Commit | Line | Data |
---|---|---|
1287fffe CL |
1 | .\" Copyright (c) 1980, 1991 Regents of the University of California. |
2 | .\" All rights reserved. | |
09056340 | 3 | .\" |
1287fffe | 4 | .\" %sccs.include.redist.man% |
09056340 | 5 | .\" |
bd8ecad4 | 6 | .\" @(#)intro.3 6.11 (Berkeley) %G% |
1287fffe CL |
7 | .\" |
8 | .Dd | |
9 | .Dt INTRO 3 | |
10 | .Os BSD 4 | |
11 | .Sh NAME | |
12 | .Nm intro | |
13 | .Nd introduction to the C libraries | |
14 | .Sh DESCRIPTION | |
15 | This section provides an overview of the C | |
16 | library functions, their error returns and other | |
17 | common definitions and concepts. | |
18 | Most of these functions are available from the C library, | |
19 | .Em libc | |
20 | (see | |
21 | .Xr libc 3 ) . | |
22 | Other libraries, such as the math library, | |
23 | .Em libm , | |
24 | must be indicated at compile time with the | |
25 | .Fl l | |
26 | option of the compiler. | |
27 | .Pp | |
28 | A subset of the | |
29 | .Xr libc functions | |
30 | are available from Fortran; | |
4885e3a3 | 31 | they are described separately in |
1287fffe CL |
32 | .Xr intro 3f . |
33 | .Pp | |
34 | The various libraries (followed by the loader flag): | |
bd8ecad4 | 35 | .Bl -tag -width "libc (-lc)" |
1287fffe CL |
36 | .It Xr libc Pq Fl l Ns Ar c |
37 | Standard C library functions. (See | |
38 | .Xr libc 3 . ) When using the C compiler | |
39 | .Xr cc 1 , | |
40 | it is not necessary | |
41 | to supply the loader flag | |
42 | .Fl l Ns Ar c | |
43 | for these functions. | |
44 | There are several `libraries' or groups of functions included inside of | |
45 | .Xr libc : the standard | |
46 | .Tn I/O | |
47 | routines, | |
48 | database routines, | |
49 | bit operators, | |
50 | string operators, | |
51 | character tests and character operators, | |
52 | des encryption routines, | |
53 | storage allocation, time functions, signal handling and more. | |
54 | .It Xo | |
55 | .Xr libcurses | |
56 | .Pf ( Fl l Ns Ar curses | |
57 | .Fl l Ns Ar termcap ) | |
58 | .Xc | |
59 | Terminal independent screen management routines | |
60 | for two dimensional non-bitmap display terminals. | |
61 | (See | |
62 | .Xr curses 3 . ) | |
63 | .It Xr libcompat Pq Fl l Ns Ar compat | |
64 | Functions which are obsolete but are available for compatibility with | |
65 | .Bx 4.3 . | |
4885e3a3 | 66 | In particular, |
ecdf96eb | 67 | a number of system call interfaces provided in previous releases of |
1287fffe CL |
68 | .Bx |
69 | have been included for source code compatibility. | |
4885e3a3 KM |
70 | Use of these routines should, for the most part, be avoided. |
71 | The manual page entry for each compatibility routine | |
72 | indicates the proper interface to use. | |
1287fffe CL |
73 | .\" .It Xr libkvm |
74 | .It Xr libl Pq Fl l Ns Ar l | |
75 | The library for | |
76 | .Xr lex 1 . | |
77 | .\" .It Xr libln | |
78 | .It Xr libm Pq Fl l Ns Ar m | |
79 | The math library, | |
80 | .Em libm . | |
4885e3a3 | 81 | The math library is loaded as needed by the Pascal compiler |
1287fffe CL |
82 | .Xr pc 1 , |
83 | but not by the C compiler which requires the | |
84 | .Fl l Ns Ar m | |
85 | flag. | |
86 | (See | |
87 | .Xr math 3 . ) | |
88 | .It Xr libmp Pq Fl l Ns Ar mp | |
89 | .\" .It Xr libom | |
90 | .\" Old math library. | |
91 | .It Xr libplot Pq Fl l Ns Ar plot | |
92 | Device independent plotting functions. | |
93 | (See | |
94 | .Xr plot 3 . ) | |
95 | .It Xr libplotf77 Pq Fl l Ns Ar plotf77 | |
96 | The device independent plotting functions for fortran. | |
97 | (See | |
98 | .Xr plot 3 . ) | |
99 | .\" .It Xr libresolv Pq Fl l Ns Ar resolv | |
100 | .\" Routines for network address resolution. | |
101 | .It Xr libtermcap Fl l Ns Ar termcap | |
102 | The terminal independent operation library package. (See | |
103 | .Xr termcap 3 . ) | |
104 | .\" .It libvt0.a | |
105 | .It Xr liby Pq Fl l Ns Ar y | |
106 | The library for | |
107 | .Xr yacc 1 . | |
108 | .El | |
109 | .Sh FILES | |
110 | .Bl -tag -width /usr/lib/libm_p.a -compact | |
111 | .It Pa /usr/lib/libc.a | |
112 | the C library | |
113 | .It Pa /usr/lib/libm.a | |
114 | the math library | |
115 | .It Pa /usr/lib/libc_p.a | |
116 | the C library compiled for profiling | |
117 | .It Pa /usr/lib/libm_p.a | |
118 | the math library compiled for profiling | |
119 | .El | |
120 | .Sh SEE ALSO | |
121 | .\" .Xr libc 3 , | |
122 | .Xr stdio 3 , | |
123 | .Xr math 3 , | |
124 | .Xr intro 2 , | |
125 | .Xr cc 1 , | |
126 | .Xr ld 1 , | |
127 | .Xr nm 1 | |
128 | .\" .Sh LIST OF FUNCTIONS | |
129 | .\" .Bl -column "strncasecmpxxx" "system" | |
130 | .\" .Sy Name Description | |
131 | .\" .El | |
132 | .Sh HISTORY | |
133 | An | |
134 | .Nm intro | |
135 | manual appeared in | |
136 | .At v7 . |