Open System Services Library Calls Reference Manual (G06.27+, H06.04+)

ManualsBrandsHP ManualsServerHP NonStop G-Series

Open System Services

Library Calls

Reference Manual

Abstract

This manual documents part of the HP NonStop Open System Services (OSS)

application program interface, including those functions speciﬁed in the ISO/ANSI C

standard. It is written for system and application programmers.

Product Version

N/A

Supported Release Version Updates (RVUs)

This manual supports G06.27 and H06.03 and all subsequent G-series and H-series

release version updates until otherwise indicated in a replacement publication.

Part Number Published

527187-004 September 2005

Summary of content (921 pages)

PAGE 1
Open System Services Library Calls Reference Manual Abstract This manual documents part of the HP NonStop Open System Services (OSS) application program interface, including those functions specified in the ISO/ANSI C standard. It is written for system and application programmers. Product Version N/A Supported Release Version Updates (RVUs) This manual supports G06.27 and H06.03 and all subsequent G-series and H-series release version updates until otherwise indicated in a replacement publication.
PAGE 2
Document History Part Number Product Version Published 527187-004 527187-003 N/A N/A September 2005 July 2005 New editions incorporate any updates issued since the previous edition.
PAGE 3
Contents _____________________________ What is New in This Manual . . . . . . . . . . . . . . . . . . . . xv . . . . . . . . . . . . . . . . . . . . xv Changed Functions . . . . . . . . . . . . . . . . . . . xvi New Functions About This Manual . . . . . . . . . . . . . . . . . . . . . . xvii Audience . . . . . . . . . . . . . . . . . . . . . . xviii Purpose . . . . . . . . . . . . .
PAGE 4
OSS Library Calls Reference Manual catopen . . cbrt . . . . ceil . . . . cfgetispeed . cfgetospeed . cfsetispeed . cfsetospeed . chvol . . . clearerr . . . clock . . . closedir . . closelog . . compile . . confstr . . . copysign . . cos . . . . cosh . . . crypt . . . ctermid . . . ctime . . . cuserid . . . dbm_clearerr . dbm_close . . dbm_delete . dbm_error . . dbm_fetch . . dbm_firstkey . dbm_nextkey . dbm_open . . dbm_store . . dec_to_longlong difftime . . dirname . . div . . . . dlclose . . . dlerror . .
PAGE 5
Contents exit . . . . exp . . . . expm1 . . . fabs . . . . fclose . . . fcvt . . . . fdopen . . . feof . . . . ferror . . . fflush . . . ffs . . . . fgetc . . . fgetpos . . . fgets . . . fgetwc . . . fgetws . . . fileno . . . finite . . . floor . . . fmod . . . fmtmsg . . . fnmatch . . fopen . . . fopen_guardian fopen_oss . . fopen_std_file . fpathconf . . fp_class . . fprintf . . . fputc . . . fputs . . . fputwc . . . fputws . . . fread . . . free . . . . freeaddrinfo . freehostent . freopen . . .
PAGE 6
OSS Library Calls Reference Manual get_assign_msg . . . . get_assign_msg_by_name . getc . . . . . . . . getchar . . . . . . . getcwd . . . . . . . getdate . . . . . . . getdtablesize . . . . . getenv . . . . . . . getgrent . . . . . . getgrgid . . . . . . getgrnam . . . . . . gethostbyaddr . . . . . gethostbyname2 . . . . gethostbyname . . . . gethostent . . . . . . gethostid . . . . . . getipnodebyaddr . . . . getipnodebyname . . . get_max_assign_msg_ordinal getnameinfo . . . . . getnetbyaddr . . . . .
PAGE 7
Contents htonl htons hypot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-101 3-102 3-103 Section 4. OSS Library Calls (i - m) iconv . . . . . . iconv_close . . . . iconv_open . . . . if_freenameindex . . . if_indextoname . . . if_nameindex . . . . if_nametoindex . . . ilogb . . . . . . index . . . . . . inet_addr . . . . . inet_lnaof . . . . . inet_makeaddr . . . inet_netof . . . . . inet_network . . . . inet_ntoa . . . . .
PAGE 8
OSS Library Calls Reference Manual labs . . . . . . lcong48 . . . . ldexp . . . . . ldiv . . . . . . lfind . . . . . lgamma . . . . lldiv . . . . . localeconv . . . . localtime . . . . log10 . . . . . log1p . . . . . log . . . . . . logb . . . . . longjmp . . . . longlong_to_dec . . lrand48 . . . . . lsearch . . . . . lwres_freeaddrinfo . lwres_freehostent . lwres_gai_strerror . lwres_getaddrinfo . lwres_gethostbyaddr .
PAGE 9
Contents ntohs . . . opendir . . . openlog . . pathconf . . pause . . . pclose . . . perror . . . popen . . . pow . . . . printf . . . putc . . . . putchar . . . putenv . . . puts . . . . putw . . . putwc . . . putwchar . . putws . . . qsort . . . raise . . . rand . . . random . . . readdir . . . realloc . . . realpath . . re_comp . . re_exec . . regcmp . . . regcomp . . regerror . . regex . . . regexec . . regfree . . . remainder . . remove . . . remove_guardian remove_oss . remque . . . rewind . . .
PAGE 10
OSS Library Calls Reference Manual setlogmask setnetent . setprotoent setpwent . setservent . setstate . . setvbuf . . sigaddset . sigdelset . sigemptyset sigfillset . sigismember siglongjmp signal . . sigsetjmp . sin . . . sinh . . . sleep . . snprintf . sprintf . . sqrt . . . srand . . srand48 . srandom . sscanf . . step . . . strcasecmp strcat . . strchr . . strcmp . . strcoll . . strcpy . . strcspn . . strdup . . strerror . . strfmon . . strftime . strlen . . strncasecmp strncat . . strncmp . strncpy .
PAGE 11
Contents sysconf . syslog . system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-128 6-133 6-137 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 12
OSS Library Calls Reference Manual wcscoll . . wcscpy . . wcscspn . wcsftime . wcslen . . wcsncat . wcsncmp . wcsncpy . wcspbrk . wcsrchr . wcsspn . . wcstod . . wcstok . . wcstol . . wcstoll . . wcstombs . wcstoul . wcstoull . wcswcs . . wcswidth . wcsxfrm . wctomb . wctype . . wcwidth . wmemchr . wmemcmp . wmemcpy . wmemmove wmemset . wordexp . wordfree . y0 . . . y1 . . . yn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 13
Contents LIST OF TABLES Table 2−1. Values of File-Related Constants for Open Files Table 5−1. Values of File-Related Constants . . . Table 6−1. Default Values for Monetary Formatting 527187-004 . . . . . . . . . . . . 2-61 . . . . . . . . . . . . . 5-23 . . . . . . . . . . . . . 6-89 . . . . . . . . . . 6-89 . . . . . . . . . . 6-135 Table 6−2. Example Output from s t r f m o n ( Table 6−3. Open System Services EMS Events . . ) . .
PAGE 14
What is New in This Manual This section describes changes made to the Open System Services Library Calls Reference Manual since the 527187-003 edition.
PAGE 15
OSS Library Calls Reference Manual lwres_getnameinfo(3) lwres_getipnodebyname(3) lwres_getipnodebyaddr(3) lwres_freehostent(3) lwres_hstrerror(3) The following function description has been added for both G-series and H-series RVUs: lldiv(3) Changed Functions The following function descriptions were changed: atoll(3) Modified to describe support for TNS/R processes. snprintf(3) and vsnprintf(3) Modified to describe support for TNS/R processes.
PAGE 16
About This Manual The HP NonStop Open System Services (OSS) application program interface (API) provides an open interface for programs to be run with the underlying HP NonStop operating system. The Open System Services Library Calls Reference Manual contains reference pages for OSS library function calls. This manual describes the OSS API in the native environment.
PAGE 17
OSS Library Calls Reference Manual TNS/E code that runs on H-series systems. Discussions of TNS or accelerated code behavior in the OSS environment apply only to G-series systems; H-series systems do not support TNS or accelerated code execution in the OSS environment. Audience This manual is for system and application programmers who want to use the OSS application program interface provided with the HP NonStop operating system.
PAGE 18
About This Manual PARAMETERS Descriptions of the parameters listed under the SYNOPSIS heading. DESCRIPTION For function topics, how the function works, including the conditions or permissions required to use it successfully, the set of values for all parameters, and the effect of the function on the state of processes or files. For file topic reference pages, a description of file contents. For miscellaneous topics, a general description.
PAGE 19
OSS Library Calls Reference Manual • Inspect Manual • ld Manual • Native Inspect Manual (TNS/E systems only) • nld Manual • noft Manual • Open System Services Library Calls Reference Manual • Open System Services Porting Guide • Open System Services Programmer’s Guide • Open System Services Shell and Utilities Reference Manual • Open System Services User’s Guide • rld Manual • Software Internationalization Guide • TCP/IP and TCP/IPv6 Programming Manual • TNS/R Native Application M
PAGE 20
About This Manual _________________________________________________________________________________ (1) User commands OSS Shell and Utilities Reference Manual (2) System calls OSS System Calls Reference Manual (3) Library calls OSS Library Calls Reference Manual OSS System Calls Reference Manual (SPT_*( ) functions) (4) File formats and data structures OSS System Calls Reference Manual OSS Library Calls Reference Manual OSS Shell and Utilities Reference Manual (5) Miscellaneous topics and envir
PAGE 21
Section 1. OSS Library Calls (a - d) This section contains reference pages documenting library calls with English names beginning with the letter a through the letter d that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 22
a64l(3) OSS Library Calls Reference Manual NAME a64l - Converts a radix-64 ASCII string to a 32-bit integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include long a64l(const char *s); PARAMETERS s Is a pointer to a string in radix-64 ASCII notation.
PAGE 23
OSS Library Calls (a - d) abort(3) NAME abort - Generates a software signal to end the current process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 24
_abs(3) OSS Library Calls Reference Manual NAME _abs - Expands absolute value of its argument LIBRARY None. This application program interface is implemented as a macro. | SYNOPSIS #include arith_type _abs ( arith_type expr ); | PARAMETERS arith_type Any arithmetic type can be specified. | expr Specifies an expression to be expanded to an absolute value. | DESCRIPTION The _abs( ) macro evaluates to the absolute value of its argument.
PAGE 25
OSS Library Calls (a - d) abs(3) NAME abs - Computes absolute value of an integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int abs( int i); PARAMETERS i Specifies an integer. DESCRIPTION The abs( ) function returns the absolute value of its integer operand.
PAGE 26
acos(3) OSS Library Calls Reference Manual NAME acos - Computes the inverse trigonometric cosine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double acos( double x); PARAMETERS x Is the value for which the inverse trigonometric cosine function is to be computed.
PAGE 27
OSS Library Calls (a - d) acos(3) The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following feature is affected in the HP implementation: • 527187-004 For IEEE floating-point values, errno is not set to [EDOM] when the value of x is NaN.
PAGE 28
acosh(3) OSS Library Calls Reference Manual NAME acosh - Computes the inverse hyperbolic cosine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double acosh( double x); PARAMETERS x Is the value for which the inverse hyperbolic cosine function is to be computed.
PAGE 29
OSS Library Calls (a - d) advance(3) NAME advance - Matches regular expressions LIBRARY None. This application program interface is implemented as a macro. | SYNOPSIS #include int advance( const char *string, const char *expbuf); extern char *loc1, *loc2, *locs; PARAMETERS string Points to a null-terminated string of characters in the step( ) function, to be searched for a match. expbuf Points to a character array where the compiled regular expression is stored.
PAGE 30
advance(3) OSS Library Calls Reference Manual compile (patstr, expbuf, &expbuf[ESIZE], ’\0’); ... if (step (linebuf, expbuf)) succeed( ); ... RETURN VALUES Whenever a successful match occurs, the advance( ) macro returns a nonzero value. Upon failure, this macro returns a value of 0 (zero). | ERRORS None. This macro does not set errno. | RELATED INFORMATION Functions: compile(3), isalpha(3), regcomp(3), regexec(3), step(3). | Commands: ed(1), sed(1), grep(1).
PAGE 31
OSS Library Calls (a - d) alarm(3) NAME alarm - Sets or changes the timeout value for interval timers LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include unsigned int alarm( unsigned int seconds); PARAMETERS seconds Specifies the number of real-time seconds before the timer expires.
PAGE 32
asctime(3) OSS Library Calls Reference Manual NAME asctime - Converts broken-down time into a date and time string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *asctime( const struct tm *timeptr ); PARAMETERS timeptr Points to a type tm structure that contains the broken-down time.
PAGE 33
OSS Library Calls (a - d) asin(3) NAME asin - Computes the inverse trigonometric sine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double asin( double x); PARAMETERS x Is the value for which the inverse trigonometric sine function is to be computed.
PAGE 34
asin(3) OSS Library Calls Reference Manual The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 1−14 • When used for IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 35
OSS Library Calls (a - d) asinh(3) NAME asinh - Computes the inverse hyperbolic sine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double asinh( double x); PARAMETERS x Is the value for which the inverse hyperbolic sine function is to be computed.
PAGE 36
assert(3) OSS Library Calls Reference Manual NAME assert - Inserts program diagnostics LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void assert ( int expression); PARAMETERS expression Specifies an expression that is evaluated as TRUE or FALSE. This expression is evaluated in the same manner as a C language if control statement. DESCRIPTION The assert( ) macro inserts diagnostics into programs.
PAGE 37
OSS Library Calls (a - d) atan2(3) NAME atan2 - Computes the inverse trigonometric tangent function of y/x LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include
PAGE 38
atan2(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point format data. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point data. The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 39
OSS Library Calls (a - d) atan(3) NAME atan - Computes the inverse trigonometric tangent function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double atan( double x); PARAMETERS x Is the value for which the inverse trigonometric tangent function is to be computed.
PAGE 40
atanh(3) OSS Library Calls Reference Manual NAME atanh - Computes the inverse hyperbolic tangent function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double atanh( double x); PARAMETERS x Is the value for which the inverse hyperbolic tangent function is to be computed.
PAGE 41
OSS Library Calls (a - d) atanh(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 527187-004 • When used for IEEE floating-point values, this function does not set errno to [EDOM] when the value of x is NaN. • When used for Tandem floating-point values, this function does not return the value NaN when an invalid parameter is passed.
PAGE 42
atexit(3) OSS Library Calls Reference Manual NAME atexit - Provides for cleanup on process termination LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll | SYNOPSIS #include
PAGE 43
OSS Library Calls (a - d) atof(3) NAME atof - Converts a character string to a double-precision floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include double atof( const char *nptr); PARAMETERS nptr Points to the character string to be converted.
PAGE 44
atof(3) OSS Library Calls Reference Manual NOTES This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values in the native environment. IEEE values can include NaN and infinity, and the sign of 0.0 (zero) can be either positive or negative. Refer to the fp_class(3) reference page for a description of IEEE value classes. Guardian functions are available to convert between floating-point formats.
PAGE 45
OSS Library Calls (a - d) atoi(3) NAME atoi - Converts a character string to an integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int atoi( const char *nptr); PARAMETERS nptr Points to the character string to convert.
PAGE 46
atol(3) OSS Library Calls Reference Manual NAME atol - Converts a character string to a long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long int atol( const char *nptr); PARAMETERS nptr Points to the character string to convert.
PAGE 47
OSS Library Calls (a - d) atoll(3) NAME atoll - Converts a character string to a long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll | | SYNOPSIS #include long long int atoll ( const char *nptr ); PARAMETERS nptr Points to the character string to convert.
PAGE 48
basename(3) OSS Library Calls Reference Manual NAME basename - Returns the final component of a pathname LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *basename(char *path); PARAMETERS path is a pointer to a pathname. DESCRIPTION The basename( ) function returns a pointer to the final component of the pathname pointed to by the path parameter. Any slash (/) characters are deleted.
PAGE 49
OSS Library Calls (a - d) bcmp(3) NAME bcmp - Compares two areas of memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZI18NSRL G-series native OSS processes: /G/system/sysnn/zi18nsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int bcmp( const void *s1, const void *s2, size_t n); PARAMETERS s1 Is a pointer to the first area to be compared.
PAGE 50
bcopy(3) OSS Library Calls Reference Manual NAME bcopy - Copies an area of memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZI18NSRL G-series native OSS processes: /G/system/sysnn/zi18nsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void bcopy( const void *s1, void *s2, size_t n); PARAMETERS s1 Is a pointer to the area to be copied.
PAGE 51
OSS Library Calls (a - d) bsearch(3) NAME bsearch - Performs a binary search LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void *bsearch( const void *key, const void *base, size_t nmemb, size_t size, int (*compar)(const void *, const void *)); PARAMETERS key Target of search.
PAGE 52
bzero(3) OSS Library Calls Reference Manual NAME bzero - Zeroes an area of memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void bzero( void *s, size_t n); PARAMETERS s Is a pointer to the area to be zeroed. n Is the number of bytes to zero.
PAGE 53
OSS Library Calls (a - d) calloc(3) NAME calloc - Allocates memory in an array LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void *calloc( size_t num_of_elts, size_t elt_size); PARAMETERS num_of_elts Specifies the number of elements in the array.
PAGE 54
catclose(3) OSS Library Calls Reference Manual NAME catclose - Closes a specified message catalog LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int catclose ( nl_catd cat_descriptor); PARAMETERS cat_descriptor Specifies an index into the message catalog that is returned from a call to the catopen( ) function.
PAGE 55
OSS Library Calls (a - d) catgets(3) NAME catgets - Retrieves a message from a catalog LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series OSS processes: /G/systemzdllsnnn/zcrtldll SYNOPSIS #include char *catgets( nl_catd cat_descriptor, int set_number, int message_number, const char *string); PARAMETERS cat_descriptor Specifies a catalog description that is returned by the catopen( ) function. set_number Specifies the set ID.
PAGE 56
catopen(3) OSS Library Calls Reference Manual NAME catopen - Opens a specified message catalog LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include nl_catd catopen( const char *name, int oflag); PARAMETERS name Specifies the catalog file to open. oflag Specifies if the LANG or LC_MESSAGES environment variable is used to locate the catalog.
PAGE 57
OSS Library Calls (a - d) catopen(3) NLSPATH=../%N:/usr/lib/nls/msg/%L/%N:/usr/lib/nls/msg/%l/%N LANG=fr_BE.ISO8859-1 then the application searches for the catalog in the following order: ../mycmd.cat /usr/lib/nls/msg/fr_BE.ISO88591-1/mycmd.cat /usr/lib/nls/msg/fr/mycmd.cat The setlocale( ) function sets the value of the LC_MESSAGES category based on the values of the parameters to setlocale( ) and on the values of the LC_MESSAGES, LANG, and LC_ALL environment variables.
PAGE 58
cbrt(3) OSS Library Calls Reference Manual NAME cbrt - Computes the cube root of a floating-point number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double cbrt( double x); PARAMETERS x Is the value whose cube root is to be computed.
PAGE 59
OSS Library Calls (a - d) ceil(3) NAME ceil - Rounds floating-point numbers to floating-point integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double ceil( double x); PARAMETERS x Specifies the double value to be rounded.
PAGE 60
cfgetispeed(3) OSS Library Calls Reference Manual NAME cfgetispeed - Gets the input baud rate for a terminal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include speed_t cfgetispeed( const struct termios *termios_p); PARAMETERS termios_p Points to a termios structure containing the input baud rate.
PAGE 61
OSS Library Calls (a - d) cfgetospeed(3) NAME cfgetospeed - Gets the output baud rate for a terminal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include speed_t cfgetospeed( const struct termios *termios_p); PARAMETERS termios_p Points to a termios structure containing the output baud rate.
PAGE 62
cfsetispeed(3) OSS Library Calls Reference Manual NAME cfsetispeed - Sets the input baud rate for a terminal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int cfsetispeed( struct termios *termios_p, speed_t speed); PARAMETERS termios_p Points to a termios structure containing the input baud rate.
PAGE 63
OSS Library Calls (a - d) cfsetospeed(3) NAME cfsetospeed - Sets the output baud rate for a terminal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int cfsetospeed( struct termios *termios_p, speed_t speed); PARAMETERS termios_p Points to a termios structure containing the output baud rate.
PAGE 64
chvol(3) OSS Library Calls Reference Manual NAME chvol - Changes default volume and subvolume names used to qualify partial Guardian filenames LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL For G-series OSS native processes: /G/system/sysnn/zcrtlsrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL For H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 65
OSS Library Calls (a - d) clearerr(3) NAME clearerr - Clears indicators on a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void clearerr( FILE *stream); PARAMETERS stream Specifies the input or output stream to be cleared.
PAGE 66
clock(3) OSS Library Calls Reference Manual NAME clock - Reports processor time used LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include clock_t clock(void); DESCRIPTION The clock( ) function reports the amount of processor time used by the calling process.
PAGE 67
OSS Library Calls (a - d) closedir(3) NAME closedir - Closes a directory stream LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ int closedir( DIR *dir_pointer); PARAMETERS dir_pointer Points to the dir structure of an open directory. DESCRIPTION The type DIR, which is defined in the dirent.
PAGE 68
closedir(3) OSS Library Calls Reference Manual EXAMPLES The following example shows how to close a directory after searching for the entry name: len = strlen(name); dir_pointer = opendir("."); for (dp = readdir(dir_pointer); dp != NULL; dp = readdir(dir_pointer)) if (strlen(dp->d_name) == len && !strcmp(dp->d_name, name)) { closedir(dir_pointer); return FOUND; } closedir(dir_pointer); return NOT_FOUND; RETURN VALUES Upon successful completion, the closedir( ) function returns the value 0 (zero).
PAGE 69
OSS Library Calls (a - d) closelog(3) NAME closelog - Closes the Event Management Service (EMS) event log file LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include void closelog(void); DESCRIPTION The closelog( ) function closes the connection to the event-message collector that was opened by the syslog( ) or openlog( ) function. RETURN VALUES None. ERRORS None. This function does not set errno.
PAGE 70
compile(3) OSS Library Calls Reference Manual NAME compile - Compiles regular expressions LIBRARY None. This application program interface is implemented as a macro. | SYNOPSIS #define #define #define #define #define #define INIT declarations GETC( ) getc code PEEKC( ) peekc code UNGETC(c) ungetc code RETURN(ptr) return code ERROR(val) error code #include
PAGE 71
OSS Library Calls (a - d) INIT compile(3) The INIT( ) macro is used for dependent declarations and initializations. In the | regexp.h header file this macro is located right after the compile( ) macro | declarations and opening { (left brace). Your INIT( ) declarations must end with a ; (semicolon). The INIT( ) macro is frequently used to set a register variable to point to the beginning of the regular expression, so that this pointer can be used in declarations for GETC( ), PEEKC( ), and UNGETC( ).
PAGE 72
compile(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completion, the compile( ) macro calls the RETURN( ) macro. Upon failure, this macro calls the ERROR( ) macro. | ERRORS If any of the following conditions occurs, the compile( ) macro calls the ERROR( ) macro with an error value as its argument: | 11 _BIGRANGE The range endpoint is too large. 16 _BADNUM A bad number was received. 25 _BIGDIGIT The number in digit is out of range.
PAGE 73
OSS Library Calls (a - d) confstr(3) NAME confstr - Determines the current value of a specified system variable defined by a string value LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 74
confstr(3) OSS Library Calls Reference Manual ERRORS If the specified name value does not have a system-defined value, the confstr( ) function returns a value of 0 (zero) and leaves the errno value unchanged. If the specified name value is invalid, the value 0 (zero) is returned, and errno is set to [EINVAL]. [EINVAL] The value of the name parameter is invalid. RELATED INFORMATION Functions: pathconf(3), sysconf(3).
PAGE 75
OSS Library Calls (a - d) copysign(3) NAME copysign - Returns x with the sign of y LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL For G-series OSS native processes: /G/system/sysnn/zcrtlsrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL For H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include double copysign( double x, double y ); PARAMETERS x Specifies a double-precision floating-point value.
PAGE 76
cos(3) OSS Library Calls Reference Manual NAME cos - Computes the trigonometric cosine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double cos( double x); PARAMETERS x Is the value for which the trigonometric cosine function is to be computed.
PAGE 77
OSS Library Calls (a - d) 527187-004 cos(3) • For IEEE floating-point values, errno is not set to 0.0 (zero) when the value of x is positive or negative infinity. • errno is not set to [ERANGE] when the return value would cause underflow.
PAGE 78
cosh(3) OSS Library Calls Reference Manual NAME cosh - Computes the hyperbolic cosine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double cosh( double x); PARAMETERS x Is the value for which the hyperbolic cosine function is to be computed.
PAGE 79
OSS Library Calls (a - d) crypt(3) NAME crypt - Encrypts a password or other character data LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZOSSCSRL G-series native OSS processes: /G/system/sysnn/zosscsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZOSSCDLL H-series OSS processes: /G/system/zdllnnn/zosscdll SYNOPSIS #include
PAGE 80
ctermid(3) OSS Library Calls Reference Manual NAME ctermid - Generates the pathname for the controlling terminal LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include char *ctermid( char *s); PARAMETERS s Indicates where to store the returned pathname. If the s parameter is a null pointer, the pathname is stored in an internal static area and the address is returned.
PAGE 81
OSS Library Calls (a - d) ctermid(3) STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • If the s parameter is a null pointer, the string is stored in an internal static area and the address is returned. The next call to the ctermid( ) function overwrites the contents of the internal static area.
PAGE 82
ctime(3) OSS Library Calls Reference Manual NAME ctime - Converts time since the Epoch into a date and time string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *ctime( const time_t *timer); PARAMETERS timer Points to a variable that specifies a time value in seconds.
PAGE 83
OSS Library Calls (a - d) cuserid(3) NAME cuserid - Gets the username associated with the real user ID of the current process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include char *cuserid( char *s); PARAMETERS s Specifies where to store the character string containing the username.
PAGE 84
cuserid(3) OSS Library Calls Reference Manual [EIO] A disk process or file system input or output error occurred. Data might have been lost during the transfer. [ENOCRE] The calling process does not use the Common Run-Time Environment (CRE) but requested a service that requires CRE (the static area cannot be allocated in the calling process). [ENOMEM] There is insufficient user memory to complete the call. RELATED INFORMATION Functions: getlogin(2), getpwent(3).
PAGE 85
OSS Library Calls (a - d) dbm_clearerr(3) NAME dbm_clearerr, dbm_close, dbm_delete, dbm_error, dbm_fetch, dbm_firstkey, dbm_nextkey, dbm_open, dbm_store - Manipulates a database LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include
PAGE 86
dbm_clearerr(3) store_mode OSS Library Calls Reference Manual Determines whether the record being stored by the dbm_store( ) function replaces an existing record or is inserted. DESCRIPTION These functions create, access, and modify a database. A database consists of two files: one with a .dir suffix and one with a .pag suffix. The .dir file contains a catalog of the keys in the database and how to find them, while the .pag file contains the actual data.
PAGE 87
OSS Library Calls (a - d) dbm_clearerr(3) If the db parameter does not point to a database structure, the results are undefined and [EINVAL] is returned. CAUTIONS The dptr pointer returned by some of these functions may point to static storage that may be overwritten by future function calls. The dbm_delete( ) function only makes file space available for future use; it does not physically reclaim the space.
PAGE 88
dbm_clearerr(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: open(2), read(2), write(2), lseek(2). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 1−68 The errno values [EINVAL], [ENOMEM], and [ENOPERM] can be returned.
PAGE 89
OSS Library Calls (a - d) dbm_close(3) NAME dbm_close - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 90
dbm_delete(3) OSS Library Calls Reference Manual NAME dbm_delete - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 91
OSS Library Calls (a - d) dbm_error(3) NAME dbm_error - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 92
dbm_fetch(3) OSS Library Calls Reference Manual NAME dbm_fetch - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 93
OSS Library Calls (a - d) dbm_firstkey(3) NAME dbm_firstkey - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 94
dbm_nextkey(3) OSS Library Calls Reference Manual NAME dbm_nextkey - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 95
OSS Library Calls (a - d) dbm_open(3) NAME dbm_open - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 96
dbm_store(3) OSS Library Calls Reference Manual NAME dbm_store - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 97
OSS Library Calls (a - d) dec_to_longlong(3) NAME dec_to_longlong - Converts SQL DECIMAL value stored in a C array of decimal to a C long long value LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRESRL For G-series OSS native processes: /G/system/sysnn/zcresrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCREDLL For H-series OSS processes: /G/systemzdllsnnn/zcredll SYNOPSIS #include
PAGE 98
difftime(3) OSS Library Calls Reference Manual NAME difftime - Computes the difference between two calendar times LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include double difftime( time_t time1, time_t time2 ); PARAMETERS time1 Specifies a time value expressed in seconds.
PAGE 99
OSS Library Calls (a - d) dirname(3) NAME dirname - Returns the parent directory name of a file pathname LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include char *dirname(char *path); PARAMETERS path Is a pointer to a pathname. DESCRIPTION The dirname( ) function takes the path parameter, which points to the pathname of a file, and returns a pointer to the pathname of that file’s parent directory.
PAGE 100
div(3) OSS Library Calls Reference Manual NAME div - Divides integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include div_t div ( int numerator, int denominator); | PARAMETERS numerator Specifies an integer. denominator Specifies an integer.
PAGE 101
OSS Library Calls (a - d) dlclose(3) NAME dlclose - Invalidates a dynamic-link library handle and unloads any dynamically loaded library LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 102
dlclose(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful invalidation of the library handle, the function returns the value 0 (zero). Otherwise, a nonzero value is returned and the dlerror( ) or dlresultcode( ) function should be called immediately to determine the problem. ERRORS The dlclose( ) function does not set the errno variable. Error information is available through the dlerror( ) or dlresultcode( ) function.
PAGE 103
OSS Library Calls (a - d) dlerror(3) NAME dlerror - Returns an explanation of a previous dynamic-link library error LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 104
dlerror(3) OSS Library Calls Reference Manual ERRORS The dlerror( ) function does not set the errno variable. RELATED INFORMATION Functions: dlclose(3), dlopen(3), dlresultcode(3), dlsym(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification.
PAGE 105
OSS Library Calls (a - d) dlopen(3) NAME dlopen - Opens a dynamic-link library loadfile from a running process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 106
dlopen(3) OSS Library Calls Reference Manual RTLD_VERBOSE(n) Specifies the amount and kind of debugging information to provide on the home terminal or standard error file when an error occurs: 0 Perform the default behavior 1 Do not list warning or error messages on the home terminal or the standard error file 2 List warning and error messages 3 List warning and error messages and files loaded 4 List warning and error messages, files loaded, and symbol resolution 5 List warning and error messag
PAGE 107
OSS Library Calls (a - d) dlopen(3) Symbol controls within the loadfiles affect a call to dlopen( ); that is, the library designated by object_pathname and each library it requires can be localized, globalized, or semi-globalized itself, and its symbols are resolved accordingly. dlopen( ) does not load licensed libraries. Controlling the Loader Search Path Users can specify the search path used to find libraries without fully qualified file names.
PAGE 108
dlopen(3) OSS Library Calls Reference Manual 4. Locations specified by -rld_l at link time (the value of rpath) 5. Default locations: On OSS: /lib:/usr/lib:/usr/local/lib:/G/SYSTEM/ZDLL On Guardian: $SYSTEM.ZDLL Environment Variables and Runtime Searches At run time, users can modify the path list specified at link time. For OSS programs, the loadtime path lists can be specified using the following environment variables: _RLD_LIB_PATH=object_pathname[:object_pathname]...
PAGE 109
OSS Library Calls (a - d) dlopen(3) For Guardian programs, the class MAP DEFINE =_RLDVERBOSE performs the equivalent action. For example: ADD DEFINE =_RLDVERBOSE, CLASS MAP, FILE #4 Disposing of Unresolved Symbols Users can specify an option to the ld or eld linker to control disposition of unresolved symbols in a loadfile. The option is stored in the loadfile and determines whether rld or dlopen( ) generates warnings or errors when it encounters unresolved procedure references in the loadfile.
PAGE 110
dlopen(3) OSS Library Calls Reference Manual In the case of an error, a summary message can be retrieved by a call to dlerror( ). RELATED INFORMATION Commands: eld(1), ld(1). Functions: dlclose(3), dlerror(3), dlresultcode(3), dlsym(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification.
PAGE 111
OSS Library Calls (a - d) dlresultcode(3) NAME dlresultcode - Returns the error code for the most recent call to dlopen(), dlclose(), or dlsym() LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 112
dlresultcode(3) OSS Library Calls Reference Manual 7 The process phase changed unexpectedly while running initialization or termination functions, or constructors or destructors for global instances of classes. This error-detail can be generated only by a call to dlopen( ) or dlclose( ). 8 The RTLD_NOLOAD option was passed to dlopen( ), but the library specified by the object_pathname value of that function had not been loaded. ERRORS dlresultcode( ) does not set errno.
PAGE 113
OSS Library Calls (a - d) dlsym(3) NAME dlsym - Obtains the address of an external symbol in a dynamic-link library LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 114
dlsym(3) OSS Library Calls Reference Manual someData *theData; // pointer to structure // variable "theData" in "mydll" dlHandle handle; // handle from loading "mydll" handle = dlopen("mydll",RTLD_NOW); if (! handle) ... // error handling theFunction = (someFunction_p)dlsym(handle,"theFunction"); if (! theFunction) ... //error handling theData = (someData*)dlsym(handle,"theData"); if (! theData) ...
PAGE 115
OSS Library Calls (a - d) drand48(3) NAME drand48 - Generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 116
drand48(3) OSS Library Calls Reference Manual RETURN VALUES The drand48( ) function returns nonnegative, double-precision, floating-point values. RELATED INFORMATION Functions: erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), nrand48(3), rand(3), seed48(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 117
Section 2. OSS Library Calls (e - f) This section contains reference pages documenting library calls with English names beginning with the letter e through the letter f that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 118
ecvt(3) OSS Library Calls Reference Manual NAME ecvt - Converts a floating-point number to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *ecvt( double value, int ndigit, int *decpt, int *sign ); PARAMETERS value Is the floating-point number to be converted.
PAGE 119
OSS Library Calls (e - f) ecvt(3) RELATED INFORMATION Functions: fcvt(3), fp_class(3), gcvt(3), sprintf(3). STANDARDS CONFORMANCE The ecvt( ) function is defined in the XPG4 Version 2 specification.
PAGE 120
edfseek(3) OSS Library Calls Reference Manual NAME edfseek - Sets the file-position indicator of an Edit file opened for ANSI I/O LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL For G-series OSS native processes: /G/system/sysnn/zcrtlsrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL For H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 121
OSS Library Calls (e - f) edfseek(3) the file. For absolute positioning (using pos_base value SEEK_SET), pos is the Edit line number multiplied by 1000. For example, 23000L corresponds to line 23, and 44120L corresponds to line 44.12. Using absolute positioning, edfseek( ) sets the file position to the specified line if and only if the specified line exists in the file.
PAGE 122
edftell(3) OSS Library Calls Reference Manual NAME edftell - Retrieves the file-position indicator of an Edit file opened for ANSI I/O LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long edftell ( FILE *stream); PARAMETERS stream denotes an Edit file opened for ANSI I/O.
PAGE 123
OSS Library Calls (e - f) encrypt(3) NAME encrypt - Encrypts or decrypts an array LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZOSSCSRL G-series native OSS processes: /G/system/sysnn/zosscsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZOSSCDLL H-series OSS processes: /G/system/zdllnnn/zosscdll SYNOPSIS #include void encrypt( char block[64], int edflag); PARAMETERS block Specifies a string containing only bytes with a numerical value of 0 (zero) or 1.
PAGE 124
endgrent(3) OSS Library Calls Reference Manual NAME endgrent - Closes the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include void endgrent(void); DESCRIPTION The getgrent( ), getgrgid( ), getgrnam( ), setgrent( ), and endgrent( ) functions are used to access group attributes.
PAGE 125
OSS Library Calls (e - f) endhostent(3) NAME endhostent - Closes the network host database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void endhostent(void); DESCRIPTION The endhostent( ) function closes /etc/hosts, the network host database. The database can be opened by calls to gethostbyaddr( ), gethostbyname( ), or sethostent( ). RETURN VALUES The endhostent( ) function does not return a value.
PAGE 126
endnetent(3) OSS Library Calls Reference Manual NAME endnetent - Closes the networks database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void endnetent(void); PARAMETERS None. DESCRIPTION The endnetent( ) function closes /etc/networks, the networks database file. The database can be opened with the getnetent( ), getnetbyaddr( ), setnetent( ), or getnetbyname( ) function.
PAGE 127
OSS Library Calls (e - f) endprotoent(3) NAME endprotoent - Closes the connection to the network protocols database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void endprotoent(void); PARAMETERS None. DESCRIPTION The endprotoent( ) function closes the connection to the /etc/protocols file, the network protocols database.
PAGE 128
endpwent(3) OSS Library Calls Reference Manual NAME endpwent - Closes the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include void endpwent(void); DESCRIPTION The endpwent( ) function normally closes the user authentication database.
PAGE 129
OSS Library Calls (e - f) endservent(3) NAME endservent - Closes the connection to the network services database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void endservent(void); PARAMETERS None. DESCRIPTION The endservent( ) function closes /etc/services, the network services database. /etc/services can be opened with the setservent( ), getservent( ), getservbyname( ), or getservbyport( ) function.
PAGE 130
erand48(3) OSS Library Calls Reference Manual NAME erand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 131
OSS Library Calls (e - f) erand48(3) IEEE value classes. Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The erand48( ) function returns nonnegative, double-precision, floating-point values. RELATED INFORMATION Functions: drand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), nrand(3), rand(3), seed48(3), srand48(3).
PAGE 132
erf(3) OSS Library Calls Reference Manual NAME erf - Computes the error function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double erf( double x); PARAMETERS x Specifies the double value for which the error function is to be computed.
PAGE 133
OSS Library Calls (e - f) erfc(3) NAME erfc - Computes the complementary error function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double erfc( double x); PARAMETERS x Specifies the double value for which the complementary error function is to be computed.
PAGE 134
exit(3) OSS Library Calls Reference Manual NAME exit - Terminates a process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void exit( int status); PARAMETERS status Indicates the status of the process.
PAGE 135
OSS Library Calls (e - f) exp(3) NAME exp - Computes the exponential function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double exp( double x); PARAMETERS x Specifies the power to which the base of the natural logarithms (e) is to be raised.
PAGE 136
exp(3) OSS Library Calls Reference Manual The XPG4 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 2−20 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 137
OSS Library Calls (e - f) expm1(3) NAME expm1 - Computes the exponential function minus 1.0 LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double expm1( double x); PARAMETERS x Is the power to which the base of the natural logarithms (e) is to be raised.
PAGE 138
fabs(3) OSS Library Calls Reference Manual NAME fabs - Computes the floating-point absolute value function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double fabs( double x); PARAMETERS x Specifies the double value whose absolute value is to be computed.
PAGE 139
OSS Library Calls (e - f) fclose(3) NAME fclose - Closes a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fclose ( FILE *stream); PARAMETERS stream Specifies the output or update stream.
PAGE 140
fclose(3) OSS Library Calls Reference Manual [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: close(2), exit(2), fflush(3), fopen(3), setbuf(3).
PAGE 141
OSS Library Calls (e - f) fcvt(3) NAME fcvt - Converts a floating-point number to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *fcvt( double value, int ndigit, int *decpt, int *sign ); PARAMETERS value Specifies the floating-point number to be converted.
PAGE 142
fcvt(3) OSS Library Calls Reference Manual RETURN VALUES The fcvt( ) function returns a pointer to a null-terminated string representation of value. ERRORS No errors are returned. This function does not set errno. RELATED INFORMATION Functions: ecvt(3), fp_class(3), gcvt(3), sprintf(3). STANDARDS CONFORMANCE The fcvt( ) function is defined in the XPG4 Version 2 specification.
PAGE 143
OSS Library Calls (e - f) fdopen(3) NAME fdopen - Associates a stream with a file descriptor LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 144
fdopen(3) OSS Library Calls Reference Manual ignored. All output is written at the end of the file and the file pointer is repositioned to the end of the output. If two separate processes open the same file for append, each process can write freely to the file without destroying the output being written by the other. The output from the two processes is intermixed in the order in which it is written to the file. Note that if the data is buffered, it is not actually written until it is flushed.
PAGE 145
OSS Library Calls (e - f) feof(3) NAME feof - Tests EOF on a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int feof( FILE *stream); PARAMETERS stream Specifies the input stream. DESCRIPTION The feof( ) function test the EOF (End-of-File) condition on the specified stream.
PAGE 146
ferror(3) OSS Library Calls Reference Manual NAME ferror - Tests the error indicator on a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ferror( FILE *stream); PARAMETERS stream Specifies the input or output stream.
PAGE 147
OSS Library Calls (e - f) fflush(3) NAME fflush - Flushes a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fflush( FILE *stream); PARAMETERS stream Specifies the output or update stream.
PAGE 148
fflush(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: close(2), exit(2), fclose(3), fopen(3), setbuf(3). STANDARDS CONFORMANCE The [ENXIO] errno value is not defined in the POSIX standards. It is an optional extension defined in the XPG4 version 2 specification.
PAGE 149
OSS Library Calls (e - f) ffs(3) NAME ffs - Finds first bit set LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int ffs(int i); PARAMETERS i is an integer to examined.
PAGE 150
fgetc(3) OSS Library Calls Reference Manual NAME fgetc - Gets a character from a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fgetc( FILE *stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 151
OSS Library Calls (e - f) fgetc(3) RELATED INFORMATION Functions: getc(3), getchar(3), gets(3), getwc(3), putc(3), read(2). STANDARDS CONFORMANCE The [ENXIO] errno value is an extension to the POSIX standard and an optional extension in the XPG4 Version 2 specification.
PAGE 152
fgetpos(3) OSS Library Calls Reference Manual NAME fgetpos - Reposition the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fgetpos( FILE *stream, fpos_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 153
OSS Library Calls (e - f) fgets(3) NAME fgets - Gets a string from a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *fgets( char *string, int n, FILE *stream); PARAMETERS string Points to a string to receive bytes. n Specifies an upper bound on the number of bytes to read.
PAGE 154
fgets(3) [ENOMEM] OSS Library Calls Reference Manual Insufficient memory is available for the operation. Any error encountered during the underlying call to the read( ) function can cause this function to return the corresponding errno value reported by the read( ) function. If your application program encounters an errno value not listed above, refer to the read(2) reference page either online or in the Open System Services System Calls Reference Manual for information about the cause of that error.
PAGE 155
OSS Library Calls (e - f) fgetwc(3) NAME fgetwc - Gets a wide character from a a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t fgetwc( FILE *stream); PARAMETERS stream Specifies the input data.
PAGE 156
fgetws(3) OSS Library Calls Reference Manual NAME fgetws - Gets a wide character string from a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *fgetws( wchar_t *string, int number, FILE *stream); PARAMETERS wstring Points to a string to receive characters.
PAGE 157
OSS Library Calls (e - f) fileno(3) NAME fileno - Maps a stream pointer to a file descriptor LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fileno( FILE *stream); PARAMETERS stream Specifies the input stream.
PAGE 158
finite(3) OSS Library Calls Reference Manual NAME finite - Tests whether a floating-point number is infinite LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int finite( double x); PARAMETERS x Specifies a double-precision IEEE floating-point value.
PAGE 159
OSS Library Calls (e - f) floor(3) NAME floor - Rounds floating-point numbers to floating-point integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double floor( double x); PARAMETERS x Specifies the double value to be rounded.
PAGE 160
fmod(3) OSS Library Calls Reference Manual NAME fmod - Computes the modulo remainder of a division operation LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double fmod( double x, double y ); PARAMETERS x Specifies the double value that is the numerator of the division.
PAGE 161
OSS Library Calls (e - f) fmod(3) RELATED INFORMATION Functions: abs(3), ceil(3), fabs(3), floor(3), fp_class(3), isnan(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point values. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point values. The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 162
fmtmsg(3) OSS Library Calls Reference Manual NAME fmtmsg - Displays message on standard error or system console in specified format LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include int fmtmsg( long classification, const char *label, int severity, const char *text, const char *action, const char *tag); PARAMETERS classification Identifies the source of the message and tells how to display the message.
PAGE 163
OSS Library Calls (e - f) fmtmsg(3) Status Subclass Identifies whether or not the application will recover from the condition. It can be one of MM_RECOVER (recoverable) or MM_NRECOV (nonrecoverable). There is also the MM_NULLMC identifier, which indicates that there is no classification component for the message. label Points to a string that gives the source of the message. The format of this parameter is two fields separated by a colon.
PAGE 164
fmtmsg(3) OSS Library Calls Reference Manual RETURN VALUES The fmtmsg( ) function returns one of the following values: MM_OK The function succeeded. MM_NOTOK The function failed completely. MM_NOMSG The function could not generate a message on standard error, but otherwise succeeded. MM_NOCON The function could not generate a console message, but otherwise succeeded. ERRORS None. This function does not set errno. RELATED INFORMATION Functions: printf(3).
PAGE 165
OSS Library Calls (e - f) fnmatch(3) NAME fnmatch - Matches filename patterns LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int fnmatch( const char * pattern, const char * string, int flags); PARAMETERS pattern Contains the pattern that the string parameter is compared to. string Contains the string to be compared to the pattern parameter.
PAGE 166
fnmatch(3) OSS Library Calls Reference Manual A period is determined to be leading according to the setting of the FNM_PATHNAME flag, as follows: • If FNM_PATHNAME is set, a period is leading only if it is the first character in the string parameter or if it immediately follows a slash. • If FNM_PATHNAME is not set, a period is leading only if it is the first character of the string parameter.
PAGE 167
OSS Library Calls (e - f) fopen(3) NAME fopen - Opens a file stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the fopen( ) function: fopen_oss( ) and fopen_guardian( ).
PAGE 168
fopen_guardian(3) OSS Library Calls Reference Manual NAME fopen_guardian - Opens a stream (Guardian fopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 169
OSS Library Calls (e - f) fopen_guardian(3) rb Opens a C binary file for reading. wb Creates a new C binary file for writing, or opens and truncates a C binary file to zero length. ab Appends (opens a C binary file for writing at the end of the file, or creates a C binary file for writing). rb+ Opens a C binary file for update (reading and writing). wb+ Truncates or creates a C binary file for update.
PAGE 170
fopen_guardian(3) OSS Library Calls Reference Manual Explicit calls to the fopen_oss( ) and fopen_guardian( ) variants in source code are only made when the behavior of one environment is desired from the other environment. fopen_oss( ) is functionally identical to the fopen( ) function of the OSS environment. It is the same as setting systype oss at compile-time. systype oss is the default setting for c89 in the OSS environment and on UNIX workstations.
PAGE 171
OSS Library Calls (e - f) fopen_oss(3) NAME fopen_oss - Opens a stream (OSS fopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 172
fopen_oss(3) OSS Library Calls Reference Manual the end of the file. When you open a file for append (that is, when the mode parameter is a or a+), it is impossible to overwrite information already in the file. You can use the fseek( ) function to reposition the file pointer to any position in the file, but when output is written to the file, the current file pointer is ignored. All output is written at the end of the file and the file pointer is repositioned to the end of the output.
PAGE 173
OSS Library Calls (e - f) fopen_oss(3) [EINTR] The function was interrupted by a signal that was caught. [EINVAL] The mode parameter is not a valid mode. [EISDIR] The named file is a directory and mode requires write access. [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process. [ENAMETOOLONG] The length of the path string exceeds PATH_MAX or a pathname component is longer than NAME_MAX. [ENFILE] Too many files are currently open in the processor.
PAGE 174
fopen_std_file(3) OSS Library Calls Reference Manual NAME fopen_std_file - Opens standard input, standard output, or standard error file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 175
OSS Library Calls (e - f) fpathconf(3) NAME fpathconf - Gets file configuration attributes for an open file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 176
fpathconf(3) PATH_MAX OSS Library Calls Reference Manual Is the maximum number of bytes in a pathname (including a terminating null). The value returned is the maximum length of a relative pathname when the specified file is a directory. Value of name: _PC_PATH_MAX PIPE_BUF Is the maximum number of bytes guaranteed to be written atomically. This attribute is applicable only to a pipe or FIFO file. The value returned applies to the referenced object.
PAGE 177
OSS Library Calls (e - f) fpathconf(3) The following table shows the values the fpathconf( ) function returns for the symbolic constants defined in the unistd.h file that correspond to the name parameter: Table 2−1.
PAGE 178
fpathconf(3) OSS Library Calls Reference Manual • [EIO] The filedes parameter specifies an AF_INET or AF_INET6 socket or an unbound AF_UNIX socket. An input or output error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed. [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment.
PAGE 179
OSS Library Calls (e - f) fpathconf(3) The following are HP extensions to the XPG4 Version 2 specification: • 527187-004 The errno values [EFSBAD], [EIO], [EISGUARDIAN], [ENETDOWN], [ENOROOT], [ENXIO], and [EWRONGID] can be returned by the fpathconf( ) function.
PAGE 180
fp_class(3) OSS Library Calls Reference Manual NAME fp_class - Returns the class of a floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int fp_class( double x); PARAMETERS x Specifies a double-precision IEEE floating-point value.
PAGE 181
OSS Library Calls (e - f) fp_class(3) RELATED INFORMATION Functions: isnan(3). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification and provides features of the IEEE Std 754-1985 that are implementation-defined.
PAGE 182
fprintf(3) OSS Library Calls Reference Manual NAME fprintf - Prints formatted output to an output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fprintf ( FILE *stream, const char *format [, value] . . .
PAGE 183
OSS Library Calls (e - f) • fprintf(3) + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero). For x and X conversions, a nonzero result has 0x or 0X prefixed to it.
PAGE 184
fprintf(3) OSS Library Calls Reference Manual • An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
PAGE 185
OSS Library Calls (e - f) 527187-004 fprintf(3) x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 186
fprintf(3) OSS Library Calls Reference Manual S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 187
OSS Library Calls (e - f) fprintf(3) ERRORS The fprintf( ) function fails if stream is unbuffered, or if stream’s buffer needed to be flushed and the function call caused an underlying write( ) or lseek( ) function to be invoked. In addition, if the fprintf( ) function fails, errno is set to one of the following values: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation.
PAGE 188
fputc(3) OSS Library Calls Reference Manual NAME fputc - Writes a byte to a specified output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fputc( int c, FILE *stream); PARAMETERS c Specifies the character to be written. stream Points to the file structure of an open file.
PAGE 189
OSS Library Calls (e - f) fputc(3) In addition, if any of the following conditions occur, the fputc( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing.
PAGE 190
fputs(3) OSS Library Calls Reference Manual NAME fputs - Writes a string to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fputs( const char *string, FILE *stream); PARAMETERS string Points to a string to be written to output.
PAGE 191
OSS Library Calls (e - f) fputs(3) [ENOMEM] Insufficient storage space available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 192
fputwc(3) OSS Library Calls Reference Manual NAME fputwc - Writes a wide character to a specified stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t fputwc( wint_t c, FILE *stream); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
PAGE 193
OSS Library Calls (e - f) fputwc(3) [ENOMEM] Insufficient storage space is available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 194
fputws(3) OSS Library Calls Reference Manual NAME fputws - Writes a wide-character string to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fputws( wchar_t *string, FILE *stream); PARAMETERS string Points to a string to be written to output.
PAGE 195
OSS Library Calls (e - f) fputws(3) [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: gets(3), getws(3), wcstombs(3), printf(3), putc(3), puts(3), putwc(3), putws(3).
PAGE 196
fread(3) OSS Library Calls Reference Manual NAME fread - Reads input from a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t fread( void ∗ pointer, size_t size, size_t num_items, FILE ∗ stream); PARAMETERS pointer Points to an array.
PAGE 197
OSS Library Calls (e - f) fread(3) [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the input stream and the process would be delayed in the read operation. [EBADF] The file descriptor underlying the input stream is not a valid file descriptor open for reading. [EINTR] The read operation was interrupted by a signal that was caught, and no data was transferred.
PAGE 198
free(3) OSS Library Calls Reference Manual NAME free - Releases allocated memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void free( void ∗ pointer); PARAMETERS pointer Points to the block of memory that was returned by a memory allocation function.
PAGE 199
OSS Library Calls (e - f) freeaddrinfo(3) NAME freeaddrinfo - Frees address information structure and storage for IPv6 socket LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 200
freeaddrinfo(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: freehostent(3), gai_strerror(3), getaddrinfo(3), getipnodebyaddr(3), getipnodebyname(3), getnameinfo(3), if_freenameindex(3), if_indextoname(3), if_nameindex(3), if_nametoindex(3), inet_pton(3), inet_ntop(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
PAGE 201
OSS Library Calls (e - f) freehostent(3) NAME freehostent - Frees address information structure and storage for IPv6 socket LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 202
freopen(3) OSS Library Calls Reference Manual NAME freopen - Opens a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the freopen( ) function: freopen_oss( ) and freopen_guardian( ).
PAGE 203
OSS Library Calls (e - f) freopen_guardian(3) NAME freopen_guardian - Opens a stream (Guardian freopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 204
freopen_guardian(3) OSS Library Calls Reference Manual r+ Opens a text file for update (reading and writing). w+ Truncates or creates a text file for update. a+ Appends (opens a text file for update, writing at the end of the file, or creates a text file for writing). rb Opens a C binary file for reading. wb Creates a new C binary file for writing, or opens and truncates a C binary file to zero length.
PAGE 205
OSS Library Calls (e - f) freopen_guardian(3) freopen_oss( ) is functionally identical to the freopen( ) function of the OSS environment. It is the same as setting systype oss at compile-time. systype oss is the default setting for c89 in the OSS environment and on UNIX workstations. freopen_guardian( ) is functionally identical to the freopen( ) function of the Guardian environment. It is the same as setting systype guardian at compile-time.
PAGE 206
freopen_oss(3) OSS Library Calls Reference Manual NAME freopen_oss - Opens a stream (OSS freopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 207
OSS Library Calls (e - f) freopen_oss(3) w+ Truncates or creates a file for update. a+ Appends (opens a file for update, writing at the end of the file, or creates a file for writing). The OSS version of freopen( ) does not distinguish between text and binary files. Specifying a value of mode that consists of a r, w, or a followed by a b indicates a binary file. When you open a file for update, you can perform both input and output operations on the resulting stream.
PAGE 208
freopen_oss(3) OSS Library Calls Reference Manual [EINTR] The function was interrupted by a signal that was caught. [EINVAL] The mode parameter is not a valid mode. [EISDIR] The named file is a directory and mode requires write access. [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process. [ENAMETOOLONG] The length of the path string exceeds PATH_MAX or a pathname component is longer than NAME_MAX. [ENFILE] Too many files are currently open in the processor.
PAGE 209
OSS Library Calls (e - f) frexp(3) NAME frexp - Breaks a floating-point number into a fraction and a power of 2 LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double frexp( double value, int *exp ); PARAMETERS value Specifies the double value to be broken into a fraction and a power of 2.
PAGE 210
frexp(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), isnan(3), ldexp(3), modf(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point format data. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point data. The XPG4 Version 2 specification allows certain features to be defined by the implementing vendor.
PAGE 211
OSS Library Calls (e - f) fscanf(3) NAME fscanf - Converts formatted input read from an input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fscanf( FILE *stream, const char *format [, *pointer] . . . ); PARAMETERS stream Specifies the input stream.
PAGE 212
fscanf(3) OSS Library Calls Reference Manual • Maximum width—if the conversion specification includes a maximum width and the field is not terminated by white space or an invalid character, then when that maximum width is reached in the input stream, the field is terminated. Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$.
PAGE 213
OSS Library Calls (e - f) • fscanf(3) A conversion code character convcode that specifies the type of conversion to be applied: % Accepts a single % (percent sign) input at this point; no assignment is done. c Accepts a single character or a series of characters. If there is either no width or a width of 1 in the conversion specification, one character is accepted and the corresponding pointer parameter should be a type char pointer.
PAGE 214
fscanf(3) OSS Library Calls Reference Manual o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer. p Matches an unsigned hexadecimal integer, the same as the %p conversion of the printf( ) function. The corresponding pointer parameter must be a pointer to a pointer to void. s Accepts a string of characters. The input field ends with a white-space character.
PAGE 215
OSS Library Calls (e - f) fscanf(3) The conversion code convcode indicates how to interpret the input field. The corresponding pointer must usually be of a restricted type. You should not specify the pointer parameter for a suppressed field. fscanf( ) processing ends at either the end of the input file, at the end of the conversion specifications, or when an input character conflicts with a conversion specification.
PAGE 216
fscanf(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), sscanf(3). STANDARDS CONFORMANCE The [EILSEQ] and [EINVAL] errno values are extensions to the POSIX standards defined in the XPG4 Version 2 specification. The POSIX standards leave some features to the implementing vendor to define.
PAGE 217
OSS Library Calls (e - f) fseek(3) NAME fseek - Repositions the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fseek( FILE ∗ stream, long int offset, int whence); PARAMETERS stream Specifies the I/O stream.
PAGE 218
fseek(3) OSS Library Calls Reference Manual Information About Guardian EDIT Files If called from a native process, the fseek( ) function can operate on Guardian EDIT files (type 101 files). The behavior of this function differs according to whether the file is opened with a Guardian connection or with an OSS connection.
PAGE 219
OSS Library Calls (e - f) fseek(3) [EIO] The process is a member of a background process group attempting to write to its controlling terminal, the TOSTOP signal is set, the process is neither ignoring nor blocking SIGTTOU, and the process group of the process is orphaned. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device.
PAGE 220
fsetpos(3) OSS Library Calls Reference Manual NAME fsetpos - Repositions the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fsetpos( FILE *stream, const fpos_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 221
OSS Library Calls (e - f) ftell(3) NAME ftell - Reports the position the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long int ftell( FILE ∗ stream); PARAMETERS stream Specifies the I/O stream.
PAGE 222
ftell(3) OSS Library Calls Reference Manual ERRORS If the following conditions occur, the ftell( ) function sets errno to the corresponding value: [EBADF] The file descriptor underlying the stream parameter is not a valid file descriptor. [ESPIPE] An illegal attempt was made to get set the file position of a pipe or FIFO. RELATED INFORMATION Functions: fgetpos(3), fopen(3), fseek(3), fsetpos(3), lseek(2), rewind(3).
PAGE 223
OSS Library Calls (e - f) ftime(3) NAME ftime - Gets date and time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ftime( struct timeb *tp); PARAMETERS tp Points to the timeb structure.
PAGE 224
ftok(3) OSS Library Calls Reference Manual NAME ftok - Generates an OSS interprocess communication (IPC) key LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include key_t ftok( const char *path_name, int id); PARAMETERS path_name Specifies the pathname of an existing file.
PAGE 225
OSS Library Calls (e - f) ftok(3) • The current working directory is assigned from the VOLUME attribute of the Guardian environment =_DEFAULTS DEFINE. • The use of static memory by the process increases slightly. These effects occur only when the first of the set of functions is called. The effects are not cumulative. NOTES The id parameter should be a single-byte character to ensure portability. CAUTIONS It is important for each installation to define standards for forming keys.
PAGE 226
ftok(3) OSS Library Calls Reference Manual • The specified file is on a remote HP NonStop server node and communication with the remote name server has been lost. [ENOTDIR] A component of the pathname pointed to by the path_name parameter is not a directory. [ENXIO] The caller’s current working directory or the root directory is not mounted. [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process was not running.
PAGE 227
OSS Library Calls (e - f) ftw(3) NAME ftw - Traverses a file tree LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int ftw( const char *path, int(*function)(const char *object, const struct stat *ptr, int flag), int ndirs); PARAMETERS path Points to the directory hierarchy to be searched. function Points to the function to be invoked for each file in the directory hierarchy.
PAGE 228
ftw(3) OSS Library Calls Reference Manual [EACCES] in errno. The ftw( ) function finishes processing a directory before processing any of its files or subdirectories. The ftw( ) function continues the search until either the directory hierarchy specified by the path parameter is completely searched, an invocation of the function specified by the function parameter returns a nonzero value, or an error is detected within ftw( ), such as an I/O error.
PAGE 229
OSS Library Calls (e - f) ftw(3) RETURN VALUES The ftw( ) function continues processing until one of the following conditions occurs; it then returns the appropriate value, as follows: • If the traversal of the directory hierarchy is complete, the ftw( ) function returns the value 0 (zero). • If the function specified by the function parameter returns a value other than 0 (zero), ftw( ) terminates its search and returns the value that was returned by function.
PAGE 230
ftw(3) OSS Library Calls Reference Manual • The specified file is on a remote HP NonStop server node and communication with the remote name server has been lost. [ENOTDIR] A component of the path parameter is not a directory. [ENXIO] The fileset containing the client’s current working directory or root directory is not mounted. In addition, if the function pointed to by the function parameter encounters an error, errno might be set accordingly.
PAGE 231
OSS Library Calls (e - f) fwrite(3) NAME fwrite - Writes to an output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t fwrite( const void ∗ pointer, size_t size, size_t num_items, FILE ∗ stream); PARAMETERS pointer Points to an array.
PAGE 232
fwrite(3) OSS Library Calls Reference Manual [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size.
PAGE 233
Section 3. OSS Library Calls (g - h) This section contains reference pages documenting library calls with English names beginning with the letter g through the letter h that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 234
gai_strerror(3) OSS Library Calls Reference Manual NAME gai_strerror - Returns error message strings for errors detected by the getaddrinfo( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include char *gai_strerror( int ecode); PARAMETERS ecode Specifies one of the following error codes; the returned strings are also shown: EAI_ADDRFAMILY Address family was not recognized or address length was invalid.
PAGE 235
OSS Library Calls (g - h) gai_strerror(3) RETURN VALUES Upon successful completion, gai_strerror( ) returns a pointer to a character string corresponding to the specified error code, as indicated in the PARAMETERS section of this reference page. Otherwise, the function returns a NULL pointer and sets errno to describe the error.
PAGE 236
gamma(3) OSS Library Calls Reference Manual NAME gamma - Computes the logarithm of the gamma function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double gamma( double x); extern int signgam; PARAMETERS x Specifies a positive double value.
PAGE 237
OSS Library Calls (g - h) gamma(3) RETURN VALUES Upon successful completion, the gamma( ) function returns the logarithmic gamma of x. For IEEE floating-point values, if the value of x is NaN, NaN is returned. If the value of x is positive infinity, NaN is returned. If the value of x is negative infinity, HUGE_VAL is returned and errno is set to [EDOM]. If the value of x is 0.0 (zero), HUGE_VAL is returned and errno is set to [EDOM].
PAGE 238
gcvt(3) OSS Library Calls Reference Manual NAME gcvt - Converts a floating-point number to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/sysnn/zcrtldll SYNOPSIS #include char *gcvt( double value, int ndigit, char *buf ); PARAMETERS value Specifies the floating-point number to be converted.
PAGE 239
OSS Library Calls (g - h) gcvt(3) RELATED INFORMATION Functions: ecvt(3), fcvt(3), fp_class(3), sprintf(3). STANDARDS CONFORMANCE The gcvt( ) function is defined in the XPG4 Version 2 specification.
PAGE 240
getaddrinfo(3) OSS Library Calls Reference Manual NAME getaddrinfo - Converts hostnames and service names into socket address information structures LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 241
OSS Library Calls (g - h) getaddrinfo(3) int ai_protocol; /* 0 or IPPROTO_xxx */ size_t ai_addrlen; /* length of ai_addr */ char *ai_canonname; /* a pointer to the canonical name for nodename */ struct sockaddr *ai_addr; /* binary address */ struct addrinfo *ai_next; /* next structure in linked list */ }; Each addrinfo struct contains the following members: ai_family A literal of the form PF_xxx, where xxx indicates the address family as a protocol family name ai_socktype A literal of the form SOCK_xx
PAGE 242
getaddrinfo(3) OSS Library Calls Reference Manual AI_V4MAPPED Requests the return of all IPv4-mapped IPv6 addresses when the address family is AF_INET6 and there are no matching IPv6 addresses. This flag is ignored if the address family is AF_INET. A TCP or UDP client typically specifies nonNULL values for both the hostname and service parameters.
PAGE 243
OSS Library Calls (g - h) getaddrinfo(3) ERRORS If the EAI_SYSTEM condition occurs, the function sets errno to the corresponding value: [ENOSPC] The buffer allocated for the return value is not large enough to contain the requested data. [EPROTOTYPE] The specified address has a different type than that of the socket bound to the specified peer address.
PAGE 244
get_assign_msg(3) OSS Library Calls Reference Manual NAME get_assign_msg - Retrieves a specified assign message LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 245
OSS Library Calls (g - h) get_assign_msg(3) short access_spec; short record_size; short block_size; } assign_msg_type; In the type assign_msg_type, the structure members provide the following information: msg_code value of -2 for an ASSIGN message. logical_unit_name name of logical unit used in program and consists of program unit and file name.
PAGE 246
get_assign_msg_by_name(3) OSS Library Calls Reference Manual NAME get_assign_msg_by_name - Retrieves assign message by logical-unit name LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 247
OSS Library Calls (g - h) getc(3) NAME getc - Gets a character from a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int getc( FILE ∗ stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 248
getc(3) OSS Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. Any error encountered during the underlying call to the read( ) function can cause this function to return the corresponding errno value reported by the read( ) function. If your application program encounters an errno value not listed above, refer to the read(2) reference page either online or in the Open System Services System Calls Reference Manual for information about the cause of that error.
PAGE 249
OSS Library Calls (g - h) getchar(3) NAME getchar - Gets a character from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int getchar(void); PARAMETERS None.
PAGE 250
getchar(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fgetc(3), getc(3), gets(3), getwc(3), putc(3), read(2). STANDARDS CONFORMANCE The [ENXIO] errno value is an extension to the POSIX standard and an optional extension in the XPG4 Version 2 specification.
PAGE 251
OSS Library Calls (g - h) getcwd(3) NAME getcwd - Gets the pathname of the current working directory LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include char *getcwd( char *buffer, size_t size); PARAMETERS buffer Points to a character array to hold the pathname. size Specifies the length of the character array in bytes.
PAGE 252
getcwd(3) OSS Library Calls Reference Manual • The current working directory is assigned from the VOLUME attribute of the Guardian environment =_DEFAULTS DEFINE. • The use of static memory by the process increases slightly. These effects occur only when the first of the set of functions is called. The effects are not cumulative. RETURN VALUES Upon successful completion, either the buffer parameter or, if buffer was a null pointer, a pointer to a buffer is returned.
PAGE 253
OSS Library Calls (g - h) [ERANGE] getcwd(3) The size parameter is greater than 0 (zero) but smaller than the length of the pathname + 1. RELATED INFORMATION Functions: chdir(2), malloc(3). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • If the buffer parameter is a null pointer, the getcwd( ) function uses the malloc( ) function to allocate a buffer.
PAGE 254
getdate(3) OSS Library Calls Reference Manual NAME getdate - Converts user format date and time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include struct tm *getdate(const char *string); extern int getdate_err; PARAMETERS string Is a pointer to a string containing date/time information.
PAGE 255
OSS Library Calls (g - h) getdate(3) %p Matches the equivalent of AM or PM in the current locale. %R Matches an appropriate representation of time for the current locale. In the POSIX locale, this is the same as %H%M. %r Matches an appropriate representation of time in the current locale’s equivalent of AM/PM notation. In the POSIX locale, this is the same as %I%M%S%p. %S Matches the seconds (00 to 61). Note that there is an allowance for two leap seconds.
PAGE 256
getdate(3) OSS Library Calls Reference Manual • When the input string contains no hour, no minutes, and no seconds, the getdate( ) function assumes the current hour, minute, and second. • When the input string contains no date, the getdate( ) function assumes today if the given hour is greater than the current hour and assumes tomorrow if it is less. NOTES The getdate( ) function uses the getdate_err external variable to return error values.
PAGE 257
OSS Library Calls (g - h) getdtablesize(3) NAME getdtablesize - Gets the file descriptor table size LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include int getdtablesize(void); DESCRIPTION The getdtablesize( ) function returns the number of file descriptors that a process may allocate. This value is one greater than the largest number that can be assigned to a newly created descriptor.
PAGE 258
getenv(3) OSS Library Calls Reference Manual NAME getenv - Returns the value of an environment variable LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *getenv( const char *name); PARAMETERS name Specifies the name of an environment variable.
PAGE 259
OSS Library Calls (g - h) getgrent(3) NAME getgrent - Gets group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 260
getgrent(3) OSS Library Calls Reference Manual NOTES The data returned by the getgrent( ) function is stored in a static area and is overwritten on subsequent calls to the getgrent( ) function. If the data needs to be saved, it must be copied. Each string pointed to by a char * field of the group structure must be copied separately; an application should not assume that the strings are contiguously located within the structure.
PAGE 261
OSS Library Calls (g - h) getgrgid(3) NAME getgrgid - Gets group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 262
getgrgid(3) OSS Library Calls Reference Manual The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string. NOTES The data returned by the getgrgid( ) function is stored in a static area and is overwritten on subsequent calls to the getgrgid( ) or getgrnam( ) function. An application should not rely on the data fields being stored contiguously.
PAGE 263
OSS Library Calls (g - h) getgrnam(3) NAME getgrnam - Gets group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 264
getgrnam(3) OSS Library Calls Reference Manual The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string. NOTES The data returned by the getgrnam( ) function is stored in a static area and is overwritten on subsequent calls to the getgrgid( ) or getgrnam( ) function. An application should not rely on the data fields being stored contiguously.
PAGE 265
OSS Library Calls (g - h) gethostbyaddr(3) NAME gethostbyaddr - Gets a network host entry by address (AF_INET only) LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include #include extern h_errno; struct hostent *gethostbyaddr ( const void *addr, size_t len, int type); PARAMETERS addr Specifies an Internet address in network-byte order. len On input, specifies the number of bytes in addr.
PAGE 266
gethostbyaddr(3) OSS Library Calls Reference Manual NO_RECOVERY A server failure occurred. This is a nonrecoverable error. TRY_AGAIN An error occurred that might have been caused by a transient condition. A later retry might succeed. FILES /etc/hosts The Internet network hostname database. Each record in the file occupies a single line and has three fields: the host address, the official hostname, and aliases. /etc/resolv.conf The resolver configuration file.
PAGE 267
OSS Library Calls (g - h) gethostbyname2(3) NAME gethostbyname2 - Gets an Internet host entry by name and IPv4 or IPv6 address family LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include extern h_errno; struct hostent *gethostbyname2 ( const char *name, int af); PARAMETERS name Points to either the official name or an alias of the host whose Internet address is to be found.
PAGE 268
gethostbyname2(3) OSS Library Calls Reference Manual NO_RECOVERY This is a nonrecoverable error. EXAMPLE This example makes a call to gethostbyname2( ) by passing the host name and address family as arguments. If an answer is found, a pointer to the hostent structure is returned and stored in hp. NULL is returned if no answer is found. int af; char *name; struct hostent *hp; hp = gethostbyname2(name, af); FILES /etc/hosts The Internet network hostname database file.
PAGE 269
OSS Library Calls (g - h) gethostbyname(3) NAME gethostbyname - Gets a host entry by name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include extern h_errno; struct hostent *gethostbyname( const char *name); PARAMETERS name Specifies the network name or alias. DESCRIPTION The gethostbyname( ) function searches host entries sequentially until a match with the name parameter occurs.
PAGE 270
gethostbyname(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: gethostbyaddr(3), endhostent(3). Files: hosts(4).
PAGE 271
OSS Library Calls (g - h) gethostent(3) NAME gethostent - Gets the next entry in the network host database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct hostent *gethostent(void) PARAMETERS None. DESCRIPTION The gethostent( ) function retrieves the next entry in /etc/hosts, the network host database.
PAGE 272
gethostid(3) OSS Library Calls Reference Manual NAME gethostid - gets the identifier for the current host. LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include long gethostid(void) DESCRIPTION The gethostid() function retrieves the 32-bit identifier for the current host. RETURN VALUES On successful completion, gethostid( ) returns a 32-bit identifier for the current host.
PAGE 273
OSS Library Calls (g - h) getipnodebyaddr(3) NAME getipnodebyaddr - Gets a network host entry by address (protocol-independent) LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include #include
PAGE 274
getipnodebyaddr(3) OSS Library Calls Reference Manual 2. If addr_family is AF_INET, the function looks up the name for the given IPv4 address. 3. If addr_family is AF_INET6, the function looks up the name for the given IPv6 address. Information returned by getipnodebyaddr( ) is dynamically allocated; the hostent structure and the data areas pointed to by the members of the hostent structure are all dynamically allocated. Use the freehostent( ) function to return memory to the system.
PAGE 275
OSS Library Calls (g - h) getipnodebyname(3) NAME getipnodebyname - Gets host information based on IP node name (protocol-independent) LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include #include
PAGE 276
getipnodebyname(3) OSS Library Calls Reference Manual AI_V4MAPPED Requests the return of all IPv4-mapped IPv6 addresses when the address family is AF_INET6 and there are no matching IPv6 addresses. This flag is ignored if the address family is AF_INET. error_num Returns an error code if the call fails. DESCRIPTION The getipnodebyname( ) function searches host entries sequentially until a match with the name parameter occurs.
PAGE 277
OSS Library Calls (g - h) getipnodebyname(3) STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
PAGE 278
get_max_assign_msg_ordinal(3) OSS Library Calls Reference Manual NAME get_max_assign_msg_ordinal - Determines number of active assign messages for a process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll | | | SYNOPSIS #include
PAGE 279
OSS Library Calls (g - h) getnameinfo(3) NAME getnameinfo - Translates protocol-independent host address to hostname LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include int getnameinfo( const struct sockaddr *sa, socklen_t salen, char *host, size_t hostlen, char *serv, size_t servlen, int flags ); PARAMETERS sa Points to the sockaddr_in or sockaddr_in6 struct containing the IP address and port number.
PAGE 280
getnameinfo(3) OSS Library Calls Reference Manual NI_NUMERICHOST Return the numeric form of the host address instead of the host name. NI_NUMERICSERV Return the numeric port number instead of the service name. DESCRIPTION This function uses a socket address to search for a hostname and service name. Given a binary IPv4 or IPv6 address and port number, it returns the corresponding hostname and service name from a name resolution service, the /etc/ipnodes file, or the /etc/hosts file.
PAGE 281
OSS Library Calls (g - h) getnameinfo(3) all other error codes Unknown error. ERRORS If the EAI_SYSTEM condition occurs, the function sets errno to the corresponding value: [ENOSPC] The buffer allocated for the returned value is not large enough to contain the requested data. [EPROTOTYPE] The specified address has a different type than that of the socket bound to the specified peer address.
PAGE 282
getnetbyaddr(3) OSS Library Calls Reference Manual NAME getnetbyaddr - Gets a network entry by address LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include #include
PAGE 283
OSS Library Calls (g - h) getnetbyname(3) NAME getnetbyname - Gets a network entry by name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct netent *getnetbyname ( const char *name); PARAMETERS name Specifies the network name or alias. DESCRIPTION The getnetbyname( ) function searches the /etc/networks file sequentially until a match with the name parameter is found.
PAGE 284
getnetent(3) OSS Library Calls Reference Manual NAME getnetent - Gets the next entry in the network database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct netent *getnetent(void); DESCRIPTION The getnetent( ) function retrieves the next entry in the /etc/networks file. The getnetent( ) function returns a pointer to a netent structure, whose members specify information about a network.
PAGE 285
OSS Library Calls (g - h) getopt(3) NAME getopt - Gets flag letters from the argument vector LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 286
getopt(3) OSS Library Calls Reference Manual #define ARGS "r:w:f:s" { int int int int c, errflg = 0; readers = 1, writers = 1; freeBufs = 1; doStats = FALSE; optarg = NULL; while (!errflg && (c = getopt(argc, argv, ARGS)) != -1) switch (c) { case ’r’ : readers = atoi(optarg); break; case ’w’ : writers = atoi(optarg); break; case ’f’ : freeBufs = atoi(optarg); break; case ’s’ : doStats = TRUE; break; default : errflg++; } NOTES The external int optopt variable is set to the real flag found in the argv
PAGE 287
OSS Library Calls (g - h) • getopt(3) The argv[optind] result points to the - (dash) string. The getopt( ) function does increment optind if the result of argv[optind] points to the -- (dash dash) string. RELATED INFORMATION Commands: getopt(1).
PAGE 288
getpagesize(3) OSS Library Calls Reference Manual NAME getpagesize - Gets the current page size LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include int getpagesize(void); DESCRIPTION The getpagesize( ) function returns the current operating system page size. The value returned by getpagesize( ) need not be the minimum value that malloc( ) can allocate.
PAGE 289
OSS Library Calls (g - h) get_param_by_name(3) NAME get_param_by_name - Retrieves value of a parameter by parameter name LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 290
get_param_msg(3) OSS Library Calls Reference Manual NAME get_param_msg - Retrieves the param message LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 291
OSS Library Calls (g - h) get_param_msg(3) RELATED INFORMATION Functions: get_assign_msg(3), get_assign_msg_by_name(3), get_max_assign_msg_ordinal(3), get_param_by_name(3), get_startup_msg(3). STANDARDS CONFORMANCE The get_param_msg( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 292
getpass(3) OSS Library Calls Reference Manual NAME getpass - Reads a string of characters (such as a password) without echoing LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include char *getpass( const char *prompt); PARAMETERS prompt Points to the prompt string that is written to the controlling terminal.
PAGE 293
OSS Library Calls (g - h) [EIO] getpass(3) One of the following conditions exists: • The process is a background process that is attempting to read from its controlling terminal. • The process is ignoring or blocking the SIGTTIN signal. • The process group has become an orphaned process group. [EMFILE] OPEN_MAX file descriptors are currently open in the calling process. No more file opens can occur. [ENFILE] Too many files are currently open in the processor.
PAGE 294
getprotobyname(3) OSS Library Calls Reference Manual NAME getprotobyname - Gets a protocol entry by name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct protoent *getprotobyname( const char *name); PARAMETERS name Specifies the protocol name or alias. DESCRIPTION The getprotobyname( ) function searches the network protocols database file /etc/protocols sequentially until a match with name is found.
PAGE 295
OSS Library Calls (g - h) getprotobynumber(3) NAME getprotobynumber - Gets a protocol entry by number LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct protoent *getprotobynumber( int num); PARAMETERS num Specifies the protocol number. DESCRIPTION The getprotobynumber( ) function searches the /etc/protocols file starting at the first entry until a match with the num parameter is found.
PAGE 296
getprotoent(3) OSS Library Calls Reference Manual NAME getprotoent - Gets the next protocol entry LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct protoent *getprotoent(void); DESCRIPTION The getprotoent( ) (get protocol entry) function retrieves the next entry from /etc/protocols, the network protocol database.
PAGE 297
OSS Library Calls (g - h) getpwent(3) NAME getpwent - Gets user attribute information from the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 298
getpwent(3) OSS Library Calls Reference Manual Use From the Guardian Environment The getpwent( ) function can be used by a Guardian process when the process has been compiled using the #define _XOPEN_SOURCE_EXTENDED 1 feature-test macro or an equivalent compiler command option. NOTES All information generated by the getpwent( ) function is stored in a static area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 299
OSS Library Calls (g - h) getpwnam(3) NAME getpwnam - Gets user attribute information from the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 300
getpwnam(3) OSS Library Calls Reference Manual OSS user authentication database functions do not leave the database open between calls. Authentication records for user aliases follow regular user authentication records in the database. NOTES All information generated by the getpwnam( ) function is stored in a static area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 301
OSS Library Calls (g - h) getpwuid(3) NAME getpwuid - Gets user attribute information from the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 302
getpwuid(3) OSS Library Calls Reference Manual OSS user authentication database functions do not leave the database open between calls. Authentication records for user aliases follow regular user authentication records in the database. NOTES All information generated by the getpwuid( ) function is stored in a static area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 303
OSS Library Calls (g - h) gets(3) NAME gets - Gets a string from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char ∗ gets( char ∗ string); PARAMETERS string Points to a string to receive bytes.
PAGE 304
gets(3) OSS Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. Any error encountered during the underlying call to the read( ) function can cause this function to return the corresponding errno value reported by the read( ) function. If your application program encounters an errno value not listed above, refer to the read(2) reference page either online or in the Open System Services System Calls Reference Manual for information about the cause of that error.
PAGE 305
OSS Library Calls (g - h) getservbyname(3) NAME getservbyname - Gets a network service entry by name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct servent *getservbyname( const char *name, const char *proto); PARAMETERS name Specifies the services name or the services alias name. proto Specifies the name of the protocol to use when contacting the service.
PAGE 306
getservbyport(3) OSS Library Calls Reference Manual NAME getservbyport - Gets a network service entry by port number LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct servent *getservbyport ( int port, const char *proto); PARAMETERS port Specifies the port number for the service, in network-byte order. proto Specifies the protocol name to use when contacting the service.
PAGE 307
OSS Library Calls (g - h) getservent(3) NAME getservent - Gets the next entry from the network services database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include struct servent *getservent(void); PARAMETERS None. DESCRIPTION The getservent( ) (get service entry) function reads the next line of the /etc/services file.
PAGE 308
get_startup_msg(3) OSS Library Calls Reference Manual NAME get_startup_msg - Retrieves the process startup message LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 309
OSS Library Calls (g - h) get_startup_msg(3) char volume[8]; char subvolume[8]; char file[8]; } parts; } outfile; char param[530]; } startup_msg_type; In the type startup_msg_type, the structure members provide the following information: msg_code message type; -1 means a startup message. defaults default volume and subvolume names. infile volume, subvolume, and file name of input file. outfile volume, subvolume, and file name of output file. param[530] text of message. EXAMPLES 1.
PAGE 310
get_startup_msg(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The get_startup_msg( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 311
OSS Library Calls (g - h) getsubopt(3) NAME getsubopt - Parses suboption arguments from a string LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include int getsubopt( char **optionp, char * const *tokens, char **valuep); PARAMETERS optionp Is the address of a pointer to the option argument string. tokens Is a vector of possible tokens.
PAGE 312
getw(3) OSS Library Calls Reference Manual NAME getw - Gets a word from an input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll | | | SYNOPSIS #include int getw( FILE *stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 313
OSS Library Calls (g - h) getw(3) RELATED INFORMATION Functions: fgetc(3), getc(3), getchar(3), gets(3), getwc(3), putc(3). STANDARDS CONFORMANCE The [ENXIO] errno value is an extension to the POSIX standard and an optional extension in the XPG4 specification.
PAGE 314
getwc(3) OSS Library Calls Reference Manual NAME getwc - Gets a wide character from a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t getwc( FILE *stream); PARAMETERS stream Specifies the input data.
PAGE 315
OSS Library Calls (g - h) getwchar(3) NAME getwchar - Gets a wide character from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t getwchar(void); PARAMETERS None.
PAGE 316
getwd(3) OSS Library Calls Reference Manual NAME getwd - Gets the pathname of the current working directory LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include char *getwd(char *path_name); PARAMETERS path_name Is a pointer to an array, which can contain a pathname.
PAGE 317
OSS Library Calls (g - h) getws(3) NAME getws - Gets a wide character string from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *getws( wchar_t *string); PARAMETERS wstring Points to a string to receive characters.
PAGE 318
gfileno(3) OSS Library Calls Reference Manual NAME gfileno - Maps a stream pointer to a Guardian file number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int gfileno( FILE *stream); PARAMETERS stream Specifies the open stream.
PAGE 319
OSS Library Calls (g - h) glob(3) NAME glob - Generates pathnames matching a pattern LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int glob( const char *pattern, int flags, int (*errfunc)(constr char *epath, int eerrno), glob_t *pglob); PARAMETERS pattern Contains the filename pattern to compare against accessible pathnames. flags Controls the customizable behavior of the glob( ) function.
PAGE 320
glob(3) OSS Library Calls Reference Manual gl_pathv A pointer to the list of matching pathnames. gl_offs The number of entries in the gl_pathv list reserved for matching pathnames. gl_padr A pointer to the structure that contains the addresses of matching pathnames. gl_ptx A pointer to the first text buffer containing a matching pathname. The matching pathnames are sorted, based on the setting of the LC_COLLATE category in the current locale.
PAGE 321
OSS Library Calls (g - h) glob(3) • If the application did not set the GLOB_DOOFFS flag in the first call to the glob( ) function, then the flag is not set in the second call.
PAGE 322
glob(3) OSS Library Calls Reference Manual EXAMPLES Note that the pglob parameter has meaning even if the glob( ) function fails. This allows the glob( ) function to report partial results in the event of an error. However, if the number of matched pathnames is 0 (zero), the pointer in the pglob parameter is unspecified even if the glob( ) function did not return an error.
PAGE 323
OSS Library Calls (g - h) glob(3) GLOB_NOSPACE Indicates an attempt to allocate memory failed. A call to the malloc( ) function failed and the function given by the *errfunc parameter was called with an errno value of [ENOMEM]. If, during the search, a directory is encountered that cannot be opened or read and the errfunc parameter is not null, the glob( ) function calls the function inidcated by errfunc with two parameters: epath Specifies the pathname that failed.
PAGE 324
globfree(3) OSS Library Calls Reference Manual NAME globfree - Frees all memory associated with the pglob parameter LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include void globfree( glob_t *pglob); PARAMETERS pglob Points to a structure that contains the results of a previous call to the glob( ) function.
PAGE 325
OSS Library Calls (g - h) gmtime(3) NAME gmtime - Converts time since the Epoch to broken-down Coordinated Universal Time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include struct tm *gmtime( const time_t *timer); PARAMETERS timer Points to a variable that specifies a time value in seconds.
PAGE 326
hcreate(3) OSS Library Calls Reference Manual NAME hcreate - Initializes a hash table LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int hcreate( size_t nel); PARAMETERS nel Specifies an estimate of the maximum number of entries that the hash table will contain.
PAGE 327
OSS Library Calls (g - h) hdestroy(3) NAME hdestroy - Removes a hash table LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void hdestroy(void); PARAMETERS None. DESCRIPTION The hsearch( ), hcreate( ), and hdestroy( ) functions are used to manage hash table operations.
PAGE 328
heap_check(3) OSS Library Calls Reference Manual NAME heap_check - Checks the consistency of the run-time heap LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void heap_check(void); PARAMETERS None.
PAGE 329
OSS Library Calls (g - h) heap_check_always(3) NAME heap_check_always - Controls whether the run-time heap consistency is checked automatically LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include
PAGE 330
heap_min_block_size(3) OSS Library Calls Reference Manual NAME heap_min_block_size - Specifies the minimum block size to attempt to use when allocating from the heap LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 331
OSS Library Calls (g - h) hsearch(3) NAME hsearch - Searches a hash table LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include ENTRY *hsearch( ENTRY item, ACTION action); PARAMETERS item Identifies a structure of the type ENTRY as defined in the search.h header file.
PAGE 332
hsearch(3) [ESRCH] OSS Library Calls Reference Manual The search failed. RELATED INFORMATION Functions: bsearch(3), hcreate(3), hdestroy(3), lsearch(3), tsearch(3), qsort(3).
PAGE 333
OSS Library Calls (g - h) htonl(3) NAME htonl - Converts a 32-bit integer from host byte order to Internet network byte order LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_addr_t htonl( in_addr_t hostlong); PARAMETERS hostlong Specifies a 32-bit integer in host byte order.
PAGE 334
htons(3) OSS Library Calls Reference Manual NAME htons - Converts a 16-bit integer from host byte order to Internet network byte order LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_port_t htons( in_port_t hostshort); PARAMETERS hostshort Specifies a 16-bit integer in host byte order.
PAGE 335
OSS Library Calls (g - h) hypot(3) NAME hypot - Computes the Euclidean distance function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double hypot( double x, double y ); PARAMETERS x Specifies a double value. y Specifies a double value.
PAGE 336
hypot(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 3−104 • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 337
Section 4. OSS Library Calls (i - m) This section contains reference pages documenting library calls with English names beginning with the letter i through the letter m that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 338
iconv(3) OSS Library Calls Reference Manual NAME iconv - Converts a string of characters from one character code set to another character code set LIBRARY G-series native OSS processes: /G/system/sysnn/zicnvsrl H-series OSS processes: /G/system/zdllnnn/zicnvdll SYNOPSIS #include size_t iconv( iconv_t cd, char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft); PARAMETERS cd Specifies the conversion descriptor that points to the correct code set converter.
PAGE 339
OSS Library Calls (i - m) iconv(3) [EBADF] The cd parameter does not specify a valid converter descriptor. [EILSEQ] An input character does not belong to the input code set or a valid input character that does not have a valid counterpart in the target code set. No conversion is attempted on the input character and inbytesleft indicates the bytes left to be converted, including the first byte of the invalid character. The inbuf parameter points to the first byte of the invalid character sequence.
PAGE 340
iconv_close(3) OSS Library Calls Reference Manual NAME iconv_close - Closes a specified code-set converter LIBRARY G-series native OSS processes: /G/system/sysnn/zicnvsrl H-series OSS processes: /G/system/zdllnnn/zicnvdll SYNOPSIS #include int iconv_close( iconv_t cd); PARAMETERS cd Specifies the conversion descriptor to be closed. DESCRIPTION The iconv_close( ) function closes a converter previously opened with iconv_open( ) and deallocates any resources used by the specified converter.
PAGE 341
OSS Library Calls (i - m) iconv_open(3) NAME iconv_open - Opens a character code-set converter LIBRARY G-series native OSS processes: /G/system/sysnn/zicnvsrl H-series OSS processes: /G/system/zdllnnn/zicnvdll SYNOPSIS #include iconv_t iconv_open( const char *tocode, const char *fromcode); PARAMETERS tocode Specifies the destination code set. fromcode Specifies the originating code set. DESCRIPTION The iconv_open( ) function initializes code-set converters.
PAGE 342
iconv_open(3) OSS Library Calls Reference Manual [ENFILE] Specifies that too many files are currently open in the processor. [ENOMEM] Specifies that insufficient storage space is available. [EINVAL] Specifies that the conversion specified by the fromcode and tocode parameters is not supported by the implementation. RELATED INFORMATION Commands: genxlt(1), iconv(1). Functions: iconv(3), iconv_close(3).
PAGE 343
OSS Library Calls (i - m) if_freenameindex(3) NAME if_freenameindex - Frees dynamic memory allocated by the if_nameindex() function LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void if_freenameindex( struct if_nameindex *ptr); PARAMETERS ptr Specifies the address pointer returned by the if_nameindex( ) function for which storage should be returned to the system.
PAGE 344
if_indextoname(3) OSS Library Calls Reference Manual NAME if_indextoname - Maps an interface index to its corresponding name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 345
OSS Library Calls (i - m) [ENXIO] if_indextoname(3) There is no interface corresponding to the index specified by the ifindex parameter. RELATED INFORMATION Functions: freeaddrinfo(3), freehostent(3), gai_strerror(3), getaddrinfo(3), getipnodebyaddr(3), getipnodebyname(3), getnameinfo(3), if_freenameindex(3), if_nameindex(3), if_nametoindex(3), inet_pton(3), inet_ntop(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
PAGE 346
if_nameindex(3) OSS Library Calls Reference Manual NAME if_nameindex - Gets all interface names and indexes LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include #include struct if_nameindex *if_nameindex( void); DESCRIPTION When an interface (subnet) is created, it is assigned a unique number called an interface index.
PAGE 347
OSS Library Calls (i - m) if_nameindex(3) [ENOMEM] Either no memory is available to complete the request or a system error occurred. [ENXIO] There is no interface corresponding to the index specified by the ifindex parameter. RELATED INFORMATION Functions: freeaddrinfo(3), freehostent(3), gai_strerror(3), getaddrinfo(3), getnameinfo(3), getipnodebyaddr(3), getipnodebyname(3), if_indextoname(3), if_nameindex(3), if_nametoindex(3), inet_pton(3), inet_ntop(3).
PAGE 348
if_nametoindex(3) OSS Library Calls Reference Manual NAME if_nametoindex - Maps an interface name to its corresponding index LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include unsigned int if_nametoindex( const char *ifname); PARAMETERS ifname Specifies the name of the interface (subnet) to be mapped to an index number. The name specified cannot be larger than IFNAMSIZ, as defined in the if.h header file.
PAGE 349
OSS Library Calls (i - m) if_nametoindex(3) RELATED INFORMATION Functions: freeaddrinfo(3), gai_strerror(3), getaddrinfo(3), getnameinfo(3), if_freenameindex(3), if_indextoname(3), if_nameindex(3), inet_pton(3), inet_ntop(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
PAGE 350
ilogb(3) OSS Library Calls Reference Manual NAME ilogb - Computes the radix-independent exponent as an integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/sysnn/zcredll SYNOPSIS #include int ilogb( double x); PARAMETERS x Specifies the value for which the exponent is to be calculated.
PAGE 351
OSS Library Calls (i - m) index(3) NAME index - Scans string for a first occurrence of a character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/sysnn/zcredll SYNOPSIS #include char *index ( const char *s, int c); PARAMETERS s Is a pointer to the string to be scanned. c Is the character being scanned for.
PAGE 352
inet_addr(3) OSS Library Calls Reference Manual NAME inet_addr - Constructs an integer Internet IPv4 address from a character string in standard dotted-decimal notation LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_addr_t inet_addr ( const char *string); PARAMETERS string An Internet dot-formatted address character string.
PAGE 353
OSS Library Calls (i - m) inet_lnaof(3) NAME inet_lnaof - Extracts the local network address from an Internet IPv4 host address LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_addr_t inet_lnaof ( struct in_addr net_addr); PARAMETERS net_addr An Internet host address.
PAGE 354
inet_makeaddr(3) OSS Library Calls Reference Manual NAME inet_makeaddr - Constructs an Internet IPv4 address from an Internet network number and a local network address LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/systemzdllsnnn/zinetdll SYNOPSIS #include struct in_addr inet_makeaddr ( in_addr_t net_num, in_addr_t loc_addr ); PARAMETERS net_num An Internet network number in host-byte order. loc_addr A local address in host-byte order.
PAGE 355
OSS Library Calls (i - m) inet_netof(3) NAME inet_netof - Extracts the network number from an Internet IPv4 host address LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_addr_t inet_netof ( struct in_addr net_addr ); PARAMETERS net_addr An Internet host address.
PAGE 356
inet_network(3) OSS Library Calls Reference Manual NAME inet_network - Translates a string in Internet dotted-decimal notation to an Internet IPv4 network address LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_addr_t inet_network ( char *string ); PARAMETERS string An Internet dot-formatted address.
PAGE 357
OSS Library Calls (i - m) inet_ntoa(3) NAME inet_ntoa - Translates an integer Internet IPv4 address into a dotted-decimal-formatted character string LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include char *inet_ntoa ( struct in_addr net_addr); PARAMETERS net_addr An Internet host address.
PAGE 358
inet_ntop(3) OSS Library Calls Reference Manual NAME inet_ntop - Converts an IPv6 or IPv4 binary address to a character string LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 359
OSS Library Calls (i - m) inet_ntop(3) RELATED INFORMATION Functions: freeaddrinfo(3), gai_strerror(3), getaddrinfo(3), getnameinfo(3), if_freenameindex(3), if_indextoname(3), if_nameindex(3), if_nametoindex(3), inet_pton(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
PAGE 360
inet_pton(3) OSS Library Calls Reference Manual NAME inet_pton - Converts a character string to an IPv6 or IPv4 binary address LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 361
OSS Library Calls (i - m) inet_pton(3) RETURN VALUES Upon successful completion, this function returns a 1. Otherwise, this function returns: 0 The dst parameter specifies an invalid address string. -1 The af parameter specifies an invalid address family. If -1 is returned, errno is also set. ERRORS If any of these conditions occurs, the function sets errno to the corresponding value: [EAFNOSUPPORT] The value specified for the af parameter is not valid.
PAGE 362
initstate(3) OSS Library Calls Reference Manual NAME initstate - Initialize random number generator LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *initstate ( unsigned int seed, char *state, size_t size); PARAMETERS seed Is an unsigned int used to initialize a state array.
PAGE 363
OSS Library Calls (i - m) insque(3) NAME insque, remque - Inserts or removes an element in a queue LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/sysnn/zosshdll SYNOPSIS #include void insque( void *element, void *pred); void remque( void *lement); PARAMETERS element Is a pointer to an element to be inserted in or removed from a doubly linked list. pred Is a pointer to an item in a doubly linked list.
PAGE 364
insque(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The following is an HP extension to the XPG4 Version 2 specification: • 4−28 The behavior of the remque( ) function when removing the last element of a queue is an HP extension.
PAGE 365
OSS Library Calls (i - m) isalnum(3) NAME isalnum - Tests for an alphanumeric character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isalnum( int c); PARAMETERS c Specifies the character to be tested.
PAGE 366
isalpha(3) OSS Library Calls Reference Manual NAME isalpha - Tests for alphabetic character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isalpha( int c); PARAMETERS c Specifies the character to be tested.
PAGE 367
OSS Library Calls (i - m) isascii(3) NAME isascii - Tests for ASCII character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isascii( int c); PARAMETERS c Specifies the character to be tested.
PAGE 368
isatty(3) OSS Library Calls Reference Manual NAME isatty - Tests for a terminal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int isatty( int filedes); PARAMETERS filedes Specifies an open file descriptor.
PAGE 369
OSS Library Calls (i - m) iscntrl(3) NAME iscntrl - Tests for control character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iscntrl( int c); PARAMETERS c Specifies the character to be tested.
PAGE 370
isdigit(3) OSS Library Calls Reference Manual NAME isdigit - Tests for a digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isdigit( int c); PARAMETERS c Specifies the character to be tested.
PAGE 371
OSS Library Calls (i - m) isgraph(3) NAME isgraph - Tests for a graphic character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isgraph( int c); PARAMETERS c Specifies the character to be tested.
PAGE 372
islower(3) OSS Library Calls Reference Manual NAME islower - Test for lowercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int islower( int c); PARAMETERS c Specifies the character to be tested.
PAGE 373
OSS Library Calls (i - m) isnan(3) NAME isnan - Tests whether a value is NaN (not a number) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int isnan( double x); PARAMETERS x Specifies a double-precision floating-point value.
PAGE 374
isprint(3) OSS Library Calls Reference Manual NAME isprint - Tests for printable character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isprint( int c); PARAMETERS c Specifies the character to be tested.
PAGE 375
OSS Library Calls (i - m) ispunct(3) NAME ispunct - Test for a punctuation character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ispunct( int c); PARAMETERS c Specifies the character to be tested.
PAGE 376
isspace(3) OSS Library Calls Reference Manual NAME isspace - Tests for a white space character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isspace( int c); PARAMETERS c Specifies the character to be tested.
PAGE 377
OSS Library Calls (i - m) isupper(3) NAME isupper - Test for an uppercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isupper( int c); PARAMETERS c Specifies the character to be tested.
PAGE 378
iswalnum(3) OSS Library Calls Reference Manual NAME iswalnum - Tests for an alphanumeric wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswalnum( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 379
OSS Library Calls (i - m) iswalpha(3) NAME iswalpha - Tests for an alphabetic wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswalpha( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 380
iswcntrl(3) OSS Library Calls Reference Manual NAME iswcntrl - Tests for a wide control character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswcntrl( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 381
OSS Library Calls (i - m) iswctype(3) NAME iswctype - Determines the properties of a wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswctype( wint_t wc, wctype_t wc_prop); PARAMETERS wc Specifies the wide character to be tested.
PAGE 382
iswdigit(3) OSS Library Calls Reference Manual NAME iswdigit - Tests for a wide digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/ZDLLnnn/zcrtldll SYNOPSIS #include int iswdigit( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 383
OSS Library Calls (i - m) iswgraph(3) NAME iswgraph - Tests for wide graphic character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswgraph( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 384
iswlower(3) OSS Library Calls Reference Manual NAME iswlower - Tests for a wide lowercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswlower( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 385
OSS Library Calls (i - m) iswprint(3) NAME iswprint - Tests for a printable wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswprint( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 386
iswpunct(3) OSS Library Calls Reference Manual NAME iswpunct - Tests for a wide punctuation character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswpunct( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 387
OSS Library Calls (i - m) iswspace(3) NAME iswspace - Test for a wide white-space character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswspace( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 388
iswupper(3) OSS Library Calls Reference Manual NAME iswupper - Tests for a wide uppercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswupper( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 389
OSS Library Calls (i - m) iswxdigit(3) NAME iswxdigit - Tests for a wide hexadecimal-digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswxdigit( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 390
isxdigit(3) OSS Library Calls Reference Manual NAME isxdigit - Tests for a hexadecimal digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isxdigit( int c); PARAMETERS c Specifies the character to be tested.
PAGE 391
OSS Library Calls (i - m) j0(3) NAME j0 - Computes the Bessel function of the first kind, of order 0 (zero) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double j0( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 392
j0(3) OSS Library Calls Reference Manual • 4−56 errno is not set to [ERANGE] when underflow occurs.
PAGE 393
OSS Library Calls (i - m) j1(3) NAME j1 - Computes the Bessel function of the first kind, of order 1 LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double j1( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 394
j1(3) OSS Library Calls Reference Manual • 4−58 errno is not set to [ERANGE] when underflow occurs.
PAGE 395
OSS Library Calls (i - m) jn(3) NAME jn - Computes the Bessel function of the first kind, of order n LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double jn( int n, double x); PARAMETERS n Is an integer value specifying the order number.
PAGE 396
jn(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 4−60 • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 397
OSS Library Calls (i - m) jrand48(3) NAME jrand48 - Generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 398
jrand48(3) OSS Library Calls Reference Manual Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The jrand48( ) function returns signed long integers uniformly distributed over the range $-2 sup 31˜<=˜y˜<˜2 sup 31$. RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), lcong48(3), lrand48(3), mrand48(3), nrand48(3), rand(3), seed48(3), srand48(3).
PAGE 399
OSS Library Calls (i - m) l64a(3) NAME l64a - Converts a 32-bit integer to a radix-64 ASCII string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *l64a(long value); PARAMETERS value Is a long value to be converted to radix-64 ASCII notation.
PAGE 400
labs(3) OSS Library Calls Reference Manual NAME labs - Computes absolute value of long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include long labs( long i); PARAMETERS i Specifies a long integer. DESCRIPTION The labs( ) function returns the absolute value of its long integer operand.
PAGE 401
OSS Library Calls (i - m) lcong48(3) NAME lcong48 - Sets rule to generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 402
lcong48(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 403
OSS Library Calls (i - m) ldexp(3) NAME ldexp - Multiplies a floating-point number by a power of 2 LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double ldexp( double value, int exp ); PARAMETERS value Specifies the value to be multiplied by a power of 2. exp Specifies the exponent for 2.
PAGE 404
ldexp(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point data. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point data. The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 405
OSS Library Calls (i - m) ldiv(3) NAME ldiv - Divides long integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include ldiv_t ldiv ( long numerator, long denominator); | PARAMETERS numerator Specifies a long integer. denominator Specifies a long integer.
PAGE 406
lfind(3) OSS Library Calls Reference Manual NAME lfind - Performs a linear search LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 407
OSS Library Calls (i - m) lgamma(3) NAME lgamma - Computes the logarithm of the gamma function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double lgamma( double x); extern int signgam; PARAMETERS x Specifies a positive double value.
PAGE 408
lgamma(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completion, the lgamma( ) function returns the logarithmic gamma of x. For IEEE floating-point values, if the value of x is NaN, NaN is returned. If the value of x is positive infinity, NaN is returned. If the value of x is negative infinity, HUGE_VAL is returned and errno is set to [EDOM]. If the value of x is 0.0 (zero), HUGE_VAL is returned and errno is set to [EDOM].
PAGE 409
OSS Library Calls (i - m) lldiv(3) NAME lldiv - Divides long long integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include lldiv_t lldiv ( long long numerator, long long denominator); PARAMETERS numerator Specifies a long long integer. denominator Specifies a long long integer.
PAGE 410
localeconv(3) OSS Library Calls Reference Manual NAME localeconv - Retrieves locale-dependent formatting parameters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include struct lconv *localeconv(void); PARAMETERS None.
PAGE 411
OSS Library Calls (i - m) localeconv(3) char *mon_grouping A string whose elements indicate the size of each group of digits in formatted monetary quantities. char *positive_sign The string used to indicate a nonnegative formatted monetary quantity. char *negative_sign The string used to indicate a negative formatted monetary quantity. char int_frac_digits The number of fractional digits (those to the right of the decimal point) to be displayed in an internationally formatted monetary quantity.
PAGE 412
localeconv(3) OSS Library Calls Reference Manual _TANDEM_SOURCE, do not specify the leading two underscore characters. The elements of grouping and mon_grouping are interpreted according to the following: CHAR_MAX No further grouping is to be performed. 0 The previous element is to be repeatedly used for the remainder of the digits. other The integer value is the number of digits that comprise the current group.
PAGE 413
OSS Library Calls (i - m) localtime(3) NAME localtime - Converts time since the Epoch to broken-down local time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include struct tm *localtime( const time_t *timer); PARAMETERS timer Points to a variable that specifies a time value in seconds.
PAGE 414
log10(3) OSS Library Calls Reference Manual NAME log10 - Computes the base 10 logarithm function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double log10( double x); PARAMETERS x Specifies a double value. DESCRIPTION The log10( ) function computes the base 10 logarithm of x.
PAGE 415
OSS Library Calls (i - m) log10(3) The XPG4 specification leaves some features to the implementing vendor to define. The following feature is affected in the HP implementation: • 527187-004 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 416
log1p(3) OSS Library Calls Reference Manual NAME log1p - Computes the natural logarithm function of 1.0 plus x LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double log1p( double x); PARAMETERS x Is the value for which the natural logarithm is to be calculated.
PAGE 417
OSS Library Calls (i - m) log(3) NAME log - Computes the natural logarithm function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double log( double x); PARAMETERS x Specifies a double value. DESCRIPTION The log( ) function computes the natural logarithm of x.
PAGE 418
log(3) OSS Library Calls Reference Manual The XPG4 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 4−82 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 419
OSS Library Calls (i - m) logb(3) NAME logb - Computes the radix-independent exponent as a floating-point number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double logb( double x); PARAMETERS x Specifies the value for which the exponent is to be calculated.
PAGE 420
logb(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), ilogb(3), isnan(3). STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 4−84 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 421
OSS Library Calls (i - m) longjmp(3) NAME longjmp - Performs a nonlocal goto LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include void longjmp( jmp_buf env, int value); PARAMETERS env Specifies the address of a jmp_buf structure containing the environment to be restored.
PAGE 422
longjmp(3) OSS Library Calls Reference Manual This condition might also cause unexpected process termination. If the procedure has been exited, the results are unpredictable. RETURN VALUES After the longjmp( ) function is finished, program execution continues as if the corresponding call of the setjmp( ) function had just returned the value specified by the value parameter.
PAGE 423
OSS Library Calls (i - m) longlong_to_dec(3) NAME longlong_to_dec - Converts a C long long value to a SQL DECIMAL value and stores it in a C array of type decimal LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include
PAGE 424
longlong_to_dec(3) OSS Library Calls Reference Manual 2 Indicates that the ary_size parameter had an invalid value. An invalid value is less than zero or greater than 19. 3 Indicates that ll_val was negative, but sign_type was 0 (zero). (This is a request for conversion to an unsigned SQL DECIMAL value.) 4 Indicates that the sign_type parameter had an invalid value.
PAGE 425
OSS Library Calls (i - m) lrand48(3) NAME lrand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 426
lrand48(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), mrand48(3), nrand(3), rand(3), seed48(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 427
OSS Library Calls (i - m) lsearch(3) NAME lsearch - Performs a linear search and update LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 428
lsearch(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: bsearch(3), hsearch(3), find(3), tsearch(3), qsort(3).
PAGE 429
OSS Library Calls (i - m) lwres_freeaddrinfo(3) NAME lwres_freeaddrinfo - Frees the memory of one or more addrinfo structures previously created by the lwres_getaddrinfo function LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void lwres_freeaddrinfo ( struct addrinfo * ai ); PARAMETERS ai Specifies the addrinfo structure to be freed.
PAGE 430
lwres_freehostent(3) OSS Library Calls Reference Manual NAME lwres_freehostent - Frees the memory of one or more hostent structures returned by the lwres_getipnodebyaddr() or lwres_getipnodebyname() functions LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include void lwres_freehostent ( struct hostent * ptr ); PARAMETERS ptr Points to the hostent structure that is to be freed.
PAGE 431
OSS Library Calls (i - m) lwres_gai_strerror(3) NAME lwres_gai_strerror - Aids applications in printing error messages based on the EAI_ codes returned by the lwres_getaddrinfo() function LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 432
lwres_gai_strerror(3) OSS Library Calls Reference Manual RETURN VALUES The lwres_gai_strerror( ) function call returns a pointer to a character string describing the error code passed into it. ERRORS The message invalid error code is returned if ecode is out of range.
PAGE 433
OSS Library Calls (i - m) lwres_getaddrinfo(3) NAME lwres_getaddrinfo - Converts host names and service names into socket address structures LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include netdb.
PAGE 434
lwres_getaddrinfo(3) OSS Library Calls Reference Manual This function provides the same information as the getaddrinfo( ) function but uses the Domain Name System (DNS) lightweight resolver server lwresd instead of the named DNS server. RETURN VALUES lwres_getaddrinfo ) returns 0 (zero) on success or one of the error codes listed in the ERRORS section of this reference page if an error occurs. ERRORS EAI_ADDRFAMILY Address family for host name not supported.
PAGE 435
OSS Library Calls (i - m) lwres_getaddrinfo(3) s = socket(ainfo->ai_family, ainfo->ai_socktype, ainfo->ai_protocol); if (connect(s, ainfo->ai_addr, ainfo->ai_addrlen) == -1) { perror(argv[0]); fprintf(stderr, "unable to connect0); FILE_CLOSE(S); continue; } else break; } RELATED INFORMATION Functions: getaddrinfo(3), lwres_gai_strerror(3), lwres_gethostbyname(3), lwres_getipnodebyname(3).
PAGE 436
lwres_gethostbyaddr(3) OSS Library Calls Reference Manual NAME lwres_gethostbyaddr - Gets the name of the host with the specified Internet address and address family LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include extern lwres_h_errno struct hostent *lwres_gethostbyaddr ( const void *addr, size_t len, int type ); PARAMETERS addr Points to the Internet address of the host whose name is to be found.
PAGE 437
OSS Library Calls (i - m) lwres_gethostbyaddr(3) NO_RECOVERY A nonrecoverable error occurred. NO_DATA The name exists, but has no address information associated with it (or vice versa in the case of a reverse lookup). The value NO_ADDRESS is accepted as a synonym for NO_DATA for backwards compatibility. EXAMPLE char *addr; int len, type; struct hostent *hp; hp = lwres_gethostbyaddr(addr, len, type); The above example makes a call to lwres_gethostbyaddr( ) by passing the Internet address as an argument.
PAGE 438
lwres_gethostbyname2(3) OSS Library Calls Reference Manual NAME lwres_gethostbyname2 - Gets an Internet host entry by name and IPv4 or IPv6 address family LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include extern lwres_h_errno; struct hostent *lwres_gethostbyname2 ( const char *name, int af); PARAMETERS name Points to either the official name or an alias of the host whose Internet address is to be found.
PAGE 439
OSS Library Calls (i - m) lwres_gethostbyname2(3) TRY_AGAIN The local server did not receive a response from an authoritative server. A retry at a later time might succeed. NO_RECOVERY This is a nonrecoverable error. NO_DATA or NO_ADDRESS The requested name is valid but no associated address was found. Another type of name server request might succeed. EXAMPLE This example makes a call to lwres_gethostbyname2( ) by passing the host name and address family as arguments.
PAGE 440
lwres_gethostbyname(3) OSS Library Calls Reference Manual NAME lwres_gethostbyname - Gets the Internet address (IPv4) of the host whose name is specified LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include extern lwres_h_errno struct hostent *lwres_gethostbyname( const char *name ); PARAMETERS name Points to either the official name or an alias of the host whose Internet address is to be found.
PAGE 441
OSS Library Calls (i - m) lwres_gethostbyname(3) EXAMPLE char *name; struct hostent *hp; hp = lwres_gethostbyname(name); The above example makes a call to lwres_gethostbyname( ) by passing the Internet host name as an argument. If an answer is found, a pointer to the hostent structure is returned and stored in hp. NULL is returned if no answer is found. RELATED INFORMATION Functions: gethostbyname(3), lwres_hstrerror(3).
PAGE 442
lwres_getipnodebyaddr(3) OSS Library Calls Reference Manual NAME lwres_getipnodebyaddr - Searches host entries until a match is found LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include #include
PAGE 443
OSS Library Calls (i - m) lwres_getipnodebyaddr(3) NO_RECOVERY An unexpected server failure occurred that cannot be recovered. NO_ADDRESS The specified host name is valid, but the host does not have an IP address. Another type of request to the name server for the domain might return an error. RELATED INFORMATION Functions: getipnodebyaddr(3), lwres_hstrerror(3).
PAGE 444
lwres_getipnodebyname(3) OSS Library Calls Reference Manual NAME lwres_getipnodebyname - Gets host information based on the host name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 445
OSS Library Calls (i - m) lwres_getipnodebyname(3) NOTES The hostent structure is statically declared. Subsequent calls to lwres_gethostbyname( ) replace the existing data in the hostent structure. RETURN VALUES Upon successful completion of the call, the lwres_getipnodebyname( ) function returns a pointer to a structure of type hostent whose members specify data obtained from a name server.
PAGE 446
lwres_getnameinfo(3) OSS Library Calls Reference Manual NAME lwres_getnameinfo - Translates a protocol-independent host address to host name LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 447
OSS Library Calls (i - m) lwres_getnameinfo(3) NI_NUMERICSERV Specifies to return the numeric port number instead of the service name. NI_DGRAM Specifies to return only ports configured for a UDP service. This flag is required for ports that use different services for UDP and TCP. DESCRIPTION This function uses a socket address to search for a host name and service name.
PAGE 448
lwres_hstrerror(3) OSS Library Calls Reference Manual NAME lwres_hstrerror - Returns a string for an error code LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include const char *lwres_hstrerror ( int err_num); PARAMETERS err_num Specifies the integer error code. DESCRIPTION This function converts an integer error code returned by another lightweight resolver function into a displayable text string.
PAGE 449
OSS Library Calls (i - m) malloc(3) NAME malloc - Allocates memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void ∗ malloc( size_t size); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 450
malloc_pages(3) OSS Library Calls Reference Manual NAME malloc_pages - Provides a memory page allocator LIBRARY H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void *malloc_pages ( size_t size ); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 451
OSS Library Calls (i - m) _max(3) NAME _max - Expands the greater of its two arguments LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include arith_type _max( arith_type expr1, arith_type expr2); PARAMETERS arith_type Specifies the type of expr1, expr2, and the return value. Any arithmetic type can be specified. However, they must all be of the same type. expr1 Is an expression. expr2 Is an expression of the same type as expr1.
PAGE 452
mblen(3) OSS Library Calls Reference Manual NAME mblen - Determines the length in bytes of a multibyte character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int mblen ( const char *mbs, size_t n); PARAMETERS mbs Points to a multibyte character string.
PAGE 453
OSS Library Calls (i - m) mblen(3) RELATED INFORMATION Functions: mbtowc(3), wctomb(3), mbstowcs(3), wcstombs(3).
PAGE 454
mbstowcs(3) OSS Library Calls Reference Manual NAME mbstowcs - Converts a multibyte character string to a wide character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 455
OSS Library Calls (i - m) mbtowc(3) NAME mbtowc - Converts a multibyte character to a wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int mbtowc ( wchar_t *pwc, const char *s, size_t n); PARAMETERS pwc Points to the wide character variable location.
PAGE 456
mbtowc(3) OSS Library Calls Reference Manual • If the character encoding is not shift-state dependent, mbtowc( ) returns a value of 0 (zero). The return value is never greater than the value specified by the n parameter or the value of the MB_CUR_MAX macro. ERRORS If the following condition occurs, the mbtowc ) function sets errno to the corresponding value. [EILSEQ] The s parameter points to an invalid multibyte character or a multibyte character with more the n bytes.
PAGE 457
OSS Library Calls (i - m) memccpy(3) NAME memccpy - Copies characters sequentially in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void *memccpy( void *s1, void *s2, int c, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 458
memchr(3) OSS Library Calls Reference Manual NAME memchr - Finds a character byte in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void *memchr( const void *s, int c, size_t n); PARAMETERS s Points to the location of a string. c Specifies a byte for which to search.
PAGE 459
OSS Library Calls (i - m) memcmp(3) NAME memcmp - Compares characters in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int memcmp( const void *s1, const void *s2, size_t n); PARAMETERS s1 Points to the location of a destination string. s2 Points to the location of a source string.
PAGE 460
memcpy(3) OSS Library Calls Reference Manual NAME memcpy - Copies a character in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void *memcpy( void *s1, const void *s2, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 461
OSS Library Calls (i - m) memmove(3) NAME memmove - Copies characters with overlapping areas in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void *memmove( void *s1, const void *s2, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 462
memset(3) OSS Library Calls Reference Manual NAME memset - Sets characters in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void *memset( void *s, int c, size_t n); PARAMETERS s Points to the location of a string. c Specifies a byte for which c is the target of the copy.
PAGE 463
OSS Library Calls (i - m) _min(3) NAME _min - Expands the lesser of its two arguments LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include arith_type _min( arith_type expr1, arith_type expr2); PARAMETERS arith_type Specifies the type of expr1, expr2, and the return value. Any arithmetic type can be specified, but all must be of the same type. This is an optional parameter. expr1 Is an expression. expr2 Is an expression of the same type as expr1.
PAGE 464
mkfifo(3) OSS Library Calls Reference Manual NAME mkfifo - Creates a FIFO special file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int mkfifo( const char *path, mode_t mode); PARAMETERS path Names the new file.
PAGE 465
OSS Library Calls (i - m) mkfifo(3) Use From the Guardian Environment The mkfifo( ) function is one of a set of functions that have the following effects when the first of them is called from the Guardian environment: • Two Guardian file system file numbers (not necessarily the next two available) are allocated for the root directory and the current working directory. These file numbers cannot be closed by calling the Guardian FILE_CLOSE_ procedure.
PAGE 466
mkfifo(3) OSS Library Calls Reference Manual • [ENOROOT] The path parameter specifies a file on a remote HP NonStop server node but communication with the remote node has been lost. One of the following conditions exists: • The root fileset of the local node (fileset 0) is not in the STARTED state. • The current root fileset for the specified file is unavailable. The OSS name server for the fileset might have failed.
PAGE 467
OSS Library Calls (i - m) mkstemp(3) NAME mkstemp, mktemp - Makes a unique filename LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include int mkstemp(char *template); char *mktemp(char *template); PARAMETERS template Is a pointer to a string that serves as the template for creating unique filenames.
PAGE 468
mktemp(3) OSS Library Calls Reference Manual NAME mktemp - Makes a unique filename DESCRIPTION See mkstemp(3).
PAGE 469
OSS Library Calls (i - m) mktime(3) NAME mktime - Converts broken-down time into time since the Epoch LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include time_t mktime( struct tm *timeptr ); PARAMETERS timeptr Points to a type tm structure that contains the broken-down time.
PAGE 470
mktime(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completion, the mktime( ) function returns the specified time since the Epoch as a value of type time_t. On error, or whenever the time since the Epoch cannot be represented, this function returns the value (time_t)-1 and sets errno to indicate the error. The value returned is affected by the setting of the TZ environment variable and calls to the tzset( ) function.
PAGE 471
OSS Library Calls (i - m) modf(3) NAME modf - Breaks a floating-point number into integral and fractional parts LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include
PAGE 472
modf(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point format data. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point data. The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 473
OSS Library Calls (i - m) mrand48(3) NAME mrand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 474
mrand48(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), nrand48(3), rand(3), seed48(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 475
Section 5. OSS Library Calls (n - r) This section contains reference pages documenting library calls with English names beginning with the letter n through the letter r that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 476
nextafter(3) OSS Library Calls Reference Manual NAME nextafter - Computes the next representable double-precision floating-point number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double nextafter( double x, double y ); PARAMETERS x Is a double-precision floating-point number.
PAGE 477
OSS Library Calls (n - r) nextafter(3) ERRORS If any of the following conditions occurs, the nextafter( ) function sets errno to the corresponding value: [ERANGE] The return value would cause an overflow. RELATED INFORMATION Functions: fp_class(3). STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 478
nftw(3) OSS Library Calls Reference Manual NAME nftw - Traverses a file tree LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int nftw( const char *path, int(*function) (const char *object, const struct stat *ptr, int flag, struct FTW *sftw), int depth, int flags); PARAMETERS path Points to the directory hierarchy to be searched.
PAGE 479
OSS Library Calls (n - r) nftw(3) DESCRIPTION The nftw( ) function recursively searches the directory hierarchy that descends from the directory specified by the path parameter. For each file in the hierarchy, nftw( ) calls the function pointed to by the function parameter and passes four arguments. The flag value passed to the function parameter identifies the file type of the object specified for the object parameter or provides other information that modifies the operation of the nftw( ) function.
PAGE 480
nftw(3) OSS Library Calls Reference Manual Use on Guardian Objects All Guardian files (that is, files in /G) that are visible to the opendir( ) function can be traversed. This includes temporary and structured files. Safeguard subsystem security controls on Guardian objects do not affect the outcome of a call to the nftw( ) function.
PAGE 481
OSS Library Calls (n - r) nftw(3) • The function specified by the function parameter returns -1 and does not reset the value of errno. [EFSBAD] The program attempted an operation involving a fileset with a corrupted fileset catalog. [ELOOP] Too many symbolic links were encountered in translating path.
PAGE 482
nlist(3) OSS Library Calls Reference Manual NAME nlist - Gets entries from name list LIBRARY G-series native OSS processes: /G/system/sysnn/zutilsrl H-series OSS processes: /G/system/zdllnnn/zutildll SYNOPSIS #include int nlist( char *filename, struct nlist n1[] ); PARAMETERS filename Specifies the name of the file to examine. n1[] Specifies the array in which the entry list is returned.
PAGE 483
OSS Library Calls (n - r) nl_langinfo(3) NAME nl_langinfo - Provides national language information LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *nl_langinfo( nl_item item); PARAMETERS item Specifies constant names and values.
PAGE 484
nrand48(3) OSS Library Calls Reference Manual NAME nrand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 485
OSS Library Calls (n - r) nrand48(3) Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The nrand48( ) function returns signed long integers uniformly distributed over the range $0˜<=˜y<˜2 sup 31$. RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), rand(3), seed48(3), srand48(3).
PAGE 486
ntohl(3) OSS Library Calls Reference Manual NAME ntohl - Converts a 32-bit integer from Internet network byte order to host byte order LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_addr_t ntohl( in_addr_t netlong); PARAMETERS netlong Specifies a 32-bit integer in network byte order.
PAGE 487
OSS Library Calls (n - r) ntohs(3) NAME ntohs - Converts a 16-bit integer from Internet network byte order to host byte order LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include in_port_t ntohs( in_port_t netshort); PARAMETERS netshort Specifies a 16-bit integer in network byte order.
PAGE 488
opendir(3) OSS Library Calls Reference Manual NAME opendir - Opens a directory and creates a directory stream LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ DIR *opendir( const char *dir_name); PARAMETERS dir_name Names the directory.
PAGE 489
OSS Library Calls (n - r) opendir(3) Use on Guardian Objects A call to opendir( ) on /G, followed by calls to readdir( ), returns all of the Guardian volumes on the system. The same sequence performed on /G/vol returns all of the subvolumes and temporary files on that particular volume. The same sequence performed on /G/vol/subvol returns all of the files on that particular subvolume, including files that are inaccessible to the OSS interface such as Enscribe structured files and SQL objects.
PAGE 490
opendir(3) OSS Library Calls Reference Manual [EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt. [ELOOP] Too many symbolic links were encountered in translating the dir_name parameter.
PAGE 491
OSS Library Calls (n - r) [EPERM] opendir(3) One of the following conditions occurred: • The function attempted to open a Guardian process (the specified pathname maps to /G/process) or a Guardian subvolume with a name beginning with ZYQ. • The function attempted to open the /E directory on a remote system or a directory within the /E directory on a remote system. RELATED INFORMATION Functions: closedir(3), mkdir(2), readdir(3), rewinddir(3), rmdir(2), seekdir(3), telldir(3).
PAGE 492
openlog(3) OSS Library Calls Reference Manual NAME openlog - Initializes Event Management Service (EMS) event log files LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int openlog( const char *ident, int logopt, int facility); PARAMETERS ident Contains a pointer to an identity (event subject) string, which by default contains "syslog.
PAGE 493
OSS Library Calls (n - r) openlog(3) LOG_PERROR Has no effect. This option is included for compatibility with certain UNIX systems. LOG_PID Includes the ZOSS-TKN-PID token, which contains the OSS process ID of the calling process, in each event message created by the syslog( ) function. Do not use this option when the calling process is running in the Guardian environment. If you do so, a Guardian trap 5 occurs. facility Indicates the part of the system generating the event message.
PAGE 494
openlog(3) OSS Library Calls Reference Manual LOG_SYSLOG Messages generated by a syslogd daemon. LOG_UUCP Messages generated by a UNIX-to-UNIX copy program (UUCP) subsystem. DESCRIPTION The openlog( ) function changes logging actions if special processing is needed for an event message.
PAGE 495
OSS Library Calls (n - r) pathconf(3) NAME pathconf - Gets configuration attributes for a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include long int pathconf( const char *path, int name); PARAMETERS path Specifies the pathname of the file.
PAGE 496
pathconf(3) PATH_MAX OSS Library Calls Reference Manual Is the maximum number of bytes in a pathname (including a terminating null). The value returned is the maximum length of a relative pathname when the specified file is a directory. Value of name: _PC_PATH_MAX PIPE_BUF Is the maximum number of bytes guaranteed to be written atomically. This attribute is applicable only to a pipe or FIFO file. The value returned applies to the referenced object.
PAGE 497
OSS Library Calls (n - r) pathconf(3) The following table shows the values the pathconf( ) function returns for the symbolic constants defined in the unistd.h file that correspond to the name parameter: Table 5−1.
PAGE 498
pathconf(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completion, the pathconf( ) function returns the specified parameter. Otherwise, the value -1 is returned and errno is set to indicate the error. The value -1 is returned, with errno unchanged, if the variable corresponding to name has no limit for the path or file descriptor.
PAGE 499
OSS Library Calls (n - r) [ENOROOT] pathconf(3) One of the following conditions exists: • The root fileset of the local node (fileset 0) is not in the STARTED state. • The current root fileset for the specified file is unavailable. The OSS name server for the fileset might have failed. • The specified file is on a remote HP NonStop server node and communication with the remote name server has been lost. [ENOTDIR] A component of the pathname prefix is not a directory.
PAGE 500
pause(3) OSS Library Calls Reference Manual NAME pause - Suspends a process until a signal is received LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 501
OSS Library Calls (n - r) pclose(3) NAME pclose - Closes a pipe to a process LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int pclose( FILE *stream); PARAMETERS stream Points to a FILE structure for an open pipe returned by a previous call to the popen( ) function. DESCRIPTION The pclose( ) function closes a pipe between the calling program and a shell command to be executed.
PAGE 502
pclose(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fclose(3), popen(3), wait(2). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 5−28 The error [EBADF] can be returned.
PAGE 503
OSS Library Calls (n - r) perror(3) NAME perror - Writes a message explaining a function error LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 504
popen(3) OSS Library Calls Reference Manual NAME popen - Initiates a pipe to a process LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include FILE *popen( const char *command, const char *mode); PARAMETERS command Points to a null-terminated string containing a shell command line. mode Points to a null-terminated string indicating an I/O mode.
PAGE 505
OSS Library Calls (n - r) popen(3) NOTES Programs using the popen( ) function to invoke an output filter should beware of possible deadlock caused by output data remaining in the program’s buffer. This can be avoided either by using the setbuf( ) function to ensure that the output stream is unbuffered or by using the fflush( ) function to ensure that all buffered data is flushed before you call the pclose( ) function.
PAGE 506
pow(3) OSS Library Calls Reference Manual NAME pow - Computes the power function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double pow( double x, double y ); PARAMETERS x Specifies a double value. y Specifies a double value.
PAGE 507
OSS Library Calls (n - r) 527187-004 pow(3) • If the value of y is NaN, NaN is returned. • If the value of x is 0.0 (zero) and the value of y is negative, positive or negative HUGE_VAL is returned and errno is set to [EDOM]. • If the value of x is 0.0 (zero) and the value of y is greater than 0.0 (zero), positive or negative 0.0 (zero) is returned. • If the value of x is less than 0.0 (zero) and the value of y is not an integral value, NaN is returned and errno is set to [EDOM].
PAGE 508
pow(3) OSS Library Calls Reference Manual • If the value of x is positive or negative 0.0 (zero) and the value of y is not an odd integral value but is greater than 0.0 (zero), positive 0.0 (zero) is returned. ERRORS If any of the following conditions occurs, the pow( ) function sets errno to the corresponding value: [EDOM] [ERANGE] One of the following conditions exists: • The value of x is negative and the value of y is nonintegral. • The value of x is 0.0 (zero) and the value of y is negative.
PAGE 509
OSS Library Calls (n - r) printf(3) NAME printf - Prints formatted output to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int printf ( const char *format [, value] . . .
PAGE 510
printf(3) OSS Library Calls Reference Manual • + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero). For x and X conversions, a nonzero result has 0x or 0X prefixed to it.
PAGE 511
OSS Library Calls (n - r) • printf(3) An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
PAGE 512
printf(3) 5−38 OSS Library Calls Reference Manual x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 513
OSS Library Calls (n - r) printf(3) S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 514
printf(3) OSS Library Calls Reference Manual ERRORS The printf( ) function fails if the standard output stream is unbuffered, or if the buffer needed to be flushed and the function call caused an underlying write( ) or lseek( ) function to be invoked. In addition, if the printf( ) function fails, errno is set to one of the following values: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation.
PAGE 515
OSS Library Calls (n - r) putc(3) NAME putc - Writes a byte to a specified output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putc( int c, FILE *stream); PARAMETERS c Specifies the character to be written. stream Points to the file structure of an open file.
PAGE 516
putc(3) OSS Library Calls Reference Manual ERRORS The putc( ) function fails if: • The stream parameter is not open for writing. • The output file size cannot be increased. • The stream is unbuffered • The stream’s buffer needed to be flushed and the function call caused an underlying write( ) or lseek( ) to be invoked and this underlying operation fails.
PAGE 517
OSS Library Calls (n - r) putchar(3) NAME putchar - Writes a byte to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putchar( int c); PARAMETERS c Specifies the character to be written.
PAGE 518
putchar(3) OSS Library Calls Reference Manual In addition, if any of the following conditions occur, the putchar( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing.
PAGE 519
OSS Library Calls (n - r) putenv(3) NAME putenv - Sets an environment variable LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int putenv( const char *string); PARAMETERS string Points to a string of the form name=value.
PAGE 520
putenv(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The putenv( ) function behavior in Guardian processes is an HP extension to the XPG4 Version 2 specification.
PAGE 521
OSS Library Calls (n - r) puts(3) NAME puts - Writes a string to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int puts( const char *string); PARAMETERS string Points to a string to be written to output.
PAGE 522
puts(3) OSS Library Calls Reference Manual [ENOMEM] Insufficient storage space available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a nonexistent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 523
OSS Library Calls (n - r) putw(3) NAME putw - Writes a word to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putw( int w, FILE *stream); PARAMETERS stream Points to the file structure of an open file. w Specifies the word to be written.
PAGE 524
putw(3) OSS Library Calls Reference Manual [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size. [EINTR] The write operation was interrupted by a signal that was caught, and no data was transferred.
PAGE 525
OSS Library Calls (n - r) putwc(3) NAME putwc - Writes a wide character to a specified stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t putwc( wint_t c, FILE *stream); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
PAGE 526
putwc(3) OSS Library Calls Reference Manual [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. [EILSEQ] The wide character code specified by the c parameter does not correspond to a valid character.
PAGE 527
OSS Library Calls (n - r) putwchar(3) NAME putwchar - Writes a wide character to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t putwchar( wint_t c); PARAMETERS c Specifies the wide character to be written.
PAGE 528
putwchar(3) OSS Library Calls Reference Manual [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. [EILSEQ] The wide character code specified by the c parameter does not correspond to a valid character. RELATED INFORMATION Functions: fputwc(3), getc(3), getwc(3), printf(3), putc(3), puts(3), putwc(3), wctomb(3).
PAGE 529
OSS Library Calls (n - r) putws(3) NAME putws - Writes a wide-character string to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putws( wchar_t *string); PARAMETERS string Points to a string to be written to output.
PAGE 530
putws(3) OSS Library Calls Reference Manual [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: fputws(3), gets(3), getws(3), wcstombs(3), printf(3), putc(3), puts(3), putwc(3).
PAGE 531
OSS Library Calls (n - r) qsort(3) NAME qsort - Sorts a table in place LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void qsort ( void *base, size_t nmemb, size_t size, int (*compar)(const void *, const void *) ); PARAMETERS base Points to the first entry in the table.
PAGE 532
qsort(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: bsearch(3), tsearch(3).
PAGE 533
OSS Library Calls (n - r) raise(3) NAME raise - Sends a signal to the calling process LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int raise( int signal); PARAMETERS signal Specifies a signal number. DESCRIPTION The raise( ) function sends the signal specified by the signal parameter to the executing program.
PAGE 534
raise(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 5−60 The raise( ) function can return the errno value [ENOTOSS].
PAGE 535
OSS Library Calls (n - r) rand(3) NAME rand - Returns pseudorandom numbers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int rand (void); DESCRIPTION The rand( ) function returns successive pseudorandom numbers in the range from 0 (zero) to RAND_MAX.
PAGE 536
random(3) OSS Library Calls Reference Manual NAME random - Generates random numbers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include long random(void); PARAMETERS None.
PAGE 537
OSS Library Calls (n - r) readdir(3) NAME readdir - Reads a directory stream LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ struct dirent *readdir( DIR *dir_pointer); PARAMETERS dir_pointer Points to the dir structure of an open directory. DESCRIPTION The type DIR, which is defined in the dirent.
PAGE 538
readdir(3) OSS Library Calls Reference Manual If files are removed from a directory after the most recent call to the opendir( ) or rewinddir( ) function but prior to the first call to the readdir( ) function, the readdir( ) function does not return entries for these files. If files are added to a directory after the most recent call to the opendir( ) or rewinddir( ) function but prior to the first call to the readdir( ) function, the readdir( ) function returns entries for these files.
PAGE 539
OSS Library Calls (n - r) readdir(3) EXAMPLES The following example shows how to search a directory for the entry name: len = strlen(name); dir_pointer = opendir("."); for (dp = readdir(dir_pointer); dp != NULL; dp = readdir(dir_pointer)) if (strlen(dp->d_name) == len && !strcmp(dp->d_name, name)) { closedir(dir_pointer); return FOUND; } closedir(dir_pointer); return NOT_FOUND; RETURN VALUES Upon successful completion, the readdir( ) function returns a pointer to an object of type struct dirent.
PAGE 540
readdir(3) OSS Library Calls Reference Manual [ENXIO] One of the following events occurred: • A device was specified that does not exist, or a request was made beyond the limits of the device. • The fileset containing the requestor’s current working directory or root directory is not mounted. This error can occur after failure and restart of an OSS name server until the fileset has been repaired and remounted.
PAGE 541
OSS Library Calls (n - r) realloc(3) NAME realloc - Reallocates memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void ∗ realloc( void ∗ pointer, size_t size); PARAMETERS size Specifies the number of bytes of memory.
PAGE 542
realpath(3) OSS Library Calls Reference Manual NAME realpath - Resolves pathname LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll SYNOPSIS #include char *realpath( const char *file_name, char *resolved_name); PARAMETERS file_name Is a pointer to a pathname that is to be converted to an absolute pathname. resolved_name Is a pointer to a buffer where the resolved pathname can be stored.
PAGE 543
OSS Library Calls (n - r) realpath(3) [ENOTDIR] A component of the derived absolute pathname was not a directory. [ENOMEM] Insufficient storage space was available. RELATED INFORMATION Functions: getwd(3), getcwd(3), sysconf(3).
PAGE 544
re_comp(3) OSS Library Calls Reference Manual NAME re_comp - Compiles regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *re_comp( const char *re_string); PARAMETERS re_string Is a pointer to the regular expression string to be compiled by the re_comp( ) function.
PAGE 545
OSS Library Calls (n - r) re_comp(3) Within the bracketed string, a minus sign (-) can be used to specify a range of consecutive ASCII characters. For example, [0-9] is the same as [0123456789]. If, however, the minus sign is the first character (following any initial "ˆ") or the last character within the bracketed string, it loses this special meaning.
PAGE 546
re_comp(3) OSS Library Calls Reference Manual RETURN VALUES When the re_comp( ) function successfully converts the string pointed to by the re_string parameter, it returns a null pointer. Otherwise, it returns a pointer to an error message string.
PAGE 547
OSS Library Calls (n - r) re_exec(3) NAME re_exec - Executes regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 548
re_exec(3) OSS Library Calls Reference Manual minus sign is the first character (following any initial "ˆ") or the last character within the bracketed string, it loses this special meaning. When a right square bracket is the first character (following any initial "ˆ") within a bracketed string, it has no special meaning and simply matches itself. When the ",", "*", "[", or "\" characters appear within a bracketed string, they have no special meaning and simply match themselves.
PAGE 549
OSS Library Calls (n - r) re_exec(3) ERRORS The re_exec( ) function does not return error values. RELATED INFORMATION Functions: re_comp(3), regcmp(3), regexec(3). STANDARDS CONFORMANCE The re_exec( ) function is defined in the XPG4 Version 2 specification.
PAGE 550
regcmp(3) OSS Library Calls Reference Manual NAME regcmp - Compiles regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *regcmp(const char *string1, ... /*, (char *)0 */); PARAMETERS string1, ... Is a list of pointers to strings that will be concatenated and compiled.
PAGE 551
OSS Library Calls (n - r) regcmp(3) NOTES The behavior of this function in locales other than POSIX is undefined. This function can be called by native processes only. CAUTIONS Be sure to free space that the malloc( ) function has reserved for compiled regular expressions once it is no longer needed. If this is not done, there is a risk of running out of memory. RETURN VALUES On successful completion, the regcmp( ) function returns a pointer to the compiled regular expression.
PAGE 552
regcomp(3) OSS Library Calls Reference Manual NAME regcomp, regerror, regexec, regfree - Perform regular expression matching LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 553
OSS Library Calls (n - r) regcomp(3) subexpressions (delimited by a $ (backslash left parenthesis) and $ (backslash right parenthesis) pair in basic regular expressions, or ( ) (parentheses) in extended regular expressions) to the number found in the pattern parameter. preg The structure that contains the compiled basic or extended regular expression. errcode Identifies the error code. errbuf Points to the buffer where regerror( ) stores the message text.
PAGE 554
regcomp(3) OSS Library Calls Reference Manual of the end of the substring. Subexpression i begins at the ith matched open parenthesis, counting from 1. The 0 (zero) element of the array corresponds to the entire pattern. Unused elements of the pmatch parameter, up to the value pmatch[nmatch-1], are filled with -1. If there are more than the number of subexpressions specified by the nmatch parameter (the pattern parameter itself counts as a subexpression), only the first nmatch-1 are recorded.
PAGE 555
OSS Library Calls (n - r) regcomp(3) EXAMPLES 1. The following example demonstrates how the REG_NOTBOL flag can be used with the regexec( ) function to find all substrings in a line that match a pattern supplied by a user. The main( ) function in the example accepts two input strings from the user. The match( ) function in the example uses regcomp( ) and regexec( ) to search for matches. #include #include #include #include #include
PAGE 556
regcomp(3) OSS Library Calls Reference Manual if (error == REG_NOMATCH) { printf("No matches in string\n"); return; } else if (error != 0) { msize = regerror(error, &preg, message, SLENGTH); printf("%s\n", message); if (msize > SLENGTH) printf("Additional text lost\n"); return; }; count = 1; start_search = string + pmatch.rm_eo; while (error == 0) { error = regexec(&preg, start_search, 1, &pmatch, REG_NOTBOL); start_search = start_search + pmatch.
PAGE 557
OSS Library Calls (n - r) regcomp(3) matches_tocheck = preg.
PAGE 558
regcomp(3) OSS Library Calls Reference Manual REG_EBRACE The use of a pair of \{ (backslash left brace) and \} (backslash right brace) or { } (braces) is unbalanced. REG_EBRACK The use of [] (square brackets) is unbalanced. REG_ECOLLATE There is an unusable collating element referenced. REG_ECTYPE There is an unusable character class type referenced. REG_EESCAPE There is a trailing \ (backslash) in the pattern.
PAGE 559
OSS Library Calls (n - r) regerror(3) NAME regerror - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 560
regex(3) OSS Library Calls Reference Manual NAME regex - Executes regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *regex(const char *re, const char *subject, char *se0, ...
PAGE 561
OSS Library Calls (n - r) regex(3) (...)$n Returns the value of the enclosed regular expression (subexpression). The value is stored in the location pointed to by the n+1th parameter in the se0, ... list where n is a single digit. If there are fewer than n parameters in this list, the behavior of regex( ) is undefined. A maximum of ten enclosed regular expressions are allowed. (...) Groups a regular expression. A regular expression in parentheses can be followed by an operator like *, +, or {}.
PAGE 562
regexec(3) OSS Library Calls Reference Manual NAME regexec - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 563
OSS Library Calls (n - r) regfree(3) NAME regfree - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 564
remainder(3) OSS Library Calls Reference Manual NAME remainder - Computes the remainder of a division operation LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS double remainder( double x, double y ); PARAMETERS x Is a double-precision floating-point number. y Is a double-precision floating-point number.
PAGE 565
OSS Library Calls (n - r) remainder(3) • The value of the x parameter is positive or negative infinity. RELATED INFORMATION Functions: fp_class(3), isnan(3). STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527187-004 For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x or y is NaN.
PAGE 566
remove(3) OSS Library Calls Reference Manual NAME remove - Removes a file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the remove( ) function: remove_oss( ) and remove_guardian( ).
PAGE 567
OSS Library Calls (n - r) remove_guardian(3) NAME remove_guardian - Removes a file (Guardian remove( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 568
remove_oss(3) OSS Library Calls Reference Manual NAME remove_oss - Removes a file (OSS remove( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int remove( const char *file_name); int remove_oss( const char *file_name); PARAMETERS file_name Points to the file to be removed.
PAGE 569
OSS Library Calls (n - r) remove_oss(3) NOTES If the file operated upon by the remove( ) function has multiple links, the link count in the file is decremented. If the file operated upon is a symbolic link, it is not deleted. All special files, including symbolic links, are processed as if they were directories; because a symbolic link is not a directory, the attempt to remove it (or the file it points to) fails.
PAGE 570
remque(3) OSS Library Calls Reference Manual NAME remque - Inserts or remove an element in a queue DESCRIPTION See insque(3).
PAGE 571
OSS Library Calls (n - r) rewind(3) NAME rewind - Repositions the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void rewind( FILE ∗ stream); PARAMETERS stream Specifies the I/O stream.
PAGE 572
rewind(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fgetpos(3), fopen(3), fseek(3), lseek(2), fsetpos(3), ftell(3). STANDARDS CONFORMANCE The [ENXIO] errno value is not specified in the POSIX standards. It is an extension defined in the XPG4 version 2 specification.
PAGE 573
OSS Library Calls (n - r) rewinddir(3) NAME rewinddir - Resets the position in the directory stream to the beginning of the directory LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ void rewinddir( DIR *dir_pointer); PARAMETERS dir_pointer Points to the dir structure of an open directory. DESCRIPTION The type DIR, which is defined in the dirent.
PAGE 574
rewinddir(3) OSS Library Calls Reference Manual If, after a call to a fork( ) or tdm_fork( ) function, both the parent and child processes make calls to the rewinddir( ) function and the readdir( ) function to access an OSS directory, the results are undefined. Use on Guardian Objects • Only disks appear as entries in the /G directory. A call to rewinddir( ) rewinds the list of disks to the beginning. A call to rewinddir( ) on a specific disk rewinds the list of its subvolumes to the beginning.
PAGE 575
OSS Library Calls (n - r) rewinddir(3) The following are HP extensions to the XPG4 Version 2 specification: • 527187-004 The error values [EBADF] and [EFAULT] can be returned.
PAGE 576
rindex(3) OSS Library Calls Reference Manual NAME rindex - Scans string for last occurrence of a character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *rindex ( const char *s, int c); PARAMETERS s Is a pointer to the string to be scanned. c Is the character being scanned for.
PAGE 577
OSS Library Calls (n - r) rint(3) NAME rint - Rounds floating-point numbers to nearest integral value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double rint( double x); PARAMETERS x Is the double-precision floating-point value to be rounded.
PAGE 578
rint(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 5−104 For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 579
Section 6. OSS Library Calls (s) This section contains reference pages documenting library calls with English names beginning with the letter s that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 580
scalb(3) OSS Library Calls Reference Manual NAME scalb - Computes exponent of a radix-independent floating-point number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double scalb( double x, double n ); PARAMETERS x Is the value to be multiplied. n Is the exponent of the radix.
PAGE 581
OSS Library Calls (s) scalb(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527187-004 This function does not set errno to [EDOM] if the value of x or n is NaN.
PAGE 582
scanf(3) OSS Library Calls Reference Manual NAME scanf - Converts formatted input read from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int scanf( const char *format [, *pointer] . . . ); PARAMETERS format Specifies the format conversion.
PAGE 583
OSS Library Calls (s) scanf(3) Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$. The scanf( ) function can handle a format string that enables the system to process an element of the input stream for storage at a specific pointer location.
PAGE 584
scanf(3) OSS Library Calls Reference Manual c Accepts a single character or a series of characters. If there is either no width or a width of 1 in the conversion specification, one character is accepted and the corresponding pointer parameter should be a type char pointer. If there is a width greater than 1, the indicated number of characters are accepted and the corresponding pointer parameter should be an array of type char. The normal skip over white space is suppressed.
PAGE 585
OSS Library Calls (s) scanf(3) s Accepts a string of characters. The input field ends with a white-space character. If width is given, the corresponding pointer parameter refers to a character array and the indicated number of type char values are read. A string of type char values is written to the array. The array must be large enough to contain the output string with a terminating null byte appended. S Accepts a string of characters. The input field ends with a white-space character.
PAGE 586
scanf(3) OSS Library Calls Reference Manual Unless there is a match in the conversion specification, trailing white space (including a newline character) is not read. The success of literal matches and suppressed assignments cannot be directly determined. The scanf( ) function returns the number of successfully matched and assigned input items. NOTES This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values in the native environment.
PAGE 587
OSS Library Calls (s) scanf(3) The following are HP extensions to the XPG4 Version 2 specification: 527187-004 • The conversion code character L followed by a d, i, n, o, or x conversion code character indicates that the receiving variable is treated as a long long, which is a 64-bit integer data type. • The conversion specifier ll followed by a d, i, n, o, or x indicates that the argument will be treated as an unsigned long long, which is a 64-bit integer data type.
PAGE 588
seed48(3) OSS Library Calls Reference Manual NAME seed48 - Sets rule to generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 589
OSS Library Calls (s) seed48(3) RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), nrand48(3), rand(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 590
seekdir(3) OSS Library Calls Reference Manual NAME seekdir - Sets position within a directory stream LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ void seekdir( DIR *dir_pointer, long location); PARAMETERS dir_pointer Points to the dir structure of an open directory.
PAGE 591
OSS Library Calls (s) seekdir(3) ERRORS If any of the following conditions occurs, the seekdir( ) function sets errno to the corresponding value: [EBADF] The dir_pointer parameter does not refer to an open directory stream. This error is returned instead of [EFAULT] if the process has copied and altered the structure pointed to by the dir_pointer parameter after the system has freed the buffer that contains the structure.
PAGE 592
setbuf(3) OSS Library Calls Reference Manual NAME setbuf - Assigns buffering to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void setbuf( FILE *stream, char *buffer); PARAMETERS stream Specifies the input/output stream. buffer Points to a character array.
PAGE 593
OSS Library Calls (s) setgrent(3) NAME setgrent - Resets the group name key to get group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 594
sethostent(3) OSS Library Calls Reference Manual NAME sethostent - Opens the network host database /etc/hosts and sets the next entry to the first entry in the database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 595
OSS Library Calls (s) setjmp(3) NAME setjmp - Saves the current execution context LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes:implicit libraries SYNOPSIS #include int setjmp( jmp_buf env); PARAMETERS env Specifies the address of the jmp_buf structure in which to save the current environment.
PAGE 596
setkey(3) OSS Library Calls Reference Manual NAME setkey - Sets an encryption or decryption key LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZOSSCSRL G-series native OSS processes: /G/system/sysnn/zosscsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZOSSCDLL H-series OSS processes: /G/system/zdllnnn/zosscdll SYNOPSIS #include
PAGE 597
OSS Library Calls (s) setlocale(3) NAME setlocale - Changes or queries the program’s current locale LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *setlocale( int category, const char *locale); PARAMETERS category Specifies the category of the locale to set or query.
PAGE 598
setlocale(3) OSS Library Calls Reference Manual C Specifies the minimal environment for C-language translation. If setlocale( ) is not invoked, the C locale is the default. Operational behavior within the C locale is defined separately for each interface function that is affected by the locale string. POSIX Equivalent to C. NULL Used to direct setlocale( ) to query the current internationalized environment and return the name of the locale; does not change the locale.
PAGE 599
OSS Library Calls (s) 3. setlocale(3) The following subroutine queries and saves the existing international environment, then explicitly sets the locale to the C locale, performs some operations in the C locale, and finally, restores the locale to the saved environment. The main program typically uses setlocale( ) to set the international environment to the locale specified by the user’s environment program.
PAGE 600
setlocale(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: atof(3), catopen(3), catgets(3), isalnum(3), localeconv(3), nl_langinfo(3), printf(3), scanf(3), strcat(3), strfmon(3), strftime(3), wctype(3).
PAGE 601
OSS Library Calls (s) setlocale_from_msg(3) NAME setlocale_from_msg - Changes the locale of the process to match the message received on $RECEIVE LIBRARY G-series native OSS processes: /G/system/sysnn/zicnvsrl H-series OSS processes: /G/system/zdllnnn/zicnvdll SYNOPSIS #include char* setlocale_from_msg( short msg_tag); PARAMETERS msg_tag Message tag of the message from which locale is to be set.
PAGE 602
setlocale_from_msg(3) OSS Library Calls Reference Manual /* Change locale based on the received message’s locale */ if (setlocale_from_msg(receive_info[2]) != NULL) { /* Perform operations in the locale received from msg */ } /* Restore the server’s locale */ server_lc = setlocale(LC_ALL, server_lc); } RETURN VALUES Upon successful completion, the string of the new locale name associated with the specified msg_tag is returned. Otherwise, a NULL pointer will be returned.
PAGE 603
OSS Library Calls (s) setlogmask(3) NAME setlogmask - Sets the Event Management Service (EMS) event log mask LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int setlogmask( int maskpri); ,ne 5 PARAMETERS maskpri Contains a bit mask that indicates the events to be logged. Logging is enabled for the levels indicated by the bits in the mask that are set and is disabled where the bits are not set.
PAGE 604
setnetent(3) OSS Library Calls Reference Manual NAME setnetent - Opens the networks database /etc/networks and sets the next entry to the first entry LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 605
OSS Library Calls (s) setprotoent(3) NAME setprotoent - Opens the protocols database /etc/protocols and sets the next entry to the first entry in the database LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 606
setpwent(3) OSS Library Calls Reference Manual NAME setpwent - Resets the sequential key to the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 607
OSS Library Calls (s) setservent(3) NAME setservent - Opens the network services database /etc/services and sets the next entry to the first entry LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include
PAGE 608
setstate(3) OSS Library Calls Reference Manual NAME setstate - Switches hte state array used by the random number generator LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *setstate ( const char *state PARAMETERS state Is a pointer to a state array.
PAGE 609
OSS Library Calls (s) setvbuf(3) NAME setvbuf - Assigns buffering to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int setvbuf( FILE *stream, char *buffer, int mode, size_t size); PARAMETERS stream Specifies the input/output stream. buffer Points to a character array.
PAGE 610
setvbuf(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fopen(3), fread(3), getc(3), getwc(3), malloc(3), putc(3), putwc(3), setbuf(3).
PAGE 611
OSS Library Calls (s) sigaddset(3) NAME sigaddset - Adds a signal to a signal set LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigaddset( sigset_t *set, int sig_number ); PARAMETERS set Points to the signal set to be modified. sig_number Specifies the signal to be added to the set.
PAGE 612
sigaddset(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: sigaction(2), sigdelset(3), sigemptyset(3), sigfillset(3), sigismember(3), sigprocmask(2), sigsuspend(2). Files: signal(4). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • 6−34 Use of this function on a signal set that has not been properly initialized causes undefined results.
PAGE 613
OSS Library Calls (s) sigdelset(3) NAME sigdelset - Deletes a signal from a signal set LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigdelset( sigset_t *set, int sig_number ); PARAMETERS set Points to the signal set to be modified. sig_number Specifies the signal to be deleted from the set.
PAGE 614
sigdelset(3) OSS Library Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: • 6−36 The function can return the error value [EFAULT].
PAGE 615
OSS Library Calls (s) sigemptyset(3) NAME sigemptyset - Initializes a signal mask to exclude all signals LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigemptyset( sigset_t *set ); PARAMETERS set Points to the signal set to be initialized. DESCRIPTION The sigemptyset( ) function initializes the signal set pointed to by the set parameter such that all signals are excluded.
PAGE 616
sigemptyset(3) 6−38 OSS Library Calls Reference Manual Hewlett-Packard Company 527187-004
PAGE 617
OSS Library Calls (s) sigfillset(3) NAME sigfillset - Initializes a signal mask to include all signals LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigfillset ( sigset_t *set ); PARAMETERS set Points to the signal set to be initialized. DESCRIPTION The sigfillset( ) function initializes the signal set pointed to by the set parameter such that all signals are included.
PAGE 618
sigismember(3) OSS Library Calls Reference Manual NAME sigismember - Tests for a signal in a signal set LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigismember ( sigset_t *set, int sig_number ); PARAMETERS set Points to the signal set to be checked. sig_number Specifies the signal to be tested for in the set.
PAGE 619
OSS Library Calls (s) siglongjmp(3) NAME siglongjmp - Performs a nonlocal goto with signal handling LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include void siglongjmp( sigjmp_buf env, int value); PARAMETERS env Specifies the address of a sigjmp_buf structure containing the environment to be restored. value Specifies a nonzero value to be returned from the corresponding sigsetjmp( ) call.
PAGE 620
siglongjmp(3) OSS Library Calls Reference Manual ERRORS The siglongjmp( ) function never sets the value of errno. Instead, if the call is unsuccessful, an undefined signal that cannot be caught, blocked, or ignored is delivered to the calling process. If the env parameter was saved using the setjmp( ) function instead of the sigsetjmp( ) function, a SIGABRT signal is delivered to terminate the process. RELATED INFORMATION Functions: setjmp(3), sigaction(2), sigprocmask(2), sigsetjmp(3), sigsuspend(2).
PAGE 621
OSS Library Calls (s) signal(3) NAME signal - Specifies the action to take upon delivery of a signal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include void (*signal( int signal, void (*function)(int))) (int); PARAMETERS signal Specifies the signal. The signal names are defined in the signal.h header file.
PAGE 622
signal(3) OSS Library Calls Reference Manual returned and errno is set to [ENOTOSS]. Specifying the Signal The signal parameter specifies the signal. All signal values are valid if the corresponding action is to restore the default action. All signals can be caught or ignored except the SIGKILL, SIGSTOP, and SIGABEND signals; these signals can neither be caught nor ignored. Specifying the Function The function parameter can have the SIG_DFL or SIG_IGN value, or it can point to a function.
PAGE 623
OSS Library Calls (s) signal(3) The following are HP extensions to the XPG4 Version 2 specification: 527187-004 • HP defined several new signals, including SIGABEND. See the signal(4) reference page for a complete list. • The errno value [ENOTOSS] can be returned.
PAGE 624
sigsetjmp(3) OSS Library Calls Reference Manual NAME sigsetjmp - Saves the current execution context for a nonlocal goto with signal handling LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigsetjmp( sigjmp_buf env, int savemask); PARAMETERS env Specifies the address of the sigjmp_buf structure in which to save the current environment. savemask Specifies whether the current signal mask should be saved.
PAGE 625
OSS Library Calls (s) sin(3) NAME sin - Computes the trigonometric sine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double sin( double x); PARAMETERS x is the value for which the trigonometric sine function is to be computed.
PAGE 626
sin(3) 6−48 OSS Library Calls Reference Manual • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 627
OSS Library Calls (s) sinh(3) NAME sinh - Computes the hyperbolic sine function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double sinh( double x); PARAMETERS x Is the value for which the hyperbolic sine function is to be computed.
PAGE 628
sleep(3) OSS Library Calls Reference Manual NAME sleep - Suspends execution for an interval LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include unsigned int sleep( unsigned int seconds); PARAMETERS seconds Specifies the number of seconds to suspend execution. A value greater than the system maximum of 0x7FFFFFFF one-hundredths of a second is reduced to the system maximum without informing the caller.
PAGE 629
OSS Library Calls (s) sleep(3) RETURN VALUES If the sleep( ) function returns because the requested time has elapsed, the value 0 (zero) is returned. If the sleep( ) function returns because a signal was caught, the number of seconds still remaining when the signal was delivered is returned. ERRORS If a signal is received via pthread_kill( ) and is not blocked, ignored, or handled, EOF is returned with an errno of EINTR. RELATED INFORMATION Functions: alarm(3), pause(3), sigaction(2), usleep(3).
PAGE 630
snprintf(3) OSS Library Calls Reference Manual NAME snprintf - Stores formatted output into a character array LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll | | SYNOPSIS #include int snprintf ( char *string, size_t n, const char *format, [, value] . . .
PAGE 631
OSS Library Calls (s) snprintf(3) used, the * (asterisk) specification for field width in precision is replaced by %digit$. If the variable ordering feature is used, it must be specified for all conversions. • • Zero or more flags that modify the meaning of the conversion specification. The flag characters and their meanings are as follows: - Left align within the field the result of the conversion. + Begin the result of a signed conversion with a sign (+ or -).
PAGE 632
snprintf(3) OSS Library Calls Reference Manual converted for output is not fetched until the conversion letter is reached, so the parameters specifying field width or precision must appear before the value (if any) to be converted. If the value of the corresponding parameter is negative, it is treated as if the precision had not been specified. When variable ordering with the Ldigit$ format is used, the * (asterisk) specification for field width in precision is replaced by *digit$.
PAGE 633
OSS Library Calls (s) 527187-004 snprintf(3) o Accepts an integer (int) value and converts it to unsigned octal notation. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1. The result of converting a 0 (zero) value with a precision of 0 (zero) is a null string.
PAGE 634
snprintf(3) OSS Library Calls Reference Manual s Accepts a pointer to an array of char type. Bytes from the array are printed until a null character is encountered or the number of characters indicated by the precision is reached. If no precision is specified, all characters up to the first null character are printed. If the precision is not specified or is greater than the size of the array, then the array must be terminated by a null byte.
PAGE 635
OSS Library Calls (s) snprintf(3) RETURN VALUES Upon successful completion, this function returns the number of bytes that would have been stored had n been sufficiently large (not counting the terminating null character). Otherwise, a negative value is returned. Thus, the null-terminated output has been completely stored if and only if the returned value is nonnegative and less than n. The value returned by the snprintf( ) function does not include the final ’\0’ (null) character. ERRORS None.
PAGE 636
sprintf(3) OSS Library Calls Reference Manual NAME sprintf - Stores formatted output into a character array LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int sprintf ( char *string, const char *format [, value] . . .
PAGE 637
OSS Library Calls (s) • • sprintf(3) Zero or more flags that modify the meaning of the conversion specification. The flag characters and their meanings are as follows: - Left align within the field the result of the conversion. + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored.
PAGE 638
sprintf(3) OSS Library Calls Reference Manual had not been specified. When variable ordering with the Ldigit$ format is used, the * (asterisk) specification for field width in precision is replaced by *digit$.
PAGE 639
OSS Library Calls (s) sprintf(3) not implied. 527187-004 x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 640
sprintf(3) OSS Library Calls Reference Manual S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 641
OSS Library Calls (s) sprintf(3) ERRORS None. The sprintf( ) function does not set errno. RELATED INFORMATION Functions: fp_class(3), fprintf(3), isnan(3), toascii(3), putc(3), printf(3), scanf(3). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 527187-004 The conversion specifier L followed by a d, i, n, o, or x indicates that the argument will be treated as a long long, which is a 64-bit integer data type.
PAGE 642
sqrt(3) OSS Library Calls Reference Manual NAME sqrt - Computes the square root of a floating-point number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double sqrt( double x); PARAMETERS x Is the value whose square root is to be computed.
PAGE 643
OSS Library Calls (s) sqrt(3) This function supports the special rounding modes of the IEEE floating-point standard. Guardian declarations and procedures can be used to access the floating-point status and control register to set and clear the special rounding modes. Refer to the Guardian Programmer’s Guide for information about those declarations and procedures.
PAGE 644
srand(3) OSS Library Calls Reference Manual NAME srand - Generates pseudorandom numbers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void srand( unsigned int seed); PARAMETERS seed Specifies an initial seed value.
PAGE 645
OSS Library Calls (s) srand48(3) NAME srand48 - Sets rule to generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void srand48( long seed_val); PARAMETERS seed_val Specifies the initialization value to begin randomization.
PAGE 646
srand48(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 647
OSS Library Calls (s) srandom(3) NAME srandom - Generates random numbers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void srandom ( unsigned int seed); PARAMETERS seed Is an unsigned int used to initialize a state array.
PAGE 648
sscanf(3) OSS Library Calls Reference Manual NAME sscanf - Converts formatted input read from a character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int sscanf( const char *string, const char *format [, *pointer] . . . ); PARAMETERS string Specifies the input string to be read.
PAGE 649
OSS Library Calls (s) sscanf(3) • Invalid character—if the input string contains a character that is not allowed, this invalid character delimits the field and is considered the first character of the next field. • Maximum width—if the conversion specification includes a maximum width and the field is not terminated by white space or an invalid character, then when that maximum width is reached in the input string, the field is terminated.
PAGE 650
sscanf(3) OSS Library Calls Reference Manual • A conversion code character convcode that specifies the type of conversion to be applied: % Accepts a single % (percent sign) input at this point; no assignment is done. c Accepts a single character or a series of characters. If there is either no width or a width of 1 in the conversion specification, one character is accepted and the corresponding pointer parameter should be a type char pointer.
PAGE 651
OSS Library Calls (s) sscanf(3) o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer. p Matches an unsigned hexadecimal integer, the same as the %p conversion of the printf( ) function. The corresponding pointer parameter must be a pointer to a pointer to void. s Accepts a string of characters. The input field ends with a white-space character.
PAGE 652
sscanf(3) OSS Library Calls Reference Manual The conversion code convcode indicates how to interpret the input field. The corresponding pointer must usually be of a restricted type. You should not specify the pointer parameter for a suppressed field. sscanf( ) processing ends either at the end of the input string, the end of the conversion specifications, or when an input character conflicts with the conversion specifications.
PAGE 653
OSS Library Calls (s) sscanf(3) The following are HP extensions to the XPG4 Version 2 specification: • 527187-004 The conversion specifier L followed by a d, i, n, o, or x indicates that the receiving variable is treated as a long long, which is a 64-bit integer data type.
PAGE 654
step(3) OSS Library Calls Reference Manual NAME step - Compile and match regular expressions LIBRARY None. This application program interface is implemented as a macro. | SYNOPSIS #include int step ( const char *string, const char *expbuf); extern char *loc1, *loc2, *locs; PARAMETERS string Points to a null-terminated string of characters to be searched for a match. expbuf Points to a character array where the compiled regular expression is stored.
PAGE 655
OSS Library Calls (s) step(3) EXAMPLES The following is an example of the regular expression macros and calls from the grep command: #define #define #define #define #define #define INIT GETC( ) PEEKC( ) UNGETC(c) RETURN(c) ERROR(c) register char *sp=instring; (*sp++) (*sp) (--sp) return; regerr( ) #include ... compile (patstr, expbuf, &expbuf[ESIZE], ’\0’); ... if (step (linebuf, expbuf)) succeed( ); ...
PAGE 656
strcasecmp(3) OSS Library Calls Reference Manual NAME strcasecmp - Compare two strings, ignoring case LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int strcasecmp( const char *s1, const char *s2); PARAMETERS s1 Is a pointer to the first string to be compared.
PAGE 657
OSS Library Calls (s) strcat(3) NAME strcat - Appends a string to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strcat( char *s1, const char *s2); PARAMETERS s1 Specifies the destination string for appending. s2 Specifies the string to be appended to s1.
PAGE 658
strchr(3) OSS Library Calls Reference Manual NAME strchr - Finds an integer character in string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/sysnn/zcredll SYNOPSIS #include char *strchr( const char *s, int c); PARAMETERS s Specifies the string to search.
PAGE 659
OSS Library Calls (s) strcmp(3) NAME strcmp - Compares strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int strcmp( const char *s1, const char *s2); PARAMETERS s1 Specifies the first of two strings to compare. s2 Specifies the second of two strings to compare.
PAGE 660
strcoll(3) OSS Library Calls Reference Manual NAME strcoll - Compares strings using locale collation LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int strcoll( const char *s1, const char *s2); PARAMETERS s1 Specifies first string to be compared.
PAGE 661
OSS Library Calls (s) strcpy(3) NAME strcpy - Copies strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strcpy( char *s1, const char *s2); PARAMETERS s1 Specifies the destination string for the copying. s2 Specifies the source string for the copying.
PAGE 662
strcspn(3) OSS Library Calls Reference Manual NAME strcspn - Returns length of initial segment of string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include size_t strcspn( const char *s1, const char *s2); PARAMETERS s1 Points to a character string being checked for an initial segment.
PAGE 663
OSS Library Calls (s) strdup(3) NAME strdup - Duplicates a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *strdup( const char s1); PARAMETERS s1 Points to the string to be duplicated.
PAGE 664
strerror(3) OSS Library Calls Reference Manual NAME strerror - Accesses message explaining function error LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *strerror( int errnum); PARAMETERS errnum Specifies an error-number value.
PAGE 665
OSS Library Calls (s) strfmon(3) NAME strfmon - Formats monetary strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS include #include ssize_t strfmon( char *s, size_t maxsize, char *format [,double value] . . .); PARAMETERS s Contains the output of the strfmon( ) function.
PAGE 666
strfmon(3) OSS Library Calls Reference Manual flag is ignored unless a left precision is specified. ^ The ˆ (circumflex) flag suppresses grouping digits when formatting the currency amount. The default is to group the digits and separate them with the grouping characters if defined for the current locale. + The + (plus) character specifies that the locale’s equivalent of + and - are used to indicate positive and negative values.
PAGE 667
OSS Library Calls (s) strfmon(3) The following table lists the default values used by the strfmon( ) function when there are no values defined in the locale for these members of the lconv structure. These are the defaults for the C locale. For all other lconv members, such as mon_thousands_sep, there are no defaults. Table 6−1. Default Values for Monetary Formatting L Explanation L Default Value Structure _lconv _______________________________________________________________ L L .
PAGE 668
strfmon(3) OSS Library Calls Reference Manual converted, including the character that caused the overflow. The infbuf parameter points to the first byte of the characters left to covert. RELATED INFORMATION Functions: localeconv(3), scanf(3), strftime(3).
PAGE 669
OSS Library Calls (s) strftime(3) NAME strftime - Converts a date and time to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 670
strftime(3) OSS Library Calls Reference Manual The format parameter has the following syntax: [ordinary-text] [%[[-|0]width] [.precision] format-code [ordinary-text]]... ordinary-text Text that is copied to the output parameter with no changes. width A decimal digit string that specifies the minimum field width. If the width of the item equals or exceeds the minimum field width, the minimum is ignored.
PAGE 671
OSS Library Calls (s) 527187-004 strftime(3) D The format is fixed to return %m/%d/%y. (For example, 20 Jun 1990 will return 06/20/90.) e The day of the month is output as a number between 1 and 31 in a 2-digit field with leading space fill. Ec Specifies the locale’s alternate appropriate date and time representation. EC Specifies the name of the base year (period) in the locale’s alternate representation. Ex Specifies the locale’s alternate date representation.
PAGE 672
strftime(3) 6−94 OSS Library Calls Reference Manual OS Specifies the seconds using the locale’s alternate numeric symbols. OU Specifies the week number of the year (Sunday as the first day of the week) using the locale’s alternate numeric symbols. OV Specifies the week number of the year (Monday as the first day of the week) using the locale’s alternate numeric symbols. Ow Specifies the weekday as a number in the locale’s alternate representation (Sunday = 0).
PAGE 673
OSS Library Calls (s) strftime(3) x The short date is output in the format specified for the current locale. X The time is output in the format specified for the current locale. y The year is output as a number (without the century) between 00 and 99. Y The year is output as a number (with the century) between 0000 and 9999. Z The (standard time or daylight saving time) time-zone name is output as a string from the environment variable TZ (CDT, for example).
PAGE 674
strftime(3) OSS Library Calls Reference Manual RETURN VALUES The strftime( ) function returns the number of bytes written into the array pointed to by the s parameter when the total number of resulting bytes, including the terminating null character, is not more than the value of the maxsize parameter. The returned value does not count the terminating null byte in the number of bytes written into the array.
PAGE 675
OSS Library Calls (s) strlen(3) NAME strlen - Finds length of string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include size_t strlen( const char *s); PARAMETERS s Specifies the string. DESCRIPTION The strlen( ) function returns the number of bytes in the string pointed to by the s parameter.
PAGE 676
strncasecmp(3) OSS Library Calls Reference Manual NAME strncasecmp - Compares two strings, ignoring case LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int strncasecmp(const char *s1, const char *s2, size_t n); PARAMETERS s1 Is a pointer to the first string to be compared.
PAGE 677
OSS Library Calls (s) strncat(3) NAME strncat - Appends bytes to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strncat( char *s1, const char *s2, size_t n); PARAMETERS s1 Points to a location containing first string.
PAGE 678
strncmp(3) OSS Library Calls Reference Manual NAME strncmp - Compares two strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int strncmp( const char *s1, const char *s2, size_t n); PARAMETERS s1 Points to a location containing first string.
PAGE 679
OSS Library Calls (s) strncpy(3) NAME strncpy - Copies a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strncpy( char *s1, const char *s2, size_t n); PARAMETERS s1 Points to a location containing first string.
PAGE 680
strpbrk(3) OSS Library Calls Reference Manual NAME strpbrk - Finds one of a set of bytes in a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strpbrk( const char *s1, const char *s2); PARAMETERS s1 Specifies a string being searched. s2 Specifies a set of bytes in a string.
PAGE 681
OSS Library Calls (s) strptime(3) NAME strptime - Converts a character string to a time value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 682
strptime(3) 6−104 OSS Library Calls Reference Manual c Inputs the date and time, using the locale’s default format. C Inputs the century as a decimal number in the range from 00 to 99. d Inputs the day of the month as a decimal number in the range from 01 to 31. D Inputs the date as %m %d %y. e Same as d. E Inputs the year, using the locale-dependent Emperor/Era name and year format. h Same as b. H Inputs the hour based on a 24-hour clock as a decimal number in the range from 00 to 23.
PAGE 683
OSS Library Calls (s) strptime(3) Y Inputs the year, including the century (for example, 1991). Z Inputs the time-zone name. % Inputs a % (percent sign) character. Alternative-format Directives The E and O characters can be used with some of the directives to stipulate that an alternative format be used, if available. If the alternative format is not available in the locale, the modifier will be ignored, and the unmodified behavior for that directive will be followed.
PAGE 684
strptime(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completition, the strptime( ) function returns a pointer to the character following the last character parsed. Otherwise, a null pointer is returned. RELATED INFORMATION Functions: scanf(3), strfmon(3), strftime(3), time(3).
PAGE 685
OSS Library Calls (s) strrchr(3) NAME strrchr - Searches for character in string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strrchr( const char *s, int c); PARAMETERS s Specifies the string to search. c Specifies a character, expressed as an int data type, to search for.
PAGE 686
strspn(3) OSS Library Calls Reference Manual NAME strspn - Returns length of initial segment of string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include size_t strspn( const char *s1, const char *s2); PARAMETERS s1 Points to a character string being checked for an initial segment.
PAGE 687
OSS Library Calls (s) strstr(3) NAME strstr - Finds a substring LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strstr( const char *s1, const char *s2); PARAMETERS s1 Specifies the character string being searched. s2 Specifies the substring to be located.
PAGE 688
strtod(3) OSS Library Calls Reference Manual NAME strtod - Converts a character string to a double-precision floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 689
OSS Library Calls (s) strtod(3) NOTES In the TNS environment, the strtod( ) function supports only the C/POSIX locale. In the native environment, all locales are supported. This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values in the native environment. IEEE values can include NaN and infinity, and the sign of 0.0 (zero) can be either positive or negative. Refer to the fp_class(3) reference page for a description of IEEE value classes.
PAGE 690
strtok(3) OSS Library Calls Reference Manual NAME strtok - Splits string into tokens LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *strtok( char *s1, const char *s2); PARAMETERS s1 Contains a pointer to the string to be searched.
PAGE 691
OSS Library Calls (s) strtok(3) EXAMPLES The following example demonstrates how to split a string into tokens. #include #include #include
PAGE 692
strtol(3) OSS Library Calls Reference Manual NAME strtol - Converts a character string to a signed long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long int strtol ( const char *nptr, char **endptr, int base); PARAMETERS nptr Points to the character string to convert.
PAGE 693
OSS Library Calls (s) strtol(3) converted: Character 0 1 2 3 4 5 6 7 8 9 A a Value B b C c D d E e F f G H g h I i J j 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 694
strtol(3) OSS Library Calls Reference Manual RETURN VALUES The strtol( ) function returns the converted value of long integer if the expected form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the converted value is outside the range of representable values, LONG_MAX or LONG_MIN is returned (according to the sign of the value).
PAGE 695
OSS Library Calls (s) strtoll(3) NAME strtoll - Converts a character string to a signed long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long long int strtoll ( const char *nptr, char **endptr, int base); PARAMETERS nptr Points to the character string to convert.
PAGE 696
strtoll(3) OSS Library Calls Reference Manual converted: Character 0 1 2 3 4 5 6 7 8 9 A a Value B b C c D d E e F G f g H h I i J j 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 697
OSS Library Calls (s) strtoll(3) STANDARDS CONFORMANCE The behavior of this function conforms to the Single UNIX Specification, Version 3 and the 1999 ANSI C standard.
PAGE 698
strtoul(3) OSS Library Calls Reference Manual NAME strtoul - Converts a character string to an unsigned long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 699
OSS Library Calls (s) strtoul(3) converted: Character 0 1 2 3 4 5 6 7 8 9 A a Value B b C c D d E e F G f g H h I i J j 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 700
strtoul(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The behavior of this function conforms to the Single UNIX Specification, Version 3 and the 1999 ANSI C standard.
PAGE 701
OSS Library Calls (s) strtoull(3) NAME strtoull - Converts a string to an unsigned long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include unsigned long long int strtoull ( const char *nptr, char **endptr, int base ); PARAMETERS nptr Points to the character string to convert.
PAGE 702
strtoull(3) OSS Library Calls Reference Manual • If the value of base is 16, the characters 0x or 0X precede the sequence of letters and digits, following the sign if present. The subject sequence is the longest initial subsequence of the input string, starting with the first non-white-space character, that is of the expected form.
PAGE 703
OSS Library Calls (s) strxfrm(3) NAME strxfrm - Transforms string for collation in current locale LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t strxfrm( char *s1, const char *s2, size_t n); PARAMETERS s1 Specifies the destination string.
PAGE 704
strxfrm(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: setlocale(3), strcoll(3), strcmp(3), wcsxfrm(3).
PAGE 705
OSS Library Calls (s) swab(3) NAME swab - Swaps bytes in a byte array LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include void swab( const void *src, void *dest, ssize_t nbytes ); PARAMETERS src Points to the location of the string to copy. dest Points to the location to which the resulting string is copied.
PAGE 706
sysconf(3) OSS Library Calls Reference Manual NAME sysconf - Gets configurable system variables LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include long int sysconf( int name); PARAMETERS name Specifies the system variable to be queried.
PAGE 707
OSS Library Calls (s) sysconf(3) COLL_WEIGHTS_MAX Is the maximum number of weights that can be assigned to an entry in the LC_COLLATE locale-dependent information in a locale-definition file. Value of name: _SC_COLL_WEIGHTS_MAX EXPR_NEST_MAX Is the maximum number of expressions that can be nested within parentheses by the expr command. Value of name: _SC_EXPR_NEST_MAX IOV_MAX Is the maximum number of iovec parameter buffers that can be used per process for fragmented input or output operations.
PAGE 708
sysconf(3) OSS Library Calls Reference Manual _POSIX2_C_BIND Has the value 1 if the system supports the C language binding option from POSIX.2; otherwise, it has the value -1. Value of name: _SC_2_C_BIND _POSIX2_C_DEV Has the value 1 if the system supports the optional C Language Development Utilities from POSIX.2; otherwise, it has the value -1. Value of name: _SC_2_C_DEV _POSIX2_C_VERSION Is a value indicating the version of the POSIX.
PAGE 709
OSS Library Calls (s) sysconf(3) _POSIX2_VERSION Is the date of approval of the most current version of the POSIX.2 standard that the system supports. The date is a 6-digit number, with the first 4 digits signifying the year and the last 2 digits the month. Different versions of the POSIX.2 standard are periodically approved by the IEEE Standards Board, and the date of approval is used to distinguish between different versions.
PAGE 710
sysconf(3) OSS Library Calls Reference Manual _POSIX2_CHAR_TERM _POSIX2_LOCALEDEF _POSIX2_UPE _POSIX2_VERSION This variable is not available at compile time. Value of name: _SC_XOPEN_XCU_VERSION Use From the Guardian Environment The sysconf( ) function can be used by a Guardian process when the process has been compiled using the #define _XOPEN_SOURCE_EXTENDED 1 feature-test macro or an equivalent compiler command option.
PAGE 711
OSS Library Calls (s) syslog(3) NAME syslog - Generates Event Management Service (EMS) events and logs them LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int syslog( int priority, const char *message [value...]); PARAMETERS priority Indicates the priority of the EMS events generated by the syslog( ) function.
PAGE 712
syslog(3) OSS Library Calls Reference Manual parameter contains data to be converted according to the message string. DESCRIPTION The syslog( ) function generates Event Management Service (EMS) events, which are significant occurrences in the subsystem environment. The syslog( ) function also sends messages about events to the EMS subsystem, which collects and distributes event messages. Collector processes accept event messages and write them to log files.
PAGE 713
OSS Library Calls (s) syslog(3) Table 6−3.
PAGE 714
syslog(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: closelog(3), openlog(3), setlogmask(3). Commands: logger(1). STANDARDS CONFORMANCE The HP implementation of this function does not conform to the XPG4 Version 2 specification because the function returns a value.
PAGE 715
OSS Library Calls (s) system(3) NAME system - Executes an OSS shell command or TACL command LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int system( const char ∗ command); PARAMETERS command Specifies a valid sh OSS shell or TACL command.
PAGE 716
system(3) OSS Library Calls Reference Manual RETURN VALUES The following return values apply to the system( ) function called from OSS processes: • The system( ) function does not return until its child process has terminated. • If the command parameter is a null pointer, the system( ) function returns a value of 1 only if a command processor is available.
PAGE 717
Section 7. OSS Library Calls (t - v) This section contains reference pages documenting library calls with English names beginning with the letter t through the letter v that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 718
tan(3) OSS Library Calls Reference Manual NAME tan - Computes the trigonometric tangent function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double tan( double x); PARAMETERS x Is the value for which the trigonometric tangent function is to be computed.
PAGE 719
OSS Library Calls (t - v) tan(3) The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 527187-004 • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs. • The tan( ) function cannot cause overflow so HUGE_VAL is not returned and errno is not set to [ERANGE].
PAGE 720
tanh(3) OSS Library Calls Reference Manual NAME tanh - Computes the hyperbolic tangent function LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double tanh( double x); PARAMETERS x Is the value for which the hyperbolic tangent function is to be computed.
PAGE 721
OSS Library Calls (t - v) tcdrain(3) NAME tcdrain - Waits for output to finish LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int tcdrain( int filedes); PARAMETERS filedes Specifies an open file descriptor. DESCRIPTION The tcdrain( ) function waits until all output written to the object referred to by the filedes parameter has been transmitted.
PAGE 722
tcdrain(3) OSS Library Calls Reference Manual [ENETDOWN] The filedes parameter specifies a file in /E (a remote $ZTNT process) but communication with the remote node has been lost. [ENOTTY] The file associated with the filedes parameter is not a terminal. [EWRONGID] The function was called for an operation involving an operating system input/output process (IOP) that is in a down state or has failed. For all other error conditions, errno is set to the appropriate Guardian file-system error number.
PAGE 723
OSS Library Calls (t - v) tcflow(3) NAME tcflow - Performs flow control functions LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int tcflow( int filedes, int action); PARAMETERS filedes Specifies an open file descriptor. action Specifies one of the following actions: TCIOFF Transmits a Stop character, which is intended to cause the terminal device to stop transmitting data to the system if the IXOFF flag is set.
PAGE 724
tcflow(3) OSS Library Calls Reference Manual • An input/or output error occurred. The device holding the terminal file might be in the down state, or both processors that provide access to the device might have failed. [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment. [ENETDOWN] The filedes parameter specifies a file in /E (a remote $ZTNT process) but communication with the remote node has been lost.
PAGE 725
OSS Library Calls (t - v) tcflush(3) NAME tcflush - Flushes untransmitted output data or unread input data LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int tcflush( int filedes, int queue_selector); PARAMETERS filedes Specifies an open file descriptor associated with a terminal. queue_selector Specifies one of the following actions: TCIFLUSH Flushes data received but not read.
PAGE 726
tcflush(3) OSS Library Calls Reference Manual [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment. [ENETDOWN] The filedes parameter specifies a file in /E (a remote $ZTNT process) but communication with the remote node has been lost. [ENOTTY] The file associated with the filedes parameter is not a terminal. [EWRONGID] The function was called for an operation involving an operating system input/output process (IOP) that is in a down state or has failed.
PAGE 727
OSS Library Calls (t - v) tcgetattr(3) NAME tcgetattr - Gets the attributes associated with a terminal LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int tcgetattr( int filedes, struct termios *termios_p); PARAMETERS filedes Specifies an open file descriptor associated with a terminal. termios_p Points to a termios structure.
PAGE 728
tcgetattr(3) OSS Library Calls Reference Manual [ENETDOWN] The filedes parameter specifies a file in /E (a remote $ZTNT process) but communication with the remote node has been lost. [ENOTTY] The file associated with the filedes parameter is not a terminal. [EWRONGID] The function was called for an operation involving an operating system input/output process (IOP) that is in a down state or has failed. RELATED INFORMATION Functions: tcsetattr(3). Files: termios(4).
PAGE 729
OSS Library Calls (t - v) tcgetpgrp(3) NAME tcgetpgrp - Gets the foreground process group ID LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t tcgetpgrp( int filedes); PARAMETERS filedes Indicates the open file descriptor for the terminal special file.
PAGE 730
tcgetpgrp(3) • 7−14 OSS Library Calls Reference Manual The tcgetpgrp( ) function can return the errno values [EISGUARDIAN] and [ENETDOWN].
PAGE 731
OSS Library Calls (t - v) tcsendbreak(3) NAME tcsendbreak - Sends a break on an asynchronous serial data line LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int tcsendbreak( int filedes, int duration); PARAMETERS filedes Specifies an open file descriptor. duration Specifies the number of milliseconds for which zero-valued bits are transmitted.
PAGE 732
tcsendbreak(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: tcdrain(3), tcflow(3), tcflush(3). Files: termios(4). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 7−16 The tcsendbreak( ) function can return the errno values [EISGUARDIAN], [ENETDOWN], and [EWRONGID].
PAGE 733
OSS Library Calls (t - v) tcsetattr(3) NAME tcsetattr - Sets the attributes associated with a terminal LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int tcsetattr( int filedes, int optional_actions, const struct termios *termios_p); PARAMETERS filedes Specifies an open file descriptor associated with a terminal. optional_actions Specifies options defining how the attributes will be set.
PAGE 734
tcsetattr(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the tcsetattr( ) function sets errno to the corresponding value: [EBADF] The filedes parameter is not a valid file descriptor. [EFAULT] The system detected a bad address while processing a parameter of the function call.
PAGE 735
OSS Library Calls (t - v) tcsetpgrp(3) NAME tcsetpgrp - Sets the foreground process group ID LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int tcsetpgrp( int filedes, pid_t pgrp_id); PARAMETERS filedes Specifies an open file descriptor. pgrp_id Specifies the process group ID.
PAGE 736
tcsetpgrp(3) OSS Library Calls Reference Manual [EPERM] The pgrp_id parameter is valid, but it matches a process ID or process group ID of a process in another session. RELATED INFORMATION Functions: tcgetpgrp(3). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The tcsetpgrp( ) function can return the errno value [EPERM].
PAGE 737
OSS Library Calls (t - v) tdelete(3) NAME tdelete - Deletes a node from a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 738
telldir(3) OSS Library Calls Reference Manual NAME telldir - Returns current position within a directory stream LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ long telldir( DIR *dir_pointer); PARAMETERS dir_pointer Points to the dir structure of an open directory. DESCRIPTION The type DIR, which is defined in the dirent.
PAGE 739
OSS Library Calls (t - v) telldir(3) ERRORS If any of the following conditions occurs, the telldir( ) function sets errno to the corresponding value: [EBADF] The dir_pointer parameter does not point to a valid directory structure open for reading. This error is returned instead of [EFAULT] if the process has copied and altered the structure pointed to by the dir_pointer parameter after the system has freed the buffer that contains the structure.
PAGE 740
tempnam 3( ) OSS Library Calls Reference Manual NAME tempnam - Constructs the name for an OSS temporary file LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *tempnam( const char *directory, const char *prefix); PARAMETERS directory Points to the pathname of the directory in which the file is to be created. prefix Points to an initial character sequence with which the filename begins.
PAGE 741
OSS Library Calls (t - v) terminate_program(3) NAME terminate_program - Terminates a process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll | | | SYNOPSIS #include
PAGE 742
terminate_program(3) OSS Library Calls Reference Manual For active backup process pairs, if the primary process calls terminate_program( ) and specifies normal termination (the option value is zero), both the primary and backup processes terminate. To ensure that all cleanup operations that the C library needs to perform are done, do not call the Guardian system procedures STOP, ABEND, or PROCESS_STOP_ directly to terminate your program.
PAGE 743
OSS Library Calls (t - v) tfind(3) NAME tfind - Finds a node in a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 744
time(3) OSS Library Calls Reference Manual NAME time - Gets time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include time_t time ( time_t *tloc); PARAMETERS tloc Points to the location where the return value is stored. When this parameter is a null pointer, no value is stored.
PAGE 745
OSS Library Calls (t - v) times(3) NAME times - Gets process and child process times LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include clock_t times( struct tms *buffer); PARAMETERS buffer Points to a type tms structure where system time information is to be stored.
PAGE 746
times(3) OSS Library Calls Reference Manual clock_t tms_cutime User time, children. The sum of the tms_utime and tms_cutime times of the terminated child processes. clock_t tms_cstime System time, children. The sum of the tms_stime and tms_cstime times of the terminated child processes. Use From the Guardian Environment A Guardian process can call times( ) with the following restrictions: • Child times are not maintained. • All processor time is accumulated as user time.
PAGE 747
OSS Library Calls (t - v) tmpfile(3) NAME tmpfile - Creates a temporary file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the tmpfile( ) function: tmpfile_oss( ) and tmpfile_guardian( ).
PAGE 748
tmpfile_guardian(3) OSS Library Calls Reference Manual NAME tmpfile_guardian - Creates a temporary file (Guardian tmpfile( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 749
OSS Library Calls (t - v) tmpfile_guardian(3) [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available. RELATED INFORMATION Functions: fopen(3), tmpfile(3), tmpfile_oss(3), tmpnam(3), unlink(2). STANDARDS CONFORMANCE The tmpfile_guardian( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 750
tmpfile_oss(3) OSS Library Calls Reference Manual NAME tmpfile_oss - Creates a temporary file (OSS tmpfile( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 751
OSS Library Calls (t - v) tmpfile_oss(3) [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available. [ENOSPC] The directory or file system that would contain the new file cannot be expanded. RELATED INFORMATION Functions: fopen(3), tmpfile(3), tmpfile_guardian, tmpnam(3), unlink(2). STANDARDS CONFORMANCE The tmpfile_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 752
tmpnam(3) OSS Library Calls Reference Manual NAME tmpnam - Constructs the name for a temporary file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the tmpnam( ) function: tmpnam_oss( ) and tmpnam_guardian( ).
PAGE 753
OSS Library Calls (t - v) tmpnam_guardian(3) NAME tmpnam_guardian - Constructs the name for a temporary file (Guardian tmpnam( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 754
tmpnam_guardian(3) OSS Library Calls Reference Manual If the s parameter is not a null pointer, it is assumed to be the address of an array of at least the number of bytes specified by L_tmpnam. L_tmpnam is a constant defined in the stdio.h header file. The tmpnam( ) function places its results into that array and returns the value of the s parameter. RELATED INFORMATION Functions: fopen(3), free(3), malloc(3), tempnam(3), tmpfile(3), tmpnam(3), tmpnam_oss(3).
PAGE 755
OSS Library Calls (t - v) tmpnam_oss(3) NAME tmpnam_oss - Constructs the name for a temporary file (OSS tmpnam( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 756
tmpnam_oss(3) OSS Library Calls Reference Manual To use the tmpnam_oss( ) or tmpnam_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro. RETURN VALUES If the s parameter is a null pointer, the tmpnam( ) function places its result into an internal static area and returns a pointer to that area. The next call to this function might modify the contents of the area.
PAGE 757
OSS Library Calls (t - v) toascii(3) NAME toascii - Translates integer to 7-bit ASCII character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int toascii ( int c); PARAMETERS c Specifies the integer to be converted.
PAGE 758
_tolower(3) OSS Library Calls Reference Manual NAME _tolower - Translates uppercase characters to lowercase characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int _tolower ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 759
OSS Library Calls (t - v) tolower(3) NAME tolower - Translates uppercase characters to lowercase LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int tolower ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 760
_toupper(3) OSS Library Calls Reference Manual NAME _toupper - Translates lowercase characters to uppercase characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int _toupper ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 761
OSS Library Calls (t - v) toupper(3) NAME toupper - Translates lowercase characters to uppercase characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int toupper ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 762
towlower(3) OSS Library Calls Reference Manual NAME towlower - Translate uppercase to lowercase wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll | | | SYNOPSIS #include wint_t towlower ( wint_t wc); PARAMETER wc Specifies the wide character to convert.
PAGE 763
OSS Library Calls (t - v) towupper(3) NAME towupper - Translates lowercase to uppercase wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll | | SYNOPSIS #include wint_t towupper ( wint_t wc); PARAMETER wc Specifies the wide character to convert.
PAGE 764
tsearch(3) OSS Library Calls Reference Manual NAME tsearch - Builds and searches a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 765
OSS Library Calls (t - v) tsearch(3) RETURN VALUES If a node is found, the tsearch( ) function inserts the entry and returns a pointer to the newly inserted entry. The tsearch( ) function returns a null pointer when there is not enough space available to create a new node. The tsearch( ) function also returns a null pointer if rootp is a null pointer on entry. RELATED INFORMATION Functions: bsearch(3), hsearch(3), lsearch(3), tfind(3), tdelete(3), twalk(3), qsort(3).
PAGE 766
ttyname(3) OSS Library Calls Reference Manual NAME ttyname - Gets the name of a terminal LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl H-series OSS processes: /G/system/zdllnnn/zossfdll SYNOPSIS #include char *ttyname( int filedes); PARAMETERS filedes Specifies an open file descriptor. DESCRIPTION The ttyname( ) function gets the name of a terminal.
PAGE 767
OSS Library Calls (t - v) ttyname(3) The following are HP extensions to the XPG4 Version 2 specification: • 527187-004 The ttyname( ) function can return the errno values [EISGUARDIAN], [ENOCRE], and [ENOMEM].
PAGE 768
twalk(3) OSS Library Calls Reference Manual NAME twalk - Traverses a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void twalk( const void *root, void (*action) (const void *, VISIT, int) ); PARAMETERS root Points to the root of the binary tree to be walked.
PAGE 769
OSS Library Calls (t - v) tzset(3) NAME tzset - Converts time units LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 770
tzset(3) OSS Library Calls Reference Manual External variable daylight is set to nonzero when a daylight-saving time conversion should be applied. By default, this conversion follows standard U.S. time conventions; other time conventions may be specified. The default conversion algorithm adjusts for peculiarities of U.S. daylight-saving time in 1974 and 1975. RETURN VALUES The tzset( ) function returns no value. ERRORS The tzset( ) function returns no errors. This function does not set errno.
PAGE 771
OSS Library Calls (t - v) ungetc(3) NAME ungetc - Pushes a character back into the input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ungetc( int c, FILE *stream); PARAMETERS c Specifies a byte to be inserted into the input stream. stream Specifies the input stream.
PAGE 772
ungetwc(3) OSS Library Calls Reference Manual NAME ungetwc - Pushes a wide character back into the input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t ungetwc( wint_t wchar, FILE *stream); PARAMETERS c Specifies a byte to be inserted into the input stream.
PAGE 773
OSS Library Calls (t - v) unordered(3) NAME unordered - Tests whether one value is unordered relative to another value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int unordered( double x, double y ); PARAMETERS x Specifies a double-precision floating-point value in IEEE 754 format.
PAGE 774
usleep(3) OSS Library Calls Reference Manual NAME usleep - Suspends execution for an interval LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include | | extern int usleep (unsigned int useconds); PARAMETERS useconds Specifies the number of microseconds to suspend execution. A value greater than 1000000 causes the function call to fail and errno to be set to [EINVAL].
PAGE 775
OSS Library Calls (t - v) usleep(3) RETURN VALUES If the usleep( ) function returns because the requested time has elapsed, the value 0 (zero) is returned. If the usleep( ) function returns because a signal was caught, the number of microseconds still remaining when the signal was delivered is returned. If the function call fails, the value -1 is returned and errno is set to indicate the error.
PAGE 776
va_arg(3) OSS Library Calls Reference Manual NAME va_arg - Returns a parameter from a variable-length parameter list LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include type va_arg( va_list ap, type); PARAMETERS ap This parameter is used to extract parameters from the parameter list. type A type name, expressed so that a pointer to an object of this type can be generated by appending an * (asterisk).
PAGE 777
OSS Library Calls (t - v) va_end(3) NAME va_end - Ends processing for a variable-length parameter list LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void va_end( va_list ap); PARAMETERS ap This parameter is used to extract parameters from the parameter list. DESCRIPTION The stdarg macros allow you to write portable functions that accept a variable number of parameters.
PAGE 778
valloc(3) OSS Library Calls Reference Manual NAME valloc - Provide a memory allocator LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void *valloc( size_t size); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 779
OSS Library Calls (t - v) va_start(3) NAME va_start - Initializes processing for a variable-length parameter list LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void va_start( va_list ap, parmn); PARAMETERS ap This parameter is used to extract parameters from the parameter list. parmn The identifier of the rightmost named parameter in the function declaration for the function that has a variable-length parameter list.
PAGE 780
va_start(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: va_arg(3), va_end(3), vfprintf(3).
PAGE 781
OSS Library Calls (t - v) vfprintf(3) NAME vfprintf - Formats a variable number of parameters for output LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include int vfprintf ( FILE *stream, const char *format, va_list printarg); PARAMETERS stream Specifies the output stream.
PAGE 782
vfprintf(3) OSS Library Calls Reference Manual • - Left align within the field the result of the conversion. + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero).
PAGE 783
OSS Library Calls (t - v) • vfprintf(3) An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
PAGE 784
vfprintf(3) 7−68 OSS Library Calls Reference Manual x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 785
OSS Library Calls (t - v) vfprintf(3) S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 786
vfprintf(3) void { OSS Library Calls Reference Manual error(char *funct, char *fmt, ...) va_list args; /* ** Display the name of the function that called error */ fprintf(stderr, "ERROR in %s: ", funct); /* ** Display the remainder of the message */ va_start(args, fmt); vfprintf(stderr, fmt, args); va_end(args); abort(); } RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned.
PAGE 787
OSS Library Calls (t - v) [EPIPE] vfprintf(3) An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: fprintf(3), printf(3), sprintf(3), vprintf(3), vsprintf(3).
PAGE 788
vprintf(3) OSS Library Calls Reference Manual NAME vprintf - Formats a variable number of parameters for output LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 789
OSS Library Calls (t - v) vprintf(3) [EINVAL] There are insufficient arguments. [EIO] The implementation supports job control; the process is a member of a background process group attempting to write to its controlling terminal; TOSTOP is set; the process is neither ignoring nor blocking SIGTTOU; and the process group of the process is orphaned. This error might also be returned under implementation-defined conditions. [ENOMEM] Insufficient storage space was available.
PAGE 790
vsnprintf(3) OSS Library Calls Reference Manual NAME vsnprintf - Formats a variable number of parameters for output to a buffer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll | | SYNOPSIS #include #include
PAGE 791
OSS Library Calls (t - v) vsnprintf(3) the range from 1 to NL_ARGMAX. Conversion is then applied to the specified argument, rather than to the next unused argument. This feature provides for the definition of format strings in an order appropriate to specific languages. When variable ordering is used, the * (asterisk) specification for field width in precision is replaced by %digit$. If the variable ordering feature is used, it must be specified for all conversions.
PAGE 792
vsnprintf(3) OSS Library Calls Reference Manual — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 793
OSS Library Calls (t - v) vsnprintf(3) Specifying a field width with a 0 (zero) as a leading character causes the field width value to be padded with leading zeros. 527187-004 o Accepts an integer (int) value and converts it to unsigned octal notation. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 794
vsnprintf(3) OSS Library Calls Reference Manual s Accepts a pointer to an array of char type. Bytes from the array are printed until a null character is encountered or the number of characters indicated by the precision is reached. If no precision is specified, all characters up to the first null character are printed. If the precision is not specified or is greater than the size of the array, then the array must be terminated by a null byte.
PAGE 795
OSS Library Calls (t - v) vsnprintf(3) RETURN VALUES Upon successful completion, this function returns the number of bytes that would have been stored had n been sufficiently large (not counting the terminating null character). Otherwise, a negative value is returned. Thus, the null-terminated output has been completely stored if and only if the returned value is nonnegative and less than n. The value returned by the vsnprintf( ) function does not include the final ’\0’ (null) character.
PAGE 796
vsprintf(3) OSS Library Calls Reference Manual NAME vsprintf - Formats a variable number of parameters for output to a buffer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 797
Section 8. OSS Library Calls (w - z) This section contains reference pages documenting library calls with English names beginning with the letter w through the letter z that are included in Open System Services. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 798
wcscat(3) OSS Library Calls Reference Manual NAME wcscat - Appends one wide-character string to another LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 799
OSS Library Calls (w - z) wcschr(3) NAME wcschr - Searches for the first instance of a character in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 800
wcscmp(3) OSS Library Calls Reference Manual NAME wcscmp - Compares wide-character strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int wcscmp( const wchar_t *wcstring1, const wchar_t *wcstring2); PARAMETERS wcstring1 Points to a location containing the first wide-character string.
PAGE 801
OSS Library Calls (w - z) wcscoll(3) NAME wcscoll - Compares wide-character strings using collation information LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int wcscoll( const wchar_t *wcs1, const wchar_t *wcs2); PARAMETERS wcs1 Points to a wide-character string.
PAGE 802
wcscoll(3) OSS Library Calls Reference Manual ERRORS If any of the following conditions occurs, the wcscoll( ) function sets errno to the corresponding value. [EINVAL] The wide-character string pointed to by the wcs1 or wcs2 sting contained characters outside of the domain of the collating sequence. RELATED INFORMATION Functions: strcoll(3) wcscmp(3), wcsxfrm(3).
PAGE 803
OSS Library Calls (w - z) wcscpy(3) NAME wcscpy - Copies one wide-character string into another LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 804
wcscspn(3) OSS Library Calls Reference Manual NAME wcscspn - Returns the length of the initial segment of a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 805
OSS Library Calls (w - z) wcsftime(3) NAME wcsftime - Converts a date and time to a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 806
wcsftime(3) width precision OSS Library Calls Reference Manual A decimal digit string that specifies the minimum field width. If the width of the item equals or exceeds the minimum field width, the minimum is ignored. If the width of the item is less than the minimum field width, the function justifies and pads the item.
PAGE 807
OSS Library Calls (w - z) 527187-004 wcsftime(3) Ec Specifies the locale’s alternate appropriate date and time representation. EC Specifies the name of the base year (period) in the locale’s alternate representation. Ex Specifies the locale’s alternate date representation. EX Specifies the locale’s alternate time representation. Ey Specifies the offset from %EC (year only) in the locale’s alternate representation. EY Specifies the full alternate year representation.
PAGE 808
wcsftime(3) 8−12 OSS Library Calls Reference Manual OV Specifies the week number of the year (Monday as the first day of the week) using the locale’s alternate numeric symbols. Ow Specifies the weekday as a number in the locale’s alternate representation (Sunday = 0). OW Specifies the week number of the year (Monday as the first day of the week) using the locale’s alternate numeric symbols. Oy Specifies the year (offset from %C) in alternate representation.
PAGE 809
OSS Library Calls (w - z) wcsftime(3) y The year is output as a number (without the century) between 00 and 99. Y The year is output as a number (with the century) between 0000 and 9999. Z The (standard time or daylight saving time) time-zone name is output as a string from the environment variable TZ (CDT, for example). If no time-zone information exists, no characters are output. % The % (percent) character is output.
PAGE 810
wcslen(3) OSS Library Calls Reference Manual NAME wcslen - Determines the number of characters in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t wcslen( const wchar_t *wcstring); PARAMETERS wcstring A wide-character string.
PAGE 811
OSS Library Calls (w - z) wcsncat(3) NAME wcsncat - Appends wide-character strings with a character count LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 812
wcsncmp(3) OSS Library Calls Reference Manual NAME wcsncmp - Compares wide-character strings with a character count LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 813
OSS Library Calls (w - z) wcsncpy(3) NAME wcsncpy - Copies wide-character strings with a character count LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 814
wcspbrk(3) OSS Library Calls Reference Manual NAME wcspbrk - Locates the first occurrence of characters in a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *wcspbrk( const wchar_t *wcs1, const wchar_t *wcs2); PARAMETERS wcs1 Pointer to a string that is being searched.
PAGE 815
OSS Library Calls (w - z) wcsrchr(3) NAME wcsrchr - Searches for the final instance of a character in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 816
wcsspn(3) OSS Library Calls Reference Manual NAME wcsspn - Returns the length of the initial segment of a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 817
OSS Library Calls (w - z) wcstod(3) NAME wcstod - Converts a wide-character string to a double-precision floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 818
wcstod(3) OSS Library Calls Reference Manual begins with a - (minus sign), the conversion value is negated. The radix character is determined by the LC_NUMERIC category in the program’s current locale. In the C locale, or in a locale where the radix character is not defined, the radix character defaults to a . (dot).
PAGE 819
OSS Library Calls (w - z) wcstok(3) NAME wcstok - Splits wide-character strings into tokens LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *wcstok( wchar_t *ws1, const wchar_t *ws2); PARAMETERS ws1 Contains a pointer to the wide-character string that is to be searched.
PAGE 820
wcstok(3) OSS Library Calls Reference Manual character strings, from call to call. The implementation behaves as though no function calls the wcstok( ) function. EXAMPLES The following example shows how to split a wide-character string into tokens. #include #include #include
PAGE 821
OSS Library Calls (w - z) wcstol(3) NAME wcstol - Converts a wide-character string to long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 822
wcstol(3) OSS Library Calls Reference Manual Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 823
OSS Library Calls (w - z) wcstol(3) RETURN VALUES The wcstol( ) function returns the converted value of long integer if the expected form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the converted value is outside the range of representable values, LONG_MAX or LONG_MIN is returned (according to the sign of the value).
PAGE 824
wcstoll(3) OSS Library Calls Reference Manual NAME wcstoll - Converts a wide-character string to a long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 825
OSS Library Calls (w - z) wcstoll(3) Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 826
wcstombs(3) OSS Library Calls Reference Manual NAME wcstombs - Converts a wide character string into a multibyte character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 827
OSS Library Calls (w - z) wcstombs(3) RETURN VALUES If the wcstombs( ) function does not encounter an invalid wide-character code, it returns the number of bytes stored, not including the terminating null byte. When the wcstombs( ) function encounters a wide character code that does not correspond to a valid multibyte character, it returns a value of -1 cast to size_t and sets errno to indicate the error.
PAGE 828
wcstoul(3) OSS Library Calls Reference Manual NAME wcstoul - Converts wide-character strings to an unsigned long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 829
OSS Library Calls (w - z) wcstoul(3) Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value cast to unsigned integer.
PAGE 830
wcstoul(3) OSS Library Calls Reference Manual RETURN VALUES The wcstoul( ) function returns the converted value of the unsigned long integer if the expected form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the converted value is outside the range of representable values, ULONG_MAX is returned.
PAGE 831
OSS Library Calls (w - z) wcstoull(3) NAME wcstoull - Converts wide-character strings to an unsigned long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 832
wcstoull(3) OSS Library Calls Reference Manual Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value cast to unsigned integer.
PAGE 833
OSS Library Calls (w - z) wcswcs(3) NAME wcswcs - Searches for a substring in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *wcswcs( wchar_t *wcstring1, wchar_t *wcstring2); PARAMETERS wcstring1 Points to the wide-character string that is being searched.
PAGE 834
wcswidth(3) OSS Library Calls Reference Manual NAME wcswidth - Determines the display width of wide-character strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 835
OSS Library Calls (w - z) wcswidth(3) value of -1 is returned. RELATED INFORMATION Functions: wcwidth(3).
PAGE 836
wcsxfrm(3) OSS Library Calls Reference Manual NAME wcsxfrm - Transforms wide character strings for collation in the current locale LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 837
OSS Library Calls (w - z) wcsxfrm(3) ERRORS If the following condition occurs, the wcsxfrm( ) function sets errno to the corresponding value. [EINVAL] The ws2 parameter contains wide-character codes outside the domain of the collating sequence defined by the current locale. [ENOMEM] There was insufficient memory available to allocate temporary storage for this operation. RELATED INFORMATION Functions: setlocale(3), strcmp(3), strxfrm(3), wcscmp(3), wcscoll(3).
PAGE 838
wctomb(3) OSS Library Calls Reference Manual NAME wctomb - Converts a wide character into a multibyte character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int wctomb ( char *s, wchar_t wchar); PARAMETERS s Points to the location where the conversion is stored.
PAGE 839
OSS Library Calls (w - z) wctomb(3) ERRORS If any of the following conditions occur, the wctomb( ) function sets errno to the corresponding value: [EILSEQ] The wchar parameter does not correspond to a valid multibyte character. RELATED INFORMATION Functions: mblen(3), mbstowcs(3), mbtowc(3), wcstombs(3).
PAGE 840
wctype(3) OSS Library Calls Reference Manual NAME wctype - Gets a handle to classify wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wctype_t wctype( char *property); PARAMETERS property Points to a string that identifies a character class.
PAGE 841
OSS Library Calls (w - z) wctype(3) punct Punctuation character (No characters in alpha, digit, cntrl, or the space character are included.) space Space characters. At a minimum, the space, form-feed, newline, carriage-return, tab, and vertical-tab characters are included in this class upper Uppercase character. At a minimum, the 26 uppercase US-ASCII characters are included in this class. These are: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z xdigit Hexadecimal character.
PAGE 842
wcwidth(3) OSS Library Calls Reference Manual NAME wcwidth - Determines the display width of wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int wcwidth( wchar_t wc); PARAMETERS wc Specifies a wide character.
PAGE 843
OSS Library Calls (w - z) wmemchr(3) NAME wmemchr - Finds a wide character in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include wchar_t *wmemchr( const wchar_t *ws, wchar_t wc, size_t n); PARAMETERS ws Points to the location of a string.
PAGE 844
wmemchr(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification and conforms with the Single UNIX Specification, Version 2.
PAGE 845
OSS Library Calls (w - z) wmemcmp(3) NAME wmemcmp - Compare wide characters in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int wmemcmp( const wchar_t *ws1, const wchar_t *ws2, size_t n); PARAMETERS ws1 Points to the location of a destination string.
PAGE 846
wmemcpy(3) OSS Library Calls Reference Manual NAME wmemcpy - Copy wide characters in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include wchar_t *wmemcpy( wchar_t *ws1, const wchar_t *ws2, size_t n); PARAMETERS ws1 Points to the location of a destination string.
PAGE 847
OSS Library Calls (w - z) wmemmove(3) NAME wmemmove - Copy wide characters with overlapping areas in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include wchar_t *wmemmove( wchar_t *ws1, const wchar_t *ws2, size_t n); PARAMETERS ws1 Points to the location of a destination string.
PAGE 848
wmemset(3) OSS Library Calls Reference Manual NAME wmemset - Sets wide characters in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include wchar_t *wmemset( wchar_t *ws, wchar_t wc, size_t n); PARAMETERS ws Points to the location of a string. wc Specifies the first wide character to copy.
PAGE 849
OSS Library Calls (w - z) wordexp(3) NAME wordexp - Expands tokens from a stream of words LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include int wordexp( const char *words, wordexp_t *pwordexp, int flags); PARAMETERS words Specifies the string containing the tokens to be expanded. pwordexp Contains a pointer to a wordexp_t structure.
PAGE 850
wordexp(3) OSS Library Calls Reference Manual 2. Parameter expansion, command substitution, and arithmetic expansion are performed next, from beginning to end. 3. Field splitting is then performed on fields generated by Step 2, unless the IFS (Input Field Separators) is full. 4. Pathname expansion is performed, unless the set -f command is in effect. 5. Quotation-mark removal is always performed last.
PAGE 851
OSS Library Calls (w - z) wordexp(3) — Pointers to the words that were in the structure pointed to by pwordexp before the call, in the same order as before. — Pointers to the new words generated by the latest call, in the specified order. • The count returned in the structure pointed to by pwordexp is the total number of words from all of the calls. • The application should not modify the pwordexp parameter between the calls.
PAGE 852
wordexp(3) OSS Library Calls Reference Manual WRDE_ESHELL An error occurred during a read of shell data from a pipe. WRDE_NOSPACE An attempt to allocate memory was unsuccessful. WRDE_SYNTAX A shell syntax error occurred, such as unbalanced parentheses or unterminated string. If the wordexp( ) function returns the error value WRDE_NOSPACE, then the structure pointed to by the pwordexp parameter is updated to reflect any words that were successfully expanded.
PAGE 853
OSS Library Calls (w - z) wordfree(3) NAME wordfree - Frees all memory associated with the pwordexp parameter LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include void wordfree( wordexp_t *pwordexp); PARAMETERS pwordexp Points to a structure that contains a list of expanded words.
PAGE 854
y0(3) OSS Library Calls Reference Manual NAME y0 - Computes the Bessel function of the second kind, of order 0 (zero) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double y0( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 855
OSS Library Calls (w - z) y1(3) NAME y1 - Computes the Bessel function of the second kind, of order 1 LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double y1( double x); PARAMETERS x Specifies the double value for which the function is to be computed. The value of x must be positive.
PAGE 856
yn(3) OSS Library Calls Reference Manual NAME yn - Computes the Bessel function of the second kind, of order n LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include double yn( int n, double x ); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 857
OSS Library Calls (w - z) yn(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527187-004 For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN.
PAGE 858
Section 9. Miscellaneous This section contains reference pages for some miscellaneous Open System Services (OSS) topics. These reference pages reside in the cat5 directory and are arranged in alphabetical order (U.S. English).
PAGE 859
stderr(5) OSS Library Calls Reference Manual NAME stderr - Standard error stream DESCRIPTION See stdin(5).
PAGE 860
Miscellaneous stdin(5) NAME stderr, stdin, stdout - Standard I/O streams SYNOPSIS #include extern FILE *stderr, *stdin, *stdout; DESCRIPTION A file with associated buffering is called a stream and is declared to be a pointer to a defined type FILE. The fopen() function creates certain descriptive data for a stream and returns a pointer to designate the stream in all further transactions. Normally there are three open streams with constant pointers declared in the
PAGE 861
stdout(5) OSS Library Calls Reference Manual NAME stdout - Standard output stream DESCRIPTION See stdin(5).
PAGE 862
Permuted Index _____________________________ for a temporary file (OSS tmpnam( temporary file (Guardian tmpfile( Opens a stream (Guardian fopen( Opens a stream (OSS fopen( Opens a stream (Guardian freopen( Opens a stream (OSS freopen( Removes a file (Guardian remove( Removes a file (OSS remove( detected by the getaddrinfo( temporary file (Guardian tmpnam( a temporary file (OSS tmpfile( of the first kind, of order of the second kind, of order of the first kind, of order of the second kind, of order the expo
PAGE 863
OSS Library Calls Reference Manual storage for/ freeaddrinfo: Frees storage for/ freehostent: Frees /and service names into socket an integer Internet IPv4 name is/ /Gets the Internet from an Internet IPv4 host a/ dlsym: Obtains the /Gets a network host entry by and service names into socket /Converts an IPv6 or IPv4 binary a protocol-independent host protocol-independent host /Frees the memory of one or more sigaddset: expressions a network host entry by address error/ lwres_gai_strerror: timeout value for
PAGE 864
Permuted Index setbuf: setvbuf: tcgetattr: Gets the attributes tcsetattr: Sets the attributes globfree: Frees all memory wordfree: Frees all memory of/ cuserid: Gets the username descriptor fdopen: tcsendbreak: Sends a break on an trigonometric tangent function trigonometric tangent function/ hyperbolic tangent function process termination to a double-precision/ to an integer to a long integer string to a long long integer from/ /the minimum block size to user/ getpwent: Gets user user/ getpwnam: Gets user
PAGE 865
OSS Library Calls Reference Manual search tree tsearch: swab: Swaps bytes in a memchr: Finds a character byte order to Internet network byte order to Internet network network byte order to host network byte order to host /integer from Internet network /integer from Internet network byte/ /a 32-bit integer from host byte/ /a 16-bit integer from host fputc: Writes a putc: Writes a stream putchar: Writes a swab: Swaps strpbrk: Finds one of a set of mblen: Determines the length in strncat: Appends /SQL DECIMAL
PAGE 866
Permuted Index wide-character strings with a wide-character strings with a wide-character strings with a Encrypts a password or other input stream fgetwc: Gets a wide stream fgetc: Gets a stream getc: Gets a stream getwc: Gets a wide stream getchar: Gets a stream getwchar: Gets a wide /for the first instance of a /for the final instance of a memcpy: Copies a wmemchr: Finds a wide strchr: Finds an integer strrchr: Searches for for a first occurrence of a wctomb: Converts a wide Tests for an alphanumeric Test
PAGE 867
OSS Library Calls Reference Manual wmemcmp: Compare wide wmemcpy: Copy wide wmemset: Sets wide memccpy: Copies getpass: Reads a string of _tolower: Translates uppercase tolower: Translates uppercase _toupper: Translates lowercase toupper: Translates lowercase uppercase characters to lowercase lowercase characters to uppercase lowercase characters to uppercase uppercase to lowercase wide lowercase to uppercase wide Gets a handle to classify wide the display width of wide in memory memmove: Copies in memory w
PAGE 868
Permuted Index using collation/ wcscoll: with a character count wcsncmp: expressions expressions step: compile: re_comp: regcmp: erfc: Computes the basename: Returns the final integer abs: integer labs: radix-independent/ scalb: function log10: the first kind, of order 0/ j0: the first kind, of order 1 j1: the first kind, of order n jn: the second kind, of order 0/ y0: the second kind, of order 1 y1: the second kind, of order n yn: function erfc: floating-point number cbrt: two calendar times difftime: erf:
PAGE 869
OSS Library Calls Reference Manual /Saves the current execution Saves the current execution iscntrl: Tests for iswcntrl: Tests for a wide tcflow: Performs flow Generates the pathname for the heap/ heap_check_always: Closes a specified code-set Opens a character code-set host byte order to/ htons: Internet network byte/ ntohs: host byte order to/ htonl: Internet network byte/ ntohl: radix-64 ASCII string l64a: SQL DECIMAL/ longlong_to_dec: double-precision/ atof: long integer atol: long long integer atoll: t
PAGE 870
Permuted Index wmemcpy: overlapping areas in/ wmemmove: of y /Maps an interface name to its /Maps an interface index to its cosine function cosine function cos: Computes the trigonometric cosh: Computes the hyperbolic the inverse trigonometric Computes the inverse hyperbolic strings with a character strings with a character strings with a character /addrinfo structures previously opendir: Opens a directory and mkfifo: tmpfile: (Guardian/ tmpfile_guardian: tmpfile( )/ tmpfile_oss: other character data for th
PAGE 871
OSS Library Calls Reference Manual next entry in the network host the next entry in the network entry from the network services information from the user information from the user information from the user group information from the group the sequential key to the user ftime: Gets getdate: Converts user format Converts broken-down time into a time since the Epoch into a strftime: Converts a string wcsftime: Converts a database database database database stores it in a C array of type /value stored in a C
PAGE 872
Permuted Index hypot: Computes the Euclidean drand48: Generate uniformly erand48: Generates uniformly jrand48: Generate uniformly /Sets rule to generate uniformly lrand48: Generates uniformly mrand48: Generates uniformly nrand48: Generates uniformly /Sets rule to generate uniformly /Sets rule to generate uniformly div: ldiv: lldiv: the modulo remainder of a Computes the remainder of a dynamic-link library handle and/ the most recent call to dlopen(), of a previous dynamic-link/ /code for the most recent cal
PAGE 873
OSS Library Calls Reference Manual /Searches host /Gets a network host getnetbyaddr: Gets a network /Gets a network host gethostbyname: Gets a host getnetbyname: Gets a network getprotobyname: Gets a protocol address/ /Gets an Internet host address/ /Gets an Internet host Gets a network service getprotobynumber: Gets a protocol /Gets a network service sets the next entry to the first sets the next entry to the first getservent: Gets the next Gets the next protocol sets the next entry to the first sets the n
PAGE 874
Permuted Index setjmp: Saves the current sigsetjmp: Saves the current sleep: Suspends usleep: Suspends function argument _abs: arguments _max: arguments _min: words wordexp: perror: Writes a message strerror: Accesses message dynamic-link/ dlerror: Returns an function minus 1.
PAGE 875
OSS Library Calls Reference Manual remove_oss: Removes a tmpfile_oss: Creates a temporary /the name for a temporary configuration attributes for a the parent directory name of a fgetpos: Reposition the fseek: Repositions the fsetpos: Repositions the ftell: Reports the position the rewind: Repositions the output, or standard error fopen: Opens a the name for an OSS temporary the name for a temporary ftw: Traverses a nftw: Traverses a mkstemp: Makes a unique mktemp: Makes a unique fnmatch: Matches used to qua
PAGE 876
Permuted Index patterns fnmatch: Matches filename ........................................... fnmatch(3) /Opens a stream (Guardian fopen( ) function) ........................................................... fopen_guardian(3) fopen_oss: Opens a stream (OSS fopen( ) function) ........................................................... fopen_oss(3) fopen: Opens a file stream ............................................ fopen(3) (Guardian fopen( ) function) fopen_guardian: Opens a stream ....................
PAGE 877
OSS Library Calls Reference Manual the inverse trigonometric tangent the inverse hyperbolic tangent Computes the trigonometric cosine Computes the hyperbolic cosine file (Guardian tmpfile( ) Computes the complementary error Writes a message explaining a Accesses message explaining the floating-point absolute value Opens a stream (Guardian fopen( ) Opens a stream (OSS fopen( ) allocated by the if_nameindex() Opens a stream (OSS freopen( ) the logarithm of the gamma Computes the Euclidean distance the logarit
PAGE 878
Permuted Index Initialize random number array used by the random number for errors detected by the and service names into socket/ specified assign message assign message by logical-unit/ specified input stream the standard input stream current working directory date and time descriptor table size environment variable from the group database from the group database from the group database host entry by address (AF_INET/ by name host entry by name and IPv4 or/ in the network host database for the current host
PAGE 879
OSS Library Calls Reference Manual nlist: attributes for an/ fpathconf: argument vector getopt: standard input stream group database getgrent: group database getgrgid: group database getgrnam: the host/ lwres_getipnodebyname: node name/ getipnodebyname: times times: with a terminal tcgetattr: getpagesize: size getdtablesize: ID tcgetpgrp: current host.
PAGE 880
Permuted Index fopen_guardian: Opens a stream freopen_guardian: Opens a stream remove_guardian: Removes a file /Creates a temporary file /the name for a temporary file /a dynamic-link library characters wctype: Gets a for a nonlocal goto with signal a nonlocal goto with signal hcreate: Initializes a hdestroy: Removes a hsearch: Searches a table to use when allocating from the /Controls whether the run-time the consistency of the run-time consistency of the run-time heap whether the run-time heap/ the minimu
PAGE 881
OSS Library Calls Reference Manual Gets the foreground process group Sets the foreground process group gethostid: gets the memory allocated by the/ index to its corresponding name dynamic memory allocated by the names and indexes name to its corresponding index strcasecmp: Compare two strings, Compares two strings, radix-independent exponent as an/ Initializes a signal mask to name to its corresponding occurrence of a character if_indextoname: Maps an interface Gets all interface names and edfseek: Sets the
PAGE 882
Permuted Index input read from the standard Gets a character from a specified wide character from a a specified formatted input read from an Gets a character from a specified a character from the standard Gets a string from the standard a wide character from a specified wide character from the standard Pushes a character back into the a wide character back into the queue remque: a queue insque: assert: element in a queue wcschr: Searches for the first wcsrchr: Searches for the final string to a long long ra
PAGE 883
OSS Library Calls Reference Manual /Converts a 16-bit integer from /an Internet IPv4 address from an key ftok: Generates an OSS sleep: Suspends execution for an usleep: Suspends execution for an or changes the timeout value for library handle and/ dlclose: function acosh: Computes the asinh: Computes the function atanh: Computes the function acos: Computes the function asin: Computes the function of/ atan2: Computes the function atan: Computes the stderr: Standard of an Edit file opened for ANSI of an Edit
PAGE 884
Permuted Index distributed pseudorandom number/ interprocess communication (IPC) Sets an encryption or decryption setgrent: Resets the group name setpwent: Resets the sequential the Bessel function of the first the Bessel function of the second the Bessel function of the first the Bessel function of the second the Bessel function of the first the Bessel function of the second to a radix-64 ASCII string long integer nl_langinfo: Provides national uniformly distributed/ floating-point number by a power/ chara
PAGE 885
OSS Library Calls Reference Manual radix-independent exponent as a/ logb: Computes the ....................................................... logb(3) /Retrieves assign message by logical-unit name ........................................................... get_assign_msg_by_name(3) Service (EMS) events and logs them /Event Management .................................... syslog(3) longjmp: Performs a nonlocal goto ..............................
PAGE 886
Permuted Index bytes of a multibyte character character string to a wide/ character to a wide character sequentially in memory memory memory memory overlapping areas in memory bcmp: Compares two areas of bcopy: Copies an area of bzero: Zeroes an area of free: Releases allocated malloc: Allocates memchr: Finds a character byte in memcmp: Compares characters in memcpy: Copies a character in memset: Sets characters in realloc: Reallocates wmemcpy: Copy wide characters in wmemset: Sets wide characters in if_fre
PAGE 887
OSS Library Calls Reference Manual of the first kind, of order of the second kind, of order host address to host /Gets an Internet host entry by /Gets an Internet host entry by tmpnam: Constructs the tmpnam_guardian: Constructs the tmpnam_oss: Constructs the tempnam: Constructs the Gets a host entry by Gets a network entry by Gets a protocol entry by information based on the host Gets a network service entry by address (IPv4) of the host whose from/ setgrent: Resets the group nlist: Gets entries from index
PAGE 888
Permuted Index /database /etc/hosts and sets the the/ //etc/protocols and sets the getprotoent: Gets the nextafter: Computes the representable double-precision/ list language information tdelete: Deletes a tfind: Finds a /Gets host information based on IP longjmp: Performs a handling siglongjmp: Performs a current execution context for a Tests whether a value is NaN string in standard dotted-decimal string in Internet dotted-decimal distributed pseudorandom number/ from Internet network byte order/ from Int
PAGE 889
OSS Library Calls Reference Manual wcspbrk: Locates the first host entry by address (AF_INET configuration attributes for an creates a directory stream /indicator of an Edit file /indicator of an Edit file Management Service (EMS) event/ converter iconv_open: directory stream opendir: loadfile from a running/ dlopen: fopen: catopen: freopen: function) fopen_guardian: ) function) freopen_guardian: function) fopen_oss: function) freopen_oss: output, or/ fopen_std_file: /etc/hosts and sets/ sethostent: databas
PAGE 890
Permuted Index tcdrain: Waits for stream printf: Prints formatted variable number of parameters for variable number of parameters for memmove: Copies characters with /Copy wide characters with malloc_pages: Provides a memory getpagesize: Gets the current get_param_msg: Retrieves the /Retrieves value of a associated with the pwordexp parameter list va_arg: Returns a memory associated with the pglob processing for a variable-length parameter from a variable-length processing for a variable-length /Retrieves v
PAGE 891
OSS Library Calls Reference Manual to the/ rewinddir: Resets the stream ftell: Reports the stream seekdir: Sets stream telldir: Returns current pow: Computes the number into a fraction and a a floating-point number by a /Returns an explanation of a one or more addrinfo structures isprint: Tests for iswprint: Tests for a to the standard output stream the EAI_/ /Aids applications in output stream fprintf: standard output stream printf: exit: Terminates a pclose: Closes a pipe to a popen: Initiates a pipe to a
PAGE 892
Permuted Index input stream ungetc: the input stream ungetwc: specified output stream standard output stream variable standard output stream a specified stream to the standard output stream string to the standard output/ all memory associated with the and subvolume names used to locale setlocale: Changes or or removes an element in a Inserts or remove an element in a Converts a 32-bit integer to a integer a64l: Converts a logb: Computes the integer ilogb: Computes the scalb: Computes exponent of a calling p
PAGE 893
OSS Library Calls Reference Manual step: Compile and match whether one value is unordered free: of a division operation fmod: Computes the modulo remainder: Computes the /Removes a file (Guardian remove_oss: Removes a file (OSS remque: Inserts or (Guardian remove( ) function) remove( ) function) remove: ) function) remove_guardian: function) remove_oss: hdestroy: insque: Inserts or element in a queue clock: pointer of a stream ftell: stream fgetpos: stream fseek: stream fsetpos: stream rewind: nextafter: Co
PAGE 894
Permuted Index distributed/ seed48: Sets distributed/ srand48: Sets library loadfile from a checked/ /Controls whether the Checks the consistency of the context setjmp: context for a/ sigsetjmp: radix-independent floating-point/ read from the standard input/ occurrence of a character index: of a character rindex: bsearch: Performs a binary lfind: Performs a linear lsearch: Performs a linear tfind: Finds a node in a binary twalk: Traverses a binary Deletes a node from a binary Builds and searches a binary ts
PAGE 895
OSS Library Calls Reference Manual /from one character code stream key to get group information/ host database /etc/hosts and/ execution context decryption key program’s current locale locale of the process to match/ Management Service (EMS) event/ database /etc/networks and sets/ database /etc/protocols and sets/ key to the user database key setkey: putenv: memset: for interval timers alarm: stream seekdir: distributed/ lcong48: distributed pseudorandom/ seed48: distributed/ srand48: with a terminal tcseta
PAGE 896
Permuted Index the inverse trigonometric Computes the inverse hyperbolic sine function Gets the file descriptor table Gets the current page /Specifies the minimum block interval into a character array /hostnames and service names into /host names and service names into structure and storage for IPv6 structure and storage for IPv6 current/ abort: Generates a qsort: isspace: Tests for a white mkfifo: Creates a FIFO get_assign_msg: Retrieves a iconv_close: Closes a error or system console in fgetc: Gets a char
PAGE 897
OSS Library Calls Reference Manual expressions address information structure and address information structure and a C/ /Converts SQL DECIMAL value character array snprintf: character array sprintf: /value to a SQL DECIMAL value and ignoring case string character in string locale collation initial segment of string clearerr: Clears indicators on a closedir: Closes a directory fclose: Closes a feof: Tests EOF on a fflush: Flushes a fgets: Gets a string from a fopen: Opens a file fputs: Writes a string to a
PAGE 898
Permuted Index a string to the standard output a wide character to a specified character to the standard output Repositions the file pointer of a Sets position within a directory position within a directory /the position in the directory a character back into the input character back into the input fdopen: Associates a string to the standard output stderr: Standard I/O explaining function error time to a string strcat: Appends a string to a strdup: Duplicates a strlen: Finds length of strncat: Appends bytes
PAGE 899
OSS Library Calls Reference Manual /Converts a wide-character strtol: Converts a character strtoll: Converts a character fputs: Writes a fputws: Writes a wide-character strcat: Appends a strptime: Converts a character /Converts a multibyte character atoi: Converts a character inet_pton: Converts a character strtoul: Converts a character integer strtoull: Converts a Appends one wide-character wcstol: Converts a wide-character stream puts: Writes a putws: Writes a wide-character date and time to a wide-charac
PAGE 900
Permuted Index interval sleep: Suspends execution for an ............................................ sleep(3) interval usleep: Suspends execution for an ............................................ usleep(3) swab: Swaps bytes in a byte array ................................ swab(3) swab: Swaps bytes in a byte array .......................................... swab(3) the random number/ setstate: Switches hte state array used by ...................................
PAGE 901
OSS Library Calls Reference Manual isatty: isspace: hexadecimal-digit/ iswxdigit: character iswcntrl: iswdigit: character iswlower: character iswpunct: character iswupper: isalpha: character iswalpha: character isalnum: character iswalnum: isascii: iscntrl: isprint: iswgraph: stream ferror: number is infinite finite: a number) isnan: unordered relative to/ unordered: search tree alarm: Sets or changes the the timeout value for interval difference between two calendar process times Gets process and child pro
PAGE 902
Permuted Index twalk: Traverses a binary search a node from a binary search Finds a node in a binary search and searches a binary search acos: Computes the inverse cos: Computes the asin: Computes the inverse sin: Computes the atan: Computes the inverse tan: Computes the y/x atan2: Computes the inverse binary search tree terminal tree and stores it in a C array of into the input stream back into the input stream pseudorandom/ drand48: Generate pseudorandom/ erand48: Generates pseudorandom/ jrand48: Generate
PAGE 903
OSS Library Calls Reference Manual strcoll: Compares strings interval a variable-length parameter list variable-length parameter list allocator a double-precision floating-point a double-precision floating-point a double-precision floating-point /long long value to a SQL DECIMAL Sets or changes the timeout the class of a floating-point the floating-point absolute isnan: Tests whether a unordered: Tests whether one get_param_by_name: Retrieves getenv: Returns the abs: Computes absolute _abs: Expands absolute
PAGE 904
Permuted Index width of wide-character strings character strings for collation/ into a multibyte character wide characters width of wide characters is infinite finite: Tests number) isnan: Tests relative to/ unordered: Tests heap_check_always: Controls isspace: Tests for a iswspace: Test for a wide address (IPv4) of the host iswalpha: Tests for an alphabetic iswprint: Tests for a printable input stream ungetwc: Pushes a input stream fgetwc: Gets a input stream getwc: Gets a input stream getwchar: Gets a wme
PAGE 905
OSS Library Calls Reference Manual character count wcsncat: Appends character/ wcsncmp: Compares character count wcsncpy: Copies wcwidth: Determines the display wcswidth: Determines the display seekdir: Sets position telldir: Returns current position characters (such as a password) in memory in memory memory with overlapping areas in memory memory getw: Gets a putw: Writes a stream of words associated with the pwordexp/ Expands tokens from a stream of Gets the pathname of the current Gets the pathname of th
PAGE 906
Index _____________________________ A B a64l function, 1-2 abort, 1-16 abort function, 1-3 abs function, 1-5 _abs macro, 1-4 absolute value function, 1-5, 4-64 macro, 1-4 acos function, 1-6 to 1-7 acosh function, 1-8 advance macro, 1-9 to 1-10 alarm function, 1-11 alpha class type test, 4-30, 4-31, 4-43 alphanumeric class type test, 4-29, 4-31, 4-42 argument vector, returning flag letters from, 3-53 asctime function, 1-12 asin function, 1-13 to 1-14 asinh function, 1-15 assert macro, 1-16 assigning buffe
PAGE 907
OSS Library Calls Reference Manual cfgetispeed function, 1-40 cfgetospeed function, 1-41 cfsetispeed function, 1-42 cfsetospeed function, 1-43 character classification functions, 4-29, 4-30, 4-31, 4-33, 4-34, 4-35, 4-36, 4-38, 4-39, 4-40, 4-41, 4-54 converting multibyte to wide, 4-119 finding length of multibyte, 4-116 getting from input stream, 2-39, 3-82, 3-83 locating first occurrence in a string, 8-18 pushing back, 7-55, 7-56 translating to 7-bit ASCII, 7-41 translating to lowercase, 7-42, 7-43 translat
PAGE 908
Index user, 2-8, 3-27, 3-29, 3-31, 6-15 date conversion, 6-91, 8-9 daylight external variable, 7-53 to 7-54 dbm_clearerr function, 1-65 dbm_close function, 1-65 dbm_delete function, 1-65 dbm_error function, 1-65 dbm_fetch function, 1-65 dbm_firstkey function, 1-65 dbm_nextkey function, 1-65 dbm_open function, 1-65 dbm_store function, 1-65 dec_to_longlong function, 1-77 decimal type, 1-77, 4-87 to 4-88 decrypting data, 2-7, 6-18 password, 2-7, 6-18 default subvolume, 1-44 default volume, 1-44 diagnostics, in
PAGE 909
OSS Library Calls Reference Manual [ELOOP], 2-113, 5-7, 5-16, 5-24 [ENAMETOOLONG], 2-109, 2-113, 4-129, 5-7, 5-16, 5-24 [ENETDOWN], 2-62, 7-6, 7-8, 7-10, 7-12, 7-13, 7-15, 7-18, 7-19 [ENOCRE], 3-20, 3-30, 5-16, 7-50 [ENOENT], 2-113, 3-20, 3-30, 5-7, 5-16 [ENOMEM], 1-60, 1-64, 2-113, 3-20, 3-30, 4-8, 4-11, 4-12, 5-7, 5-16, 5-31, 7-50 [ENOROOT], 2-109, 2-113, 3-20, 4-130, 5-7, 5-16, 5-25 [ENOSPC], 3-3, 3-11, 3-49, 4-22 [ENOTDIR], 2-114, 5-7, 5-16 [ENOTOSS], 1-60, 5-26, 5-31, 5-59, 6-44 [ENOTTY], 7-6, 7-8, 7-1
PAGE 910
Index temporary, 7-31, 7-32, 7-34 finite function, 2-42 flag letters, returning from argument vector, 3-53 floating-point integer absolute value function, 2-22 modulo remainder function, 2-44 round functions, 1-39, 2-43 floating-point number converting to fraction and integral power of 2, 2-93 converting to integral and fractional parts, 4-135 multiplying by integral power of 2, 4-67 floor function, 2-43 flow control functions, 7-7 flushing input data, 7-9 flushing output data, 7-9 fmod function, 2-44 to 2-
PAGE 911
OSS Library Calls Reference Manual getgrgid function, 3-29 to 3-30 getgrnam function, 3-31 to 3-32 gethostbyaddr function, 3-33 to 3-34 gethostbyname function, 3-37 to 3-38 gethostbyname2 function, 3-35 to 3-36 gethostent function, 3-39 gethostid function, 3-40 getipnodebyaddr function, 3-41 getipnodebyname function, 3-43 getnameinfo function, 3-47 getnetbyaddr function, 3-50 getnetbyname function, 3-51 getnetent function, 3-52 getopt function, 3-53 to 3-55 getpagesize function, 3-56 getpass function, 3-60
PAGE 912
Index returning by name, 3-37 hosts file opening, 6-16 reading next line, 6-16 resetting file marker, 6-16 retrieving entries, 6-16 hosts name files searching by address, 3-33 searching by name, 3-37 hsearch function, 3-99 to 3-100 htonl function, 3-101 htons function, 3-102 hyperbolic functions, 1-58, 6-49, 7-4 hypot function, 3-103 to 3-104 hypotenuse function, 3-103 I iconv function, 4-2 iconv_close function, 4-4 iconv_open function, 4-5 if_freenameindex function, 4-7 if_indextoname function, 4-8 if_nam
PAGE 913
OSS Library Calls Reference Manual iswlower function, 4-48 iswprint function, 4-49 iswpunct function, 4-50 iswspace function, 4-51 iswupper function, 4-52 iswxdigit function, 4-53 isxdigit function, 4-54 J j0 function, 4-55 to 4-56 j1 function, 4-57 to 4-58 jn function, 4-59 to 4-60 jrand48 function, 4-61 to 4-62 jump point, setting, 6-46 lrand48 function, 4-89 to 4-90 lsearch function, 4-91 to 4-92 lwres_freeaddrinfo function, 4-93 lwres_freehostent function, 4-94 lwres_gai_strerror function, 4-95 lwres_
PAGE 914
Index 2-82, 4-113, 4-114, 5-67, 7-62 memory area, manipulating strings in, 4-121, 4-122, 4-123, 4-124, 4-125, 4-126, 8-47, 8-49, 8-50, 8-51, 8-52 memory areas, manipulating bytes in, 1-29, 1-30, 1-32 memory operations, 1-29, 1-30, 1-32, 4-121, 4-122, 4-123, 4-124, 4-125, 4-126, 8-47 to 8-48, 8-49, 8-50, 8-51, 8-52 memset function, 4-126 message, retrieving from message catalog, 1-35 message catalog closing, 1-34 opening, 1-36 retrieving a message from, 1-35 messages, for function errors, 5-29 _min macro, 4-
PAGE 915
OSS Library Calls Reference Manual 5-63, 5-99, 6-12, 7-22 operations on strings, 6-79, 6-81, 6-83 optarg, external variable, 3-53 output finishing, 7-5 flushing, 7-9 formatting parameters, 7-65, 7-72, 7-74, 7-80 printing and formatting, 2-66, 5-35, 6-52, 6-58 output stream, writing word to, 5-49 to 5-50 P parameters formatting for output, 7-65, 7-72, 7-74, 7-80 locale-dependent, 4-74 password decrypting, 2-7, 6-18 encrypting, 1-59, 2-7, 6-18 reading, 3-60 pathconf function, 5-21 to 5-25 pathname, generatin
PAGE 916
Index Q S qsort function, 5-57 to 5-58 querying locale, 6-19 saving execution context, 6-17 scalb function, 6-2 scanf function, 6-4 to 6-9 search trees, 7-21, 7-27, 7-48, 7-52 seed48 function, 6-10 to 6-11 seekdir function, 6-12 to 6-13 sending signals, 5-59 service entry returning by name, 3-73 returning by port, 3-74 service file entry, 6-29 services file closing, 2-13 opening, 3-75 reading next line, 3-75 searching by name, 3-73 searching by port, 3-74 setbuf function, 6-14 setgrent function, 6-15 se
PAGE 917
OSS Library Calls Reference Manual sigemptyset function, 6-37 to 6-38 sigfillset function, 6-39 sigismember function, 6-40 siglongjmp function, 6-41 to 6-42 signal taking action upon receipt, 6-43 to abort current process, 1-3 signal function, 6-43 to 6-45 signal handling for nonlocal goto, 6-41 signal masks, creating and manipulating, 6-33, 6-35, 6-37, 6-39, 6-40 signals, sending, 5-59 signgam global variable, 3-4 to 3-5, 4-71 to 4-72 sigsetjmp function, 6-46 sin function, 6-47 to 6-48 sinh function, 6-49
PAGE 918
Index character to integer, 1-25, 1-26, 1-27, 6-114, 6-117, 6-120, 6-123 string length, 6-97 string manipulation, 6-79, 6-81, 6-83 string operations, 6-79, 6-81, 6-83 strings manipulating in memory area, 4-121, 4-122, 4-123, 4-124, 4-125, 4-126, 8-47, 8-49, 8-50, 8-51, 8-52 writing out, 2-74, 5-47 strlen function, 6-97 strncasecmp function, 6-98 strncat function, 6-99 strncmp function, 6-100 strncpy function, 6-101 strpbrk function, 6-102 strptime function, 6-103 strrchr function, 6-107 strspn function, 6-1
PAGE 919
OSS Library Calls Reference Manual TZNAME_MAX, 6-131 WRDE_APPEND, 8-54 WRDE_BADCHAR, 8-55 WRDE_BADVAL, 8-55 WRDE_CMDSUB, 8-55 WRDE_DOOFFS, 8-54 WRDE_EOPEN, 8-55 WRDE_ESHELL, 8-56 WRDE_NOCMD, 8-54 WRDE_NOSPACE, 8-56 WRDE_REUSE, 8-54 WRDE_SHOWERR, 8-54 WRDE_SYNTAX, 8-56 WRDE_UNDEF, 8-54 sysconf function, 6-128 to 6-132 syslog function, 6-133 to 6-136 system clock getting time, 7-28 times of process and child process, 7-29 system function, 6-137 to 6-138 system log, 1-49, 5-18, 6-25, 6-133 system variable, fin
PAGE 920
Index _tolower macro, 7-42 toupper function, 7-45 _toupper macro, 7-44 towlower function, 7-46 towupper function, 7-47 trees, binary search, 7-21, 7-27, 7-48, 7-52 trigonometric functions, 1-8, 1-15, 1-20, 1-56, 6-47, 7-2 tsearch function, 7-48 to 7-49 ttyname function, 7-50 to 7-51 twalk function, 7-52 type conversion, 1-77, 4-87 to 4-88 tzname external variable, 7-53 to 7-54 tzset function, 7-53 to 7-54 U ungetc function, 7-55 ungetwc function, 7-56 unordered function, 7-57 UNRESOLVED_PROCEDURE_CALLED fu
PAGE 921
OSS Library Calls Reference Manual wctype function, 8-44 wcwidth function, 8-46 wide character, converting to multibyte, 8-42 wide character string, converting to multibyte, 8-30 wide characters locating in a string, 8-37 returning number, 8-8, 8-20 wide-character string, determining the number of characters, 8-14 wide-character strings, comparing, 8-5 wide-characters appending, 8-15 appending copy, wcscat function, 8-2 comparing, 8-16 comparing two wchar_t strings, wcscmp function, 8-4 computing number of