Copyright (c) 1980, 1991, 1993
The Regents of the University of California. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
must display the following acknowledgement:
This product includes software developed by the University of
California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
@(#)intro.3 8.1 (Berkeley) 6/5/93
.Dd October 4, 2001 .Dt INTRO 3 .Os .Sh NAME .Nm intro .Nd introduction to the system libraries .Sh DESCRIPTION This section provides an overview of the system libraries, their functions, error returns and other common definitions and concepts. Most of these functions are available from the standard C library, .Em libc . Other libraries, such as the math library, .Em libm , 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 .
p The various system libraries supplied in .Nx (followed by the linker flags) are: l -tag -width "libc (-lc)" t Em libasn1 Pq Fl l Ns Ar asn1 The abstract syntax notation (ASN) library provides routines for the specification of abstract data types. t Em libbz2 Pq Fl l Ns Ar bz2 Block-sorting compressor library providing routines for fast and efficient compression. t Em libc Pq Fl l Ns Ar c Standard C library functions. When using the C compiler .Xr cc 1 , it is not necessary to supply the linker flag .Fl l Ns Ar c for these functions. There are several subsystems included inside .Em libc :
p l -tag -width "XXXXXX" t standard I/O routines see .Xr stdio 3 t database routines see .Xr db 3 t bit operators see .Xr bit_string 3 t string operators see .Xr string 3 t character tests and character operators t Tn encryption and hash routines see .Xr md4 3 and .Xr md5 3 . t storage allocation see .Xr mpool 3 and .Xr malloc 3 t time functions see .Xr time 3 t signal handling see .Xr signal 3 .El t Em libcdk Pq Fl l Ns Ar cdk Curses development kit (CDK) library. t Em libcom_err Pq Fl l Ns Ar com_err The common error description library. t Em libcompat Pq Fl l Ns Ar compat Functions which are obsolete but are available for compatibility with x 4.3 . In particular, a number of system call interfaces provided in previous releases of x 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. t Em libcrypt Pq Fl l Ns Ar crypt Crypt library functions. See .Xr crypt 3 . t Em libcrypto Pq Fl l Ns Ar crypto The OpenSSL cryptographic library routines. See .Xr crypto 3 . t Em libcrypto_idea Pq Fl l Ns Ar crypto_idea The OpenSSL cryptographic library routines for the IDEA algorithm. This algorithm is separated from libcrypto since the IDEA algorithm is protected by patents and its use is restricted. t Em libcrypto_rc5 Pq Fl l Ns Ar crypto_rc5 The OpenSSL cryptographic library routines for the RC5 algorithm. This algorithm is separated from libcrypto since the RC5 algorithm is protected by patents and its use is restricted. t Xo .Em libcurses
f ( Ns Fl l Ns Ar curses
.Fl l Ns Ar termcap )
.Xc
Terminal independent screen management routines
for two dimensional non-bitmap display terminals. See
.Xr curses 3 .
t Em libdes Pq Fl l Ns Ar des The OpenSSL cryptographic library for the DES algorithms. See
.Xr des 3 .
t Em libedit Pq Fl l Ns Ar edit The command-line editor or editline library. The editline library
provides generic editing and history functions. See
.Xr editline 3 .
t Em libform Pq Fl l Ns Ar form The curses form library functions provides a terminal-independent form
system using the curses library. The form library provides facilities
for defining forms on terminals. See
.Xr forms 3 .
t Em libgssapi Pq Fl l Ns Ar gssapi The Generic Security Services (GSS) API library. This library provides
verification services to applications and usually sits above the
cryptographic libraries.
t Em libhesiod Pq Fl l Ns Ar hesiod The Hesiod library functions. This library provides routines for
performing lookups of Hesiod information, which is stored as text
records in the Domain Name Service. See
.Xr hesiod 3 .
t Em libhdb Pq Fl l Ns Ar hdb The Heimdal Kerberos 5 authentication/authorisation database library.
t Em libintl Pq Fl l Ns Ar intl The internationalized message handling library. See
.Xr gettext 3 .
t Em libipsec Pq Fl l Ns Ar ipsec The IPsec policy control library. See
.Xr ipsec_set_policy 3
and
.Xr ipsec_strerror 3 .
t Em libkadm Pq Fl l Ns Ar kadm The Kerberos 4 administration server and client library.
t Em libkadm5clnt Pq Fl l Ns Ar kadm5clnt The Kerberos 5 administration client library.
t Em libkadm5srv Pq Fl l Ns Ar kadm5srv The Kerberos 5 administration server library.
t Em libkafs Pq Fl l Ns Ar kafs The Kerberos AFS library functions.
t Em libkdb Pq Fl l Ns Ar kdb The Kerberos 4 authentication/authorisation database library.
t Em libkrb Pq Fl l Ns Ar krb The Kerberos 4 library.
t Em libkrb5 Pq Fl l Ns Ar krb5 The Kerberos 5 library. See
.Xr krb5 3 .
t Em libkstream Pq Fl l Ns Ar kstream Kerberos 4 encrypted stream library.
t Em libkvm Pq Fl l Ns Ar kvm Kernel data access library. See
.Xr kvm 3 .
t Em libl Pq Fl l Ns Ar l The library for
.Xr lex 1 .
t Em libm Pq Fl l Ns Ar m The math library. See
.Xr math 3 .
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 Em libmp Pq Fl l Ns Ar mp
.It Em libom
Old math library.
.It Em libplot Pq Fl l Ns Ar plot
Device independent plotting functions (see
.Xr plot 3 ) .
.It Em libplotf77 Pq Fl l Ns Ar plotf77
The device independent plotting functions for fortran. (see
.Xr plot 3 ) .
.It Em libresolv Pq Fl l Ns Ar resolv
Routines for network address resolution.
t Em libmenu Pq Fl l Ns Ar menu The curses menu library. See
.Xr menus 3 .
t Em libpcap Pq Fl l Ns Ar pcap The packet capture library. See
.Xr pcap 3 .
t Em libpci Pq Fl l Ns Ar pci The PCI bus access library. See
.Xr pci 3 .
t Em libposix Pq Fl l Ns Ar posix POSIX compatibility library.
t Em libresolv Pq Fl l Ns Ar resolv The DNS resolver library.
t Em librmt Pq Fl l Ns Ar rmt Remote magnetic tap library. See
.Xr rmtops 3 .
t Em libroken Pq Fl l Ns Ar roken A library containing compatibility functions used by Kerberos. It
implements functionality required by the Kerberos implementation not
implemented in the standard
.Nx
libraries.
t Em librpcsvc Pq Fl l Ns Ar rpcsvc The Remote Procedure Call (RPC) services library. See
.Xr rpc 3 .
t Em libskey Pq Fl l Ns Ar skey The S/Key one-time password library.
t Em libsl Pq Fl l Ns Ar sl t Em libss Pq Fl l Ns Ar ss t Em libssl Pq Fl l Ns Ar ssl The secure sockets layer (SSL) library. See
.Xr ssl 3 .
t Em libtelnet Pq Fl l Ns Ar telnet The telnet library.
t Em libtermcap Pq Fl l Ns Ar termcap The terminal-independent operation library. See
.Xr termcap 3 .
t Em libusb Pq Fl l Ns Ar usb The Universal Serial Bus (USB) access library. See
.Xr usb 3 .
t Em libutil Pq Fl l Ns Ar util The system utilities library. See
.Xr opendisk 3 ,
etc.
t Em libwrap Pq Fl l Ns Ar wrap The TCP wrappers library. See
.Xr host_access 3 .
t Em liby Pq Fl l Ns Ar y The library for
.Xr yacc 1 .
t Em libz Pq Fl l Ns Ar z General-purpose compression library.
.El
.Sh FILES
l -tag -width /usr/lib/libm_p.a -compact t Pa /usr/lib/libc.a the C library
t Pa /usr/lib/libm.a the math library
t Pa /usr/lib/libc_p.a the C library compiled for profiling
t Pa /usr/lib/libm_p.a the math library compiled for profiling
.El
.Sh SEE ALSO
.Xr cc 1 ,
.Xr ld 1 ,
.Xr nm 1 ,
.Xr rtld 1 ,
.Xr intro 2
.Sh HISTORY
An
.Nm intro
manual appeared in
.At v7 .
Indexes created Tue Sep 30 20:09:53 GMT 2025