diff options
| author | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-06-29 14:10:33 +0000 |
|---|---|---|
| committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-06-29 14:10:33 +0000 |
| commit | 56f6529fc36c6db13ad6ff247464d6b0c9e0d023 (patch) | |
| tree | 370910d2e05f30a3e4f78b5160a518c3222aa9f9 /lib/libc/sys | |
| parent | 7e10459e58879c6c2e91c7f14687227390272c68 (diff) | |
- change references to nil to null; tschroed@acm.org
- remove trailing spaces from end of lines
- add some .Dv
- change -1 to \-1, so `-' is taken as a negative sign
- other misc formatting fixes
Diffstat (limited to 'lib/libc/sys')
111 files changed, 615 insertions, 573 deletions
diff --git a/lib/libc/sys/_exit.2 b/lib/libc/sys/_exit.2 index 49b7e76554a..17d464b0208 100644 --- a/lib/libc/sys/_exit.2 +++ b/lib/libc/sys/_exit.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: _exit.2,v 1.6 1999/06/29 03:09:55 deraadt Exp $ +.\" $OpenBSD: _exit.2,v 1.7 1999/06/29 14:09:48 aaron Exp $ .\" $NetBSD: _exit.2,v 1.6 1995/02/27 12:31:34 cgd Exp $ .\" .\" Copyright (c) 1980, 1993 @@ -52,8 +52,8 @@ terminates a process with the following consequences: .Bl -bullet .It All of the descriptors open in the calling process are closed. -This may entail delays, for example, waiting for output to drain; -a process in this state may not be killed, as it is already dying. +This may entail delays; for example, waiting for output to drain. +A process in this state may not be killed, as it is already dying. .It If the parent process of the calling process has an outstanding .Xr wait 2 @@ -62,12 +62,11 @@ or catches the .Dv SIGCHLD signal, it is notified of the calling process's termination and -the -.Em status +.Fa status is set as defined by .Xr wait 2 . .It -The parent process-ID of all of the calling process's existing child +The parent process ID of all of the calling process's existing child processes are set to 1; the initialization process (see the DEFINITIONS section of .Xr intro 2 ) @@ -75,16 +74,16 @@ inherits each of these processes. .It If the termination of the process causes any process group to become orphaned (usually because the parents of all members -of the group have now exited; see -.Dq orphaned process group +of the group have now exited, see +.Dq Orphaned Process Group in .Xr intro 2 ) , and if any member of the orphaned group is stopped, the .Dv SIGHUP -signal and the +and .Dv SIGCONT -signal are sent to all members of the newly orphaned process group. +signals are sent to all members of the newly orphaned process group. .It If the process is a controlling process (see .Xr intro 2 ) , @@ -109,6 +108,6 @@ can never return. .Xr exit 3 .Sh STANDARDS The -.Nm _exit +.Fn _exit function is defined by .St -p1003.1-88 . diff --git a/lib/libc/sys/accept.2 b/lib/libc/sys/accept.2 index f600ef7d897..62c45de5d4e 100644 --- a/lib/libc/sys/accept.2 +++ b/lib/libc/sys/accept.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: accept.2,v 1.7 1999/06/29 00:36:06 aaron Exp $ +.\" $OpenBSD: accept.2,v 1.8 1999/06/29 14:09:49 aaron Exp $ .\" $NetBSD: accept.2,v 1.7 1996/01/31 20:14:42 mycroft Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 @@ -59,7 +59,7 @@ The argument extracts the first connection request on the queue of pending connections, creates -a new socket with the same properties of +a new socket with the same properties of .Fa s and allocates a new file descriptor for the socket. If no pending connections are @@ -68,7 +68,7 @@ as non-blocking, .Fn accept blocks the caller until a connection is present. If the socket is marked non-blocking and no pending -connections are present on the queue, +connections are present on the queue, .Fn accept returns an error as described below. The accepted socket @@ -86,7 +86,7 @@ The exact format of the .Fa addr parameter is determined by the domain in which the communication is occurring. -The +The .Fa addrlen is a value-result parameter; it should initially contain the amount of space pointed to by @@ -95,7 +95,7 @@ on return it will contain the actual length (in bytes) of the address returned. This call is used with connection-based socket types, currently with -.Dv SOCK_STREAM . +.Dv SOCK_STREAM . .Pp It is possible to .Xr select 2 @@ -117,7 +117,7 @@ file descriptor, and rejection can be implied by closing the new socket. .Pp One can obtain user connection request data without confirming -the connection by issuing a +the connection by issuing a .Xr recvmsg 2 call with an .Fa msg_iovlen @@ -146,7 +146,7 @@ The descriptor is invalid. The descriptor references a file, not a socket. .It Bq Er EOPNOTSUPP The referenced socket is not of type -.Dv SOCK_STREAM . +.Dv SOCK_STREAM . .It Bq Er EINVAL The referenced socket is not listening for connections (that is, .Xr listen 2 @@ -174,5 +174,5 @@ The system file table is full. .Sh HISTORY The .Fn accept -function appeared in +function appeared in .Bx 4.2 . diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2 index 4f774189ce5..7f92ae7f7a7 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: access.2,v 1.6 1999/06/05 04:47:41 aaron Exp $ +.\" $OpenBSD: access.2,v 1.7 1999/06/29 14:09:49 aaron Exp $ .\" $NetBSD: access.2,v 1.7 1995/02/27 12:31:44 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -85,7 +85,7 @@ and If .Fa path cannot be found or if any of the desired access modes would -not be granted, then a -1 value is returned; otherwise +not be granted, then a \-1 value is returned; otherwise a 0 value is returned. .Sh ERRORS Access to the file is denied if: @@ -93,9 +93,9 @@ Access to the file is denied if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -131,7 +131,7 @@ An invalid value was specified for .Sh STANDARDS The .Fn access -function conforms to +function conforms to .St -p1003.1-90 . .Sh CAVEAT .Fn access diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index 9d88c345bc2..ed38f8834e5 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: acct.2,v 1.4 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: acct.2,v 1.5 1999/06/29 14:09:49 aaron Exp $ .\" $NetBSD: acct.2,v 1.6 1995/02/27 12:31:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -49,14 +49,15 @@ The .Fn acct call enables or disables the collection of system accounting records. -If the argument +If .Fa file -is a nil pointer, accounting is disabled. +is +.Dv NULL , +accounting is disabled. If .Fa file -is an -.Em existing -pathname (null-terminated), record collection is enabled and for +is an existing, +null-terminated pathname, record collection is enabled and for every process initiated which terminates under normal conditions an accounting record is appended to .Fa file . @@ -79,7 +80,7 @@ Accounting is automatically disabled when the file system the accounting file resides on runs out of space; it is enabled when space once again becomes available. .Sh RETURN VALUES -On error -1 is returned. +On error \-1 is returned. The file must exist and the call may be exercised only by the super-user. .Sh ERRORS .Fn acct @@ -90,9 +91,9 @@ The caller is not the super-user. .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -116,5 +117,5 @@ An I/O error occurred while reading from or writing to the file system. .Sh HISTORY An .Fn acct -function call appeared in +function call appeared in .At v7 . diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2 index 03f68525080..70b278a24f0 100644 --- a/lib/libc/sys/adjtime.2 +++ b/lib/libc/sys/adjtime.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: adjtime.2,v 1.7 1999/06/06 19:15:04 deraadt Exp $ +.\" $OpenBSD: adjtime.2,v 1.8 1999/06/29 14:09:50 aaron Exp $ .\" $NetBSD: adjtime.2,v 1.5 1995/10/12 15:40:44 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -70,7 +70,7 @@ may not be finished when is called again. If .Fa olddelta -is non-nil, +is non-null, the structure pointed to will contain, upon return, the number of microseconds still to be corrected from the earlier call. @@ -80,12 +80,12 @@ of computers in a local area network. Such time servers would slow down the clocks of some machines and speed up the clocks of others to bring them to the average network time. .Pp -The call +The call .Fn adjtime is restricted to the super-user. .Sh RETURN VALUES A return value of 0 indicates that the call succeeded. -A return value of -1 indicates that an error occurred, and in this +A return value of \-1 indicates that an error occurred, and in this case an error code is stored in the global variable .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index 479f136fc19..ad560bc51d8 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bind.2,v 1.7 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: bind.2,v 1.8 1999/06/29 14:09:50 aaron Exp $ .\" $NetBSD: bind.2,v 1.8 1995/10/12 15:40:46 jtc Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -48,7 +48,7 @@ .Sh DESCRIPTION .Fn bind assigns a name to an unnamed socket. -When a socket is created +When a socket is created with .Xr socket 2 it exists in a name space (address family) @@ -67,7 +67,7 @@ The rules used in name binding vary between communication domains. Consult the manual entries in section 4 for detailed information. .Sh RETURN VALUES If the bind is successful, a 0 value is returned. -A return value of -1 indicates an error, which is +A return value of \-1 indicates an error, which is further specified in the global .Va errno . .Sh ERRORS @@ -102,9 +102,9 @@ The following errors are specific to binding names in the UNIX domain. .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2 index 32748bbcd12..d94beef6100 100644 --- a/lib/libc/sys/brk.2 +++ b/lib/libc/sys/brk.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: brk.2,v 1.8 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: brk.2,v 1.9 1999/06/29 14:09:50 aaron Exp $ .\" $NetBSD: brk.2,v 1.7 1995/02/27 12:31:57 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -49,7 +49,11 @@ .Fn sbrk "int incr" .Sh DESCRIPTION .Bf -symbolic -The brk and sbrk functions are historical curiosities +The +.Fn brk +and +.Fn sbrk +functions are historical curiosities left over from earlier days before the advent of virtual memory management. .Ef The @@ -63,7 +67,7 @@ Data addressing is restricted between .Fa addr and the lowest stack pointer to the stack segment. Memory is allocated by -.Fa brk +.Fn brk in page size pieces; if .Fa addr @@ -85,7 +89,7 @@ increased to the next page boundary. .\" .Pp The current value of the program break is reliably returned by .Dq Li sbrk(0) -(see also +(see also .Xr end 3 ) . The .Xr getrlimit 2 @@ -105,19 +109,19 @@ e.g. for the definition of .Em etext ) . .Sh RETURN VALUES -.Nm brk +.Fn brk returns a pointer to the new end of memory if successful; -otherwise -1 with +otherwise \-1 with .Va errno set to indicate why the allocation failed. The -.Nm sbrk +.Fn sbrk function returns a pointer to the base of the new storage if successful; -otherwise -1 with +otherwise \-1 with .Va errno set to indicate why the allocation failed. .Sh ERRORS -.Nm sbrk +.Fn sbrk will fail and no additional memory will be allocated if one of the following are true: .Bl -tag -width Er @@ -142,10 +146,10 @@ to support the expansion. Setting the break may fail due to a temporary lack of swap space. It is not possible to distinguish this from a failure caused by exceeding the maximum size of -the data segment without consulting +the data segment without consulting .Xr getrlimit . .Sh HISTORY A .Fn brk -function call appeared in +function call appeared in .At v7 . diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index 9fd77dccc56..7fc397c01f9 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chdir.2,v 1.4 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: chdir.2,v 1.5 1999/06/29 14:09:51 aaron Exp $ .\" $NetBSD: chdir.2,v 1.7 1995/02/27 12:32:00 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -74,7 +74,7 @@ In order for a directory to become the current directory, a process must have execute (search) access to the directory. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. @@ -86,9 +86,9 @@ one or more of the following are true: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -122,9 +122,9 @@ is not a valid file descriptor. .Sh SEE ALSO .Xr chroot 2 .Sh STANDARDS -The +The .Fn chdir -is expected to conform to +is expected to conform to .St -p1003.1-88 . .Sh HISTORY The diff --git a/lib/libc/sys/chflags.2 b/lib/libc/sys/chflags.2 index fcd8f03cb9d..a7f5992f5dc 100644 --- a/lib/libc/sys/chflags.2 +++ b/lib/libc/sys/chflags.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chflags.2,v 1.11 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: chflags.2,v 1.12 1999/06/29 14:09:51 aaron Exp $ .\" $NetBSD: chflags.2,v 1.6 1995/02/27 12:32:03 cgd Exp $ .\" .\" Copyright (c) 1989, 1993 @@ -94,7 +94,7 @@ the system is in single-user mode. for details.) .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -104,9 +104,9 @@ will fail it: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index 6d723dff54d..c9188372db0 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chmod.2,v 1.7 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: chmod.2,v 1.8 1999/06/29 14:09:51 aaron Exp $ .\" $NetBSD: chmod.2,v 1.7 1995/02/27 12:32:06 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -124,7 +124,7 @@ from remaining set-user-id (set-group-id) if they are modified, at the expense of a degree of compatibility. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -134,9 +134,9 @@ will fail and the file mode will be unchanged if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -185,7 +185,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn chmod -function is expected to conform to +function is expected to conform to .St -p1003.1-88 . .Sh HISTORY The diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index 95a4234f39e..4776492fc03 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chown.2,v 1.6 1999/06/05 04:16:07 aaron Exp $ +.\" $OpenBSD: chown.2,v 1.7 1999/06/29 14:09:52 aaron Exp $ .\" $NetBSD: chown.2,v 1.10 1995/10/12 15:40:47 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -59,7 +59,7 @@ or referenced by .Fa fd is changed as specified by the arguments .Fa owner -and +and .Fa group . The owner of a file may change the .Fa group @@ -102,9 +102,9 @@ will fail and the file or link will be unchanged if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -148,7 +148,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn chown -function is expected to conform to +function is expected to conform to .St -p1003.1-88 . .Sh HISTORY The diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index cce45f656a2..7d58de52ef2 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chroot.2,v 1.7 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: chroot.2,v 1.8 1999/06/29 14:09:52 aaron Exp $ .\" $NetBSD: chroot.2,v 1.7 1995/02/27 12:32:12 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -46,7 +46,9 @@ .Fn chroot "const char *dirname" .Sh DESCRIPTION .Fa dirname -is the address of the pathname of a directory, terminated by an ASCII NUL. +is the address of the pathname of a directory, terminated by an +.Tn ASCII +NUL. .Fn chroot causes .Fa dirname @@ -71,7 +73,7 @@ tree than the altered root directory. This call is restricted to the super-user. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. Otherwise, -a value of -1 is returned and +a value of \-1 is returned and .Va errno is set to indicate an error. .Sh ERRORS @@ -81,9 +83,9 @@ will fail and the root directory will be unchanged if: .It Bq Er ENOTDIR A component of the path name is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2 index 8ba27046e2d..37a3eccc052 100644 --- a/lib/libc/sys/clock_gettime.2 +++ b/lib/libc/sys/clock_gettime.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: clock_gettime.2,v 1.6 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: clock_gettime.2,v 1.7 1999/06/29 14:09:52 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -57,15 +57,19 @@ which is specifed by .Fa clock_id . .Pp .Fa clock_id -can be one of three values: CLOCK_REALTIME for time that increments as -a wall clock should, CLOCK_VIRTUAL for time that increments only when +can be one of three values: +.Dv CLOCK_REALTIME +for time that increments as +a wall clock should, +.Dv CLOCK_VIRTUAL +for time that increments only when the CPU is running in user mode on behalf of the calling process, or -CLOCK_PROF for time that increments when the CPU is running in user or -kernel mode. +.Dv CLOCK_PROF +for time that increments when the CPU is running in user or kernel mode. .Pp The structure pointed to by .Fa tp -is defined in +is defined in .Ao Pa sys/time.h Ac as: .Pp @@ -88,11 +92,11 @@ system call even when the system is secure. .Pp The resolution (granularity) of a clock is returned by the .Fn clock_getres -call. This value is placed in a (non-NULL) +call. This value is placed in a (non-null) .Fa *tp . .Sh RETURN A 0 return value indicates that the call succeeded. -A -1 return value indicates an error occurred, and in this +A \-1 return value indicates an error occurred, and in this case an error code is stored into the global variable .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 5943bea2552..8a3295ab47c 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: close.2,v 1.7 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: close.2,v 1.8 1999/06/29 14:09:53 aaron Exp $ .\" $NetBSD: close.2,v 1.5 1995/02/27 12:32:14 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -64,7 +64,7 @@ the lock is released. However, the semantics of System V and dictate that all .Xr fcntl 2 advisory record locks associated with a file for a given process -are removed when +are removed when .Em any file descriptor for that file is closed by that process (see further @@ -103,7 +103,7 @@ restores the default, which is to not close the descriptor. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and the global integer variable +Otherwise, a value of \-1 is returned and the global integer variable .Va errno is set to indicate the error. .Sh ERRORS @@ -127,5 +127,5 @@ An interrupt was received. .Xr socketpair 2 .Sh STANDARDS .Fn close -conforms to +conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/connect.2 b/lib/libc/sys/connect.2 index bbe9da104a3..092b464ad60 100644 --- a/lib/libc/sys/connect.2 +++ b/lib/libc/sys/connect.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: connect.2,v 1.12 1999/05/23 14:10:50 aaron Exp $ +.\" $OpenBSD: connect.2,v 1.13 1999/06/29 14:09:53 aaron Exp $ .\" $NetBSD: connect.2,v 1.8 1995/10/12 15:40:48 jtc Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -73,7 +73,7 @@ Datagram sockets may dissolve the association by connecting to an invalid address, such as a null address. .Sh RETURN VALUES If the connection or binding succeeds, 0 is returned. -Otherwise a -1 is returned, and a more specific error +Otherwise a \-1 is returned, and a more specific error code is stored in .Va errno . .Sh ERRORS @@ -113,7 +113,7 @@ The parameter specifies an area outside the process address space. .It Bq Er EINPROGRESS -The socket is non-blocking +The socket is non-blocking and the connection cannot be completed immediately. It is possible to @@ -135,9 +135,9 @@ These errors may not apply in future versions of the UNIX IPC domain. .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index 5bd878a28fa..6b7a4842637 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: dup.2,v 1.6 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: dup.2,v 1.7 1999/06/29 14:09:53 aaron Exp $ .\" $NetBSD: dup.2,v 1.4 1995/02/27 12:32:21 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -90,7 +90,7 @@ additional call. The close-on-exec flag on the new file descriptor is unset. .Pp -In +In .Fn dup2 , the value of the new descriptor .Fa newd @@ -99,7 +99,7 @@ in use, the descriptor is first deallocated as if a .Xr close 2 call had been done first. .Sh RETURN VALUES -The value -1 is returned if an error occurs in either call. +The value \-1 is returned if an error occurs in either call. The external variable .Va errno indicates the cause of the error. @@ -130,5 +130,5 @@ Too many descriptors are active. .Fn dup and .Fn dup2 -are expected to conform to +are expected to conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index 326a7e9e829..409424661d2 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: execve.2,v 1.10 1999/05/25 13:06:46 aaron Exp $ +.\" $OpenBSD: execve.2,v 1.11 1999/06/29 14:09:54 aaron Exp $ .\" $NetBSD: execve.2,v 1.9 1995/02/27 12:32:25 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -193,13 +193,13 @@ to the arguments themselves. .Sh RETURN VALUES As the .Fn execve -function overlays the current process image +function overlays the current process image with a new process image the successful call has no process to return to. If .Fn execve does return to the calling process an error has occurred; the -return value will be -1 and the global variable +return value will be \-1 and the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -209,9 +209,9 @@ will fail and return to the calling process if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index 7900869ca68..c73778a570c 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fcntl.2,v 1.13 1999/05/25 22:38:01 aaron Exp $ +.\" $OpenBSD: fcntl.2,v 1.14 1999/06/29 14:09:54 aaron Exp $ .\" $NetBSD: fcntl.2,v 1.6 1995/02/27 12:32:29 cgd Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -139,7 +139,7 @@ process groups are specified by supplying .Fa arg (interpreted as an .Fa int ) -as negative, otherwise +as negative, otherwise .Fa arg is taken as a process ID. .El @@ -158,7 +158,7 @@ if no data is available to a call, or if a .Xr write 2 operation would block, -the read or write call returns -1 with the error +the read or write call returns \-1 with the error .Er EAGAIN . .It Dv O_APPEND Force each write to append at the end of file; @@ -326,7 +326,7 @@ For example if an application for updating the password file locks the password file database while making the update, and then calls .Xr getpwname 3 to retrieve a record, -the lock will be lost because +the lock will be lost because .Xr getpwname 3 opens, reads, and closes the password database. The database close will release all locks that the process has @@ -344,9 +344,9 @@ allows locks to be inherited by child processes. is recommended for applications that want to ensure the integrity of their locks when using library routines or wish to pass locks to their children. -Note that +Note that .Xr flock 2 -and +and .Xr fcntl 2 locks may be safely used concurrently. .Pp @@ -373,10 +373,10 @@ Value of flags. .It Dv F_GETOWN Value of file descriptor owner. .It other -Value other than -1. +Value other than \-1. .El .Pp -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index cb8f6719256..e59e47e46a3 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: flock.2,v 1.10 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: flock.2,v 1.11 1999/06/29 14:09:54 aaron Exp $ .\" $NetBSD: flock.2,v 1.5 1995/02/27 12:32:32 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -82,7 +82,7 @@ locks and locks. At any time multiple shared locks may be applied to a file, but at no time are multiple exclusive, or both shared and exclusive, -locks allowed simultaneously on a file. +locks allowed simultaneously on a file. .Pp A shared lock may be .Em upgraded @@ -115,7 +115,7 @@ lose its lock. Processes blocked awaiting a lock may be awakened by signals. .Sh RETURN VALUES Zero is returned if the operation was successful; -on an error a -1 is returned and an error code is left in +on an error a \-1 is returned and an error code is left in the global location .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2 index 6d3b9b3b43a..f19dc2d3458 100644 --- a/lib/libc/sys/fork.2 +++ b/lib/libc/sys/fork.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fork.2,v 1.8 1999/06/06 06:57:53 pjanzen Exp $ +.\" $OpenBSD: fork.2,v 1.9 1999/06/29 14:09:55 aaron Exp $ .\" $NetBSD: fork.2,v 1.6 1995/02/27 12:32:36 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -80,7 +80,7 @@ Upon successful completion, .Fn fork returns a value of 0 to the child process and returns the process ID of the child -process to the parent process. Otherwise, a value of -1 is returned +process to the parent process. Otherwise, a value of \-1 is returned to the parent process, no child process is created, and the global variable .Va errno diff --git a/lib/libc/sys/fsync.2 b/lib/libc/sys/fsync.2 index e31ef3db2ce..e910c1e5909 100644 --- a/lib/libc/sys/fsync.2 +++ b/lib/libc/sys/fsync.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fsync.2,v 1.4 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: fsync.2,v 1.5 1999/06/29 14:09:55 aaron Exp $ .\" $NetBSD: fsync.2,v 1.4 1995/02/27 12:32:38 cgd Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -57,7 +57,7 @@ should be used by programs that require a file to be in a known state, for example, in building a simple transaction facility. .Sh RETURN VALUES -A 0 value is returned on success. A -1 value indicates +A 0 value is returned on success. A \-1 value indicates an error. .Sh ERRORS The diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index 60e3b28abc5..5dc21d9bd87 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getdirentries.2,v 1.7 1999/05/16 19:55:25 alex Exp $ +.\" $OpenBSD: getdirentries.2,v 1.8 1999/06/29 14:09:55 aaron Exp $ .\" $NetBSD: getdirentries.2,v 1.7 1995/10/12 15:40:50 jtc Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -87,7 +87,7 @@ The entry is the length, in bytes, of the directory record. The .Fa d_name -entry contains a null terminated file name. +entry contains a null-terminated file name. The .Fa d_namlen entry specifies the length of the file name excluding the null byte. @@ -125,7 +125,7 @@ a value returned in the location pointed to by or zero. .Sh RETURN VALUES If successful, the number of bytes actually transferred is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2 index 3cfb75e009e..34a6c53b15d 100644 --- a/lib/libc/sys/getfh.2 +++ b/lib/libc/sys/getfh.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getfh.2,v 1.5 1999/02/27 21:56:17 deraadt Exp $ +.\" $OpenBSD: getfh.2,v 1.6 1999/06/29 14:09:56 aaron Exp $ .\" $NetBSD: getfh.2,v 1.7 1995/10/12 15:40:53 jtc Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -53,7 +53,7 @@ in the file handle pointed to by This system call is restricted to the superuser. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -67,12 +67,12 @@ is not a directory. .It Bq ENAMETOOLONG The length of a component of .Fa path -exceeds +exceeds .Dv {NAME_MAX} characters, or the length of .Fa path -exceeds -.Dv {PATH_MAX} +exceeds +.Dv {PATH_MAX} characters. .It Bq ENOENT The file referred to by diff --git a/lib/libc/sys/getfsstat.2 b/lib/libc/sys/getfsstat.2 index 14af7552c33..dc241f9764d 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getfsstat.2,v 1.9 1999/06/01 15:32:53 millert Exp $ +.\" $OpenBSD: getfsstat.2,v 1.10 1999/06/29 14:09:58 aaron Exp $ .\" $NetBSD: getfsstat.2,v 1.6 1995/06/29 11:40:44 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -87,7 +87,8 @@ up to the size specified by .Pp If .Fa buf -is given as NULL, +is +.Dv NULL , .Fn getfsstat returns just the number of mounted file systems. .Pp @@ -107,10 +108,10 @@ Thus, some of the information will be out of date, but will not block waiting for information from a file system that is unable to respond. .Sh RETURN VALUES -Upon successful completion, the number of +Upon successful completion, the number of .Fa statfs structures is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/getgid.2 b/lib/libc/sys/getgid.2 index 260ccbb0690..1c6b6ff47c5 100644 --- a/lib/libc/sys/getgid.2 +++ b/lib/libc/sys/getgid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getgid.2,v 1.7 1999/05/27 13:17:28 aaron Exp $ +.\" $OpenBSD: getgid.2,v 1.8 1999/06/29 14:09:58 aaron Exp $ .\" $NetBSD: getgid.2,v 1.5 1995/02/27 12:32:53 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -80,5 +80,5 @@ The .Fn getgid and .Fn getegid -functions conform to +functions conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index b92acdd8a69..713515f4222 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getgroups.2,v 1.5 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: getgroups.2,v 1.6 1999/06/29 14:09:59 aaron Exp $ .\" $NetBSD: getgroups.2,v 1.8 1995/02/27 12:32:57 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -48,11 +48,11 @@ .Sh DESCRIPTION .Fn getgroups gets the current group access list of the current user process -and stores it in the array +and stores it in the array .Fa gidset . The parameter .Fa gidsetlen -indicates the number of entries that may be placed in +indicates the number of entries that may be placed in .Fa gidset . .Fn getgroups returns the actual number of groups returned in @@ -63,14 +63,14 @@ will ever be returned. If .Fa gidsetlen -is 0, +is 0, .Fn getgroups returns the number of groups without modifying the .Fa gidset array. .Sh RETURN VALUES A successful call returns the number of groups in the group set. -A value of -1 indicates that an error occurred, and the error +A value of \-1 indicates that an error occurred, and the error code is stored in the global variable .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index 769560a0dc7..5fb623abb5d 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getitimer.2,v 1.9 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: getitimer.2,v 1.10 1999/06/29 14:09:59 aaron Exp $ .\" $NetBSD: getitimer.2,v 1.6 1995/10/12 15:40:54 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -67,9 +67,9 @@ call sets a timer to the specified .Fa value (returning the previous value of the timer if .Fa ovalue -is non-nil). +is non-null). .Pp -A timer value is defined by the +A timer value is defined by the .Fa itimerval structure: .Bd -literal -offset indent @@ -81,15 +81,15 @@ struct itimerval { .Pp If .Fa it_value -is non-zero, it indicates the time to the next timer expiration. +is non-zero, it indicates the time to the next timer expiration. If .Fa it_interval -is non-zero, it specifies a value to be used in reloading +is non-zero, it specifies a value to be used in reloading .Fa it_value when the timer expires. -Setting +Setting .Fa it_value -to 0 disables a timer. Setting +to 0 disables a timer. Setting .Fa it_interval to 0 causes a timer to be disabled after its next expiration (assuming .Fa it_value @@ -158,7 +158,7 @@ Adds two timers and stores the result in .Pp .Sh RETURN VALUES If the calls succeed, a value of 0 is returned. If an error occurs, -the value -1 is returned, and a more precise error code is placed +the value \-1 is returned, and a more precise error code is placed in the global variable .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2 index e784800551f..ea6e7f81e8c 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getlogin.2,v 1.6 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: getlogin.2,v 1.7 1999/06/29 14:09:59 aaron Exp $ .\" $NetBSD: getlogin.2,v 1.4 1995/02/27 12:33:03 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -79,7 +79,7 @@ If a call to .Fn setlogin succeeds, a value of 0 is returned. If .Fn setlogin -fails, a value of -1 is returned and an error code is +fails, a value of \-1 is returned and an error code is placed in the global location .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index 30c628d5792..7ce4aea75fd 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpeername.2,v 1.9 1999/05/23 14:10:51 aaron Exp $ +.\" $OpenBSD: getpeername.2,v 1.10 1999/06/29 14:10:00 aaron Exp $ .\" $NetBSD: getpeername.2,v 1.6 1995/10/12 15:40:56 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -59,7 +59,7 @@ On return it contains the actual size of the name returned (in bytes). The name is truncated if the buffer provided is too small. .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +A 0 is returned if the call succeeds, \-1 if it fails. .Sh ERRORS The call succeeds unless: .Bl -tag -width Er @@ -77,7 +77,7 @@ The socket is not connected. Insufficient resources were available in the system to perform the operation. .It Bq Er EFAULT -The +The .Fa name parameter points to memory not in a valid part of the process address space. diff --git a/lib/libc/sys/getpid.2 b/lib/libc/sys/getpid.2 index 411f0c518d1..7b52243ac82 100644 --- a/lib/libc/sys/getpid.2 +++ b/lib/libc/sys/getpid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpid.2,v 1.5 1999/05/23 14:10:52 aaron Exp $ +.\" $OpenBSD: getpid.2,v 1.6 1999/06/29 14:10:00 aaron Exp $ .\" $NetBSD: getpid.2,v 1.5 1995/02/27 12:33:12 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -58,7 +58,7 @@ useful for constructing temporary file names. .Pp .Fn getppid returns the process ID of the parent -of the calling process. +of the calling process. .Sh ERRORS The .Fn getpid @@ -72,5 +72,5 @@ indicate an error. .Fn getpid and .Fn getppid -conform to +conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index f2c4619296e..5a65f742761 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpriority.2,v 1.4 1999/05/23 14:10:52 aaron Exp $ +.\" $OpenBSD: getpriority.2,v 1.5 1999/06/29 14:10:00 aaron Exp $ .\" $NetBSD: getpriority.2,v 1.4 1995/02/27 12:33:15 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -65,9 +65,9 @@ is one of .Dv PRIO_PGRP , or .Dv PRIO_USER , -and +and .Fa who -is interpreted relative to +is interpreted relative to .Fa which (a process identifier for .Dv PRIO_PROCESS , @@ -80,7 +80,7 @@ A zero value of .Fa who denotes the current process, process group, or user. .Fa prio -is a value in the range -20 to 20. The default priority is 0; +is a value in the range \-20 to 20. The default priority is 0; lower priorities cause more favorable scheduling. .Pp The @@ -93,16 +93,16 @@ to the specified value. Only the super-user may lower priorities. .Sh RETURN VALUES Since .Fn getpriority -can legitimately return the value -1, it is necessary +can legitimately return the value \-1, it is necessary to clear the external variable .Va errno prior to the call, then check it afterward to determine -if a -1 is an error or a legitimate value. +if a \-1 is an error or a legitimate value. The .Fn setpriority call returns 0 if there is no error, or --1 if there is. +\-1 if there is. .Sh ERRORS .Fn getpriority and @@ -110,7 +110,7 @@ and will fail if: .Bl -tag -width Er .It Bq Er ESRCH -No process was located using the +No process was located using the .Fa which and .Fa who diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index 6b65cbebbe0..13f40e9657b 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getrlimit.2,v 1.8 1999/05/23 14:10:52 aaron Exp $ +.\" $OpenBSD: getrlimit.2,v 1.9 1999/06/29 14:10:00 aaron Exp $ .\" $NetBSD: getrlimit.2,v 1.8 1995/10/12 15:40:58 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -55,7 +55,7 @@ and each process it creates may be obtained with the .Fn getrlimit call, and set with the .Fn setrlimit -call. +call. .Pp The .Fa resource @@ -100,7 +100,7 @@ A resource limit is specified as a soft limit and a hard limit. When a soft limit is exceeded a process may receive a signal (for example, if the cpu time or file size is exceeded), but it will be allowed to continue execution until it reaches the hard limit (or modifies -its resource limit). The +its resource limit). The .Em rlimit structure is used to specify the hard and soft limits on a resource, .Bd -literal -offset indent @@ -111,9 +111,9 @@ struct rlimit { .Ed .Pp Only the super-user may raise the maximum limits. Other users -may only alter +may only alter .Fa rlim_cur -within the range from 0 to +within the range from 0 to .Fa rlim_max or (irreversibly) lower .Fa rlim_max . @@ -157,7 +157,7 @@ is sent to the offending process. .Sh RETURN VALUES A 0 return value indicates that the call succeeded, changing -or returning the resource limit. A return value of -1 indicates +or returning the resource limit. A return value of \-1 indicates that an error occurred, and an error code is stored in the global location .Va errno . diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index f73268ec3cf..627df5928c7 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getrusage.2,v 1.5 1999/05/23 14:10:53 aaron Exp $ +.\" $OpenBSD: getrusage.2,v 1.6 1999/06/29 14:10:01 aaron Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -133,16 +133,16 @@ priority process becoming runnable or because the current process exceeded its time slice. .El .Sh NOTES -The numbers +The numbers .Fa ru_inblock -and +and .Fa ru_oublock account only for real I/O; data supplied by the caching mechanism is charged only to the first process to read or write the data. .Sh ERRORS .Fn getrusage -returns -1 on error. +returns \-1 on error. The possible errors are: .Bl -tag -width Er .It Bq Er EINVAL diff --git a/lib/libc/sys/getsid.2 b/lib/libc/sys/getsid.2 index 37799c50400..2986bc62904 100644 --- a/lib/libc/sys/getsid.2 +++ b/lib/libc/sys/getsid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsid.2,v 1.4 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: getsid.2,v 1.5 1999/06/29 14:10:01 aaron Exp $ .\" .\" Copyright (c) 1997 Peter Wemm <peter@freebsd.org> .\" @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $Id: getsid.2,v 1.4 1999/05/23 14:10:54 aaron Exp $ +.\" $Id: getsid.2,v 1.5 1999/06/29 14:10:01 aaron Exp $ .\" .Dd August 19, 1997 .Dt GETSID 2 @@ -49,7 +49,7 @@ returns the session ID of the current process. Upon successful completion, the function .Fn getsid returns the session ID of -the specified process; otherwise, it returns a value of -1 and +the specified process; otherwise, it returns a value of \-1 and sets errno to indicate an error. .Sh ERRORS .Fn getsid diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index d5c93166ab4..229cd0a437f 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsockname.2,v 1.9 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: getsockname.2,v 1.10 1999/06/29 14:10:02 aaron Exp $ .\" $NetBSD: getsockname.2,v 1.6 1995/10/12 15:41:00 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -47,7 +47,7 @@ .Fn getsockname "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh DESCRIPTION .Fn getsockname -returns the current +returns the current .Fa name for the specified socket. The .Fa namelen @@ -57,7 +57,7 @@ the amount of space pointed to by On return it contains the actual size of the name returned (in bytes). .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +A 0 is returned if the call succeeds, \-1 if it fails. .Sh ERRORS The call succeeds unless: .Bl -tag -width Er @@ -73,7 +73,7 @@ is a file, not a socket. Insufficient resources were available in the system to perform the operation. .It Bq Er EFAULT -The +The .Fa name parameter points to memory not in a valid part of the process address space. diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 108e5372a83..90941242e15 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsockopt.2,v 1.10 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: getsockopt.2,v 1.11 1999/06/29 14:10:02 aaron Exp $ .\" $NetBSD: getsockopt.2,v 1.7 1995/02/27 12:33:29 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -96,7 +96,8 @@ and modified on return to indicate the actual size of the value returned. If no option value is to be supplied or returned, .Fa optval -may be NULL. +may be +.Dv NULL . .Pp .Fa optname and any specified options are passed uninterpreted to the appropriate @@ -186,12 +187,12 @@ of the destination address. .Pp .Dv SO_LINGER controls the action taken when unsent messages -are queued on socket and a +are queued on socket and a .Xr close 2 is performed. If the socket promises reliable delivery of data and .Dv SO_LINGER is set, -the system will block the process on the +the system will block the process on the .Xr close 2 attempt until it is able to transmit the data or until it decides it is unable to deliver the information (a timeout period measured in seconds, @@ -199,10 +200,10 @@ termed the linger interval, is specified in the .Fn setsockopt call when .Dv SO_LINGER -is requested). +is requested). If .Dv SO_LINGER -is disabled and a +is disabled and a .Xr close 2 is issued, the system will process the close in a manner that allows the process to continue as quickly as possible. @@ -257,7 +258,7 @@ requested. The default value for .Dv SO_RCVLOWAT is 1. -If +If .Dv SO_RCVLOWAT is set to a larger value, blocking receive calls normally wait until they have received the smaller of the low water mark value @@ -312,7 +313,7 @@ the error status. It may be used to check for asynchronous errors on connected datagram sockets or for other asynchronous errors. .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +A 0 is returned if the call succeeds, \-1 if it fails. .Sh ERRORS The call succeeds unless: .Bl -tag -width Er @@ -327,7 +328,7 @@ is a file, not a socket. .It Bq Er ENOPROTOOPT The option is unknown at the level indicated. .It Bq Er EFAULT -The address pointed to by +The address pointed to by .Fa optval is not in a valid part of the process address space. For diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index 6b07c22c376..dfa7a5a62fc 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gettimeofday.2,v 1.6 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: gettimeofday.2,v 1.7 1999/06/29 14:10:02 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -64,14 +64,16 @@ in ``ticks.'' If .Fa tp or .Fa tzp -is NULL, the associated time +is +.Dv NULL , +the associated time information will not be returned or set. .Pp The structures pointed to by .Fa tp and .Fa tzp -are defined in +are defined in .Ao Pa sys/time.h Ac as: .Pp @@ -87,7 +89,7 @@ struct timezone { }; .Ed .Pp -The +The .Fa timezone structure indicates the local time zone (measured in minutes of time westward from Greenwich), @@ -106,7 +108,7 @@ The system time can still be adjusted backwards using the system call even when the system is secure. .Sh RETURN A 0 return value indicates that the call succeeded. -A -1 return value indicates an error occurred, and in this +A \-1 return value indicates an error occurred, and in this case an error code is stored into the global variable .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2 index 3143bb6e581..2a3694d2457 100644 --- a/lib/libc/sys/intro.2 +++ b/lib/libc/sys/intro.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: intro.2,v 1.12 1999/05/27 20:49:35 aaron Exp $ +.\" $OpenBSD: intro.2,v 1.13 1999/06/29 14:10:03 aaron Exp $ .\" $NetBSD: intro.2,v 1.6 1995/02/27 12:33:41 cgd Exp $ .\" .\" Copyright (c) 1980, 1983, 1986, 1991, 1993 @@ -59,12 +59,12 @@ which is defined as: .Pp When a system call detects an error, it returns an integer value -indicating failure (usually -1) +indicating failure (usually \-1) and sets the variable .Va errno accordingly. <This allows interpretation of the failure on receiving -a -1 and to take action accordingly.> +a \-1 and to take action accordingly.> Successful calls never set .Va errno ; once set, it remains until another error occurs. @@ -84,7 +84,7 @@ An attempt was made to perform an operation limited to processes with appropriate privileges or to the owner of a file or other resources. .It Er 2 ENOENT Em "No such file or directory" . -A component of a specified pathname did not exist, or the +A component of a specified pathname did not exist, or the pathname was an empty string. .It Er 3 ESRCH Em "No such process" . No process could be found corresponding to that specified by the given @@ -362,7 +362,7 @@ was supplied to a remove directory or rename call. .It Er 68 EUSERS Em "Too many users" . The quota system ran out of table entries. .It Er 69 EDQUOT Em "Disc quota exceeded" . -A +A .Xr write 2 to an ordinary file, the creation of a directory or symbolic link, or the creation of a directory @@ -374,10 +374,10 @@ was exhausted. An attempt was made to access an open file (on an .Tn NFS filesystem) -which is now unavailable as referenced by the file descriptor. +which is now unavailable as referenced by the file descriptor. This may indicate the file was deleted on the -.Tn NFS -server or some +.Tn NFS +server or some other catastrophic event occurred. .It Er 72 EBADRPC Em "RPC struct is bad" . Exchange of @@ -391,7 +391,7 @@ the local version. .It Er 74 EPROGUNAVAIL Em "RPC prog. not avail" . The requested program is not registered on the remote host. .It Er 75 EPROGMISMATCH Em "Program version wrong" . -The requested version of the program is not available +The requested version of the program is not available on the remote host .Pq Tn RPC . .It Er 76 EPROCUNAVAIL Em "Bad procedure for program" . @@ -400,10 +400,10 @@ An call was attempted for a procedure which doesn't exist in the remote program. .It Er 77 ENOLCK Em "No locks available" . -A system-imposed limit on the number of simultaneous file +A system-imposed limit on the number of simultaneous file locks was reached. .It Er 78 ENOSYS Em "Function not implemented" . -Attempted a system call that is not available on this +Attempted a system call that is not available on this system. .It Er 79 EFTYPE Em "Inappropriate file type or format" . The file contains invalid data or set to invalid modes. @@ -475,10 +475,10 @@ The process group of a session leader is orphaned by definition. Each user on the system is identified by a positive integer termed the real user ID. .Pp -Each user is also a member of one or more groups. +Each user is also a member of one or more groups. One of these groups is distinguished from others and used in implementing accounting facilities. The positive -integer corresponding to this distinguished group is termed +integer corresponding to this distinguished group is termed the real group ID. .Pp All processes have a real user ID and real group ID. @@ -572,7 +572,7 @@ Note also that is an upper limit fixed by the kernel, meant to be used for sizing buffers. Some filesystems may have additional restrictions. These can be queried using -.Xr pathconf 2 +.Xr pathconf 2 and .Xr fpathconf 2 . .It Path Name @@ -585,7 +585,7 @@ followed by zero or more directory names separated by slashes, optionally followed by a file name. The total length of a path name must be less than 1024 .Pq Dv MAXPATHLEN -characters. +characters. Additional restrictions may apply, depending upon the filesystem, to be queried with .Xr pathconf 2 @@ -624,13 +624,13 @@ These permissions are used in determining whether a process may perform a requested operation on the file (such as opening a file for writing). Access permissions are established at the time a file is created. They may be changed at some later time -through the +through the .Xr chmod 2 -call. +call. .Pp File access is broken down according to whether a file may be: read, written, or executed. Directory files use the execute -permission to control if the directory may be searched. +permission to control if the directory may be searched. .Pp File access permissions are interpreted by the system as they apply to three different classes of users: the owner @@ -686,7 +686,7 @@ chosen from the address family in which the socket was created. .El .Sh SEE ALSO .Xr intro 3 , -.Xr perror 3 +.Xr perror 3 .Sh HISTORY An .Nm intro diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index 32ef467d437..33cfe6a00b7 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ioctl.2,v 1.7 1999/05/28 01:51:48 aaron Exp $ +.\" $OpenBSD: ioctl.2,v 1.8 1999/06/29 14:10:03 aaron Exp $ .\" $NetBSD: ioctl.2,v 1.5 1995/02/27 12:33:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -83,7 +83,7 @@ Macros and defines used in specifying an ioctl are located in the file .Ao Pa sys/ioctl.h Ac . .Sh RETURN VALUES -If an error has occurred, a value of -1 is returned and +If an error has occurred, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -119,5 +119,5 @@ is not valid. .Sh HISTORY An .Fn ioctl -function call appeared in +function call appeared in .At v7 . diff --git a/lib/libc/sys/issetugid.2 b/lib/libc/sys/issetugid.2 index 1e2aa1f73ca..a00a569753e 100644 --- a/lib/libc/sys/issetugid.2 +++ b/lib/libc/sys/issetugid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: issetugid.2,v 1.16 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: issetugid.2,v 1.17 1999/06/29 14:10:03 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -69,7 +69,7 @@ the specified file. Quite often this is not wise because the status of the effective uid is not known. .Pp -The +The .Fn issetugid system call's result is unaffected by calls to .Fn setuid , diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2 index 6db4dcee96a..314fa12096d 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kill.2,v 1.10 1999/06/06 06:57:53 pjanzen Exp $ +.\" $OpenBSD: kill.2,v 1.11 1999/06/29 14:10:04 aaron Exp $ .\" $NetBSD: kill.2,v 1.7 1995/02/27 12:33:53 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -58,7 +58,7 @@ may be one of the signals specified in .Xr sigaction 2 or it may be 0, in which case error checking is performed but no -signal is actually sent. +signal is actually sent. This can be used to check the validity of .Fa pid . .Pp @@ -147,5 +147,5 @@ of the group could not be signaled. .Sh STANDARDS The .Fn kill -function is expected to conform to +function is expected to conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2 index 18e5cd53934..1b6be37cd7b 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ktrace.2,v 1.6 1999/05/24 11:57:13 aaron Exp $ +.\" $OpenBSD: ktrace.2,v 1.7 1999/06/29 14:10:04 aaron Exp $ .\" $NetBSD: ktrace.2,v 1.2 1995/02/27 12:33:58 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -54,42 +54,44 @@ function enables or disables tracing of one or more processes. Users may only trace their own processes. Only the super-user can trace setuid or setgid programs. .Pp -The -.Ar tracefile +.Fa tracefile gives the pathname of the file to be used for tracing. The file must exist and be writable by the calling process. All trace records are always appended to the file, so the file must be truncated to zero length to discard previous trace data. -If tracing points are being disabled (see KTROP_CLEAR below), +If tracing points are being disabled (see +.Dv KTROP_CLEAR +below), .Ar tracefile -may be NULL. +may be +.Dv NULL . .Pp The -.Nm ops +.Fa ops parameter specifies the requested ktrace operation. The defined operations are: .Bl -column KTRFLAG_DESCENDXXX -offset indent -.It KTROP_SET Enable trace points specified in Ar trpoints . -.It KTROP_CLEAR Disable trace points specified in Ar trpoints . -.It KTROP_CLEARFILE Stop all tracing. -.It KTRFLAG_DESCEND The tracing change should apply to the +.It Dv KTROP_SET Enable trace points specified in Ar trpoints . +.It Dv KTROP_CLEAR Disable trace points specified in Ar trpoints . +.It Dv KTROP_CLEARFILE Stop all tracing. +.It Dv KTRFLAG_DESCEND The tracing change should apply to the specified process and all its current children. .El .Pp The -.Nm trpoints +.Fa trpoints parameter specifies the trace points of interest. The defined trace points are: .Bl -column KTRFAC_SYSCALLXXX -offset indent -.It KTRFAC_SYSCALL Trace system calls. -.It KTRFAC_SYSRET Trace return values from system calls. -.It KTRFAC_NAMEI Trace name lookup operations. -.It KTRFAC_GENIO Trace all I/O (note that this option can +.It Dv KTRFAC_SYSCALL Trace system calls. +.It Dv KTRFAC_SYSRET Trace return values from system calls. +.It Dv KTRFAC_NAMEI Trace name lookup operations. +.It Dv KTRFAC_GENIO Trace all I/O (note that this option can generate much output). -.It KTRFAC_PSIG Trace posted signals. -.It KTRFAC_CSW Trace context switch points. -.It KTRFAC_INHERIT Inherit tracing to future children. +.It Dv KTRFAC_PSIG Trace posted signals. +.It Dv KTRFAC_CSW Trace context switch points. +.It Dv KTRFAC_INHERIT Inherit tracing to future children. .El .Pp Each tracing event outputs a record composed of a generic header @@ -107,34 +109,34 @@ struct ktr_header { .Ed .Pp The -.Nm ktr_len -field specifies the length of the -.Nm ktr_type +.Fa ktr_len +field specifies the length of the +.Fa ktr_type data that follows this header. The -.Nm ktr_pid +.Fa ktr_pid and -.Nm ktr_comm +.Fa ktr_comm fields specify the process and command generating the record. The -.Nm ktr_time +.Fa ktr_time field gives the time (with microsecond resolution) that the record was generated. The -.Nm ktr_buf +.Fa ktr_buf is an internal kernel pointer and is not useful. .Pp -The generic header is followed by -.Nm ktr_len +The generic header is followed by +.Fa ktr_len bytes of a -.Nm ktr_type +.Fa ktr_type record. The type specific records are defined in the .Pa <sys/ktrace.h> include file. .Sh RETURN VALUES On successful completion a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to show the error. .Sh ERRORS @@ -162,6 +164,6 @@ An I/O error occurred while reading from or writing to the file system. .Xr ktrace 1 .Sh HISTORY A -.Nm ktrace +.Fn ktrace function call first appeared in .Bx 4.4 . diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 06cc9286bb1..0c72c6427ff 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: link.2,v 1.9 1999/05/25 13:06:46 aaron Exp $ +.\" $OpenBSD: link.2,v 1.10 1999/06/29 14:10:04 aaron Exp $ .\" $NetBSD: link.2,v 1.7 1995/02/27 12:34:01 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -82,7 +82,7 @@ As mandated by POSIX.1 may not be a directory. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. Otherwise, -a value of -1 is returned and +a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -92,9 +92,9 @@ will fail and no link will be created if: .It Bq Er ENOTDIR A component of either path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -148,7 +148,7 @@ is being placed cannot be extended because the user's quota of disk blocks on the file system containing the directory has been exhausted. .It Bq Er EIO -An I/O error occurred while reading from or writing to +An I/O error occurred while reading from or writing to the file system to make the directory entry. .It Bq Er EROFS The requested link requires writing in a directory on a read-only file @@ -164,5 +164,5 @@ is outside the process's allocated address space. .Sh STANDARDS The .Fn link -function is expected to conform to +function is expected to conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index 5a2ad35a5e0..2348da80457 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: listen.2,v 1.6 1999/05/25 13:06:46 aaron Exp $ +.\" $OpenBSD: listen.2,v 1.7 1999/06/29 14:10:05 aaron Exp $ .\" $NetBSD: listen.2,v 1.7 1996/02/16 20:38:45 phil Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -73,7 +73,7 @@ receive an error with an indication of or, if the underlying protocol supports retransmission, the request may be ignored so that retries may succeed. .Sh RETURN VALUES -A 0 return value indicates success; -1 indicates an error. +A 0 return value indicates success; \-1 indicates an error. .Sh ERRORS .Fn listen will fail if: diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2 index 78eae5090b0..2f5ee755b3f 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: lseek.2,v 1.7 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: lseek.2,v 1.8 1999/06/29 14:10:05 aaron Exp $ .\" $NetBSD: lseek.2,v 1.6 1995/02/27 12:34:09 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -105,7 +105,7 @@ Upon successful completion, returns the resulting offset location as measured in bytes from the beginning of the file. Otherwise, -a value of -1 is returned and +a value of \-1 is returned and .Va errno is set to indicate the error. @@ -135,5 +135,5 @@ is incorrect English, but is maintained for historical reasons. .Sh STANDARDS The .Fn lseek -function conforms to +function conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/madvise.2 b/lib/libc/sys/madvise.2 index 9caaf7b1e87..8fe94c7e105 100644 --- a/lib/libc/sys/madvise.2 +++ b/lib/libc/sys/madvise.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: madvise.2,v 1.9 1998/08/21 16:48:53 millert Exp $ +.\" $OpenBSD: madvise.2,v 1.10 1999/06/29 14:10:05 aaron Exp $ .\" $NetBSD: madvise.2,v 1.7 1995/12/27 21:17:02 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -64,13 +64,13 @@ The known behaviors are given in .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh SEE ALSO .Xr mincore 2 , .Xr minherit 2 , -.Xr mprotect 2 , +.Xr mprotect 2 , .Xr msync 2 , .Xr munmap 2 .Sh BUGS diff --git a/lib/libc/sys/mincore.2 b/lib/libc/sys/mincore.2 index 65c68aa2394..b34c49570b4 100644 --- a/lib/libc/sys/mincore.2 +++ b/lib/libc/sys/mincore.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mincore.2,v 1.7 1998/07/06 18:27:51 deraadt Exp $ +.\" $OpenBSD: mincore.2,v 1.8 1999/06/29 14:10:05 aaron Exp $ .\" $NetBSD: mincore.2,v 1.7 1995/10/12 15:41:05 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -52,13 +52,13 @@ system call allows a process to obtain information about whether pages are core resident. Here the current core residency of the pages is returned -in the character array +in the character array .Fa vec , with a value of 1 meaning that the page is in-core. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh SEE ALSO diff --git a/lib/libc/sys/minherit.2 b/lib/libc/sys/minherit.2 index b713033727c..571aea31905 100644 --- a/lib/libc/sys/minherit.2 +++ b/lib/libc/sys/minherit.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: minherit.2,v 1.7 1998/07/06 18:27:52 deraadt Exp $ +.\" $OpenBSD: minherit.2,v 1.8 1999/06/29 14:10:06 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -55,9 +55,9 @@ Not all implementations will guarantee that the inheritance characteristic can be set on a page basis; the granularity of changes may be as large as an entire region. .Sh SEE ALSO -.Xr madvise 2 , -.Xr mincore 2 , -.Xr mprotect 2 , +.Xr madvise 2 , +.Xr mincore 2 , +.Xr mprotect 2 , .Xr msync 2 , .Xr munmap 2 .Sh HISTORY diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 4301495e88c..40997c077a0 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mkdir.2,v 1.5 1999/05/23 14:10:54 aaron Exp $ +.\" $OpenBSD: mkdir.2,v 1.6 1999/06/29 14:10:06 aaron Exp $ .\" $NetBSD: mkdir.2,v 1.8 1995/02/27 12:34:22 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -58,7 +58,7 @@ The directory's owner ID is set to the process's effective user ID. The directory's group ID is set to that of the parent directory in which it is created. .Sh RETURN VALUES -A 0 return value indicates success. A -1 return value +A 0 return value indicates success. A \-1 return value indicates an error, and an error code is stored in .Va errno . .Sh ERRORS @@ -68,9 +68,9 @@ will fail and no directory will be created if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -109,7 +109,7 @@ points outside the process's allocated address space. .Xr stat 2 , .Xr umask 2 .Sh STANDARDS -The +The .Fn mkdir -function conforms to +function conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index 09af95c4f64..58282fd10c8 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mkfifo.2,v 1.3 1999/02/27 21:56:31 deraadt Exp $ +.\" $OpenBSD: mkfifo.2,v 1.4 1999/06/29 14:10:06 aaron Exp $ .\" $NetBSD: mkfifo.2,v 1.8 1995/02/27 12:34:27 cgd Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 @@ -60,7 +60,7 @@ The fifo's owner ID is set to the process's effective user ID. The fifo's group ID is set to that of the parent directory in which it is created. .Sh RETURN VALUES -A 0 return value indicates success. A -1 return value +A 0 return value indicates success. A \-1 return value indicates an error, and an error code is stored in .Va errno . .Sh ERRORS @@ -72,9 +72,9 @@ The kernel has not been configured to support fifo's. .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/mknod.2 b/lib/libc/sys/mknod.2 index 5097bc7e70f..c8119f5b895 100644 --- a/lib/libc/sys/mknod.2 +++ b/lib/libc/sys/mknod.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mknod.2,v 1.6 1999/05/25 13:06:46 aaron Exp $ +.\" $OpenBSD: mknod.2,v 1.7 1999/06/29 14:10:07 aaron Exp $ .\" $NetBSD: mknod.2,v 1.6 1995/02/27 12:34:33 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -71,7 +71,7 @@ is ignored. requires super-user privileges. .Sh RETURN VALUES Upon successful completion a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -81,9 +81,9 @@ will fail and the file will be not created if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -126,5 +126,5 @@ points outside the process's allocated address space. .Sh HISTORY A .Fn mknod -function call appeared in +function call appeared in .At v6 . diff --git a/lib/libc/sys/mlock.2 b/lib/libc/sys/mlock.2 index 21bca84a2b6..04c87195bc4 100644 --- a/lib/libc/sys/mlock.2 +++ b/lib/libc/sys/mlock.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mlock.2,v 1.8 1999/05/27 16:54:23 aaron Exp $ +.\" $OpenBSD: mlock.2,v 1.9 1999/06/29 14:10:07 aaron Exp $ .\" $NetBSD: mlock.2,v 1.3 1995/06/24 10:42:03 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -106,7 +106,7 @@ resource limit. .Sh RETURN VALUES A return value of 0 indicates that the call succeeded and all pages in the range have either been locked or unlocked. -A return value of -1 indicates an error occurred and the locked +A return value of \-1 indicates an error occurred and the locked status of all pages in the range remains unchanged. In this case, the global location .Va errno diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index 6648bc7345c..f02f245caa5 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mmap.2,v 1.16 1999/06/16 08:45:12 alex Exp $ +.\" $OpenBSD: mmap.2,v 1.17 1999/06/29 14:10:07 aaron Exp $ .\" $NetBSD: mmap.2,v 1.5 1995/06/24 10:48:59 cgd Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -119,7 +119,9 @@ specified. If the specified address cannot be used, .Nm mmap will fail. -If MAP_FIXED is specified, +If +.Dv MAP_FIXED +is specified, .Fa addr must be a multiple of the pagesize. Use of this option is discouraged. @@ -140,7 +142,7 @@ Modifications are private and unlike you don't see modifications made by others. .El .Pp -The +The .Xr close 2 function does not unmap pages; see .Xr munmap 2 diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index a5e2dac2343..be13f3d3968 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mount.2,v 1.14 1999/05/27 16:10:36 millert Exp $ +.\" $OpenBSD: mount.2,v 1.15 1999/06/29 14:10:08 aaron Exp $ .\" $NetBSD: mount.2,v 1.12 1996/02/29 23:47:48 jtc Exp $ .\" .\" Copyright (c) 1980, 1989, 1993 @@ -182,13 +182,13 @@ even if the filesystem is later remounted. .Sh RETURN VALUES The .Fn mount -returns the value 0 if the mount was successful, otherwise -1 is returned +returns the value 0 if the mount was successful, otherwise \-1 is returned and the variable .Va errno is set to indicate the error. .Pp .Fn unmount -returns the value 0 if the unmount succeeded; otherwise -1 is returned +returns the value 0 if the unmount succeeded; otherwise \-1 is returned and the variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2 index 1a5b26ba188..876e196c969 100644 --- a/lib/libc/sys/mprotect.2 +++ b/lib/libc/sys/mprotect.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mprotect.2,v 1.6 1998/07/06 18:28:00 deraadt Exp $ +.\" $OpenBSD: mprotect.2,v 1.7 1999/06/29 14:10:08 aaron Exp $ .\" $NetBSD: mprotect.2,v 1.6 1995/10/12 15:41:08 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -56,12 +56,12 @@ the granularity of protection changes may be as large as an entire region. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh SEE ALSO -.Xr madvise 2 , -.Xr mincore 2 , +.Xr madvise 2 , +.Xr mincore 2 , .Xr msync 2 , .Xr munmap 2 .Sh HISTORY diff --git a/lib/libc/sys/msgctl.2 b/lib/libc/sys/msgctl.2 index e6d8be987d4..dfacd93a7f8 100644 --- a/lib/libc/sys/msgctl.2 +++ b/lib/libc/sys/msgctl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: msgctl.2,v 1.8 1999/06/05 04:16:08 aaron Exp $ +.\" $OpenBSD: msgctl.2,v 1.9 1999/06/29 14:10:08 aaron Exp $ .\" $NetBSD: msgctl.2,v 1.2 1997/03/27 08:20:35 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -117,7 +117,7 @@ The values are taken from the corresponding fields in the structure pointed to by .Fa buf . This operation can only be executed by the super-user, or a process that -has an effective user ID equal to either +has an effective user ID equal to either .Va msg_perm.cuid or .Va msg_perm.uid @@ -126,7 +126,9 @@ The value of .Va msg_qbytes can only be increased by the super-user. Values for .Va msg_qbytes -that exceed the system limit (MSGMNB from +that exceed the system limit +.Pf ( Dv MSGMNB +from .Aq Pa sys/msg.h ) are silently truncated to that limit. .Pp @@ -134,7 +136,7 @@ are silently truncated to that limit. Remove the message queue specified by .Fa msqid and destroy the data associated with it. Only the super-user or a process -with an effective UID equal to the +with an effective UID equal to the .Va msg_perm.cuid or .Va msg_perm.uid @@ -160,7 +162,7 @@ effective GID can match either or .Va msg_perm.gid . .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. Otherwise, -1 is +Upon successful completion, a value of 0 is returned. Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/msgget.2 b/lib/libc/sys/msgget.2 index b4fbf12df57..fd056d449a9 100644 --- a/lib/libc/sys/msgget.2 +++ b/lib/libc/sys/msgget.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: msgget.2,v 1.6 1999/05/27 14:05:09 aaron Exp $ +.\" $OpenBSD: msgget.2,v 1.7 1999/06/29 14:10:09 aaron Exp $ .\" $NetBSD: msgget.2,v 1.1 1995/10/16 23:49:19 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -65,7 +65,7 @@ structure, see .Xr msgctl 2 ) is initialized as follows: .Bl -bullet -.It +.It .Va msg_perm.cuid and .Va msg_perm.uid @@ -85,20 +85,20 @@ is set to the lower 9 bits of .Va msg_lspid , .Va msg_lrpid , .Va msg_rtime , -and +and .Va msg_stime are set to 0 .It .Va msg_qbytes is set to the system wide maximum value for the number of bytes in a queue -(MSGMNB). +.Pq Dv MSGMNB . .It .Va msg_ctime is set to the current time. .El .Sh RETURN VALUES Upon successful completion a positive message queue identifier is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/msgrcv.2 b/lib/libc/sys/msgrcv.2 index 99d8f2a7475..3fd937b0e91 100644 --- a/lib/libc/sys/msgrcv.2 +++ b/lib/libc/sys/msgrcv.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: msgrcv.2,v 1.7 1999/05/27 16:54:23 aaron Exp $ +.\" $OpenBSD: msgrcv.2,v 1.8 1999/06/29 14:10:09 aaron Exp $ .\" $NetBSD: msgrcv.2,v 1.2 1997/03/27 08:20:37 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -43,7 +43,7 @@ .Ft int .Fn msgrcv "int msqid" "void *msgp" "size_t msgsz" "long msgtyp" "int msgflg" .Sh DESCRIPTION -The +The .Fn msgrcv function receives a message from the message queue specified in .Fa msqid , @@ -58,7 +58,8 @@ This structure should consist of the following members: .Va mtype is an integer greater than 0 that can be used for selecting messages, .Va mtext -is an array of bytes, with a size up to that of the system limit (MSGMAX). +is an array of bytes, with a size up to that of the system limit +.Pq Dv MSGMAX . .Pp The value of .Fa msgtyp @@ -102,7 +103,7 @@ or not. If .Dv IPC_NOWAIT is set, .Fn msgrcv -will immediately return a value of -1, and set +will immediately return a value of \-1, and set .Va errno to .Er EAGAIN . @@ -114,12 +115,12 @@ until: .It A message of the requested type becomes available on the message queue. .It -The message queue is removed, in which case -1 will be returned, and +The message queue is removed, in which case \-1 will be returned, and .Va errno set to .Er EINVAL . .It -A signal is received and caught. -1 is returned, and +A signal is received and caught. \-1 is returned, and .Va errno set to .Er EINTR . @@ -149,7 +150,7 @@ returns the number of bytes received into the .Va mtext field of the structure pointed to by .Fa msgp . -Otherwise, -1 is returned, and +Otherwise, \-1 is returned, and .Va errno set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/msgsnd.2 b/lib/libc/sys/msgsnd.2 index ccbd1be3a83..c7312193ef7 100644 --- a/lib/libc/sys/msgsnd.2 +++ b/lib/libc/sys/msgsnd.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: msgsnd.2,v 1.6 1999/05/27 14:05:10 aaron Exp $ +.\" $OpenBSD: msgsnd.2,v 1.7 1999/06/29 14:10:09 aaron Exp $ .\" $NetBSD: msgsnd.2,v 1.2 1997/03/27 08:20:36 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -43,7 +43,7 @@ .Ft int .Fn msgsnd "int msqid" "const void *msgp" "size_t msgsz" "int msgflg" .Sh DESCRIPTION -The +The .Fn msgsnd function sends a message from the message queue specified in .Fa msqid . @@ -58,8 +58,9 @@ consist of the following members: .Va mtype is an integer greater than 0 that can be used for selecting messages (see .Xr msgrcv 2 ) , -.Va mtext -is an array of bytes, with a size up to that of the system limit (MSGMAX). +.Va mtext +is an array of bytes, with a size up to that of the system limit +.Pq Dv MSGMAX . .Pp If the number of bytes already on the message queue plus .Fa msgsz @@ -86,7 +87,7 @@ set in it, the call will block until: The condition which caused the call to block does no longer exist. The message will be sent. .It -The messag queue is removed, in which case -1 will be returned, and +The messag queue is removed, in which case \-1 will be returned, and .Va errno is set to .Er EINVAL . @@ -114,7 +115,7 @@ is set to the pid of the calling process. is set to the current time. .El .Sh RETURN VALUES -Upon successful completion, 0 is returned. Otherwise, -1 is returned and +Upon successful completion, 0 is returned. Otherwise, \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2 index b687ae3f077..06e6eb78905 100644 --- a/lib/libc/sys/msync.2 +++ b/lib/libc/sys/msync.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: msync.2,v 1.14 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: msync.2,v 1.15 1999/06/29 14:10:10 aaron Exp $ .\" $NetBSD: msync.2,v 1.8 1995/10/12 15:41:09 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -85,7 +85,7 @@ MS_INVALIDATE Invalidate cached data after writing. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/munmap.2 b/lib/libc/sys/munmap.2 index 2eb96689166..bd2648e0771 100644 --- a/lib/libc/sys/munmap.2 +++ b/lib/libc/sys/munmap.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: munmap.2,v 1.8 1999/06/16 08:45:12 alex Exp $ +.\" $OpenBSD: munmap.2,v 1.9 1999/06/29 14:10:10 aaron Exp $ .\" $NetBSD: munmap.2,v 1.5 1995/02/27 12:35:03 cgd Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -56,7 +56,7 @@ to generate invalid memory references. Upon successful completion, .Nm munmap returns zero. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2 index adb186364a5..7bb722eba06 100644 --- a/lib/libc/sys/nanosleep.2 +++ b/lib/libc/sys/nanosleep.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nanosleep.2,v 1.3 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: nanosleep.2,v 1.4 1999/06/29 14:10:10 aaron Exp $ .\" $NetBSD: nanosleep.2,v 1.1 1997/04/17 18:12:02 jtc Exp $ .\" .\" Copyright (c) 1986, 1991, 1993 @@ -51,34 +51,33 @@ signal will cause it to terminate the sleep early, regardless of the .Dv SA_RESTART value on the interrupting signal. .Sh RETURN VALUE -If the +If the .Fn nanosleep function returns because the requested time has elapsed, the value -returned will be zero. +returned will be zero. .Pp -If the +If the .Fn nanosleep function returns due to the delivery of a signal, the value returned -will be the -1, and the global variable +will be the \-1, and the global variable .Va errno will be set to indicate the interruption. -If +If .Fa rmtp -is -.Pf non- Dv NULL , +is non-null, the timespec structure it references is updated to contain the unslept amount (the request time minus the time actually slept). .Sh ERRORS If any of the following conditions occur, the -.Nm -function shall return -1 and set +.Fn nanosleep +function shall return \-1 and set .Va errno to the corresponding value. .Bl -tag -width Er .It Bq Er EFAULT Either .Fa rqtp -or +or .Fa rmtp points to memory that is not a valid part of the process address space. diff --git a/lib/libc/sys/nfssvc.2 b/lib/libc/sys/nfssvc.2 index 7ce614a2f54..f4d96deef8f 100644 --- a/lib/libc/sys/nfssvc.2 +++ b/lib/libc/sys/nfssvc.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nfssvc.2,v 1.7 1999/05/16 19:55:31 alex Exp $ +.\" $OpenBSD: nfssvc.2,v 1.8 1999/06/29 14:10:11 aaron Exp $ .\" $NetBSD: nfssvc.2,v 1.6 1995/02/27 12:35:08 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -104,7 +104,10 @@ If the mount point is using Kerberos, then the .Xr mount_nfs 8 daemon will return from .Fn nfssvc -with errno == ENEEDAUTH whenever the client side requires an ``rcmd'' +with errno set to +.Er ENEEDAUTH +whenever the client side requires an +.Dq rcmd authentication ticket for the user. .Xr mount_nfs 8 will attempt to get the Kerberos ticket, and if successful will call @@ -113,7 +116,7 @@ with the flags .Dv NFSSVC_MNTD and .Dv NFSSVC_GOTAUTH -after filling the ticket into the +after filling the ticket into the ncd_authstr field and setting the ncd_authlen and ncd_authtype @@ -157,11 +160,12 @@ Whenever an .Xr nfsd 8 daemon receives a Kerberos authentication ticket, it will return from .Fn nfssvc -with errno == ENEEDAUTH. +with errno set to +.Er ENEEDAUTH . The .Xr nfsd 8 will attempt to authenticate the ticket and generate a set of credentials -on the server for the ``user id'' specified in the field nsd_uid. +on the server for the user ID specified in the field nsd_uid. This is done by first authenticating the Kerberos ticket and then mapping the Kerberos principal to a local name and getting a set of credentials for that user via. @@ -213,7 +217,7 @@ Normally .Nm nfssvc does not return unless the server is terminated by a signal when a value of 0 is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to specify the error. .Sh ERRORS diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index 74106b46461..5031199f8e2 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: open.2,v 1.12 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: open.2,v 1.13 1999/06/29 14:10:11 aaron Exp $ .\" $NetBSD: open.2,v 1.8 1995/02/27 12:35:14 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -131,7 +131,7 @@ the request for the lock will never fail If successful, .Fn open returns a non-negative integer, termed a file descriptor. -It returns -1 on failure. +It returns \-1 on failure. The file pointer used to mark the current position within the file is set to the beginning of the file. .Pp @@ -155,9 +155,9 @@ The named file is opened unless: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -271,5 +271,5 @@ is already locked. .Sh HISTORY An .Fn open -function call appeared in +function call appeared in .At v6 . diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index 7348ff194b6..be5dec02b8f 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pathconf.2,v 1.6 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: pathconf.2,v 1.7 1999/06/29 14:10:11 aaron Exp $ .\" $NetBSD: pathconf.2,v 1.2 1995/02/27 12:35:22 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -116,7 +116,7 @@ If any of the following conditions occur, the .Nm pathconf and .Nm fpathconf -functions shall return -1 and set +functions shall return \-1 and set .Va errno to the corresponding value. .Bl -tag -width Er diff --git a/lib/libc/sys/pipe.2 b/lib/libc/sys/pipe.2 index e41e71e5fb3..3eb80aa5d3c 100644 --- a/lib/libc/sys/pipe.2 +++ b/lib/libc/sys/pipe.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pipe.2,v 1.6 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: pipe.2,v 1.7 1999/06/29 14:10:13 aaron Exp $ .\" $NetBSD: pipe.2,v 1.6 1995/02/27 12:35:27 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -57,7 +57,7 @@ The first descriptor connects to the .Em read end of the pipe, and the second connects to the -.Em write end , +.Em write end , so that data written to .Fa fildes[1] appears on (i.e., can be read from) @@ -82,8 +82,8 @@ Widowing a pipe is the only way to deliver end-of-file to a reader: after the reader consumes any buffered data, reading a widowed pipe returns a zero count. .Sh RETURN VALUES -On successful creation of the pipe, zero is returned. Otherwise, -a value of -1 is returned and the variable +On successful creation of the pipe, zero is returned. Otherwise, +a value of \-1 is returned and the variable .Va errno set to indicate the error. @@ -116,5 +116,5 @@ function conforms to .Sh HISTORY A .Fn pipe -function call appeared in +function call appeared in .At v6 . diff --git a/lib/libc/sys/poll.2 b/lib/libc/sys/poll.2 index d645c7e804c..b96986b4454 100644 --- a/lib/libc/sys/poll.2 +++ b/lib/libc/sys/poll.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: poll.2,v 1.6 1999/05/16 19:55:33 alex Exp $ +.\" $OpenBSD: poll.2,v 1.7 1999/06/29 14:10:14 aaron Exp $ .\" .\" Copyright (c) 1994 Jason R. Thorpe .\" All rights reserved. @@ -140,7 +140,7 @@ member will generate an error condition. In addition to I/O multiplexing, .Fn poll can be used to generate simple timeouts. This functionality may be achieved -by passing a NULL pointer for +by passing a null pointer for .Pa fds . .Sh WARNINGS The @@ -149,7 +149,7 @@ flag is only a close approximation and may not always be accurate. .Sh RETURN VALUES Upon error, .Fn poll -returns a -1 and sets the global variable +returns a \-1 and sets the global variable .Pa errno to indicate the error. If the timeout interval was reached before any events occurred, a 0 is returned. Otherwise, diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 293d51cf15d..cbaf81ea788 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ptrace.2,v 1.6 1999/05/27 16:54:23 aaron Exp $ +.\" $OpenBSD: ptrace.2,v 1.7 1999/06/29 14:10:14 aaron Exp $ .\" $NetBSD: ptrace.2,v 1.3 1996/02/23 01:39:41 jtc Exp $ .\" .\" This file is in the public domain. @@ -158,7 +158,9 @@ process is running as root, these restrictions do not apply.) The tracing process will see the newly traced process stop and may then control it as if it had been traced all along. .It Dv PT_DETACH -This request is like PT_CONTINUE, except that it does not allow +This request is like +.Dv PT_CONTINUE , +except that it does not allow specifying an alternate place to continue execution, and after it succeeds, the traced process is no longer traced and continues execution normally. diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index acffa10a944..19f02da48e2 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: quotactl.2,v 1.4 1999/02/27 21:56:39 deraadt Exp $ +.\" $OpenBSD: quotactl.2,v 1.5 1999/06/29 14:10:14 aaron Exp $ .\" $NetBSD: quotactl.2,v 1.8 1995/02/27 12:35:43 cgd Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 @@ -81,7 +81,7 @@ The .Fa addr argument specifies a file from which to take the quotas. The quota file must exist; -it is normally created with the +it is normally created with the .Xr quotacheck 8 program. The @@ -139,7 +139,7 @@ parameters are ignored. .El .Sh RETURN VALUES A successful call returns 0, -otherwise the value -1 is returned and the global variable +otherwise the value \-1 is returned and the global variable .Va errno indicates the reason for the failure. .Sh ERRORS @@ -165,9 +165,9 @@ Search permission is denied for a component of a path prefix. .It Bq Er ENOTDIR A component of a path prefix was not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index bd54862bc69..6ec9548c4d6 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: read.2,v 1.9 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: read.2,v 1.10 1999/06/29 14:10:15 aaron Exp $ .\" $NetBSD: read.2,v 1.6 1995/02/27 12:35:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -59,15 +59,15 @@ into the buffer pointed to by .Fa buf . .Fn \ Readv performs the same action, but scatters the input data -into the +into the .Fa iovcnt buffers specified by the members of the .Fa iov array: iov[0], iov[1], ..., iov[iovcnt\|\-\|1]. .Pp -For +For .Fn readv , -the +the .Fa iovec structure is defined as: .Pp @@ -78,10 +78,10 @@ struct iovec { }; .Ed .Pp -Each +Each .Fa iovec entry specifies the base address and length of an area -in memory where data should be placed. +in memory where data should be placed. .Fn readv will always fill an area completely before proceeding to the next. @@ -112,7 +112,7 @@ before the end-of-file, but in no other case. .Pp Note that .Fn readv -will fail if the value of +will fail if the value of .Fa iovcnt exceedes the constant .Dv IOV_MAX . @@ -121,7 +121,7 @@ exceedes the constant If successful, the number of bytes actually read is returned. Upon reading end-of-file, zero is returned. -Otherwise, a -1 is returned and the global variable +Otherwise, a \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -150,7 +150,7 @@ The file was marked for non-blocking I/O, and no data were ready to be read. .El .Pp -In addition, +In addition, .Fn read may return following error: .Bl -tag -width Er @@ -173,7 +173,7 @@ The sum of the .Fa iov_len values in the .Fa iov -array overflowed an +array overflowed an .Em ssize_t . .It Bq Er EFAULT Part of the diff --git a/lib/libc/sys/readlink.2 b/lib/libc/sys/readlink.2 index 4c9c804c292..2c03d733315 100644 --- a/lib/libc/sys/readlink.2 +++ b/lib/libc/sys/readlink.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: readlink.2,v 1.8 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: readlink.2,v 1.9 1999/06/29 14:10:15 aaron Exp $ .\" $NetBSD: readlink.2,v 1.7 1995/02/27 12:35:54 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -59,7 +59,7 @@ character to .Fa buf . .Sh RETURN VALUES The call returns the count of characters placed in the buffer -if it succeeds, or a -1 if an error occurs, placing the error +if it succeeds, or a \-1 if an error occurs, placing the error code in the global variable .Va errno . .Sh ERRORS @@ -69,9 +69,9 @@ will fail if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2 index 272f625a4f6..3f1f35667cd 100644 --- a/lib/libc/sys/reboot.2 +++ b/lib/libc/sys/reboot.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: reboot.2,v 1.4 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: reboot.2,v 1.5 1999/06/29 14:10:15 aaron Exp $ .\" $NetBSD: reboot.2,v 1.5 1995/02/27 12:36:02 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -134,7 +134,7 @@ An automatic consistency check of the disks is normally performed .El .Sh RETURN VALUES If successful, this call never returns. -Otherwise, a -1 is returned and an error is returned in the global +Otherwise, a \-1 is returned and an error is returned in the global variable .Va errno . .Sh ERRORS diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index e79b568bfe5..3de95ca7b51 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: recv.2,v 1.18 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: recv.2,v 1.19 1999/06/29 14:10:16 aaron Exp $ .\" $NetBSD: recv.2,v 1.6 1995/02/27 12:36:08 cgd Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 @@ -61,7 +61,7 @@ it is connection-oriented. .Pp If .Fa from -is non-nil, and the socket is not connection-oriented, +is non-null and the socket is not connection-oriented, the source address of the message is filled in. .Fa fromlen is a value-result parameter, initialized to the size of @@ -70,15 +70,15 @@ the buffer associated with and modified on return to indicate the actual size of the address stored there. .Pp -The +The .Fn recv -call is normally used only on a +call is normally used only on a .Em connected socket (see .Xr connect 2 ) and is identical to .Fn recvfrom -with a nil +with a null .Fa from parameter. As it is redundant, it may not be supported in future releases. @@ -94,7 +94,7 @@ receive call waits for a message to arrive, unless the socket is nonblocking (see .Xr fcntl 2 ) in which case the value --1 is returned and the external variable +\-1 is returned and the external variable .Va errno set to .Er EAGAIN . @@ -114,7 +114,7 @@ call may be used to determine when more data arrive. .Pp The .Fa flags -argument to a recv call is formed by +argument to a recv call is formed by .Tn OR Ns ing one or more of the values: .Bl -column MSG_WAITALL -offset indent @@ -129,11 +129,15 @@ flag requests receipt of out-of-band data that would not be received in the normal data stream. Some protocols place expedited data at the head of the normal data queue, and thus this flag cannot be used with such protocols. -The MSG_PEEK flag causes the receive operation to return data +The +.Dv MSG_PEEK +flag causes the receive operation to return data from the beginning of the receive queue without removing that data from the queue. Thus, a subsequent receive call will return the same data. -The MSG_WAITALL flag requests that the operation block until +The +.Dv MSG_WAITALL +flag requests that the operation block until the full request is satisfied. However, the call may still return less data than requested if a signal is caught, an error or disconnect occurs, @@ -141,7 +145,7 @@ or the next data to be received is of a different type than that returned. .Pp The .Fn recvmsg -call uses a +call uses a .Fa msghdr structure to minimize the number of directly supplied parameters. This structure has the following form, as defined in @@ -229,7 +233,7 @@ Indicates that the packet was received as multicast. .El .Pp .Sh RETURN VALUES -These calls return the number of bytes received, or -1 +These calls return the number of bytes received, or \-1 if an error occurred. .Sh ERRORS .Fn recv , @@ -272,7 +276,7 @@ and may return following error: .Bl -tag -width Er .It Bq Er EINVAL -.Fa len +.Fa len was larger than .Dv SSIZE_MAX . .El @@ -291,8 +295,8 @@ array overflowed an .It Bq Er EMSGSIZE The .Fa msg_iovlen -member of -.Fa msg +member of +.Fa msg was less than 0 or larger than .Dv IOV_MAX . .El diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index d8938259a8b..67b774dbe7d 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rename.2,v 1.6 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: rename.2,v 1.7 1999/06/29 14:10:16 aaron Exp $ .\" $NetBSD: rename.2,v 1.7 1995/02/27 12:36:15 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -50,10 +50,10 @@ causes the link named .Fa from to be renamed as .Fa to . -If +If .Fa to exists, it is first removed. -Both +Both .Fa from and .Fa to @@ -92,7 +92,7 @@ perform .Ql rename a/foo b/bar and .Ql rename b/bar a/foo , -respectively, +respectively, the system may deadlock attempting to lock both directories for modification. Hard links to directories should be @@ -100,7 +100,7 @@ replaced by symbolic links by the system administrator. .Sh RETURN VALUES A 0 value is returned if the operation succeeds, otherwise .Fn rename -returns -1 and the global variable +returns \-1 and the global variable .Va errno indicates the reason for the failure. .Sh ERRORS @@ -109,9 +109,9 @@ will fail and neither of the argument files will be affected if: .Bl -tag -width Er .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -203,5 +203,5 @@ is a directory and is not empty. .Sh STANDARDS The .Fn rename -function conforms to +function conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index 0b2a0062086..cf38c071261 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rfork.2,v 1.12 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: rfork.2,v 1.13 1999/06/29 14:10:16 aaron Exp $ .\" .\" This manual page is taken directly from Plan9, and modified to .\" describe the actual OpenBSD implementation. Permission for @@ -41,7 +41,7 @@ The current implementation requires this flag to always be set. .It Dv RFNOWAIT If set, the child process will be dissociated from the parent. Upon exit the child will not leave a status for the parent to collect. -See +See .Xr wait 2 . .It Xo Dv RFNAMEG , Dv RFCNAMEG , .Dv RFENVG , Dv RFCENVG , Dv RFNOTEG diff --git a/lib/libc/sys/rmdir.2 b/lib/libc/sys/rmdir.2 index e480708cfb5..963c45023ee 100644 --- a/lib/libc/sys/rmdir.2 +++ b/lib/libc/sys/rmdir.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rmdir.2,v 1.6 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: rmdir.2,v 1.7 1999/06/29 14:10:16 aaron Exp $ .\" $NetBSD: rmdir.2,v 1.7 1995/02/27 12:36:30 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -55,7 +55,7 @@ than and .Ql \&.. . .Sh RETURN VALUES -A 0 is returned if the remove succeeds; otherwise a -1 is +A 0 is returned if the remove succeeds; otherwise a \-1 is returned and an error code is stored in the global location .Va errno . .Sh ERRORS @@ -64,9 +64,9 @@ The named file is removed unless: .It Bq Er ENOTDIR A component of the path is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 662e23e2d5f..fe5e4bd84bd 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: select.2,v 1.13 1999/05/23 14:10:55 aaron Exp $ +.\" $OpenBSD: select.2,v 1.14 1999/06/29 14:10:17 aaron Exp $ .\" $NetBSD: select.2,v 1.5 1995/06/27 22:32:28 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -104,12 +104,12 @@ to the maximum number of descriptors supported by the system. .Pp If .Fa timeout -is a non-nil pointer, it specifies a maximum interval to wait for the -selection to complete. If +is a non-null pointer, it specifies a maximum interval to wait for the +selection to complete. If .Fa timeout -is a nil pointer, the select blocks indefinitely. To effect a poll, the +is a null pointer, the select blocks indefinitely. To effect a poll, the .Fa timeout -argument should be non-nil, pointing to a zero-valued timeval structure. +argument should be non-null, pointing to a zero-valued timeval structure. .Fa timeout is not changed by .Fn select , @@ -122,12 +122,12 @@ Any of .Fa writefds , and .Fa exceptfds -may be given as nil pointers if no descriptors are of interest. +may be given as null pointers if no descriptors are of interest. .Sh RETURN VALUES .Fn select returns the number of ready descriptors that are contained in the descriptor sets, -or -1 if an error occurred. +or \-1 if an error occurred. If the time limit expires, .Fn select returns 0. diff --git a/lib/libc/sys/semctl.2 b/lib/libc/sys/semctl.2 index 1b4b8c1c702..c5da566a05b 100644 --- a/lib/libc/sys/semctl.2 +++ b/lib/libc/sys/semctl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: semctl.2,v 1.9 1999/06/05 04:16:08 aaron Exp $ +.\" $OpenBSD: semctl.2,v 1.10 1999/06/29 14:10:17 aaron Exp $ .\" $NetBSD: semctl.2,v 1.2 1997/03/27 08:20:40 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -120,7 +120,7 @@ Return the number of processes waiting to acquire the semaphore. Return the number of processes waiting for the value of the semaphore to reach 0. .It Dv GETALL -Return the values for all the semaphores associated with +Return the values for all the semaphores associated with .Fa semid . .It Dv SETALL Set the values for all the semaphores that are associated with the semaphore @@ -147,7 +147,7 @@ The values are taken from the corresponding fields in the structure pointed to by .Fa arg.buf . This operation can only be executed by the super-user, or a process that -has an effective user ID equal to either +has an effective user ID equal to either .Va sem_perm.cuid or .Va sem_perm.uid @@ -156,7 +156,7 @@ in the data structure associated with the message queue. Remove the semaphores associated with .Fa semid from the system and destroy the data structures associated with it. Only the -super-user or a process with an effective UID equal to the +super-user or a process with an effective UID equal to the .Va sem_perm.cuid or .Va sem_perm.uid @@ -191,7 +191,7 @@ operations, returns one of the values described above if successful. All other operations will make .Fn semctl -return 0 if no errors occur. Otherwise -1 is returned and +return 0 if no errors occur. Otherwise \-1 is returned and .Va errno set to reflect the error. .Sh ERRORS diff --git a/lib/libc/sys/semget.2 b/lib/libc/sys/semget.2 index b8646815175..3a5e58a517d 100644 --- a/lib/libc/sys/semget.2 +++ b/lib/libc/sys/semget.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: semget.2,v 1.9 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: semget.2,v 1.10 1999/06/29 14:10:17 aaron Exp $ .\" $NetBSD: semget.2,v 1.2 1997/03/27 08:20:41 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -50,7 +50,7 @@ system call returns the semaphore identifier associated with .Pp A new set containing .Fa nsems -semaphores is created if either +semaphores is created if either .Fa key is equal to .Dv IPC_PRIVATE , @@ -85,7 +85,7 @@ structure, see .Xr semctl 2 ) is intialized as follows: .Bl -bullet -.It +.It .Va sem_perm.cuid and .Va sem_perm.uid @@ -112,7 +112,7 @@ is set to 0 .El .Sh RETURN VALUES .Fn semget -returns a non-negative semaphore identifier if successful. Otherwise, -1 +returns a non-negative semaphore identifier if successful. Otherwise, \-1 is returned and .Va errno is set to reflect the error. diff --git a/lib/libc/sys/semop.2 b/lib/libc/sys/semop.2 index 6d70c6d38be..7fb2d17ade3 100644 --- a/lib/libc/sys/semop.2 +++ b/lib/libc/sys/semop.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: semop.2,v 1.6 1999/05/27 16:54:23 aaron Exp $ +.\" $OpenBSD: semop.2,v 1.7 1999/06/29 14:10:18 aaron Exp $ .\" $NetBSD: semop.2,v 1.1 1995/10/16 23:49:28 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -48,7 +48,7 @@ provides a number of atomic operations on a set of semaphores. The semaphore set is specified by .Fa semid . .Fa sops -is an array of semaphore operations, +is an array of semaphore operations, .Fa nsops is the number of operations in this array. The .Va sembuf @@ -99,7 +99,7 @@ In the case where the calling process would normally block, waiting for a semaphore to reach a certain value, .Dv IPC_NOWAIT makes the -call return immediately, returning a value of -1 and setting +call return immediately, returning a value of \-1 and setting .Va errno to .Er EAGAIN . @@ -111,7 +111,7 @@ should the process that has the semaphore locked terminate in a critical section. .El .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. Otherwise, -1 is +Upon successful completion, a value of 0 is returned. Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index d2ddaba83c6..15425903d08 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: send.2,v 1.15 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: send.2,v 1.16 1999/06/29 14:10:18 aaron Exp $ .\" $NetBSD: send.2,v 1.6 1996/01/15 01:17:18 thorpej Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -58,9 +58,9 @@ and .Fn sendmsg are used to transmit a message to another socket. .Fn send -may be used only when the socket is in a +may be used only when the socket is in a .Em connected -state, while +state, while .Fn sendto and .Fn sendmsg @@ -68,7 +68,7 @@ may be used at any time. .Pp The address of the target is given by .Fa to -with +with .Fa tolen specifying its size. The length of the message is given by @@ -81,7 +81,7 @@ the message is not transmitted. .Pp No indication of failure to deliver is implicit in a .Fn send . -Locally detected errors are indicated by a return value of -1. +Locally detected errors are indicated by a return value of \-1. .Pp If no messages space is available at the socket to hold the message to be transmitted, then @@ -113,13 +113,13 @@ data. .Dv MSG_DONTROUTE is usually used only by diagnostic or routing programs. .Pp -See +See .Xr recv 2 for a description of the .Fa msghdr structure. .Sh RETURN VALUES -The call returns the number of characters sent, or -1 +The call returns the number of characters sent, or \-1 if an error occurred. .Sh ERRORS .Fn send , @@ -150,7 +150,9 @@ The output queue for a network interface was full. This generally indicates that the interface has stopped sending, but may be caused by transient congestion. .It Bq Er EACCES -The SO_BROADCAST option is not set on the socket, and a broadcast address +The +.Dv SO_BROADCAST +option is not set on the socket, and a broadcast address was given as the destination. .It Bq Er EHOSTUNREACH The destination address specified an unreachable host. @@ -181,7 +183,7 @@ and may return the following error: .Bl -tag -width Er .It Bq Er EINVAL -.Fa len +.Fa len was larger than .Dv SSIZE_MAX . .El diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 18de110e0ac..0ca2f089d87 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setgroups.2,v 1.5 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: setgroups.2,v 1.6 1999/06/29 14:10:18 aaron Exp $ .\" $NetBSD: setgroups.2,v 1.7 1995/02/27 12:36:49 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993, 1994 @@ -48,7 +48,7 @@ .Sh DESCRIPTION .Fn setgroups sets the group access list of the current user process -according to the array +according to the array .Fa gidset . The parameter .Fa ngroups @@ -58,7 +58,7 @@ more than .Pp Only the super-user may set new groups. .Sh RETURN VALUES -A 0 value is returned on success, -1 on error, with +A 0 value is returned on success, \-1 on error, with an error code stored in .Va errno . .Sh ERRORS @@ -67,7 +67,7 @@ The call will fail if: .Bl -tag -width Er .It Bq Er EINVAL -The value of +The value of .Fa ngroups is greater than .Dv {NGROUPS_MAX} . diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2 index 17479fb783f..cca08b54f88 100644 --- a/lib/libc/sys/setpgid.2 +++ b/lib/libc/sys/setpgid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setpgid.2,v 1.6 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: setpgid.2,v 1.7 1999/06/29 14:10:19 aaron Exp $ .\" $NetBSD: setpgid.2,v 1.8 1995/02/27 12:36:55 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -63,7 +63,7 @@ of the invoking process. .Sh RETURN VALUES .Fn setpgid returns 0 when the operation was successful. -If the request failed, -1 is returned and the global variable +If the request failed, \-1 is returned and the global variable .Va errno indicates the reason. .Sh ERRORS @@ -73,7 +73,7 @@ will fail and the process group will not be altered if: .It Bq Er EACCES The value of the .Fa pid -argument matches the process ID of a child process of the calling process, +argument matches the process ID of a child process of the calling process, and the child process has successfully executed one of the exec functions. .It Bq Er EINVAL The value of the @@ -84,9 +84,9 @@ The effective user ID of the requested process is different from that of the caller and the process is not a descendant of the calling process. .It Bq Er ESRCH -The value of the -.Fa pid -argument does not match the process ID of the calling process or of a +The value of the +.Fa pid +argument does not match the process ID of the calling process or of a child process of the calling process. .El .Sh SEE ALSO @@ -94,7 +94,7 @@ child process of the calling process. .Sh STANDARDS The .Fn setpgid -function conforms to +function conforms to .St -p1003.1-88 . .Sh COMPATIBILITY .Fn setpgrp diff --git a/lib/libc/sys/setsid.2 b/lib/libc/sys/setsid.2 index 2f57e1d2999..f4a397f83ce 100644 --- a/lib/libc/sys/setsid.2 +++ b/lib/libc/sys/setsid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setsid.2,v 1.8 1999/05/16 19:55:37 alex Exp $ +.\" $OpenBSD: setsid.2,v 1.9 1999/06/29 14:10:19 aaron Exp $ .\" $NetBSD: setsid.2,v 1.3 1995/10/12 15:41:13 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -61,7 +61,7 @@ group, which is the same as the process ID of the calling process. .Sh ERRORS If an error occurs, .Nm setsid -returns -1 and the global variable +returns \-1 and the global variable .Va errno is set to indicate the error, as follows: .Bl -tag -width Er diff --git a/lib/libc/sys/setuid.2 b/lib/libc/sys/setuid.2 index 0f1c1981ae0..57ea5540fec 100644 --- a/lib/libc/sys/setuid.2 +++ b/lib/libc/sys/setuid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setuid.2,v 1.7 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: setuid.2,v 1.8 1999/06/29 14:10:19 aaron Exp $ .\" $NetBSD: setuid.2,v 1.3 1995/02/27 12:37:06 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -125,7 +125,7 @@ The .Fn seteuid and .Fn setegid -functions are extensions based on the +functions are extensions based on the .Tn POSIX concept of .Li _POSIX_SAVED_IDS , diff --git a/lib/libc/sys/shmat.2 b/lib/libc/sys/shmat.2 index 960fe6759b6..8e20b9d4650 100644 --- a/lib/libc/sys/shmat.2 +++ b/lib/libc/sys/shmat.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: shmat.2,v 1.7 1999/05/27 16:54:23 aaron Exp $ +.\" $OpenBSD: shmat.2,v 1.8 1999/06/29 14:10:19 aaron Exp $ .\" $NetBSD: shmat.2,v 1.2 1997/03/27 08:20:38 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -56,15 +56,21 @@ parameter. If it is equal to 0, the system will pick an address itself. Otherwise, an attempt is made to map the shared memory segment at the address .Fa shmaddr -specifies. If SHM_RND is set in +specifies. If +.Dv SHM_RND +is set in .Fa shmflg , -the system will round the address down to a multiple of SHMLBA bytes -(SHMLBA is defined in +the system will round the address down to a multiple of +.Dv SHMLBA +bytes +.Pf ( Dv SHMLBA +is defined in .Aq Pa sys/shm.h ). .Pp A shared memory segment can be mapped read-only by specifying the -SHM_RDONLY flag in +.Dv SHM_RDONLY +flag in .Fa shmflg . .Pp .Fn shmdt @@ -83,9 +89,9 @@ command. .Sh RETURN VALUES .Fn shmat returns the address at which the shared memory segment has been mapped into -the calling process' address space when successful, +the calling process' address space when successful, .Fn shmdt -returns 0 on successful completion. Otherwise, a value of -1 is returned, +returns 0 on successful completion. Otherwise, a value of \-1 is returned, and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/shmctl.2 b/lib/libc/sys/shmctl.2 index 4e1bf42ca80..02498ebf7a9 100644 --- a/lib/libc/sys/shmctl.2 +++ b/lib/libc/sys/shmctl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: shmctl.2,v 1.9 1999/06/05 04:16:08 aaron Exp $ +.\" $OpenBSD: shmctl.2,v 1.10 1999/06/29 14:10:20 aaron Exp $ .\" $NetBSD: shmctl.2,v 1.3 1997/03/27 08:20:39 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -116,7 +116,7 @@ The values are taken from the corresponding fields in the structure pointed to by .Fa buf . This operation can only be executed by the super-user, or a process that -has an effective user ID equal to either +has an effective user ID equal to either .Va shm_perm.cuid or .Va shm_perm.uid @@ -126,7 +126,7 @@ in the data structure associated with the shared memory segment. Remove the shared memory segment specified by .Fa shmid and destroy the data associated with it. Only the super-user or a process -with an effective UID equal to the +with an effective UID equal to the .Va shm_perm.cuid or .Va shm_perm.uid @@ -149,7 +149,7 @@ effective GID can match either or .Va shm_perm.gid . .Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. Otherwise, -1 is +Upon successful completion, a value of 0 is returned. Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2 index 97ac040344e..301f9b8b9f1 100644 --- a/lib/libc/sys/shmget.2 +++ b/lib/libc/sys/shmget.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: shmget.2,v 1.6 1999/05/27 14:05:10 aaron Exp $ +.\" $OpenBSD: shmget.2,v 1.7 1999/06/29 14:10:20 aaron Exp $ .\" $NetBSD: shmget.2,v 1.2 1997/03/27 08:20:39 mikel Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden @@ -64,7 +64,7 @@ structure, see .Xr shmctl 2 ) is initialized as follows: .Bl -bullet -.It +.It .Va shm_perm.cuid and .Va shm_perm.uid @@ -82,7 +82,7 @@ is set to the lower 9 bits of .Va shm_lpid , .Va shm_nattch , .Va shm_atime , -and +and .Va shm_dtime are set to 0 .It @@ -95,7 +95,7 @@ is set to the value of .El .Sh RETURN VALUES Upon successful completion a positive shared memory segment identifier is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/shutdown.2 b/lib/libc/sys/shutdown.2 index 7fc94cb0910..30fd2b3636d 100644 --- a/lib/libc/sys/shutdown.2 +++ b/lib/libc/sys/shutdown.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: shutdown.2,v 1.7 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: shutdown.2,v 1.8 1999/06/29 14:10:21 aaron Exp $ .\" $NetBSD: shutdown.2,v 1.5 1995/02/27 12:37:11 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -68,7 +68,7 @@ is .Ar SHUT_RDWR , further sends and receives will be disallowed. .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +A 0 is returned if the call succeeds, \-1 if it fails. .Sh ERRORS The call succeeds unless: .Bl -tag -width Er diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index 81c9e2d585b..9fdd5ad3e3c 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaction.2,v 1.19 1999/05/10 17:56:29 aaron Exp $ +.\" $OpenBSD: sigaction.2,v 1.20 1999/06/29 14:10:21 aaron Exp $ .\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -207,7 +207,7 @@ the calling process exit. If the calling process subsequently issues a .Xr wait 2 (or equivalent), it blocks until all of the calling process's child -processes terminate, and then returns a value of -1 with errno set to +processes terminate, and then returns a value of \-1 with errno set to .Dv ECHILD . .It Dv SA_ONSTACK If this bit is set, the system will deliver the signal to the process @@ -348,7 +348,9 @@ handler(sig) int sig; .Pp .Ed -If the SA_SIGINFO option is enabled, the canonical way to declare it is: +If the +.Dv SA_SIGINFO +option is enabled, the canonical way to declare it is: .Bd -literal -offset indent void handler(sig, sip, scp) @@ -371,7 +373,9 @@ as described in .Pa <sys/siginfo.h> . If .Dv SA_SIGINFO -is not set, this pointer will be NULL instead. +is not set, this pointer will be +.Dv NULL +instead. The function specified in .Fa sa_sigaction will be called instead of the function specified by diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index 6fbe7376c36..2fe6c3bd5ae 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaltstack.2,v 1.8 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: sigaltstack.2,v 1.9 1999/06/29 14:10:21 aaron Exp $ .\" $NetBSD: sigaltstack.2,v 1.3 1995/02/27 10:41:52 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1992, 1993 @@ -72,7 +72,7 @@ call), the system checks to see if the process is currently executing on that stack. If the process is not currently executing on the signal stack, the system arranges a switch to the signal stack for the -duration of the signal handler's execution. +duration of the signal handler's execution. .Pp If .Dv SS_DISABLE @@ -84,7 +84,7 @@ and are ignored and the signal stack will be disabled. Trying to disable an active stack will cause .Nm -to return -1 with +to return \-1 with .Va errno set to .Dv EINVAL . @@ -137,7 +137,7 @@ If the stack overflows and this space is not protected unpredictable results may occur. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/sigprocmask.2 b/lib/libc/sys/sigprocmask.2 index 62bd8928776..3b8e9ac9e15 100644 --- a/lib/libc/sys/sigprocmask.2 +++ b/lib/libc/sys/sigprocmask.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigprocmask.2,v 1.3 1999/05/16 19:55:38 alex Exp $ +.\" $OpenBSD: sigprocmask.2,v 1.4 1999/06/29 14:10:22 aaron Exp $ .\" $NetBSD: sigprocmask.2,v 1.6 1995/02/27 12:37:33 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -96,7 +96,7 @@ or .Dv SIGSTOP to be blocked. .Sh RETURN VALUES -A 0 value indicated that the call succeeded. A -1 return value +A 0 value indicated that the call succeeded. A \-1 return value indicates an error occurred and .Va errno is set to indicated the reason. diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index f9b83c7ba91..eb87ec7eb69 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigreturn.2,v 1.6 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: sigreturn.2,v 1.7 1999/06/29 14:10:22 aaron Exp $ .\" $NetBSD: sigreturn.2,v 1.6 1995/02/27 12:37:40 cgd Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 @@ -65,7 +65,7 @@ This system call is not available in 4.2 hence it should not be used if backward compatibility is needed. .Sh RETURN VALUES If successful, the system call does not return. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/sigstack.2 b/lib/libc/sys/sigstack.2 index 5d2ee27ac61..0e8b3745950 100644 --- a/lib/libc/sys/sigstack.2 +++ b/lib/libc/sys/sigstack.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigstack.2,v 1.3 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: sigstack.2,v 1.4 1999/06/29 14:10:23 aaron Exp $ .\" $NetBSD: sigstack.2,v 1.5 1995/02/27 13:21:35 cgd Exp $ .\" .\" Copyright (c) 1983, 1992, 1993 @@ -41,7 +41,7 @@ .Nm sigstack .Nd set and/or get signal stack context .Sh DESCRIPTION -The +The .Fn sigstack function has been deprecated in favor of the interface described in .Xr sigaltstack 2 . diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2 index 744e701eb4c..a901f63d26c 100644 --- a/lib/libc/sys/sigsuspend.2 +++ b/lib/libc/sys/sigsuspend.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigsuspend.2,v 1.4 1999/05/16 19:55:39 alex Exp $ +.\" $OpenBSD: sigsuspend.2,v 1.5 1999/06/29 14:10:23 aaron Exp $ .\" $NetBSD: sigsuspend.2,v 1.4 1995/02/27 12:37:46 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -67,7 +67,7 @@ with the previous mask returned by The .Fn sigsuspend function -always terminates by being interrupted, returning -1 with +always terminates by being interrupted, returning \-1 with .Va errno set to .Dv EINTR . diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index 2d7fe8dab22..a7356916e21 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: socket.2,v 1.10 1999/06/25 04:10:08 aaron Exp $ +.\" $OpenBSD: socket.2,v 1.11 1999/06/29 14:10:23 aaron Exp $ .\" $NetBSD: socket.2,v 1.5 1995/02/27 12:37:53 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -134,7 +134,7 @@ call. Once connected, data may be transferred using .Xr read 2 and .Xr write 2 -calls or some variant of the +calls or some variant of the .Xr send 2 and .Xr recv 2 @@ -154,7 +154,7 @@ peer protocol has buffer space cannot be successfully transmitted within a reasonable length of time, then the connection is considered broken and calls will indicate an error with --1 returns and with +\-1 returns and with .Dv ETIMEDOUT as the specific code in the global variable @@ -177,7 +177,7 @@ sockets employ the same system calls as .Dv SOCK_STREAM sockets. The only difference -is that +is that .Xr read 2 calls will return only the amount of data requested, and any remaining in the arriving packet will be discarded. @@ -192,7 +192,7 @@ calls. Datagrams are generally received with .Xr recvfrom 2 , which returns the next datagram with its return address. .Pp -An +An .Xr fcntl 2 call can be used to specify a process group to receive a @@ -212,7 +212,7 @@ and .Xr getsockopt 2 are used to set and get options, respectively. .Sh RETURN VALUES -A -1 is returned if an error occurs, otherwise the return +A \-1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket. .Sh ERRORS The diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2 index e0d5a590daa..28b8845772c 100644 --- a/lib/libc/sys/socketpair.2 +++ b/lib/libc/sys/socketpair.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: socketpair.2,v 1.8 1999/05/27 16:54:24 aaron Exp $ +.\" $OpenBSD: socketpair.2,v 1.9 1999/06/29 14:10:24 aaron Exp $ .\" $NetBSD: socketpair.2,v 1.5 1995/02/27 12:38:00 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -62,7 +62,7 @@ and .Fa sv Ns [1] . The two sockets are indistinguishable. .Sh RETURN VALUES -A 0 is returned if the call succeeds, -1 if it fails. +A 0 is returned if the call succeeds, \-1 if it fails. .Sh ERRORS The call succeeds unless: .Bl -tag -width Er diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index c522f2d54db..eabd4bb2bbb 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: stat.2,v 1.8 1999/05/25 21:16:26 aaron Exp $ +.\" $OpenBSD: stat.2,v 1.9 1999/06/29 14:10:24 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -188,7 +188,7 @@ and .Xr chmod 2 . .Sh RETURN VALUES Upon successful completion a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh COMPATIBILITY @@ -211,9 +211,9 @@ will fail if: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -274,7 +274,7 @@ The .Fn stat and .Fn fstat -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-88 . .Sh HISTORY An diff --git a/lib/libc/sys/statfs.2 b/lib/libc/sys/statfs.2 index 3b80f94e48b..b09b973db94 100644 --- a/lib/libc/sys/statfs.2 +++ b/lib/libc/sys/statfs.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: statfs.2,v 1.10 1999/05/31 17:34:41 millert Exp $ +.\" $OpenBSD: statfs.2,v 1.11 1999/06/29 14:10:25 aaron Exp $ .\" $NetBSD: statfs.2,v 1.10 1995/06/29 11:40:48 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -88,7 +88,7 @@ returns the same information about an open file referenced by descriptor .Fa fd . .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, -1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -102,11 +102,11 @@ is not a directory. .It Bq Er ENAMETOOLONG The length of a component of .Fa path -exceeds +exceeds .Dv {NAME_MAX} characters, or the length of .Fa path -exceeds +exceeds .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/swapctl.2 b/lib/libc/sys/swapctl.2 index c74501680cf..bb24923f484 100644 --- a/lib/libc/sys/swapctl.2 +++ b/lib/libc/sys/swapctl.2 @@ -152,7 +152,7 @@ or .Fn swapctl returns the number of swap devices, if successful. The .Dv SWAP_NSWAP -command is always successful. Otherwise it returns 0 on success and -1 +command is always successful. Otherwise it returns 0 on success and \-1 on failure, setting the global variable .Va errno to indicate the error. @@ -163,9 +163,9 @@ succeeds unless: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv NAME_MAX -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv PATH_MAX characters. .It Bq Er ENOENT @@ -189,7 +189,7 @@ has no associated size, or the .Fa cmd was unknown. .It Bq Er ENXIO -The major device number of +The major device number of .Fa arg is out of range (this indicates no device driver exists for the associated hardware). diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index b5bb1e13e6c..218570bcf84 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: swapon.2,v 1.6 1999/05/27 20:49:36 aaron Exp $ +.\" $OpenBSD: swapon.2,v 1.7 1999/06/29 14:10:25 aaron Exp $ .\" $NetBSD: swapon.2,v 1.7 1995/02/27 12:38:21 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -46,17 +46,17 @@ .Fn swapon "const char *special" .Sh DESCRIPTION .Fn swapon -makes the block device +makes the block device .Fa special available to the system for allocation for paging and swapping. The names of potentially available devices are known to the system and defined at system -configuration time. The size of the swap area on +configuration time. The size of the swap area on .Fa special is calculated at the time the device is first made available for swapping. .Sh RETURN VALUES -If an error has occurred, a value of -1 is returned and +If an error has occurred, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -66,9 +66,9 @@ succeeds unless: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -93,7 +93,7 @@ The device configured by was not configured into the system as a swap device. .It Bq Er ENXIO -The major device number of +The major device number of .Fa special is out of range (this indicates no device driver exists for the associated hardware). diff --git a/lib/libc/sys/symlink.2 b/lib/libc/sys/symlink.2 index 944c65cbac8..b82fda88a2d 100644 --- a/lib/libc/sys/symlink.2 +++ b/lib/libc/sys/symlink.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: symlink.2,v 1.9 1999/05/26 03:16:22 aaron Exp $ +.\" $OpenBSD: symlink.2,v 1.10 1999/06/29 14:10:26 aaron Exp $ .\" $NetBSD: symlink.2,v 1.7 1995/02/27 12:38:34 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -63,7 +63,7 @@ need not exist at all. Upon successful completion, a zero value is returned. If an error occurs, the error code is stored in .Va errno -and a -1 value is returned. +and a \-1 value is returned. .Sh ERRORS The symbolic link succeeds unless: .Bl -tag -width Er @@ -72,9 +72,9 @@ A component of the .Fa name2 prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index 590f33519b5..fb269f355d0 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sync.2,v 1.4 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: sync.2,v 1.5 1999/06/29 14:10:26 aaron Exp $ .\" $NetBSD: sync.2,v 1.4 1995/02/27 12:38:41 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -45,7 +45,7 @@ .Ft void .Fn sync void .Sh DESCRIPTION -The +The .Fn sync function forces a write of dirty (modified) buffers in the block buffer cache out @@ -57,7 +57,7 @@ call is issued frequently by the user process .Xr update 8 -(about every 30 seconds). +(about every 30 seconds). .Pp The function .Xr fsync 2 @@ -73,5 +73,5 @@ may return before the buffers are completely flushed. .Sh HISTORY A .Fn sync -function call appeared in +function call appeared in .At v6 . diff --git a/lib/libc/sys/syscall.2 b/lib/libc/sys/syscall.2 index 1982ea870c1..a5c3a32a90d 100644 --- a/lib/libc/sys/syscall.2 +++ b/lib/libc/sys/syscall.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: syscall.2,v 1.4 1999/05/23 14:10:56 aaron Exp $ +.\" $OpenBSD: syscall.2,v 1.5 1999/06/29 14:10:26 aaron Exp $ .\" $NetBSD: syscall.2,v 1.4 1995/02/27 12:38:53 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -65,7 +65,7 @@ do not have entries in the C library. .Sh RETURN VALUES The return values are defined by the system call being invoked. In general, a 0 return value indicates success. -A -1 return value indicates an error, +A \-1 return value indicates an error, and an error code is stored in .Va errno . .Sh BUGS diff --git a/lib/libc/sys/truncate.2 b/lib/libc/sys/truncate.2 index 64115039b94..5cee80f4347 100644 --- a/lib/libc/sys/truncate.2 +++ b/lib/libc/sys/truncate.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: truncate.2,v 1.5 1999/05/23 14:10:57 aaron Exp $ +.\" $OpenBSD: truncate.2,v 1.6 1999/06/29 14:10:27 aaron Exp $ .\" $NetBSD: truncate.2,v 1.7 1995/02/27 12:39:00 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -63,7 +63,7 @@ With the file must be open for writing. .Sh RETURN VALUES A value of 0 is returned if the call succeeds. If the call -fails a -1 is returned, and the global variable +fails a \-1 is returned, and the global variable .Va errno specifies the error. .Sh ERRORS @@ -73,9 +73,9 @@ succeeds unless: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/umask.2 b/lib/libc/sys/umask.2 index e8f1adeeed2..77b7b4eafcf 100644 --- a/lib/libc/sys/umask.2 +++ b/lib/libc/sys/umask.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: umask.2,v 1.3 1999/05/23 14:10:57 aaron Exp $ +.\" $OpenBSD: umask.2,v 1.4 1999/06/29 14:10:27 aaron Exp $ .\" $NetBSD: umask.2,v 1.6 1995/02/27 12:39:06 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -86,5 +86,5 @@ function is always successful. The .Fn umask function call is expected to -conform to +conform to .St -p1003.1-88 . diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2 index c947268ea29..c3089723f19 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: unlink.2,v 1.7 1999/05/23 14:10:57 aaron Exp $ +.\" $OpenBSD: unlink.2,v 1.8 1999/06/29 14:10:28 aaron Exp $ .\" $NetBSD: unlink.2,v 1.7 1995/02/27 12:39:13 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -61,7 +61,7 @@ the link is removed, but the removal of the file is delayed until all references to it have been closed. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -72,9 +72,9 @@ succeeds unless: .It Bq Er ENOTDIR A component of the path prefix is not a directory. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT @@ -116,5 +116,5 @@ points outside the process's allocated address space. .Sh HISTORY An .Fn unlink -function call appeared in +function call appeared in .At v6 . diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index e9d0abf8637..16c426e7076 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: utimes.2,v 1.5 1999/05/23 14:10:57 aaron Exp $ +.\" $OpenBSD: utimes.2,v 1.6 1999/06/29 14:10:28 aaron Exp $ .\" $NetBSD: utimes.2,v 1.9 1996/04/23 10:34:16 mycroft Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -54,9 +54,9 @@ or referenced by are changed as specified by the argument .Fa times . .Pp -If +If .Fa times -is +is .Dv NULL , the access and modification times are set to the current time. The caller must be the owner of the file, have permission to @@ -64,8 +64,7 @@ write the file, or be the super-user. .Pp If .Fa times -is -.Pf non- Dv NULL , +is non-null, it is assumed to point to an array of two timeval structures. The access time is set to the value of the first element, and the modification time is set to the value of the second element. @@ -75,7 +74,7 @@ In either case, the inode-change-time of the file is set to the current time. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. .Sh ERRORS @@ -101,9 +100,9 @@ An I/O error occurred while reading or writing the affected inode. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv {NAME_MAX} -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv {PATH_MAX} characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index c0363709210..1b83bb110c8 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: vfork.2,v 1.10 1999/05/23 14:10:57 aaron Exp $ +.\" $OpenBSD: vfork.2,v 1.11 1999/06/29 14:10:28 aaron Exp $ .\" $NetBSD: vfork.2,v 1.8 1997/07/10 07:54:13 mikel Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -52,7 +52,7 @@ environment. It was useful when the purpose of .Xr fork 2 would have been to create a new system context for an .Xr execve . -It is the case that +It is the case that .Xr fork is now efficient, even in the above case, so that the need for .Fn vfork diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index cc250fec7eb..7ce0ef63d9e 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: wait.2,v 1.8 1999/06/05 04:47:42 aaron Exp $ +.\" $OpenBSD: wait.2,v 1.9 1999/06/29 14:10:31 aaron Exp $ .\" $NetBSD: wait.2,v 1.6 1995/02/27 12:39:37 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -63,9 +63,9 @@ function suspends execution of its calling process until .Fa status information is available for a terminated child process, or a signal is received. -On return from a successful +On return from a successful .Fn wait -call, +call, the .Fa status area contains termination information about the process that exited @@ -85,18 +85,18 @@ The parameter specifies the set of child processes for which to wait. If .Fa wpid -is -1, the call waits for any child process. +is \-1, the call waits for any child process. If .Fa wpid is 0, the call waits for any child process in the process group of the caller. If .Fa wpid -is greater than zero, the call waits for the process with process id +is greater than zero, the call waits for the process with process ID .Fa wpid . If .Fa wpid -is less than -1, the call waits for any process whose process group id +is less than \-1, the call waits for any process whose process group ID equals the absolute value of .Fa wpid . .Pp @@ -133,10 +133,10 @@ for stopped processes). When the .Dv WNOHANG option is specified and no processes -wish to report status, +wish to report status, .Fn wait4 -returns a -process id +returns a +process ID of 0. .Pp The @@ -152,7 +152,7 @@ call is the same as .Fn wait4 with a .Fa wpid -value of -1. +value of \-1. .Pp The following macros may be used to test the manner of exit of the process. One of the first three macros will evaluate to a non-zero (true) value: @@ -227,7 +227,7 @@ If .Fn wait returns due to a stopped or terminated child process, the process ID of the child -is returned to the calling process. Otherwise, a value of -1 +is returned to the calling process. Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. @@ -241,7 +241,7 @@ returns due to a stopped or terminated child process, the process ID of the child is returned to the calling process. If there are no children not previously awaited, --1 is returned with +\-1 is returned with .Va errno set to .Bq Er ECHILD . @@ -251,7 +251,7 @@ is specified and there are no stopped or exited children, 0 is returned. If an error is detected or a caught signal aborts the call, -a value of -1 +a value of \-1 is returned and .Va errno is set to indicate the error. @@ -302,5 +302,5 @@ call are extensions to the POSIX interface. .Sh HISTORY A .Fn wait -function call appeared in +function call appeared in .At v6 . diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 1c9d22d3937..c1abe14981e 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: write.2,v 1.11 1999/05/23 14:10:57 aaron Exp $ +.\" $OpenBSD: write.2,v 1.12 1999/06/29 14:10:32 aaron Exp $ .\" $NetBSD: write.2,v 1.6 1995/02/27 12:39:43 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -56,18 +56,18 @@ attempts to write of data to the object referenced by the descriptor .Fa d from the buffer pointed to by -.Fa buf . +.Fa buf . .Fn \ Writev performs the same action, but gathers the output data -from the +from the .Fa iovcnt buffers specified by the members of the .Fa iov array: iov[0], iov[1], ..., iov[iovcnt\|-\|1]. .Pp -For +For .Fn writev , -the +the .Fa iovec structure is defined as: .Pp @@ -78,7 +78,7 @@ struct iovec { }; .Ed .Pp -Each +Each .Fa iovec entry specifies the base address and length of an area in memory from which data should be written. @@ -124,16 +124,16 @@ and may write fewer bytes than requested; the return value must be noted, and the remainder of the operation should be retried when possible. -.Pp -Note that -.Fn writev -will fail if the value of -.Fa iovcnt +.Pp +Note that +.Fn writev +will fail if the value of +.Fa iovcnt exceedes the constant -.Dv IOV_MAX . +.Dv IOV_MAX . .Sh RETURN VALUES Upon successful completion the number of bytes which were written -is returned. Otherwise a -1 is returned and the global variable +is returned. Otherwise a \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -150,7 +150,7 @@ An attempt is made to write to a pipe that is not open for reading by any process. .It Bq Er EPIPE An attempt is made to write to a socket of type -.DV SOCK_STREAM +.Dv SOCK_STREAM that is not connected to a peer socket. .It Bq Er EFBIG An attempt was made to write a file that exceeds the process's |