1 .\" Copyright (c) 1980, 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)intro.3 8.1 (Berkeley) 6/5/93
40 .Nd introduction to the C libraries
42 This section provides an overview of the C
43 library functions, their error returns and other
44 common definitions and concepts.
45 Most of these functions are available from the C library,
47 Other libraries, such as the math library,
49 must be indicated at compile time with the
51 option of the compiler.
53 The various libraries (followed by the loader flag):
54 .Bl -tag -width "libc (-lc)"
55 .It Em libc Pq Fl l Ns Ar c
56 Standard C library functions.
57 When using the C compiler
60 to supply the loader flag
63 There are several `libraries' or groups of functions included inside of
71 character tests and character operators,
72 des encryption routines,
73 storage allocation, time functions, signal handling and more.
74 .It Em libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap
75 Terminal independent screen management routines
76 for two dimensional non-bitmap display terminals.
79 .It Em libcompat Pq Fl l Ns Ar compat
80 Functions which are obsolete but are available for compatibility with
83 a number of system call interfaces provided in previous releases of
85 have been included for source code compatibility.
86 Use of these routines should, for the most part, be avoided.
87 The manual page entry for each compatibility routine
88 indicates the proper interface to use.
89 .It Em libkvm Pq Fl l Ns Ar kvm
90 Functions used to access kernel memory are in this library.
92 against both a running system and a crash dump.
95 .It Em libl Pq Fl l Ns Ar l
98 .It Em libm Pq Fl l Ns Ar m
101 The math library is loaded as needed by the Pascal compiler,
102 but not by the C compiler which requires the
107 .It Em libmp Pq Fl l Ns Ar mp
108 .It Em libtermcap Pq Fl l Ns Ar termcap
109 The terminal independent operation library package.
112 .It Em liby Pq Fl l Ns Ar y
117 .Bl -tag -width /usr/lib/libm_p.a -compact
118 .It Pa /usr/lib/libc.a
120 .It Pa /usr/lib/libc_p.a
121 the C library compiled for profiling
122 .It Pa /usr/lib/libm.a
124 .It Pa /usr/lib/libm_p.a
125 the math library compiled for profiling