diff options
author | dd <dd@FreeBSD.org> | 2001-07-15 07:53:42 +0000 |
---|---|---|
committer | dd <dd@FreeBSD.org> | 2001-07-15 07:53:42 +0000 |
commit | a145482cf625d5f04072fd1d20b5c2062cbe8e47 (patch) | |
tree | d6c008b8ae357e7c4c800baa477713b82a6ee2f2 /lib/libc | |
parent | 0d7bb1fec635c87e914e57048716adc5a87cfe22 (diff) | |
download | FreeBSD-src-a145482cf625d5f04072fd1d20b5c2062cbe8e47.zip FreeBSD-src-a145482cf625d5f04072fd1d20b5c2062cbe8e47.tar.gz |
Remove whitespace at EOL.
Diffstat (limited to 'lib/libc')
205 files changed, 554 insertions, 554 deletions
diff --git a/lib/libc/compat-43/gethostid.3 b/lib/libc/compat-43/gethostid.3 index 837cecf..dcf6250 100644 --- a/lib/libc/compat-43/gethostid.3 +++ b/lib/libc/compat-43/gethostid.3 @@ -72,7 +72,7 @@ The .Fn gethostid and .Fn sethostid -syscalls appeared in +syscalls appeared in .Bx 4.2 and were dropped in .Bx 4.4 . diff --git a/lib/libc/compat-43/setruid.3 b/lib/libc/compat-43/setruid.3 index 7c87821..b90656b 100644 --- a/lib/libc/compat-43/setruid.3 +++ b/lib/libc/compat-43/setruid.3 @@ -76,7 +76,7 @@ The .Fn setruid and .Fn setrgid -syscalls appeared in +syscalls appeared in .Bx 4.2 and were dropped in .Bx 4.4 . diff --git a/lib/libc/compat-43/sigpause.2 b/lib/libc/compat-43/sigpause.2 index 516486e..5333315 100644 --- a/lib/libc/compat-43/sigpause.2 +++ b/lib/libc/compat-43/sigpause.2 @@ -49,7 +49,7 @@ .Xr sigsuspend 2 . .Pp .Fn Sigpause -assigns +assigns .Fa sigmask to the set of masked signals and then waits for a signal to arrive; diff --git a/lib/libc/compat-43/sigsetmask.2 b/lib/libc/compat-43/sigsetmask.2 index 59944d6..305f9d2 100644 --- a/lib/libc/compat-43/sigsetmask.2 +++ b/lib/libc/compat-43/sigsetmask.2 @@ -58,7 +58,7 @@ This interface is made obsolete by: .Fn Sigsetmask sets the current signal mask to the specified .Fa mask . -Signals are blocked from delivery if the corresponding bit in +Signals are blocked from delivery if the corresponding bit in .Fa mask is a 1. .Fn Sigblock diff --git a/lib/libc/compat-43/sigvec.2 b/lib/libc/compat-43/sigvec.2 index 1e45736..eb94904 100644 --- a/lib/libc/compat-43/sigvec.2 +++ b/lib/libc/compat-43/sigvec.2 @@ -58,10 +58,10 @@ This interface is made obsolete by sigaction(2). .Pp The system defines a set of signals that may be delivered to a process. Signal delivery resembles the occurrence of a hardware interrupt: -the signal is blocked from further occurrence, the current process +the signal is blocked from further occurrence, the current process context is saved, and a new one is built. A process may specify a .Em handler -to which a signal is delivered, or specify that a signal is to be +to which a signal is delivered, or specify that a signal is to be .Em blocked or .Em ignored . @@ -78,7 +78,7 @@ Signal routines execute with the signal that caused their invocation .Em blocked , but other signals may yet occur. -A global +A global .Em "signal mask" defines the set of signals currently blocked from delivery to a process. The signal mask for a process is initialized @@ -95,7 +95,7 @@ signals pending for the process. If the signal is not currently .Em blocked by the process then it is delivered to the process. When a signal is delivered, the current state of the process is saved, -a new signal mask is calculated (as described below), +a new signal mask is calculated (as described below), and the signal handler is invoked. The call to the handler is arranged so that if the signal handling routine returns normally the process will resume execution in the context @@ -111,7 +111,7 @@ or .Xr sigsetmask 2 call is made). This mask is formed by taking the current signal mask, -adding the signal to be delivered, and +adding the signal to be delivered, and .Em or Ns 'ing in the signal mask associated with the handler to be invoked. .Pp @@ -129,7 +129,7 @@ the system will deliver the signal to the process on a .Em "signal stack" , specified with .Xr sigaltstack 2 . -If +If .Fa ovec is non-zero, the previous handling information for the signal is returned to the user. @@ -241,7 +241,7 @@ Ignored signals remain ignored; the signal mask remains the same; signals that interrupt system calls continue to do so. .Sh NOTES -The mask specified in +The mask specified in .Fa vec is not allowed to block .Dv SIGKILL @@ -267,7 +267,7 @@ of the following occurs: .It Bq Er EFAULT Either .Fa vec -or +or .Fa ovec points to memory that is not a valid part of the process address space. @@ -309,7 +309,7 @@ struct sigcontext *scp; Here .Fa sig is the signal number, into which the hardware faults and traps are -mapped as defined below. +mapped as defined below. .Fa Code is a parameter that is either a constant as given below or, for compatibility mode faults, the code provided by diff --git a/lib/libc/gen/exec.3 b/lib/libc/gen/exec.3 index e8f6403..6d7e80c 100644 --- a/lib/libc/gen/exec.3 +++ b/lib/libc/gen/exec.3 @@ -145,7 +145,7 @@ The search path is the path specified in the environment by .Dq Ev PATH variable. If this variable isn't specified, -the default path is set according to the +the default path is set according to the .Dv _PATH_DEFPATH definition in .Aq paths.h , diff --git a/lib/libc/gen/getprogname.3 b/lib/libc/gen/getprogname.3 index 7422595..ea9c353 100644 --- a/lib/libc/gen/getprogname.3 +++ b/lib/libc/gen/getprogname.3 @@ -1,7 +1,7 @@ .\" .\" Copyright (c) 2001 Christopher G. Demetriou .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -17,7 +17,7 @@ .\" information about NetBSD. .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3 index efc413c..5c2da21 100644 --- a/lib/libc/gen/glob.3 +++ b/lib/libc/gen/glob.3 @@ -386,7 +386,7 @@ was set or returned non-zero. .It Dv GLOB_LIMIT The flag -.Dv GLOB_MAXPATH +.Dv GLOB_MAXPATH was provided, and the specified limit passed to .Fn glob in diff --git a/lib/libc/gen/sem_destroy.3 b/lib/libc/gen/sem_destroy.3 index 4074adc..0de4691 100644 --- a/lib/libc/gen/sem_destroy.3 +++ b/lib/libc/gen/sem_destroy.3 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd February 15, 2000 .Dt SEM_DESTROY 3 diff --git a/lib/libc/gen/sem_getvalue.3 b/lib/libc/gen/sem_getvalue.3 index e9ac2a6..3ee947a 100644 --- a/lib/libc/gen/sem_getvalue.3 +++ b/lib/libc/gen/sem_getvalue.3 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd February 15, 2000 .Dt SEM_GETVALUE 3 diff --git a/lib/libc/gen/sem_init.3 b/lib/libc/gen/sem_init.3 index a727fe2..5f43c08 100644 --- a/lib/libc/gen/sem_init.3 +++ b/lib/libc/gen/sem_init.3 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd February 15, 2000 .Dt SEM_INIT 3 diff --git a/lib/libc/gen/sem_open.3 b/lib/libc/gen/sem_open.3 index 22229b3..eec5a57 100644 --- a/lib/libc/gen/sem_open.3 +++ b/lib/libc/gen/sem_open.3 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,14 +24,14 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd February 15, 2000 .Dt SEM_OPEN 3 .Os .Sh NAME -.Nm sem_open , -.Nm sem_close , +.Nm sem_open , +.Nm sem_close , .Nm sem_unlink .Nd named semaphore operations .Sh LIBRARY diff --git a/lib/libc/gen/sem_post.3 b/lib/libc/gen/sem_post.3 index 970550d..0c8dea4 100644 --- a/lib/libc/gen/sem_post.3 +++ b/lib/libc/gen/sem_post.3 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd February 15, 2000 .Dt SEM_POST 3 diff --git a/lib/libc/gen/sem_wait.3 b/lib/libc/gen/sem_wait.3 index beff2e3..397cbfe 100644 --- a/lib/libc/gen/sem_wait.3 +++ b/lib/libc/gen/sem_wait.3 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,13 +24,13 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd February 15, 2000 .Dt SEM_WAIT 3 .Os .Sh NAME -.Nm sem_wait , +.Nm sem_wait , .Nm sem_trywait .Nd decrement (lock) a semaphore .Sh LIBRARY diff --git a/lib/libc/gen/setproctitle.3 b/lib/libc/gen/setproctitle.3 index a09d539..96fbc5a 100644 --- a/lib/libc/gen/setproctitle.3 +++ b/lib/libc/gen/setproctitle.3 @@ -101,7 +101,7 @@ source code by .Sh BUGS Never pass a string with user-supplied data as a format without using .Ql %s . -An attacker can put format specifiers in the string to mangle your stack, +An attacker can put format specifiers in the string to mangle your stack, leading to a possible security hole. This holds true even if the string was built using a function like .Fn snprintf , diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 18dd3cb..6852bc0 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -283,7 +283,7 @@ functions appeared in .Sh BUGS Never pass a string with user-supplied data as a format without using .Ql %s . -An attacker can put format specifiers in the string to mangle your stack, +An attacker can put format specifiers in the string to mangle your stack, leading to a possible security hole. This holds true even if the string was built using a function like .Fn snprintf , diff --git a/lib/libc/gmon/moncontrol.3 b/lib/libc/gmon/moncontrol.3 index 1273824..1966d72 100644 --- a/lib/libc/gmon/moncontrol.3 +++ b/lib/libc/gmon/moncontrol.3 @@ -72,7 +72,7 @@ to resume the collection of histogram ticks and call counts use .Fn moncontrol 1 . This feature allows the cost of particular operations to be measured. Note that an output file will be produced on program exit -regardless of the state of +regardless of the state of .Fn moncontrol . .Pp Programs that are not loaded with @@ -88,7 +88,7 @@ the lowest address sampled is that of .Fa lowpc and the highest is just below .Fa highpc . -Only functions in that range that have been compiled with the +Only functions in that range that have been compiled with the .Fl pg option to .Xr cc 1 diff --git a/lib/libc/i386/sys/i386_get_ioperm.2 b/lib/libc/i386/sys/i386_get_ioperm.2 index aad357b..27b38c7 100644 --- a/lib/libc/i386/sys/i386_get_ioperm.2 +++ b/lib/libc/i386/sys/i386_get_ioperm.2 @@ -50,8 +50,8 @@ and the number of contiguous entries will be returned in .Pp .Fn i386_set_ioperm will set access to a range of I/O ports described by the -.Fa start -and +.Fa start +and .Fa length arguments to the state specified by the .Fa enable @@ -73,7 +73,7 @@ and will fail if: .Bl -tag -width Er .It Bq Er EINVAL -An invalid range was specified by the +An invalid range was specified by the .Fa start or .Fa length diff --git a/lib/libc/i386/sys/i386_get_ldt.2 b/lib/libc/i386/sys/i386_get_ldt.2 index c1e9584..5b6070e 100644 --- a/lib/libc/i386/sys/i386_get_ldt.2 +++ b/lib/libc/i386/sys/i386_get_ldt.2 @@ -58,7 +58,7 @@ LDT. Both routines accept a starting selector number .Fa start_sel , an array of memory that -will contain the descriptors to be set or returned +will contain the descriptors to be set or returned .Fa descs , and the number of entries to set or return .Fa num_sels . diff --git a/lib/libc/i386/sys/i386_set_watch.3 b/lib/libc/i386/sys/i386_set_watch.3 index a85ae85..6c49cbe 100644 --- a/lib/libc/i386/sys/i386_set_watch.3 +++ b/lib/libc/i386/sys/i386_set_watch.3 @@ -55,9 +55,9 @@ parameters. The argument specifies which watch register is used, 0, 1, 2, 3, or -1. If .Fa watchnum is -1, a free watch register is found and used. If there are no free -watch registers, an error code of -1 is returned. +watch registers, an error code of -1 is returned. .Fa Watchaddr -specifies the watch address, +specifies the watch address, .Fa size specifies the size in bytes of the area to be watched (1, 2, or 4 bytes), and diff --git a/lib/libc/i386/sys/i386_vm86.2 b/lib/libc/i386/sys/i386_vm86.2 index fd9c89e..3c85ade 100644 --- a/lib/libc/i386/sys/i386_vm86.2 +++ b/lib/libc/i386/sys/i386_vm86.2 @@ -72,7 +72,7 @@ it will be dispatched by the vm86 interrupt table. .\" .It Dv VM86_INTCALL .El .Pp -vm86 mode is entered by calling +vm86 mode is entered by calling .Xr sigreturn 2 with the correct machine context for vm86, and with the .Em PSL_VM diff --git a/lib/libc/locale/euc.4 b/lib/libc/locale/euc.4 index ce319ba..548d9ca 100644 --- a/lib/libc/locale/euc.4 +++ b/lib/libc/locale/euc.4 @@ -42,18 +42,18 @@ .Nm euc .Nd EUC encoding of runes .Sh SYNOPSIS -.Nm ENCODING +.Nm ENCODING .Qq EUC .Pp .Nm VARIABLE -.Ar len1 -.Ar mask1 -.Ar len2 -.Ar mask2 -.Ar len3 -.Ar mask3 -.Ar len4 -.Ar mask4 +.Ar len1 +.Ar mask1 +.Ar len2 +.Ar mask2 +.Ar len3 +.Ar mask3 +.Ar len4 +.Ar mask4 .Ar mask .Sh DESCRIPTION The @@ -85,7 +85,7 @@ A multibyte character in the fourth codeset consists of .Ar len4 bytes starting with the byte 0x8f. .Pp -The +The .Ev rune_t encoding of .Nm EUC diff --git a/lib/libc/locale/euc.5 b/lib/libc/locale/euc.5 index ce319ba..548d9ca 100644 --- a/lib/libc/locale/euc.5 +++ b/lib/libc/locale/euc.5 @@ -42,18 +42,18 @@ .Nm euc .Nd EUC encoding of runes .Sh SYNOPSIS -.Nm ENCODING +.Nm ENCODING .Qq EUC .Pp .Nm VARIABLE -.Ar len1 -.Ar mask1 -.Ar len2 -.Ar mask2 -.Ar len3 -.Ar mask3 -.Ar len4 -.Ar mask4 +.Ar len1 +.Ar mask1 +.Ar len2 +.Ar mask2 +.Ar len3 +.Ar mask3 +.Ar len4 +.Ar mask4 .Ar mask .Sh DESCRIPTION The @@ -85,7 +85,7 @@ A multibyte character in the fourth codeset consists of .Ar len4 bytes starting with the byte 0x8f. .Pp -The +The .Ev rune_t encoding of .Nm EUC diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3 index 4a69ff9..6b239aa 100644 --- a/lib/libc/locale/isalnum.3 +++ b/lib/libc/locale/isalnum.3 @@ -51,7 +51,7 @@ .Sh DESCRIPTION The .Fn isalnum -function tests for any character for which +function tests for any character for which .Xr isalpha 3 or .Xr isdigit 3 diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3 index 80953cd..54d7e206 100644 --- a/lib/libc/locale/isalpha.3 +++ b/lib/libc/locale/isalpha.3 @@ -46,7 +46,7 @@ .Lb libc .Sh SYNOPSIS .Fd #include <ctype.h> -.Ft int +.Ft int .Fn isalpha "int c" .Sh DESCRIPTION The diff --git a/lib/libc/locale/isascii.3 b/lib/libc/locale/isascii.3 index 027f794..0a67f79 100644 --- a/lib/libc/locale/isascii.3 +++ b/lib/libc/locale/isascii.3 @@ -49,7 +49,7 @@ The .Fn isascii function tests for an .Tn ASCII -character, which is any character +character, which is any character between 0 and octal 0177 inclusive. .Sh SEE ALSO .Xr ctype 3 , diff --git a/lib/libc/locale/mbrune.3 b/lib/libc/locale/mbrune.3 index 680b01e..959f839 100644 --- a/lib/libc/locale/mbrune.3 +++ b/lib/libc/locale/mbrune.3 @@ -133,11 +133,11 @@ if the character does not appear in the string. The .Fn mbmb function -returns a pointer to the +returns a pointer to the .Fa pattern , or .Dv NULL -if the +if the .Fa pattern does not appear in the string. .Sh "SEE ALSO diff --git a/lib/libc/locale/multibyte.3 b/lib/libc/locale/multibyte.3 index a78a4a2..52ee84e 100644 --- a/lib/libc/locale/multibyte.3 +++ b/lib/libc/locale/multibyte.3 @@ -164,7 +164,7 @@ the result in .Fa mbchar . The object pointed to by .Fa mbchar -must be large enough to accommodate the multibyte character. +must be large enough to accommodate the multibyte character. .Pp The .Fn mbstowcs diff --git a/lib/libc/locale/rune.3 b/lib/libc/locale/rune.3 index a945274..04bbdc7 100644 --- a/lib/libc/locale/rune.3 +++ b/lib/libc/locale/rune.3 @@ -119,7 +119,7 @@ will point to If there is an encoding error at the start of .Fa string , .Dv _INVALID_RUNE -is returned and +is returned and .Fa *result will point to the second character of .Fa string . @@ -160,7 +160,7 @@ is not .Fa *result will be set to .Dv NULL . -In all cases, +In all cases, .Fn sputrune will return the number of bytes which would be needed to store .Fa rune @@ -170,7 +170,7 @@ The .Fn fgetrune function operates the same as .Fn sgetrune -with the exception that it attempts to read enough bytes from +with the exception that it attempts to read enough bytes from .Fa stream to decode a single rune. It returns either .Dv EOF @@ -185,7 +185,7 @@ function pushes the multibyte encoding, as provided by of .Fa rune onto -.Fa stream +.Fa stream such that the next .Fn fgetrune call will return @@ -242,7 +242,7 @@ as a multibyte string. .Bl -tag -width /usr/share/locale/locale/LC_CTYPE -compact .It Pa $PATH_LOCALE/ Ns Em locale Ns /LC_CTYPE .It Pa /usr/share/locale/ Ns Em locale Ns /LC_CTYPE -binary LC_CTYPE file for the locale +binary LC_CTYPE file for the locale .Em locale . .El .Sh SEE ALSO diff --git a/lib/libc/locale/setlocale.3 b/lib/libc/locale/setlocale.3 index 5c1659a..8f987e6 100644 --- a/lib/libc/locale/setlocale.3 +++ b/lib/libc/locale/setlocale.3 @@ -286,9 +286,9 @@ or .Bl -tag -width /usr/share/locale/locale/category -compact .It Pa $PATH_LOCALE/ Ns Em locale/category .It Pa /usr/share/locale/ Ns Em locale/category -locale file for the locale +locale file for the locale .Em locale -and the category +and the category .Em category . .El .Sh SEE ALSO diff --git a/lib/libc/locale/toupper.3 b/lib/libc/locale/toupper.3 index 337a205..f9734e2 100644 --- a/lib/libc/locale/toupper.3 +++ b/lib/libc/locale/toupper.3 @@ -51,7 +51,7 @@ .Sh DESCRIPTION The .Fn toupper -function converts a lower-case letter to the corresponding +function converts a lower-case letter to the corresponding upper-case letter. For single C .Va char Ns s diff --git a/lib/libc/net/addr2ascii.3 b/lib/libc/net/addr2ascii.3 index ced7349..b9f6fa9 100644 --- a/lib/libc/net/addr2ascii.3 +++ b/lib/libc/net/addr2ascii.3 @@ -12,7 +12,7 @@ .\" no representations about the suitability of this software for any .\" purpose. It is provided "as is" without express or implied .\" warranty. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS .\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF @@ -146,7 +146,7 @@ inet_ntoa(struct in_addr addr) int inet_aton(const char *ascii, struct in_addr *addr) { - return (ascii2addr(AF_INET, ascii, addr) + return (ascii2addr(AF_INET, ascii, addr) == sizeof(*addr)); } .Ed diff --git a/lib/libc/net/byteorder.3 b/lib/libc/net/byteorder.3 index 0785911..cae00a7 100644 --- a/lib/libc/net/byteorder.3 +++ b/lib/libc/net/byteorder.3 @@ -70,7 +70,7 @@ and .Sh HISTORY The .Nm byteorder -functions appeared in +functions appeared in .Bx 4.2 . .Sh BUGS On the diff --git a/lib/libc/net/ethers.3 b/lib/libc/net/ethers.3 index a1dc7a1..6a9ea552 100644 --- a/lib/libc/net/ethers.3 +++ b/lib/libc/net/ethers.3 @@ -115,7 +115,7 @@ and functions map ethernet addresses to their corresponding hostnames as specified in the .Pa /etc/ethers -database. +database. .Fn ether_ntohost converts from ethernet address to hostname, and .Fn ether_hostton @@ -132,7 +132,7 @@ structure and the hostname in the supplied string .Ar h . .Pp -On success, +On success, .Fn ether_ntoa returns a pointer to a string containing an .Tn ASCII diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3 index 0c3772e..7d78f96 100644 --- a/lib/libc/net/gethostbyname.3 +++ b/lib/libc/net/gethostbyname.3 @@ -185,7 +185,7 @@ If the flag is non-zero, this sets the option to send all queries to the name server using .Tn TCP -and to retain the connection after each call to +and to retain the connection after each call to .Fn gethostbyname , .Fn gethostbyname2 or @@ -240,7 +240,7 @@ if ((hp = gethostbyaddr((const char *)&ip, printf("name associated with %s is %s\en", ipstr, hp->h_name); .Ed .Sh DIAGNOSTICS -Error return status from +Error return status from .Fn gethostbyname , .Fn gethostbyname2 and @@ -277,8 +277,8 @@ A retry at some later time may succeed. Some unexpected server failure was encountered. This is a non-recoverable error. .It Dv NO_DATA -The requested name is valid but does not have an IP address; -this is not a temporary error. +The requested name is valid but does not have an IP address; +this is not a temporary error. This means that the name is known to the name server but there is no address associated with this name. Another type of request to the name server using this domain name @@ -335,7 +335,7 @@ closes the file. .Sh HISTORY The .Fn herror -function appeared in +function appeared in .Bx 4.3 . The .Fn endhostent , diff --git a/lib/libc/net/getnetent.3 b/lib/libc/net/getnetent.3 index 92e4970..23e90ae 100644 --- a/lib/libc/net/getnetent.3 +++ b/lib/libc/net/getnetent.3 @@ -66,14 +66,14 @@ functions each return a pointer to an object with the following structure describing an internet network. This structure contains either the information obtained -from the nameserver, +from the nameserver, .Xr named 8 , broken-out fields of a line in the network data base .Pa /etc/networks , or entries supplied by the -.Xr yp 4 +.Xr yp 4 system. The order of the lookups is controlled by the -`networks' entry in +`networks' entry in .Xr nsswitch.conf 5 . .Pp .Bd -literal -offset indent @@ -109,7 +109,7 @@ function opens and rewinds the file. If the .Fa stayopen flag is non-zero, -the net data base will not be closed after each call to +the net data base will not be closed after each call to .Fn getnetbyname or .Fn getnetbyaddr . @@ -159,7 +159,7 @@ The .Fn setnetent , and .Fn endnetent -functions appeared in +functions appeared in .Bx 4.2 . .Sh BUGS The data space used by diff --git a/lib/libc/net/getprotoent.3 b/lib/libc/net/getprotoent.3 index a24d995..d073ac0 100644 --- a/lib/libc/net/getprotoent.3 +++ b/lib/libc/net/getprotoent.3 @@ -98,7 +98,7 @@ function opens and rewinds the file. If the .Fa stayopen flag is non-zero, -the net data base will not be closed after each call to +the net data base will not be closed after each call to .Fn getprotobyname or .Fn getprotobynumber . @@ -139,7 +139,7 @@ The .Fn setprotoent , and .Fn endprotoent -functions appeared in +functions appeared in .Bx 4.2 . .Sh BUGS These functions use a static data space; diff --git a/lib/libc/net/getservent.3 b/lib/libc/net/getservent.3 index e1569d45..5a0258e 100644 --- a/lib/libc/net/getservent.3 +++ b/lib/libc/net/getservent.3 @@ -47,7 +47,7 @@ .Sh SYNOPSIS .Fd #include <netdb.h> .Ft struct servent * -.Fn getservent +.Fn getservent .Ft struct servent * .Fn getservbyname "const char *name" "const char *proto" .Ft struct servent * @@ -102,7 +102,7 @@ function opens and rewinds the file. If the .Fa stayopen flag is non-zero, -the net data base will not be closed after each call to +the net data base will not be closed after each call to .Fn getservbyname or .Fn getservbyport . @@ -126,7 +126,7 @@ or until .Dv EOF is encountered. If a protocol name is also supplied (non- -.Dv NULL ) , +.Dv NULL ) , searches must also match the protocol. .Sh FILES .Bl -tag -width /etc/services -compact @@ -148,7 +148,7 @@ The .Fn setservent , and .Fn endservent -functions appeared in +functions appeared in .Bx 4.2 . .Sh BUGS These functions use static data storage; diff --git a/lib/libc/net/inet.3 b/lib/libc/net/inet.3 index 99e7791..f9ce2c6 100644 --- a/lib/libc/net/inet.3 +++ b/lib/libc/net/inet.3 @@ -53,7 +53,7 @@ .Fd #include <sys/socket.h> .Fd #include <netinet/in.h> .Fd #include <arpa/inet.h> -.Ft int +.Ft int .Fn inet_aton "const char *cp" "struct in_addr *pin" .Ft in_addr_t .Fn inet_addr "const char *cp" @@ -65,7 +65,7 @@ .Fn inet_ntop "int af" "const void *src" "char *dst" "size_t size" .Ft int .Fn inet_pton "int af" "const char *src" "void *dst" -.Ft struct in_addr +.Ft struct in_addr .Fn inet_makeaddr "in_addr_t net" "in_addr_t lna" .Ft in_addr_t .Fn inet_lnaof "struct in_addr in" @@ -248,7 +248,7 @@ This is a narrower input set than that accepted by .Fn inet_aton . .Sh HISTORY These -functions appeared in +functions appeared in .Bx 4.2 . .Sh BUGS The value diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3 index 8236548..c2338fc 100644 --- a/lib/libc/net/inet6_option_space.3 +++ b/lib/libc/net/inet6_option_space.3 @@ -323,7 +323,7 @@ called for a given ancillary data object, .Fa *tptrp must be set to .Dv NULL . -.Pp +.Pp Each time this function returns success, .Fa *tptrp points to the 8-bit @@ -409,7 +409,7 @@ return .Li -1 setting .Fa *tptrp -to non +to non .Dv NULL value. .\" diff --git a/lib/libc/net/iso_addr.3 b/lib/libc/net/iso_addr.3 index 5f825c0..4bc3ed1 100644 --- a/lib/libc/net/iso_addr.3 +++ b/lib/libc/net/iso_addr.3 @@ -63,7 +63,7 @@ addresses and returns .Tn ASCII strings representing NSAPs (network service access points) in a -notation inverse to that accepted by +notation inverse to that accepted by .Fn iso_addr . .Pp Unfortunately, no universal standard exists for representing @@ -101,7 +101,7 @@ The .Fn iso_addr and .Fn iso_ntoa -functions appeared in +functions appeared in .Bx 4.3 Reno . .Sh BUGS The returned values diff --git a/lib/libc/net/linkaddr.3 b/lib/libc/net/linkaddr.3 index 23932cb..7631c4a 100644 --- a/lib/libc/net/linkaddr.3 +++ b/lib/libc/net/linkaddr.3 @@ -116,7 +116,7 @@ The .Fn link_addr and .Fn link_ntoa -functions appeared in +functions appeared in .Bx 4.3 Reno . .Sh BUGS The returned values for link_ntoa diff --git a/lib/libc/net/ns.3 b/lib/libc/net/ns.3 index 4d545e3..e8cc2ec 100644 --- a/lib/libc/net/ns.3 +++ b/lib/libc/net/ns.3 @@ -46,7 +46,7 @@ address conversion routines .Sh SYNOPSIS .Fd #include <sys/types.h> .Fd #include <netns/ns.h> -.Ft struct ns_addr +.Ft struct ns_addr .Fn ns_addr "char *cp" .Ft char * .Fn ns_ntoa "struct ns_addr ns" @@ -70,7 +70,7 @@ notation in common use in the Xerox Development Environment: .Ed .Pp Trailing zero fields are suppressed, and each number is printed in hexadecimal, -in a format suitable for input to +in a format suitable for input to .Fn ns_addr . Any fields lacking super-decimal digits will have a trailing @@ -121,7 +121,7 @@ The .Fn ns_addr and .Fn ns_toa -functions appeared in +functions appeared in .Bx 4.3 . .Sh BUGS The string returned by diff --git a/lib/libc/net/nsdispatch.3 b/lib/libc/net/nsdispatch.3 index 7ed6345..8d7a686 100644 --- a/lib/libc/net/nsdispatch.3 +++ b/lib/libc/net/nsdispatch.3 @@ -57,7 +57,7 @@ .Sh DESCRIPTION The .Fn nsdispatch -function invokes the callback functions specified in +function invokes the callback functions specified in .Va dtab in the order given in .Pa /etc/nsswitch.conf @@ -95,7 +95,7 @@ The last entry in should contain .Dv NULL values for -.Va src , +.Va src , .Va cb , and .Va cb_data . @@ -132,7 +132,7 @@ For each default source type, an entry with set to the name of the source, and .Va flags set to the relevant flags -(usually +(usually .Dv NS_SUCCESS ; refer to .Sx Callback return values @@ -203,9 +203,9 @@ The routines first appeared in .Fx 4.1 . They were imported from the -.Nx +.Nx Project, -where they appeared first in +where they appeared first in .Nx 1.4 . .Sh AUTHORS Luke Mewburn diff --git a/lib/libc/net/rcmd.3 b/lib/libc/net/rcmd.3 index abc6017..08b6e72 100644 --- a/lib/libc/net/rcmd.3 +++ b/lib/libc/net/rcmd.3 @@ -104,7 +104,7 @@ If the connection succeeds, a socket in the Internet domain of type .Dv SOCK_STREAM is returned to the caller, and given to the remote -command as +command as .Em stdin and .Em stdout . @@ -122,10 +122,10 @@ signal numbers, to be forwarded to the process group of the command. If .Fa fd2p -is 0, then the +is 0, then the .Em stderr (unit 2 of the remote -command) will be made the same as the +command) will be made the same as the .Em stdout and no provision is made for sending arbitrary signals to the remote process, @@ -138,7 +138,7 @@ The .Fn rresvport function is used to obtain a socket to which an address with a Privileged Internet port is bound. -This socket is suitable for use by +This socket is suitable for use by .Fn rcmd and several other functions. Privileged Internet ports are those in the range 0 to 1023. @@ -284,7 +284,7 @@ is overloaded to mean ``All network ports in use.'' .Re .Sh HISTORY Most of these -functions appeared in +functions appeared in .Bx 4.2 . .Fn rresvport_af appeared in RFC2292, and was implemented by the WIDE project diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3 index 4870992..2771e9b 100644 --- a/lib/libc/net/resolver.3 +++ b/lib/libc/net/resolver.3 @@ -92,7 +92,7 @@ .Fa "int anslen" .Fc .Ft int -.Fn res_init +.Fn res_init .Ft int .Fo dn_comp .Fa "const char *exp_dn" @@ -418,5 +418,5 @@ see .Sh HISTORY The .Nm -function appeared in +function appeared in .Bx 4.3 . diff --git a/lib/libc/nls/catclose.3 b/lib/libc/nls/catclose.3 index 0fcbfe9..c29b45d 100644 --- a/lib/libc/nls/catclose.3 +++ b/lib/libc/nls/catclose.3 @@ -42,7 +42,7 @@ .Sh DESCRIPTION The .Fn catclose -function closes the message catalog specified by the argument +function closes the message catalog specified by the argument .Fa catd . .Sh RETURN VALUES .Rv -std catclose diff --git a/lib/libc/nls/catgets.3 b/lib/libc/nls/catgets.3 index fda5f36..f566abb 100644 --- a/lib/libc/nls/catgets.3 +++ b/lib/libc/nls/catgets.3 @@ -32,7 +32,7 @@ .Os .Sh NAME .Nm catgets -.Nd retrieve string from message catalog +.Nd retrieve string from message catalog .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -40,20 +40,20 @@ .Ft char * .Fn catgets "nl_catd catd" "int set_id" "int msg_id" "const char *s" .Sh DESCRIPTION -The -.Fn catgets +The +.Fn catgets function attempts to retrieve message .Fa msg_id of set .Fa set_id from the message catalog referenced by the descriptor .Fa catd . -The argument +The argument .Fa s points to a default message which is returned if the function is unable to retrieve the specified message. .Sh RETURN VALUES -If the specified message was retrieved successfully, +If the specified message was retrieved successfully, .Fn catgets returns a pointer to an internal buffer containing the message string; otherwise it returns diff --git a/lib/libc/nls/catopen.3 b/lib/libc/nls/catopen.3 index 68cf893..4c0dccc 100644 --- a/lib/libc/nls/catopen.3 +++ b/lib/libc/nls/catopen.3 @@ -32,7 +32,7 @@ .Os .Sh NAME .Nm catopen -.Nd open message catalog +.Nd open message catalog .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -40,21 +40,21 @@ .Ft nl_catd .Fn catopen "const char *name" "int oflag" .Sh DESCRIPTION -The +The .Fn catopen function opens the message catalog specified by -.Fa name +.Fa name and returns a message catalog descriptor. If .Fa name contains a -.Sq / -then +.Sq / +then .Fa name -specifies the full pathname for the message catalog, otherwise the value +specifies the full pathname for the message catalog, otherwise the value of the environment variable -.Ev NLSPATH -is used with +.Ev NLSPATH +is used with the following substitutions: .Bl -tag -width XXX .It \&%N @@ -86,7 +86,7 @@ environment variable or from the .Dv LC_MESSAGES category. .It \&%% -A single % character. +A single % character. .El .Pp An empty string is substituted for undefined values. @@ -124,11 +124,11 @@ until a successful call to one of the .Xr exec 3 function. .Sh RETURN VALUES -Upon successful completion, +Upon successful completion, .Fn catopen returns a message catalog descriptor. Otherwise, (nl_catd) -1 is returned and -.Va errno +.Va errno is set to indicate the error. .Sh ERRORS .Bl -tag -width Er diff --git a/lib/libc/posix1e/acl.3 b/lib/libc/posix1e/acl.3 index 39822b8..6f74b8b 100644 --- a/lib/libc/posix1e/acl.3 +++ b/lib/libc/posix1e/acl.3 @@ -220,7 +220,7 @@ POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion of the draft continues on the cross-platform POSIX.1e implementation mailing list. To join this list, see the -.Fx +.Fx POSIX.1e implementation page for more information. .Sh HISTORY POSIX.1e support was introduced in diff --git a/lib/libc/posix1e/acl_delete.3 b/lib/libc/posix1e/acl_delete.3 index 2aa3f15..2b21bf9 100644 --- a/lib/libc/posix1e/acl_delete.3 +++ b/lib/libc/posix1e/acl_delete.3 @@ -112,7 +112,7 @@ The file system is read-only. POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion of the draft continues on the cross-platform POSIX.1e implementation mailing list. To join this list, see the -.Fx +.Fx POSIX.1e implementation page for more information. .Sh HISTORY diff --git a/lib/libc/posix1e/acl_from_text.3 b/lib/libc/posix1e/acl_from_text.3 index 578e3f7..13a1f42 100644 --- a/lib/libc/posix1e/acl_from_text.3 +++ b/lib/libc/posix1e/acl_from_text.3 @@ -111,12 +111,12 @@ rely on the library calls to manage username and uid mapping, as well as the .Xr getgrent 3 library calls to manage groupname and gid mapping. These calls are not -thread safe, and so transitively, neither are +thread safe, and so transitively, neither are .Fn acl_from_text and .Fn acl_to_text . These functions may also interfere with stateful -calls associated with the +calls associated with the .Fn getpwent and .Fn getgrent diff --git a/lib/libc/posix1e/acl_get.3 b/lib/libc/posix1e/acl_get.3 index ee8ab54..5121d1a 100644 --- a/lib/libc/posix1e/acl_get.3 +++ b/lib/libc/posix1e/acl_get.3 @@ -51,10 +51,10 @@ The and .Fn acl_get_fd_np each allow the retrieval of an ACL from a file. -.Fn acl_get_file +.Fn acl_get_file is a POSIX.1e call that allows the retrieval of a specified type of ACL from a file by name; -.Fn acl_get_fd +.Fn acl_get_fd is a POSIX.1e call that allows the retrieval of an ACL of type ACL_TYPE_ACCESS from a file descriptor. diff --git a/lib/libc/posix1e/acl_set.3 b/lib/libc/posix1e/acl_set.3 index 12abb92..17a8db0 100644 --- a/lib/libc/posix1e/acl_set.3 +++ b/lib/libc/posix1e/acl_set.3 @@ -53,13 +53,13 @@ and each associate an ACL with an object referred to by .Va fd or -.Va path_p . +.Va path_p . All except .Fn acl_set_fd_np are POSIX.1e calls-- .Fn acl_set_fd allows only the setting of ACLs of type ACL_TYPE_ACCESS -where as +where as .Fn acl_set_fd_np allows the setting of ACLs of any type. .Sh IMPLEMENTATION NOTES diff --git a/lib/libc/posix1e/acl_to_text.3 b/lib/libc/posix1e/acl_to_text.3 index b28fd59..eb990a2 100644 --- a/lib/libc/posix1e/acl_to_text.3 +++ b/lib/libc/posix1e/acl_to_text.3 @@ -39,7 +39,7 @@ .Ft char * .Fn acl_to_text "acl_t acl" "ssize_t *len_p" .Sh DESCRIPTION -The +The .Fn acl_to_text function translates the ACL pointed to by argument .Va acl diff --git a/lib/libc/posix1e/acl_valid.3 b/lib/libc/posix1e/acl_valid.3 index 1418d3c..a395df6 100644 --- a/lib/libc/posix1e/acl_valid.3 +++ b/lib/libc/posix1e/acl_valid.3 @@ -69,7 +69,7 @@ then one ACL_MASK entry shall also be required. The ACL shall contain at most on ACL_MASK entry. .Pp The qualifier field shall be unique among all entries of -the same POSIX.1e ACL facility defined tag type. The +the same POSIX.1e ACL facility defined tag type. The tag type field shall contain valid values including any implementation-defined values. Validation of the values of the qualifier field is implementation-defined. @@ -78,7 +78,7 @@ of the qualifier field is implementation-defined. The POSIX.1e .Fn acl_valid function may reorder the ACL for the purposes of verification; the -non-portable validation functions will not. +non-portable validation functions will not. .Sh IMPLEMENTATION NOTES .Fx Ns 's support for POSIX.1e interfaces and features is still under diff --git a/lib/libc/posix1e/cap.3 b/lib/libc/posix1e/cap.3 index 26d977e..0aa782b 100644 --- a/lib/libc/posix1e/cap.3 +++ b/lib/libc/posix1e/cap.3 @@ -66,7 +66,7 @@ This function is described in .Xr cap_free 3 , and may be used to free a capability structure. .It Fn cap_from_text -This function is described in +This function is described in .Xr cap_from_text 3 , and may be used to convert a text-form capability to its internal representation. @@ -153,7 +153,7 @@ ACLs are available, this capability overrides the ACL execute access restrictions when accessing an object. .It Dv CAP_DAC_WRITE This capability overrides file mode write access restrictions when access an -object, and, if +object, and, if .Xr posix1e 3 ACLs are available, this capability also overrides the ACL write access restrictions when accessing an object. @@ -229,7 +229,7 @@ capability set when invoking .It Dv CAP_SYS_SETFFLAG This capability overrides the restriction that a process cannot manipulate the system file flags on a file system object. -For portability, equivilent to +For portability, equivilent to .Dv CAP_LINUX_IMMUTABLE . .It Dv CAP_NET_BIND_SERVICE This capability overrides network namespace restrictions on process's @@ -267,7 +267,7 @@ configure, or disable system process accounting. .It Dv CAP_SYS_ADMIN .It Dv CAP_SYS_BOOT This capability overrides the restriction that a process cannot invoke -the +the .Xr boot 2 system call. .It Dv CAP_SYS_NICE @@ -323,7 +323,7 @@ use in the short term. POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion of the draft continues on the cross-platform POSIX.1e implementation mailing list. To join this list, see the -.Fx +.Fx POSIX.1e implementation page for more information. .Sh HISTORY diff --git a/lib/libc/posix1e/cap_clear.3 b/lib/libc/posix1e/cap_clear.3 index 97c7958..5f305cb 100644 --- a/lib/libc/posix1e/cap_clear.3 +++ b/lib/libc/posix1e/cap_clear.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_CLEAR 3 diff --git a/lib/libc/posix1e/cap_dup.3 b/lib/libc/posix1e/cap_dup.3 index 0f29656..9ea0396 100644 --- a/lib/libc/posix1e/cap_dup.3 +++ b/lib/libc/posix1e/cap_dup.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_DUP 3 diff --git a/lib/libc/posix1e/cap_free.3 b/lib/libc/posix1e/cap_free.3 index 03a62d4..3f6e192 100644 --- a/lib/libc/posix1e/cap_free.3 +++ b/lib/libc/posix1e/cap_free.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_FREE 3 diff --git a/lib/libc/posix1e/cap_get_flag.3 b/lib/libc/posix1e/cap_get_flag.3 index beb3f6e..1f8ab20 100644 --- a/lib/libc/posix1e/cap_get_flag.3 +++ b/lib/libc/posix1e/cap_get_flag.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_GET_FLAG 3 diff --git a/lib/libc/posix1e/cap_get_proc.3 b/lib/libc/posix1e/cap_get_proc.3 index 67ff185..2ebf5c8 100644 --- a/lib/libc/posix1e/cap_get_proc.3 +++ b/lib/libc/posix1e/cap_get_proc.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_GET_PROC 3 diff --git a/lib/libc/posix1e/cap_init.3 b/lib/libc/posix1e/cap_init.3 index 7705bc5..753ced9 100644 --- a/lib/libc/posix1e/cap_init.3 +++ b/lib/libc/posix1e/cap_init.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_INIT 3 diff --git a/lib/libc/posix1e/cap_set_flag.3 b/lib/libc/posix1e/cap_set_flag.3 index 641439a..ef74d10 100644 --- a/lib/libc/posix1e/cap_set_flag.3 +++ b/lib/libc/posix1e/cap_set_flag.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_SET_FLAG 3 diff --git a/lib/libc/posix1e/cap_set_proc.3 b/lib/libc/posix1e/cap_set_proc.3 index b0b78b8..f3dfae3 100644 --- a/lib/libc/posix1e/cap_set_proc.3 +++ b/lib/libc/posix1e/cap_set_proc.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.\" TrustedBSD Project - support for POSIX.1e process capabilities +.\" TrustedBSD Project - support for POSIX.1e process capabilities .\" .Dd April 1, 2000 .Dt CAP_SET_PROC 3 diff --git a/lib/libc/posix1e/cap_to_text.3 b/lib/libc/posix1e/cap_to_text.3 index 22feeff..ea6b522 100644 --- a/lib/libc/posix1e/cap_to_text.3 +++ b/lib/libc/posix1e/cap_to_text.3 @@ -21,7 +21,7 @@ .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. +.\" SUCH DAMAGE. .\" .\" $FreeBSD$ .\" diff --git a/lib/libc/posix1e/posix1e.3 b/lib/libc/posix1e/posix1e.3 index 05304f8..7c8af19 100644 --- a/lib/libc/posix1e/posix1e.3 +++ b/lib/libc/posix1e/posix1e.3 @@ -56,7 +56,7 @@ Access Control are in the wings, and Information Flow Labels are not on the calendar. .Pp POSIX.1e defines both syntax and semantics for these features, but fairly -substantial changes are required to implement these features in the +substantial changes are required to implement these features in the operating system. As shipped, .Fx 4.0 permits file systems to export diff --git a/lib/libc/regex/re_format.7 b/lib/libc/regex/re_format.7 index b6fb9de..2b6655c 100644 --- a/lib/libc/regex/re_format.7 +++ b/lib/libc/regex/re_format.7 @@ -230,7 +230,7 @@ and stands for the sequence of characters of that collating element. The sequence is a single element of the bracket expression's list. -A bracket expression containing a multi-character collating element +A bracket expression containing a multi-character collating element can thus match more than one character, e.g. if the collating sequence includes a .Ql ch @@ -419,7 +419,7 @@ RE or the beginning of a parenthesized subexpression Finally, there is one new type of atom, a .Em back reference : .Ql \e -followed by a non-zero decimal digit +followed by a non-zero decimal digit .Em d matches the same sequence of characters matched by the diff --git a/lib/libc/rpc/bindresvport.3 b/lib/libc/rpc/bindresvport.3 index bfb011e..e3996ea 100644 --- a/lib/libc/rpc/bindresvport.3 +++ b/lib/libc/rpc/bindresvport.3 @@ -88,7 +88,7 @@ may also fail and set for any of the errors specified for the calls .Xr bind 2 , .Xr getsockopt 2 , -or +or .Xr setsockopt 2 . .Sh SEE ALSO .Xr bind 2 , diff --git a/lib/libc/rpc/getrpcent.3 b/lib/libc/rpc/getrpcent.3 index 6a02ca1..3f03c18 100644 --- a/lib/libc/rpc/getrpcent.3 +++ b/lib/libc/rpc/getrpcent.3 @@ -64,7 +64,7 @@ flag is non-zero, the net data base will not be closed after each call to .Fn getrpcent (either directly, or indirectly through one of -the other +the other .Dq getrpc calls). .Pp @@ -88,7 +88,7 @@ program number is found, or until end-of-file is encountered. .Sh DIAGNOSTICS A .Dv NULL -pointer is returned on +pointer is returned on .Dv EOF or error. .Sh BUGS diff --git a/lib/libc/rpc/rpc_clnt_auth.3 b/lib/libc/rpc/rpc_clnt_auth.3 index 89feb76..43af256 100644 --- a/lib/libc/rpc/rpc_clnt_auth.3 +++ b/lib/libc/rpc/rpc_clnt_auth.3 @@ -55,7 +55,7 @@ style of authentication is discussed here. .Bl -tag -width authsys_create_default() .It Fn auth_destroy A function macro that destroys the authentication -information associated with +information associated with .Fa auth . Destruction usually involves deallocation of private data structures. diff --git a/lib/libc/rpc/rpc_clnt_calls.3 b/lib/libc/rpc/rpc_clnt_calls.3 index 55beca5..134e083 100644 --- a/lib/libc/rpc/rpc_clnt_calls.3 +++ b/lib/libc/rpc/rpc_clnt_calls.3 @@ -279,7 +279,7 @@ is the address of where to place the result(s). .Fa nettype can be any of the values listed on .Xr rpc 3 . -This routine returns +This routine returns .Dv RPC_SUCCESS if it succeeds, or an appropriate status is returned. diff --git a/lib/libc/stdio/fgets.3 b/lib/libc/stdio/fgets.3 index c84d6bd..427b88e 100644 --- a/lib/libc/stdio/fgets.3 +++ b/lib/libc/stdio/fgets.3 @@ -85,11 +85,11 @@ if any, is sufficiently short to fit in the string. .Sh RETURN VALUES Upon successful completion, .Fn fgets -and +and .Fn gets return a pointer to the string. -If end-of-file occurs before any characters are read, +If end-of-file occurs before any characters are read, they return .Dv NULL and the buffer contents is unchanged. diff --git a/lib/libc/stdio/fseek.3 b/lib/libc/stdio/fseek.3 index f12e047..9a58668 100644 --- a/lib/libc/stdio/fseek.3 +++ b/lib/libc/stdio/fseek.3 @@ -77,7 +77,7 @@ The new position, measured in bytes, is obtained by adding .Fa offset bytes to the position specified by .Fa whence . -If +If .Fa whence is set to .Dv SEEK_SET , @@ -143,7 +143,7 @@ and (with whence set to .Dv SEEK_SET ) , setting and storing the current value of -the file offset into or from the object referenced by +the file offset into or from the object referenced by .Fa pos . On some .Pq non- Ns Tn UNIX @@ -180,7 +180,7 @@ is not a seekable stream. .It Bq Er EINVAL The .Fa whence -argument to +argument to .Fn fseek was not .Dv SEEK_SET , @@ -188,7 +188,7 @@ was not or .Dv SEEK_CUR . .It Bq Er EOVERFLOW -For +For .Fn ftell , the resulting file offset would be a value which cannot be represented correctly in an object of type long. @@ -208,7 +208,7 @@ for any of the errors specified for the routines .Xr fflush 3 , .Xr fstat 2 , .Xr lseek 2 , -and +and .Xr malloc 3 . .Sh SEE ALSO .Xr lseek 2 @@ -225,7 +225,7 @@ conform to .St -isoC . .Pp The -.Fn fseeko +.Fn fseeko and .Fn ftello functions conform to diff --git a/lib/libc/stdio/funopen.3 b/lib/libc/stdio/funopen.3 index b035514..e1d0040 100644 --- a/lib/libc/stdio/funopen.3 +++ b/lib/libc/stdio/funopen.3 @@ -58,7 +58,7 @@ The function associates a stream with up to four .Dq Tn I/O No functions . -Either +Either .Fa readfn or .Fa writefn @@ -73,7 +73,7 @@ close the new stream. .Pp In general, omitting a function means that any attempt to perform the associated operation on the resulting stream will fail. -If the close function is omitted, closing the stream will flush +If the close function is omitted, closing the stream will flush any buffered output and then succeed. .Pp The calling conventions of @@ -90,7 +90,7 @@ and .Xr close 2 with the single exception that they are passed the .Fa cookie -argument specified to +argument specified to .Fn funopen in place of the traditional file descriptor argument. .Pp @@ -112,7 +112,7 @@ Additionally, all of the functions should set the external variable .Va errno appropriately if an error occurs. .Pp -An error on +An error on .Fn closefn does not keep the stream open. .Pp @@ -126,7 +126,7 @@ as calls to .Fn funopen with only a read or write function specified. .Sh RETURN VALUES -Upon successful completion, +Upon successful completion, .Fn funopen returns a .Dv FILE diff --git a/lib/libc/stdio/getc.3 b/lib/libc/stdio/getc.3 index bd099ab..db69606 100644 --- a/lib/libc/stdio/getc.3 +++ b/lib/libc/stdio/getc.3 @@ -54,7 +54,7 @@ .Ft int .Fn getc "FILE *stream" .Ft int -.Fn getchar +.Fn getchar .Ft int .Fn getw "FILE *stream" .Sh DESCRIPTION diff --git a/lib/libc/stdio/mktemp.3 b/lib/libc/stdio/mktemp.3 index 1f79e4f..27fc969 100644 --- a/lib/libc/stdio/mktemp.3 +++ b/lib/libc/stdio/mktemp.3 @@ -166,25 +166,25 @@ to any value specified by the function. .Sh NOTES A common problem that results in a core dump is that the programmer -passes in a read-only string to +passes in a read-only string to .Fn mktemp , .Fn mkstemp , .Fn mkstemps or .Fn mkdtemp . -This is common with programs that were developed before +This is common with programs that were developed before .St -isoC compilers were common. For example, calling .Fn mkstemp -with an argument of +with an argument of .Qq /tmp/tempfile.XXXXXX -will result in a core dump due to +will result in a core dump due to .Fn mkstemp attempting to modify the string constant that was given. If the program in question makes heavy use of that type of function call, you do have the option of compiling the program -so that it will store string constants in a writable segment of memory. +so that it will store string constants in a writable segment of memory. See .Xr gcc 1 for more information. @@ -196,7 +196,7 @@ are used to increase the number of possible temporary filenames. This makes the race in .Fn mktemp , -between testing for a file's existence (in the +between testing for a file's existence (in the .Fn mktemp function call) and opening it for use @@ -232,13 +232,13 @@ The .Fn mkstemp function appeared in .Bx 4.4 . -The +The .Fn mkdtemp function first appeared in .Ox 2.2 , and later in .Fx 3.2 . -The +The .Fn mkstemps function first appeared in .Ox 2.4 , diff --git a/lib/libc/stdio/remove.3 b/lib/libc/stdio/remove.3 index 6627afa..a79219f 100644 --- a/lib/libc/stdio/remove.3 +++ b/lib/libc/stdio/remove.3 @@ -63,7 +63,7 @@ is the equivalent of Otherwise, it is the equivalent of .Fn unlink "path" . .Sh RETURN VALUES -Upon successful completion, +Upon successful completion, .Fn remove returns 0. Otherwise, \-1 is returned and the global variable diff --git a/lib/libc/stdio/setbuf.3 b/lib/libc/stdio/setbuf.3 index 28451580..d2b2056 100644 --- a/lib/libc/stdio/setbuf.3 +++ b/lib/libc/stdio/setbuf.3 @@ -69,7 +69,7 @@ output or input is read from any stream attached to a terminal device The function .Xr fflush 3 may be used to force the block out early. -(See +(See .Xr fclose 3 . ) .Pp Normally all files are block buffered. @@ -108,7 +108,7 @@ The parameter may be given as zero to obtain deferred optimal-size buffer allocation as usual. If it is not zero, -then except for unbuffered files, the +then except for unbuffered files, the .Fa buf argument should point to a buffer at least .Fa size @@ -135,7 +135,7 @@ but may have peculiar side effects (such as discarding input or flushing output) if the stream is ``active''. Portable applications should call it only once on any given stream, -and before any +and before any .Tn I/O is performed. .Pp diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3 index c7dc30d..f91e2f7 100644 --- a/lib/libc/stdio/stdio.3 +++ b/lib/libc/stdio/stdio.3 @@ -117,10 +117,10 @@ At program startup, three streams are predefined and need not be opened explicitly: .Bl -bullet -compact -offset indent .It -.Em standard input +.Em standard input (for reading conventional input), .It -.Em standard output +.Em standard output (for writing conventional output), and .It .Em standard error diff --git a/lib/libc/stdio/tmpnam.3 b/lib/libc/stdio/tmpnam.3 index 0c4e861..9a9d037 100644 --- a/lib/libc/stdio/tmpnam.3 +++ b/lib/libc/stdio/tmpnam.3 @@ -96,7 +96,7 @@ In either case, .Fn tmpnam returns a pointer to the file name. .Pp -The buffer referenced by +The buffer referenced by .Fa str is expected to be at least .Dv L_tmpnam diff --git a/lib/libc/stdlib/alloca.3 b/lib/libc/stdlib/alloca.3 index d7b48a0..db0ea46 100644 --- a/lib/libc/stdlib/alloca.3 +++ b/lib/libc/stdlib/alloca.3 @@ -48,7 +48,7 @@ The .Fn alloca function -allocates +allocates .Fa size bytes of space in the stack frame of the caller. This temporary space is automatically freed on @@ -76,6 +76,6 @@ is machine dependent; its use is discouraged. .\" .Fn alloca .\" function appeared in .\" .Bx ?? . -.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd +.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd .\" The first man page (or link to a man page that I can find at the .\" moment is 4.3... diff --git a/lib/libc/stdlib/bsearch.3 b/lib/libc/stdlib/bsearch.3 index 8100796..a148f5e 100644 --- a/lib/libc/stdlib/bsearch.3 +++ b/lib/libc/stdlib/bsearch.3 @@ -53,12 +53,12 @@ The .Fn bsearch function searches an array of .Fa nmemb -objects, the initial member of which is +objects, the initial member of which is pointed to by .Fa base , for a member that matches the object pointed to by .Fa key . -The size of each member of the array is specified by +The size of each member of the array is specified by .Fa size . .Pp The contents of the array should be in ascending sorted order according diff --git a/lib/libc/stdlib/exit.3 b/lib/libc/stdlib/exit.3 index 4b6dd78..663eea6 100644 --- a/lib/libc/stdlib/exit.3 +++ b/lib/libc/stdlib/exit.3 @@ -72,7 +72,7 @@ function. Passing arbitrary values back to the environment as .Ar status is considered bad style; -you should use the values +you should use the values .Dv EXIT_SUCCESS and .Dv EXIT_FAILURE . diff --git a/lib/libc/stdlib/getenv.3 b/lib/libc/stdlib/getenv.3 index e639b52..a0feb2b 100644 --- a/lib/libc/stdlib/getenv.3 +++ b/lib/libc/stdlib/getenv.3 @@ -66,7 +66,7 @@ the given arguments .Ar name and .Ar value -may be appended and prepended, +may be appended and prepended, respectively, with an equal sign .Dq Li \&= . diff --git a/lib/libc/stdlib/getopt.3 b/lib/libc/stdlib/getopt.3 index 70857b9..bf1549f 100644 --- a/lib/libc/stdlib/getopt.3 +++ b/lib/libc/stdlib/getopt.3 @@ -124,7 +124,7 @@ The .Fn getopt function returns \-1 -when the argument list is exhausted, or +when the argument list is exhausted, or .Ql ?\& if a non-recognized option is encountered. @@ -152,8 +152,8 @@ Setting .Va opterr to a zero will disable these error messages. If -.Va optstring -has a leading +.Va optstring +has a leading .Ql \&: then a missing option argument causes a .Ql \&: @@ -202,13 +202,13 @@ function appeared in The .Fn getopt function was once specified to return -.Dv EOF +.Dv EOF instead of \-1. This was changed by .St -p1003.2-92 -to decouple +to decouple .Fn getopt -from +from .Pa <stdio.h> . .Pp A single dash diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3 index f49604d..67e84e9 100644 --- a/lib/libc/stdlib/malloc.3 +++ b/lib/libc/stdlib/malloc.3 @@ -156,7 +156,7 @@ The ``name'' of the file referenced by the symbolic link named the value of the environment variable .Ev MALLOC_OPTIONS , and the string pointed to by the global variable -.Va _malloc_options +.Va _malloc_options will be interpreted, in that order, character by character as flags. .Pp Most flags are single letters, @@ -209,7 +209,7 @@ Attempting to allocate zero bytes will return a .Dv NULL pointer instead of a valid pointer. -(The default behavior is to make a minimal allocation and return a +(The default behavior is to make a minimal allocation and return a pointer to it.) This option is provided for System V compatibility. This option is incompatible with the @@ -247,7 +247,7 @@ The and .Dq Z options are intended for testing and debugging. -An application which changes its behavior when these options are used +An application which changes its behavior when these options are used is flawed. .Sh EXAMPLES To set a systemwide reduction of cache size, and to dump core whenever @@ -324,8 +324,8 @@ done by a process. .Ed .Pp A side effect of this architecture is that many minor transgressions on -the interface which would traditionally not be detected are in fact -detected. As a result, programs that have been running happily for +the interface which would traditionally not be detected are in fact +detected. As a result, programs that have been running happily for years may suddenly start to complain loudly, when linked with this allocation implementation. .Pp @@ -365,7 +365,7 @@ There are a number of allocation implementations available on the 'Net which focus on detecting and pinpointing problems by trading performance for extra sanity checks and detailed diagnostics. .Sh DIAGNOSTIC MESSAGES -If +If .Fn malloc , .Fn calloc , .Fn realloc @@ -461,8 +461,8 @@ functions conform to .St -isoC . .Sh HISTORY The present allocation implementation started out as a filesystem for a -drum attached to a 20bit binary challenged computer which was built -with discrete germanium transistors. It has since graduated to +drum attached to a 20bit binary challenged computer which was built +with discrete germanium transistors. It has since graduated to handle primary storage rather than secondary. It first appeared in its new shape and ability in .Fx 2.2 . diff --git a/lib/libc/stdlib/qsort.3 b/lib/libc/stdlib/qsort.3 index 7c09dac..da4df56 100644 --- a/lib/libc/stdlib/qsort.3 +++ b/lib/libc/stdlib/qsort.3 @@ -134,7 +134,7 @@ The function .Fn mergesort requires additional memory of size .Fa nmemb * -.Fa size +.Fa size bytes; it should be used only when space is not at a premium. .Fn Mergesort is optimized for data with pre-existing order; its worst case diff --git a/lib/libc/stdlib/radixsort.3 b/lib/libc/stdlib/radixsort.3 index 7ce7156..90a52c6 100644 --- a/lib/libc/stdlib/radixsort.3 +++ b/lib/libc/stdlib/radixsort.3 @@ -66,7 +66,7 @@ Applications may specify a sort order by providing the .Fa table argument. If -.Pf non- Dv NULL , +.Pf non- Dv NULL , .Fa table must reference an array of .Dv UCHAR_MAX @@ -109,7 +109,7 @@ particular, see D.E. Knuth's Algorithm R and section 5.2.5, exercise 10. They take linear time relative to the number of bytes in the strings. .Sh RETURN VALUES Upon successful completion 0 is returned. -Otherwise, \-1 is returned and the global variable +Otherwise, \-1 is returned and the global variable .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/stdlib/rand.3 b/lib/libc/stdlib/rand.3 index 6db19d5..d9c7b54 100644 --- a/lib/libc/stdlib/rand.3 +++ b/lib/libc/stdlib/rand.3 @@ -82,7 +82,7 @@ These sequences are repeatable by calling with the same seed value. .Pp If no -.Fa seed +.Fa seed value is provided, the functions are automatically seeded with a value of 1. .Pp diff --git a/lib/libc/stdlib/random.3 b/lib/libc/stdlib/random.3 index a17c1b7..4121c83 100644 --- a/lib/libc/stdlib/random.3 +++ b/lib/libc/stdlib/random.3 @@ -46,7 +46,7 @@ .Lb libc .Sh SYNOPSIS .Fd #include <stdlib.h> -.Ft long +.Ft long .Fn random void .Ft void .Fn srandom "unsigned long seed" @@ -70,7 +70,7 @@ The period of this random number generator is very large, approximately .if n 16*((2**31)\(mi1). .Pp The -.Fn random +.Fn random and .Fn srandom functions have (almost) the same calling sequence and initialization properties as the @@ -94,7 +94,7 @@ Like will by default produce a sequence of numbers that can be duplicated by calling .Fn srandom -with +with .Ql 1 as the seed. .Pp @@ -179,7 +179,7 @@ messages are printed on the standard error output. .Xr random 4 .Sh HISTORY These -functions appeared in +functions appeared in .Bx 4.2 . .Sh BUGS About 2/3 the speed of diff --git a/lib/libc/stdlib/realpath.3 b/lib/libc/stdlib/realpath.3 index 9e50e7d..5176770 100644 --- a/lib/libc/stdlib/realpath.3 +++ b/lib/libc/stdlib/realpath.3 @@ -70,7 +70,7 @@ refer to a buffer capable of storing at least .Dv MAXPATHLEN characters. .Pp -The +The .Fn realpath function will resolve both absolute and relative paths and return the absolute pathname corresponding to diff --git a/lib/libc/stdlib/strtod.3 b/lib/libc/stdlib/strtod.3 index d0d335c..6b65e21 100644 --- a/lib/libc/stdlib/strtod.3 +++ b/lib/libc/stdlib/strtod.3 @@ -53,7 +53,7 @@ string to double .Sh DESCRIPTION The .Fn strtod -function converts the initial portion of the string +function converts the initial portion of the string pointed to by .Fa nptr to @@ -99,7 +99,7 @@ is stored in If the correct value would cause underflow, zero is returned and .Er ERANGE -is stored in +is stored in .Va errno . .Sh ERRORS .Bl -tag -width Er diff --git a/lib/libc/stdlib/system.3 b/lib/libc/stdlib/system.3 index ef9b06f..d0afe05 100644 --- a/lib/libc/stdlib/system.3 +++ b/lib/libc/stdlib/system.3 @@ -80,9 +80,9 @@ The function returns the exit status of the shell as returned by .Xr waitpid 2 , -or \-1 if an error occurred when invoking +or \-1 if an error occurred when invoking .Xr fork 2 -or +or .Xr waitpid 2 . A return value of 127 means the execution of the shell failed. diff --git a/lib/libc/stdlib/tsearch.3 b/lib/libc/stdlib/tsearch.3 index b6d66f8..7f17434 100644 --- a/lib/libc/stdlib/tsearch.3 +++ b/lib/libc/stdlib/tsearch.3 @@ -24,7 +24,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" OpenBSD: tsearch.3,v 1.2 1998/06/21 22:13:49 millert Exp +.\" OpenBSD: tsearch.3,v 1.2 1998/06/21 22:13:49 millert Exp .\" $FreeBSD$ .\" .Dd June 15, 1997 @@ -91,7 +91,7 @@ and calls the function on each node. .Fa Action is called with three arguments: a pointer to the current node, -a value from the enum +a value from the enum .Sy "typedef enum { preorder, postorder, endorder, leaf } VISIT;" specifying the traversal type, and a node level (where level zero is the root of the tree). diff --git a/lib/libc/stdtime/ctime.3 b/lib/libc/stdtime/ctime.3 index e3de91b..b3d53ef 100644 --- a/lib/libc/stdtime/ctime.3 +++ b/lib/libc/stdtime/ctime.3 @@ -148,9 +148,9 @@ except the caller must provide the output buffer to store the result, which must be at least 26 characters long. .Fn localtime_r and -.Fn gmtime_r -provide the same functionality as -.Fn localtime +.Fn gmtime_r +provide the same functionality as +.Fn localtime and .Fn gmtime respectively, except the caller must provide the output buffer @@ -253,7 +253,7 @@ returns the difference between two calendar times, .Fa time0 ) , expressed in seconds. .Pp -External declarations as well as the tm structure definition are in the +External declarations as well as the tm structure definition are in the .Aq Pa time.h include file. The tm structure includes at least the following fields: @@ -328,7 +328,7 @@ the time package contributed to Berkeley by and which appeared in .Bx 4.3 . .Sh BUGS -Except for +Except for .Fn difftime , .Fn mktime , and the diff --git a/lib/libc/stdtime/strptime.3 b/lib/libc/stdtime/strptime.3 index cda46cf..b69cbee 100644 --- a/lib/libc/stdtime/strptime.3 +++ b/lib/libc/stdtime/strptime.3 @@ -62,7 +62,7 @@ All conversion specifications are identical to those described in .Pp Two-digit year values, including formats .Fa %y -and +and .Fa \&%D , are now interpreted as beginning at 1969 per POSIX requirements. Years 69-00 are interpreted in the 20th century (1969-2000), years diff --git a/lib/libc/string/bcmp.3 b/lib/libc/string/bcmp.3 index 0e743a0..8d06b8b 100644 --- a/lib/libc/string/bcmp.3 +++ b/lib/libc/string/bcmp.3 @@ -70,5 +70,5 @@ The strings may overlap. .Sh HISTORY A .Fn bcmp -function first appeared in +function first appeared in .Bx 4.2 . diff --git a/lib/libc/string/bcopy.3 b/lib/libc/string/bcopy.3 index 7f3fa47..095ae05 100644 --- a/lib/libc/string/bcopy.3 +++ b/lib/libc/string/bcopy.3 @@ -70,5 +70,5 @@ is zero, no bytes are copied. .Sh HISTORY A .Fn bcopy -function appeared in +function appeared in .Bx 4.2 . diff --git a/lib/libc/string/bzero.3 b/lib/libc/string/bzero.3 index 1f4fbc5..73d3428 100644 --- a/lib/libc/string/bzero.3 +++ b/lib/libc/string/bzero.3 @@ -67,5 +67,5 @@ does nothing. A .Fn bzero function -appeared in +appeared in .Bx 4.3 . diff --git a/lib/libc/string/index.3 b/lib/libc/string/index.3 index 1ec56e6..d023658 100644 --- a/lib/libc/string/index.3 +++ b/lib/libc/string/index.3 @@ -79,5 +79,5 @@ locates the terminating '\e0'. .Sh HISTORY A .Fn index -function appeared in +function appeared in .At v6 . diff --git a/lib/libc/string/rindex.3 b/lib/libc/string/rindex.3 index 0f9919c..e6c019f 100644 --- a/lib/libc/string/rindex.3 +++ b/lib/libc/string/rindex.3 @@ -81,5 +81,5 @@ locates the terminating .Sh HISTORY A .Fn rindex -function appeared in +function appeared in .At v6 . diff --git a/lib/libc/string/strlcpy.3 b/lib/libc/string/strlcpy.3 index c26a6f3..f22c897 100644 --- a/lib/libc/string/strlcpy.3 +++ b/lib/libc/string/strlcpy.3 @@ -66,7 +66,7 @@ as long as there is at least one byte free in Note that you should include a byte for the NUL in .Fa size . Also note that -.Fn strlcpy +.Fn strlcpy and .Fn strlcat only operate on true diff --git a/lib/libc/string/strtok.3 b/lib/libc/string/strtok.3 index 77837d2..6ad05cc 100644 --- a/lib/libc/string/strtok.3 +++ b/lib/libc/string/strtok.3 @@ -16,12 +16,12 @@ .\" .\" 1. Redistributions of source code must retain the above copyright .\" notices, this list of conditions and the following disclaimer. -.\" +.\" .\" 2. Redistributions in binary form must reproduce the above .\" copyright notices, this list of conditions and the following .\" disclaimer in the documentation and/or other materials provided .\" with the distribution. -.\" +.\" .\" 3. All advertising materials mentioning features or use of this .\" software must display the following acknowledgement: .\" @@ -113,7 +113,7 @@ character. When no more tokens remain, a null pointer is returned. .Sh EXAMPLES The following uses -.Fn strtok_r +.Fn strtok_r to parse two strings using separate contexts: .Bd -literal char test[80], blah[80]; @@ -169,6 +169,6 @@ such a sequence of calls would always return Softweyr LLC: .Aq wes@softweyr.com .Pp -Based on the +Based on the .Fx 3.0 implementation. diff --git a/lib/libc/sys/_exit.2 b/lib/libc/sys/_exit.2 index 50096e6..efeb4e8 100644 --- a/lib/libc/sys/_exit.2 +++ b/lib/libc/sys/_exit.2 @@ -113,7 +113,7 @@ can never return. .Sh STANDARDS The .Fn _exit -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY An diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2 index e37d069..6a11a00 100644 --- a/lib/libc/sys/access.2 +++ b/lib/libc/sys/access.2 @@ -124,7 +124,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn access -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh CAVEAT .Fn Access diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2 index 7b1c6c2..ed41171 100644 --- a/lib/libc/sys/acct.2 +++ b/lib/libc/sys/acct.2 @@ -56,7 +56,7 @@ If .Fa file is an .Em existing -pathname (null-terminated), record collection is enabled and for +pathname (null-terminated), record collection is enabled and for every process initiated which terminates under normal conditions an accounting record is appended to .Fa file . diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2 index a6ddd8c..359b7ac 100644 --- a/lib/libc/sys/adjtime.2 +++ b/lib/libc/sys/adjtime.2 @@ -80,7 +80,7 @@ of computers in a local area network. Such time servers would slow down the clocks of some machines and speed up the clocks of others to bring them to the average network time. .Pp -The call +The call .Fn adjtime is restricted to the super-user. .Sh RETURN VALUES diff --git a/lib/libc/sys/aio_error.2 b/lib/libc/sys/aio_error.2 index e27c973..af5cade 100644 --- a/lib/libc/sys/aio_error.2 +++ b/lib/libc/sys/aio_error.2 @@ -46,7 +46,7 @@ associated with the structure pointed to by If the asynchronous I/O request has completed successfully, .Fn aio_error returns 0. If the request has not yet completed, -.Er EINPROGRESS +.Er EINPROGRESS is returned. If the request has completed unsuccessfully the error status is returned as described in .Xr read 2 , diff --git a/lib/libc/sys/aio_read.2 b/lib/libc/sys/aio_read.2 index 5dac793..839805e 100644 --- a/lib/libc/sys/aio_read.2 +++ b/lib/libc/sys/aio_read.2 @@ -48,7 +48,7 @@ beginning at the offset .Fa iocb->aio_offset into the buffer pointed to by .Fa iocb->aio_buf . -The call returns immediately after the read request has +The call returns immediately after the read request has been enqueued to the descriptor; the read may or may not have completed at the time the call returns. .Pp @@ -90,7 +90,7 @@ for these objects is discouraged. .Pp The asynchronous I/O control buffer .Fa iocb -should be zeroed before the +should be zeroed before the .Fn aio_read call to avoid passing bogus context information to the kernel. .Pp @@ -195,6 +195,6 @@ This manual page was written by .An Terry Lambert Aq terry@whistle.com . .Sh BUGS -Invalid information in +Invalid information in .Fa iocb->_aiocb_private may confuse the kernel. diff --git a/lib/libc/sys/aio_return.2 b/lib/libc/sys/aio_return.2 index 3477288..64bc8c9 100644 --- a/lib/libc/sys/aio_return.2 +++ b/lib/libc/sys/aio_return.2 @@ -45,7 +45,7 @@ associated with the structure pointed to by .Pp .Fn aio_return should only be called once, to obtain the final status of an asynchronous -I/O operation once +I/O operation once .Xr aio_error 2 returns something other than .Er EINPROGRESS . @@ -59,7 +59,7 @@ or On failure, .Fn aio_return returns -.Dv -1 +.Dv -1 and sets .Dv errno to indicate the error condition. diff --git a/lib/libc/sys/aio_suspend.2 b/lib/libc/sys/aio_suspend.2 index 333ad82..d59cb8d 100644 --- a/lib/libc/sys/aio_suspend.2 +++ b/lib/libc/sys/aio_suspend.2 @@ -46,7 +46,7 @@ delivered, or the has passed. .Pp .Fa iocbs -is an array of +is an array of .Fa niocb pointers to asynchronous I/O requests. Array members containing NULL will be silently ignored. @@ -79,7 +79,7 @@ The function will fail if: .Bl -tag -width Er .It Bq Er EAGAIN -the +the .Fa timeout expired before any I/O requests completed. .It Bq Er EINVAL diff --git a/lib/libc/sys/aio_write.2 b/lib/libc/sys/aio_write.2 index f099d43..8215720 100644 --- a/lib/libc/sys/aio_write.2 +++ b/lib/libc/sys/aio_write.2 @@ -51,9 +51,9 @@ the call returns. If the request could not be enqueued, generally due to invalid arguments, the call returns without having enqueued the request. .Pp -If -.Dv O_APPEND -is set for +If +.Dv O_APPEND +is set for .Fa iocb->aio_fildes , .Fn aio_write operations append to the file in the same order as the calls were @@ -64,7 +64,7 @@ the absolute position from the beginning of the file plus .Fa iocb->aio_offset . .Pp If -.Dv _POSIX_PRIORITIZED_IO +.Dv _POSIX_PRIORITIZED_IO is defined, and the descriptor supports it, then the enqueued operation is submitted at a priority equal to that of the calling process minus @@ -91,7 +91,7 @@ and the buffer that the member of that structure references must remain valid until the operation has completed. For this reason, use of auto (stack) variables for these objects is discouraged. -.Pp +.Pp The asynchronous I/O control buffer .Fa iocb should be zeroed before the diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index ac8337e..56ab9a5 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -48,7 +48,7 @@ .Sh DESCRIPTION .Fn Bind assigns the local protocol address to a socket. -When a socket is created +When a socket is created with .Xr socket 2 it exists in an address family space but has no protocol address assigned. @@ -96,7 +96,7 @@ The call will fail if: .Bl -tag -width Er .It Bq Er EAGAIN -Kernel resources to complete the request are +Kernel resources to complete the request are temporarily unavilable. .It Bq Er EBADF .Fa S diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2 index 97b2915..50c8196 100644 --- a/lib/libc/sys/brk.2 +++ b/lib/libc/sys/brk.2 @@ -85,7 +85,7 @@ increased to the next page boundary. .\" .Pp The current value of the program break is reliably returned by .Dq Li sbrk(0) -(see also +(see also .Xr end 3 ) . The .Xr getrlimit 2 @@ -143,7 +143,7 @@ to support the expansion. Setting the break may fail due to a temporary lack of swap space. It is not possible to distinguish this from a failure caused by exceeding the maximum size of -the data segment without consulting +the data segment without consulting .Xr getrlimit 2 . .Sh HISTORY A diff --git a/lib/libc/sys/chdir.2 b/lib/libc/sys/chdir.2 index 7a9c716..bd969f9 100644 --- a/lib/libc/sys/chdir.2 +++ b/lib/libc/sys/chdir.2 @@ -121,7 +121,7 @@ is not a valid file descriptor. .Sh STANDARDS The .Fn chdir -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index 6a3120f..d003503 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -129,7 +129,7 @@ For more details of the properties of the sticky bit, see If mode ISUID (set UID) is set on a directory, and the MNT_SUIDDIR option was used in the mount of the filesystem, then the owner of any new files and sub-directories -created within this directory are set +created within this directory are set to be the same as the owner of that directory. If this function is enabled, new directories will inherit the bit from their parents. Execute bits are removed from @@ -146,7 +146,7 @@ such should not be used on shell machines, especially on home directories. This option requires the SUIDDIR option in the kernel to work. Only UFS filesystems support this option. -For more details of the suiddir mount option, see +For more details of the suiddir mount option, see .Xr mount 8 . .Pp Writing or changing the owner of a file @@ -212,7 +212,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn chmod -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 , except for the return of .Er EFTYPE diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2 index e049ad5..363893a 100644 --- a/lib/libc/sys/chown.2 +++ b/lib/libc/sys/chown.2 @@ -58,7 +58,7 @@ or referenced by .Fa fd is changed as specified by the arguments .Fa owner -and +and .Fa group . The owner of a file may change the .Fa group @@ -147,7 +147,7 @@ An I/O error occurred while reading from or writing to the file system. .Sh STANDARDS The .Fn chown -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index db7336c..eeb9def 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -67,26 +67,26 @@ This call is restricted to the super-user. Depending on the setting of the .Ql kern.chroot_allow_open_directories sysctl variable, open filedescriptors which reference directories -will make the +will make the .Fn chroot fail as follows: .Pp -If +If .Ql kern.chroot_allow_open_directories -is set to zero, +is set to zero, .Fn chroot will always fail with .Er EPERM if there are any directories open. .Pp -If +If .Ql kern.chroot_allow_open_directories -is set to one (the default), +is set to one (the default), .Fn chroot will fail with .Er EPERM if there are any directories open and the -process is already subject to a +process is already subject to a .Fn chroot call. .Pp diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2 index 24ead35..e392954 100644 --- a/lib/libc/sys/clock_gettime.2 +++ b/lib/libc/sys/clock_gettime.2 @@ -68,7 +68,7 @@ kernel mode. .Pp The structure pointed to by .Fa tp -is defined in +is defined in .Ao Pa sys/time.h Ac as: .Pp diff --git a/lib/libc/sys/close.2 b/lib/libc/sys/close.2 index 18ebe3c..98c35e0 100644 --- a/lib/libc/sys/close.2 +++ b/lib/libc/sys/close.2 @@ -66,7 +66,7 @@ However, the semantics of System V and dictate that all .Xr fcntl 2 advisory record locks associated with a file for a given process -are removed when +are removed when .Em any file descriptor for that file is closed by that process. .Pp @@ -149,7 +149,7 @@ An interrupt was received. .Sh STANDARDS The .Fn close -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/connect.2 b/lib/libc/sys/connect.2 index 7a8a59d..54adbb2 100644 --- a/lib/libc/sys/connect.2 +++ b/lib/libc/sys/connect.2 @@ -131,7 +131,7 @@ The parameter specifies an area outside the process address space. .It Bq Er EINPROGRESS -The socket is non-blocking +The socket is non-blocking and the connection cannot be completed immediately. It is possible to diff --git a/lib/libc/sys/dup.2 b/lib/libc/sys/dup.2 index d64ee65..347795c 100644 --- a/lib/libc/sys/dup.2 +++ b/lib/libc/sys/dup.2 @@ -90,7 +90,7 @@ additional call. The close-on-exec flag on the new file descriptor is unset. .Pp -In +In .Fn dup2 , the value of the new descriptor .Fa newd @@ -194,7 +194,7 @@ The .Fn dup and .Fn dup2 -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index 85531f8..9086232 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -208,7 +208,7 @@ library re-initialization and then calls .Sh RETURN VALUES As the .Fn execve -function overlays the current process image +function overlays the current process image with a new process image the successful call has no process to return to. If diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index 9c2a25b..86364c1 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -122,7 +122,7 @@ and signals; process groups are specified by supplying .Fa arg -as negative, otherwise +as negative, otherwise .Fa arg is interpreted as a process ID. .El @@ -302,7 +302,7 @@ locks conflicts with the type specified in the request. This interface follows the completely stupid semantics of System V and .St -p1003.1-88 that require that all locks associated with a file for a given process are -removed when +removed when .Em any file descriptor for that file is closed by that process. This semantic means that applications must be aware of any files that @@ -311,7 +311,7 @@ For example if an application for updating the password file locks the password file database while making the update, and then calls .Xr getpwnam 3 to retrieve a record, -the lock will be lost because +the lock will be lost because .Xr getpwnam 3 opens, reads, and closes the password database. The database close will release all locks that the process has @@ -329,9 +329,9 @@ allows locks to be inherited by child processes. is recommended for applications that want to ensure the integrity of their locks when using library routines or wish to pass locks to their children. -Note that +Note that .Xr flock 2 -and +and .Xr fcntl 2 locks may be safely used concurrently. .Pp @@ -497,10 +497,10 @@ 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 EPERM -.Fa Cmd -is +.Fa Cmd +is .Dv F_SETOWN -and +and the process ID or process group given as an argument is in a different session than the caller. .It Bq Er ESRCH @@ -511,7 +511,7 @@ and the process ID given as argument is not in use. .El .Pp -In addition, if +In addition, if .Fa fd refers to a descriptor open on a terminal device (as opposed to a descriptor open on a socket), a diff --git a/lib/libc/sys/flock.2 b/lib/libc/sys/flock.2 index 49ecd4d..5e9ebf6 100644 --- a/lib/libc/sys/flock.2 +++ b/lib/libc/sys/flock.2 @@ -81,7 +81,7 @@ locks and locks. At any time multiple shared locks may be applied to a file, but at no time are multiple exclusive, or both shared and exclusive, -locks allowed simultaneously on a file. +locks allowed simultaneously on a file. .Pp A shared lock may be .Em upgraded diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index ee438ff..48d2e0e 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -122,7 +122,7 @@ The current position pointer associated with .Fa fd is set to point to the next block of entries. The pointer may not advance by the number of bytes returned by -.Fn getdirentries +.Fn getdirentries or .Fn getdents . A value of zero is returned when diff --git a/lib/libc/sys/getfsstat.2 b/lib/libc/sys/getfsstat.2 index de2bb80..bec4f14 100644 --- a/lib/libc/sys/getfsstat.2 +++ b/lib/libc/sys/getfsstat.2 @@ -145,7 +145,7 @@ Thus, some of the information will be out of date, but will not block waiting for information from a filesystem that is unable to respond. .Sh RETURN VALUES -Upon successful completion, the number of +Upon successful completion, the number of .Fa fsstat structures is returned. Otherwise, -1 is returned and the global variable diff --git a/lib/libc/sys/getgid.2 b/lib/libc/sys/getgid.2 index 3e1a148..39215e1 100644 --- a/lib/libc/sys/getgid.2 +++ b/lib/libc/sys/getgid.2 @@ -81,5 +81,5 @@ The .Fn getgid and .Fn getegid -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/getgroups.2 b/lib/libc/sys/getgroups.2 index 6527e80..7b0789d 100644 --- a/lib/libc/sys/getgroups.2 +++ b/lib/libc/sys/getgroups.2 @@ -48,11 +48,11 @@ .Sh DESCRIPTION .Fn Getgroups gets the current group access list of the user process -and stores it in the array +and stores it in the array .Fa gidset . The parameter .Fa gidsetlen -indicates the number of entries that may be placed in +indicates the number of entries that may be placed in .Fa gidset . .Fn Getgroups returns the actual number of groups returned in diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index db629f4..156caa1 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -68,7 +68,7 @@ call sets a timer to the specified .Fa ovalue is non-nil). .Pp -A timer value is defined by the +A timer value is defined by the .Fa itimerval structure: .Bd -literal -offset indent @@ -80,13 +80,13 @@ struct itimerval { .Pp If .Fa it_value -is non-zero, it indicates the time to the next timer expiration. +is non-zero, it indicates the time to the next timer expiration. If .Fa it_interval -is non-zero, it specifies a value to be used in reloading +is non-zero, it specifies a value to be used in reloading .Fa it_value when the timer expires. -Setting +Setting .Fa it_value to 0 disables a timer, regardless of the value of .Fa it_interval . diff --git a/lib/libc/sys/getpeername.2 b/lib/libc/sys/getpeername.2 index 20d9f53..c409cea 100644 --- a/lib/libc/sys/getpeername.2 +++ b/lib/libc/sys/getpeername.2 @@ -100,7 +100,7 @@ The socket is not connected. Insufficient resources were available in the system to perform the operation. .It Bq Er EFAULT -The +The .Fa name parameter points to memory not in a valid part of the process address space. diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2 index 9e3fa54..30209ac 100644 --- a/lib/libc/sys/getpgrp.2 +++ b/lib/libc/sys/getpgrp.2 @@ -109,7 +109,7 @@ function call is derived from its usage in System V Release 4. .Sh STANDARDS The .Fn getpgrp -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh COMPATIBILITY This version of diff --git a/lib/libc/sys/getpid.2 b/lib/libc/sys/getpid.2 index 70c0b65..656d7e7 100644 --- a/lib/libc/sys/getpid.2 +++ b/lib/libc/sys/getpid.2 @@ -62,7 +62,7 @@ instead. .Pp .Fn Getppid returns the process ID of the parent -of the calling process. +of the calling process. .Sh ERRORS The .Fn getpid @@ -77,7 +77,7 @@ The .Fn getpid and .Fn getppid -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/getpriority.2 b/lib/libc/sys/getpriority.2 index 8a8d57b..efaa5ed 100644 --- a/lib/libc/sys/getpriority.2 +++ b/lib/libc/sys/getpriority.2 @@ -65,9 +65,9 @@ is one of .Dv PRIO_PGRP , or .Dv PRIO_USER , -and +and .Fa who -is interpreted relative to +is interpreted relative to .Fa which (a process identifier for .Dv PRIO_PROCESS , @@ -110,7 +110,7 @@ and will fail if: .Bl -tag -width Er .It Bq Er ESRCH -No process was located using the +No process was located using the .Fa which and .Fa who diff --git a/lib/libc/sys/getrlimit.2 b/lib/libc/sys/getrlimit.2 index ceac426..9b76214 100644 --- a/lib/libc/sys/getrlimit.2 +++ b/lib/libc/sys/getrlimit.2 @@ -55,7 +55,7 @@ and each process it creates may be obtained with the .Fn getrlimit call, and set with the .Fn setrlimit -call. +call. .Pp The .Fa resource @@ -104,7 +104,7 @@ A resource limit is specified as a soft limit and a hard limit. When a soft limit is exceeded a process may receive a signal (for example, if the cpu time or file size is exceeded), but it will be allowed to continue execution until it reaches the hard limit (or modifies -its resource limit). The +its resource limit). The .Em rlimit structure is used to specify the hard and soft limits on a resource, .Bd -literal -offset indent @@ -115,9 +115,9 @@ struct rlimit { .Ed .Pp Only the super-user may raise the maximum limits. Other users -may only alter +may only alter .Fa rlim_cur -within the range from 0 to +within the range from 0 to .Fa rlim_max or (irreversibly) lower .Fa rlim_max . diff --git a/lib/libc/sys/getrusage.2 b/lib/libc/sys/getrusage.2 index ad7f585..2d973cb 100644 --- a/lib/libc/sys/getrusage.2 +++ b/lib/libc/sys/getrusage.2 @@ -144,9 +144,9 @@ priority process becoming runnable or because the current process exceeded its time slice. .El .Sh NOTES -The numbers +The numbers .Fa ru_inblock -and +and .Fa ru_oublock account only for real I/O; data supplied by the caching mechanism is charged only diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index d2ecff9..afaa86b 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -47,7 +47,7 @@ .Fn getsockname "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh DESCRIPTION .Fn Getsockname -returns the current +returns the current .Fa name for the specified socket. The .Fa namelen @@ -96,7 +96,7 @@ is a file, not a socket. Insufficient resources were available in the system to perform the operation. .It Bq Er EFAULT -The +The .Fa name parameter points to memory not in a valid part of the process address space. diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 0f1a23b..b5bc37b 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -187,13 +187,13 @@ of the destination address. .Pp .Dv SO_LINGER controls the action taken when unsent messages -are queued on socket and a +are queued on socket and a .Xr close 2 is performed. If the socket promises reliable delivery of data and .Dv SO_LINGER is set, -the system will block the process on the +the system will block the process on the .Xr close 2 attempt until it is able to transmit the data or until it decides it is unable to deliver the information (a timeout period, termed the @@ -201,10 +201,10 @@ linger interval, is specified in seconds in the .Fn setsockopt call when .Dv SO_LINGER -is requested). +is requested). If .Dv SO_LINGER -is disabled and a +is disabled and a .Xr close 2 is issued, the system will process the close in a manner that allows the process to continue as quickly as possible. @@ -263,7 +263,7 @@ requested. The default value for .Dv SO_RCVLOWAT is 1. -If +If .Dv SO_RCVLOWAT is set to a larger value, blocking receive calls normally wait until they have received the smaller of the low water mark value @@ -406,7 +406,7 @@ is a file, not a socket. .It Bq Er ENOPROTOOPT The option is unknown at the level indicated. .It Bq Er EFAULT -The address pointed to by +The address pointed to by .Fa optval is not in a valid part of the process address space. For diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index 6b8f3f6..06b7996 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -74,7 +74,7 @@ The structures pointed to by .Fa tp and .Fa tzp -are defined in +are defined in .Ao Pa sys/time.h Ac as: .Pp @@ -90,7 +90,7 @@ struct timezone { }; .Ed .Pp -The +The .Fa timezone structure indicates the local time zone (measured in minutes of time westward from Greenwich), diff --git a/lib/libc/sys/getuid.2 b/lib/libc/sys/getuid.2 index 1a762fe..95873bf 100644 --- a/lib/libc/sys/getuid.2 +++ b/lib/libc/sys/getuid.2 @@ -83,7 +83,7 @@ The .Fn geteuid and .Fn getuid -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2 index 07c1a02..56dbcd7 100644 --- a/lib/libc/sys/intro.2 +++ b/lib/libc/sys/intro.2 @@ -52,7 +52,7 @@ their error returns, and other common definitions and concepts. .Sh RETURN VALUES Nearly all of the system calls provide an error number referenced via the external identifier errno. -This identifier is defined in +This identifier is defined in .Aq Pa sys/errno.h as .Pp @@ -97,7 +97,7 @@ An attempt was made to perform an operation limited to processes with appropriate privileges or to the owner of a file or other resources. .It Er 2 ENOENT Em "No such file or directory" . -A component of a specified pathname did not exist, or the +A component of a specified pathname did not exist, or the pathname was an empty string. .It Er 3 ESRCH Em "No such process" . No process could be found corresponding to that specified by the given @@ -383,7 +383,7 @@ was supplied to a remove directory or rename call. .It Er 68 EUSERS Em "Too many users" . The quota system ran out of table entries. .It Er 69 EDQUOT Em "Disc quota exceeded" . -A +A .Xr write 2 to an ordinary file, the creation of a directory or symbolic link, or the creation of a directory @@ -395,10 +395,10 @@ was exhausted. An attempt was made to access an open file (on an .Tn NFS filesystem) -which is now unavailable as referenced by the file descriptor. +which is now unavailable as referenced by the file descriptor. This may indicate the file was deleted on the -.Tn NFS -server or some +.Tn NFS +server or some other catastrophic event occurred. .It Er 72 EBADRPC Em "RPC struct is bad" . Exchange of @@ -412,7 +412,7 @@ the local version. .It Er 74 EPROGUNAVAIL Em "RPC prog. not avail" . The requested program is not registered on the remote host. .It Er 75 EPROGMISMATCH Em "Program version wrong" . -The requested version of the program is not available +The requested version of the program is not available on the remote host .Pq Tn RPC . .It Er 76 EPROCUNAVAIL Em "Bad procedure for program" . @@ -421,13 +421,13 @@ An call was attempted for a procedure which doesn't exist in the remote program. .It Er 77 ENOLCK Em "No locks available" . -A system-imposed limit on the number of simultaneous file +A system-imposed limit on the number of simultaneous file locks was reached. .It Er 78 ENOSYS Em "Function not implemented" . -Attempted a system call that is not available on this +Attempted a system call that is not available on this system. .It Er 79 EFTYPE Em "Inappropriate file type or format" . -The file was the wrong type for the operation, or a data file had +The file was the wrong type for the operation, or a data file had the wrong format. .It Er 80 EAUTH Em "Authentication error" . Attempted to use an invalid authentication ticket to mount a @@ -448,8 +448,8 @@ provided space. .It Er 85 ECANCELED Em "Operation canceled" . The scheduled operation was canceled. .It Er 86 EILSEQ Em "Illegal byte sequence" . -While decoding a multibyte character the function came along an -invalid or an incomplete sequence of bytes or the given wide +While decoding a multibyte character the function came along an +invalid or an incomplete sequence of bytes or the given wide character is invalid. .El .Sh DEFINITIONS @@ -519,10 +519,10 @@ The process group of a session leader is orphaned by definition. Each user on the system is identified by a positive integer termed the real user ID. .Pp -Each user is also a member of one or more groups. +Each user is also a member of one or more groups. One of these groups is distinguished from others and used in implementing accounting facilities. The positive -integer corresponding to this distinguished group is termed +integer corresponding to this distinguished group is termed the real group ID. .Pp All processes have a real user ID and real group ID. @@ -653,13 +653,13 @@ These permissions are used in determining whether a process may perform a requested operation on the file (such as opening a file for writing). Access permissions are established at the time a file is created. They may be changed at some later time -through the +through the .Xr chmod 2 -call. +call. .Pp File access is broken down according to whether a file may be: read, written, or executed. Directory files use the execute -permission to control if the directory may be searched. +permission to control if the directory may be searched. .Pp File access permissions are interpreted by the system as they apply to three different classes of users: the owner diff --git a/lib/libc/sys/ioctl.2 b/lib/libc/sys/ioctl.2 index 5f75d49..fe1fea2 100644 --- a/lib/libc/sys/ioctl.2 +++ b/lib/libc/sys/ioctl.2 @@ -62,11 +62,11 @@ The third argument to .Nm is traditionally named .Ar "char *argp" . -Most uses of +Most uses of .Nm in .Fx 3.0 -however, require the third argument to be a +however, require the third argument to be a .Ar caddr_t or an .Ar int . diff --git a/lib/libc/sys/jail.2 b/lib/libc/sys/jail.2 index cc0df2a..e457548 100644 --- a/lib/libc/sys/jail.2 +++ b/lib/libc/sys/jail.2 @@ -58,9 +58,9 @@ the prison. It is not possible to add a process to a preexisting prison. .Pp Inside the prison, the concept of "superuser" is very diluted. In general, it can be assumed that nothing can be mangled from inside a prison which -does not exist entirely inside that prison. For instance the directory +does not exist entirely inside that prison. For instance the directory tree below -.Dq Li path +.Dq Li path can be manipulated all the ways a root can normally do it, including .Dq Li "rm -rf /*" but new device special nodes cannot be created because they reference diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2 index e641fd9..f0b9654 100644 --- a/lib/libc/sys/kill.2 +++ b/lib/libc/sys/kill.2 @@ -59,7 +59,7 @@ may be one of the signals specified in .Xr sigaction 2 or it may be 0, in which case error checking is performed but no -signal is actually sent. +signal is actually sent. This can be used to check the validity of .Fa pid . .Pp @@ -135,7 +135,7 @@ of the group could not be signaled. .Sh STANDARDS The .Fn kill -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/kldfind.2 b/lib/libc/sys/kldfind.2 index aabd41d..8305076 100644 --- a/lib/libc/sys/kldfind.2 +++ b/lib/libc/sys/kldfind.2 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDFIND 2 .Os .Sh NAME .Nm kldfind -.Nd returns the fileid of a kld file +.Nd returns the fileid of a kld file .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kldfirstmod.2 b/lib/libc/sys/kldfirstmod.2 index fe928b8..29e81d8 100644 --- a/lib/libc/sys/kldfirstmod.2 +++ b/lib/libc/sys/kldfirstmod.2 @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDFIRSTMOD 2 diff --git a/lib/libc/sys/kldload.2 b/lib/libc/sys/kldload.2 index f897c83..2b40bab 100644 --- a/lib/libc/sys/kldload.2 +++ b/lib/libc/sys/kldload.2 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm kldload -.Nd load KLD files into the kernel +.Nd load KLD files into the kernel .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -68,7 +68,7 @@ The file was not found. .It Bq Er ENOEXEC The file format of .Fa file -was unrecognized. +was unrecognized. .El .Sh SEE ALSO .Xr kldfind 2 , diff --git a/lib/libc/sys/kldnext.2 b/lib/libc/sys/kldnext.2 index 4ba8ca3..d18f953 100644 --- a/lib/libc/sys/kldnext.2 +++ b/lib/libc/sys/kldnext.2 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDNEXT 2 .Os .Sh NAME .Nm kldnext -.Nd return the fileid of the next kld file +.Nd return the fileid of the next kld file .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kldstat.2 b/lib/libc/sys/kldstat.2 index 4846905..0ad213b 100644 --- a/lib/libc/sys/kldstat.2 +++ b/lib/libc/sys/kldstat.2 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd March 3, 1999 .Dt KLDSTAT 2 .Os .Sh NAME .Nm kldstat -.Nd get status of kld file +.Nd get status of kld file .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 7225358..4d5ee64 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -60,7 +60,7 @@ The filter is also run when the user attempts to retrieve the kevent from the kqueue. If the filter indicates that the condition that triggered the event no longer holds, the kevent is removed from the kqueue and -is not returned. +is not returned. .Pp Multiple events which trigger the filter do not result in multiple kevents being placed on the kqueue; instead, the filter will aggregate @@ -85,17 +85,17 @@ is used to register events with the queue, and return any pending events to the user. .Fa changelist is a pointer to an array of -.Va kevent +.Va kevent structures, as defined in .Aq Pa sys/event.h . -All changes contained in the +All changes contained in the .Fa changelist are applied before any pending events are read from the queue. .Fa nchanges gives the size of .Fa changelist . .Fa eventlist -is a pointer to an array of kevent structures. +is a pointer to an array of kevent structures. .Fa nevents determines the size of .Fa eventlist . @@ -112,7 +112,7 @@ argument should be non-NULL, pointing to a zero-valued .Va timespec structure. The same array may be used for the .Fa changelist -and +and .Fa eventlist . .Pp .Fn EV_SET @@ -149,7 +149,7 @@ Actions to perform on the event. .It fflags Filter-specific flags. .It data -Filter-specific data value. +Filter-specific data value. .It udata Opaque user-defined value passed through the kernel unchanged. .El @@ -172,8 +172,8 @@ Disable the event so .Fn kevent will not return it. The filter itself is not disabled. .It EV_DELETE -Removes the event from the kqueue. Events which are attached to -file descriptors are automatically deleted on the last close of +Removes the event from the kqueue. Events which are attached to +file descriptors are automatically deleted on the last close of the descriptor. .It EV_ONESHOT Causes the event to return only the first occurrence of the filter @@ -193,7 +193,7 @@ below. .El .Pp The predefined system filters are listed below. -Arguments may be passed to and from the filter via the +Arguments may be passed to and from the filter via the .Va fflags and .Va data @@ -218,9 +218,9 @@ subject to the .Dv SO_RCVLOWAT value of the socket buffer. This may be overridden with a per-filter low water mark at the -time the filter is added by setting the -NOTE_LOWAT -flag in +time the filter is added by setting the +NOTE_LOWAT +flag in .Va fflags , and specifying the new low water mark in .Va data . @@ -231,7 +231,7 @@ contains the number of bytes in the socket buffer. If the read direction of the socket has shutdown, then the filter also sets EV_EOF in .Va flags , -and returns the socket error (if any) in +and returns the socket error (if any) in .Va fflags . It is possible for EOF to be returned (indicating the connection is gone) while there is still data pending in the socket buffer. @@ -254,22 +254,22 @@ returning. .It EVFILT_WRITE Takes a descriptor as the identifier, and returns whenever it is possible to write to the descriptor. For sockets, pipes -and fifos, +and fifos, .Va data will contain the amount of space remaining in the write buffer. The filter will set EV_EOF when the reader disconnects, and for the fifo case, this may be cleared by use of EV_CLEAR. Note that this filter is not supported for vnodes. .Pp -For sockets, the low water mark and socket error handling is +For sockets, the low water mark and socket error handling is identical to the EVFILT_READ case. .It EVFILT_AIO The sigevent portion of the AIO request is filled in, with -.Va sigev_notify_kqueue +.Va sigev_notify_kqueue containing the descriptor of the kqueue that the event should be attached to, .Va sigev_value -containing the udata value, and +containing the udata value, and .Va sigev_notify set to SIGEV_EVENT. When the aio_* function is called, the event will be registered @@ -280,7 +280,7 @@ argument set to the returned by the aio_* function. The filter returns under the same conditions as aio_error. .Pp -Alternatively, a kevent structure may be initialized, with +Alternatively, a kevent structure may be initialized, with .Va ident containing the descriptor of the kqueue, and the address of the kevent structure placed in the @@ -288,7 +288,7 @@ address of the kevent structure placed in the field of the AIO request. However, this approach will not work on architectures with 64-bit pointers, and should be considered depreciated. .It EVFILT_VNODE -Takes a file descriptor as the identifier and the events to watch for in +Takes a file descriptor as the identifier and the events to watch for in .Va fflags , and returns when one or more of the requested events occurs on the descriptor. The events to monitor are: @@ -307,7 +307,7 @@ The link count on the file changed. .It NOTE_RENAME The file referenced by the descriptor was renamed. .It NOTE_REVOKE -Access to the file was revoked via +Access to the file was revoked via .Xr revoke 2 or the underlying fileystem was unmounted. .El @@ -316,7 +316,7 @@ On return, .Va fflags contains the events which triggered the filter. .It EVFILT_PROC -Takes the process ID to monitor as the identifier and the events to watch for +Takes the process ID to monitor as the identifier and the events to watch for in .Va fflags , and returns when the process performs one or more of the requested events. @@ -329,7 +329,7 @@ The process has exited. The process has called .Fn fork . .It NOTE_EXEC -The process has executed a new process via +The process has executed a new process via .Xr execve 2 or similar call. .It NOTE_TRACK @@ -339,7 +339,7 @@ calls. The parent process will return with NOTE_TRACK set in the .Va fflags field, while the child process will return with NOTE_CHILD set in .Va fflags -and the parent PID in +and the parent PID in .Va data . .It NOTE_TRACKERR This flag is returned if the system was unable to attach an event to @@ -354,7 +354,7 @@ Takes the signal number to monitor as the identifier and returns when the given signal is delivered to the process. This coexists with the .Fn signal -and +and .Fn sigaction facilities, and has a lower precedence. The filter will record all attempts to deliver a signal to a process, even if the signal has @@ -416,9 +416,9 @@ function fails if: .It Bq Er EACCES The process does not have permission to register a filter. .It Bq Er EFAULT -There was an error reading or writing the +There was an error reading or writing the .Va kevent -structure. +structure. .It Bq Er EBADF The specified descriptor is invalid. .It Bq Er EINTR diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2 index ded62e6..fcbf46e 100644 --- a/lib/libc/sys/ktrace.2 +++ b/lib/libc/sys/ktrace.2 @@ -110,7 +110,7 @@ struct ktr_header { .Pp The .Va ktr_len -field specifies the length of the +field specifies the length of the .Va ktr_type data that follows this header. The @@ -126,7 +126,7 @@ The .Va ktr_buf is an internal kernel pointer and is not useful. .Pp -The generic header is followed by +The generic header is followed by .Va ktr_len bytes of a .Va ktr_type diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 5ddc28b..baea6eb 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -138,7 +138,7 @@ is being placed cannot be extended because the user's quota of disk blocks on the file system containing the directory has been exhausted. .It Bq Er EIO -An I/O error occurred while reading from or writing to +An I/O error occurred while reading from or writing to the file system to make the directory entry. .It Bq Er EROFS The requested link requires writing in a directory on a read-only file @@ -154,7 +154,7 @@ is outside the process's allocated address space. .Sh STANDARDS The .Fn link -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A @@ -166,4 +166,4 @@ The .Fn link system call traditionally allows the super-user to link directories which corrupts the filesystem coherency. This implementation no longer permits -it. +it. diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2 index fd67ca4..b77500a 100644 --- a/lib/libc/sys/listen.2 +++ b/lib/libc/sys/listen.2 @@ -109,7 +109,7 @@ unlocks .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 e161025..362485b 100644 --- a/lib/libc/sys/lseek.2 +++ b/lib/libc/sys/lseek.2 @@ -135,7 +135,7 @@ is incorrect English, but is maintained for historical reasons. .Sh STANDARDS The .Fn lseek -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/madvise.2 b/lib/libc/sys/madvise.2 index 4886d02..e5d6a06 100644 --- a/lib/libc/sys/madvise.2 +++ b/lib/libc/sys/madvise.2 @@ -66,7 +66,7 @@ The known behaviors are given in #define MADV_CORE 9 /* revert to including pages in a core file */ .Ed .Pp -.Bl -tag -width MADV_SEQUENTIAL +.Bl -tag -width MADV_SEQUENTIAL .It Dv MADV_NORMAL Tells the system to revert to the default paging behavior. @@ -92,26 +92,26 @@ this address range will incur a page fault. .It Dv MADV_FREE Gives the VM system the freedom to free pages, and tells the system that information in the specified page range -is no longer important. This is an efficient way of allowing +is no longer important. This is an efficient way of allowing .Xr malloc 3 to free pages anywhere in the address space, while keeping the address space valid. The next time that the page is referenced, the page might be demand -zeroed, or might contain the data that was there before the +zeroed, or might contain the data that was there before the .Dv MADV_FREE call. References made to that address space range will not make the VM system page the information back in from backing store until the page is modified again. .It Dv MADV_NOSYNC -Request that the system not flush the data associated with this map to +Request that the system not flush the data associated with this map to physical backing store unless it needs to. Typically this prevents the filesystem update daemon from gratuitously writing pages dirtied -by the VM system to physical disk. Note that VM/filesystem coherency is +by the VM system to physical disk. Note that VM/filesystem coherency is always maintained, this feature simply ensures that the mapped data is only flush when it needs to be, usually by the system pager. .Pp This feature is typically used when you want to use a file-backed shared -memory area to communicate between processes (IPC) and do not particularly +memory area to communicate between processes (IPC) and do not particularly need the data being stored in that area to be physically written to disk. With this feature you get the equivalent performance with mmap that you would expect to get with SysV shared memory calls, but in a more controllable @@ -146,7 +146,7 @@ function will fail if: .It Bq Er EINVAL The virtual address range specified by the .Fa addr -and +and .Fa len arguments is not valid. .El diff --git a/lib/libc/sys/minherit.2 b/lib/libc/sys/minherit.2 index d80c172..265d6d27 100644 --- a/lib/libc/sys/minherit.2 +++ b/lib/libc/sys/minherit.2 @@ -84,9 +84,9 @@ arguments. .El .Sh SEE ALSO .Xr fork 2 , -.Xr madvise 2 , -.Xr mincore 2 , -.Xr mprotect 2 , +.Xr madvise 2 , +.Xr mincore 2 , +.Xr mprotect 2 , .Xr msync 2 , .Xr munmap 2 , .Xr rfork 2 diff --git a/lib/libc/sys/mkdir.2 b/lib/libc/sys/mkdir.2 index 91374ce..5db2074 100644 --- a/lib/libc/sys/mkdir.2 +++ b/lib/libc/sys/mkdir.2 @@ -110,5 +110,5 @@ points outside the process's allocated address space. .Sh STANDARDS The .Fn mkdir -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/mkfifo.2 b/lib/libc/sys/mkfifo.2 index aeed3d9..2a606cb 100644 --- a/lib/libc/sys/mkfifo.2 +++ b/lib/libc/sys/mkfifo.2 @@ -113,11 +113,11 @@ points outside the process's allocated address space. .El .Sh SEE ALSO .Xr chmod 2 , -.Xr mknod 2 , +.Xr mknod 2 , .Xr stat 2 , .Xr umask 2 .Sh STANDARDS The .Fn mkfifo -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index e9eb9d3..f4cb27e 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -137,7 +137,7 @@ Region is not included in a core file. .It Dv MAP_NOSYNC Causes data dirtied via this VM map to be flushed to physical media only when necessary (usually by the pager) rather then gratuitously. -Typically this prevents the update daemons from flushing pages dirtied +Typically this prevents the update daemons from flushing pages dirtied through such maps and thus allows efficient sharing of memory across unassociated processes using a file-backed shared memory map. Without this option any VM pages you dirty may be flushed to disk every so often @@ -193,7 +193,7 @@ The .Xr msync 2 system call is obsolete since .Bx -implements a coherent filesystem buffer cache. However, it may be +implements a coherent filesystem buffer cache. However, it may be used to associate dirty VM pages with filesystem buffers and thus cause them to be flushed to physical media sooner rather then later. .It Dv MAP_PRIVATE @@ -217,26 +217,26 @@ to enable this option for other architechures. implies .Dv MAP_ANON , and -.Fa offset -of 0. -.Fa fd -must be -1 and -.Fa prot +.Fa offset +of 0. +.Fa fd +must be -1 and +.Fa prot must include at least .Dv PROT_READ and .Dv PROT_WRITE . This option creates -a memory region that grows to at most -.Fa len +a memory region that grows to at most +.Fa len bytes in size, starting from the stack top and growing down. The -stack top is the starting address returned by the call, plus -.Fa len +stack top is the starting address returned by the call, plus +.Fa len bytes. The bottom of the stack at maximum growth is the starting address returned by the call. .El .Pp -The +The .Xr close 2 function does not unmap pages, see .Xr munmap 2 @@ -332,7 +332,7 @@ was specified and insufficient memory was available. .Sh BUGS .Fa len is limited to 2GB. Mmapping slightly more than 2GB doesn't work, but -it is possible to map a window of size (filesize % 2GB) for file sizes +it is possible to map a window of size (filesize % 2GB) for file sizes of slightly less than 2G, 4GB, 6GB and 8GB. .Pp The limit is imposed for a variety of reasons. diff --git a/lib/libc/sys/modfind.2 b/lib/libc/sys/modfind.2 index ad29f2e..c1ac0c6 100644 --- a/lib/libc/sys/modfind.2 +++ b/lib/libc/sys/modfind.2 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm modfind -.Nd returns the modid of a kernel module +.Nd returns the modid of a kernel module .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index efc3384..ef3d22d 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -82,7 +82,7 @@ suppress default semantics which affect filesystem access. .It Dv MNT_RDONLY The filesystem should be treated as read-only; Even the super-user may not write on it. -Specifying MNT_UPDATE without this option will upgrade +Specifying MNT_UPDATE without this option will upgrade a read-only filesystem to read/write. .It Dv MNT_NOEXEC Do not allow files to be executed from the filesystem. @@ -109,7 +109,7 @@ Disable write clustering. .Pp The flag .Dv MNT_UPDATE -indicates that the mount command is being applied +indicates that the mount command is being applied to an already mounted filesystem. This allows the mount flags to be changed without requiring that the filesystem be unmounted and remounted. @@ -164,7 +164,7 @@ The option requires the SUIDDIR option to have been compiled into the kernel to have any effect. See the -.Xr mount 8 +.Xr mount 8 and .Xr chmod 2 pages for more information. @@ -225,7 +225,7 @@ does not exist. .Ar Fspec is not a block device. .It Bq Er ENXIO -The major device number of +The major device number of .Ar fspec is out of range (this indicates no device driver exists for the associated hardware). diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2 index 4403dc5..7f46d24 100644 --- a/lib/libc/sys/mprotect.2 +++ b/lib/libc/sys/mprotect.2 @@ -54,7 +54,7 @@ changes the specified pages to have protection Not all implementations will guarantee protection on a page basis; the granularity of protection changes may be as large as an entire region. .Sh RETURN VALUES -Upon successful completion, +Upon successful completion, .Fn mprotect returns 0. Otherwise a value of -1 is returned and diff --git a/lib/libc/sys/msync.2 b/lib/libc/sys/msync.2 index f9a7199..38fda84 100644 --- a/lib/libc/sys/msync.2 +++ b/lib/libc/sys/msync.2 @@ -58,7 +58,7 @@ is 0, all modified pages within the region containing will be flushed; if .Fa len -is non-zero, only those pages containing +is non-zero, only those pages containing .Fa addr and .Fa len-1 diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2 index 0c4749f..832684d 100644 --- a/lib/libc/sys/nanosleep.2 +++ b/lib/libc/sys/nanosleep.2 @@ -54,26 +54,26 @@ cause it to terminate the sleep early, regardless of the .Dv SA_RESTART value on the interrupting signal. .Sh RETURN VALUES -If the +If the .Fn nanosleep function returns because the requested time has elapsed, the value -returned will be zero. +returned will be zero. .Pp -If the +If the .Fn nanosleep function returns due to the delivery of a signal, the value returned will be the -1, and the global variable .Va errno will be set to indicate the interruption. -If +If .Fa rmtp -is +is .Pf non- Dv NULL , the timespec structure it references is updated to contain the unslept amount (the request time minus the time actually slept). .Pp If any of the following conditions occur, the -.Fn nanosleep +.Fn nanosleep function shall return -1 and set .Va errno to the corresponding value: @@ -81,7 +81,7 @@ to the corresponding value: .It Bq Er EFAULT Either .Fa rqtp -or +or .Fa rmtp points to memory that is not a valid part of the process address space. diff --git a/lib/libc/sys/nfssvc.2 b/lib/libc/sys/nfssvc.2 index a852365..d28edc1 100644 --- a/lib/libc/sys/nfssvc.2 +++ b/lib/libc/sys/nfssvc.2 @@ -121,7 +121,7 @@ with the flags .Dv NFSSVC_MNTD and .Dv NFSSVC_GOTAUTH -after filling the ticket into the +after filling the ticket into the ncd_authstr field and setting the ncd_authlen and ncd_authtype diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index feb05c1..5e4aeeb 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -58,7 +58,7 @@ argument may indicate the file is to be created if it does not exist (by specifying the .Dv O_CREAT flag). -In this case +In this case .Nm requires a third argument .Fa "mode_t mode" , diff --git a/lib/libc/sys/pipe.2 b/lib/libc/sys/pipe.2 index 0e0043f..5bbc563 100644 --- a/lib/libc/sys/pipe.2 +++ b/lib/libc/sys/pipe.2 @@ -89,7 +89,7 @@ for using the endpoints in the traditional manner when using a pipe in one direction. .Sh RETURN VALUES On successful creation of the pipe, zero is returned. -Otherwise, +Otherwise, a value of -1 is returned and the variable .Va errno set to indicate the diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 29a8538..a223b80 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -146,7 +146,7 @@ resumes execution, or 0 if no signal is to be sent. .It Dv PT_STEP The traced process is single stepped one instruction. The -.Fa addr +.Fa addr and .Fa data fields are not used. diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index 75de692..6fe4a09 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -91,7 +91,7 @@ The .Fa addr argument specifies a file from which to take the quotas. The quota file must exist; -it is normally created with the +it is normally created with the .Xr quotacheck 8 program. The @@ -115,7 +115,7 @@ Get disk quota limits and current usage for the user or group .Fa Addr is a pointer to a .Fa struct dqblk -structure (defined in +structure (defined in .Ao Pa ufs/ufs/quota.h Ac ) . .It Dv Q_SETQUOTA Set disk quota limits for the user or group @@ -124,7 +124,7 @@ Set disk quota limits for the user or group .Fa Addr is a pointer to a .Fa struct dqblk -structure (defined in +structure (defined in .Ao Pa ufs/ufs/quota.h Ac ) . The usage fields of the .Fa dqblk diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index 90c8e78..9c38809 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -62,7 +62,7 @@ into the buffer pointed to by .Fa buf . .Fn Readv performs the same action, but scatters the input data -into the +into the .Fa iovcnt buffers specified by the members of the .Fa iov @@ -71,9 +71,9 @@ array: iov[0], iov[1], ..., iov[iovcnt\|\-\|1]. performs the same function, but reads from the specified position in the file without modifying the file pointer. .Pp -For +For .Fn readv , -the +the .Fa iovec structure is defined as: .Pp @@ -84,10 +84,10 @@ struct iovec { }; .Ed .Pp -Each +Each .Fa iovec entry specifies the base address and length of an area -in memory where data should be placed. +in memory where data should be placed. .Fn Readv will always fill an area completely before proceeding to the next. @@ -199,7 +199,7 @@ The file was marked for non-blocking I/O, and no data were ready to be read. .El .Pp -In addition, +In addition, .Fn readv may return one of the following errors: .Bl -tag -width Er @@ -244,7 +244,7 @@ The file descriptor is associated with a pipe, socket, or FIFO. .Sh STANDARDS The .Fn read -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . The .Fn readv diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index 7830d77..7a49e41 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -70,9 +70,9 @@ the buffer associated with and modified on return to indicate the actual size of the address stored there. .Pp -The +The .Fn recv -call is normally used only on a +call is normally used only on a .Em connected socket (see .Xr connect 2 ) @@ -115,7 +115,7 @@ call may be used to determine when more data arrive. .Pp The .Fa flags -argument to a recv call is formed by +argument to a recv call is formed by .Em or Ap ing one or more of the values: .Bl -column MSG_WAITALL -offset indent @@ -142,7 +142,7 @@ or the next data to be received is of a different type than that returned. .Pp The .Fn recvmsg -call uses a +call uses a .Fa msghdr structure to minimize the number of directly supplied parameters. This structure has the following form, as defined in diff --git a/lib/libc/sys/rename.2 b/lib/libc/sys/rename.2 index 91bf125..41edfaf 100644 --- a/lib/libc/sys/rename.2 +++ b/lib/libc/sys/rename.2 @@ -50,10 +50,10 @@ causes the link named .Fa from to be renamed as .Fa to . -If +If .Fa to exists, it is first removed. -Both +Both .Fa from and .Fa to @@ -92,7 +92,7 @@ not the file or directory to which it points. .\".Ql rename a/foo b/bar .\"and .\".Ql rename b/bar a/foo , -.\"respectively, +.\"respectively, .\"the system may deadlock attempting to lock .\"both directories for modification. .\"Hard links to directories should be @@ -100,7 +100,7 @@ not the file or directory to which it points. .Sh RETURN VALUES A 0 value is returned if the operation succeeds, otherwise .Fn rename -returns -1 and the global variable +returns -1 and the global variable .Va errno indicates the reason for the failure. .Sh ERRORS @@ -197,5 +197,5 @@ is a directory and is not empty. .Sh STANDARDS The .Fn rename -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index bf205d3..1f96447 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -42,7 +42,7 @@ The current implementation requires this flag to always be set. If set, the child process will be dissociated from the parent. Upon exit the child will not leave a status for the parent to collect. -See +See .Xr wait 2 . .It RFFDG If set, the invoker's file descriptor table (see @@ -73,7 +73,7 @@ for information. If set, the kernel will force sharing the sigacts structure between the child and the parent. .It RFLINUXTHPN -If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread +If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread exit for the child. This is intended to mimic certain Linux clone behaviour. .El .Pp diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2 index 3f902c0..bfd72c4 100644 --- a/lib/libc/sys/rtprio.2 +++ b/lib/libc/sys/rtprio.2 @@ -1,6 +1,6 @@ .\" Copyright (c) 1994, Henrik Vestergaard Draboel .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -26,7 +26,7 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .\" .Dd July 23, 1994 @@ -40,7 +40,7 @@ .Sh SYNOPSIS .Fd #include <sys/types.h> .Fd #include <sys/rtprio.h> -.Ft int +.Ft int .Fn rtprio "int function" "pid_t pid" "struct rtprio *rtp" .Sh DESCRIPTION .Fn rtprio @@ -48,13 +48,13 @@ is used to lookup or change the realtime or idle priority of a process. .Pp .Fa function specifies the operation to be performed. -RTP_LOOKUP to lookup the current priority, +RTP_LOOKUP to lookup the current priority, and RTP_SET to set the priority. .Fa pid specifies the process to be used, 0 for the current process. .Pp .Fa *rtp -is a pointer to a struct rtprio which is used to specify the priority and priority type. +is a pointer to a struct rtprio which is used to specify the priority and priority type. This structure has the following form: .Bd -literal struct rtprio { @@ -69,7 +69,7 @@ field may be RTP_PRIO_REALTIME for realtime priorities, RTP_PRIO_NORMAL for normal priorities, and RTP_PRIO_IDLE for idle priorities. The priority specified by the .Nm prio -field ranges between 0 and +field ranges between 0 and .Dv RTP_PRIO_MAX (usually 31) . 0 is the highest possible priority. .Pp @@ -89,7 +89,7 @@ The global variable will be set to indicate the error. .Sh ERRORS .Fn rtprio -will fail if +will fail if .Bl -tag -width Er .It Bq Er EINVAL The specified diff --git a/lib/libc/sys/sched_get_priority_max.2 b/lib/libc/sys/sched_get_priority_max.2 index cebce15..20b2459 100644 --- a/lib/libc/sys/sched_get_priority_max.2 +++ b/lib/libc/sys/sched_get_priority_max.2 @@ -118,7 +118,7 @@ No process can be found corresponding to that specified by .Xr sched_set_scheduler 2 .Sh STANDARDS The -.Fn sched_setscheduler +.Fn sched_setscheduler and .Fn sched_getscheduler functions conform to diff --git a/lib/libc/sys/sched_setparam.2 b/lib/libc/sys/sched_setparam.2 index d937114..57b077f 100644 --- a/lib/libc/sys/sched_setparam.2 +++ b/lib/libc/sys/sched_setparam.2 @@ -167,7 +167,7 @@ is outside the range defined for the scheduling policy of the specified .Xr sched_yield 2 .Sh STANDARDS The -.Fn sched_setparam +.Fn sched_setparam and .Fn sched_getparam functions conform to diff --git a/lib/libc/sys/sched_setscheduler.2 b/lib/libc/sys/sched_setscheduler.2 index ff3d5ad..b616e6d 100644 --- a/lib/libc/sys/sched_setscheduler.2 +++ b/lib/libc/sys/sched_setscheduler.2 @@ -162,7 +162,7 @@ is outside the valid range for the specified scheduling policy. .Xr sched_yield 2 .Sh STANDARDS The -.Fn sched_setscheduler +.Fn sched_setscheduler and .Fn sched_getscheduler functions conform to diff --git a/lib/libc/sys/sched_yield.2 b/lib/libc/sys/sched_yield.2 index ed886c7..ee5c123 100644 --- a/lib/libc/sys/sched_yield.2 +++ b/lib/libc/sys/sched_yield.2 @@ -41,7 +41,7 @@ The function forces the running process to relinquish the processor until it again becomes the head of its process list. It takes no arguments. .Sh RETURN VALUES -The +The .Fn sched_yield function will return zero if it completes successfully, or it will return a value of -1 and set @@ -57,6 +57,6 @@ The system is not configured to support this functionality. .El .Sh STANDARDS The -.Fn sched_yield +.Fn sched_yield function conforms to .St -p1003.1b-93 . diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 058041f..9837eb5 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -110,7 +110,7 @@ is a non-nil pointer, it specifies the maximum interval to wait for the selection to complete. System activity can lengthen the interval by an indeterminate amount. .Pp -If +If .Fa timeout is a nil pointer, the select blocks indefinitely. .Pp @@ -168,7 +168,7 @@ was invalid. The default size of .Dv FD_SETSIZE is currently 1024. -In order to accommodate programs which might potentially +In order to accommodate programs which might potentially use a larger number of open files with .Fn select , it is possible @@ -179,14 +179,14 @@ before the inclusion of any header which includes .Pp If .Fa nfds -is greater than the number of open files, +is greater than the number of open files, .Fn select is not guaranteed to examine the unused file descriptors. For historical -reasons, +reasons, .Fn select will always examine the first 256 descriptors. .Sh BUGS -.St -susv2 +.St -susv2 allows systems to modify the original timeout in place. Thus, it is unwise to assume that the timeout value will be unmodified by the diff --git a/lib/libc/sys/semctl.2 b/lib/libc/sys/semctl.2 index 4446586..2b3df68 100644 --- a/lib/libc/sys/semctl.2 +++ b/lib/libc/sys/semctl.2 @@ -47,7 +47,7 @@ on the semaphore set indicated by .Fa semid . A fourth argument, a .Fa "union semun arg" , -is required for certain values of +is required for certain values of .Fa cmd . For the commands that use the .Fa arg diff --git a/lib/libc/sys/semop.2 b/lib/libc/sys/semop.2 index b029d3a..3ead1dc 100644 --- a/lib/libc/sys/semop.2 +++ b/lib/libc/sys/semop.2 @@ -152,7 +152,7 @@ When is zero, the process waits for the semaphore's value to become zero. If it is already zero, the call to .Fn semop -can return immediately. Otherwise, the calling process is put to +can return immediately. Otherwise, the calling process is put to sleep until the semaphore's value becomes zero. .El .Pp diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2 index f5749ee..6929ff1 100644 --- a/lib/libc/sys/send.2 +++ b/lib/libc/sys/send.2 @@ -58,9 +58,9 @@ and .Fn sendmsg are used to transmit a message to another socket. .Fn Send -may be used only when the socket is in a +may be used only when the socket is in a .Em connected -state, while +state, while .Fn sendto and .Fn sendmsg @@ -68,7 +68,7 @@ may be used at any time. .Pp The address of the target is given by .Fa to -with +with .Fa tolen specifying its size. The length of the message is given by @@ -130,7 +130,7 @@ protocol family, and is used to implement Transaction .Dv MSG_DONTROUTE is usually used only by diagnostic or routing programs. .Pp -See +See .Xr recv 2 for a description of the .Fa msghdr @@ -148,7 +148,7 @@ fail if: .It Bq Er EBADF An invalid descriptor was specified. .It Bq Er EACCES -The destination address is a broadcast address, and +The destination address is a broadcast address, and .Dv SO_BROADCAST has not been set on the socket. .It Bq Er ENOTSOCK diff --git a/lib/libc/sys/setgroups.2 b/lib/libc/sys/setgroups.2 index 0974f93..668b3dc 100644 --- a/lib/libc/sys/setgroups.2 +++ b/lib/libc/sys/setgroups.2 @@ -48,7 +48,7 @@ .Sh DESCRIPTION .Fn Setgroups sets the group access list of the current user process -according to the array +according to the array .Fa gidset . The parameter .Fa ngroups diff --git a/lib/libc/sys/setpgid.2 b/lib/libc/sys/setpgid.2 index c5c8cec..d9178b5 100644 --- a/lib/libc/sys/setpgid.2 +++ b/lib/libc/sys/setpgid.2 @@ -82,7 +82,7 @@ of the calling process. .Sh STANDARDS The .Fn setpgid -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh COMPATIBILITY .Fn Setpgrp diff --git a/lib/libc/sys/setreuid.2 b/lib/libc/sys/setreuid.2 index 102d32b..aa87657 100644 --- a/lib/libc/sys/setreuid.2 +++ b/lib/libc/sys/setreuid.2 @@ -49,7 +49,7 @@ The real and effective user IDs of the current process are set according to the arguments. If .Fa ruid -or +or .Fa euid is -1, the current uid is filled in by the system. Unprivileged users may change the real user @@ -75,7 +75,7 @@ the standard .Fn setuid function is preferred. .Sh RETURN VALUES -.Rv -std setreuid +.Rv -std setreuid .Sh ERRORS .Bl -tag -width Er .It Bq Er EPERM diff --git a/lib/libc/sys/setuid.2 b/lib/libc/sys/setuid.2 index 9374e93..4ef4d35 100644 --- a/lib/libc/sys/setuid.2 +++ b/lib/libc/sys/setuid.2 @@ -148,7 +148,7 @@ The .Fn seteuid and .Fn setegid -functions are extensions based on the +functions are extensions based on the .Tn POSIX concept of .Li _POSIX_SAVED_IDS , diff --git a/lib/libc/sys/shmat.2 b/lib/libc/sys/shmat.2 index 3c3e40f..6f7dc13 100644 --- a/lib/libc/sys/shmat.2 +++ b/lib/libc/sys/shmat.2 @@ -60,7 +60,7 @@ If is 0, the segment is attached at an address selected by the kernel. .It -If +If .Fa addr is nonzero and SHM_RND is not specified in .Fa flag , diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2 index bf0bb58..b176c53 100644 --- a/lib/libc/sys/shmget.2 +++ b/lib/libc/sys/shmget.2 @@ -134,7 +134,7 @@ corresponding to .Fa key already exists. .El -.Sh "SEE ALSO" +.Sh "SEE ALSO" .Xr shmat 2 , .Xr shmctl 2 , .Xr shmdt 2 , diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index e35469e..1d1c98f 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -58,10 +58,10 @@ struct sigaction { .Sh DESCRIPTION The system defines a set of signals that may be delivered to a process. Signal delivery resembles the occurrence of a hardware interrupt: -the signal is normally blocked from further occurrence, the current process +the signal is normally blocked from further occurrence, the current process context is saved, and a new one is built. A process may specify a .Em handler -to which a signal is delivered, or specify that a signal is to be +to which a signal is delivered, or specify that a signal is to be .Em ignored . A process may also specify that a default action is to be taken by the system when a signal occurs. @@ -80,7 +80,7 @@ Signal routines normally execute with the signal that caused their invocation .Em blocked , but other signals may yet occur. -A global +A global .Em "signal mask" defines the set of signals currently blocked from delivery to a process. The signal mask for a process is initialized @@ -107,7 +107,7 @@ The set of pending signals is returned by the function. When a caught signal is delivered, the current state of the process is saved, -a new signal mask is calculated (as described below), +a new signal mask is calculated (as described below), and the signal handler is invoked. The call to the handler is arranged so that if the signal handling routine returns normally the process will resume execution in the context @@ -121,7 +121,7 @@ installed for the duration of the process' signal handler .Xr sigprocmask call is made). This mask is formed by taking the union of the current signal mask set, -the signal to be delivered, and +the signal to be delivered, and the signal mask associated with the handler to be invoked. .Pp .Fn Sigaction @@ -135,7 +135,7 @@ specifies an action .Dv SIG_IGN , or a handler routine) and mask to be used when delivering the specified signal. -If +If .Fa oact is non-zero, the previous handling information for the signal is returned to the user. @@ -143,7 +143,7 @@ is returned to the user. Once a signal handler is installed, it normally remains installed until another .Fn sigaction -call is made, or an +call is made, or an .Xr execve 2 is performed. A signal-specific default action may be reset by @@ -212,11 +212,11 @@ See paragraph below. If this bit is set, the handler function is assumed to be pointed to by the sa_sigaction member of struct sigaction and should match the prototype shown above or as below in -.Sx EXAMPLES . -This bit should not be set when assigning -.Dv SIG_DFL -or -.Dv SIG_IGN . +.Sx EXAMPLES . +This bit should not be set when assigning +.Dv SIG_DFL +or +.Dv SIG_IGN . .El .Pp If a signal is caught during the system calls listed below, @@ -311,7 +311,7 @@ is possible on a descriptor (see .Sh NOTE The .Fa sa_mask -field specified in +field specified in .Fa act is not allowed to block .Dv SIGKILL @@ -322,7 +322,7 @@ Any attempt to do so will be silently ignored. The following functions are either reentrant or not interruptible by signals and are async-signal safe. Therefore applications may -invoke them, without restriction, from signal-catching functions: +invoke them, without restriction, from signal-catching functions: .Pp Base Interfaces: .Pp @@ -462,14 +462,14 @@ The .Dv sa_handler member declaration in .Fx -include files is that of ANSI C (as required by POSIX), +include files is that of ANSI C (as required by POSIX), so a function pointer of a BSD-style function needs to be casted to compile without warning. The traditional BSD style is not portable and since its capabilities are a full subset of a SA_SIGINFO handler, its use is deprecated. .Pp -The +The .Fa sig argument is the signal number, one of the .Dv SIG... @@ -506,7 +506,7 @@ of the following occurs: .It Bq Er EFAULT Either .Fa act -or +or .Fa oact points to memory that is not a valid part of the process address space. @@ -522,7 +522,7 @@ or .Sh STANDARDS The .Fn sigaction -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . The .Dv SA_ONSTACK diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index 171cafc..d69b34b 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -70,7 +70,7 @@ call), the system checks to see if the process is currently executing on that stack. If the process is not currently executing on the signal stack, the system arranges a switch to the signal stack for the -duration of the signal handler's execution. +duration of the signal handler's execution. .Pp If .Dv SS_DISABLE @@ -134,7 +134,7 @@ If the stack overflows and this space is not protected unpredictable results may occur. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and +Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/sigpending.2 b/lib/libc/sys/sigpending.2 index e05d186..361a918 100644 --- a/lib/libc/sys/sigpending.2 +++ b/lib/libc/sys/sigpending.2 @@ -76,5 +76,5 @@ argument specified an invalid address. .Sh STANDARDS The .Fn sigpending -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2 index 674f453..6325b81 100644 --- a/lib/libc/sys/sigreturn.2 +++ b/lib/libc/sys/sigreturn.2 @@ -89,7 +89,7 @@ This system call is not available in 4.2 hence it should not be used if backward compatibility is needed. .Sh RETURN VALUES If successful, the system call does not return. -Otherwise, a value of -1 is returned and +Otherwise, a value of -1 is returned and .Va errno is set to indicate the error. .Sh ERRORS diff --git a/lib/libc/sys/sigstack.2 b/lib/libc/sys/sigstack.2 index 61f58db..9f1dfa9 100644 --- a/lib/libc/sys/sigstack.2 +++ b/lib/libc/sys/sigstack.2 @@ -41,7 +41,7 @@ .Sh LIBRARY .Lb libc .Sh DESCRIPTION -The +The .Fn sigstack function has been deprecated in favor of the interface described in .Xr sigaltstack 2 . diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2 index b3984be..280d6d9 100644 --- a/lib/libc/sys/sigsuspend.2 +++ b/lib/libc/sys/sigsuspend.2 @@ -78,5 +78,5 @@ set to .Sh STANDARDS The .Fn sigsupend -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . diff --git a/lib/libc/sys/sigwait.2 b/lib/libc/sys/sigwait.2 index 818a623..bd46b1c 100644 --- a/lib/libc/sys/sigwait.2 +++ b/lib/libc/sys/sigwait.2 @@ -1,6 +1,6 @@ .\" Copyright (C) 2000 Jason Evans <jasone@freebsd.org>. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -12,7 +12,7 @@ .\" notice(s), this list of conditions and the following disclaimer in .\" the documentation and/or other materials provided with the .\" distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY .\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .Dd April 27, 2000 .Dt SIGWAIT 3 diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index ef98bf5..ef2669f 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -161,7 +161,7 @@ Once connected, data may be transferred using .Xr read 2 and .Xr write 2 -calls or some variant of the +calls or some variant of the .Xr send 2 and .Xr recv 2 @@ -212,7 +212,7 @@ sockets employ the same system calls as .Dv SOCK_STREAM sockets. The only difference -is that +is that .Xr read 2 calls will return only the amount of data requested, and any remaining in the arriving packet will be discarded. @@ -227,7 +227,7 @@ calls. Datagrams are generally received with .Xr recvfrom 2 , which returns the next datagram with its return address. .Pp -An +An .Xr fcntl 2 call can be used to specify a process group to receive a diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2 index f65c970..9984a1e 100644 --- a/lib/libc/sys/stat.2 +++ b/lib/libc/sys/stat.2 @@ -271,7 +271,7 @@ The .Fn stat and .Fn fstat -function calls are expected to conform to +function calls are expected to conform to .St -p1003.1-90 . .Sh HISTORY A diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2 index 1eb2b05..16e7e16 100644 --- a/lib/libc/sys/swapon.2 +++ b/lib/libc/sys/swapon.2 @@ -46,12 +46,12 @@ .Fn swapon "const char *special" .Sh DESCRIPTION .Fn Swapon -makes the block device +makes the block device .Fa special available to the system for allocation for paging and swapping. The names of potentially available devices are known to the system and defined at system -configuration time. The size of the swap area on +configuration time. The size of the swap area on .Fa special is calculated at the time the device is first made available for swapping. @@ -90,7 +90,7 @@ The device configured by was not configured into the system as a swap device. .It Bq Er ENXIO -The major device number of +The major device number of .Fa special is out of range (this indicates no device driver exists for the associated hardware). diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index f5e112c..d60c0e4 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -45,7 +45,7 @@ .Ft void .Fn sync void .Sh DESCRIPTION -The +The .Fn sync function forces a write of dirty (modified) buffers in the block buffer cache out @@ -58,7 +58,7 @@ call is issued frequently by the user process .Xr syncer 4 -(about every 30 seconds). +(about every 30 seconds). .Pp The function .Xr fsync 2 diff --git a/lib/libc/sys/umask.2 b/lib/libc/sys/umask.2 index 4e7815b..026a983 100644 --- a/lib/libc/sys/umask.2 +++ b/lib/libc/sys/umask.2 @@ -81,7 +81,7 @@ function is always successful. .Sh STANDARDS The .Fn umask -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . .Sh HISTORY An diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2 index fdf893f..84a0a0d 100644 --- a/lib/libc/sys/utimes.2 +++ b/lib/libc/sys/utimes.2 @@ -60,9 +60,9 @@ or referenced by are changed as specified by the argument .Fa times . .Pp -If +If .Fa times -is +is .Dv NULL , the access and modification times are set to the current time. The caller must be the owner of the file, have permission to @@ -71,7 +71,7 @@ write the file, or be the super-user. If .Fa times is -.Pf non- Dv NULL , +.Pf non- Dv NULL , it is assumed to point to an array of two timeval structures. The access time is set to the value of the first element, and the modification time is set to the value of the second element. @@ -120,9 +120,9 @@ An I/O error occurred while reading or writing the affected inode. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er ENAMETOOLONG -A component of a pathname exceeded +A component of a pathname exceeded .Dv NAME_MAX -characters, or an entire path name exceeded +characters, or an entire path name exceeded .Dv PATH_MAX characters. .It Bq Er ENOENT diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index 91a28ee..49e36b6 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -104,7 +104,7 @@ Same as for .Xr fork 2 . .Sh BUGS This system call will be eliminated when proper system sharing -mechanisms are implemented. +mechanisms are implemented. Users should not depend on the memory sharing semantics of .Xr vfork 2 diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index 3fa5c2b..bbb2c57 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -63,9 +63,9 @@ function suspends execution of its calling process until .Fa status information is available for a terminated child process, or a signal is received. -On return from a successful +On return from a successful .Fn wait -call, +call, the .Fa status area contains termination information about the process that exited @@ -131,9 +131,9 @@ for stopped processes). When the .Dv WNOHANG option is specified and no processes -wish to report status, +wish to report status, .Fn wait4 -returns a +returns a process id of 0. .Pp diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 255447d..5d4fdc2 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -62,7 +62,7 @@ from the buffer pointed to by .Fa buf . .Fn Writev performs the same action, but gathers the output data -from the +from the .Fa iovcnt buffers specified by the members of the .Fa iov @@ -71,9 +71,9 @@ array: iov[0], iov[1], ..., iov[iovcnt\|-\|1]. performs the same function, but writes to the specified position in the file without modifying the file pointer. .Pp -For +For .Fn writev , -the +the .Fa iovec structure is defined as: .Pp @@ -84,7 +84,7 @@ struct iovec { }; .Ed .Pp -Each +Each .Fa iovec entry specifies the base address and length of an area in memory from which data should be written. @@ -221,7 +221,7 @@ The file was marked for non-blocking I/O, and no data could be written immediately. .El .Pp -In addition, +In addition, .Fn writev may return one of the following errors: .Bl -tag -width Er @@ -269,7 +269,7 @@ The file descriptor is associated with a pipe, socket, or FIFO. .Sh STANDARDS The .Fn write -function call is expected to conform to +function call is expected to conform to .St -p1003.1-90 . The .Fn writev |