intro(3) Library Functions Manual intro(3)
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 func-
tions 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 Threadsafe Threadsafe Equivalent
-------------------------------------------
asctime asctime_r
ctime ctime_r
endpwent endpwent_r
fgetgrent fgetgrent_r
fgetpwent fgetpwent_r
getgrent getgrent_r
getgrgid getgrgid_r
getgrname getgrname_r
getpwent getpwent_r
getpwnam getpwnam_r
getpwuid getpwuid_r
gmtime gmtime_r
localtime localtime_r
rand rand_r
readdir readdir_r
setpwent setpwent_r
strtok strtok_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_regis-
ter, 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
intro(3)
