summaryrefslogtreecommitdiffstats
path: root/share/man/man3
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man3')
-rw-r--r--share/man/man3/assert.315
-rw-r--r--share/man/man3/bitstring.311
-rw-r--r--share/man/man3/dlfcn.313
-rw-r--r--share/man/man3/end.316
-rw-r--r--share/man/man3/intro.362
-rw-r--r--share/man/man3/queue.371
-rw-r--r--share/man/man3/stdarg.36
-rw-r--r--share/man/man3/sysexits.391
8 files changed, 137 insertions, 148 deletions
diff --git a/share/man/man3/assert.3 b/share/man/man3/assert.3
index 6ab5cc4a39a..de72ad0a7e6 100644
--- a/share/man/man3/assert.3
+++ b/share/man/man3/assert.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: assert.3,v 1.4 2000/03/19 19:25:23 aaron Exp $
+.\" $OpenBSD: assert.3,v 1.5 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: assert.3,v 1.5 1994/11/30 15:24:30 jtc Exp $
.\"
.\" Copyright (c) 1991, 1993
@@ -48,10 +48,8 @@ The
.Fn assert
macro tests the given
.Ar expression
-and if it is false,
-the calling process is terminated.
-A
-diagnostic message is written to
+and if it is false, the calling process is terminated.
+A diagnostic message is written to
.Em stderr
and the
.Xr abort 3
@@ -59,16 +57,13 @@ function is called, effectively terminating the program.
.Pp
If
.Ar expression
-is true,
-the
+is true, the
.Fn assert
macro does nothing.
.Pp
The
.Fn assert
-macro
-may be removed at compile time with
-the
+macro may be removed at compile time with the
.Xr cc 1
option
.Fl DNDEBUG .
diff --git a/share/man/man3/bitstring.3 b/share/man/man3/bitstring.3
index 44d2d2703db..b07aa96c5a2 100644
--- a/share/man/man3/bitstring.3
+++ b/share/man/man3/bitstring.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bitstring.3,v 1.7 2000/03/19 19:25:23 aaron Exp $
+.\" $OpenBSD: bitstring.3,v 1.8 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: bitstring.3,v 1.4 1994/11/30 15:24:31 jtc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
@@ -105,8 +105,7 @@ The
.Fn bit_nclear
and
.Fn bit_nset
-macros
-clear or set the zero-based numbered bits from
+macros clear or set the zero-based numbered bits from
.Fa start
to
.Fa stop
@@ -115,8 +114,7 @@ in the bit string
.Pp
The
.Fn bit_test
-macro
-evaluates to non-zero if the zero-based numbered bit
+macro evaluates to non-zero if the zero-based numbered bit
.Fa bit
of bit string
.Fa name
@@ -124,8 +122,7 @@ is set, and zero otherwise.
.Pp
The
.Fn bit_ffs
-macro
-stores in the location referenced by
+macro stores in the location referenced by
.Fa value
the zero-based number of the first bit set in the array of
.Fa nbits
diff --git a/share/man/man3/dlfcn.3 b/share/man/man3/dlfcn.3
index 4a9bda937d2..d17b4576375 100644
--- a/share/man/man3/dlfcn.3
+++ b/share/man/man3/dlfcn.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: dlfcn.3,v 1.11 2000/05/25 21:49:01 deraadt Exp $
+.\" $OpenBSD: dlfcn.3,v 1.12 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: dlfcn.3,v 1.3 1996/01/09 19:43:34 pk Exp $
.\"
.\" Copyright (c) 1995 Paul Kranenburg
@@ -33,7 +33,11 @@
.Dt DLFCN 3
.Os
.Sh NAME
-.Nm dlopen , dlclose , dlsym , dlctl , dlerror
+.Nm dlopen ,
+.Nm dlclose ,
+.Nm dlsym ,
+.Nm dlctl ,
+.Nm dlerror
.Nd dynamic link interface
.Sh SYNOPSIS
.Fd #include <dlfcn.h>
@@ -78,11 +82,10 @@ for future compatibility.
.Fn dlopen
returns a handle to be used in calls to
.Fn dlclose ,
-.Fn dlsym
+.Fn dlsym ,
and
.Fn dlctl .
-If the named shared object has already
-been loaded by a previous call to
+If the named shared object has already been loaded by a previous call to
.Fn dlopen
.Pq and not yet unloaded by Fn dlclose ,
a handle referring to the resident copy is returned.
diff --git a/share/man/man3/end.3 b/share/man/man3/end.3
index 2c56714e6b7..c76f4be67b5 100644
--- a/share/man/man3/end.3
+++ b/share/man/man3/end.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: end.3,v 1.6 1999/07/09 13:35:37 aaron Exp $
+.\" $OpenBSD: end.3,v 1.7 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: end.3,v 1.5 1996/03/01 00:17:49 jtc Exp $
.\"
.\" Copyright (c) 1986
@@ -38,7 +38,9 @@
.Dt END 3
.Os
.Sh NAME
-.Nm end , etext , edata
+.Nm end ,
+.Nm etext ,
+.Nm edata
.Nd end boundaries of image segments
.Sh SYNOPSIS
.Vt extern end;
@@ -46,14 +48,12 @@
.Vt extern edata;
.Sh DESCRIPTION
The global variables
-.Va end , etext
+.Va end ,
+.Va etext ,
and
.Va edata
-correspond to
-the next address following
-the end of the text segment,
-the end of initialized data segment and
-the end of the data segment
+correspond to the next address following the end of the text segment,
+the end of initialized data segment, and the end of the data segment
.Pq Tn BSS .
.Sh SEE ALSO
.Xr brk 2 ,
diff --git a/share/man/man3/intro.3 b/share/man/man3/intro.3
index 228ac32c1df..74fbdc130c8 100644
--- a/share/man/man3/intro.3
+++ b/share/man/man3/intro.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: intro.3,v 1.9 2000/03/19 19:25:24 aaron Exp $
+.\" $OpenBSD: intro.3,v 1.10 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: intro.3,v 1.5 1995/05/10 22:46:24 jtc Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
@@ -41,9 +41,8 @@
.Nm intro
.Nd introduction to the C libraries
.Sh DESCRIPTION
-This section provides an overview of the C
-library functions, their error returns and other
-common definitions and concepts.
+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 .
Other libraries, such as the math library,
@@ -58,8 +57,7 @@ The various libraries (followed by the loader flag):
Standard C library functions.
When using the C compiler
.Xr cc 1 ,
-it is not necessary
-to supply the loader flag
+it is not necessary to supply the loader flag
.Fl l Ns Ar c
for these functions.
There are several
@@ -72,25 +70,27 @@ database routines,
bit operators,
string operators,
character tests and character operators,
-des encryption routines,
-storage allocation, time functions, signal handling and more.
+DES encryption routines,
+storage allocation,
+time functions,
+signal handling,
+and more.
.It libc_r Pq Fl l Ns Ar c_r
Reentrant C library.
Contains POSIX 1003.1c
.Xr pthreads 3
-API and thread scheduler, as well as all of the functions
-found in
+API and thread scheduler, as well as all of the functions found in
.Xr libc .
.It libcurses Pq Fl l Ns Ar curses
-Terminal independent screen management routines
-for two dimensional non-bitmap display terminals.
+Terminal independent screen management routines for two-dimensional
+non-bitmap display terminals.
See
.Xr curses 3 .
.It 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
+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.
@@ -109,7 +109,8 @@ The math library,
See
.Xr math 3 .
.It libtermcap Pq Fl l Ns Ar termcap
-The terminal independent operation library package. (See
+The terminal independent operation library package.
+(See
.Xr termcap 3 . )
.El
.Sh FILES
@@ -126,14 +127,14 @@ reentrant C library (see
4.3 compatibility library
.It Pa /usr/lib/libcrypto.a
.Xr ssl 8
-support library.
+support library
.It Pa /usr/lib/libcurses++.a
C++
.Xr curses 3
-library.
+library
.It Pa /usr/lib/libcurses.a
.Xr curses 3
-library.
+library
.It Pa /usr/lib/libdes.a
.It Pa /usr/lib/libedit.a
.It Pa /usr/lib/libfl.a
@@ -143,17 +144,17 @@ library.
.It Pa /usr/lib/libiberty.a
.It Pa /usr/lib/libkadm.a
.Xr kerberos 1
-support library.
+support library
.It Pa /usr/lib/libkafs.a
.Xr afsd 8
-support library.
+support library
.It Pa /usr/lib/libkdb.a
.It Pa /usr/lib/libkeycap.a
.It Pa /usr/lib/libkeynote.a
.It Pa /usr/lib/libkrb.a
.It Pa /usr/lib/libkvm.a
.Xr kvm 3
-kernel virtual memory access library.
+kernel virtual memory access library
.It Pa /usr/lib/libl.a
.It Pa /usr/lib/libm.a
.Xr math 3
@@ -194,21 +195,20 @@ The
.Xr resolver 3
routines are included in
.Em libc .
-For legacy applications,
-this library contains only those functions.
+For legacy applications, this library contains only those functions.
.It Pa /usr/lib/librpcsvc.a
-A library generated by
-.Xr rpcgen 1
+generated by
+.Xr rpcgen 1 ,
containing stub functions for many common
.Xr rpc 3
-protocols.
+protocols
.It Pa /usr/lib/libskey.a
-A support library for the
+support library for the
.Xr skey 1
-authentication toolkit.
+authentication toolkit
.It Pa /usr/lib/libssl.a
.Xr ssl 8
-support library.
+support library
.It Pa /usr/lib/libstdc++.a
.It Pa /usr/lib/libtelnet.a
.It Pa /usr/lib/libtermcap.a
@@ -222,8 +222,8 @@ support library.
.It Pa /usr/lib/libi386.a
.El
.Pp
-Must talk about shared libraries, _p profiled libraries and how to tell the
-C compiler to use them, and any other issues.
+.\" Must talk about shared libraries, _p profiled libraries, and how to tell the
+.\" C compiler to use them, and any other issues.
.Sh SEE ALSO
.Xr cc 1 ,
.Xr ld 1 ,
diff --git a/share/man/man3/queue.3 b/share/man/man3/queue.3
index 40f9450652d..5fba8ffb099 100644
--- a/share/man/man3/queue.3
+++ b/share/man/man3/queue.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: queue.3,v 1.11 2000/04/15 01:42:29 deraadt Exp $
+.\" $OpenBSD: queue.3,v 1.12 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: queue.3,v 1.4 1995/07/03 00:25:36 mycroft Exp $
.\"
.\" Copyright (c) 1993 The Regents of the University of California.
@@ -112,7 +112,7 @@
.Nd "implementations of singly-linked lists, doubly-linked lists, simple queues, tail queues, and circular queues"
.Sh SYNOPSIS
.Fd #include <sys/queue.h>
-.sp
+.Pp
.Fn SLIST_ENTRY "TYPE"
.Fn SLIST_HEAD "HEADNAME" "TYPE"
.Fn SLIST_HEAD_INITIALIZER "SLIST_HEAD head"
@@ -133,7 +133,7 @@
.Fn SLIST_INSERT_HEAD "SLIST_HEAD *head" "struct TYPE *elm" "SLIST_ENTRY NAME"
.Ft void
.Fn SLIST_REMOVE_HEAD "SLIST_HEAD *head" "SLIST_ENTRY NAME"
-.sp
+.Pp
.Fn LIST_ENTRY "TYPE"
.Fn LIST_HEAD "HEADNAME" "TYPE"
.Fn LIST_HEAD_INITIALIZER "LIST_HEAD head"
@@ -156,7 +156,7 @@
.Fn LIST_INSERT_HEAD "LIST_HEAD *head" "struct TYPE *elm" "LIST_ENTRY NAME"
.Ft void
.Fn LIST_REMOVE "struct TYPE *elm" "LIST_ENTRY NAME"
-.sp
+.Pp
.Fn SIMPLEQ_ENTRY "TYPE"
.Fn SIMPLEQ_HEAD "HEADNAME" "TYPE"
.Fn SIMPLEQ_HEAD_INITIALIZER "SIMPLEQ_HEAD head"
@@ -176,7 +176,7 @@
.Fn SIMPLEQ_INSERT_AFTER "struct TYPE *listelm" "struct TYPE *elm" "SIMPLEQ_ENTRY NAME"
.Ft void
.Fn SIMPLEQ_REMOVE_HEAD "SIMPLEQ_HEAD *head" "struct TYPE *elm" "SIMPLEQ_ENTRY NAME"
-.sp
+.Pp
.Fn TAILQ_ENTRY "TYPE"
.Fn TAILQ_HEAD "HEADNAME" "TYPE"
.Fn TAILQ_HEAD_INITIALIZER "TAILQ_HEAD head"
@@ -205,7 +205,7 @@
.Fn TAILQ_INSERT_TAIL "TAILQ_HEAD *head" "struct TYPE *elm" "TAILQ_ENTRY NAME"
.Ft void
.Fn TAILQ_REMOVE "TAILQ_HEAD *head" "struct TYPE *elm" "TAILQ_ENTRY NAME"
-.sp
+.Pp
.Fn CIRCLEQ_ENTRY "TYPE"
.Fn CIRCLEQ_HEAD "HEADNAME" "TYPE"
.Fn CIRCLEQ_HEAD_INITIALIZER "CIRCLEQ_HEAD head"
@@ -237,8 +237,7 @@
.Fn CIRCLEQ_REMOVE "CIRCLEQ_HEAD *head" "struct TYPE *elm" "CIRCLEQ_ENTRY NAME"
.Sh DESCRIPTION
These macros define and operate on five types of data structures:
-singly-linked lists, simple queues, lists, tail queues,
-and circular queues.
+singly-linked lists, simple queues, lists, tail queues, and circular queues.
All five structures support the following functionality:
.Pp
.Bl -enum -compact -offset indent
@@ -255,8 +254,7 @@ Forward traversal through the list.
Singly-linked lists are the simplest of the five data structures
and support only the above functionality.
Singly-linked lists are ideal for applications with large datasets
-and few or no removals,
-or for implementing a LIFO queue.
+and few or no removals, or for implementing a LIFO queue.
.Pp
Simple queues add the following functionality:
.Pp
@@ -343,14 +341,12 @@ Each head entry requires two pointers rather than one.
.It
The termination condition for traversal is more complex.
.It
-Code size is about 40% greater and operations run about 45% slower
-than lists.
+Code size is about 40% greater and operations run about 45% slower than lists.
.El
.Pp
In the macro definitions,
.Fa TYPE
-is the name tag of a user defined structure,
-that must contain a field of type
+is the name tag of a user defined structure that must contain a field of type
.Li SLIST_ENTRY ,
.Li LIST_ENTRY ,
.Li SIMPLEQ_ENTRY ,
@@ -369,14 +365,12 @@ using the macros
.Fn TAILQ_HEAD ,
or
.Fn CIRCLEQ_HEAD .
-See the examples below for further explanation of how these
-macros are used.
+See the examples below for further explanation of how these macros are used.
.Sh SINGLY_LINKED LISTS
A singly-linked list is headed by a structure defined by the
.Fn SLIST_HEAD
macro.
-This structure contains a single pointer to the first element
-on the list.
+This structure contains a single pointer to the first element on the list.
The elements are singly linked for minimum space and pointer manipulation
overhead at the expense of O(n) removal for arbitrary elements.
New elements can be added to the list after an existing element or
@@ -387,7 +381,7 @@ structure is declared as follows:
.Bd -literal -offset indent
SLIST_HEAD(HEADNAME, TYPE) head;
.Ed
-.sp
+.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and struct
@@ -397,13 +391,13 @@ A pointer to the head of the list can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
-.sp
+.Pp
(The names
.Li head
and
.Li headp
are user selectable.)
-.sp
+.Pp
The
.Fa HEADNAME
facility is often not used, leading to the following bizarre code:
@@ -413,8 +407,7 @@ SLIST_HEAD(, TYPE) head, *headp;
.Pp
The
.Fn SLIST_ENTRY
-macro declares a structure that connects the elements in
-the list.
+macro declares a structure that connects the elements in the list.
.Pp
The
.Fn SLIST_INIT
@@ -469,8 +462,7 @@ macro should be used to check whether a simple list is empty.
A list is headed by a structure defined by the
.Fn LIST_HEAD
macro.
-This structure contains a single pointer to the first element
-on the list.
+This structure contains a single pointer to the first element on the list.
The elements are doubly linked so that an arbitrary element can be
removed without traversing the list.
New elements can be added to the list after an existing element,
@@ -481,7 +473,7 @@ structure is declared as follows:
.Bd -literal -offset indent
LIST_HEAD(HEADNAME, TYPE) head;
.Ed
-.sp
+.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and struct
@@ -491,13 +483,13 @@ A pointer to the head of the list can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
-.sp
+.Pp
(The names
.Li head
and
.Li headp
are user selectable.)
-.sp
+.Pp
The
.Fa HEADNAME
facility is often not used, leading to the following bizarre code:
@@ -507,8 +499,7 @@ LIST_HEAD(, TYPE) head, *headp;
.Pp
The
.Fn LIST_ENTRY
-macro declares a structure that connects the elements in
-the list.
+macro declares a structure that connects the elements in the list.
.Pp
The
.Fn LIST_INIT
@@ -598,9 +589,8 @@ while (head.lh_first != NULL) /* Delete. */
A simple queue is headed by a structure defined by the
.Fn SIMPLEQ_HEAD
macro.
-This structure contains a pair of pointers,
-one to the first element in the simple queue and the other to
-the last element in the simple queue.
+This structure contains a pair of pointers, one to the first element in the
+simple queue and the other to the last element in the simple queue.
The elements are singly linked.
New elements can be added to the queue after an existing element,
at the head of the queue or at the tail of the queue.
@@ -610,7 +600,7 @@ structure is declared as follows:
.Bd -literal -offset indent
SIMPLEQ_HEAD(HEADNAME, TYPE) head;
.Ed
-.sp
+.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and struct
@@ -620,7 +610,7 @@ A pointer to the head of the queue can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
-.sp
+.Pp
(The names
.Li head
and
@@ -725,7 +715,7 @@ structure is declared as follows:
.Bd -literal -offset indent
TAILQ_HEAD(HEADNAME, TYPE) head;
.Ed
-.sp
+.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and struct
@@ -735,7 +725,7 @@ A pointer to the head of the tail queue can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
-.sp
+.Pp
(The names
.Li head
and
@@ -859,7 +849,7 @@ structure is declared as follows:
.Bd -literal -offset indent
CIRCLEQ_HEAD(HEADNAME, TYPE) head;
.Ed
-.sp
+.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and struct
@@ -869,7 +859,7 @@ A pointer to the head of the circular queue can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
-.sp
+.Pp
(The names
.Li head
and
@@ -878,8 +868,7 @@ are user selectable.)
.Pp
The
.Fn CIRCLEQ_ENTRY
-macro declares a structure that connects the elements in
-the circular queue.
+macro declares a structure that connects the elements in the circular queue.
.Pp
The
.Fn CIRCLEQ_INIT
diff --git a/share/man/man3/stdarg.3 b/share/man/man3/stdarg.3
index 45120f09e82..01c12b8be15 100644
--- a/share/man/man3/stdarg.3
+++ b/share/man/man3/stdarg.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: stdarg.3,v 1.6 2000/03/21 14:08:35 aaron Exp $
+.\" $OpenBSD: stdarg.3,v 1.7 2000/10/26 00:37:03 aaron Exp $
.\" $NetBSD: stdarg.3,v 1.3 1994/11/30 15:24:37 jtc Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
@@ -42,7 +42,9 @@
.Dt STDARG 3
.Os
.Sh NAME
-.Nm va_start , va_arg , va_end
+.Nm va_start ,
+.Nm va_arg ,
+.Nm va_end
.Nd variable argument lists
.Sh SYNOPSIS
.Fd #include <stdarg.h>
diff --git a/share/man/man3/sysexits.3 b/share/man/man3/sysexits.3
index 0d20193ef6c..c1c01732159 100644
--- a/share/man/man3/sysexits.3
+++ b/share/man/man3/sysexits.3
@@ -23,7 +23,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: sysexits.3,v 1.1 2000/04/26 16:01:09 millert Exp $
+.\" $OpenBSD: sysexits.3,v 1.2 2000/10/26 00:37:03 aaron Exp $
.\" $FreeBSD: src/share/man/man3/sysexits.3,v 1.4.2.1 1999/08/29 16:45:41 peter Exp $
.\"
.\" "
@@ -40,77 +40,80 @@ According to
.Xr style 9 ,
it is not a good practice to call
.Xr exit 3
-with arbitrary values to indicate a failure condition when ending
-a program. Instead, the pre-defined exit codes from
-.Nm sysexits
+with arbitrary values to indicate a failure condition when ending a program.
+Instead, the pre-defined exit codes from
+.Nm
should be used, so the caller of the process can get a rough
estimation about the failure class without looking up the source code.
.Pp
The successful exit is always indicated by a status of 0, or
-.Sy EX_OK .
+.Dv EX_OK .
Error numbers begin at
-.Sy EX__BASE
+.Dv EX__BASE
to reduce the possibility of clashing with other exit statuses that
-random programs may already return. The meaning of the codes is
-approximately as follows:
+random programs may already return.
+The meaning of the code is approximately as follows:
.Bl -tag -width "EX_UNAVAILABLEXX(XX)"
-.It Sy EX_USAGE Pq 64
+.It Dv EX_USAGE Pq 64
The command was used incorrectly, e.g., with the wrong number of
arguments, a bad flag, a bad syntax in a parameter, or whatever.
-.It Sy EX_DATAERR Pq 65
-The input data was incorrect in some way. This should only be used
-for user's data and not system files.
-.It Sy EX_NOINPUT Pq 66
+.It Dv EX_DATAERR Pq 65
+The input data was incorrect in some way.
+This should only be used for user's data and not system files.
+.It Dv EX_NOINPUT Pq 66
An input file (not a system file) did not exist or was not readable.
This could also include errors like
.Dq \&No message
to a mailer (if it cared to catch it).
-.It Sy EX_NOUSER Pq 67
-The user specified did not exist. This might be used for mail
-addresses or remote logins.
-.It Sy EX_NOHOST Pq 68
-The host specified did not exist. This is used in mail addresses or
-network requests.
-.It Sy EX_UNAVAILABLE Pq 69
-A service is unavailable. This can occur if a support program or file
-does not exist. This can also be used as a catchall message when
-something you wanted to do doesn't work, but you don't know why.
-.It Sy EX_SOFTWARE Pq 70
-An internal software error has been detected. This should be limited
-to non-operating system related errors as possible.
-.It Sy EX_OSERR Pq 71
-An operating system error has been detected. This is intended to be
-used for such things as
+.It Dv EX_NOUSER Pq 67
+The user specified did not exist.
+This might be used for mail addresses or remote logins.
+.It Dv EX_NOHOST Pq 68
+The host specified did not exist.
+This is used in mail addresses or network requests.
+.It Dv EX_UNAVAILABLE Pq 69
+A service is unavailable.
+This can occur if a support program or file does not exist.
+This can also be used as a catch-all message when something you wanted
+to do doesn't work, but you don't know why.
+.It Dv EX_SOFTWARE Pq 70
+An internal software error has been detected.
+This should be limited to non-operating system related errors if possible.
+.It Dv EX_OSERR Pq 71
+An operating system error has been detected.
+This is intended to be used for such things as
.Dq cannot fork ,
-.Dq cannot create pipe ,
-or the like. It includes things like getuid returning a user that
-does not exist in the passwd file.
-.It Sy EX_OSFILE Pq 72
+or
+.Dq cannot create pipe .
+It includes things like
+.Xr getuid 2
+returning a user that does not exist in the passwd file.
+.It Dv EX_OSFILE Pq 72
Some system file (e.g.,
.Pa /etc/passwd ,
.Pa /var/run/utmp ,
etc.) does not exist, cannot be opened, or has some sort of error
(e.g., syntax error).
-.It Sy EX_CANTCREAT Pq 73
+.It Dv EX_CANTCREAT Pq 73
A (user specified) output file cannot be created.
-.It Sy EX_IOERR Pq 74
+.It Dv EX_IOERR Pq 74
An error occurred while doing I/O on some file.
-.It Sy EX_TEMPFAIL Pq 75
+.It Dv EX_TEMPFAIL Pq 75
Temporary failure, indicating something that is not really an error.
In sendmail, this means that a mailer (e.g.) could not create a
connection, and the request should be reattempted later.
-.It Sy EX_PROTOCOL Pq 76
+.It Dv EX_PROTOCOL Pq 76
The remote system returned something that was
.Dq not possible
during a protocol exchange.
-.It Sy EX_NOPERM Pq 77
-You did not have sufficient permission to perform the operation. This
-is not intended for file system problems, which should use
-.Sy EX_NOINPUT
+.It Dv EX_NOPERM Pq 77
+You did not have sufficient permission to perform the operation.
+This is not intended for file system problems, which should use
+.Dv EX_NOINPUT
or
-.Sy EX_CANTCREAT ,
+.Dv EX_CANTCREAT ,
but rather for higher level permissions.
-.It Sy EX_CONFIG Pq 78
+.It Dv EX_CONFIG Pq 78
Something was found in an unconfigured or misconfigured state.
.El
.Pp
@@ -129,6 +132,6 @@ This man page has been written by
.ie t J\(:org Wunsch
.el Joerg Wunsch
after the comments in
-.Pa <sysexits.h> .
+.Aq Pa sysexits.h .
.Sh BUGS
The choice of an appropriate exit value is often ambiguous.
Copyright © 1996 – 2023 Jason A. Donenfeld. All Rights Reverse Engineered.