Content-type: text/html Man page of intro

intro

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

intro - Introduction to library functions  

DESCRIPTION

Section 3 reference pages describe functions that may be found in various libraries. The library functions are those other than the functions that directly invoke Tru64 UNIX system primitives, described in Section 2 reference pages.

Some reference pages in Section 3 may contain suffixes to allow their files to exist with those of other reference pages having the same base name and section number. When used, suffixes are made up of one to four letters. See the man(1) reference page for more information on suffixes.

To use the reentrant functions and data structures identified as ``obsolete'' in Section 3 reference pages, it is necessary to define the preprocessor symbol _REENTRANT prior to including the associated include file. If this is not done, prototypes and supplementary data structures for these functions may not be defined. This symbol is defined for you if you use the -threads or -pthread switches to the cc or c89 command.

All libc functions are threadsafe unless otherwise indicated on their respective reference pages. The following table lists non-threadsafe libc functions and their threadsafe equivalents (which are provided in libc.so for use in multithreaded applications):

Not ThreadsafeThreadsafe Equivalent

asctimeasctime_r
ctimectime_r
endpwentendpwent_r
fgetgrentfgetgrent_r
fgetpwentfgetpwent_r
getgrentgetgrent_r
getgrgidgetgrgid_r
getgrnamegetgrname_r
getpwentgetpwent_r
getpwnamgetpwnam_r
getpwuidgetpwuid_r
gmtimegmtime_r
localtimelocaltime_r
randrand_r
readdirreaddir_r
setpwentsetpwent_r
strtokstrtok_r

The following functions are not threadsafe and do not have threadsafe equivalents: registerrpc, svc_destroy, svc_freeargs, svc_getargs, svc_getcaller, svc_getreq, svc_getreqset, svc_register, svc_run, svc_sendreply, svc_unregister, svcerr_auth, svcerr_decode, svcerr_noproc, svcerr_noprog, svcerr_progvers, svcerr_systemerr, svcerr_weakauth, svcfd_create, svcraw_create, svctcp_create, svcudp_create, xprt_register, xprt_unregister  

ERRORS

Functions in the math library may return conventional values when the function is undefined for the given arguments or when the value is not representable. In these cases, the external variable errno is set to the value of EDOM (domain error) or ERANGE (range error). For further information, see intro(2). The values of EDOM and ERANGE are defined in the include file <math.h>.  

FILES

/usr/lib/libc.a
/usr/lib/libcP.a
/usr/lib/libm.a
/usr/lib/libcV.a
 

RELATED INFORMATION

cc(1), ld(1), nm(1), intro(2) delim off


 

Index

NAME
DESCRIPTION
ERRORS
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:13 GMT, October 02, 2010