Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

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.28 and all subsequent G-series RVUs and H06.05 and all

subsequent H-series RVUs until otherwise indicated by its replacement publication.

Part Number Published

527187-007 July 2006

Summary of content (995 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.28 and all subsequent G-series RVUs and H06.05 and all subsequent H-series RVUs until otherwise indicated by its replacement publication.
PAGE 2
Document History Part Number Product Version Published 527187-003 527187-004 527187-005 527187-006 527187-007 N/A N/A N/A N/A N/A July 2005 September 2005 February 2006 February 2006 July 2006 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 catgets . . . 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 . .
PAGE 5
Contents erfc . . . . . exit . . . . . exp . . . . . expm1 . . . . fabs . . . . . fclose . . . . fcvt . . . . . fdopen . . . . feof . . . . . ferror . . . . fflush . . . . ffs . . . . . fgetc . . . . fgetpos . . . . fgetpos64 . . . fgets . . . . fgetwc . . . . fgetws . . . . fileno . . . . finite . . . . floor . . . . fmod . . . . fmtmsg . . . . fnmatch . . . fopen . . . . fopen64 . . . fopen64_guardian fopen64_oss . . fopen64_std_file . fopen_guardian . fopen_oss . . . fopen_std_file . . fpathconf . . .
PAGE 6
OSS Library Calls Reference Manual fsetpos64 ftell . . ftello . ftello64 ftime . ftok . . ftw . . ftw64 . fwrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-133 2-134 2-136 2-138 2-140 2-141 2-144 2-148 2-152 Section 3.
PAGE 7
Contents getw . . . . . getwc . . . . . getwchar . . . . getwd . . . . . getws . . . . . gfileno . . . . . glob . . . . . globfree . . . . gmtime . . . . . hcreate . . . . . hdestroy . . . . heap_check . . . heap_check_always . heap_min_block_size hsearch . . . . . htonl . . . . . htons . . . . . hypot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 8
OSS Library Calls Reference Manual iswctype . . . . iswdigit . . . . iswgraph . . . . iswlower . . . . iswprint . . . . iswpunct . . . . iswspace . . . . iswupper . . . . iswxdigit . . . . isxdigit . . . . . j0 . . . . . . j1 . . . . . . jn . . . . . . jrand48 . . . . . l64a . . . . . . labs . . . . . . lcong48 . . . . ldexp . . . . . ldiv . . . . . . lfind . . . . . lgamma . . . . lldiv . . . . . localeconv . . . . localtime . . . . log10 . . . . . log1p . . . . . log . . . . . . logb . . . . . longjmp . .
PAGE 9
Contents _min . mkfifo . mkstemp mktemp mktime . modf . mrand48 . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 5. OSS Library Calls (n - r) nextafter . . . . nftw . . . . . nftw64 . . . . . nlist . . . . . . nl_langinfo . . . nrand48 . . . . ntohl . . . . . ntohs . . . . . opendir . . . . . openlog . . . . pathconf . . . . pause . . . . . pclose . . . . . perror . . . . . popen . . . . . pow . . . . . . printf . . . . . putc . . . . . . putchar . . . . . putenv . . . . . puts . . . . .
PAGE 10
OSS Library Calls Reference Manual rewind . rewinddir rindex . rint . . . . . . . . . . . . . . Section 6. OSS Library Calls (s) scalb . . . . scandir . . . . scandir64 . . . scanf . . . . seed48 . . . . seekdir . . . . setbuf . . . . setgrent . . . sethostent . . . setjmp . . . . setkey . . . . setlocale . . . setlocale_from_msg setlogmask . . setnetent . . . setprotoent . . setpwent . . . setservent . . . setstate . . . . setvbuf . . . . sigaddset . . . sigdelset . . . sigemptyset . . sigfillset . . .
PAGE 11
Contents strftime . strlen . . strncasecmp strncat . . strncmp . strncpy . . strpbrk . . strptime . strrchr . . strspn . . strstr . . strtod . . strtok . . strtol . . strtoll . . strtoul . . strtoull . . strxfrm . . swab . . sysconf . . syslog . . system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 7. OSS Library Calls (t - v) tan . . . . . . tanh . . . . . . tcdrain . . . . . tcflow . . . . . tcflush . .
PAGE 12
OSS Library Calls Reference Manual towlower towupper tsearch . ttyname twalk . tzset . ungetc . ungetwc unordered usleep . va_arg . va_end . valloc . va_start vfprintf . vprintf . vsnprintf vsprintf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 13
Contents y1 yn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-59 8-60 Section 9. Miscellaneous stderr . . . stdin . . . stdout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1 9-2 9-3 9-4 Permuted Index Index . 527187-007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 14
OSS Library Calls Reference Manual LIST OF TABLES Table 2−1. Values of File-Related Constants for Open Files Table 5−1. Values of File-Related Constants . . . . . . . . . . 2-75 . . . . . . . . . . . . 5-29 Table 6−1. Default Values for Monetary Formatting . . . . . . . . . . . . . 6-93 Table 6−2. Example Output from strfmon() Function . . . . . . . . . . . . . 6-93 . . . . . . . . . . . . . 6-139 xiv . . . . Table 6−3.
PAGE 15
What is New in This Manual This section describes changes made to the Open System Services Library Calls Reference Manual since February 2006 (527187-006). This manual contains information about some of the following G-series development tools. For servers running H-series RVUs, these tools are supported only in H06.
PAGE 16
OSS Library Calls Reference Manual fopen64_oss(3) fopen64_std_file(3) freopen64(3) freopen64_guardian(3) freopen64_oss(3) fseeko(3) fseeko64(3) fsetpos64(3) ftello(3) ftello64(3) ftw64(3) nftw64(3) readdir64(3) scandir64(3) tmpfile64(3) tmpfile64_guardian(3) tmpfile64_oss(3) This function was also added for the H06.06 and G06.29 RVUs: scandir(3) This new function was added to support OSS access control lists (ACLs), which are supported for G06.
PAGE 17
What is New in This Manual freopen_oss(3) ftw(3) fwrite(3) fscanf(3) fseek(3) fsetpos(3) ftell(3) getc(3) getchar(3) gets(3) getw(3) getwc(3) getwchar(3) getws(3) nftw(3) printf(3) putc(3) putchar(3) puts(3) putw(3) putwchar(3) putws(3) scandir(3) scanf(3) tmpfile_guardian(3) tmpfile_oss(3) vfprintf(3) vprintf(3) The descriptions of these functions have changed to support OSS ACLs: fopen_oss(3) fopen64_oss(3) freopen_oss(3) freopen64_oss(3) mkfifo(3) opendir(3) The descriptions of these functions have chang
PAGE 18
OSS Library Calls Reference Manual xviii Hewlett-Packard Company 527187-007
PAGE 19
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 20
OSS Library Calls Reference Manual Audience This manual is for system and application programmers who want to use the OSS API provided with the NonStop operating system. The manual assumes that the reader is a programmer and is familiar with the C programming language. Purpose This manual provides a complete reference to all OSS library function calls and their related files and miscellaneous topics. Document Usage This manual contains a portion of the online reference (man) pages.
PAGE 21
About This Manual 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. EXAMPLES Compilable C language program excerpts using the function call described in the reference page.
PAGE 22
OSS Library Calls Reference 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 Migration Guide If
PAGE 23
About This Manual the correspondence between reference section numbers and OSS manuals.
PAGE 24
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 25
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 26
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 27
_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 28
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 29
aclsort(3) OSS Library Calls Reference Manual NAME aclsort - Sorts an access control list (ACL) LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library SYNOPSIS #include #include int aclsort ( int nentries, int calclass, struct acl *aclbufp ); PARAMETERS nentries Specifies the number of ACL entries in the buffer aclbufp. calclass If nonzero, specifies that the class permissions be recalculated.
PAGE 30
OSS Library Calls (a - d) aclsort(3) • If the ACL contains no entries of type DEF_USER and no entries of type DEF_GROUP, and an entry of type DEF_GROUP_OBJ is specified, an entry of type DEF_CLASS_OBJ is also specified and the two entries have the same permissions. RETURN VALUES On successful completion, the aclsort( ) function returns a 0 (zero). If the ACL contains duplicate entries, the aclsort( ) function returns the position of the first duplicate entry.
PAGE 31
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 32
OSS Library Calls (a - d) acos(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 leaves some features to the implementing vendor to define.
PAGE 33
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 34
OSS Library Calls (a - d) acosh(3) • 527187-007 When used for Tandem floating-point values, this function does not return the value NaN when an invalid parameter is passed.
PAGE 35
advance(3) OSS Library Calls Reference Manual 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 36
OSS Library Calls (a - d) advance(3) #include . . . 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 37
alarm(3) OSS Library Calls Reference Manual 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 38
OSS Library Calls (a - d) asctime(3) 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 39
asin(3) OSS Library Calls Reference Manual 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 40
OSS Library Calls (a - d) asin(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 leaves some features to the implementing vendor to define.
PAGE 41
asinh(3) OSS Library Calls Reference Manual 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 42
OSS Library Calls (a - d) assert(3) 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 43
atan2(3) OSS Library Calls Reference Manual 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 44
OSS Library Calls (a - d) atan2(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 leaves some features to the implementing vendor to define.
PAGE 45
atan(3) OSS Library Calls Reference Manual 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 46
OSS Library Calls (a - d) atan(3) • 527187-007 This function does not set errno to [ERANGE] when the result would underflow.
PAGE 47
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 48
OSS Library Calls (a - d) atanh(3) RELATED INFORMATION Functions: asin(3), asinh(3), acos(3), acosh(3), atan(3), atan2(3), 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-007 • When used for IEEE floating-point values, this function does not set errno to [EDOM] when the value of x is NaN.
PAGE 49
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 50
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 51
atof(3) OSS Library Calls Reference Manual setlocale( ) function. 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 52
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 53
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 54
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 55
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 56
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 57
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 58
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 59
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 60
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 61
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 62
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 63
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 64
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 65
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 66
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 67
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 68
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 69
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 70
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 71
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 72
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 73
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 74
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 75
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 76
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 77
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 78
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 79
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. 36 _NODELIM There is an illegal or missing delimiter.
PAGE 80
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 81
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 82
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 83
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 84
OSS Library Calls (a - d) 527187-007 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 85
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 86
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 87
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 88
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 89
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 90
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 91
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 92
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 93
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 94
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 95
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−72 The errno values [EINVAL], [ENOMEM], and [ENOPERM] can be returned.
PAGE 96
OSS Library Calls (a - d) dbm_close(3) NAME dbm_close - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 97
dbm_delete(3) OSS Library Calls Reference Manual NAME dbm_delete - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 98
OSS Library Calls (a - d) dbm_error(3) NAME dbm_error - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 99
dbm_fetch(3) OSS Library Calls Reference Manual NAME dbm_fetch - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 100
OSS Library Calls (a - d) dbm_firstkey(3) NAME dbm_firstkey - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 101
dbm_nextkey(3) OSS Library Calls Reference Manual NAME dbm_nextkey - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 102
OSS Library Calls (a - d) dbm_open(3) NAME dbm_open - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 103
dbm_store(3) OSS Library Calls Reference Manual NAME dbm_store - Manipulates a database DESCRIPTION See dbm_clearerr(3).
PAGE 104
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 105
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 106
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 107
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 108
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 109
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 110
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 111
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 112
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 113
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 114
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 115
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 116
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 117
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 118
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 119
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 120
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 121
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 122
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 123
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 124
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 125
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 126
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 127
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 128
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 129
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 130
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 131
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 132
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 133
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 134
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 135
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 136
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 137
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 138
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 139
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 140
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 141
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 142
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 143
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 144
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 145
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 146
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 147
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), fopen64(3), setbuf(3).
PAGE 148
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 149
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 150
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 151
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 152
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 153
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 154
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 155
fflush(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: close(2), exit(2), fclose(3), fopen(3), fopen64(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 156
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 157
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 158
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 159
fgetpos(3) OSS Library Calls Reference Manual NAME fgetpos - 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 fgetpos( FILE *stream, fpos_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 160
OSS Library Calls (e - f) fgetpos64(3) NAME fgetpos64 - 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 fgetpos64( FILE *stream, fpos64_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 161
fgetpos64(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fgetpos(3), fgetpos64(3), fopen(3), fopen64(3), fseek(3), fseeko(3), fseeko64(3), fsetpos(3), fsetpos64(3), ftell(3), ftello(3), ftello64(3), rewind(3). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 version 2 specification.
PAGE 162
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 163
fgets(3) OSS Library Calls Reference Manual 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, for information about the cause of that error, see to the read(2) reference page.
PAGE 164
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 165
fgetwc(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fopen(3), fread(3), getc(3), gets(3), getwc(3), getwchar(3), putwc(3), scanf(3).
PAGE 166
OSS Library Calls (e - f) fgetws(3) 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 167
fileno(3) OSS Library Calls Reference Manual 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 168
OSS Library Calls (e - f) finite(3) 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 169
floor(3) OSS Library Calls Reference Manual 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 170
OSS Library Calls (e - f) fmod(3) 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 171
fmod(3) OSS Library Calls Reference Manual 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 172
OSS Library Calls (e - f) fmtmsg(3) 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 173
fmtmsg(3) OSS Library Calls Reference Manual 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 174
OSS Library Calls (e - f) fmtmsg(3) 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 175
fnmatch(3) OSS Library Calls Reference Manual 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 176
OSS Library Calls (e - f) fnmatch(3) 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. NOTES If you use this function on the local / (slash) root directory, the action includes the /G and /E directories.
PAGE 177
fopen(3) OSS Library Calls Reference Manual 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 178
OSS Library Calls (e - f) fopen64(3) NAME fopen64 - 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 fopen64( ) function: fopen64_oss( ) and fopen64_guardian( ).
PAGE 179
fopen64_guardian(3) OSS Library Calls Reference Manual NAME fopen64_guardian - Opens a stream (Guardian fopen64( ) 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 180
OSS Library Calls (e - f) fopen64_guardian(3) a Create a text file (or open an existing text file) and open it for append (write at the end of the file) access. r+ Open an existing text file for update access (reading and writing). w+ Create a text file (or truncate an existing text file to length zero) and open it for update access. a+ Create a text file (or open an existing text file) and open it for update access with writing at the end of the file.
PAGE 181
fopen64_guardian(3) OSS Library Calls Reference Manual The default number of secondary extents for files created by fopen64( ) is 16. The default number of maxextents for files created by fopen64( ) is 500. Interoperability Variants The C run-time library supports two variants of the fopen64( ) function: fopen64_oss( ) and fopen64_guardian( ). The variants support the unique file-naming conventions and structures of the OSS and Guardian file systems, respectively.
PAGE 182
OSS Library Calls (e - f) fopen64_oss(3) NAME fopen64_oss - Opens a stream (OSS fopen64( ) 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 183
fopen64_oss(3) OSS Library Calls Reference Manual r Open an existing file for read-only access. w Create a file (or truncate an existing file to length zero) and open it for write-only access. a Create a file (or open an existing file) and open it for append (write at the end of the file) access. r+ Open an existing file for update access (reading and writing). w+ Create a file (or truncate an existing file to length zero) and open it for update access.
PAGE 184
OSS Library Calls (e - f) fopen64_oss(3) fopen64_guardian( ) is functionally identical to the fopen64( ) function of the Guardian environment. It is the same as setting systype guardian at compile time. systype guardian is the default setting for the C and C++ compilers in the Guardian environment. To use the fopen64_oss( ) or fopen64_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro. RETURN VALUES If the fopen64( ) function succeeds, a pointer to the stream is returned.
PAGE 185
fopen64_oss(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: open(2), fclose(3), fopen(3), fopen64(3), fopen64_guardian(3), fopen_oss(3), freopen(3), fseek(3), setbuf(3). | Miscellaneous topics: acl(5). | STANDARDS CONFORMANCE The fopen64_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 186
OSS Library Calls (e - f) fopen64_std_file(3) NAME fopen64_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 187
fopen64_std_file(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The fopen64_std_file( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 188
OSS Library Calls (e - f) fopen_guardian(3) 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 189
fopen_guardian(3) OSS Library Calls Reference Manual 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 190
OSS Library Calls (e - f) fopen_guardian(3) 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 191
fopen_oss(3) OSS Library Calls Reference Manual 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 192
OSS Library Calls (e - f) fopen_oss(3) w+ Create a file (or truncate an existing file to length zero) and open it for update access. a+ Create a file (or open an existing file) and open it for update access with writing at the end of the file. The OSS version of fopen does not distinguish between text and binary files. Text and binary files are type 180. Specifying a value of mode that consists of an r, w, or a followed by a b indicates a binary file.
PAGE 193
fopen_oss(3) OSS Library Calls Reference Manual RETURN VALUES If the fopen( ) function succeeds, a pointer to the stream is returned. If the fopen( ) function fails, a null pointer is returned, and errno is set to indicate the error. ERRORS If any of these conditions occurs, the fopen( ) function sets errno to the corresponding value.
PAGE 194
OSS Library Calls (e - f) fopen_oss(3) STANDARDS CONFORMANCE The fopen_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 195
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 196
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 197
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 198
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 199
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 200
OSS Library Calls (e - f) fpathconf(3) The following are HP extensions to the XPG4 Version 2 specification: • 527187-007 The errno values [EFSBAD], [EIO], [EISGUARDIAN], [ENETDOWN], [ENOROOT], [ENXIO], and [EWRONGID] can be returned by the fpathconf( ) function.
PAGE 201
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 202
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 203
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 204
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 205
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 206
OSS Library Calls (e - f) 527187-007 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 207
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 208
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 209
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 210
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. [EFBIG] An attempt was made to write at or beyond the file offset maximum.
PAGE 211
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 212
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 213
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 214
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 215
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 216
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 217
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 218
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 219
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 220
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 221
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 222
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 223
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 224
OSS Library Calls (e - f) freopen64(3) NAME freopen64 - 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 freopen64( ) function: freopen64_oss( ) and freopen64_guardian( ).
PAGE 225
freopen64_guardian(3) OSS Library Calls Reference Manual NAME freopen64_guardian - Opens a stream (Guardian freopen64( ) 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 226
OSS Library Calls (e - f) freopen64_guardian(3) r Opens a text file for reading. w Creates a new text file for writing, or opens and truncates a text file to zero length. a Appends (opens a text file for writing at the end of the file, or creates a text file for writing). 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).
PAGE 227
freopen64_guardian(3) OSS Library Calls Reference Manual Interoperability Variants The C run-time library supports two variants of the freopen64( ) function: freopen64_oss( ) and freopen64_guardian( ). The variants support the unique file-naming conventions and structures of the OSS and Guardian file systems, respectively. Explicit calls to the freopen64_oss( ) and freopen64_guardian( ) variants in source code are only made when the behavior of one environment is desired from the other environment.
PAGE 228
OSS Library Calls (e - f) freopen64_oss(3) NAME freopen64_oss - Opens a stream (OSS freopen64( ) 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 229
freopen64_oss(3) OSS Library Calls Reference Manual The original stream is closed regardless of whether the open64( ) function succeeds with the named file. The freopen64( ) function returns a pointer to the FILE structure associated with the stream parameter. The freopen64( ) function is typically used to attach the preopened streams associated with stdin, stdout, and stderr to other files. The mode parameter controls the access allowed to the stream.
PAGE 230
OSS Library Calls (e - f) freopen64_oss(3) freopen64_guardian( ) is functionally identical to the freopen64( ) function of the Guardian environment. It is the same as setting systype guardian at compile time. systype guardian is the default setting for the C and C++ compilers in the Guardian environment. To use the freopen64_oss( ) or freopen64_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro.
PAGE 231
freopen64_oss(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The freopen64_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 232
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 233
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 234
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 235
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 236
OSS Library Calls (e - f) freopen_oss(3) r Opens the file for reading. w Creates a new file for writing, or opens and truncates a file to zero length. a Appends (opens a file for writing at the end of the file, or creates a file for writing). r+ Opens a file for update (reading and writing). 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).
PAGE 237
freopen_oss(3) OSS Library Calls Reference Manual RETURN VALUES If the freopen( ) function fails, a null pointer is returned, and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the freopen( ) function sets errno to the value that corresponds to the condition.
PAGE 238
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 239
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 240
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 241
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 242
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 243
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 244
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 245
fscanf(3) OSS Library Calls Reference Manual [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. | 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 246
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 247
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 248
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 249
fseeko(3) OSS Library Calls Reference Manual NAME fseeko - 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 fseeko( FILE ∗ stream, off_t offset, int whence); PARAMETERS stream Specifies the I/O stream.
PAGE 250
OSS Library Calls (e - f) fseeko(3) reflect the location specified by the fseeko( ) function. The fseeko( ) function allows the file-position indicator to be set beyond the end of existing data in the file. If data is later written at this point, subsequent reads of data in the gap will return bytes with the value 0 (zero) until data is actually written into the gap. The fseeko( ) function does not, by itself, extend the size of a file.
PAGE 251
fseeko(3) OSS Library Calls Reference Manual [EINVAL] The whence parameter is an invalid value, or the resulting file offset is invalid. [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] No free space was remaining on the device containing the file.
PAGE 252
OSS Library Calls (e - f) fseeko64(3) NAME fseeko64 - 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 fseeko64( FILE ∗ stream, off64_t offset, int whence); PARAMETERS stream Specifies the I/O stream.
PAGE 253
fseeko64(3) OSS Library Calls Reference Manual If the most recent operation (ignoring any ftell( ) operations) on a given stream was fflush( ), then the fseeko64( ) function causes the file offset in the underlying open file descriptor to be adjusted to reflect the location specified by the fseeko64( ) function. The fseeko64( ) function allows the file-position indicator to be set beyond the end of existing data in the file.
PAGE 254
OSS Library Calls (e - f) fseeko64(3) [EINTR] A signal terminated the write operation, and either none, some, or all the data was transferred. If there is buffered I/O, call the fflush( ) function before the fseeko64( ) function to guarantee that the buffer characters are written. [EINVAL] The whence parameter is an invalid value, or the resulting file offset would be invalid.
PAGE 255
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 256
OSS Library Calls (e - f) fsetpos64(3) NAME fsetpos64 - 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 fsetpos64( FILE *stream, const fpos64_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 257
ftell(3) OSS Library Calls Reference Manual 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 258
OSS Library Calls (e - f) ftell(3) 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. [EOVERFLOW] The value of the file position cannot be represented in an object of type long. [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 259
ftello(3) OSS Library Calls Reference Manual NAME ftello - Reports the position of 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 off_t ftello( FILE ∗ stream); PARAMETERS stream Specifies the I/O stream.
PAGE 260
OSS Library Calls (e - f) ftello(3) RETURN VALUES Upon successful completion, the ftello( ) function returns the offset of the current byte relative to the beginning of the file associated with the named stream. Otherwise, a value of -1 is returned, and errno is set to indicate the error. ERRORS If these conditions occurs, the ftello( ) function sets errno to the corresponding value: [EBADF] The file descriptor underlying the stream parameter is not a valid file descriptor.
PAGE 261
ftello64(3) OSS Library Calls Reference Manual NAME ftello64 - Reports the position of 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 off64_t ftello64( FILE ∗ stream); PARAMETERS stream Specifies the I/O stream.
PAGE 262
OSS Library Calls (e - f) ftello64(3) RETURN VALUES Upon successful completion, the ftello64( ) function returns the offset of the current byte relative to the beginning of the file associated with the named stream. Otherwise, a value of -1 is returned, and errno is set to indicate the error. ERRORS If these conditions occurs, the ftello64( ) function sets errno to the corresponding value: [EBADF] The file descriptor underlying the stream parameter is not a valid file descriptor.
PAGE 263
ftime(3) OSS Library Calls Reference Manual 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 264
OSS Library Calls (e - f) ftok(3) 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 265
ftok(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. 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 266
OSS Library Calls (e - f) ftok(3) • 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. [ENOTSUP] The path_name parameter refers to a file on a logical disk volume administered through the Storage Management Foundation (SMF). [ENXIO] The caller’s current working directory or the root directory is not mounted.
PAGE 267
ftw(3) OSS Library Calls Reference Manual 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 268
OSS Library Calls (e - f) ftw(3) 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 269
ftw(3) OSS Library Calls Reference Manual • 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. • If ftw( ) detects an error other than that for FTW_DNR or FTW_NS (that is, other than [EACCES]), the value -1 is returned and errno is set to indicate the error.
PAGE 270
OSS Library Calls (e - f) ftw(3) [ENOTDIR] A component of the path parameter is not a directory. [ENOTSUP] The path parameter refers to a file on a logical disk volume administered through the Storage Management Foundation (SMF). [ENXIO] The fileset containing the client’s current working directory or root directory is not mounted. | [EOVERFLOW] The file size (in bytes) or the file inode number (serial number) cannot be represented correctly in the structure pointed to by the ptr parameter.
PAGE 271
ftw64(3) OSS Library Calls Reference Manual NAME ftw64 - 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 ftw64( const char *path, int(*function)(const char *object, const struct stat64 *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 272
OSS Library Calls (e - f) ftw64(3) FTW_F Regular file FTW_NS A file for which the stat64( ) function could not be executed successfully FTW_SL Symbolic link If flag is FTW_DNR, the files and subdirectories contained in that directory are not processed. If flag is FTW_NS, the stat64 structure contents are meaningless. An example of a file that causes FTW_NS to be passed to the function parameter is a file in a directory for which you have read permission but not execute (search) permission.
PAGE 273
ftw64(3) OSS Library Calls Reference Manual You can use the UTILSGE environment variable that governs shell utility to test or recommend whether use should include Guardian files or files on remote HP NonStop server nodes. UTILSGE settings are only advisory for functions; changing the variable value does not affect function behavior. For more information about UTILSGE, see the environ(5) reference page.
PAGE 274
OSS Library Calls (e - f) ftw64(3) [ENOMEM] The system has insufficient resources. [ENOROOT] 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.
PAGE 275
fwrite(3) OSS Library Calls Reference Manual 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 276
OSS Library Calls (e - f) fwrite(3) [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 277
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 278
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 279
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 280
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 281
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 282
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 283
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 284
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 285
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 286
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 287
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 288
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 289
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 290
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 291
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 292
getc(3) OSS Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. | 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.
PAGE 293
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 294
getchar(3) OSS Library Calls Reference Manual cause of that error. 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 295
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 296
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 297
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 298
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 299
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 300
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 301
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 302
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 303
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 304
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 305
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 306
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 307
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 308
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 309
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 310
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 311
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 312
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 313
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 int 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 314
gethostbyname(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: gethostbyaddr(3), endhostent(3). Files: hosts(4).
PAGE 315
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 316
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 317
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 318
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 319
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 320
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 321
OSS Library Calls (g - h) getipnodebyname(3) STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
PAGE 322
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 323
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 324
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 325
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 326
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 327
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 328
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 329
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 330
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 331
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 332
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 333
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 334
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 335
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 336
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 337
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 338
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 339
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 340
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 341
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 342
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 343
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 344
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 345
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 346
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 347
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 348
gets(3) OSS Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. | 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.
PAGE 349
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 350
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 351
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 352
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 353
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 354
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 355
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 356
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 357
OSS Library Calls (g - h) getw(3) [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. | 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 358
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 359
OSS Library Calls (g - h) getwc(3) RELATED INFORMATION Functions: fgetwc(3), fopen(3), fread(3), getc(3), gets(3), getwchar(3), putwc(3), scanf(3).
PAGE 360
getwchar(3) OSS Library Calls Reference Manual 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 361
OSS Library Calls (g - h) getwd(3) 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 362
getws(3) OSS Library Calls Reference Manual 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 363
OSS Library Calls (g - h) gfileno(3) 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 364
glob(3) OSS Library Calls Reference Manual 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 365
OSS Library Calls (g - h) glob(3) 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 366
glob(3) OSS Library Calls Reference Manual • 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 367
OSS Library Calls (g - h) glob(3) 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 368
glob(3) OSS Library Calls Reference Manual GLOB_NOMATCH Indicates that the value specified for the pattern parameter did not match any existing pathname and the GLOB_NOCHECK flag was not set in the flags parameter. 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].
PAGE 369
OSS Library Calls (g - h) globfree(3) 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 370
gmtime(3) OSS Library Calls Reference Manual 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
PAGE 371
OSS Library Calls (g - h) hcreate(3) 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 372
hdestroy(3) OSS Library Calls Reference Manual 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 373
OSS Library Calls (g - h) heap_check(3) 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 374
heap_check_always(3) OSS Library Calls Reference Manual 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 375
OSS Library Calls (g - h) heap_min_block_size(3) 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 376
hsearch(3) OSS Library Calls Reference Manual 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 377
OSS Library Calls (g - h) [ESRCH] hsearch(3) The search failed. RELATED INFORMATION Functions: bsearch(3), hcreate(3), hdestroy(3), lsearch(3), tsearch(3), qsort(3).
PAGE 378
htonl(3) OSS Library Calls Reference Manual 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 379
OSS Library Calls (g - h) htons(3) 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 380
hypot(3) OSS Library Calls Reference Manual 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 381
OSS Library Calls (g - h) hypot(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-007 • 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 382
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 383
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 384
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 385
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 386
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 387
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 388
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 389
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 390
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 391
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 392
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 393
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 394
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 395
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 396
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 397
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 398
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 399
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 400
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 401
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 402
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 403
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 404
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 405
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 406
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 407
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 408
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 409
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 410
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 411
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 412
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 413
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 414
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 415
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 416
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 417
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 418
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 419
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 420
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 421
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 422
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 423
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 424
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 425
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 426
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 427
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 428
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 429
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 430
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 431
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 432
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 433
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 434
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 435
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 436
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 437
j0(3) OSS Library Calls Reference Manual • 4−56 errno is not set to [ERANGE] when underflow occurs.
PAGE 438
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 439
j1(3) OSS Library Calls Reference Manual • 4−58 errno is not set to [ERANGE] when underflow occurs.
PAGE 440
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 441
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 442
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 443
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 444
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 445
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 446
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 447
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 448
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 449
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 450
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 451
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 452
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 453
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 454
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 455
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 456
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 457
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 458
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 459
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 460
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-007 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 461
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 462
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 463
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 464
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 465
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 466
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 467
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 468
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 469
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 470
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 471
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 472
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 473
lsearch(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: bsearch(3), hsearch(3), find(3), tsearch(3), qsort(3).
PAGE 474
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 475
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 476
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 477
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 478
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 479
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 480
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 481
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 482
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 483
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 484
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 485
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 486
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 487
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 488
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 489
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 490
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 491
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 492
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 493
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 494
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 495
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 496
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 497
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 498
OSS Library Calls (i - m) mblen(3) RELATED INFORMATION Functions: mbtowc(3), wctomb(3), mbstowcs(3), wcstombs(3).
PAGE 499
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 500
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 501
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 502
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 503
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 504
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 505
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 506
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 507
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 508
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 509
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 510
OSS Library Calls (i - m) mkfifo(3) For more information about ACLs, see the acl(5) reference page. | Use on Guardian Objects Attempting to create a FIFO within the Guardian file system (that is, within G) fails with errno set to [EINVAL].
PAGE 511
mkfifo(3) OSS Library Calls Reference Manual [ENOENT] [ENOROOT] One of the following conditions exists: • A component of the pathname prefix does not exist. • The path parameter points to an empty string. • 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.
PAGE 512
OSS Library Calls (i - m) 527187-007 mkfifo(3) Hewlett-Packard Company 4−131
PAGE 513
mkstemp(3) OSS Library Calls Reference Manual 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 514
OSS Library Calls (i - m) mktemp(3) NAME mktemp - Makes a unique filename DESCRIPTION See mkstemp(3).
PAGE 515
mktime(3) OSS Library Calls Reference Manual 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 516
OSS Library Calls (i - m) mktime(3) 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 517
modf(3) OSS Library Calls Reference Manual 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 518
OSS Library Calls (i - m) 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 leaves some features to the implementing vendor to define.
PAGE 519
mrand48(3) OSS Library Calls Reference Manual 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 520
OSS Library Calls (i - m) mrand48(3) 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 521
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 522
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 523
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 524
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 525
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 526
nftw(3) OSS Library Calls Reference Manual Use From the Guardian Environment The nftw( ) 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 527
OSS Library Calls (n - r) nftw(3) [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 528
nftw(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The nftw( ) function does not return the error values [EMFILE] or [ENFILE]. The following are HP extensions to the XPG4 Version 2 specification: • 5−8 The error values [EFSBAD], [ENOMEM], [ENOROOT], [ENOTSUP], and [ENXIO] can be returned.
PAGE 529
OSS Library Calls (n - r) nftw64(3) NAME nftw64 - 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 nftw64( const char *path, int(*function) (const char *object, const struct stat64 *ptr, int flag, struct FTW *sftw), int depth, int flags); PARAMETERS path Points to the directory hierarchy to be searched.
PAGE 530
nftw64(3) OSS Library Calls Reference Manual DESCRIPTION The nftw64( ) function is similar to the nftw( ) function except that, in addition to supporting smaller files, the nftw64( ) function supports OSS files larger than approximately 2 gigabytes. An application can explicitly call this function when you compile the application using the #define _LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command option.
PAGE 531
OSS Library Calls (n - r) nftw64(3) The nftw64( ) function traverses symbolic links encountered in the resolution of path, including the final component. Symbolic links encountered while traversing the directory tree rooted at path are not traversed. 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.
PAGE 532
nftw64(3) OSS Library Calls Reference Manual ERRORS If any of these conditions occurs, the nftw64( ) function sets errno to the corresponding value: [EACCES] One of the following statements is true: • Search permission is denied for any component of the path parameter. • Read permission is denied for the path parameter. • The function specified by the function parameter returns -1 and does not reset the value of errno.
PAGE 533
OSS Library Calls (n - r) nftw64(3) RELATED INFORMATION Functions: ftw64(3), longjmp(3), malloc(3), stat64(2). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
PAGE 534
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 535
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 536
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 537
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 538
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 539
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 540
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 541
OSS Library Calls (n - r) opendir(3) any directory. 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.
PAGE 542
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 543
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 544
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 545
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 546
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 547
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 548
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 549
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 550
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 551
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 552
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 553
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 554
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−34 The error [EBADF] can be returned.
PAGE 555
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 556
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 557
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 558
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 559
OSS Library Calls (n - r) 527187-007 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 560
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 561
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 562
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 563
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 564
printf(3) 5−44 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 565
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 566
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 567
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 568
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 569
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 570
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. [EFBIG] An attempt was made to write at or beyond the file offset maximum.
PAGE 571
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 572
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 573
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 574
puts(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 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. RELATED INFORMATION Functions: fputs(3), gets(3), getws(3), printf(3), putc(3), putwc(3), putws(3).
PAGE 575
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 576
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 at or beyond the file offset maximum. [EINTR] The write operation was interrupted by a signal that was caught, and no data was transferred.
PAGE 577
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 578
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 579
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 580
putwchar(3) [EILSEQ] OSS Library Calls Reference Manual 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 581
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 582
putws(3) [EPIPE] OSS Library Calls Reference Manual 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 583
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 584
qsort(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: bsearch(3), tsearch(3).
PAGE 585
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 586
raise(3) OSS Library Calls Reference Manual STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 5−66 The raise( ) function can return the errno value [ENOTOSS].
PAGE 587
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 588
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 589
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 590
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 before 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 before the first call to the readdir( ) function, the readdir( ) function returns entries for these files.
PAGE 591
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 592
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. [EOVERFLOW] The inode number (serial number) is greater than 2 gigabytes minus 1 byte.
PAGE 593
OSS Library Calls (n - r) readdir(3) The following are HP extensions to the XPG4 Version 2 specification: | | • The error values [EFAULT], [EINVAL], [EIO], [ENOENT], [ENOMEM], [ENETDOWN], [ENOROOT], [ENXIO], and [EWRONGID] can be returned.
PAGE 594
readdir64(3) OSS Library Calls Reference Manual | | NAME readdir64 - 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 dirent64 *readdir64( DIR *dir_pointer); | | | PARAMETERS dir_pointer || Points to the dir structure of an open directory.
PAGE 595
OSS Library Calls (n - r) readdir64(3) | • The caller might receive a SIGSEGV or SIGILL signal in the OSS environment. || | | • The caller might cause a trap condition in the Guardian environment. || | | • User memory might be corrupted. || | General Considerations for Directory Operations Directory entries represent files. Files can be removed from a directory or added to a directory asynchronously to the operation of the readdir64( ) function.
PAGE 596
readdir64(3) OSS Library Calls Reference Manual Use on Objects in /E For objects in /E that reside on remote HP NonStop server nodes, the d_ino field of the dirent64 structure contains the Expand node number of the remote HP NonStop server node containing the object. The d_ino value for objects in /E that reside on the local node is the pseudo Expand node number 255. | | | | | The following example shows how to search a directory for the entry name: | | len = strlen(name); dir_pointer = opendir(".
PAGE 597
OSS Library Calls (n - r) readdir64(3) [ENET- | DOWN] The dir_pointer parameter specifies a directory on a remote HP NonStop server node, but communication with the remote node has been lost. | | An invalid position value was used in the previous call to the seekdir( ) function. | The system has insufficient resources to complete the request. | The root fileset (fileset 0) is not in the STARTED state.
PAGE 598
realloc(3) OSS Library Calls Reference Manual | | 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 #include #include | | | void ∗ realloc( void ∗ pointer, size_t size); | | | SYNOPSIS | PARAMETERS size || Specifies the number of bytes of memory.
PAGE 599
OSS Library Calls (n - r) realpath(3) | | NAME realpath - Resolves pathname | | | LIBRARY G-series native OSS processes: /G/system/sysnn/zosshsrl H-series OSS processes: /G/system/zdllnnn/zosshdll #include | | char *realpath( const char *file_name, char *resolved_name); | | | SYNOPSIS | PARAMETERS file_name || Is a pointer to a pathname that is to be converted to an absolute pathname. | Is a pointer to a buffer where the resolved pathname can be stored.
PAGE 600
realpath(3) OSS Library Calls Reference Manual produced an intermediate result whose length exceeds PATH_MAX. | A component of the pathname pointed to by the file_name parameter names a nonexistent file, or the file_name parameter points to an empty string. | | [ENOENT] || [ENOT- | DIR] A component of the derived absolute pathname was not a directory. | Insufficient storage space was available. | [ENOMEM] || | | RELATED INFORMATION Functions: getwd(3), getcwd(3), sysconf(3).
PAGE 601
OSS Library Calls (n - r) re_comp(3) | | 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 #include
PAGE 602
re_comp(3) OSS Library Calls Reference Manual • Any character used to delimit a regular expression string is special for that regular expression string. | || | | | 3. A period (.) is a one-character regular expression string that matches any one single char- | acter except newline. | || | 4. A set of square brackets containing a non-empty string of characters is a one-character regular expression string that matches any one character found within the brackets.
PAGE 603
OSS Library Calls (n - r) re_comp(3) | 5. A regular expression string enclosed with $ and $ is a regular expression string that matches whatever the enclosed regular expression string matches. || | | | 6. The expression \n matches the same character string matched by an expression enclosed within $ and $ earlier in the same regular expression string. In particular, the earlier string is that beginning with the nth occurrence of \( counting from the left.
PAGE 604
re_comp(3) OSS Library Calls Reference Manual | | RELATED INFORMATION Functions: re_exec(3), regcmp(3), regexec(3). | | STANDARDS CONFORMANCE The re_comp( ) function is defined in the XPG4 Version 2 specification.
PAGE 605
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 #include
PAGE 606
re_exec(3) OSS Library Calls Reference Manual • Any character used to delimit a regular expression string is special for that regular expression string. | || | | | 3. A period (.) is a one-character regular expression string that matches any one single char- | acter except newline. | || | 4. A set of square brackets containing a non-empty string of characters is a one-character regular expression string that matches any one character found within the brackets.
PAGE 607
OSS Library Calls (n - r) re_exec(3) | 5. A regular expression string enclosed with $ and $ is a regular expression string that matches whatever the enclosed regular expression string matches. || | | | 6. The expression \n matches the same character string matched by an expression enclosed within $ and $ earlier in the same regular expression string. In particular, the earlier string is that beginning with the nth occurrence of \( counting from the left.
PAGE 608
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 #include | | char *regcmp(const char *string1, ... /*, (char *)0 */); | | SYNOPSIS | PARAMETERS string1, ...
PAGE 609
OSS Library Calls (n - r) regcmp(3) expressions are allowed. | Groups a regular expression. A regular expression in parentheses can be followed by an operator like *, +, or {}. These operators have the same effect on a group regular expression as they do on a single character. | | | All of these regular expression symbols are special characters. To use them as themselves, you must escape them by preceding them with a backslash.
PAGE 610
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 #include #include
PAGE 611
OSS Library Calls (n - r) regcomp(3) pat- | tern Contains the basic or extended regular expression to be compiled by regcomp( ). | The default regular expression type for the pattern parameter is a basic regular expression. An application can specify extended regular expressions with the REG_EXTENDED flag.
PAGE 612
regcomp(3) OSS Library Calls Reference Manual The regcomp( ), regerror( ), regexec( ), and regfree( ) functions perform regular expression matching. The regcomp( ) function compiles a regular expression and the regexec( ) function compares the compiled regular expression to a string. The regerror( ) function returns text associated with an error condition encountered by regcomp( ) or regexec( ). The regfree( ) function frees the internal storage allocated for the compiled regular expression.
PAGE 613
OSS Library Calls (n - r) regcomp(3) • If a subexpression matched a zero-length string, the offsets in the pmatch parameter refer to the byte immediately following the matching string. | || | | If the REG_NOSUB flag was set in the cflags parameter in the call to the regcomp( ) function, and the nmatch parameter is not equal to 0 (zero) in the call to the regexec function, the content of the pmatch array is unspecified.
PAGE 614
regcomp(3) OSS Library Calls Reference Manual char char | | patt[SLENGTH], strng[SLENGTH]; *eol; (void)setlocale(LC_ALL, ""); | printf("Enter a regular expression:"); fgets(patt, SLENGTH, stdin); if ((eol = strchr(patt, ’\n’)) != NULL) *eol = ’\0’; /* Replace newline with null */ else return; /* Line entered too long */ printf("Enter string to compare\nString: "); fgets(strng, SLENGTH, stdin); if ((eol = strchr(strng, ’\n’)) != NULL) *eol = ’\0’; /* Replace newline with null */ else return; /* Line e
PAGE 615
OSS Library Calls (n - r) regcomp(3) | | | | | | | | | regexec(&preg, start_search, 1, &pmatch, REG_NOTBOL); start_search = start_search + pmatch.rm_eo; count++; }; count--; printf("There are %i matches\n", count); regfree(&preg); } | 527187-007 2. The following example finds out which subexpressions in the regular expression have matches in the string. This example uses the same main( ) program as the preceding example.
PAGE 616
regcomp(3) OSS Library Calls Reference Manual } else printf("String contained a match for the entire re\n"); for (count = 0; count <= matches_tocheck; count++) { if (pmatch[count].rm_so != -1) { printf( "Subexpression %i matched in string\n", count); printf( "Match starts at %i. Byte after match is %i\n", pmatch[count].rm_so, pmatch[count].
PAGE 617
OSS Library Calls (n - r) regcomp(3) REG_EESCAPE There is a trailing \ (backslash) in the pattern. | || REG_EPAREN The use of a pair of $ (backslash left parenthesis) and $ (backslash right parenthesis) or ( ) (parentheses) is unbalanced. | | REG_ERANGE There was an unusable endpoint in the range expression. | REG_ESPACE There is insufficient memory space. | REG_ESUBREG The number in \digit is unusable or in error. | REG_NOMATCH The regexec( ) function failed to match.
PAGE 618
regerror(3) OSS Library Calls Reference Manual | | NAME regerror - Performs regular expression matching | | DESCRIPTION See regcomp(3).
PAGE 619
OSS Library Calls (n - r) regex(3) | | 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 #include | | char *regex(const char *re, const char *subject, char *se0, ...
PAGE 620
regex(3) OSS Library Calls Reference Manual {m} {m,} {m,u} || Matches a given number of consecutive occurrences of the preceding regular expression. The {m,u} syntax matches from m to u occurrences where m and u are integers indicating the maximum and minimum number of occurrences, respectively. The {m} syntax matches exactly m occurrences while the {m,} syntax matches m or more occurences. | | | | | Returns the value of the enclosed regular expression (subexpression).
PAGE 621
OSS Library Calls (n - r) regexec(3) | | NAME regexec - Performs regular expression matching | | DESCRIPTION See regcomp(3).
PAGE 622
regfree(3) OSS Library Calls Reference Manual | | NAME regfree - Performs regular expression matching | | DESCRIPTION See regcomp(3).
PAGE 623
OSS Library Calls (n - r) remainder(3) | | 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.
PAGE 624
remainder(3) OSS Library Calls Reference Manual | | | ERRORS If any of the following conditions occurs, the remainder( ) function sets errno to the corresponding value: [EDOM] || One of the following conditions exists: | | • The value of the y parameter is 0.0 (zero). || | | • The value of the x parameter is positive or negative infinity. || | | | RELATED INFORMATION Functions: fp_class(3), isnan(3).
PAGE 625
OSS Library Calls (n - r) remove(3) | | 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 The C run-time library supports two variants of the remove( ) function: remove_oss( ) and remove_guardian( ).
PAGE 626
remove_guardian(3) OSS Library Calls Reference Manual | | 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 #include
PAGE 627
OSS Library Calls (n - r) remove_guardian(3) | | RELATED INFORMATION Functions: link(2), remove(3), remove_oss(3), rename(2). | | STANDARDS CONFORMANCE The remove_guardian( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 628
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 #include
PAGE 629
OSS Library Calls (n - r) remove_oss(3) 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 630
remque(3) OSS Library Calls Reference Manual | | NAME remque - Inserts or remove an element in a queue | | DESCRIPTION See insque(3).
PAGE 631
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 #include | | void rewind( FILE ∗ stream); | | SYNOPSIS | PARAMETERS stream || Specifies the I/O stream.
PAGE 632
rewind(3) OSS Library Calls Reference Manual [ENOSPC] || There was no free space remaining on the device containing the file. | A request was made to a nonexistent device, or the request was outside the capabilities of the device. | | An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal is also sent to the process. | | [ENXIO] || [EPIPE] || | | RELATED INFORMATION Functions: fgetpos(3), fopen(3), fseek(3), lseek(2), fsetpos(3), ftell(3).
PAGE 633
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.
PAGE 634
rewinddir(3) OSS Library Calls Reference Manual Directory Operations After fork Operations If, after a call to a fork( ) or tdm_fork( ) function, both the parent and child processes make calls to the readdir( ) function to access an OSS directory, the results of the calls are undefined. | | | 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.
PAGE 635
OSS Library Calls (n - r) rewinddir(3) • After a call to one of the exec set of functions, all open directory streams are closed automatically. • The ramifications of having both the parent and child processes access the same OSS directory after a call to the fork( ) or tdm_fork( ) function are undefined. • The consequences of calling directory functions with a dir_pointer parameter that does not refer to a currently opened directory stream are defined.
PAGE 636
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 #include | | char *rindex ( const char *s, int c); | | | SYNOPSIS | PARAMETERS s || Is a pointer to the string to be scanned.
PAGE 637
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 #include | | double rint( double x); | | SYNOPSIS | PARAMETERS x || Is the double-precision floating-point value to be rounded.
PAGE 638
rint(3) OSS Library Calls Reference Manual | | ERRORS No error values are returned. This function does not set errno. | | 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: • For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 639
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 640
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 641
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-007 This function does not set errno to [EDOM] if the value of x or n is NaN.
PAGE 642
scandir(3) OSS Library Calls Reference Manual NAME scandir - Scan a directory LIBRARY G-series native OSS processes: /G/system/sysnn/zutilsrl H-series OSS processes: /G/system/zdllnnn/zutilfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ int scandir( const char *dir_name, struct dirent *(*namelist[ ]), int (*select)(struct dirent *entry), int (*dcomp)(struct dirent **entry1, struct dirent **entry2)); PARAMETERS dir_name Names the directory.
PAGE 643
OSS Library Calls (s) scandir(3) ERRORS These underlying functions can cause the scandir( ) function to report an errno value: opendir( ), readdir( ), and malloc( ). For information about the errors reported by these functions, see the reference pages for the functions. RELATED INFORMATION Functions: closedir(3), mkdir(2), opendir(3), readdir(3), rewinddir(3), rmdir(2), scandir64(3), seekdir(3), telldir(3). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
PAGE 644
scandir64(3) OSS Library Calls Reference Manual NAME scandir64 - Scan a directory LIBRARY G-series native OSS processes: /G/system/sysnn/zutilsrl H-series OSS processes: /G/system/zdllnnn/zutilfdll SYNOPSIS #include #include /* optional except for POSIX.1 */ int scandir( const char *dir_name, struct dirent64 *(*namelist[ ]), int (*select)(struct dirent64 *entry), int (*dcomp)(struct dirent64 **entry1, struct dirent64 **entry2)); PARAMETERS dir_name Names the directory.
PAGE 645
OSS Library Calls (s) scandir64(3) RETURN VALUES Upon successful completion, the scandir64( ) function returns the number of entries selected. The namelist parameter returns a pointer to the array of entry pointers. If scandir64( ) is not successful, -1 is returned. When an underlying call to another function encounters an error, errno is set to indicate the error. ERRORS These underlying functions can cause the scandir64( ) function to report an errno value: opendir( ), readdir( ), and malloc( ).
PAGE 646
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 647
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 648
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 649
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 650
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 651
OSS Library Calls (s) • scanf(3) A - (dash) character that is neither the first nor last character in a scanset for %[scanset] conversion indicates a range of values. The value preceding a - (dash) character must be lexically less than or equal to the value after the - (dash).
PAGE 652
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 653
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 654
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 655
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 656
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 657
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 658
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 659
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 660
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 661
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 662
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 663
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 664
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 665
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 666
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 667
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 668
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 669
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 670
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 671
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 672
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 673
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 674
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 675
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 676
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−38 Use of this function on a signal set that has not been properly initialized causes undefined results.
PAGE 677
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 678
sigdelset(3) OSS Library Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: • 6−40 The function can return the error value [EFAULT].
PAGE 679
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 680
sigemptyset(3) 6−42 OSS Library Calls Reference Manual Hewlett-Packard Company 527187-007
PAGE 681
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 682
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 683
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 684
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 685
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 686
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 687
OSS Library Calls (s) signal(3) The following are HP extensions to the XPG4 Version 2 specification: 527187-007 • 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 688
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 689
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 690
sin(3) 6−52 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 691
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 692
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 693
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 694
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 695
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 696
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 697
OSS Library Calls (s) 527187-007 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 698
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 699
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 700
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 701
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 702
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 703
OSS Library Calls (s) sprintf(3) not implied. 527187-007 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 704
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 705
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-007 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 706
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 707
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 708
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 709
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 710
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 711
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 712
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 713
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 714
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 715
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 716
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 717
OSS Library Calls (s) sscanf(3) The following are HP extensions to the XPG4 Version 2 specification: • 527187-007 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 718
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 719
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 720
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 721
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 722
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 723
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 724
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 725
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 726
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 727
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 728
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 729
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 730
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 731
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 732
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 733
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 734
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 735
OSS Library Calls (s) 527187-007 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 736
strftime(3) 6−98 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 737
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 738
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 739
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 740
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 741
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 742
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 743
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 744
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 745
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 746
strptime(3) 6−108 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 747
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 748
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 749
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 750
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 751
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 752
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 753
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 754
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 755
OSS Library Calls (s) strtok(3) EXAMPLES The following example demonstrates how to split a string into tokens. #include #include #include
PAGE 756
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 757
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 758
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 759
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 760
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 761
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 762
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 763
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 764
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 765
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 766
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 767
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 768
strxfrm(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: setlocale(3), strcoll(3), strcmp(3), wcsxfrm(3).
PAGE 769
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 770
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 771
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 772
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 773
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 774
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 775
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 776
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 777
OSS Library Calls (s) syslog(3) Table 6−3.
PAGE 778
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 779
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 780
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 781
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 782
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 783
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-007 • 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 784
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 785
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 786
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 787
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 788
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 789
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 790
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 791
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 792
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 793
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 794
tcgetpgrp(3) • 7−14 OSS Library Calls Reference Manual The tcgetpgrp( ) function can return the errno values [EISGUARDIAN] and [ENETDOWN].
PAGE 795
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 796
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 797
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 798
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 799
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 800
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 801
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 802
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 803
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 804
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 805
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 806
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 807
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 808
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 809
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 810
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 811
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 812
tmpfile64(3) OSS Library Calls Reference Manual NAME tmpfile64 - 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 tmpfile64( ) function: tmpfile64_oss( ) and tmpfile64_guardian( ).
PAGE 813
OSS Library Calls (t - v) tmpfile64_guardian(3) NAME tmpfile64_guardian - Creates a temporary file (Guardian tmpfile64( ) 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 814
tmpfile64_guardian(3) OSS Library Calls Reference Manual RETURN VALUES Upon successful completion, the tmpfile64( ) function returns a pointer to the stream of the file that is created. Otherwise, it returns a null pointer, and sets errno to indicate the error. ERRORS If any of these conditions occurs, the tmpfile64( ) function sets errno to the corresponding value: [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process.
PAGE 815
OSS Library Calls (t - v) tmpfile64_oss(3) NAME tmpfile64_oss - Creates a temporary file (OSS tmpfile64( ) 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 816
tmpfile64_oss(3) OSS Library Calls Reference Manual ERRORS If any of these conditions occurs, the tmpfile64( ) function sets errno to the corresponding value: [EINTR] A signal was caught during the tmpfile64( ) function. [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process. [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available.
PAGE 817
OSS Library Calls (t - v) tmpfile_guardian(3) 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 818
tmpfile_guardian(3) OSS Library Calls Reference Manual [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available. RELATED INFORMATION Functions: fopen(3), tmpfile(3), tmpfile64_guardian(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 819
OSS Library Calls (t - v) tmpfile_oss(3) 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 820
tmpfile_oss(3) OSS Library Calls Reference Manual [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, tmpfile64_oss, tmpnam(3), unlink(2). STANDARDS CONFORMANCE The tmpfile_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 821
OSS Library Calls (t - v) tmpnam(3) 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 822
tmpnam_guardian(3) OSS Library Calls Reference Manual 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 823
OSS Library Calls (t - v) tmpnam_guardian(3) 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 824
tmpnam_oss(3) OSS Library Calls Reference Manual 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 825
OSS Library Calls (t - v) tmpnam_oss(3) 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 826
toascii(3) OSS Library Calls Reference Manual 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 827
OSS Library Calls (t - v) _tolower(3) 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 828
tolower(3) OSS Library Calls Reference Manual 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 829
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 830
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 831
OSS Library Calls (t - v) towlower(3) 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 832
towupper(3) OSS Library Calls Reference Manual 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 833
OSS Library Calls (t - v) tsearch(3) 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 834
tsearch(3) OSS Library Calls Reference Manual 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 835
OSS Library Calls (t - v) ttyname(3) 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 836
ttyname(3) OSS Library Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: • 7−56 The ttyname( ) function can return the errno values [EISGUARDIAN], [ENOCRE], and [ENOMEM].
PAGE 837
OSS Library Calls (t - v) twalk(3) 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 838
tzset(3) OSS Library Calls Reference Manual 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 839
OSS Library Calls (t - v) tzset(3) 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 840
ungetc(3) OSS Library Calls Reference Manual 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.
PAGE 841
OSS Library Calls (t - v) ungetwc(3) 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 842
unordered(3) OSS Library Calls Reference Manual 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
PAGE 843
OSS Library Calls (t - v) usleep(3) 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]. A value of 0 (zero) is ignored.
PAGE 844
usleep(3) OSS Library Calls Reference Manual 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 845
OSS Library Calls (t - v) va_arg(3) 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 846
va_end(3) OSS Library Calls Reference Manual 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 847
OSS Library Calls (t - v) valloc(3) 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 848
va_start(3) OSS Library Calls Reference Manual 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 849
OSS Library Calls (t - v) va_start(3) RELATED INFORMATION Functions: va_arg(3), va_end(3), vfprintf(3).
PAGE 850
vfprintf(3) OSS Library Calls Reference Manual 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
PAGE 851
OSS Library Calls (t - v) • vfprintf(3) - 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 852
vfprintf(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 853
OSS Library Calls (t - v) 527187-007 vfprintf(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 854
vfprintf(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 855
OSS Library Calls (t - v) void { vfprintf(3) 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 856
vfprintf(3) OSS Library Calls Reference Manual RELATED INFORMATION Functions: fprintf(3), printf(3), sprintf(3), vprintf(3), vsprintf(3).
PAGE 857
OSS Library Calls (t - v) vprintf(3) 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 858
vprintf(3) OSS Library Calls Reference Manual [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 859
OSS Library Calls (t - v) vsnprintf(3) 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 860
vsnprintf(3) OSS Library Calls Reference Manual 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 861
OSS Library Calls (t - v) vsnprintf(3) — 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 862
vsnprintf(3) OSS Library Calls Reference Manual Specifying a field width with a 0 (zero) as a leading character causes the field width value to be padded with leading zeros. 7−82 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 863
OSS Library Calls (t - v) vsnprintf(3) 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 864
vsnprintf(3) OSS Library Calls Reference Manual 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 865
OSS Library Calls (t - v) vsprintf(3) 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 866
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 867
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 868
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 869
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 870
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 871
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 872
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 873
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 874
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 875
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 876
OSS Library Calls (w - z) 527187-007 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 877
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 878
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 879
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 880
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 881
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 882
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 883
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 884
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 885
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 886
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 887
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 888
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 889
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 890
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 891
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 892
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 893
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 894
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 895
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 896
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 897
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 898
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 899
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 900
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 901
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 902
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 903
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 904
OSS Library Calls (w - z) wcswidth(3) value of -1 is returned. RELATED INFORMATION Functions: wcwidth(3).
PAGE 905
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 906
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 907
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 908
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 909
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 910
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 911
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 912
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 913
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 914
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 915
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 916
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 917
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 918
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 919
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 920
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 921
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 922
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 923
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 924
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 925
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 926
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-007 For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN.
PAGE 927
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 928
stderr(5) OSS Library Calls Reference Manual NAME stderr - Standard error stream DESCRIPTION See stdin(5).
PAGE 929
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 930
stdout(5) OSS Library Calls Reference Manual NAME stdout - Standard output stream DESCRIPTION See stdin(5).
PAGE 931
Permuted Index _____________________________ for a temporary file (OSS tmpnam( file (Guardian tmpfile64( temporary file (Guardian tmpfile( a temporary file (OSS tmpfile64( Opens a stream (Guardian fopen64( Opens a stream (OSS fopen64( Opens a stream (Guardian fopen( Opens a stream (OSS fopen( Opens a stream (OSS freopen64( Opens a stream (Guardian freopen( Opens a stream (OSS freopen( a stream (Guardian freopen64( Removes a file (Guardian remove( Removes a file (OSS remove( detected by the getaddrinfo( tem
PAGE 932
OSS Library Calls Reference Manual number from an Internet IPv4 host entry by name and IPv4 or IPv6 entry by name and IPv4 or IPv6 specified Internet address and in/ /an integer Internet IPv4 host/ /Extracts the local network /Constructs an Internet IPv4 number and a local network Gets a network entry by 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
PAGE 933
Permuted Index a 32-bit integer to a radix-64 a64l: Converts a radix-64 time into a date and time string trigonometric sine function hyperbolic sine function diagnostics get_assign_msg_by_name: Retrieves Retrieves a specified /Determines number of active 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 trigonomet
PAGE 934
OSS Library Calls Reference Manual /Converts time since the Epoch to /Converts time since the Epoch to time string asctime: Converts the Epoch mktime: Converts of parameters for output to a of parameters for output to a setbuf: Assigns setvbuf: Assigns 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
PAGE 935
Permuted Index iswgraph: Tests for wide graphic Stores formatted output into a Stores formatted output into a stream ungetc: Pushes a stream ungetwc: Pushes a wide memchr: Finds a one character code set to another /a string of characters from one iconv_open: Opens a 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 str
PAGE 936
OSS Library Calls Reference Manual mbtowc: Converts a multibyte stream putwchar: Writes a wide Translates integer to 7-bit ASCII a wide character into a multibyte code/ iconv: Converts a string of Locates the first occurrence of wcslen: Determines the number of memcmp: Compares memset: Sets 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 lower
PAGE 937
Permuted Index case strcasecmp: wmemcmp: memcmp: strcmp: collation strcoll: bcmp: strncmp: case strncasecmp: wcscmp: 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 se
PAGE 938
OSS Library Calls Reference Manual whether the run-time heap heap_check: Checks the /on standard error or system IPv4 address from a/ inet_addr: address from an/ inet_makeaddr: temporary file tmpnam: temporary file/ tmpnam_guardian: temporary file (OSS/ tmpnam_oss: temporary file tempnam: /Saves the current execution Saves the current execution iscntrl: Tests for iswcntrl: Tests for a wide tcflow: Performs flow aclsort: Sorts an access Generates the pathname for the heap/ heap_check_always: Closes a specifi
PAGE 939
Permuted Index to an unsigned long/ wcstoull: since the Epoch to broken-down memcpy: strncpy: bcopy: memory memccpy: overlapping areas in/ memmove: into another wcscpy: strcpy: with a character count wcsncpy: 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 ch
PAGE 940
OSS Library Calls Reference Manual endpwent: Closes the user entry to the first entry in the entry to the first entry in the to the network protocols to the network services Closes the network host next/ /Opens the network host setnetent: Opens the networks setprotoent: Opens the protocols the/ /Opens the network services group information from the group group information from the group group information from the group next entry in the network host the next entry in the network entry from the network servi
PAGE 941
Permuted Index stream opendir: Opens a pathname of the current working pathname of the current working stream to the beginning of the dirname: Returns the parent closedir: Closes a readdir: Reads a readdir64: Reads a seekdir: Sets position within a Opens a directory and creates a Returns current position within a of/ /Resets the position in the directory name of a file/ wcwidth: Determines the strings wcswidth: Determines the error or system console/ fmtmsg: hypot: Computes the Euclidean drand48: Generate u
PAGE 942
OSS Library Calls Reference Manual /Event Management Service (EMS) event log files ..................................................... openlog(3) Sets the Event Management Service (EMS) event log mask setlogmask: ............................. setlogmask(3) /Event Management Service (EMS) events and logs them ......................................... syslog(3) array encrypt: Encrypts or decrypts an .................................. encrypt(3) setkey: Sets an encryption or decryption key ..................
PAGE 943
Permuted Index /Opens the network host database /Opens the networks database /Opens the protocols database /the network services database hypot: Computes the Event Management Service (EMS) Event Management Service (EMS) Event Management Service (EMS) event log/ closelog: Closes the event log/ openlog: Initializes event log/ setlogmask: Sets the events and/ syslog: Generates Event Management Service (EMS) Initializes a signal mask to TACL command system: re_exec: regex: setjmp: Saves the current sigsetjmp: S
PAGE 944
OSS Library Calls Reference Manual from a a specified input stream string from a stream mkfifo: Creates a mkfifo: Creates a FIFO special remove: Removes a tmpfile: Creates a temporary tmpfile64: Creates a temporary Service (EMS) event log an open file fpathconf: Gets Associates a stream with a Maps a stream pointer to a getdtablesize: Gets the attributes for an open remove_guardian: Removes a function) /Creates a temporary function) /Creates a temporary /the name for a temporary a stream pointer to a Guardi
PAGE 945
Permuted Index tcdrain: Waits for output to floating-point number is/ vector getopt: Gets function fabs: Computes the Rounds floating-point numbers to Rounds floating-point numbers to cbrt: Computes the cube root of a of 2 ldexp: Multiplies a exponent of a radix-independent integral and/ modf: Breaks a fraction and a/ frexp: Breaks a finite: Tests whether a Computes the square root of a radix-independent exponent as a representable double-precision ecvt: Converts a fcvt: Converts a gcvt: Converts a floating
PAGE 946
OSS Library Calls Reference Manual specified output stream stream to a specified stream string to a stream a floating-point number into a number into integral and information structure and/ information structure and/ structure and/ freeaddrinfo: structure and/ freehostent: the pglob parameter globfree: the pwordexp parameter wordfree: the/ if_freenameindex: addrinfo/ lwres_freeaddrinfo: hostent/ lwres_freehostent: /Opens a stream (Guardian freopen_oss: Opens a stream (OSS /Opens a stream (Guardian /Opens a
PAGE 947
Permuted Index the logarithm of the gamma Computes the Euclidean distance the logarithm of the gamma Computes the natural logarithm Computes the base 10 logarithm expm1: Computes the exponential file (Guardian tmpnam( ) Computes the natural logarithm order 0/ j0: Computes the Bessel order 1 j1: Computes the Bessel order n jn: Computes the Bessel order 0/ y0: Computes the Bessel order 1 y1: Computes the Bessel order n yn: Computes the Bessel the inverse trigonometric tangent a stream (Guardian fopen64( ) a s
PAGE 948
OSS Library Calls Reference Manual 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 949
Permuted Index getpagesize: size getdtablesize: ID tcgetpgrp: current host.
PAGE 950
OSS Library Calls Reference Manual 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 minimum block size to/ isxdigit: Tests for a iswxdigit: Tests for a wide address from an Internet IPv4 number from an Internet IPv4 /Translates a protocol-independent /Translates protocol-independent Internet network byte
PAGE 951
Permuted 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 file-position for/ /Retrieves the file-position ferror: Tests the error clearerr: Clears Internet IPv4 address from a/ network address from an Internet/ Internet IPv4 address from an/ number from an Internet IPv4/ in Internet dotted-decimal/ Inte
PAGE 952
OSS Library Calls Reference Manual 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 radix-64 ASCII string to a 32-bit Computes absolute value of an Converts a character string to an a character string to a long a character string to a long long strchr: Finds an string to a signed long lo
PAGE 953
Permuted Index 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 file opened for ANSI Gets host information based on an OSS interprocess communication /Constructs an integer Internet network/ /Constructs an Internet Translates an integer Internet a character string to an IPv6 or inet_ntop: Converts an IPv6
PAGE 954
OSS Library Calls Reference Manual 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/ character mblen: Determines the string strcspn: Returns string strspn: Returns strlen: Finds a string wcscspn: Returns the a string wcsspn: Returns the _min: Expands the getopt: Gets flag the gamma function of a pre
PAGE 955
Permuted Index iswlower: Tests for a wide characters _toupper: Translates characters toupper: Translates uppercase characters to characters towupper: Translates uppercase characters to towlower: Translate uppercase to distributed pseudorandom number/ and update memory of one or more addrinfo/ memory of one or more hostent/ applications in printing error/ names and service names into/ /previously created by the /on the EAI_ codes returned by the name of the host with the/ Internet address (IPv4) of the/ Inte
PAGE 956
OSS Library Calls Reference Manual 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_freenameindex: Frees dynamic valloc: Provide a pwordexp/ wordfree: Frees all parameter globfree: Frees all wi
PAGE 957
Permuted Index 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 to its corresponding Returns the parent directory ttyname: Gets the lwres_gethostbyaddr: Gets the host information based on IP node assign message by logical-unit value of a parameter b
PAGE 958
OSS Library Calls Reference Manual 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 Internet network byte order/ address from an Internet network Multiplies a floating-point the cube root of a floating-point radi
PAGE 959
Permuted Index /indicator of an Edit file Management Service (EMS) event/ converter iconv_open: directory stream opendir: loadfile from a running/ dlopen: fopen: fopen64: catopen: freopen: freopen64: freopen64( )/ freopen64_guardian: function) fopen_guardian: ) function) fopen64_guardian: ) function) freopen_guardian: function) fopen_oss: function) fopen64_oss: function) freopen_oss: function) freopen64_oss: output, or/ fopen64_std_file: output, or/ fopen_std_file: /etc/hosts and sets/ sethostent: database/
PAGE 960
OSS Library Calls Reference Manual Writes a byte to the standard Writes a string to the standard a wide character to the standard variable number of parameters for variable number of parameters for fprintf: Prints formatted 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
PAGE 961
Permuted Index fseeko: Repositions the file fseeko64: Repositions the file fsetpos: Repositions the file fsetpos64: Repositions the file rewind: Repositions the file Reports the position the file Reports the position of the file Reports the position of the file fileno: Maps a stream gfileno: Maps a stream process Gets a network service entry by to the/ rewinddir: Resets the stream ftello: Reports the stream ftello64: Reports the stream ftell: Reports the stream seekdir: Sets stream telldir: Returns current
PAGE 962
OSS Library Calls Reference Manual information nl_langinfo: /Generate uniformly distributed /Generates uniformly distributed /Generate uniformly distributed /to generate uniformly distributed /Generates uniformly distributed /Generates uniformly distributed /Generates uniformly distributed /to generate uniformly distributed /to generate uniformly distributed rand: Returns srand: Generates ispunct: Test for a iswpunct: Tests for a wide input stream ungetc: the input stream ungetwc: specified output stream st
PAGE 963
Permuted Index expressions expression matching expression matching expressions expression matching expression matching regcomp: Perform regerror: Performs regexec: Performs regfree: Performs advance: Matches compile: Compiles re_comp: Compiles re_exec: Executes regcmp: Compiles regex: Executes 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 (Guar
PAGE 964
OSS Library Calls Reference Manual errors detected by/ gai_strerror: of string strcspn: of string strspn: rand: floating-point value fp_class: most recent call/ dlresultcode: pathname basename: segment of a string wcscspn: segment of a string wcsspn: of a file pathname dirname: environment variable getenv: copysign: pointer of a stream the directory stream to the/ occurrence of a character numbers to nearest integral/ cbrt: Computes the cube sqrt: Computes the square floating-point integers ceil: floating-p
PAGE 965
Permuted Index distributed pseudorandom number distributed pseudorandom number distributed pseudorandom number distributed pseudorandom number distributed pseudorandom number distributed pseudorandom number database setpwent: Resets the memccpy: Copies characters Sends a break on an asynchronous /Closes the Event Management /Initializes Event Management /Sets the Event Management them /Generates Event Management getservbyname: Gets a network getservbyport: Gets a network /Converts hostnames and /Converts ho
PAGE 966
OSS Library Calls Reference Manual in a signal set goto with signal handling copysign: Returns x with the sigdelset: Deletes a context for a nonlocal goto with Performs a nonlocal goto with sigismember: Tests for a pause: Suspends a process until a sigemptyset: Initializes a sigfillset: Initializes a sigaddset: Adds a signal to a Deletes a signal from a Tests for a signal in a action to take upon delivery of a take upon delivery of a signal sigaddset: Adds a abort: Generates a software raise: Sends a a sign
PAGE 967
Permuted Index a floating-point number number sqrt: Computes the numbers uniformly distributed/ read from a character string /from a character string in input, standard output, or input, standard output, or in/ fmtmsg: Displays message on stderr: or/ fopen64_std_file: Opens or/ fopen_std_file: Opens gets: Gets a string from the formatted input read from the Gets a character from the a wide character string from the Gets a wide character from the stderr: error file /Opens standard input, error file /Opens st
PAGE 968
OSS Library Calls Reference Manual stderr: Standard error stdout: Standard output input read from an input read from the standard input Tests the error indicator on a character from a specified input Repositions the file pointer of a Repositions the file pointer of a a wide character string from a formatted output to an output a byte to a specified output a wide character to a specified a wide-character string to a Repositions the file pointer of a Repositions the file pointer of a Repositions the file poin
PAGE 969
Permuted Index binary address to a character time into a date and time input read from a character the Epoch into a date and time of characters in a wide-character character a floating-point number to a a floating-point number to a a character index: Scans lwres_hstrerror: Returns a locale strxfrm: Transforms character rindex: Scans a character in a wide-character a character in a wide-character fgets: Gets a fgetws: Gets a wide character stream gets: Gets a getws: Gets a wide character a floating-point num
PAGE 970
OSS Library Calls Reference Manual wcscmp: Compares wide-character /Transforms wide character the/ /Returns error message strcasecmp: Compare two strncasecmp: Compares two wcstok: Splits wide-character wcstoul: Converts wide-character wcstoull: Converts wide-character wcscoll: Compares wide-character strcoll: Compares display width of wide-character wcsncat: Appends wide-character wcsncmp: Compares wide-character wcsncpy: Copies wide-character strings, ignoring case string bytes in a string string to a tim
PAGE 971
Permuted Index the inverse trigonometric tangent function finish functions output data or unread input data associated with a terminal process group ID asynchronous serial data line associated with a terminal process group ID binary search tree within a directory stream an OSS temporary file tmpfile: Creates a tmpfile64: Creates a tmpnam: Constructs the name for a tmpfile64_guardian: Creates a )/ tmpfile_guardian: Creates a )/ /Constructs the name for a function) tmpfile_oss: Creates a tmpfile64_oss: Create
PAGE 972
OSS Library Calls Reference Manual unordered relative to/ unordered: Tests whether one value is ............................................ unordered(3) search tree tfind: Finds a node in a binary ...................................... tfind(3) time: Gets time .............................................................. time(3) alarm: Sets or changes the timeout value for interval timers .................................. alarm(3) the timeout value for interval timers alarm: Sets or changes .............
PAGE 973
Permuted Index 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 lcong48: Sets rule to generate pseudorandom/ lrand48: Generates pseudorandom/ mrand48: Generates pseudorandom/ nrand48: Generates seed48: Sets rule to generate srand48: Sets rule to generate mkstemp: Makes a mktemp: Makes a tzset: Converts time Epoch to br
PAGE 974
OSS Library Calls Reference Manual 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 labs: Computes absolute numbers to nearest integral decimal to/ /Converts SQL DECIMAL a character string to a time is unordered relative to another stores it/ /Converts a C long long array of decimal to a C long long putenv: Sets an environment the value of an environment
PAGE 975
Permuted Index 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 wmemchr: Finds a character wctomb: Converts a Tests for an alphanumeric Determines the properties of a a multibyte character to a a multibyte character string to a stream fgetws: Gets a standard input/ getws: Gets a multibyte/ wcstombs: Converts a collation in/
PAGE 976
OSS Library Calls Reference Manual 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 the current output stream fputc: output stream putc: output stream putchar: function error perror: fputs: output stream puts: specified stream fputwc: specified stream putwc: standard output stream putwchar: a stream fputws: the standard output/ putws: putw: fwrite: log
PAGE 977
Index _____________________________ A B a64l function, 1-2 abort fault, and assert macro, 1-19 abort function, 1-3 abs function, 1-5 _abs macro, 1-4 absolute value function, 1-5, 4-64 macro, 1-4 ACLs, sorting entries in, 1-6 aclsort command, 1-6 acos function, 1-8 to 1-9 acosh function, 1-10 advance macro, 1-12 to 1-13 alarm function, 1-14 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-15 asin f
PAGE 978
OSS Library Calls Reference Manual C calloc function, 1-37 catclose function, 1-38 catgets function, 1-39 catopen function, 1-40 to 1-41 cbrt function, 1-42 ceil function, 1-43 cfgetispeed function, 1-44 cfgetospeed function, 1-45 cfsetispeed function, 1-46 cfsetospeed function, 1-47 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-41, 3-82, 3-84 loca
PAGE 979
Index crypt function, 1-63 ctermid function, 1-64 to 1-65 ctime function, 1-66 cube root function, 1-42 cuserid function, 1-67 to 1-68 D data decrypting, 2-7, 6-22 encrypting, 1-63, 2-7, 6-22 database manipulating entry in user, 2-12, 3-65, 3-67, 3-69, 6-32 user, 2-8, 3-29, 3-31, 6-19 basic group information, 3-27 date conversion, 6-95, 8-9 daylight external variable, 7-58 to 7-59 dbm_clearerr function, 1-69 dbm_close function, 1-69 dbm_delete function, 1-69 dbm_error function, 1-69 dbm_fetch function, 1-6
PAGE 980
OSS Library Calls Reference Manual _RLDVERBOSE, 1-92 _RLD_FIRST_LIB_PATH, 1-92 _RLD_LIB_PATH, 1-92 erand48 function, 2-14 to 2-15 erf function, 2-16 erfc function, 2-17 errno value [EACCES], 2-146, 2-150, 3-20, 3-60, 5-6, 5-12 [EAFNOSUPPORT], 4-22, 4-25 [EAGAIN], 1-67, 3-30 [EBADF], 4-32, 7-5, 7-7, 7-9, 7-11, 7-18, 7-19, 7-55 [ECWDTOOLONG], 3-20 [EFAULT], 3-20, 6-39, 7-11, 7-18, 7-30 [EFSBAD], 2-146, 2-150, 3-20, 5-7, 5-12 [EINTR], 3-60, 5-32, 7-5, 7-18 [EINVAL], 1-48, 3-20, 3-30, 4-8, 4-10, 4-12, 5-37, 5-6
PAGE 981
Index a program, 7-25 _exit function, 1-3 exit function, 2-18 exp function, 2-19 to 2-20 expm1 function, 2-21 exponential function, 2-19, 2-21 expressions, regular, 1-12, 1-54, 6-80 external variable, optarg, 3-53 F fabs function, 2-22 fclose function, 2-23 to 2-24 fcvt function, 2-25 fdopen function, 2-27 to 2-28 feof function, 2-29 ferror function, 2-30 fflush function, 2-31 to 2-32 ffs function, 2-33 fgetc function, 2-34 to 2-35 fgetpos function, 2-36 fgetpos64 function, 2-37 to 2-38 fgets function, 2-3
PAGE 982
OSS Library Calls Reference Manual fputs function, 2-88 to 2-89 fputwc function, 2-90 to 2-91 fputws function, 2-92 to 2-93 fp_class function, 2-78 fread function, 2-94 to 2-95 free function, 2-96 freeaddrinfo function, 2-97 freehostent function, 2-99 freopen function, 2-100, 2-109, 2-112 freopen64 function, 2-101, 2-102, 2-105 to 2-108 freopen64_guardian function, 2-102 freopen64_oss function, 2-105 to 2-108 freopen_guardian function, 2-109 freopen_oss function, 2-112 frexp function, 2-115 to 2-116 fscanf
PAGE 983
Index get_startup_msg function, 3-76 to 3-78 gfileno function, 3-87 glob function, 3-88 to 3-92 globfree function, 3-93 gmtime function, 3-94 graph class type test, 4-31, 4-35, 4-47 group ID foreground process, 7-13 setting for process, 7-19 group information, accessing in user database, 2-8, 3-27, 3-29, 3-31, 6-19 Guardian API, 1-48, 2-4 to 2-5, 2-6, 2-63 to 2-64, 2-72, 3-12 to 3-13, 3-14, 3-46, 3-57, 3-58 to 3-59, 3-76 to 3-78, 3-87, 3-97, 3-98, 3-99, 7-25 to 7-26 Guardian environment, using from abort fu
PAGE 984
OSS Library Calls Reference Manual ilogb function, 4-14 index function, 4-15 inet_addr function, 4-16 inet_lnaof function, 4-17 inet_makeaddr function, 4-18 inet_netof function, 4-19 inet_network function, 4-20 inet_ntoa function, 4-21 inet_ntop function, 4-22 inet_pton function, 4-24 inistate function, 4-26 input converting formatted, 2-117, 6-8, 6-74 flushing, 7-9 pushing back character, 7-60, 7-61 input stream getting character from, 2-34, 2-41, 3-15, 3-17, 3-82, 3-84 getting word from, 2-41, 3-80, 3-82,
PAGE 985
Index L M l64a function, 4-63 labs function, 4-64 lcong48 function, 4-65 to 4-66 ldexp function, 4-67 to 4-68 ldiv function, 4-69 lfind function, 4-70 lgamma function, 4-71 to 4-72 linear search, of table, 4-70, 4-91 lldiv function, 4-73 locale, setting and querying, 6-23 locale-dependent parameters, 4-74 localeconv function, 4-74 to 4-76 localtime function, 4-77 log function, 4-81 to 4-82 log10 function, 4-78 to 4-79 log1p function, 4-80 logarithm functions base 10 logarithm, 4-78 natural logarithm of 1
PAGE 986
OSS Library Calls Reference Manual hyperbolic cosine, 1-62 hyperbolic sine, 6-53 hyperbolic tangent, 7-4 hypotenuse, 3-104 inverse hyperbolic cosine, 1-10 inverse hyperbolic sine, 1-18 inverse hyperbolic tangent, 1-24 inverse trigonometric sine (arc sine), 1-16 inverse trigonometric tangent (arc tangent), 1-20, 1-22 lesser of two arguments, 4-127 logarithm of gamma function, 3-4 logarithm of the gamma function, 4-71 maximum of two arguments, 4-115 modulo remainder function, 2-47 multiplying by integral powe
PAGE 987
Index copying wide characters with memory overlap, 8-51 finding a character byte, 4-122 finding a wide character byte, 8-47 setting characters in, 4-126 setting wide characters in, 8-52 memory operations comparing characters, 4-123 comparing memory areas, 1-33 comparing wide characters, 8-49 copying a character, 4-124 copying a wide character, 8-50 copying an area, 1-34 copying characters sequentially, 4-121 copying characters with memory overlap, 4-125 copying wide characters with memory overlap, 8-51 find
PAGE 988
OSS Library Calls Reference Manual closing, 2-10 getting next entry, 3-52 opening, 3-52 networks file opening, 3-52 reading next line, 3-52 searching by address, 3-50 searching by name, 3-51 nextafter function, 5-2 nftw function, 5-4 to 5-8 nftw64 function, 5-9 to 5-13 nlist function, 5-14 nl_langinfo function, 5-15 nonlocal goto longjmp function, 4-85 setting jump point, 6-50 siglongjmp function, 6-45 nrand48 function, 5-16 to 5-17 ntohl function, 5-18 ntohs function, 5-19 null character, 1-27, 6-114 O op
PAGE 989
Index returning processor time used, 1-50 suspending, 5-32 suspending execution, 6-54, 7-63 terminating, 1-26, 2-18 processor time, returning, 1-50 protocol entry retrieving, 3-64 returning by name, 3-62 returning by number, 3-63 protocols file closing, 2-11 opening, 3-64 reading, 3-64 searching by name, 3-62 searching by number, 3-63 setting and rewinding, 6-31 pseudo-random numbers, generator functions, 1-99 to 1-100, 2-14 to 2-15, 4-26, 4-61 to 4-62, 4-65 to 4-66, 4-89 to 4-90, 4-138 to 4-139, 5-16 to 5-
PAGE 990
OSS Library Calls Reference Manual S saving execution context, 6-21 scalb function, 6-2 scandir function, 6-4 to 6-5 scandir64 function, 6-6 to 6-7 scanf function, 6-8 to 6-13 search trees, 7-21, 7-27, 7-53, 7-57 seed48 function, 6-14 to 6-15 seekdir function, 6-16 to 6-17 sending signals, 5-65 service entry returning by name, 3-73 returning by port, 3-74 service file entry, 6-33 services file closing, 2-13 opening, 3-75 reading next line, 3-75 searching by name, 3-73 searching by port, 3-74 setbuf functio
PAGE 991
Index stdout, 2-63 to 2-64, 2-72 stdout file, 9-3 step macro, 6-80 to 6-81 strcasecmp function, 6-82 strcat function, 6-83 strchr function, 6-84 strcmp function, 6-85 strcoll function, 6-86 strcpy function, 6-87 strcspn function, 6-88 strdup function, 6-89 stream clearing errors, 1-49 closing, 2-23 flushing, 2-31 getting a string from, 2-43, 3-86 getting a string from stdin, 3-71 mapping pointer to file descriptor, 2-44 mapping pointer to Guardian file number, 3-87 opening, 2-27, 2-56, 2-59, 2-65, 2-68, 2-1
PAGE 992
OSS Library Calls Reference Manual writing out, 2-88, 5-53 strlen function, 6-101 strncasecmp function, 6-102 strncat function, 6-103 strncmp function, 6-104 strncpy function, 6-105 strpbrk function, 6-106 strptime function, 6-107 strrchr function, 6-111 strspn function, 6-112 strstr function, 6-113 strtod function, 6-114 to 6-115 strtok function, 6-116 strtol function, 6-118 to 6-120 strtoll function, 6-121 to 6-123 strtoul function, 6-124 to 6-126 strtoull function, 6-127 to 6-128 structures sftw, 5-4, 5-
PAGE 993
Index _XOPEN_XCU_VERSION, 6-135 sysconf function, 6-132 to 6-136 syslog function, 6-137 to 6-140 system clock getting time, 7-28 times of process and child process, 7-29 system function, 6-141 to 6-142 system log, 1-53, 5-24, 6-29, 6-137 system variables finding current value, 1-57 retrieving values of, 6-132 T table performing linear search, 4-70 performing linear search and update, 4-91 sorting, 5-63 TACL commands, 6-141 tan function, 7-2 to 7-3 tanh function, 7-4 tcdrain function, 7-5 to 7-6 tcflow func
PAGE 994
OSS Library Calls Reference Manual hyperbolic cosine, 1-62 hyperbolic sine, 6-53 hyperbolic tangent, 7-4 inverse hyperbolic cosine, 1-10 inverse hyperbolic sine, 1-18 inverse hyperbolic tangent, 1-24 inverse trigonometric tangent (arc tangent), 1-20, 1-22 sine, 6-51 tangent, 7-2 trigonometric functions"inverse trigonometric sine (arc sin, 1-16 tsearch function, 7-53 to 7-54 ttyname function, 7-55 to 7-56 twalk function, 7-57 type conversion, 1-81, 4-87 to 4-88 tzname external variable, 7-58 to 7-59 tzset fu
PAGE 995
Index wcstoul function, 8-32 wcstoull function, 8-35 wcswcs function, 8-37 wcswidth function, 8-38 wcsxfrm function, 8-40 wctomb function, 8-42 to 8-43 wctype function, 8-44 wcwidth function, 8-46 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 wchar_t characters, wcscspn function, 8-8 converting string to multibyte, wcstombs function, 8-30 converting to multibyte, wctomb function, 8-42 copying, 8-17