.\" @(#)intro.3 8.1 (Berkeley) 6/5/93
.\" $FreeBSD: src/share/man/man3/intro.3,v 1.14 2001/08/07 15:48:38 ru Exp $
.\"
-.Dd June 5, 1993
+.Dd Aug 17, 2006
.Dt INTRO 3
.Os
.Sh NAME
This section provides an overview of the C
library functions, their error returns and other
common definitions and concepts.
-Most of these functions are available from the C library,
-.Em libc .
-.\" (see
-.\" .Xr libc 3 ) .
-Other libraries, such as the math library,
-.Em libm ,
+Most of these functions are available from the System library,
+.Em libSystem .
+Other libraries
must be indicated at compile time with the
.Fl l
option of the compiler.
-.\" .Pp
-.\" A subset of the
-.\" .Xr libc functions
-.\" are available from Fortran;
-.\" they are described separately in
-.\" .Xr intro 3f .
.Pp
The various libraries (followed by the loader flag):
-.Bl -tag -width "libc (-lc)"
-.It Xr libc Pq Fl l Ns Ar c
+.Bl -tag -width "libSystem (-lSystem)"
+.It Xr libSystem Pq Fl l Ns Ar System
Standard C library functions.
-.\" (See
-.\" .Xr libc 3 . )
When using the C compiler
.Xr cc 1 ,
it is not necessary
to supply the loader flag
-.Fl l Ns Ar c
+.Fl l Ns Ar System
for these functions.
There are several `libraries' or groups of functions included inside of
-.Xr libc :
+.Xr libSystem :
the standard
.Tn I/O
routines,
character tests and character operators,
des encryption routines,
storage allocation, time functions, signal handling and more.
+.Pp
+For compatibility with other systems, which provide these capabilities in
+separate libraries (such as
+.Xr libc ) ,
+symbolic links are provided for
+.Fl l Ns Ar c ,
+.Fl l Ns Ar dbm ,
+.Fl l Ns Ar dl ,
+.Fl l Ns Ar info ,
+.Fl l Ns Ar m ,
+.Fl l Ns Ar poll ,
+.Fl l Ns Ar pthread
+and
+.Fl l Ns Ar rpcsvc ;
+they all point to
+.Xr libSystem .
.It Xr libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap
Terminal independent screen management routines
for two dimensional non-bitmap display terminals.
(See
.Xr ncurses 3 . )
-.It Xr libcompat Pq Fl l Ns Ar compat
-Functions which are obsolete but are available for compatibility with
-.Bx 4.3 .
-In particular,
-a number of system call interfaces provided in previous releases of
-.Bx
-have been included for source code compatibility.
-Use of these routines should, for the most part, be avoided.
-The manual page entry for each compatibility routine
-indicates the proper interface to use.
-.It Xr libkvm Pq Fl l Ns Ar kvm
-Functions used to access kernel memory are in this library. They can be used
-against both a running system and a crash dump.
-(See
-.Xr kvm 3 . )
.It Xr libl Pq Fl l Ns Ar l
The library for
.Xr lex 1 .
-.\" .It Xr libln
-.It Xr libm Pq Fl l Ns Ar m
-The math library,
-.Em libm .
-The math library is loaded as needed by the Pascal compiler,
-.\" .Xr pc 1 ,
-but not by the C compiler which requires the
-.Fl l Ns Ar m
-flag.
-(See
-.Xr math 3 . )
-.It Xr libmp Pq Fl l Ns Ar mp
-.\" .It Xr libom
-.\" Old math library.
-.\" .It Xr libplot Pq Fl l Ns Ar plot
-.\" Device independent plotting functions.
-.\" (See
-.\" .Xr plot 3 . )
-.\" .It Xr libplotf77 Pq Fl l Ns Ar plotf77
-.\" The device independent plotting functions for fortran.
-.\" (See
-.\" .Xr plot 3 . )
-.\" .It Xr libresolv Pq Fl l Ns Ar resolv
-.\" Routines for network address resolution.
.It Xr libtermcap Pq Fl l Ns Ar termcap
The terminal independent operation library package.
(See
.Xr yacc 1 .
.El
.Sh FILES
-.Bl -tag -width /usr/lib/libm_p.a -compact
-.It Pa /usr/lib/libc.a
-the C library
-.It Pa /usr/lib/libc_p.a
-the C library compiled for profiling
-.It Pa /usr/lib/libm.a
-the math library
-.It Pa /usr/lib/libm_p.a
-the math library compiled for profiling
+.Bl -tag -width /usr/lib/libSystem_profile.dylib -compact
+.It Pa /usr/lib/libSystem.dylib
+the main System library
+.It Pa /usr/lib/libSystem_debug.dylib
+the main System library compiled with debug support
+.It Pa /usr/lib/libSystem_profile.dylib
+the main System library compiled for profiling
.El
.Sh SEE ALSO
.\" .Xr libc 3 ,
.Xr ld 1 ,
.Xr nm 1 ,
.Xr intro 2 ,
-.Xr math 3 ,
.Xr stdio 3
.\" .Sh LIST OF FUNCTIONS
.\" .Bl -column "strncasecmpxxx" "system"
projects / apple / libc.git / blobdiff