.\"	$NetBSD: intro.3,v 1.19 2004/03/20 05:03:32 snj Exp $
.\"
.\" 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. 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 .
.Pp
The various system libraries supplied in
.Nx
(followed by the linker flags) are:
.Bl -tag -width "libc (-lc)"
.It Em libasn1 Pq Fl l Ns Ar asn1
The abstract syntax notation (ASN) library provides routines for the
specification of abstract data types.
.It Em libbz2 Pq Fl l Ns Ar bz2
Block-sorting compressor library providing routines for fast and
efficient compression.
.It Em libc Pq Fl l Ns Ar c
The standard C library.  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 :
.Pp
.Bl -tag -width "XXXXXX"
.It standard I/O routines
see
.Xr stdio 3
.It database routines
see
.Xr db 3
.It bit operators
see
.Xr bit_string 3
.It string operators
see
.Xr string 3
.It character tests and character operators
.It Tn encryption and hash routines
see
.Xr md4 3
and
.Xr md5 3 .
.It storage allocation
see
.Xr mpool 3
and
.Xr malloc 3
.It time functions
see
.Xr time 3
.It signal handling
see
.Xr signal 3
.El
.It Em libcdk Pq Fl l Ns Ar cdk
Curses development kit (CDK) library.  See
.Xr cdk 3 .
.It Em libcom_err Pq Fl l Ns Ar com_err
The common error description library.  See
.Xr com_err 3 .
.It Em 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 Em libcrypt Pq Fl l Ns Ar crypt
The crypt library.  See
.Xr crypt 3 .
.It Em libcrypto Pq Fl l Ns Ar crypto
The OpenSSL cryptographic library.  See
.Xr crypto 3 .
.It 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.
.It 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.
.It Xo
.Em libcurses
.Pf ( 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 .
.It Em libdes Pq Fl l Ns Ar des
The OpenSSL cryptographic library for the DES algorithms.  See
.Xr des 3 .
.It 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 .
.It Em libform Pq Fl l Ns Ar form
The curses form library provides a terminal-independent form system
using the curses library.  The form library provides facilities for
defining forms on terminals.  See
.Xr forms 3 .
.It 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.
.It Em libhesiod Pq Fl l Ns Ar hesiod
The Hesiod library.  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 .
.It Em libhdb Pq Fl l Ns Ar hdb
The Heimdal Kerberos 5 authentication/authorisation database access
library.
.It Em libintl Pq Fl l Ns Ar intl
The internationalized message handling library.  See
.Xr gettext 3 .
.It Em libipsec Pq Fl l Ns Ar ipsec
The IPsec policy control library.  See
.Xr ipsec_set_policy 3
and
.Xr ipsec_strerror 3 .
.It Em libkadm Pq Fl l Ns Ar kadm
The Kerberos IV administration server and client library.
.It Em libkadm5clnt Pq Fl l Ns Ar kadm5clnt
The Kerberos 5 administration client library.
.It Em libkadm5srv Pq Fl l Ns Ar kadm5srv
The Kerberos 5 administration server library.
.It Em libkafs Pq Fl l Ns Ar kafs
The Kerberos IV AFS library.  See
.Xr kafs 3 .
.It Em libkdb Pq Fl l Ns Ar kdb
The Kerberos IV authentication/authorisation database access library.
.It Em libkrb Pq Fl l Ns Ar krb
The Kerberos IV library.
.It Em libkrb5 Pq Fl l Ns Ar krb5
The Kerberos 5 library.  See
.Xr krb5 3 .
.It Em libkstream Pq Fl l Ns Ar kstream
Kerberos IV encrypted stream library.
.It Em libkvm Pq Fl l Ns Ar kvm
Kernel data access library.  See
.Xr kvm 3 .
.It Em libl Pq Fl l Ns Ar l
The library for
.Xr lex 1 .
.It 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.
.It Em libmenu Pq Fl l Ns Ar menu
The curses menu library.  See
.Xr menus 3 .
.It Em libpcap Pq Fl l Ns Ar pcap
The packet capture library.  See
.Xr pcap 3 .
.It Em libpci Pq Fl l Ns Ar pci
The PCI bus access library.  See
.Xr pci 3 .
.It Em libposix Pq Fl l Ns Ar posix
The POSIX compatibility library provides a compatibility interface for
POSIX functions which differ from the standard BSD interfaces.  See
.Xr chown 2
and
.Xr rename 2 .
.It Em libresolv Pq Fl l Ns Ar resolv
The DNS resolver library.
.It Em librmt Pq Fl l Ns Ar rmt
Remote magnetic tap library.  See
.Xr rmtops 3 .
.It 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.
.It Em librpcsvc Pq Fl l Ns Ar rpcsvc
The Remote Procedure Call (RPC) services library.  See
.Xr rpc 3 .
.It Em libskey Pq Fl l Ns Ar skey
The S/Key one-time password library.  See
.Xr skey 3 .
.It Em libsl Pq Fl l Ns Ar sl
.It Em libss Pq Fl l Ns Ar ss
.It Em libssl Pq Fl l Ns Ar ssl
The secure sockets layer (SSL) library.  See
.Xr ssl 3 .
.It Em libtelnet Pq Fl l Ns Ar telnet
The telnet library.
.It Em libtermcap Pq Fl l Ns Ar termcap
The terminal-independent operation library.  See
.Xr termcap 3 .
.It Em libusb Pq Fl l Ns Ar usb
The Universal Serial Bus (USB) access library.  See
.Xr usb 3 .
.It Em libutil Pq Fl l Ns Ar util
The system utilities library.  See
.Xr util 3 .
.It Em libwrap Pq Fl l Ns Ar wrap
The TCP wrappers library.  See
.Xr host_access 3 .
.It Em liby Pq Fl l Ns Ar y
The library for
.Xr yacc 1 .
.It Em libz Pq Fl l Ns Ar z
General-purpose compression library.
.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 .