diff options
| author | lukem <lukem@NetBSD.org> | 1998-08-29 08:32:32 +0000 |
|---|---|---|
| committer | lukem <lukem@NetBSD.org> | 1998-08-29 08:32:32 +0000 |
| commit | ce83c69e00a77ed28196913aa6cd4d90b18a5a40 (patch) | |
| tree | 450c82d7051427c4a5591ae055ee20a914f89ff7 /lib/libc | |
| parent | ed88a6f1032cd4c9cfba1c0bd934bbe6bff8fc05 (diff) | |
first pass at fixing up capitalization of function names and
arguments; ensure that each is correct with respect to the
implementation, rather than being correct as per english.
Diffstat (limited to 'lib/libc')
92 files changed, 345 insertions, 345 deletions
diff --git a/lib/libc/compat-43/creat.3 b/lib/libc/compat-43/creat.3 index a7a457112e5..fbcf26fa7a7 100644 --- a/lib/libc/compat-43/creat.3 +++ b/lib/libc/compat-43/creat.3 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)creat.2 8.1 (Berkeley) 6/2/93 -.\" $NetBSD: creat.3,v 1.11 1998/02/05 18:45:28 perry Exp $ +.\" $NetBSD: creat.3,v 1.12 1998/08/29 08:32:32 lukem Exp $ .\" .Dd June 2, 1993 .Dt CREAT 3 @@ -50,7 +50,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 dd27f2ef71d..14f94fe33c9 100644 --- a/lib/libc/compat-43/gethostid.3 +++ b/lib/libc/compat-43/gethostid.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: gethostid.3,v 1.5 1998/04/28 06:00:52 fair Exp $ +.\" $NetBSD: gethostid.3,v 1.6 1998/08/29 08:32:32 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -49,7 +49,7 @@ .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 .Ux @@ -58,7 +58,7 @@ 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 10eb2e8fb84..99a1f81be41 100644 --- a/lib/libc/compat-43/killpg.3 +++ b/lib/libc/compat-43/killpg.3 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)killpg.2 8.1 (Berkeley) 6/2/93 -.\" $NetBSD: killpg.3,v 1.8 1998/02/05 18:45:34 perry Exp $ +.\" $NetBSD: killpg.3,v 1.9 1998/08/29 08:32:32 lukem Exp $ .\" .Dd June 2, 1993 .Dt KILLPG 3 @@ -45,7 +45,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 @@ -70,11 +70,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 78a373a06c8..291b9916962 100644 --- a/lib/libc/compat-43/sigblock.3 +++ b/lib/libc/compat-43/sigblock.3 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)sigblock.2 8.1 (Berkeley) 6/2/93 -.\" $NetBSD: sigblock.3,v 1.8 1998/02/05 18:45:38 perry Exp $ +.\" $NetBSD: sigblock.3,v 1.9 1998/08/29 08:32:32 lukem Exp $ .\" .Dd June 2, 1993 .Dt SIGBLOCK 3 @@ -52,7 +52,7 @@ This interface is made obsolete by: .Xr sigprocmask 2 . .Ef .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 c9ccb1c3de7..ff45533b5d4 100644 --- a/lib/libc/compat-43/sigpause.3 +++ b/lib/libc/compat-43/sigpause.3 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)sigpause.2 8.1 (Berkeley) 6/2/93 -.\" $NetBSD: sigpause.3,v 1.9 1998/02/05 18:45:42 perry Exp $ +.\" $NetBSD: sigpause.3,v 1.10 1998/08/29 08:32:32 lukem Exp $ .\" .Dd June 2, 1993 .Dt SIGPAUSE 3 @@ -50,16 +50,16 @@ This interface is made obsolete by .Xr sigsuspend 2 . .Ef .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 33425fd2a7b..c3293673aed 100644 --- a/lib/libc/compat-43/sigsetmask.3 +++ b/lib/libc/compat-43/sigsetmask.3 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)sigsetmask.2 8.1 (Berkeley) 6/2/93 -.\" $NetBSD: sigsetmask.3,v 1.9 1998/02/05 18:45:44 perry Exp $ +.\" $NetBSD: sigsetmask.3,v 1.10 1998/08/29 08:32:32 lukem Exp $ .\" .Dd June 2, 1993 .Dt SIGSETMASK 3 @@ -51,7 +51,7 @@ This interface is made obsolete 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 027acb16d1c..d048c589e88 100644 --- a/lib/libc/compat-43/sigvec.3 +++ b/lib/libc/compat-43/sigvec.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: sigvec.3,v 1.15 1998/04/29 18:20:10 fair Exp $ +.\" $NetBSD: sigvec.3,v 1.16 1998/08/29 08:32:33 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -123,7 +123,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 @@ -306,17 +306,17 @@ Here .Fa sig is the signal number, into which the hardware faults and traps are mapped as defined below. -.Fa Code +.Fa code is a parameter that is either a constant or the code provided by the hardware. -.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 Sigvec +.Fn sigvec will fail and no new signal handler will be installed if one of the following occurs: .Bl -tag -width Er @@ -328,7 +328,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/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3 index 39c79305f5f..8489ba3586e 100644 --- a/lib/libc/gen/getdomainname.3 +++ b/lib/libc/gen/getdomainname.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: getdomainname.3,v 1.6 1998/05/08 15:51:39 kleink Exp $ +.\" $NetBSD: getdomainname.3,v 1.7 1998/08/29 08:32:33 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -49,7 +49,7 @@ .Ft int .Fn setdomainname "const char *name" "size_t namelen" .Sh DESCRIPTION -.Fn Getdomainname +.Fn getdomainname returns the standard domain name for the current processor, as previously set by .Fn setdomainname . @@ -60,7 +60,7 @@ specifies the size of the array. The returned name is null-terminated unless insufficient space is provided. .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 4224b512b05..20339b81f64 100644 --- a/lib/libc/gen/gethostname.3 +++ b/lib/libc/gen/gethostname.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: gethostname.3,v 1.6 1998/05/06 19:48:39 kleink Exp $ +.\" $NetBSD: gethostname.3,v 1.7 1998/08/29 08:32:33 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -49,7 +49,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 . @@ -60,7 +60,7 @@ specifies the size of the array. The returned name is null-terminated unless insufficient space is provided. .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 46ec5e244d2..7195b6640ad 100644 --- a/lib/libc/gen/getnetgrent.3 +++ b/lib/libc/gen/getnetgrent.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: getnetgrent.3,v 1.6 1998/02/05 18:46:49 perry Exp $ +.\" $NetBSD: getnetgrent.3,v 1.7 1998/08/29 08:32:33 lukem Exp $ .\" .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. @@ -93,7 +93,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 77faec0767e..6fb8058e8d0 100644 --- a/lib/libc/gen/getpagesize.3 +++ b/lib/libc/gen/getpagesize.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: getpagesize.3,v 1.5 1998/05/24 20:26:02 kleink Exp $ +.\" $NetBSD: getpagesize.3,v 1.6 1998/08/29 08:32:33 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -51,7 +51,7 @@ This interface is obsoleted by .Xr sysconf 3 . .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. .Pp diff --git a/lib/libc/gen/utime.3 b/lib/libc/gen/utime.3 index 93c16fd0611..24ffcbf6492 100644 --- a/lib/libc/gen/utime.3 +++ b/lib/libc/gen/utime.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: utime.3,v 1.12 1998/04/28 20:11:36 fair Exp $ +.\" $NetBSD: utime.3,v 1.13 1998/08/29 08:32:34 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -92,7 +92,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 diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3 index 0713621b1f2..080ce70fa7c 100644 --- a/lib/libc/net/resolver.3 +++ b/lib/libc/net/resolver.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: resolver.3,v 1.9 1998/02/05 18:48:56 perry Exp $ +.\" $NetBSD: resolver.3,v 1.10 1998/08/29 08:32:34 lukem Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -254,7 +254,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 250da269887..d7838ab68c0 100644 --- a/lib/libc/regex/regex.3 +++ b/lib/libc/regex/regex.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: regex.3,v 1.8 1998/02/06 05:41:14 perry Exp $ +.\" $NetBSD: regex.3,v 1.9 1998/08/29 08:32:34 lukem Exp $ .\" .\" Copyright (c) 1992, 1993, 1994 Henry Spencer. .\" Copyright (c) 1992, 1993, 1994 @@ -89,7 +89,7 @@ a type .Fa 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, @@ -99,7 +99,7 @@ and places the results in the .Fa 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 XXXREG_EXTENDED .It Dv REG_EXTENDED @@ -174,7 +174,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 @@ -344,7 +344,7 @@ the value of will not be changed by a successful .Fn regexec . .Pp -.Fn Regerror +.Fn regerror maps a non-zero .Fa errcode from either @@ -365,11 +365,11 @@ it should have been the result from the most recent .Fn regcomp using that .Fa regex_t . ( -.Fn Regerror +.Fn regerror may be able to supply a more detailed message using information from the .Fa 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 @@ -419,7 +419,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 . @@ -555,14 +555,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. -.Fa Regexec +.Fa regexec is largely insensitive to RE complexity .Em except that back references are massively expensive. @@ -570,7 +570,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 cc26cb9fed7..2906bb30dbe 100644 --- a/lib/libc/stdio/fflush.3 +++ b/lib/libc/stdio/fflush.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: fflush.3,v 1.6 1998/04/28 20:58:00 fair Exp $ +.\" $NetBSD: fflush.3,v 1.7 1998/08/29 08:32:34 lukem Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -89,7 +89,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 fd7a4484b71..3a0c82ccd47 100644 --- a/lib/libc/stdio/printf.3 +++ b/lib/libc/stdio/printf.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: printf.3,v 1.11 1998/08/28 22:21:23 perry Exp $ +.\" $NetBSD: printf.3,v 1.12 1998/08/29 08:32:34 lukem Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -83,7 +83,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 @@ -120,7 +120,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 @@ -135,7 +135,7 @@ will return -1 and set .Fa ret to be a NULL pointer. .Pp -.Fn Snprintf +.Fn snprintf and .Fn vsnprintf will write at most @@ -150,7 +150,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 bdfb6b6c4dc..116d9be9b8a 100644 --- a/lib/libc/stdio/putc.3 +++ b/lib/libc/stdio/putc.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: putc.3,v 1.4 1998/02/05 18:49:30 perry Exp $ +.\" $NetBSD: putc.3,v 1.5 1998/08/29 08:32:34 lukem Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -68,7 +68,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 @@ -77,7 +77,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/stdlib/exit.3 b/lib/libc/stdlib/exit.3 index bcc138fb820..c00ce06cf13 100644 --- a/lib/libc/stdlib/exit.3 +++ b/lib/libc/stdlib/exit.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: exit.3,v 1.5 1998/02/05 18:49:53 perry Exp $ +.\" $NetBSD: exit.3,v 1.6 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -50,7 +50,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 e536684e96e..914ae750722 100644 --- a/lib/libc/stdlib/qsort.3 +++ b/lib/libc/stdlib/qsort.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: qsort.3,v 1.6 1998/02/05 18:50:12 perry Exp $ +.\" $NetBSD: qsort.3,v 1.7 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -77,7 +77,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 @@ -114,7 +114,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. @@ -123,7 +123,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 @@ -139,7 +139,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 @@ -181,7 +181,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/sys/access.2 b/lib/libc/sys/access.2 index a148b2feeb6..8064e825eea 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: access.2,v 1.9 1997/07/14 23:19:50 kleink Exp $ +.\" $NetBSD: access.2,v 1.10 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -118,7 +118,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 5c041ec7e86..48e2fa67d45 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: acct.2,v 1.6 1995/02/27 12:31:47 cgd Exp $ +.\" $NetBSD: acct.2,v 1.7 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -81,7 +81,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 @@ -104,7 +104,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 b6214392781..721bd4ea931 100644 --- a/lib/libc/sys/adjtime.2 +++ b/lib/libc/sys/adjtime.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: adjtime.2,v 1.6 1997/11/01 06:37:47 mycroft Exp $ +.\" $NetBSD: adjtime.2,v 1.7 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,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 @@ -88,7 +88,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 a4baee90e7b..bed631eaa3a 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: bind.2,v 1.9 1998/04/28 06:00:53 fair Exp $ +.\" $NetBSD: bind.2,v 1.10 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,14 +45,14 @@ .Ft int .Fn bind "int s" "const struct sockaddr *name" "int 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. @@ -77,10 +77,10 @@ The call will fail if: .Bl -tag -width Er .It Bq Er EBADF -.Fa S +.Fa s is not a valid descriptor. .It Bq Er ENOTSOCK -.Fa S +.Fa s is not a socket. .It Bq Er EADDRNOTAVAIL The specified address is not available from the local machine. diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index ed60833a507..943d553bf0d 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: chdir.2,v 1.9 1997/07/14 23:19:51 kleink Exp $ +.\" $NetBSD: chdir.2,v 1.10 1998/08/29 08:32:35 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -78,7 +78,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 @@ -98,13 +98,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 faeace17c96..3f483ad2280 100644 --- a/lib/libc/sys/chflags.2 +++ b/lib/libc/sys/chflags.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: chflags.2,v 1.11 1998/02/03 21:12:45 perry Exp $ +.\" $NetBSD: chflags.2,v 1.12 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1989, 1993 .\" The Regents of the University of California. All rights reserved. @@ -104,7 +104,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 if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -133,7 +133,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 @@ -141,13 +141,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 EPERM The effective user ID does not match the owner of the file and diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index 87b8028b6a4..523165439ff 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: chroot.2,v 1.8 1997/09/27 19:33:20 hubertf Exp $ +.\" $NetBSD: chroot.2,v 1.9 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,9 +44,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, @@ -68,7 +68,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 @@ -86,7 +86,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 f1c57bfd643..db122a96fb5 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: close.2,v 1.7 1998/04/28 22:28:30 fair Exp $ +.\" $NetBSD: close.2,v 1.8 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -109,11 +109,11 @@ 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 -.Fa D +.Fa d is not an active descriptor. .It Bq Er EINTR An interrupt was received. diff --git a/lib/libc/sys/connect.2 b/lib/libc/sys/connect.2 index dca2e9b5ea6..ebd09c2d62f 100644 --- a/lib/libc/sys/connect.2 +++ b/lib/libc/sys/connect.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: connect.2,v 1.10 1998/07/28 09:43:30 is Exp $ +.\" $NetBSD: connect.2,v 1.11 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. @@ -81,10 +81,10 @@ The call fails if: .Bl -tag -width Er .It Bq Er EBADF -.Fa S +.Fa s is not a valid descriptor. .It Bq Er ENOTSOCK -.Fa S +.Fa s is a descriptor for a file, not a socket. .It Bq Er EADDRNOTAVAIL The specified address is not available on this machine. diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index e4f74688c52..417ee79bdb8 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: dup.2,v 1.7 1997/07/14 23:19:54 kleink Exp $ +.\" $NetBSD: dup.2,v 1.8 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -47,7 +47,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 @@ -103,13 +103,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 diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index e05d33d6e97..26a3bc68d7c 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: execve.2,v 1.13 1998/02/02 05:20:26 perry Exp $ +.\" $NetBSD: execve.2,v 1.14 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,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 @@ -199,7 +199,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 @@ -248,7 +248,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 ba3700a3620..08e4781dcdd 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: fcntl.2,v 1.12 1998/04/28 22:28:30 fair Exp $ +.\" $NetBSD: fcntl.2,v 1.13 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,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 @@ -356,7 +356,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 @@ -376,7 +376,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 @@ -407,7 +407,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 @@ -425,7 +425,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 @@ -466,7 +466,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 bc67a443b82..ee8089cf9ef 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: flock.2,v 1.7 1998/05/10 12:55:10 kleink Exp $ +.\" $NetBSD: flock.2,v 1.8 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -48,7 +48,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 844d5b3b71b..2ad20f61940 100644 --- a/lib/libc/sys/fork.2 +++ b/lib/libc/sys/fork.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: fork.2,v 1.9 1998/04/28 22:28:31 fair Exp $ +.\" $NetBSD: fork.2,v 1.10 1998/08/29 08:32:36 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,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: @@ -85,7 +85,7 @@ child process is created, and the global 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 3f4b0d69455..a9d7cf6d1e5 100644 --- a/lib/libc/sys/fsync.2 +++ b/lib/libc/sys/fsync.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: fsync.2,v 1.4 1995/02/27 12:32:38 cgd Exp $ +.\" $NetBSD: fsync.2,v 1.5 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,14 +44,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. @@ -64,10 +64,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/getdents.2 b/lib/libc/sys/getdents.2 index 651ede996cc..830ed626797 100644 --- a/lib/libc/sys/getdents.2 +++ b/lib/libc/sys/getdents.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getdents.2,v 1.2 1998/02/03 21:12:46 perry Exp $ +.\" $NetBSD: getdents.2,v 1.3 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,7 @@ .Ft int .Fn getdents "int fd" "char *buf" "size_t nbytes" .Sh DESCRIPTION -.Fn Getdents +.Fn getdents reads directory entries from the directory referenced by the file descriptor .Fa fd @@ -54,7 +54,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 @@ -123,7 +123,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/getdirentries.3 b/lib/libc/sys/getdirentries.3 index 041cde95bac..5aa0172b499 100644 --- a/lib/libc/sys/getdirentries.3 +++ b/lib/libc/sys/getdirentries.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: getdirentries.3,v 1.2 1998/02/03 21:12:46 perry Exp $ +.\" $NetBSD: getdirentries.3,v 1.3 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -52,7 +52,7 @@ has been obsoleted by .Xr getdents 2 . .Ef .Pp -.Fn Getdirentries +.Fn getdirentries reads directory entries from the directory referenced by the file descriptor .Fa fd @@ -62,7 +62,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 @@ -120,7 +120,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 @@ -136,7 +136,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 392362ec5d5..594eaa5e0fc 100644 --- a/lib/libc/sys/getfh.2 +++ b/lib/libc/sys/getfh.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getfh.2,v 1.8 1998/02/03 21:12:47 perry Exp $ +.\" $NetBSD: getfh.2,v 1.9 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,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 . @@ -56,7 +56,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 @@ -84,7 +84,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 9b8acc5a017..a7e41cedbda 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getfsstat.2,v 1.11 1998/02/03 21:12:48 perry Exp $ +.\" $NetBSD: getfsstat.2,v 1.12 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -46,9 +46,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 .Nm statfs structures defined as follows: @@ -146,11 +146,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 0c2791095da..e2cdc492de5 100644 --- a/lib/libc/sys/getgid.2 +++ b/lib/libc/sys/getgid.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getgid.2,v 1.7 1997/07/16 07:09:14 mikel Exp $ +.\" $NetBSD: getgid.2,v 1.8 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -75,7 +75,7 @@ indicate an error. .Xr setgid 2 , .Xr setregid 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 418a15e5607..d2b8ba49fe7 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getgroups.2,v 1.10 1998/02/16 15:35:07 kleink Exp $ +.\" $NetBSD: getgroups.2,v 1.11 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,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 . @@ -53,7 +53,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 eaafce4bfcb..67f26b3a486 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getitimer.2,v 1.7 1998/02/02 05:20:28 perry Exp $ +.\" $NetBSD: getitimer.2,v 1.8 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -129,7 +129,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 @@ -141,7 +141,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 1250f7a40bc..d7b7acee8b5 100644 --- a/lib/libc/sys/getlogin.2 +++ b/lib/libc/sys/getlogin.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getlogin.2,v 1.6 1998/02/03 21:12:48 perry Exp $ +.\" $NetBSD: getlogin.2,v 1.7 1998/08/29 08:32:37 lukem Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -61,7 +61,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/getpid.2 b/lib/libc/sys/getpid.2 index 1b79019b5d8..8bcf6fb2426 100644 --- a/lib/libc/sys/getpid.2 +++ b/lib/libc/sys/getpid.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getpid.2,v 1.7 1997/07/14 23:20:01 kleink Exp $ +.\" $NetBSD: getpid.2,v 1.8 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -48,14 +48,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 @@ -68,7 +68,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 1c5713afd78..6e83b96c2c3 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getpriority.2,v 1.4 1995/02/27 12:33:15 cgd Exp $ +.\" $NetBSD: getpriority.2,v 1.5 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -58,7 +58,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 , @@ -78,7 +78,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 @@ -103,7 +103,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: @@ -115,7 +115,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 0874f9cdded..efd89a2c906 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getrlimit.2,v 1.11 1998/04/28 22:28:31 fair Exp $ +.\" $NetBSD: getrlimit.2,v 1.12 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -156,7 +156,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 a2a81250e6e..0b985a0a247 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getrusage.2,v 1.5 1997/03/21 05:59:54 mikel Exp $ +.\" $NetBSD: getrusage.2,v 1.6 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -47,7 +47,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 @@ -140,7 +140,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/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 28d624eac0c..69473cc981a 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getsockopt.2,v 1.14 1998/07/28 09:43:30 is Exp $ +.\" $NetBSD: getsockopt.2,v 1.15 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -48,7 +48,7 @@ .Ft int .Fn setsockopt "int s" "int level" "int optname" "const void *optval" "int optlen" .Sh DESCRIPTION -.Fn Getsockopt +.Fn getsockopt and .Fn setsockopt manipulate the @@ -97,7 +97,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 4847ece563e..f03d85f9db4 100644 --- a/lib/libc/sys/getuid.2 +++ b/lib/libc/sys/getuid.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: getuid.2,v 1.7 1997/07/14 23:20:03 kleink Exp $ +.\" $NetBSD: getuid.2,v 1.8 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -76,7 +76,7 @@ indicate an error. .Xr setreuid 2 .Sh STANDARDS The -.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 9eb6001e319..95ac7ec0376 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: ioctl.2,v 1.5 1995/02/27 12:33:47 cgd Exp $ +.\" $NetBSD: ioctl.2,v 1.6 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -75,7 +75,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 @@ -91,7 +91,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 39a362d7da8..f242cd0e725 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: kill.2,v 1.9 1997/07/15 07:13:29 mikel Exp $ +.\" $NetBSD: kill.2,v 1.10 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -52,7 +52,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 @@ -71,11 +71,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; @@ -102,11 +102,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 0f127bc21c1..34ea4352b57 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: ktrace.2,v 1.4 1998/06/27 21:22:56 christos Exp $ +.\" $NetBSD: ktrace.2,v 1.5 1998/08/29 08:32:38 lukem Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -144,7 +144,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 2aa2ae1cbdf..527f7f8dc14 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: link.2,v 1.10 1997/07/14 23:20:05 kleink Exp $ +.\" $NetBSD: link.2,v 1.11 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -68,7 +68,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 @@ -76,7 +76,7 @@ both and .Fa name2 must be in the same file system. -.Fa Name1 +.Fa name1 may not be a directory unless the caller is the super-user and the file system containing it supports linking to directories. .Sh RETURN VALUES @@ -85,7 +85,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 9e782a2e4d2..13586d58c5c 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: listen.2,v 1.7 1996/02/16 20:38:45 phil Exp $ +.\" $NetBSD: listen.2,v 1.8 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -73,7 +73,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 f48e88dc7ea..22ed2fb23c0 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: lseek.2,v 1.10 1997/11/12 00:47:47 mrg Exp $ +.\" $NetBSD: lseek.2,v 1.11 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -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 file offset would be invalid. .El .Sh SEE ALSO diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 155353e8c41..3ad314fe042 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: mkdir.2,v 1.10 1997/07/14 23:20:06 kleink Exp $ +.\" $NetBSD: mkdir.2,v 1.11 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -61,7 +61,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 @@ -100,7 +100,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 4611c257c69..3817bc83d52 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: mkfifo.2,v 1.9 1997/07/14 23:20:07 kleink Exp $ +.\" $NetBSD: mkfifo.2,v 1.10 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,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 @@ -63,7 +63,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 @@ -110,7 +110,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 36b6d97e821..99420a68c76 100644 --- a/lib/libc/sys/mknod.2 +++ b/lib/libc/sys/mknod.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: mknod.2,v 1.7 1997/11/02 17:16:48 kleink Exp $ +.\" $NetBSD: mknod.2,v 1.8 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -66,7 +66,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. @@ -74,7 +74,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 @@ -115,7 +115,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 a729c19373f..75f5657754f 100644 --- a/lib/libc/sys/mlock.2 +++ b/lib/libc/sys/mlock.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: mlock.2,v 1.5 1998/02/03 21:12:51 perry Exp $ +.\" $NetBSD: mlock.2,v 1.6 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -111,7 +111,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 @@ -123,7 +123,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 58498d1f0b8..afe4c0f0071 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: mmap.2,v 1.15 1998/06/03 22:03:44 kleink Exp $ +.\" $NetBSD: mmap.2,v 1.16 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -177,7 +177,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 @@ -200,7 +200,7 @@ 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 .\"One of @@ -218,10 +218,10 @@ valid address range for a process. .Dv MAP_ANON was specified and .Fa fd was not \-1. -.Fa Len +.Fa len was less than zero. .It Bq Er ENODEV -.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 5963b700d62..7a66b581834 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: mount.2,v 1.16 1998/06/08 09:45:50 lukem Exp $ +.\" $NetBSD: mount.2,v 1.17 1998/08/29 08:32:39 lukem Exp $ .\" .\" Copyright (c) 1980, 1989, 1993 .\" The Regents of the University of California. All rights reserved. @@ -118,7 +118,7 @@ The types of file systems known to the system are defined in .\" sysctl vfs .\" .Ed .\" .Pp -.Fa Data +.Fa data is a pointer to a structure that contains the type specific arguments to mount. The currently supported types of file systems and @@ -234,7 +234,7 @@ is not a directory. 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. .El .Pp @@ -328,7 +328,7 @@ on the file system. .It Bq Er EIO An I/O error occurred while writing cached file system 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 4b5807f253d..f16b4873021 100644 --- a/lib/libc/sys/munmap.2 +++ b/lib/libc/sys/munmap.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: munmap.2,v 1.9 1998/02/03 21:12:52 perry Exp $ +.\" $NetBSD: munmap.2,v 1.10 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -59,7 +59,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/open.2 b/lib/libc/sys/open.2 index 82be614834e..a4bdb0b29f9 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: open.2,v 1.14 1998/08/02 18:32:20 kleink Exp $ +.\" $NetBSD: open.2,v 1.15 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -279,7 +279,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 14a876a1b37..79201cae135 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: pathconf.2,v 1.6 1998/08/07 13:28:23 kleink Exp $ +.\" $NetBSD: pathconf.2,v 1.7 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -130,7 +130,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 @@ -149,7 +149,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 a727d1a3fac..31a4f370643 100644 --- a/lib/libc/sys/poll.2 +++ b/lib/libc/sys/poll.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: poll.2,v 1.5 1998/08/15 09:16:27 mycroft Exp $ +.\" $NetBSD: poll.2,v 1.6 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -46,7 +46,7 @@ .Ft int .Fn poll "struct pollfd *fds" "nfds_t nfds" "int timeout" .Sh DESCRIPTION -.Fn Poll +.Fn poll examines a set of file descriptors to see if some of them are ready for I/O. The @@ -131,7 +131,7 @@ is zero, then .Fn poll will return without blocking. .Sh RETURN VALUES -.Fn Poll +.Fn poll returns the number of descriptors that are ready for I/O, or -1 if an error occured. If the time limit expires, .Fn poll @@ -162,7 +162,7 @@ An error return from indicates: .Bl -tag -width Er .It Bq Er EFAULT -.Fa Fds +.Fa fds points outside the process's allocated address space. .It Bq Er EINTR A signal was delivered before the time limit expired and diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index 37baeafca99..272c8dc69d5 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: quotactl.2,v 1.11 1998/02/02 05:20:34 perry Exp $ +.\" $NetBSD: quotactl.2,v 1.12 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -101,7 +101,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 (defined in @@ -110,7 +110,7 @@ structure (defined in 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 (defined in @@ -123,7 +123,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 (defined in @@ -156,7 +156,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 @@ -191,7 +191,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 2976798e03d..15d981e2176 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: read.2,v 1.11 1998/08/03 15:02:47 kleink Exp $ +.\" $NetBSD: read.2,v 1.12 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -55,21 +55,21 @@ .Ft ssize_t .Fn preadv "int d" "const struct iovec *iov" "int iovcnt" "off_t offset" .Sh DESCRIPTION -.Fn Read +.Fn read attempts to read .Fa nbytes of data from the object referenced by the descriptor .Fa d into the buffer pointed to by .Fa buf . -.Fn Readv +.Fn readv performs the same action, but scatters the input data into the .Fa iovcnt buffers specified by the members of the .Fa iov array: iov[0], iov[1], ..., iov[iovcnt\|\-\|1]. -.Fn Pread +.Fn pread and .Fn preadv perform the same functions, but read from the specified position in @@ -94,7 +94,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 @@ -132,7 +132,7 @@ Otherwise, a -1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS -.Fn Read , +.Fn read , .Fn readv , .Fn pread , and @@ -140,10 +140,10 @@ and 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. @@ -169,7 +169,7 @@ and 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 30a0b7573fa..cc3a735f254 100644 --- a/lib/libc/sys/readlink.2 +++ b/lib/libc/sys/readlink.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: readlink.2,v 1.9 1998/03/27 13:02:21 kleink Exp $ +.\" $NetBSD: readlink.2,v 1.10 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,14 +44,14 @@ .Ft int .Fn readlink "const char *path" "char *buf" "size_t bufsiz" .Sh DESCRIPTION -.Fn Readlink +.Fn readlink places the contents of the symbolic link .Fa path in the buffer .Fa buf , which has size .Fa bufsiz . -.Nm Readlink +.Fn readlink does not append a .Dv NUL character to @@ -62,7 +62,7 @@ if it succeeds, or a -1 if an error occurs, placing the error code in the global variable .Va errno . .Sh ERRORS -.Fn Readlink +.Fn readlink will fail if: .Bl -tag -width Er .It Bq Er ENOTDIR @@ -84,7 +84,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 2e6c7474768..9256fb3da47 100644 --- a/lib/libc/sys/reboot.2 +++ b/lib/libc/sys/reboot.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: reboot.2,v 1.8 1997/07/15 03:04:56 mikel Exp $ +.\" $NetBSD: reboot.2,v 1.9 1998/08/29 08:32:40 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,13 +45,13 @@ .Ft int .Fn reboot "int howto, char *bootstr" .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 , @@ -131,7 +131,7 @@ An automatic consistency check of the disks is normally performed (see .Xr fsck 8 ) . .Dv RB_STRING -.Fa Bootstr +.Fa bootstr is a string passed to the firmware on the machine, if possible, if this option is set. Currently this only implemented on the sparc and the sun3. .El diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index f8636fa0b9c..ae05215abff 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: recv.2,v 1.10 1998/08/04 19:48:34 kleink Exp $ +.\" $NetBSD: recv.2,v 1.11 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -51,7 +51,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, @@ -62,7 +62,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 , @@ -167,12 +167,12 @@ and specify the destination 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 @@ -258,7 +258,7 @@ The total length of the I/O is more than can be expressed by the ssize_t return value. .El .Pp -.Fn Recvmsg +.Fn recvmsg will also fail if: .Bl -tag -width Er .It Bq Er EMSGSIZE diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index ad5a0f7333e..eb9c75563c0 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: rename.2,v 1.8 1998/05/24 19:09:23 kleink Exp $ +.\" $NetBSD: rename.2,v 1.9 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,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 @@ -59,7 +59,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 @@ -111,7 +111,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 @@ -190,7 +190,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 @@ -198,7 +198,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 00d09917139..4e5ff8e436b 100644 --- a/lib/libc/sys/revoke.2 +++ b/lib/libc/sys/revoke.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: revoke.2,v 1.3 1995/10/12 15:41:11 jtc Exp $ +.\" $NetBSD: revoke.2,v 1.4 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -91,7 +91,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/rmdir.2 b/lib/libc/sys/rmdir.2 index 34ffcb0dc15..5978d82aa9f 100644 --- a/lib/libc/sys/rmdir.2 +++ b/lib/libc/sys/rmdir.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: rmdir.2,v 1.9 1997/07/14 23:20:12 kleink Exp $ +.\" $NetBSD: rmdir.2,v 1.10 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,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 . @@ -96,7 +96,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/send.2 b/lib/libc/sys/send.2 index bfca3b31628..d30b7e8e9fe 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: send.2,v 1.10 1998/08/04 19:48:34 kleink Exp $ +.\" $NetBSD: send.2,v 1.11 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -51,12 +51,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 @@ -123,7 +123,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 @@ -160,7 +160,7 @@ The total length of the I/O is more than can be expressed by the ssize_t return value. .El .Pp -.Fn Sendmsg +.Fn sendmsg will also fail if: .Bl -tag -width Er .It Bq Er EMSGSIZE diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 1547f702787..f5a6a96ed03 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: setgroups.2,v 1.7 1995/02/27 12:36:49 cgd Exp $ +.\" $NetBSD: setgroups.2,v 1.8 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,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 a43562ed0e2..ca2533cc53a 100644 --- a/lib/libc/sys/setpgid.2 +++ b/lib/libc/sys/setpgid.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: setpgid.2,v 1.11 1997/11/27 07:37:20 mikel Exp $ +.\" $NetBSD: setpgid.2,v 1.12 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -47,7 +47,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 @@ -60,13 +60,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 @@ -96,7 +96,7 @@ The function conforms to .St -p1003.1-90 . .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 8019affbb47..9d5df4b3d7d 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: sigaction.2,v 1.18 1998/07/11 06:39:22 mrg Exp $ +.\" $NetBSD: sigaction.2,v 1.19 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -121,7 +121,7 @@ the signal to be delivered, and the signal mask associated with the handler to be invoked, .Em sa_mask . .Pp -.Fn Sigaction +.Fn sigaction assigns an action for a specific signal. If .Fa act @@ -305,10 +305,10 @@ Here .Fa sig is the signal number, into which the hardware faults and traps are mapped. -.Fa Code +.Fa code is a parameter that is either a constant or the code provided by the hardware. -.Fa Scp +.Fa scp is a pointer to the .Fa sigcontext structure (defined in @@ -327,7 +327,7 @@ interface with the .Fa siginfo interface. .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 @@ -339,7 +339,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 d603bb8e5d5..615732859bf 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: sigaltstack.2,v 1.7 1998/02/02 05:20:35 perry Exp $ +.\" $NetBSD: sigaltstack.2,v 1.8 1998/08/29 08:32:41 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1992, 1993 .\" The Regents of the University of California. All rights reserved. @@ -52,7 +52,7 @@ typedef struct sigaltstack { .Ft int .Fn sigaltstack "const stack_t *ss" "stack_t *oss" .Sh DESCRIPTION -.Fn Sigaltstack +.Fn sigaltstack allows users to define an alternative stack on which signals are to be processed. If @@ -139,7 +139,7 @@ Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS -.Fn Sigstack +.Fn sigstack will fail and the signal stack context will remain unchanged if one of the following occurs. .Bl -tag -width Er diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index a66238ed4c5..f045ca4fadf 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: sigreturn.2,v 1.7 1998/02/06 05:41:36 perry Exp $ +.\" $NetBSD: sigreturn.2,v 1.8 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -55,7 +55,7 @@ struct sigcontext { .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 @@ -77,12 +77,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 f062de2578a..3e9388e4080 100644 --- a/lib/libc/sys/sigsuspend.2 +++ b/lib/libc/sys/sigsuspend.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: sigsuspend.2,v 1.7 1998/04/28 22:28:32 fair Exp $ +.\" $NetBSD: sigsuspend.2,v 1.8 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -44,7 +44,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 a1184bcc8bb..9ef15b39380 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: socket.2,v 1.11 1998/08/01 21:51:06 thorpej Exp $ +.\" $NetBSD: socket.2,v 1.12 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,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 diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index 8b70d99cd03..04b62e150b0 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: stat.2,v 1.15 1998/02/02 05:20:36 perry Exp $ +.\" $NetBSD: stat.2,v 1.16 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -238,7 +238,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. @@ -253,7 +253,7 @@ will fail if: .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 eadca5e7668..88b646014c2 100644 --- a/lib/libc/sys/statfs.2 +++ b/lib/libc/sys/statfs.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: statfs.2,v 1.15 1998/02/03 21:12:54 perry Exp $ +.\" $NetBSD: statfs.2,v 1.16 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -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: @@ -114,7 +114,7 @@ The filesystem is exported with Kerberos uid mapping. .El .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 @@ -123,12 +123,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 @@ -151,7 +151,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. @@ -161,14 +161,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.3 b/lib/libc/sys/swapon.3 index 24bb27d08a0..2899580a018 100644 --- a/lib/libc/sys/swapon.3 +++ b/lib/libc/sys/swapon.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: swapon.3,v 1.2 1998/02/28 13:58:39 enami Exp $ +.\" $NetBSD: swapon.3,v 1.3 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -51,7 +51,7 @@ has been obsoleted by .Xr swapctl 2 . .Ef .Pp -.Fn Swapon +.Fn swapon makes the block device .Fa special available to the system for @@ -66,7 +66,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 ENAMETOOLONG .It Bq Er ENOTDIR @@ -86,7 +86,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 @@ -106,7 +106,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 fd3261a7441..ff015d9fcc4 100644 --- a/lib/libc/sys/symlink.2 +++ b/lib/libc/sys/symlink.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: symlink.2,v 1.8 1997/03/25 05:18:21 mikel Exp $ +.\" $NetBSD: symlink.2,v 1.9 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -83,7 +83,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 @@ -122,7 +122,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 a94475b4e07..8ec3b22543c 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: sync.2,v 1.4 1995/02/27 12:38:41 cgd Exp $ +.\" $NetBSD: sync.2,v 1.5 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -67,7 +67,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 fd37bfbd198..2ad36c08efb 100644 --- a/lib/libc/sys/sysarch.2 +++ b/lib/libc/sys/sysarch.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: sysarch.2,v 1.6 1998/02/25 21:24:57 perry Exp $ +.\" $NetBSD: sysarch.2,v 1.7 1998/08/29 08:32:42 lukem Exp $ .\" .\" Copyright (c) 1980, 1991 Regents of the University of California. .\" All rights reserved. @@ -44,14 +44,14 @@ .Ft int .Fn sysarch "int number" "void *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 5e6384be352..5d324fcb0ff 100644 --- a/lib/libc/sys/syscall.2 +++ b/lib/libc/sys/syscall.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: syscall.2,v 1.5 1996/12/21 01:38:56 cgd Exp $ +.\" $NetBSD: syscall.2,v 1.6 1998/08/29 08:32:43 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -48,7 +48,7 @@ .Ft quad_t .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 06f01dec084..38c981a9aa8 100644 --- a/lib/libc/sys/truncate.2 +++ b/lib/libc/sys/truncate.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: truncate.2,v 1.7 1995/02/27 12:39:00 cgd Exp $ +.\" $NetBSD: truncate.2,v 1.8 1998/08/29 08:32:43 lukem Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -47,7 +47,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 @@ -66,7 +66,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 @@ -94,11 +94,11 @@ 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. .El .Pp -.Fn Ftruncate +.Fn ftruncate succeeds unless: .Bl -tag -width Er .It Bq Er EBADF diff --git a/lib/libc/sys/undelete.2 b/lib/libc/sys/undelete.2 index 301a2d6ae55..20eaa6eeba3 100644 --- a/lib/libc/sys/undelete.2 +++ b/lib/libc/sys/undelete.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: undelete.2,v 1.3 1998/02/03 21:12:54 perry Exp $ +.\" $NetBSD: undelete.2,v 1.4 1998/08/29 08:32:43 lukem Exp $ .\" .\" Copyright (c) 1994 .\" Jan-Simon Pendry @@ -95,7 +95,7 @@ An I/O error occurred while updating the directory entry. .It Bq Er EROFS The name 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/unlink.2 b/lib/libc/sys/unlink.2 index 5a457983d63..a739966c011 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: unlink.2,v 1.10 1997/07/14 23:20:22 kleink Exp $ +.\" $NetBSD: unlink.2,v 1.11 1998/08/29 08:32:43 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -104,7 +104,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/wait.2 b/lib/libc/sys/wait.2 index a0c061b524a..4ee84345422 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: wait.2,v 1.9 1997/07/14 23:20:23 kleink Exp $ +.\" $NetBSD: wait.2,v 1.10 1998/08/29 08:32:43 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -253,7 +253,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 792ce045b80..e175579d446 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -1,4 +1,4 @@ -.\" $NetBSD: write.2,v 1.11 1998/08/03 15:02:47 kleink Exp $ +.\" $NetBSD: write.2,v 1.12 1998/08/29 08:32:43 lukem Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -55,21 +55,21 @@ .Ft ssize_t .Fn pwritev "int d" "const struct iovec *iov" "int iovcnt" "off_t offset" .Sh DESCRIPTION -.Fn Write +.Fn write attempts to write .Fa nbytes of data to the object referenced by the descriptor .Fa d from the buffer pointed to by .Fa buf . -.Fn Writev +.Fn writev performs the same action, but gathers the output data from the .Fa iovcnt buffers specified by the members of the .Fa iov array: iov[0], iov[1], ..., iov[iovcnt\|-\|1]. -.Fn Pwrite +.Fn pwrite and .Fn pwritev perform the same functions, but write to the specified position in @@ -94,7 +94,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 @@ -136,7 +136,7 @@ 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 , .Fn writev , .Fn pwrite , and @@ -144,7 +144,7 @@ and 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 @@ -188,7 +188,7 @@ and 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 |
