NAME

intro − introduction to library functions

DESCRIPTION

Section 3 describes functions found in libraries. 

This section describes subroutines found in the system libraries. 

The main C library is /lib/libc.a, and contains all the system call entry points described in section 2 as well as functions described in several subsections here.  The primary functions in the C library are described in the main section 3.  Functions associated with the “standard I/O library” used by many C programs are found in section 3S.  The libc library also includes the Internet network functions described in section 3N and routines providing compatibility with other UNIX systems as described in section 3C as well as all the system entry points from section 2. 

Other sections here are:

(3F) The 3F functions are all functions callable from FORTRAN.  These functions perform the same jobs as the straight “3” functions do for C programmers.  There are in fact three FORTRAN libraries, namely −lU77 which contains the system interface routines, −lI77 which is the I/O interface library, and −lF77 which is everything not contained in the other two.  These libraries are searched automatically by the loader when loading FORTRAN programs. 

(3M) These functions constitute the math library.  C declarations for the types of functions may be obtained from the include file <math.h>. To use these functions with C programs use a −lm option with cc(1). They are automatically loaded as needed by the Fortran and Pascal compilers f77(1) and pc(1).

(3X) Various specialized libraries have not been given distinctive captions.  Files in which such libraries are found are named on appropriate pages if they don’t appear in the libc library. 

FILES

/lib/libc.aC Library ((2), (3), (3N) and (3C) routines)
/usr/lib/libc_p.aProfiling C library (for
gprof(1))
/usr/lib/libm.aMath Library −lm (see section 3M)
/usr/lib/libm_p.aProfiling version of −lm
/usr/lib/libU77.aFORTRAN system interface (see section 3F)
/usr/lib/libI77.aFORTRAN I/O (see section 3F)
/usr/lib/libF77.aFORTRAN everything else (see section 3F)
/usr/lib/libcurses.ascreen management routines (see
curses(3X)
/usr/lib/libdbm.adata base management routines (see
dbm(3X))
/usr/lib/libmp.amultiple precision math library (see
mp(3X))
/usr/lib/libtermcap.aterminal handling routines (see
termcap(3X))
/usr/lib/libtermcap_p.a
/usr/lib/libtermlib
/usr/lib/libtermlib_p.a
/usr/lib/libplot.aplot routines (see
plot(3X))
/usr/lib/lib300.a  "
/usr/lib/lib300s.a  "
/usr/lib/lib4014.a  "
/usr/lib/lib450.a  "

SEE ALSO

intro(3C), intro(3S), intro(3F), intro(3M), intro(3N), nm(1), ld(1), cc(1), f77(1), intro(2)

DIAGNOSTICS

Functions in the math library (section 3M) 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 (see intro(2)) is set to the value EDOM (domain error) or ERANGE (range error). The values of EDOM and ERANGE are defined in the include file <errno.h>.

LIST OF FUNCTIONS

NameAppears on PageDescription

Sun Release 1.1  —  Last change: 12 January 1984