Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

first pass at fixing up capitalization of function names and

Browse Source 
arguments; ensure that each is correct with respect to the
implementation, rather than being correct as per english.
This commit is contained in:
lukem 1998-08-29 08:32:32 +00:00
parent ed88a6f103
commit ce83c69e00
98 changed files with 361 additions and 361 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
lib/libc/compat-43/creat.3
View File

@ -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);

6
lib/libc/compat-43/gethostid.3
View File

@ -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.

8
lib/libc/compat-43/killpg.3
View File

@ -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

4
lib/libc/compat-43/sigblock.3
View File

@ -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

8
lib/libc/compat-43/sigpause.3
View File

@ -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

4
lib/libc/compat-43/sigsetmask.3
View File

@ -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

12
lib/libc/compat-43/sigvec.3
View File

@ -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

6
lib/libc/gen/getdomainname.3
View File

@ -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

6
lib/libc/gen/gethostname.3
View File

@ -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

4
lib/libc/gen/getnetgrent.3
View File

@ -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

4
lib/libc/gen/getpagesize.3
View File

@ -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

4
lib/libc/gen/utime.3
View File

@ -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

4
lib/libc/net/resolver.3
View File

@ -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

24
lib/libc/regex/regex.3
View File

@ -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.

4
lib/libc/stdio/fflush.3
View File

@ -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.

10
lib/libc/stdio/printf.3
View File

@ -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

6
lib/libc/stdio/putc.3
View File

@ -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

4
lib/libc/stdlib/exit.3
View File

@ -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

12
lib/libc/stdlib/qsort.3
View File

@ -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.

6
lib/libc/sys/access.2
View File

@ -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.

6
lib/libc/sys/acct.2
View File

@ -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.

6
lib/libc/sys/adjtime.2
View File

@ -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

10
lib/libc/sys/bind.2
View File

@ -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.

8
lib/libc/sys/chdir.2
View File

@ -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

10
lib/libc/sys/chflags.2
View File

@ -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

10
lib/libc/sys/chroot.2
View File

@ -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.

6
lib/libc/sys/close.2
View File

@ -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.

6
lib/libc/sys/connect.2
View File

@ -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.

8
lib/libc/sys/dup.2
View File

@ -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

8
lib/libc/sys/execve.2
View File

@ -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

14
lib/libc/sys/fcntl.2
View File

@ -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

4
lib/libc/sys/flock.2
View File

@ -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

6
lib/libc/sys/fork.2
View File

@ -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

10
lib/libc/sys/fsync.2
View File

@ -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.

8
lib/libc/sys/getdents.2
View File

@ -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

10
lib/libc/sys/getdirentries.3
View File

@ -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

8
lib/libc/sys/getfh.2
View File

@ -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

10
lib/libc/sys/getfsstat.2
View File

@ -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

4
lib/libc/sys/getgid.2
View File

@ -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

6
lib/libc/sys/getgroups.2
View File

@ -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

6
lib/libc/sys/getitimer.2
View File

@ -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:

4
lib/libc/sys/getlogin.2
View File

@ -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

8
lib/libc/sys/getpid.2
View File

@ -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

10
lib/libc/sys/getpriority.2
View File

@ -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 ,

4
lib/libc/sys/getrlimit.2
View File

@ -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:

6
lib/libc/sys/getrusage.2
View File

@ -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

6
lib/libc/sys/getsockopt.2
View File

@ -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

4
lib/libc/sys/getuid.2
View File

@ -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

6
lib/libc/sys/ioctl.2
View File

@ -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.

12
lib/libc/sys/kill.2
View File

@ -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

4
lib/libc/sys/ktrace.2
View File

@ -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

8
lib/libc/sys/link.2
View File

@ -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

4
lib/libc/sys/listen.2
View File

@ -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

6
lib/libc/sys/lseek.2
View File

@ -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

6
lib/libc/sys/mkdir.2
View File

@ -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

8
lib/libc/sys/mkfifo.2
View File

@ -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

8
lib/libc/sys/mknod.2
View File

@ -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

6
lib/libc/sys/mlock.2
View File

@ -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

10
lib/libc/sys/mmap.2
View File

@ -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

8
lib/libc/sys/mount.2
View File

@ -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

4
lib/libc/sys/munmap.2
View File

@ -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

4
lib/libc/sys/open.2
View File

@ -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

6
lib/libc/sys/pathconf.2
View File

@ -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

8
lib/libc/sys/poll.2
View File

@ -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

12
lib/libc/sys/quotactl.2
View File

@ -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.

18
lib/libc/sys/read.2
View File

@ -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

10
lib/libc/sys/readlink.2
View File

@ -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

8
lib/libc/sys/reboot.2
View File

@ -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

12
lib/libc/sys/recv.2
View File

@ -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

12
lib/libc/sys/rename.2
View File

@ -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

4
lib/libc/sys/revoke.2
View File

@ -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

6
lib/libc/sys/rmdir.2
View File

@ -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

10
lib/libc/sys/send.2
View File

@ -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

4
lib/libc/sys/setgroups.2
View File

@ -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 .

10
lib/libc/sys/setpgid.2
View File

@ -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

12
lib/libc/sys/sigaction.2
View File

@ -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

6
lib/libc/sys/sigaltstack.2
View File

@ -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

8
lib/libc/sys/sigreturn.2
View File

@ -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

4
lib/libc/sys/sigsuspend.2
View File

@ -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,

4
lib/libc/sys/socket.2
View File

@ -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

6
lib/libc/sys/stat.2
View File

@ -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.

22
lib/libc/sys/statfs.2
View File

@ -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

10
lib/libc/sys/swapon.3
View File

@ -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 ,

6
lib/libc/sys/symlink.2
View File

@ -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.

4
lib/libc/sys/sync.2
View File

@ -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

6
lib/libc/sys/sysarch.2
View File

@ -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

4
lib/libc/sys/syscall.2
View File

@ -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

10
lib/libc/sys/truncate.2
View File

@ -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

4
lib/libc/sys/undelete.2
View File

@ -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

4
lib/libc/sys/unlink.2
View File

@ -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

4
lib/libc/sys/wait.2
View File

@ -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

16
lib/libc/sys/write.2
View File

@ -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

4
lib/libcompat/4.3/lsearch.3
View File

@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)lsearch.3 8.1 (Berkeley) 6/4/93
.\" $NetBSD: lsearch.3,v 1.4 1998/02/05 18:51:25 perry Exp $
.\" $NetBSD: lsearch.3,v 1.5 1998/08/29 08:32:43 lukem Exp $
.\"
.Dd June 4, 1993
.Dt LSEARCH 3
@ -58,7 +58,7 @@ and
.Fn lfind
provide basic linear searching functionality.
.Pp
.Fa Base
.Fa base
is the pointer to the beginning of an array.
The argument
.Fa nelp

4
lib/libcurses/PSD.doc/intro.1
View File

@ -1,4 +1,4 @@
.\" $NetBSD: intro.1,v 1.4 1998/01/09 04:12:11 perry Exp $
.\" $NetBSD: intro.1,v 1.5 1998/08/29 08:32:44 lukem Exp $
.\"
.\" Copyright (c) 1980, 1993
.\" The Regents of the University of California. All rights reserved.
@ -138,7 +138,7 @@ the routine
if the window is not
.Vn stdscr )
is called.
.Fn Refresh
.Fn refresh
makes the terminal,
in the area covered by the window,
look like that window.

10
lib/libcurses/PSD.doc/intro.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: intro.3,v 1.4 1998/01/09 04:12:12 perry Exp $
.\" $NetBSD: intro.3,v 1.5 1998/08/29 08:32:44 lukem Exp $
.\"
.\" Copyright (c) 1980, 1993
.\" The Regents of the University of California. All rights reserved.
@ -56,7 +56,7 @@ it can overflow core when attempting to do so.
On this rather rare occasion,
.Fn initscr
returns ERR.
.Fn Initscr
.Fn initscr
must
.bi always
be called before any of the routines which affect windows are used.
@ -91,7 +91,7 @@ Additional windows can be created by using the functions
.Fn newwin
and
.Fn subwin .
.Fn Delwin
.Fn delwin
allows you to delete an exisiting window.
The variables
.Vn LINES
@ -117,14 +117,14 @@ used to change what will go on a window are
.Fn addch
and
.Fn move .
.Fn Addch
.Fn addch
adds a character at the current \*y,
returning ERR if it would cause the window to illegally scroll,
.i i.e. ,
printing a character in the lower right-hand corner
of a terminal which automatically scrolls
if scrolling is not allowed.
.Fn Move
.Fn move
changes the current \*y to whatever you want them to be.
It returns ERR if you try to move off the window.
As mentioned above, you can combine the two into

6
lib/libm/man/lgamma.3
View File

@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)lgamma.3 6.6 (Berkeley) 12/3/92
.\" $NetBSD: lgamma.3,v 1.12 1998/02/05 18:52:10 perry Exp $
.\" $NetBSD: lgamma.3,v 1.13 1998/08/29 08:32:44 lukem Exp $
.\"
.Dd December 3, 1992
.Dt LGAMMA 3
@ -51,7 +51,7 @@
.Ft float
.Fn lgammaf "float x"
.Sh DESCRIPTION
.Fn Lgamma x
.Fn lgamma x
.if t \{\
returns ln\||\(*G(x)| where
.Bd -unfilled -offset indent
@ -81,7 +81,7 @@ Only after
has returned can signgam be correct.
.Pp
.Sh RETURN VALUES
.Fn Lgamma
.Fn lgamma
returns appropriate values unless an argument is out of range.
Overflow will occur for sufficiently large positive values, and
non-positive integers.

4
lib/libutil/getmaxpartitions.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getmaxpartitions.3,v 1.3 1998/02/05 18:52:23 perry Exp $
.\" $NetBSD: getmaxpartitions.3,v 1.4 1998/08/29 08:32:44 lukem Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -47,7 +47,7 @@
.Ft int
.Fn getmaxpartitions void
.Sh DESCRIPTION
.Fn Getmaxpartitions
.Fn getmaxpartitions
returns the number of partitions that are allowed per disk on the
system.
.Sh SEE ALSO

4
lib/libutil/getrawpartition.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: getrawpartition.3,v 1.3 1998/02/05 18:52:24 perry Exp $
.\" $NetBSD: getrawpartition.3,v 1.4 1998/08/29 08:32:44 lukem Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -49,7 +49,7 @@ partition
.Ft int
.Fn getrawpartition void
.Sh DESCRIPTION
.Fn Getrawpartition
.Fn getrawpartition
returns the partition number (
.Sq a
== 0,