diff options
Diffstat (limited to 'lib/libc')
108 files changed, 406 insertions, 406 deletions
diff --git a/lib/libc/compat-43/creat.3 b/lib/libc/compat-43/creat.3 index d512066d17e..cd7f90c0ebf 100644 --- a/lib/libc/compat-43/creat.3 +++ b/lib/libc/compat-43/creat.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: creat.3,v 1.2 1996/08/19 08:19:17 tholo Exp $ +.\" $OpenBSD: creat.3,v 1.3 1999/02/27 21:54:48 deraadt Exp $ .\" .Dd June 23, 1991 .Dt CREAT 3 @@ -49,7 +49,7 @@ This interface is made obsolete by: .Ef .Xr open 2 . .Pp -.Fn Creat +.Fn creat is the same as: .Bd -literal -offset indent open(path, O_CREAT | O_TRUNC | O_WRONLY, mode); diff --git a/lib/libc/compat-43/gethostid.3 b/lib/libc/compat-43/gethostid.3 index 4c0fccb8d6d..e0c2b00e0d2 100644 --- a/lib/libc/compat-43/gethostid.3 +++ b/lib/libc/compat-43/gethostid.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: gethostid.3,v 1.2 1996/08/19 08:19:22 tholo Exp $ +.\" $OpenBSD: gethostid.3,v 1.3 1999/02/27 21:54:49 deraadt Exp $ .\" .Dd June 2, 1993 .Dt GETHOSTID 3 @@ -45,14 +45,14 @@ .Ft int .Fn sethostid "long hostid" .Sh DESCRIPTION -.Fn Sethostid +.Fn sethostid establishes a 32-bit identifier for the current processor that is intended to be unique among all UNIX systems in existence. This is normally a DARPA Internet address for the local machine. This call is allowed only to the super-user and is normally performed at boot time. .Pp -.Fn Gethostid +.Fn gethostid returns the 32-bit identifier for the current processor. .Pp This function has been deprecated. diff --git a/lib/libc/compat-43/killpg.3 b/lib/libc/compat-43/killpg.3 index 9b402532086..4990e487a6a 100644 --- a/lib/libc/compat-43/killpg.3 +++ b/lib/libc/compat-43/killpg.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: killpg.3,v 1.2 1996/08/19 08:19:25 tholo Exp $ +.\" $OpenBSD: killpg.3,v 1.3 1999/02/27 21:54:50 deraadt Exp $ .\" .Dd March 10, 1991 .Dt KILLPG 3 @@ -42,7 +42,7 @@ .Ft int .Fn killpg "pid_t pgrp" "int sig" .Sh DESCRIPTION -.Fn Killpg +.Fn killpg sends the signal .Fa sig to the process group @@ -67,11 +67,11 @@ a value of -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Killpg +.Fn killpg will fail and no signal will be sent if: .Bl -tag -width Er .It Bq Er EINVAL -.Fa Sig +.Fa sig is not a valid signal number. .It Bq Er ESRCH No process can be found in the process group specified by diff --git a/lib/libc/compat-43/sigblock.3 b/lib/libc/compat-43/sigblock.3 index 80b715efb0f..4e7dcdc30ca 100644 --- a/lib/libc/compat-43/sigblock.3 +++ b/lib/libc/compat-43/sigblock.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: sigblock.3,v 1.3 1998/07/24 00:43:40 espie Exp $ +.\" $OpenBSD: sigblock.3,v 1.4 1999/02/27 21:54:51 deraadt Exp $ .\" .Dd March 10, 1991 .Dt SIGBLOCK 3 @@ -49,7 +49,7 @@ This interface is made obsolete by: .Ef .Xr sigprocmask 2 . .Pp -.Fn Sigblock +.Fn sigblock adds the signals specified in .Fa mask to the set of signals currently diff --git a/lib/libc/compat-43/sigpause.3 b/lib/libc/compat-43/sigpause.3 index b1bfbfceb18..8cf12b54107 100644 --- a/lib/libc/compat-43/sigpause.3 +++ b/lib/libc/compat-43/sigpause.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: sigpause.3,v 1.3 1998/07/24 00:43:41 espie Exp $ +.\" $OpenBSD: sigpause.3,v 1.4 1999/02/27 21:54:52 deraadt Exp $ .\" .Dd March 10, 1991 .Dt SIGPAUSE 3 @@ -45,16 +45,16 @@ .Sy This interface is made obsolete by .Xr sigsuspend 2 . .Pp -.Fn Sigpause +.Fn sigpause assigns .Fa sigmask to the set of masked signals and then waits for a signal to arrive; on return the set of masked signals is restored. -.Fa Sigmask +.Fa sigmask is usually 0 to indicate that no signals are to be blocked. -.Fn Sigpause +.Fn sigpause always terminates by being interrupted, returning -1 with .Va errno set to diff --git a/lib/libc/compat-43/sigsetmask.3 b/lib/libc/compat-43/sigsetmask.3 index eb396363e09..33edbfce725 100644 --- a/lib/libc/compat-43/sigsetmask.3 +++ b/lib/libc/compat-43/sigsetmask.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: sigsetmask.3,v 1.3 1998/07/24 00:43:42 espie Exp $ +.\" $OpenBSD: sigsetmask.3,v 1.4 1999/02/27 21:54:52 deraadt Exp $ .\" .Dd March 10, 1991 .Dt SIGSETMASK 3 @@ -48,7 +48,7 @@ This interface is made obsoleted by: .Ef .Xr sigprocmask 2 . .Pp -.Fn Sigsetmask +.Fn sigsetmask sets the current signal mask Signals are blocked from delivery if the corresponding bit in diff --git a/lib/libc/compat-43/sigvec.3 b/lib/libc/compat-43/sigvec.3 index da0872465bf..be327fff82c 100644 --- a/lib/libc/compat-43/sigvec.3 +++ b/lib/libc/compat-43/sigvec.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: sigvec.3,v 1.9 1998/07/24 00:43:43 espie Exp $ +.\" $OpenBSD: sigvec.3,v 1.10 1999/02/27 21:54:54 deraadt Exp $ .\" .Dd April 29, 1991 .Dt SIGVEC 3 @@ -120,7 +120,7 @@ This mask is formed by taking the union of the current signal mask, the signal to be delivered, and the signal mask associated with the handler to be invoked. .Pp -.Fn Sigvec +.Fn sigvec assigns a handler for a specific signal. If .Fa vec is non-zero, it @@ -209,7 +209,7 @@ or all signals, the signal mask, the signal stack, and the interrupt/restart flags are inherited by the child. .Pp -.Xr Execve 2 +.Xr execve 2 reinstates the default action for all signals which were caught and resets all signals to be caught on the user stack. @@ -282,7 +282,7 @@ indicates an error occurred and .Va errno is set to indicated the reason. .Sh ERRORS -.Fn Sigvec +.Fn sigvec will fail and no new signal handler will be installed if one of the following occurs: .Bl -tag -width Er @@ -294,7 +294,7 @@ or points to memory that is not a valid part of the process address space. .It Bq Er EINVAL -.Fa Sig +.Fa sig is not a valid signal number. .It Bq Er EINVAL An attempt is made to ignore or supply a handler for diff --git a/lib/libc/db/man/dbopen.3 b/lib/libc/db/man/dbopen.3 index 4f1dc27a4ba..65d6ea47db9 100644 --- a/lib/libc/db/man/dbopen.3 +++ b/lib/libc/db/man/dbopen.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: dbopen.3,v 1.5 1999/02/26 06:55:53 millert Exp $ +.\" $OpenBSD: dbopen.3,v 1.6 1999/02/27 21:54:56 deraadt Exp $ .\" $NetBSD: dbopen.3,v 1.6 1995/02/27 13:23:25 cgd Exp $ .\" .\" Copyright (c) 1997, Phillip F Knaack. All rights reserved. @@ -182,7 +182,7 @@ with a or .Fa sync function may result in inconsistent or lost information. -.Fa Close +.Fa close routines return -1 on error (setting .Va errno ) and 0 on success. @@ -198,7 +198,7 @@ Delete the record referenced by the cursor. The cursor must have previously been initialized. .El .Pp -.Fa Delete +.Fa delete routines return -1 on error (setting .Va errno ) , 0 on success, and 1 if the specified @@ -221,7 +221,7 @@ locking functions. The file descriptor is not necessarily associated with any of the underlying files used by the access method. No file descriptor is available for in memory databases. -.Fa Fd +.Fa fd routines return -1 on error (setting .Va errno ) , and the file descriptor on success. @@ -232,7 +232,7 @@ The address and length of the data associated with the specified .Fa key are returned in the structure referenced by .Fa data . -.Fa Get +.Fa get routines return -1 on error (setting .Va errno ) , 0 on success, and 1 if the @@ -287,7 +287,7 @@ The default behavior of the routines is to enter the new key/data pair, replacing any previously existing key. .Pp -.Fa Put +.Fa put routines return -1 on error (setting .Va errno ) , 0 on success, and 1 if the R_NOOVERWRITE @@ -350,7 +350,7 @@ R_LAST and R_PREV are available only for the DB_BTREE and DB_RECNO access methods because they each imply that the keys have an inherent order which does not change. .Pp -.Fa Seq +.Fa seq routines return -1 on error (setting .Va errno ) , 0 on success and 1 if there are no key/data pairs less than or greater @@ -379,7 +379,7 @@ field of the manual page for more information.) .El .Pp -.Fa Sync +.Fa sync routines return -1 on error (setting .Va errno ) and 0 on success. diff --git a/lib/libc/db/man/mpool.3 b/lib/libc/db/man/mpool.3 index 7f426b66b0c..b91475a1ca2 100644 --- a/lib/libc/db/man/mpool.3 +++ b/lib/libc/db/man/mpool.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mpool.3,v 1.3 1999/02/26 06:54:50 millert Exp $ +.\" $OpenBSD: mpool.3,v 1.4 1999/02/27 21:54:57 deraadt Exp $ .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -151,7 +151,7 @@ The function .Fn mpool_put unpins the page referenced by .Fa pgaddr . -.Fa Pgaddr +.Fa pgaddr must be an address previously returned by .Fn mpool_get or @@ -164,14 +164,14 @@ the following values: The page has been modified and needs to be written to the backing file. .El .Pp -.Fn Mpool_put +.Fn mpool_put returns 0 on success and -1 if an error occurs. .Pp The function .Fn mpool_sync writes all modified pages associated with the MPOOL pointer to the backing file. -.Fn Mpool_sync +.Fn mpool_sync returns 0 on success and -1 if an error occurs. .Pp The @@ -181,7 +181,7 @@ cookie. Modified pages are .Em not written to the backing file. -.Fn Mpool_close +.Fn mpool_close returns 0 on success and -1 if an error occurs. .Sh ERRORS The diff --git a/lib/libc/gen/exec.3 b/lib/libc/gen/exec.3 index 78ea90d9f07..be5751aa31b 100644 --- a/lib/libc/gen/exec.3 +++ b/lib/libc/gen/exec.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: exec.3,v 1.3 1998/06/27 18:29:52 art Exp $ +.\" $OpenBSD: exec.3,v 1.4 1999/02/27 21:55:02 deraadt Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -190,7 +190,7 @@ will be set to indicate the error. The shell. .El .Sh ERRORS -.Fn Execl , +.Fn execl , .Fn execle , .Fn execlp and @@ -202,7 +202,7 @@ for any of the errors specified for the library functions and .Xr malloc 3 . .Pp -.Fn Exect +.Fn exect and .Fn execv may fail and set @@ -248,7 +248,7 @@ and upon which they returned. They now return if any error other than the ones described above occurs. .Sh STANDARDS -.Fn Execl , +.Fn execl , .Fn execv , .Fn execle , .Fn execlp diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3 index aae42b41438..1cdefd1e439 100644 --- a/lib/libc/gen/getcap.3 +++ b/lib/libc/gen/getcap.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getcap.3,v 1.6 1999/02/25 21:40:16 millert Exp $ +.\" $OpenBSD: getcap.3,v 1.7 1999/02/27 21:55:04 deraadt Exp $ .\" .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. @@ -89,7 +89,7 @@ will first look for files ending in (see .Xr cap_mkdb 1) before accessing the ASCII file. -.Fa Buf +.Fa buf must be retained through all subsequent calls to .Fn cgetmatch , .Fn cgetcap , diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3 index 37d6da5a781..edeaebe176c 100644 --- a/lib/libc/gen/getdomainname.3 +++ b/lib/libc/gen/getdomainname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getdomainname.3,v 1.8 1998/08/29 21:11:26 deraadt Exp $ +.\" $OpenBSD: getdomainname.3,v 1.9 1999/02/27 21:55:06 deraadt Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,7 @@ .Ft int .Fn setdomainname "const char *name" "size_t namelen" .Sh DESCRIPTION -.Fn Getdomainname +.Fn getdomainname returns the YP domain name for the current processor, as previously set by .Fn setdomainname . @@ -56,7 +56,7 @@ specifies the size of the array. If insufficient space is provided, the returned name is truncated. The returned name is always null-terminated. .Pp -.Fn Setdomainname +.Fn setdomainname sets the domain name of the host machine to be .Fa name , which has length diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3 index 0a163061282..fb5e19632c0 100644 --- a/lib/libc/gen/gethostname.3 +++ b/lib/libc/gen/gethostname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gethostname.3,v 1.7 1998/08/29 21:11:28 deraadt Exp $ +.\" $OpenBSD: gethostname.3,v 1.8 1999/02/27 21:55:07 deraadt Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,7 @@ .Ft int .Fn sethostname "const char *name" "size_t namelen" .Sh DESCRIPTION -.Fn Gethostname +.Fn gethostname returns the standard host name for the current processor, as previously set by .Fn sethostname . @@ -56,7 +56,7 @@ specifies the size of the array. If insufficient space is provided, the returned name is truncated. The returned name is always null-terminated. .Pp -.Fn Sethostname +.Fn sethostname sets the name of the host machine to be .Fa name , which has length diff --git a/lib/libc/gen/getnetgrent.3 b/lib/libc/gen/getnetgrent.3 index 3b4d54b24f8..02fa35a5ff0 100644 --- a/lib/libc/gen/getnetgrent.3 +++ b/lib/libc/gen/getnetgrent.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getnetgrent.3,v 1.6 1997/07/09 00:56:56 millert Exp $ +.\" $OpenBSD: getnetgrent.3,v 1.7 1999/02/27 21:55:08 deraadt Exp $ .\" .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. @@ -89,7 +89,7 @@ If is called with a different netgroup than the previous call, an implicit .Fn endnetgrent is implied. -.Fn Setnetgrent +.Fn setnetgrent also sets the offset to the first member of the netgroup. .Pp The function diff --git a/lib/libc/gen/getpagesize.3 b/lib/libc/gen/getpagesize.3 index ac2f0e0818c..adf5f734b6d 100644 --- a/lib/libc/gen/getpagesize.3 +++ b/lib/libc/gen/getpagesize.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpagesize.3,v 1.3 1998/06/02 05:28:59 deraadt Exp $ +.\" $OpenBSD: getpagesize.3,v 1.4 1999/02/27 21:55:10 deraadt Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -49,7 +49,7 @@ Use .Fn sysconf _SC_PAGESIZE . .Ef .Pp -.Fn Getpagesize +.Fn getpagesize returns the number of bytes in a page. Page granularity is the granularity of many of the memory management calls. diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index 8da05c559ef..1762b15d09c 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: signal.3,v 1.5 1997/07/23 21:04:07 kstailey Exp $ +.\" $OpenBSD: signal.3,v 1.6 1999/02/27 21:55:17 deraadt Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -201,7 +201,7 @@ is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Xr Signal +.Fn signal will fail and no action will take place if one of the following occur: .Bl -tag -width Er diff --git a/lib/libc/gen/utime.3 b/lib/libc/gen/utime.3 index c448b9b3d93..b6ee28b5e87 100644 --- a/lib/libc/gen/utime.3 +++ b/lib/libc/gen/utime.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: utime.3,v 1.4 1998/04/28 07:36:41 deraadt Exp $ +.\" $OpenBSD: utime.3,v 1.5 1999/02/27 21:55:22 deraadt Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -88,7 +88,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Utime +.Fn utime will fail if: .Bl -tag -width Er .It Bq Er EACCES @@ -101,7 +101,7 @@ and the effective user ID of the process does not match the owner of the file, and is not the super-user, and write access is denied. .It Bq Er EFAULT -.Xr File +.Ar file or .Fa times points outside the process's allocated address space. diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3 index 37069c0a597..e28fed361ca 100644 --- a/lib/libc/net/gethostbyname.3 +++ b/lib/libc/net/gethostbyname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gethostbyname.3,v 1.9 1998/09/07 16:44:35 aaron Exp $ +.\" $OpenBSD: gethostbyname.3,v 1.10 1999/02/27 21:55:27 deraadt Exp $ .\" .\" Copyright (c) 1983, 1987, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -123,7 +123,7 @@ See .Xr hostname 7 for the domain search procedure and the alias file format. .Pp -.Fn Gethostbyname2 +.Fn gethostbyname2 is an advanced form of .Fn gethostbyname which allows lookups in address families other than diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3 index 98718d448aa..389906d8a30 100644 --- a/lib/libc/net/resolver.3 +++ b/lib/libc/net/resolver.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: resolver.3,v 1.5 1998/09/05 17:41:44 deraadt Exp $ +.\" $OpenBSD: resolver.3,v 1.6 1999/02/27 21:55:34 deraadt Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -250,7 +250,7 @@ but can be any of the query types defined in .Aq Pa arpa/nameser.h . The domain name for the query is given by .Fa dname . -.Fa Newrr +.Fa newrr is currently unused but is intended for making update messages. .Pp The diff --git a/lib/libc/regex/regex.3 b/lib/libc/regex/regex.3 index 4e05c3d5b3b..ede04ac696e 100644 --- a/lib/libc/regex/regex.3 +++ b/lib/libc/regex/regex.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: regex.3,v 1.5 1998/06/15 17:55:05 mickey Exp $ +.\" $OpenBSD: regex.3,v 1.6 1999/02/27 21:55:37 deraadt Exp $ .\" .\" Copyright (c) 1997, Phillip F Knaack. All rights reserved. .\" @@ -73,7 +73,7 @@ These routines implement POSIX 1003.2 regular expressions (``RE''s); see .Xr re_format 7 . -.Fn Regcomp +.Fn regcomp compiles an RE written as a string into an internal form, .Fn regexec matches that internal form against a string and reports results, @@ -95,7 +95,7 @@ a type .Em regoff_t , and a number of constants with names starting with ``REG_''. .Pp -.Fn Regcomp +.Fn regcomp compiles the regular expression contained in the .Fa pattern string, @@ -105,7 +105,7 @@ and places the results in the .Em regex_t structure pointed to by .Fa preg . -.Fa Cflags +.Fa cflags is the bitwise OR of zero or more of the following flags: .Bl -tag -width XREG_EXTENDEDX .It REG_EXTENDED @@ -181,7 +181,7 @@ If fails, it returns a non-zero error code; see DIAGNOSTICS. .Pp -.Fn Regexec +.Fn regexec matches the compiled RE pointed to by .Fa preg against the @@ -328,7 +328,7 @@ the value of will not be changed by a successful .Fn regexec . .Pp -.Fn Regerror +.Fn regerror maps a non-zero .Va errcode from either @@ -350,11 +350,11 @@ it should have been the result from the most recent .Fn regcomp using that .Em regex_t . ( -.Fn Regerror +.Fn regerror may be able to supply a more detailed message using information from the .Em regex_t . ) -.Fn Regerror +.Fn regerror places the NUL-terminated message into the buffer pointed to by .Fa errbuf , limiting the length (including the NUL) to at most @@ -400,7 +400,7 @@ and should be used with caution in software intended to be portable to other systems. Be warned also that they are considered experimental and changes are possible. .Pp -.Fn Regfree +.Fn regfree frees any dynamically-allocated storage associated with the compiled RE pointed to by .Fa preg . @@ -528,14 +528,14 @@ and only the collating elements etc. of that locale are available. The back-reference code is subtle and doubts linger about its correctness in complex cases. .Pp -.Fn Regexec +.Fn regexec performance is poor. This will improve with later releases. -.Fa Nmatch +.Fa nmatch exceeding 0 is expensive; .Fa nmatch exceeding 1 is worse. -.Fn Regexec +.Fn regexec is largely insensitive to RE complexity .Em except that back references are massively expensive. @@ -543,7 +543,7 @@ RE length does matter; in particular, there is a strong speed bonus for keeping RE length under about 30 characters, with most special characters counting roughly double. .Pp -.Fn Regcomp +.Fn regcomp implements bounded repetitions by macro expansion, which is costly in time and space if counts are large or bounded repetitions are nested. diff --git a/lib/libc/stdio/fflush.3 b/lib/libc/stdio/fflush.3 index a13e5f7478b..3649ef99c4c 100644 --- a/lib/libc/stdio/fflush.3 +++ b/lib/libc/stdio/fflush.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fflush.3,v 1.2 1996/08/19 08:32:25 tholo Exp $ +.\" $OpenBSD: fflush.3,v 1.3 1999/02/27 21:55:40 deraadt Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -85,7 +85,7 @@ is set to indicate the error. .Sh ERRORS .Bl -tag -width Er .It Bq Er EBADF -.Fa Stream +.Fa stream is not an open stream, or, in the case of .Fn fflush , not a stream open for writing. diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3 index d4c753935d7..dd3a4f24054 100644 --- a/lib/libc/stdio/printf.3 +++ b/lib/libc/stdio/printf.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: printf.3,v 1.13 1998/09/27 20:53:24 millert Exp $ +.\" $OpenBSD: printf.3,v 1.14 1999/02/27 21:55:46 deraadt Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -82,7 +82,7 @@ The family of functions produces output according to a .Fa format as described below. -.Fn Printf +.Fn printf and .Fn vprintf write output to @@ -119,7 +119,7 @@ the number of characters printed .Ql \e0 used to end output to strings). .Pp -.Fn Asprintf +.Fn asprintf and .Fn vasprintf return a pointer to a buffer sufficiently large to hold the @@ -144,7 +144,7 @@ of 0, they set .Fa ret to be a NULL pointer. .Pp -.Fn Snprintf +.Fn snprintf and .Fn vsnprintf will write at most @@ -159,7 +159,7 @@ if the return value is greater than or equal to the argument, the string was too short and some of the printed characters were discarded. .Pp -.Fn Sprintf +.Fn sprintf and .Fn vsprintf effectively assume an infinite diff --git a/lib/libc/stdio/putc.3 b/lib/libc/stdio/putc.3 index 5383f723e83..0c28835d0f7 100644 --- a/lib/libc/stdio/putc.3 +++ b/lib/libc/stdio/putc.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: putc.3,v 1.2 1996/08/19 08:32:58 tholo Exp $ +.\" $OpenBSD: putc.3,v 1.3 1999/02/27 21:55:47 deraadt Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -64,7 +64,7 @@ writes the character to the output stream pointed to by .Fa stream . .Pp -.Fn Putc +.Fn putc acts essentially identically to .Fn fputc , but is a macro that expands in-line. It may evaluate @@ -73,7 +73,7 @@ more than once, so arguments given to .Fn putc should not be expressions with potential side effects. .Pp -.Fn Putchar +.Fn putchar is identical to .Fn putc with an output stream of diff --git a/lib/libc/stdio/tmpnam.3 b/lib/libc/stdio/tmpnam.3 index 2c501aebe2c..c2a71d55933 100644 --- a/lib/libc/stdio/tmpnam.3 +++ b/lib/libc/stdio/tmpnam.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tmpnam.3,v 1.4 1998/03/12 20:17:42 deraadt Exp $ +.\" $OpenBSD: tmpnam.3,v 1.5 1999/02/27 21:55:50 deraadt Exp $ .\" .\" Copyright (c) 1988, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -131,7 +131,7 @@ if .Pf non- Dv NULL , is used to specify a file name prefix, which will be the first part of the created file name. -.Fn Tempnam +.Fn tempnam allocates memory in which to store the file name; the returned pointer may be used as a subsequent argument to .Xr free 3 . diff --git a/lib/libc/stdlib/a64l.3 b/lib/libc/stdlib/a64l.3 index 4ec707adf1c..0607338cbaf 100644 --- a/lib/libc/stdlib/a64l.3 +++ b/lib/libc/stdlib/a64l.3 @@ -24,7 +24,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $OpenBSD: a64l.3,v 1.2 1998/06/21 22:13:48 millert Exp $ +.\" $OpenBSD: a64l.3,v 1.3 1999/02/27 21:55:53 deraadt Exp $ .\" .Dd August 17, 1997 .Dt A64L 3 @@ -61,7 +61,7 @@ and returns a corresponding 32-bit value. If the string pointed to by contains more than six characters, .Fn a64l will use the first six. -.Fn A64l +.Fn a64l scans the character string from left to right, decoding each character as a 6-bit radix-64 number. If a long integer is larger than 32 bits, the return value will be sign-extended. diff --git a/lib/libc/stdlib/exit.3 b/lib/libc/stdlib/exit.3 index 6dd2affef90..326c5539a88 100644 --- a/lib/libc/stdlib/exit.3 +++ b/lib/libc/stdlib/exit.3 @@ -33,7 +33,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: exit.3,v 1.2 1996/08/19 08:33:30 tholo Exp $ +.\" $OpenBSD: exit.3,v 1.3 1999/02/27 21:55:55 deraadt Exp $ .\" .Dd June 29, 1991 .Dt EXIT 3 @@ -46,7 +46,7 @@ .Ft void .Fn exit "int status" .Sh DESCRIPTION -.Fn Exit +.Fn exit terminates a process. .Pp Before termination it performs the following functions in the diff --git a/lib/libc/stdlib/qsort.3 b/lib/libc/stdlib/qsort.3 index a65c5819d05..0a718244501 100644 --- a/lib/libc/stdlib/qsort.3 +++ b/lib/libc/stdlib/qsort.3 @@ -33,7 +33,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: qsort.3,v 1.2 1996/08/19 08:33:42 tholo Exp $ +.\" $OpenBSD: qsort.3,v 1.3 1999/02/27 21:56:00 deraadt Exp $ .\" .Dd June 4, 1993 .Dt QSORT 3 @@ -71,7 +71,7 @@ objects, the initial member of which is pointed to by .Fa base . The size of each object is specified by .Fa size . -.Fn Mergesort +.Fn mergesort behaves similarly, but .Em requires that @@ -108,7 +108,7 @@ The function is an implementation of C.A.R. Hoare's ``quicksort'' algorithm, a variant of partition-exchange sorting; in particular, see D.E. Knuth's Algorithm Q. -.Fn Qsort +.Fn qsort takes O N lg N average time. This implementation uses median selection to avoid its O N**2 worst-case behavior. @@ -117,7 +117,7 @@ The .Fn heapsort function is an implementation of J.W.J. William's ``heapsort'' algorithm, a variant of selection sorting; in particular, see D.E. Knuth's Algorithm H. -.Fn Heapsort +.Fn heapsort takes O N lg N worst-case time. Its .Em only @@ -133,7 +133,7 @@ requires additional memory of size .Fa nmemb * .Fa size bytes; it should be used only when space is not at a premium. -.Fn Mergesort +.Fn mergesort is optimized for data with pre-existing order; its worst case time is O N lg N; its best case is O N. .Pp @@ -175,7 +175,7 @@ argument to is less than .Dq "sizeof(void *) / 2" . .It Bq Er ENOMEM -.Fn Heapsort +.Fn heapsort or .Fn mergesort were unable to allocate memory. diff --git a/lib/libc/stdlib/tsearch.3 b/lib/libc/stdlib/tsearch.3 index dbdae7943ca..c2ef8ae6cb3 100644 --- a/lib/libc/stdlib/tsearch.3 +++ b/lib/libc/stdlib/tsearch.3 @@ -23,7 +23,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $OpenBSD: tsearch.3,v 1.2 1998/06/21 22:13:49 millert Exp $ +.\" $OpenBSD: tsearch.3,v 1.3 1999/02/27 21:56:03 deraadt Exp $ .\" .Dd June 15, 1997 .Dt TSEARCH 3 @@ -53,7 +53,7 @@ from Knuth (6.2.2). The comparison function passed in by the user has the same style of return values as .Xr strcmp 3 . .Pp -.Fn Tfind +.Fn tfind searches for the datum matched by the argument .Fa key in the binary tree rooted at @@ -61,7 +61,7 @@ in the binary tree rooted at returning a pointer to the datum if it is found and NULL if it is not. .Pp -.Fn Tsearch +.Fn tsearch is identical to .Fn tfind except that if no match is found, @@ -70,7 +70,7 @@ is inserted into the tree and a pointer to it is returned. If .Fa rootp points to a NULL value a new binary search tree is created. .Pp -.Fn Tdelete +.Fn tdelete deletes a node from the specified binary search tree and returns a pointer to the parent of the node to be deleted. It takes the same arguments as @@ -81,13 +81,13 @@ If the node to be deleted is the root of the binary search tree, .Fa rootp will be adjusted. .Pp -.Fn Twalk +.Fn twalk walks the binary search tree rooted in .fa root and calls the function .Fa action on each node. -.Fa Action +.Fa action is called with three arguments: a pointer to the current node, a value from the enum .Sy "typedef enum { preorder, postorder, endorder, leaf } VISIT;" @@ -103,7 +103,7 @@ The function returns NULL if allocation of a new node fails (usually due to a lack of free memory). .Pp -.Fn Tfind , +.Fn tfind , .Fn tsearch , and .Fn tdelete diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2 index 329feccaf69..14ea707fa0c 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: access.2,v 1.3 1998/07/06 18:27:02 deraadt Exp $ +.\" $OpenBSD: access.2,v 1.4 1999/02/27 21:56:05 deraadt Exp $ .\" $NetBSD: access.2,v 1.7 1995/02/27 12:31:44 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -116,7 +116,7 @@ checked with respect to the ``group'' mode bits, and all others have permissions checked with respect to the ``other'' mode bits. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. @@ -133,6 +133,6 @@ The function conforms to .St -p1003.1-90 . .Sh CAVEAT -.Fn Access +.Fn access is a potential security hole and should never be used. diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index 32e5e1b22ab..7d3691cbe31 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: acct.2,v 1.2 1998/07/06 18:27:04 deraadt Exp $ +.\" $OpenBSD: acct.2,v 1.3 1999/02/27 21:56:06 deraadt Exp $ .\" $NetBSD: acct.2,v 1.6 1995/02/27 12:31:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -82,7 +82,7 @@ space once again becomes available. On error -1 is returned. The file must exist and the call may be exercised only by the super-user. .Sh ERRORS -.Fn Acct +.Fn acct will fail if one of the following is true: .Bl -tag -width Er .It Bq Er EPERM @@ -105,7 +105,7 @@ Too many symbolic links were encountered in translating the pathname. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa File +.Fa file points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2 index 9c22f0cafe3..1d6c3bc73a9 100644 --- a/lib/libc/sys/adjtime.2 +++ b/lib/libc/sys/adjtime.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: adjtime.2,v 1.4 1998/07/06 18:27:05 deraadt Exp $ +.\" $OpenBSD: adjtime.2,v 1.5 1999/02/27 21:56:07 deraadt Exp $ .\" $NetBSD: adjtime.2,v 1.5 1995/10/12 15:40:44 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn adjtime "const struct timeval *delta" "struct timeval *olddelta" .Sh DESCRIPTION -.Fn Adjtime +.Fn adjtime makes small adjustments to the system time, as returned by .Xr gettimeofday 2 , advancing or retarding it @@ -89,7 +89,7 @@ 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 -.Fn Adjtime +.Fn adjtime will fail if: .Bl -tag -width Er .It Bq Er EFAULT diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index 7d0fabb8825..f6349a64a3b 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bind.2,v 1.4 1999/02/15 19:04:19 millert Exp $ +.\" $OpenBSD: bind.2,v 1.5 1999/02/27 21:56:07 deraadt Exp $ .\" $NetBSD: bind.2,v 1.8 1995/10/12 15:40:46 jtc Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -46,14 +46,14 @@ .Ft int .Fn bind "int s" "const struct sockaddr *name" "socklen_t namelen" .Sh DESCRIPTION -.Fn Bind +.Fn bind assigns a name to an unnamed socket. When a socket is created with .Xr socket 2 it exists in a name space (address family) but has no name assigned. -.Fn Bind +.Fn bind requests that .Fa name be assigned to the socket. diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index a18d9af8362..aeb01a1e371 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chdir.2,v 1.2 1998/07/06 18:27:09 deraadt Exp $ +.\" $OpenBSD: chdir.2,v 1.3 1999/02/27 21:56:08 deraadt Exp $ .\" $NetBSD: chdir.2,v 1.7 1995/02/27 12:32:00 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -79,7 +79,7 @@ Otherwise, a value of -1 is returned and is set to indicate the error. .Sh ERRORS -.Fn Chdir +.Fn chdir will fail and the current working directory will be unchanged if one or more of the following are true: .Bl -tag -width Er @@ -99,13 +99,13 @@ Too many symbolic links were encountered in translating the pathname. Search permission is denied for any component of the path name. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. .El .Pp -.Fn Fchdir +.Fn fchdir will fail and the current working directory will be unchanged if one or more of the following are true: .Bl -tag -width Er diff --git a/lib/libc/sys/chflags.2 b/lib/libc/sys/chflags.2 index 37a34006756..a5de6940164 100644 --- a/lib/libc/sys/chflags.2 +++ b/lib/libc/sys/chflags.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chflags.2,v 1.8 1998/07/06 18:27:10 deraadt Exp $ +.\" $OpenBSD: chflags.2,v 1.9 1999/02/27 21:56:09 deraadt Exp $ .\" $NetBSD: chflags.2,v 1.6 1995/02/27 12:32:03 cgd Exp $ .\" .\" Copyright (c) 1989, 1993 @@ -98,7 +98,7 @@ Otherwise, -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Chflags +.Fn chflags will fail it: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -124,7 +124,7 @@ flags. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EIO An @@ -132,13 +132,13 @@ An error occurred while reading from or writing to the file system. .El .Pp -.Fn Fchflags +.Fn fchflags will fail if: .Bl -tag -width Er .It Bq Er EBADF The descriptor is not valid. .It Bq Er EINVAL -.Fa Fd +.Fa fd refers to a socket, not to a file. .It Bq Er EINVAL The flags value is invalid. diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index a0091d7532b..b76033f50f1 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chmod.2,v 1.4 1997/11/18 07:10:08 millert Exp $ +.\" $OpenBSD: chmod.2,v 1.5 1999/02/27 21:56:09 deraadt Exp $ .\" $NetBSD: chmod.2,v 1.7 1995/02/27 12:32:06 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -57,11 +57,11 @@ specified by the pathname .Fa path to .Fa mode . -.Fn Fchmod +.Fn fchmod sets the permission bits of the specified file descriptor .Fa fd . -.Fn Chmod +.Fn chmod verifies that the process owner (user) either owns the file specified by .Fa path @@ -128,7 +128,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Chmod +.Fn chmod will fail and the file mode will be unchanged if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -154,19 +154,19 @@ the effective user ID is not the super-user. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. .El .Pp -.Fn Fchmod +.Fn fchmod will fail and the file mode will be unchanged if: .Bl -tag -width Er .It Bq Er EBADF The descriptor is not valid. .It Bq Er EINVAL -.Fa Fd +.Fa fd refers to a socket, not to a file. .It Bq Er EINVAL .Fa mode diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index 3b194b6d33c..d21a1e32c67 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chown.2,v 1.3 1997/01/26 05:10:33 downsj Exp $ +.\" $OpenBSD: chown.2,v 1.4 1999/02/27 21:56:10 deraadt Exp $ .\" $NetBSD: chown.2,v 1.10 1995/10/12 15:40:47 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -69,19 +69,19 @@ but the change .Fa owner capability is restricted to the super-user. .Pp -.Fn Chown +.Fn chown clears the set-user-id and set-group-id bits on the file to prevent accidental or mischievous creation of set-user-id and set-group-id programs. .Pp -.Fn Lchown +.Fn lchown operates similarly to how .Fn chown operated on older systems, and does not follow symbolic links. It allows the owner and group of a symbolic link to be set. .Pp -.Fn Fchown +.Fn fchown is particularly useful when used in conjunction with the file locking primitives (see .Xr flock 2 ) . @@ -94,7 +94,7 @@ Zero is returned if the operation was successful; error code being placed in the global variable .Va errno . .Sh ERRORS -.Fn Chown +.Fn chown or .Fn lchown will fail and the file or link will be unchanged if: @@ -118,20 +118,20 @@ The effective user ID is not the super-user. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. .El .Pp -.Fn Fchown +.Fn fchown will fail if: .Bl -tag -width Er .It Bq Er EBADF -.Fa Fd +.Fa fd does not refer to a valid descriptor. .It Bq Er EINVAL -.Fa Fd +.Fa fd refers to a socket, not a file. .It Bq Er EPERM The effective user ID is not the super-user. diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index a1cc39f0302..27cd42524f8 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chroot.2,v 1.5 1998/07/06 18:27:11 deraadt Exp $ +.\" $OpenBSD: chroot.2,v 1.6 1999/02/27 21:56:10 deraadt Exp $ .\" $NetBSD: chroot.2,v 1.7 1995/02/27 12:32:12 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -45,9 +45,9 @@ .Ft int .Fn chroot "const char *dirname" .Sh DESCRIPTION -.Fa Dirname +.Fa dirname is the address of the pathname of a directory, terminated by an ASCII NUL. -.Fn Chroot +.Fn chroot causes .Fa dirname to become the root directory, @@ -75,7 +75,7 @@ a value of -1 is returned and .Va errno is set to indicate an error. .Sh ERRORS -.Fn Chroot +.Fn chroot will fail and the root directory will be unchanged if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -93,7 +93,7 @@ Search permission is denied for any component of the path name. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EFAULT -.Fa Dirname +.Fa dirname points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 00cb4f689d4..fb57ec95726 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: close.2,v 1.3 1998/07/06 18:27:13 deraadt Exp $ +.\" $OpenBSD: close.2,v 1.4 1999/02/27 21:56:11 deraadt Exp $ .\" $NetBSD: close.2,v 1.5 1995/02/27 12:32:14 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -99,7 +99,7 @@ Otherwise, a value of -1 is returned and the global integer variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Close +.Fn close will fail if: .Bl -tag -width Er .It Bq Er EBADF @@ -118,6 +118,6 @@ An interrupt was received. .Xr execve 2 , .Xr fcntl 2 .Sh STANDARDS -.Fn Close +.Fn close conforms to .St -p1003.1-88 . diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index cf5545e5426..9f4fde80df6 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: dup.2,v 1.3 1998/07/06 18:27:15 deraadt Exp $ +.\" $OpenBSD: dup.2,v 1.4 1999/02/27 21:56:12 deraadt Exp $ .\" $NetBSD: dup.2,v 1.4 1995/02/27 12:32:21 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -48,7 +48,7 @@ .Ft int .Fn dup2 "int oldd" "int newd" .Sh DESCRIPTION -.Fn Dup +.Fn dup duplicates an existing object descriptor and returns its value to the calling process .Fa ( newd @@ -104,13 +104,13 @@ The external variable .Va errno indicates the cause of the error. .Sh ERRORS -.Fn Dup +.Fn dup and .Fn dup2 fail if: .Bl -tag -width Er .It Bq Er EBADF -.Fa Oldd +.Fa oldd or .Fa newd is not a valid active descriptor @@ -127,7 +127,7 @@ Too many descriptors are active. .Xr socketpair 2 , .Xr getdtablesize 3 .Sh STANDARDS -.Fn Dup +.Fn dup and .Fn dup2 are expected to conform to diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index 841124c1515..0ad9690481c 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: execve.2,v 1.5 1998/07/06 18:27:16 deraadt Exp $ +.\" $OpenBSD: execve.2,v 1.6 1999/02/27 21:56:12 deraadt Exp $ .\" $NetBSD: execve.2,v 1.9 1995/02/27 12:32:25 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn execve "const char *path" "char *const argv[]" "char *const envp[]" .Sh DESCRIPTION -.Fn Execve +.Fn execve transforms the calling process into a new process. The new process is constructed from an ordinary file, whose name is pointed to by @@ -203,7 +203,7 @@ return value will be -1 and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Execve +.Fn execve will fail and return to the calling process if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -251,7 +251,7 @@ in The new process file is not as long as indicated by the size values in its header. .It Bq Er EFAULT -.Fa Path , +.Fa path , .Fa argv , or .Fa envp diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index 8f337e89616..9697f3314bd 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fcntl.2,v 1.8 1998/07/24 00:43:47 espie Exp $ +.\" $OpenBSD: fcntl.2,v 1.9 1999/02/27 21:56:14 deraadt Exp $ .\" $NetBSD: fcntl.2,v 1.6 1995/02/27 12:32:29 cgd Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn fcntl "int fd" "int cmd" "int arg" .Sh DESCRIPTION -.Fn Fcntl +.Fn fcntl provides for control over descriptors. The argument .Fa fd @@ -315,7 +315,7 @@ The .Xr flock 2 interface has much more rational last close semantics and allows locks to be inherited by child processes. -.Xr Flock 2 +.Xr flock 2 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. @@ -355,7 +355,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Fcntl +.Fn fcntl will fail if: .Bl -tag -width Er .It Bq Er EAGAIN @@ -375,7 +375,7 @@ or the type is an exclusive lock and some portion of the segment of a file to be locked is already shared-locked or exclusive-locked by another process. .It Bq Er EBADF -.Fa Fildes +.Fa fildes is not a valid open file descriptor. .Pp The argument @@ -406,7 +406,7 @@ and .Fa fildes is not a valid file descriptor open for writing. .It Bq Er EMFILE -.Fa Cmd +.Fa cmd is .Dv F_DUPFD and the maximum allowed number of file descriptors are currently @@ -424,7 +424,7 @@ is .Dv F_SETLKW , and the function was interrupted by a signal. .It Bq Er EINVAL -.Fa Cmd +.Fa cmd is .Dv F_DUPFD and @@ -465,7 +465,7 @@ or and satisfying the lock or unlock request would result in the number of locked regions in the system exceeding a system-imposed limit. .It Bq Er ESRCH -.Fa Cmd +.Fa cmd is .Dv F_SETOWN and diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index 94e5b31e2ea..d3b8de7ddf0 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: flock.2,v 1.7 1998/07/06 18:27:19 deraadt Exp $ +.\" $OpenBSD: flock.2,v 1.8 1999/02/27 21:56:15 deraadt Exp $ .\" $NetBSD: flock.2,v 1.5 1995/02/27 12:32:32 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -50,7 +50,7 @@ .Ft int .Fn flock "int fd" "int operation" .Sh DESCRIPTION -.Fn Flock +.Fn flock applies or removes an .Em advisory lock on the file associated with the file descriptor diff --git a/lib/libc/sys/fork.2 b/lib/libc/sys/fork.2 index f0291d63598..4f1828c5890 100644 --- a/lib/libc/sys/fork.2 +++ b/lib/libc/sys/fork.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fork.2,v 1.4 1998/07/06 18:27:20 deraadt Exp $ +.\" $OpenBSD: fork.2,v 1.5 1999/02/27 21:56:15 deraadt Exp $ .\" $NetBSD: fork.2,v 1.6 1995/02/27 12:32:36 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -46,7 +46,7 @@ .Ft pid_t .Fn fork void .Sh DESCRIPTION -.Fn Fork +.Fn fork causes creation of a new process. The new process (child process) is an exact copy of the calling process (parent process) except for the following: @@ -86,7 +86,7 @@ variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Fork +.Fn fork will fail and no child process will be created if: .Bl -tag -width [EAGAIN] .It Bq Er EAGAIN diff --git a/lib/libc/sys/fsync.2 b/lib/libc/sys/fsync.2 index ffce4021084..5532ab5b2cc 100644 --- a/lib/libc/sys/fsync.2 +++ b/lib/libc/sys/fsync.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fsync.2,v 1.2 1998/07/06 18:27:21 deraadt Exp $ +.\" $OpenBSD: fsync.2,v 1.3 1999/02/27 21:56:16 deraadt Exp $ .\" $NetBSD: fsync.2,v 1.4 1995/02/27 12:32:38 cgd Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -45,14 +45,14 @@ .Ft int .Fn fsync "int fd" .Sh DESCRIPTION -.Fn Fsync +.Fn fsync causes all modified data and attributes of .Fa fd to be moved to a permanent storage device. This normally results in all in-core modified copies of buffers for the associated file to be written to a disk. .Pp -.Fn Fsync +.Fn fsync should be used by programs that require a file to be in a known state, for example, in building a simple transaction facility. @@ -65,10 +65,10 @@ The fails if: .Bl -tag -width Er .It Bq Er EBADF -.Fa Fd +.Fa fd is not a valid descriptor. .It Bq Er EINVAL -.Fa Fd +.Fa fd refers to a socket, not to a file. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index 0d57614f334..1266e118810 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getdirentries.2,v 1.5 1998/07/06 18:27:23 deraadt Exp $ +.\" $OpenBSD: getdirentries.2,v 1.6 1999/02/27 21:56:17 deraadt Exp $ .\" $NetBSD: getdirentries.2,v 1.7 1995/10/12 15:40:50 jtc Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn getdirentries "int fd" "char *buf" "int nbytes" "long *basep" .Sh DESCRIPTION -.Fn Getdirentries +.Fn getdirentries reads directory entries from the directory referenced by the file descriptor .Fa fd @@ -55,7 +55,7 @@ in a filesystem independent format. Up to .Fa nbytes of data will be transferred. -.Fa Nbytes +.Fa nbytes must be greater than or equal to the block size associated with the file, see @@ -113,7 +113,7 @@ The pointer may not advance by the number of bytes returned by A value of zero is returned when the end of the directory has been reached. .Pp -.Fn Getdirentries +.Fn getdirentries writes the position of the block read into the location pointed to by .Fa basep . Alternatively, the current position pointer may be set and retrieved by @@ -129,7 +129,7 @@ Otherwise, -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Getdirentries +.Fn getdirentries will fail if: .Bl -tag -width Er .It Bq Er EBADF diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2 index 1dcf38291b2..3cfb75e009e 100644 --- a/lib/libc/sys/getfh.2 +++ b/lib/libc/sys/getfh.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getfh.2,v 1.4 1998/07/06 18:27:24 deraadt Exp $ +.\" $OpenBSD: getfh.2,v 1.5 1999/02/27 21:56:17 deraadt Exp $ .\" $NetBSD: getfh.2,v 1.7 1995/10/12 15:40:53 jtc Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -46,7 +46,7 @@ .Ft int .Fn getfh "const char *path" "fhandle_t *fhp" .Sh DESCRIPTION -.Fn Getfh +.Fn getfh returns a file handle for the specified file or directory in the file handle pointed to by .Fa fhp . @@ -57,7 +57,7 @@ Otherwise, -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Getfh +.Fn getfh fails if one or more of the following are true: .Bl -tag -width Er .It Bq ENOTDIR @@ -85,7 +85,7 @@ Search permission is denied for a component of the path prefix of Too many symbolic links were encountered in translating .Fa path . .It Bq EFAULT -.Fa Fhp +.Fa fhp points to an invalid address. .It Bq EIO An diff --git a/lib/libc/sys/getfsstat.2 b/lib/libc/sys/getfsstat.2 index 89cf2537166..055f313de14 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getfsstat.2,v 1.6 1998/07/06 18:27:26 deraadt Exp $ +.\" $OpenBSD: getfsstat.2,v 1.7 1999/02/27 21:56:18 deraadt Exp $ .\" $NetBSD: getfsstat.2,v 1.6 1995/06/29 11:40:44 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -47,9 +47,9 @@ .Ft int .Fn getfsstat "struct statfs *buf" "long bufsize" "int flags" .Sh DESCRIPTION -.Fn Getfsstat +.Fn getfsstat returns information about all mounted file systems. -.Fa Buf +.Fa buf is a pointer to an array of .Xr statfs 2 structures defined as follows: @@ -116,11 +116,11 @@ Otherwise, -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Getfsstat +.Fn getfsstat fails if one or more of the following are true: .Bl -tag -width Er .It Bq Er EFAULT -.Fa Buf +.Fa buf points to an invalid address. .It Bq Er EIO An diff --git a/lib/libc/sys/getgid.2 b/lib/libc/sys/getgid.2 index 6680d121556..d64e76d7f2b 100644 --- a/lib/libc/sys/getgid.2 +++ b/lib/libc/sys/getgid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getgid.2,v 1.3 1998/07/06 18:27:27 deraadt Exp $ +.\" $OpenBSD: getgid.2,v 1.4 1999/02/27 21:56:18 deraadt Exp $ .\" $NetBSD: getgid.2,v 1.5 1995/02/27 12:32:53 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -76,7 +76,7 @@ indicate an error. .Xr setregid 2 , .Xr setgid 2 .Sh STANDARDS -.Fn Getgid +.Fn getgid and .Fn getegid conform to diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index ec76922abdd..7fd3faeabd4 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getgroups.2,v 1.3 1998/07/06 18:27:28 deraadt Exp $ +.\" $OpenBSD: getgroups.2,v 1.4 1999/02/27 21:56:19 deraadt Exp $ .\" $NetBSD: getgroups.2,v 1.8 1995/02/27 12:32:57 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -46,7 +46,7 @@ .Ft int .Fn getgroups "int gidsetlen" "gid_t *gidset" .Sh DESCRIPTION -.Fn Getgroups +.Fn getgroups gets the current group access list of the current user process and stores it in the array .Fa gidset . @@ -54,7 +54,7 @@ The parameter .Fa gidsetlen indicates the number of entries that may be placed in .Fa gidset . -.Fn Getgroups +.Fn getgroups returns the actual number of groups returned in .Fa gidset . No more than diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index d79e4145fc4..be6062f2fda 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getitimer.2,v 1.5 1998/08/17 17:35:09 deraadt Exp $ +.\" $OpenBSD: getitimer.2,v 1.6 1999/02/27 21:56:19 deraadt Exp $ .\" $NetBSD: getitimer.2,v 1.6 1995/10/12 15:40:54 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -131,7 +131,7 @@ restart interrupted system calls. .Sh NOTES Three macros for manipulating time values are defined in .Ao Pa sys/time.h Ac . -.Fa Timerclear +.Fa timerclear sets a time value to zero, .Fa timerisset tests if a time value is non-zero, and @@ -144,7 +144,7 @@ the value -1 is returned, and a more precise error code is placed in the global variable .Va errno . .Sh ERRORS -.Fn Getitimer +.Fn getitimer and .Fn setitimer will fail if: diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2 index e9c3f6dd3b3..66f404f4e26 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getlogin.2,v 1.4 1998/07/06 18:27:31 deraadt Exp $ +.\" $OpenBSD: getlogin.2,v 1.5 1999/02/27 21:56:20 deraadt Exp $ .\" $NetBSD: getlogin.2,v 1.4 1995/02/27 12:33:03 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -62,7 +62,7 @@ for example when .Xr su 1 is used.) .Pp -.Fn Setlogin +.Fn setlogin sets the login name of the user associated with the current session to .Fa name . This call is restricted to the super-user, and diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index 9e489a962b5..d2a718cf5e1 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpeername.2,v 1.6 1999/02/15 21:48:57 millert Exp $ +.\" $OpenBSD: getpeername.2,v 1.7 1999/02/27 21:56:21 deraadt Exp $ .\" $NetBSD: getpeername.2,v 1.6 1995/10/12 15:40:56 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -46,7 +46,7 @@ .Ft int .Fn getpeername "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh DESCRIPTION -.Fn Getpeername +.Fn getpeername returns the name of the peer connected to socket .Fa s . diff --git a/lib/libc/sys/getpid.2 b/lib/libc/sys/getpid.2 index 24876a6f706..71fea284aa6 100644 --- a/lib/libc/sys/getpid.2 +++ b/lib/libc/sys/getpid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpid.2,v 1.3 1998/07/06 18:27:33 deraadt Exp $ +.\" $OpenBSD: getpid.2,v 1.4 1999/02/27 21:56:21 deraadt Exp $ .\" $NetBSD: getpid.2,v 1.5 1995/02/27 12:33:12 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -49,14 +49,14 @@ .Ft pid_t .Fn getppid void .Sh DESCRIPTION -.Fn Getpid +.Fn getpid returns the process ID of the calling process. The ID is guaranteed to be unique and is useful for constructing temporary file names. .Pp -.Fn Getppid +.Fn getppid returns the process ID of the parent of the calling process. .Sh ERRORS @@ -69,7 +69,7 @@ indicate an error. .Sh SEE ALSO .Xr gethostid 3 .Sh STANDARDS -.Fn Getpid +.Fn getpid and .Fn getppid conform to diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index 82e6bd3f69d..17145b68f96 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getpriority.2,v 1.2 1998/07/06 18:27:35 deraadt Exp $ +.\" $OpenBSD: getpriority.2,v 1.3 1999/02/27 21:56:22 deraadt Exp $ .\" $NetBSD: getpriority.2,v 1.4 1995/02/27 12:33:15 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -59,7 +59,7 @@ is obtained with the call and set with the .Fn setpriority call. -.Fa Which +.Fa which is one of .Dv PRIO_PROCESS , .Dv PRIO_PGRP , @@ -79,7 +79,7 @@ and a user ID for A zero value of .Fa who denotes the current process, process group, or user. -.Fa Prio +.Fa prio is a value in the range -20 to 20. The default priority is 0; lower priorities cause more favorable scheduling. .Pp @@ -104,7 +104,7 @@ The call returns 0 if there is no error, or -1 if there is. .Sh ERRORS -.Fn Getpriority +.Fn getpriority and .Fn setpriority will fail if: @@ -116,7 +116,7 @@ and .Fa who values specified. .It Bq Er EINVAL -.Fa Which +.Fa which was not one of .Dv PRIO_PROCESS , .Dv PRIO_PGRP , diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index e81f7b23630..0b9b443b2aa 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getrlimit.2,v 1.6 1998/07/06 18:27:36 deraadt Exp $ +.\" $OpenBSD: getrlimit.2,v 1.7 1999/02/27 21:56:22 deraadt Exp $ .\" $NetBSD: getrlimit.2,v 1.8 1995/10/12 15:40:58 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -162,7 +162,7 @@ that an error occurred, and an error code is stored in the global location .Va errno . .Sh ERRORS -.Fn Getrlimit +.Fn getrlimit and .Fn setrlimit will fail if: diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index c3ad36b805e..d876540115b 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getrusage.2,v 1.3 1997/09/17 11:54:33 deraadt Exp $ +.\" $OpenBSD: getrusage.2,v 1.4 1999/02/27 21:56:23 deraadt Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -48,7 +48,7 @@ .Ft int .Fn getrusage "int who" "struct rusage *rusage" .Sh DESCRIPTION -.Fn Getrusage +.Fn getrusage returns information describing the resources utilized by the current process, or all its terminated child processes. The @@ -141,7 +141,7 @@ 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 +.Fn getrusage returns -1 on error. The possible errors are: .Bl -tag -width Er diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index b8d545b8c85..8d8680a5f2b 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsockname.2,v 1.7 1999/02/15 21:48:57 millert Exp $ +.\" $OpenBSD: getsockname.2,v 1.8 1999/02/27 21:56:23 deraadt Exp $ .\" $NetBSD: getsockname.2,v 1.6 1995/10/12 15:41:00 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -46,7 +46,7 @@ .Ft int .Fn getsockname "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh DESCRIPTION -.Fn Getsockname +.Fn getsockname returns the current .Fa name for the specified socket. The diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index cd3d2fb43f9..131dc3e0f7c 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsockopt.2,v 1.7 1999/02/15 19:04:21 millert Exp $ +.\" $OpenBSD: getsockopt.2,v 1.8 1999/02/27 21:56:24 deraadt Exp $ .\" $NetBSD: getsockopt.2,v 1.7 1995/02/27 12:33:29 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -49,7 +49,7 @@ .Ft int .Fn setsockopt "int s" "int level" "int optname" "const void *optval" "socklen_t optlen" .Sh DESCRIPTION -.Fn Getsockopt +.Fn getsockopt and .Fn setsockopt manipulate the @@ -98,7 +98,7 @@ to be supplied or returned, .Fa optval may be NULL. .Pp -.Fa Optname +.Fa optname and any specified options are passed uninterpreted to the appropriate protocol module for interpretation. The include file diff --git a/lib/libc/sys/getuid.2 b/lib/libc/sys/getuid.2 index 75e78333f13..162bfe01839 100644 --- a/lib/libc/sys/getuid.2 +++ b/lib/libc/sys/getuid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getuid.2,v 1.2 1998/07/06 18:27:40 deraadt Exp $ +.\" $OpenBSD: getuid.2,v 1.3 1999/02/27 21:56:25 deraadt Exp $ .\" $NetBSD: getuid.2,v 1.6 1995/02/27 12:33:37 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -76,7 +76,7 @@ indicate an error. .Xr getgid 2 , .Xr setreuid 2 .Sh STANDARDS -.Fn Geteuid +.Fn geteuid and .Fn getuid functions conform to diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index 2b96c68e635..31479f98014 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ioctl.2,v 1.3 1998/07/06 18:27:43 deraadt Exp $ +.\" $OpenBSD: ioctl.2,v 1.4 1999/02/27 21:56:25 deraadt Exp $ .\" $NetBSD: ioctl.2,v 1.5 1995/02/27 12:33:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -76,7 +76,7 @@ If an error has occurred, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Ioctl +.Fn ioctl will fail if: .Bl -tag -width Er .It Bq Er EBADF @@ -92,7 +92,7 @@ of object that the descriptor .Fa d references. .It Bq Er EINVAL -.Fa Request +.Fa request or .Fa argp is not valid. diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2 index ddd45a632fb..e6bab36c340 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kill.2,v 1.4 1998/07/14 19:51:11 deraadt Exp $ +.\" $OpenBSD: kill.2,v 1.5 1999/02/27 21:56:26 deraadt Exp $ .\" $NetBSD: kill.2,v 1.7 1995/02/27 12:33:53 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -53,7 +53,7 @@ to .Fa pid , a process or a group of processes. -.Fa Sig +.Fa sig may be one of the signals specified in .Xr sigaction 2 or it may be 0, in which case @@ -72,11 +72,11 @@ A single exception is the signal SIGCONT, which may always be sent to any descendant of the current process. .Bl -tag -width Ds .It \&If Fa pid No \&is greater than zero : -.Fa Sig +.Fa sig is sent to the process whose ID is equal to .Fa pid. .It \&If Fa pid No \&is zero : -.Fa Sig +.Fa sig is sent to all processes whose group ID is equal to the process group ID of the sender, and for which the process has permission; @@ -118,11 +118,11 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Kill +.Fn kill will fail and no signal will be sent if: .Bl -tag -width Er .It Bq Er EINVAL -.Fa Sig +.Fa sig is not a valid signal number. .It Bq Er ESRCH No process can be found corresponding to that specified by diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2 index f1871c9e939..ccf1686dbf3 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ktrace.2,v 1.2 1998/07/06 18:27:45 deraadt Exp $ +.\" $OpenBSD: ktrace.2,v 1.3 1999/02/27 21:56:27 deraadt Exp $ .\" $NetBSD: ktrace.2,v 1.2 1995/02/27 12:33:58 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -136,7 +136,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to show the error. .Sh ERRORS -.Fn Ktrace +.Fn ktrace will fail if: .Bl -tag -width ENAMETOOLONGAA .It Bq Er ENOTDIR diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 52cc517691c..e7e09334fc3 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: link.2,v 1.5 1998/07/06 18:27:47 deraadt Exp $ +.\" $OpenBSD: link.2,v 1.6 1999/02/27 21:56:27 deraadt Exp $ .\" $NetBSD: link.2,v 1.7 1995/02/27 12:34:01 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -69,7 +69,7 @@ is not deleted and the link count of the underlying object is decremented. .Pp -.Fa Name1 +.Fa name1 must exist for the hard link to succeed and both @@ -86,7 +86,7 @@ a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Link +.Fn link will fail and no link will be created if: .Bl -tag -width Er .It Bq Er ENOTDIR diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index b60ce7bc574..fbb906e989d 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: listen.2,v 1.3 1999/02/15 21:48:57 millert Exp $ +.\" $OpenBSD: listen.2,v 1.4 1999/02/27 21:56:28 deraadt Exp $ .\" $NetBSD: listen.2,v 1.7 1996/02/16 20:38:45 phil Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -75,7 +75,7 @@ the request may be ignored so that retries may succeed. .Sh RETURN VALUES A 0 return value indicates success; -1 indicates an error. .Sh ERRORS -.Fn Listen +.Fn listen will fail if: .Bl -tag -width Er .It Bq Er EBADF diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2 index 0520620ffd3..b4ca0788ce0 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: lseek.2,v 1.5 1998/07/06 18:27:48 deraadt Exp $ +.\" $OpenBSD: lseek.2,v 1.6 1999/02/27 21:56:28 deraadt Exp $ .\" $NetBSD: lseek.2,v 1.6 1995/02/27 12:34:09 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -58,7 +58,7 @@ The argument .Fa fildes must be an open file descriptor. -.Fn Lseek +.Fn lseek repositions the file pointer .Fa fildes as follows: @@ -110,7 +110,7 @@ a value of -1 is returned and is set to indicate the error. .Sh ERRORS -.Fn Lseek +.Fn lseek will fail and the file pointer will remain unchanged if: .Bl -tag -width Er .It Bq Er EBADF @@ -120,7 +120,7 @@ is not an open file descriptor. .Em Fildes is associated with a pipe, socket, or FIFO. .It Bq Er EINVAL -.Fa Whence +.Fa whence is not a proper value or the resulting offset would be negative on a file system or special device that does not allow negative offsets to be used. diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 8f1758f8f22..3e7159f8ecd 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mkdir.2,v 1.3 1998/07/06 18:27:53 deraadt Exp $ +.\" $OpenBSD: mkdir.2,v 1.4 1999/02/27 21:56:30 deraadt Exp $ .\" $NetBSD: mkdir.2,v 1.8 1995/02/27 12:34:22 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -62,7 +62,7 @@ A 0 return value indicates success. A -1 return value indicates an error, and an error code is stored in .Va errno . .Sh ERRORS -.Fn Mkdir +.Fn mkdir will fail and no directory will be created if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -101,7 +101,7 @@ An I/O error occurred while making the directory entry or allocating the inode. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index 38899d6bfa7..09af95c4f64 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mkfifo.2,v 1.2 1998/07/06 18:27:54 deraadt Exp $ +.\" $OpenBSD: mkfifo.2,v 1.3 1999/02/27 21:56:31 deraadt Exp $ .\" $NetBSD: mkfifo.2,v 1.8 1995/02/27 12:34:27 cgd Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 @@ -46,7 +46,7 @@ .Ft int .Fn mkfifo "const char *path" "mode_t mode" .Sh DESCRIPTION -.Fn Mkfifo +.Fn mkfifo creates a new fifo file with name .Fa path . The access permissions are @@ -64,7 +64,7 @@ A 0 return value indicates success. A -1 return value indicates an error, and an error code is stored in .Va errno . .Sh ERRORS -.Fn Mkfifo +.Fn mkfifo will fail and no fifo will be created if: .Bl -tag -width Er .It Bq Er EOPNOTSUPP @@ -111,7 +111,7 @@ An .Tn I/O error occurred while reading from or writing to the file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mknod.2 b/lib/libc/sys/mknod.2 index d062b5306a9..f5edd6d1818 100644 --- a/lib/libc/sys/mknod.2 +++ b/lib/libc/sys/mknod.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mknod.2,v 1.3 1998/07/06 18:27:56 deraadt Exp $ +.\" $OpenBSD: mknod.2,v 1.4 1999/02/27 21:56:32 deraadt Exp $ .\" $NetBSD: mknod.2,v 1.6 1995/02/27 12:34:33 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -67,7 +67,7 @@ does not indicate a block special or character special device, .Fa dev is ignored. .Pp -.Fn Mknod +.Fn mknod requires super-user privileges. .Sh RETURN VALUES Upon successful completion a value of 0 is returned. @@ -75,7 +75,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Mknod +.Fn mknod will fail and the file will be not created if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -116,7 +116,7 @@ The named file resides on a read-only file system. .It Bq Er EEXIST The named file exists. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mlock.2 b/lib/libc/sys/mlock.2 index 11fc718c243..b60b1d50d9e 100644 --- a/lib/libc/sys/mlock.2 +++ b/lib/libc/sys/mlock.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mlock.2,v 1.5 1998/07/06 18:27:57 deraadt Exp $ +.\" $OpenBSD: mlock.2,v 1.6 1999/02/27 21:56:32 deraadt Exp $ .\" $NetBSD: mlock.2,v 1.3 1995/06/24 10:42:03 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -112,7 +112,7 @@ In this case, the global location .Va errno is set to indicate the error. .Sh ERRORS -.Fn Mlock +.Fn mlock will fail if: .Bl -tag -width Er .It Bq Er EINVAL @@ -124,7 +124,7 @@ limit for locked memory. Some portion of the indicated address range is not allocated. There was an error faulting/mapping a page. .El -.Fn Munlock +.Fn munlock will fail if: .Bl -tag -width Er .It Bq Er EINVAL diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index b1a70d9a7c6..6bcc4be2a69 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mmap.2,v 1.9 1998/08/21 16:38:10 millert Exp $ +.\" $OpenBSD: mmap.2,v 1.10 1999/02/27 21:56:33 deraadt Exp $ .\" $NetBSD: mmap.2,v 1.5 1995/06/24 10:48:59 cgd Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -171,7 +171,7 @@ No successful return from will return the value .Dv MAP_FAILED . .Sh ERRORS -.Fn Mmap +.Fn mmap will fail if: .Bl -tag -width Er .It Bq Er EACCES @@ -195,14 +195,14 @@ parameters and .Fa fd was not open for writing. .It Bq Er EBADF -.Fa Fd +.Fa fd is not a valid open file descriptor. .It Bq Er EINVAL .Dv MAP_FIXED was specified and the .I addr parameter was not page aligned. -.Fa Fd +.Fa fd did not reference a regular or character special file. .It Bq Er ENOMEM .Dv MAP_FIXED diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index 64d6c1fd961..764b47779bd 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mount.2,v 1.8 1998/12/21 14:08:59 art Exp $ +.\" $OpenBSD: mount.2,v 1.9 1999/02/27 21:56:34 deraadt Exp $ .\" $NetBSD: mount.2,v 1.12 1996/02/29 23:47:48 jtc Exp $ .\" .\" Copyright (c) 1980, 1989, 1993 @@ -112,7 +112,7 @@ The argument defines the type of the filesystem. The types of filesystems known to the system are defined in .Aq Pa sys/mount.h . -.Fa Data +.Fa data is a pointer to a structure that contains the type specific arguments to mount. The currently supported types of filesystems and @@ -219,10 +219,10 @@ A pathname contains a character with the high-order bit set. Another process currently holds a reference to .Fa dir . .It Bq Er EFAULT -.Fa Dir +.Fa dir points outside the process's allocated address space. .It Bq Er EOPNOTSUPP -.Fa Type +.Fa type is not supported by the kernel. .El .Pp @@ -318,7 +318,7 @@ on the filesystem. .It Bq Er EIO An I/O error occurred while writing cached filesystem information. .It Bq Er EFAULT -.Fa Dir +.Fa dir points outside the process's allocated address space. .El .Pp diff --git a/lib/libc/sys/munmap.2 b/lib/libc/sys/munmap.2 index 44f3cbc750a..ea1e6f015d7 100644 --- a/lib/libc/sys/munmap.2 +++ b/lib/libc/sys/munmap.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: munmap.2,v 1.5 1998/07/06 18:28:04 deraadt Exp $ +.\" $OpenBSD: munmap.2,v 1.6 1999/02/27 21:56:35 deraadt Exp $ .\" $NetBSD: munmap.2,v 1.5 1995/02/27 12:35:03 cgd Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -60,7 +60,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Munmap +.Fn munmap will fail if: .Bl -tag -width Er .It Bq Er EINVAL diff --git a/lib/libc/sys/nfssvc.2 b/lib/libc/sys/nfssvc.2 index faedd334d37..702c4cb1e5f 100644 --- a/lib/libc/sys/nfssvc.2 +++ b/lib/libc/sys/nfssvc.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nfssvc.2,v 1.5 1998/07/06 18:28:06 deraadt Exp $ +.\" $OpenBSD: nfssvc.2,v 1.6 1999/02/27 21:56:36 deraadt Exp $ .\" $NetBSD: nfssvc.2,v 1.6 1995/02/27 12:35:08 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -106,7 +106,7 @@ daemon will return from .Fn nfssvc with errno == ENEEDAUTH whenever the client side requires an ``rcmd'' authentication ticket for the user. -.Xr Mount_nfs 8 +.Xr mount_nfs 8 will attempt to get the Kerberos ticket, and if successful will call .Fn nfssvc with the flags diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index a243d63e946..5aa8a9af146 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: open.2,v 1.6 1998/07/06 18:28:07 deraadt Exp $ +.\" $OpenBSD: open.2,v 1.7 1999/02/27 21:56:37 deraadt Exp $ .\" $NetBSD: open.2,v 1.8 1995/02/27 12:35:14 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -147,7 +147,7 @@ and .Pp The system imposes a limit on the number of file descriptors open simultaneously by one process. -.Xr Getdtablesize 3 +.Xr getdtablesize 3 returns the current system limit. .Sh ERRORS The named file is opened unless: @@ -240,7 +240,7 @@ executed and the .Fn open call requests write access. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EEXIST .Dv O_CREAT diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index f55665edde4..299c5ca7721 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pathconf.2,v 1.3 1998/07/06 18:28:08 deraadt Exp $ +.\" $OpenBSD: pathconf.2,v 1.4 1999/02/27 21:56:37 deraadt Exp $ .\" $NetBSD: pathconf.2,v 1.2 1995/02/27 12:35:22 cgd Exp $ .\" .\" Copyright (c) 1993 @@ -129,7 +129,7 @@ argument is invalid. The implementation does not support an association of the variable name with the associated file. .El -.Fn Pathconf +.Fn pathconf will fail if: .Bl -tag -width ENAMETOOLONGAA .It Bq Er ENOTDIR @@ -148,7 +148,7 @@ An I/O error occurred while reading from or writing to the file system. .El .Pp .Bl -tag -width [EFAULT] -.Fn Fpathconf +.Fn fpathconf will fail if: .It Bq Er EBADF .Fa fd diff --git a/lib/libc/sys/poll.2 b/lib/libc/sys/poll.2 index ff0a2e0d280..6aaf79e02de 100644 --- a/lib/libc/sys/poll.2 +++ b/lib/libc/sys/poll.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: poll.2,v 1.4 1998/08/17 17:35:12 deraadt Exp $ +.\" $OpenBSD: poll.2,v 1.5 1999/02/27 21:56:38 deraadt Exp $ .\" .\" Copyright (c) 1994 Jason R. Thorpe .\" All rights reserved. @@ -39,7 +39,7 @@ .Ft int .Fn poll "struct pollfd *fds" "int nfds" "int timeout" .Sh DESCRIPTION -.Fn Poll +.Fn poll provides a mechanism for reporting I/O conditions across a set of file descriptors. .Pp @@ -158,7 +158,7 @@ returns the number of file descriptors for which .Pa revents is non-zero. .Sh ERRORS -.Fn Poll +.Fn poll will fail if: .Bl -tag -width "EINVAL " .It Bq Er EINVAL diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index 7da7bb0b43b..acffa10a944 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: quotactl.2,v 1.3 1998/07/06 18:28:14 deraadt Exp $ +.\" $OpenBSD: quotactl.2,v 1.4 1999/02/27 21:56:39 deraadt Exp $ .\" $NetBSD: quotactl.2,v 1.8 1995/02/27 12:35:43 cgd Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 @@ -102,7 +102,7 @@ Only the super-user may turn quotas off. Get disk quota limits and current usage for the user or group (as determined by the command type) with identifier .Fa id . -.Fa Addr +.Fa addr is a pointer to a .Fa struct dqblk structure. @@ -110,7 +110,7 @@ structure. Set disk quota limits for the user or group (as determined by the command type) with identifier .Fa id . -.Fa Addr +.Fa addr is a pointer to a .Fa struct dqblk structure. @@ -122,7 +122,7 @@ This call is restricted to the super-user. Set disk usage limits for the user or group (as determined by the command type) with identifier .Fa id . -.Fa Addr +.Fa addr is a pointer to a .Fa struct dqblk structure. @@ -154,7 +154,7 @@ option. .It Bq Er EUSERS The quota table cannot be expanded. .It Bq Er EINVAL -.Fa Cmd +.Fa cmd or the command type is invalid. .It Bq Er EACCES In @@ -189,7 +189,7 @@ An invalid was supplied; the associated structure could not be copied in or out of the kernel. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EPERM The call was privileged and the caller was not the super-user. diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index 3117ed91db0..4a1cdefc606 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: read.2,v 1.7 1998/08/17 17:35:13 deraadt Exp $ +.\" $OpenBSD: read.2,v 1.8 1999/02/27 21:56:40 deraadt Exp $ .\" $NetBSD: read.2,v 1.6 1995/02/27 12:35:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -50,7 +50,7 @@ .Ft ssize_t .Fn readv "int d" "const struct iovec *iov" "int iovcnt" .Sh DESCRIPTION -.Fn Read +.Fn read attempts to read .Fa nbytes of data from the object referenced by the descriptor @@ -82,7 +82,7 @@ Each .Fa iovec entry specifies the base address and length of an area in memory where data should be placed. -.Fn Readv +.Fn readv will always fill an area completely before proceeding to the next. .Pp @@ -125,16 +125,16 @@ Otherwise, a -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Read +.Fn read and .Fn readv will succeed unless: .Bl -tag -width Er .It Bq Er EBADF -.Fa D +.Fa d is not a valid file or socket descriptor open for reading. .It Bq Er EFAULT -.Fa Buf +.Fa buf points outside the allocated address space. .It Bq Er EIO An I/O error occurred while reading from the file system. @@ -165,7 +165,7 @@ Also, may return one of the following errors: .Bl -tag -width Er .It Bq Er EINVAL -.Fa Iovcnt +.Fa iovcnt was less than or equal to 0, or greater than .Dv IOV_MAX . .It Bq Er EINVAL diff --git a/lib/libc/sys/readlink.2 b/lib/libc/sys/readlink.2 index 99c50f47627..adc8d7c883f 100644 --- a/lib/libc/sys/readlink.2 +++ b/lib/libc/sys/readlink.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: readlink.2,v 1.5 1998/07/06 18:28:17 deraadt Exp $ +.\" $OpenBSD: readlink.2,v 1.6 1999/02/27 21:56:40 deraadt Exp $ .\" $NetBSD: readlink.2,v 1.7 1995/02/27 12:35:54 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -85,7 +85,7 @@ The named file is not a symbolic link. .It Bq Er EIO An I/O error occurred while reading from the file system. .It Bq Er EFAULT -.Fa Buf +.Fa buf extends outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/reboot.2 b/lib/libc/sys/reboot.2 index ee2829c9e27..5f11f373969 100644 --- a/lib/libc/sys/reboot.2 +++ b/lib/libc/sys/reboot.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: reboot.2,v 1.2 1996/10/08 01:20:13 michaels Exp $ +.\" $OpenBSD: reboot.2,v 1.3 1999/02/27 21:56:41 deraadt Exp $ .\" $NetBSD: reboot.2,v 1.5 1995/02/27 12:36:02 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -46,13 +46,13 @@ .Ft int .Fn reboot "int howto" .Sh DESCRIPTION -.Fn Reboot +.Fn reboot reboots the system. Only the super-user may reboot a machine on demand. However, a reboot is invoked automatically in the event of unrecoverable system failures. .Pp -.Fa Howto +.Fa howto is a mask of options; the system call interface allows the following options, defined in the include file .Aq Pa sys/reboot.h , diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index e1a2bb86e72..3d32bf17df9 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: recv.2,v 1.13 1999/02/15 21:22:25 millert Exp $ +.\" $OpenBSD: recv.2,v 1.14 1999/02/27 21:56:42 deraadt Exp $ .\" $NetBSD: recv.2,v 1.6 1995/02/27 12:36:08 cgd Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 @@ -52,7 +52,7 @@ .Ft ssize_t .Fn recvmsg "int s" "struct msghdr *msg" "int flags" .Sh DESCRIPTION -.Fn Recvfrom +.Fn recvfrom and .Fn recvmsg are used to receive messages from a socket, @@ -63,7 +63,7 @@ If .Fa from is non-nil, and the socket is not connection-oriented, the source address of the message is filled in. -.Fa Fromlen +.Fa fromlen is a value-result parameter, initialized to the size of the buffer associated with .Fa from , @@ -166,12 +166,12 @@ and specify the source address if the socket is unconnected; .Fa msg_name may be given as a null pointer if no names are desired or required. -.Fa Msg_iov +.Fa msg_iov and .Fa msg_iovlen describe scatter gather locations, as discussed in .Xr read 2 . -.Fa Msg_control , +.Fa msg_control , which has length .Fa msg_controllen , points to a buffer for other protocol control related messages @@ -232,7 +232,7 @@ Indicates that the packet was received as multicast. These calls return the number of bytes received, or -1 if an error occurred. .Sh ERRORS -.Fn Recv , +.Fn recv , .Fn recvfrom , and .Fn recvmsg diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index f635c5f77d9..7e4932df025 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rename.2,v 1.3 1999/02/26 19:36:12 csapuntz Exp $ +.\" $OpenBSD: rename.2,v 1.4 1999/02/27 21:56:42 deraadt Exp $ .\" $NetBSD: rename.2,v 1.7 1995/02/27 12:36:15 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn rename "const char *from" "const char *to" .Sh DESCRIPTION -.Fn Rename +.Fn rename causes the link named .Fa from to be renamed as @@ -60,7 +60,7 @@ and must be of the same type (that is, both directories or both non-directories), and must reside on the same file system. .Pp -.Fn Rename +.Fn rename guarantees that an instance of .Fa to will always exist, even if the system should crash in @@ -104,7 +104,7 @@ returns -1 and the global variable .Va errno indicates the reason for the failure. .Sh ERRORS -.Fn Rename +.Fn rename will fail and neither of the argument files will be affected if: .Bl -tag -width Er @@ -186,7 +186,7 @@ system. .Em Path points outside the process's allocated address space. .It Bq Er EINVAL -.Fa From +.Fa from is a parent directory of .Fa to , or an attempt is made to rename @@ -194,7 +194,7 @@ or an attempt is made to rename or .Ql \&.. . .It Bq Er ENOTEMPTY -.Fa To +.Fa to is a directory and is not empty. .El .Sh SEE ALSO diff --git a/lib/libc/sys/revoke.2 b/lib/libc/sys/revoke.2 index d2fb7c015f6..7c471fd67f8 100644 --- a/lib/libc/sys/revoke.2 +++ b/lib/libc/sys/revoke.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: revoke.2,v 1.3 1998/07/06 18:28:20 deraadt Exp $ +.\" $OpenBSD: revoke.2,v 1.4 1999/02/27 21:56:43 deraadt Exp $ .\" $NetBSD: revoke.2,v 1.3 1995/10/12 15:41:11 jtc Exp $ .\" .\" Copyright (c) 1993 @@ -92,7 +92,7 @@ Search permission is denied for a component of the path prefix. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EINVAL The named file is neither a character special or block diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index 3a1221ac752..334e563d3dd 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rfork.2,v 1.9 1999/01/11 01:01:23 niklas Exp $ +.\" $OpenBSD: rfork.2,v 1.10 1999/02/27 21:56:43 deraadt Exp $ .\" .\" This manual page is taken directly from Plan9, and modified to .\" describe the actual OpenBSD implementation. Permission for @@ -29,7 +29,7 @@ The resources include the open file descriptor table (which, when shared, permits processes to open and close files for other processes), and open files. -.Fa Flags +.Fa flags is the logical OR of some subset of .Bl -tag -width "RFCNAMEG" -compact -offset indent .It RFPROC @@ -78,10 +78,10 @@ the return value is zero. Process ids range from 1 to the maximum integer .Ft ( int ) value. -.Fn Rfork +.Fn rfork will sleep, if necessary, until required process resources are available. .Pp -.Fn Fork +.Fn fork can be implemented as a call to .Xr rfork 2 using "RFFDG|RFPROC" @@ -91,7 +91,7 @@ programs will not .Xr execve 2 with extra privileges. .Sh ERRORS -.Fn Rfork +.Fn rfork will fail and no child process will be created if: .Bl -tag -width Er .It Bq Er EAGAIN diff --git a/lib/libc/sys/rmdir.2 b/lib/libc/sys/rmdir.2 index ee8fa1d0ff8..d95c3eec1e0 100644 --- a/lib/libc/sys/rmdir.2 +++ b/lib/libc/sys/rmdir.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rmdir.2,v 1.4 1999/01/22 13:52:05 art Exp $ +.\" $OpenBSD: rmdir.2,v 1.5 1999/02/27 21:56:44 deraadt Exp $ .\" $NetBSD: rmdir.2,v 1.7 1995/02/27 12:36:30 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn rmdir "const char *path" .Sh DESCRIPTION -.Fn Rmdir +.Fn rmdir removes a directory file whose name is given by .Fa path . @@ -97,7 +97,7 @@ or deallocating the inode. .It Bq Er EROFS The directory entry to be removed resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 610be6281c3..8d367e2efd2 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: select.2,v 1.8 1998/07/06 18:28:24 deraadt Exp $ +.\" $OpenBSD: select.2,v 1.9 1999/02/27 21:56:44 deraadt Exp $ .\" $NetBSD: select.2,v 1.5 1995/06/27 22:32:28 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -110,7 +110,7 @@ selection to complete. If is a nil pointer, the select blocks indefinitely. To effect a poll, the .Fa timeout argument should be non-nil, pointing to a zero-valued timeval structure. -.Fa Timeout +.Fa timeout is not changed by .Fn select , and may be reused on subsequent calls, however it is good style to re-initialize diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index c24630c3284..a8719a1a98b 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: send.2,v 1.12 1999/02/17 03:31:08 deraadt Exp $ +.\" $OpenBSD: send.2,v 1.13 1999/02/27 21:56:47 deraadt Exp $ .\" $NetBSD: send.2,v 1.6 1996/01/15 01:17:18 thorpej Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -52,12 +52,12 @@ .Ft ssize_t .Fn sendmsg "int s" "const struct msghdr *msg" "int flags" .Sh DESCRIPTION -.Fn Send , +.Fn send , .Fn sendto , and .Fn sendmsg are used to transmit a message to another socket. -.Fn Send +.Fn send may be used only when the socket is in a .Em connected state, while @@ -122,7 +122,7 @@ structure. The call returns the number of characters sent, or -1 if an error occurred. .Sh ERRORS -.Fn Send , +.Fn send , .Fn sendto , and .Fn sendmsg diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 3e255e4139b..4d4918c445e 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setgroups.2,v 1.3 1998/07/06 18:28:27 deraadt Exp $ +.\" $OpenBSD: setgroups.2,v 1.4 1999/02/27 21:56:47 deraadt Exp $ .\" $NetBSD: setgroups.2,v 1.7 1995/02/27 12:36:49 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993, 1994 @@ -46,7 +46,7 @@ .Ft int .Fn setgroups "int ngroups" "const gid_t *gidset" .Sh DESCRIPTION -.Fn Setgroups +.Fn setgroups sets the group access list of the current user process according to the array .Fa gidset . diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2 index 7514eadee87..273ce7a444e 100644 --- a/lib/libc/sys/setpgid.2 +++ b/lib/libc/sys/setpgid.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: setpgid.2,v 1.4 1998/07/06 18:28:28 deraadt Exp $ +.\" $OpenBSD: setpgid.2,v 1.5 1999/02/27 21:56:48 deraadt Exp $ .\" $NetBSD: setpgid.2,v 1.8 1995/02/27 12:36:55 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -48,7 +48,7 @@ .Ft int .Fn setpgrp "pid_t pid" "pid_t pgrp" .Sh DESCRIPTION -.Fn Setpgid +.Fn setpgid sets the process group of the specified process .Ar pid to the specified @@ -61,13 +61,13 @@ If the invoker is not the super-user, then the affected process must have the same effective user-id as the invoker or be a descendant of the invoking process. .Sh RETURN VALUES -.Fn Setpgid +.Fn setpgid returns 0 when the operation was successful. If the request failed, -1 is returned and the global variable .Va errno indicates the reason. .Sh ERRORS -.Fn Setpgid +.Fn setpgid will fail and the process group will not be altered if: .Bl -tag -width Er .It Bq Er EACCES @@ -97,7 +97,7 @@ The function conforms to .St -p1003.1-88 . .Sh COMPATIBILITY -.Fn Setpgrp +.Fn setpgrp is identical to .Fn setpgid , and is retained for calling convention compatibility with historical diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index abc430f632f..6cb4f6de95a 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaction.2,v 1.17 1998/07/24 00:43:50 espie Exp $ +.\" $OpenBSD: sigaction.2,v 1.18 1999/02/27 21:56:49 deraadt Exp $ .\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -128,7 +128,7 @@ the signal to be delivered, and the signal mask .Em sa_mask associated with the handler to be invoked. .Pp -.Fn Sigaction +.Fn sigaction assigns an action for a signal specified by .Fa sig . If @@ -272,7 +272,7 @@ or all signals, the signal mask, the signal stack, and the restart/interrupt flags are inherited by the child. .Pp -.Xr Execve 2 +.Xr execve 2 reinstates the default action for all signals which were caught and resets all signals to be caught on the user stack. @@ -377,14 +377,14 @@ The function specified in will be called instead of the function specified by .Fa sa_handler (Note that in some implementations these are in fact the same). -.Fa Scp +.Fa scp is a pointer to the .Fa sigcontext structure (defined in .Aq Pa signal.h ) , used to restore the context from before the signal. .Sh ERRORS -.Fn Sigaction +.Fn sigaction will fail and no new signal handler will be installed if one of the following occurs: .Bl -tag -width Er @@ -396,7 +396,7 @@ or points to memory that is not a valid part of the process address space. .It Bq Er EINVAL -.Fa Sig +.Fa sig is not a valid signal number. .It Bq Er EINVAL An attempt is made to ignore or supply a handler for diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index 22f2bcd26c9..82e1742c317 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaltstack.2,v 1.6 1998/12/05 17:55:52 espie Exp $ +.\" $OpenBSD: sigaltstack.2,v 1.7 1999/02/27 21:56:50 deraadt Exp $ .\" $NetBSD: sigaltstack.2,v 1.3 1995/02/27 10:41:52 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1992, 1993 @@ -54,7 +54,7 @@ struct sigaltstack { .Ft int .Fn sigaltstack "const struct sigaltstack *ss" "struct sigaltstack *oss" .Sh DESCRIPTION -.Fn Sigaltstack +.Fn sigaltstack allows users to define an alternate stack on which signals are to be processed. If @@ -141,7 +141,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Sigaltstack +.Fn sigaltstack will fail and the signal stack context will remain unchanged if one of the following occurs. .Bl -tag -width [ENOMEM] diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index afbb52b2c88..5453ffd9f1c 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigreturn.2,v 1.4 1998/07/06 18:28:39 deraadt Exp $ +.\" $OpenBSD: sigreturn.2,v 1.5 1999/02/27 21:56:51 deraadt Exp $ .\" $NetBSD: sigreturn.2,v 1.6 1995/02/27 12:37:40 cgd Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn sigreturn "struct sigcontext *scp" .Sh DESCRIPTION -.Fn Sigreturn +.Fn sigreturn allows users to atomically unmask, switch stacks, and return from a signal context. The processes signal mask and stack status are @@ -69,12 +69,12 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Sigreturn +.Fn sigreturn will fail and the process context will remain unchanged if one of the following occurs. .Bl -tag -width Er .It Bq Er EFAULT -.Fa Scp +.Fa scp points to memory that is not a valid part of the process address space. .It Bq Er EINVAL diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2 index 3505754fd39..5192035fcb8 100644 --- a/lib/libc/sys/sigsuspend.2 +++ b/lib/libc/sys/sigsuspend.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigsuspend.2,v 1.2 1998/07/06 18:28:42 deraadt Exp $ +.\" $OpenBSD: sigsuspend.2,v 1.3 1999/02/27 21:56:51 deraadt Exp $ .\" $NetBSD: sigsuspend.2,v 1.4 1995/02/27 12:37:46 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn sigsuspend "const sigset_t *sigmask" .Sh DESCRIPTION -.Fn Sigsuspend +.Fn sigsuspend temporarily changes the blocked signal mask to the set to which .Fa sigmask points, diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index 96c17eda902..1de078a9e5a 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: socket.2,v 1.6 1998/08/17 17:35:16 deraadt Exp $ +.\" $OpenBSD: socket.2,v 1.7 1999/02/27 21:56:52 deraadt Exp $ .\" $NetBSD: socket.2,v 1.5 1995/02/27 12:37:53 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -46,7 +46,7 @@ .Ft int .Fn socket "int domain" "int type" "int protocol" .Sh DESCRIPTION -.Fn Socket +.Fn socket creates an endpoint for communication and returns a descriptor. .Pp The @@ -207,7 +207,7 @@ The operation of sockets is controlled by socket level .Em options . These options are defined in the file .Ao Pa sys/socket.h Ac . -.Xr Setsockopt 2 +.Xr setsockopt 2 and .Xr getsockopt 2 are used to set and get options, respectively. diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index a48f1f7f5ec..0ee8a9e41eb 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: stat.2,v 1.5 1997/06/13 10:08:36 deraadt Exp $ +.\" $OpenBSD: stat.2,v 1.6 1999/02/27 21:56:53 deraadt Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -59,7 +59,7 @@ Read, write or execute permission of the named file is not required, but all directories listed in the path name leading to the file must be searchable. .Pp -.Fn Lstat +.Fn lstat is like .Fn stat except in the case where the named file is a symbolic link, @@ -203,7 +203,7 @@ and .Li st_blocks fields. .Sh ERRORS -.Fn Stat +.Fn stat and .Fn lstat will fail if: @@ -223,7 +223,7 @@ Search permission is denied for a component of the path prefix. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EFAULT -.Fa Sb +.Fa sb or .Em name points to an invalid address. @@ -232,13 +232,13 @@ An I/O error occurred while reading from or writing to the file system. .El .Pp .Bl -tag -width Er -.Fn Fstat +.Fn fstat will fail if: .It Bq Er EBADF .Fa fd is not a valid open file descriptor. .It Bq Er EFAULT -.Fa Sb +.Fa sb points to an invalid address. .It Bq Er EIO An I/O error occurred while reading from or writing to the file system. diff --git a/lib/libc/sys/statfs.2 b/lib/libc/sys/statfs.2 index 9d4dc3dce36..91e1ba4e98e 100644 --- a/lib/libc/sys/statfs.2 +++ b/lib/libc/sys/statfs.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: statfs.2,v 1.7 1998/07/06 18:28:44 deraadt Exp $ +.\" $OpenBSD: statfs.2,v 1.8 1999/02/27 21:56:53 deraadt Exp $ .\" $NetBSD: statfs.2,v 1.10 1995/06/29 11:40:48 cgd Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 @@ -48,11 +48,11 @@ .Ft int .Fn fstatfs "int fd" "struct statfs *buf" .Sh DESCRIPTION -.Fn Statfs +.Fn statfs returns information about a mounted file system. -.Fa Path +.Fa path is the path name of any file within the mounted file system. -.Fa Buf +.Fa buf is a pointer to a .Nm statfs structure defined as follows: @@ -84,7 +84,7 @@ struct statfs { .Ed .Pp Fields that are undefined for a particular file system are set to -1. -.Fn Fstatfs +.Fn fstatfs returns the same information about an open file referenced by descriptor .Fa fd . .Sh RETURN VALUES @@ -93,12 +93,12 @@ Otherwise, -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Statfs +.Fn statfs fails if one or more of the following are true: .Bl -tag -width Er .It Bq Er ENOTDIR A component of the path prefix of -.Fa Path +.Fa path is not a directory. .It Bq Er ENAMETOOLONG The length of a component of @@ -121,7 +121,7 @@ Search permission is denied for a component of the path prefix of Too many symbolic links were encountered in translating .Fa path . .It Bq Er EFAULT -.Fa Buf +.Fa buf or .Fa path points to an invalid address. @@ -131,14 +131,14 @@ An error occurred while reading from or writing to the file system. .El .Pp -.Fn Fstatfs +.Fn fstatfs fails if one or more of the following are true: .Bl -tag -width Er .It Bq Er EBADF -.Fa Fd +.Fa fd is not a valid open file descriptor. .It Bq Er EFAULT -.Fa Buf +.Fa buf points to an invalid address. .It Bq Er EIO An diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index b2ab1d38cbf..9d493176d0e 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: swapon.2,v 1.2 1998/07/06 18:28:46 deraadt Exp $ +.\" $OpenBSD: swapon.2,v 1.3 1999/02/27 21:56:54 deraadt Exp $ .\" $NetBSD: swapon.2,v 1.7 1995/02/27 12:38:21 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -45,7 +45,7 @@ .Ft int .Fn swapon "const char *special" .Sh DESCRIPTION -.Fn Swapon +.Fn swapon makes the block device .Fa special available to the system for @@ -60,7 +60,7 @@ If an error has occurred, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Swapon +.Fn swapon succeeds unless: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -80,7 +80,7 @@ Too many symbolic links were encountered in translating the pathname. .It Bq Er EPERM The caller is not the super-user. .It Bq Er ENOTBLK -.Fa Special +.Fa special is not a block device. .It Bq Er EBUSY The device specified by @@ -100,7 +100,7 @@ for the associated hardware). .It Bq Er EIO An I/O error occurred while opening the swap device. .It Bq Er EFAULT -.Fa Special +.Fa special points outside the process's allocated address space. .Sh SEE ALSO .Xr swapon 8 , diff --git a/lib/libc/sys/symlink.2 b/lib/libc/sys/symlink.2 index b3ca0085d85..d6a264cbf6c 100644 --- a/lib/libc/sys/symlink.2 +++ b/lib/libc/sys/symlink.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: symlink.2,v 1.5 1998/09/06 22:23:19 aaron Exp $ +.\" $OpenBSD: symlink.2,v 1.6 1999/02/27 21:56:55 deraadt Exp $ .\" $NetBSD: symlink.2,v 1.7 1995/02/27 12:38:34 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -84,7 +84,7 @@ path prefix denies search permission. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EEXIST -.Fa Name2 +.Fa name2 already exists. .It Bq Er EIO An I/O error occurred while making the directory entry for @@ -123,7 +123,7 @@ which the symbolic link is being created has been exhausted. .It Bq Er EIO An I/O error occurred while making the directory entry or allocating the inode. .It Bq Er EFAULT -.Fa Name1 +.Fa name1 or .Fa name2 points outside the process's allocated address space. diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index cc543c3f311..8d3a5891f26 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sync.2,v 1.2 1998/07/06 18:28:49 deraadt Exp $ +.\" $OpenBSD: sync.2,v 1.3 1999/02/27 21:56:55 deraadt Exp $ .\" $NetBSD: sync.2,v 1.4 1995/02/27 12:38:41 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -68,7 +68,7 @@ attributes. .Xr sync 8 , .Xr update 8 .Sh BUGS -.Fn Sync +.Fn sync may return before the buffers are completely flushed. .Sh HISTORY A diff --git a/lib/libc/sys/sysarch.2 b/lib/libc/sys/sysarch.2 index a993619874b..9294f18d89f 100644 --- a/lib/libc/sys/sysarch.2 +++ b/lib/libc/sys/sysarch.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sysarch.2,v 1.2 1998/07/06 18:28:50 deraadt Exp $ +.\" $OpenBSD: sysarch.2,v 1.3 1999/02/27 21:56:56 deraadt Exp $ .\" $NetBSD: sysarch.2,v 1.4 1995/02/27 12:38:47 cgd Exp $ .\" .\" Copyright (c) 1980, 1991 Regents of the University of California. @@ -45,14 +45,14 @@ .Ft int .Fn sysarch "int number" "char *args" .Sh DESCRIPTION -.Fn Sysarch +.Fn sysarch performs the architecture-dependent function specified by .Fa number with the arguments specified by the .Fa args pointer. -.Fa Args +.Fa args is a pointer to a structure defining the actual arguments of the function. Symbolic constants and argument structures diff --git a/lib/libc/sys/syscall.2 b/lib/libc/sys/syscall.2 index 642d9a829b3..6473a2c218e 100644 --- a/lib/libc/sys/syscall.2 +++ b/lib/libc/sys/syscall.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: syscall.2,v 1.2 1998/07/06 18:28:51 deraadt Exp $ +.\" $OpenBSD: syscall.2,v 1.3 1999/02/27 21:56:56 deraadt Exp $ .\" $NetBSD: syscall.2,v 1.4 1995/02/27 12:38:53 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -49,7 +49,7 @@ .Ft int .Fn __syscall "quad_t number" "..." .Sh DESCRIPTION -.Fn Syscall +.Fn syscall performs the system call whose assembly language interface has the specified .Fa number diff --git a/lib/libc/sys/truncate.2 b/lib/libc/sys/truncate.2 index 41814b62c10..41530858ed8 100644 --- a/lib/libc/sys/truncate.2 +++ b/lib/libc/sys/truncate.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: truncate.2,v 1.3 1998/07/06 18:28:52 deraadt Exp $ +.\" $OpenBSD: truncate.2,v 1.4 1999/02/27 21:56:57 deraadt Exp $ .\" $NetBSD: truncate.2,v 1.7 1995/02/27 12:39:00 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -48,7 +48,7 @@ .Ft int .Fn ftruncate "int fd" "off_t length" .Sh DESCRIPTION -.Fn Truncate +.Fn truncate causes the file named by .Fa path or referenced by @@ -67,7 +67,7 @@ fails a -1 is returned, and the global variable .Va errno specifies the error. .Sh ERRORS -.Fn Truncate +.Fn truncate succeeds unless: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -95,14 +95,14 @@ The file is a pure procedure (shared text) file that is being executed. .It Bq Er EIO An I/O error occurred updating the inode. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .It Bq Er EPERM The effective user ID does not match the owner of the file and the effective user ID is not the super-user. .El .Pp -.Fn Ftruncate +.Fn ftruncate succeeds unless: .Bl -tag -width Er .It Bq Er EBADF diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2 index f908b619555..8de5a6a5ff6 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: unlink.2,v 1.5 1998/12/31 00:01:57 millert Exp $ +.\" $OpenBSD: unlink.2,v 1.6 1999/02/27 21:56:58 deraadt Exp $ .\" $NetBSD: unlink.2,v 1.7 1995/02/27 12:39:13 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -105,7 +105,7 @@ or deallocating the inode. .It Bq Er EROFS The named file resides on a read-only file system. .It Bq Er EFAULT -.Fa Path +.Fa path points outside the process's allocated address space. .El .Sh SEE ALSO diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index 7d7df5036c9..49aba659b03 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: utimes.2,v 1.3 1997/06/13 10:08:37 deraadt Exp $ +.\" $OpenBSD: utimes.2,v 1.4 1999/02/27 21:56:59 deraadt Exp $ .\" $NetBSD: utimes.2,v 1.9 1996/04/23 10:34:16 mycroft Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -79,7 +79,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Utimes +.Fn utimes will fail if: .Bl -tag -width Er .It Bq Er EACCES @@ -120,11 +120,11 @@ does not match the owner of the file and is not the super-user. .It Bq Er EROFS The file system containing the file is mounted read-only. .El -.Fn Futimes +.Fn futimes will fail if: .Bl -tag -width Er .It Bq Er EBADF -.Fa Fd +.Fa fd does not refer to a valid descriptor. .It Bq Er EACCES The @@ -135,7 +135,7 @@ and the effective user ID of the process does not match the owner of the file, and is not the super-user, and write access is denied. .It Bq Er EFAULT -.Fa Times +.Fa times points outside the process's allocated address space. .It Bq Er EIO An I/O error occurred while reading or writing the affected inode. diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index ebaafc6f2ac..0c825d45ec3 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: vfork.2,v 1.6 1998/07/06 18:28:56 deraadt Exp $ +.\" $OpenBSD: vfork.2,v 1.7 1999/02/27 21:56:59 deraadt Exp $ .\" $NetBSD: vfork.2,v 1.8 1997/07/10 07:54:13 mikel Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -45,7 +45,7 @@ .Ft pid_t .Fn vfork void .Sh DESCRIPTION -.Fn Vfork +.Fn vfork was originally used to create new processes without fully copying the address space of the old process, which is horrendously inefficient in a paged environment. It was useful when the purpose of @@ -57,7 +57,7 @@ It is the case that is now efficient, even in the above case, so that the need for .Fn vfork is diminished. -.Fn Vfork +.Fn vfork differs from .Xr fork in that the parent is suspended until the child makes a call to @@ -66,7 +66,7 @@ or an exit (either by a call to .Xr _exit 2 or abnormally.) .Pp -.Fn Vfork +.Fn vfork returns 0 in the child's context and (later) the pid of the child in the parent's context. .Sh SEE ALSO diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index bafddd0cb7e..98790034adc 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: wait.2,v 1.4 1998/07/06 18:28:58 deraadt Exp $ +.\" $OpenBSD: wait.2,v 1.5 1999/02/27 21:57:00 deraadt Exp $ .\" $NetBSD: wait.2,v 1.6 1995/02/27 12:39:37 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 @@ -254,7 +254,7 @@ is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Wait +.Fn wait will fail and return immediately if: .Bl -tag -width Er .It Bq Er ECHILD diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 7461bf661ba..dfe8350fa1d 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: write.2,v 1.8 1998/08/17 17:35:17 deraadt Exp $ +.\" $OpenBSD: write.2,v 1.9 1999/02/27 21:57:02 deraadt Exp $ .\" $NetBSD: write.2,v 1.6 1995/02/27 12:39:43 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -50,7 +50,7 @@ .Ft ssize_t .Fn writev "int d" "const struct iovec *iov" "int iovcnt" .Sh DESCRIPTION -.Fn Write +.Fn write attempts to write .Fa nbytes of data to the object referenced by the descriptor @@ -82,7 +82,7 @@ Each .Fa iovec entry specifies the base address and length of an area in memory from which data should be written. -.Fn Writev +.Fn writev will always write a complete area before proceeding to the next. .Pp @@ -137,13 +137,13 @@ is returned. Otherwise a -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Write +.Fn write and .Fn writev will fail and the file pointer will remain unchanged if: .Bl -tag -width Er .It Bq Er EBADF -.Fa D +.Fa d is not a valid descriptor open for writing. .It Bq Er EPIPE An attempt is made to write to a pipe that is not open @@ -192,7 +192,7 @@ Also, may return one of the following errors: .Bl -tag -width Er .It Bq Er EINVAL -.Fa Iovcnt +.Fa iovcnt was less than or equal to 0, or greater than .Dv IOV_MAX . .It Bq Er EINVAL diff --git a/lib/libc/yp/ypclnt.3 b/lib/libc/yp/ypclnt.3 index d5cb57bd0de..466809d8fec 100644 --- a/lib/libc/yp/ypclnt.3 +++ b/lib/libc/yp/ypclnt.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ypclnt.3,v 1.6 1997/06/13 10:09:37 deraadt Exp $ +.\" $OpenBSD: ypclnt.3,v 1.7 1999/02/27 21:57:07 deraadt Exp $ .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -209,7 +209,7 @@ suite, which use UDP. The entire transaction occurs in a single RPC request-response. The third argument to this function provides a way to supply the name of a function to process each key-value pair in the map. -.Fn Yp_all +.Fn yp_all returns after the entire transaction is complete, or the .Pa foreach function decides that it does not want any more key-value pairs. The third |