intro(3)intro(3)NAMEintro - Introduction to library functions
DESCRIPTION
Section 3 reference pages describe functions that may be found in vari‐
ous 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 suf‐
fixes.
To use the reentrant functions and data structures identified as “obso‐
lete” in Section 3 reference pages, it is necessary to define the pre‐
processor 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_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
SEE ALSOcc(1), ld(1), nm(1), intro(2)intro(3)