diff options
Diffstat (limited to 'lib/libc')
173 files changed, 481 insertions, 481 deletions
diff --git a/lib/libc/compat-43/gethostid.3 b/lib/libc/compat-43/gethostid.3 index 156b4256f302..3139fcc61b29 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 3c485276e9a8..1d1e884c9faa 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 6aa52522cd47..917874648cc2 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 60a45d64ecec..c39e566ce81b 100644 --- a/lib/libc/compat-43/sigsetmask.2 +++ b/lib/libc/compat-43/sigsetmask.2 @@ -54,7 +54,7 @@ This interface is made obsolete by: .Fn Sigsetmask sets the current signal mask. Signals are blocked from delivery if the -corresponding bit in +corresponding bit in .Fa mask is a 1; the macro .Fn sigmask diff --git a/lib/libc/compat-43/sigvec.2 b/lib/libc/compat-43/sigvec.2 index d73fa3f2ef0c..3b6a22bc2044 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 e8f6403c8fdd..6d7e80c309e4 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 74225956f5d7..ea9c3531bc3f 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 efc413c15a75..5c2da2167111 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/gmon/moncontrol.3 b/lib/libc/gmon/moncontrol.3 index f0c925475081..92a76b721b64 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 aad357bef7a4..27b38c7a5892 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 d6743c4e3a34..af0f993f8c07 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 a85ae85c7b5e..6c49cbed4cd4 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 fd9c89e063f3..3c85ade2953e 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 ce319ba37ff4..548d9caece8a 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/isalnum.3 b/lib/libc/locale/isalnum.3 index 4a69ff9b9e25..6b239aab1005 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 80953cde6858..54d7e2064cdd 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 027f79453933..0a67f79ac122 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 680b01ecaa4b..959f8395b254 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 a78a4a226a29..52ee84eb12fb 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 a9452747dfcb..04bbdc79ba2a 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 0a545b8eaa27..b705bf7ea964 100644 --- a/lib/libc/locale/setlocale.3 +++ b/lib/libc/locale/setlocale.3 @@ -280,9 +280,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 337a2051c7ff..f9734e211158 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 ced73497c4e8..b9f6fa9022d2 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 a38ba8205ef7..2b805f01b5ad 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 31aa7d776b9d..559c9e865ae4 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 892fdc64fb77..fb7976bf9c55 100644 --- a/lib/libc/net/gethostbyname.3 +++ b/lib/libc/net/gethostbyname.3 @@ -161,7 +161,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 @@ -200,7 +200,7 @@ parameter. .It Pa /etc/resolv.conf .El .Sh DIAGNOSTICS -Error return status from +Error return status from .Fn gethostbyname , .Fn gethostbyname2 and @@ -235,8 +235,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 @@ -292,7 +292,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 086f4c3de9a7..c28917016f18 100644 --- a/lib/libc/net/getnetent.3 +++ b/lib/libc/net/getnetent.3 @@ -101,7 +101,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 . @@ -149,7 +149,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 22dba9ccc251..a35ced1237ad 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 06b2d5044be2..a5d94f476b68 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 270f3dc10e7c..48f1f53705d2 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 82365484f0eb..c2338fcadd9d 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 5f825c0c93ff..4bc3ed1725fc 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 9dd9e2edb187..9729ee608235 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 0376d9047520..5616de4ec7eb 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/rcmd.3 b/lib/libc/net/rcmd.3 index 899bd9e55d75..3c676cb18f0b 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 e06a5fd7c6ac..32144815e147 100644 --- a/lib/libc/net/resolver.3 +++ b/lib/libc/net/resolver.3 @@ -87,7 +87,7 @@ .Fa "int anslen" .Fc .Ft int -.Fn res_init +.Fn res_init .Fo dn_comp .Fa "const char *exp_dn" .Fa "u_char *comp_dn" @@ -364,5 +364,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 0fcbfe9d8c22..c29b45d9d493 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 fda5f367b184..f566abbfdccb 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 68cf8930935b..4c0dccc94d29 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/regex/re_format.7 b/lib/libc/regex/re_format.7 index b6fb9de0cba7..2b6655cd3bf5 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/getrpcent.3 b/lib/libc/rpc/getrpcent.3 index 208e5d0ea104..efd910571c9b 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 .Fn getrpcent function family. .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/stdio/fgets.3 b/lib/libc/stdio/fgets.3 index c84d6bdd486d..427b88ed52e9 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 f12e0471d03d..9a58668013b6 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 b0355145a388..e1d00409212c 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 bd099abd343c..db69606ba673 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 1f79e4f4eb0d..27fc96902553 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 6627afa802b6..a79219f8e5c8 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 e9fa07972b6f..67179f42c7cf 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 10d79ba8d6e7..3bca0aae6483 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 ed71236223de..f5e534181b5a 100644 --- a/lib/libc/stdio/tmpnam.3 +++ b/lib/libc/stdio/tmpnam.3 @@ -89,7 +89,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 0480a0ba7594..de09a0384241 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 81007969168c..a148f5e992cb 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 4b6dd788b367..663eea6deb94 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 e639b5292af7..a0feb2bf60c3 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 d9d69c1411d7..d0782f3a1e33 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 f80e404c5f6b..589b07f4692d 100644 --- a/lib/libc/stdlib/malloc.3 +++ b/lib/libc/stdlib/malloc.3 @@ -146,7 +146,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, @@ -197,7 +197,7 @@ Consult the source for details on this option. .It V Attempting to allocate zero bytes will return a 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 @@ -236,7 +236,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 @@ -310,8 +310,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 @@ -351,7 +351,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 @@ -449,8 +449,8 @@ Please report any problems to him at .Aq phk@FreeBSD.org . .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 7c09dac0bf92..da4df561f565 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 7ce7156539ca..90a52c66aa56 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 b47ff67b8809..700470063436 100644 --- a/lib/libc/stdlib/rand.3 +++ b/lib/libc/stdlib/rand.3 @@ -79,7 +79,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 daa834568ba5..2b07a204382f 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 urandom 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 9e50e7d612e3..51767705f259 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 58a2160cf750..d11c4f1d6a20 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 @@ -96,7 +96,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 ef9b06f6584d..d0afe0537c9a 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 b6d66f89b59b..7f174347ce25 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 989db255f54e..581212a12907 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 @@ -242,7 +242,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: @@ -317,7 +317,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 cda46cfb18a1..b69cbeea8850 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 4300d1f930b5..a901c257e035 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 54afedf4a196..591edf04bd97 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 ca488fc9423d..c94b18153e87 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 1ec56e6bbd08..d0236586df94 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 0f9919ce29b7..e6c019f11c91 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 c26a6f31721e..f22c89711477 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 297c982ec6c2..945904d5e082 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 770672b4fa1d..0ec1bfdf0a25 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 0de57e1cfbfd..8bb7f168c679 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 0dce177846fd..69d160e38787 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 a5e164748465..4e447c91a277 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 e27c973da812..af5cade2c85b 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 1a934f749db8..c1c9ce9e6e64 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 @@ -197,6 +197,6 @@ manual page was written by .Sh BUGS The value of .Fa iocb->aio_offset -is ignored. Invalid information in +is ignored. 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 3477288bccee..64bc8c9d6dc5 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 333ad82e861b..d59cb8d65e63 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 dcdbab7f6a8d..9dd948773fe3 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 9548db68cb55..d41849802a35 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 7f40e3417a27..d501ae1f25ad 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 d6ca53215549..0bbbd7dbd014 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 1957859f954f..c2a0ae450054 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -128,7 +128,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 @@ -145,7 +145,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 @@ -211,7 +211,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 1ae9bf9f2b38..13b488f4ac20 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 6d9f7642af8c..db1053403b90 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 956168a8ddf4..02e076c869ff 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 e0ebcc11bdb8..9071e0c58165 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 8b023ab4cfb2..a8b920071bf9 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 9329cbc3577d..da0f480a14c4 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 897bc0527cb1..f7bd2e9d6d26 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 ecd6221617e6..c4e13d26af6d 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 73fc8e2c7e51..119bfe149fe5 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 ee438ffb7354..48d2e0e180c4 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 de2bb80d2d55..bec4f1479645 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 aaaf72b0919e..83285167bad5 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 3ae52425a42b..9edf10ba9f82 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 485c06761e05..91bc638cebf0 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 a7cd663a92b2..af79bfa3cd11 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 6197ff5286e0..06aa8c433c9d 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 1eb77410c50f..2bebebbc85c6 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 1047cf7f6024..9db9d51cddf2 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 4f67802b1662..17a4412c21a8 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 9e441510e179..34cba3295805 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 d0262dcdbbd4..3eb0563bc9cb 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 c9e9ba9b62e3..66c00e75b30b 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 e6554cc211ce..bcaa92f21cad 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 01e464c14f68..07baf1c3ebdf 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 e25c5ba437a6..bcd8c1609195 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 af5c85228403..47db8bc57207 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 874a8a6e1816..1347bc0d5bfa 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 5a7c05cb355e..2c2166b44004 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 78cd3be99310..1ee3f3c08ed2 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 FreeBSD .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 1474f637bd63..d03cc4b1cb8b 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 eb07468c07ed..fb6170c22768 100644 --- a/lib/libc/sys/kldload.2 +++ b/lib/libc/sys/kldload.2 @@ -30,7 +30,7 @@ .Os FreeBSD .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 cef9d0aae385..6403ed60a1b6 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 FreeBSD .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 1187f6951bc8..8c3935542441 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 FreeBSD .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 7225358e86ab..4d5ee64209b9 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 db4c2d335953..992319c85814 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 31f43efa049b..21108fe7af40 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 e7cb79908963..3dfe864a84d4 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 5cc0f222240b..f236c9206fed 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 4886d0225c49..e5d6a06b03f0 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 d80c17268abe..265d6d27fb5e 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 9e0e4459c4be..964d3c3755c6 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 aeed3d97db98..2a606cbb68dd 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 2c2c5799a512..faefd3252b3b 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 362a60682da7..6ab9f681f275 100644 --- a/lib/libc/sys/modfind.2 +++ b/lib/libc/sys/modfind.2 @@ -30,7 +30,7 @@ .Os FreeBSD .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 b6682a9b101f..a0c2b1afdafa 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 4403dc5a71f4..7f46d241c839 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 f9a719947cdb..38fda84c9b5c 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 f272a9d583b3..382672e5317b 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 a852365fb2f8..d28edc13d3e5 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 82f6c8a67b25..04d39a3b0775 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 e63f6cff9be9..d8c5cc521efc 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 c91b2d1a5cee..275bdc63be3f 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 75de692e70e8..6fe4a094decc 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 c797b5b0df9a..aa558f35e936 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 f9202cba33ea..4e702c093416 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 31678f597bc0..f69ea1457f78 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 c3a6e75bdabe..8464926c5590 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 517d1dda35b2..9f8915d0ca67 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 ac2e929f8305..103b913d3976 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_setparam 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 43773734ef60..ee25174b27c3 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 6e376b81654f..a5b0b1d437d1 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 41f0af3fc799..f962c623ef41 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 16e6be2111e0..5bc9ac94d571 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 6fa120b3bd27..1892237ba027 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 faf0224b1ef2..87f3ae2df94e 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 1920059f3b12..533854de8b2e 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 43726bbdda65..25af1f4dabb6 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 0db4d2871831..a6585a179c73 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 f50b94c6e69b..a421e4af6a12 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 @@ -70,7 +70,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 e9cccd7e9b60..c62d26af2a3c 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 31408473c659..53d5e079e32c 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 05bc68cf66fe..cddfefe9c792 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 9cefbb65d189..443aec50501c 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -62,10 +62,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. @@ -84,7 +84,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 @@ -111,7 +111,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 @@ -125,7 +125,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 @@ -139,7 +139,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. @@ -147,7 +147,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 @@ -214,11 +214,11 @@ at the moment the signal is delivered. 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, @@ -313,7 +313,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 @@ -324,7 +324,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 @@ -464,14 +464,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... @@ -508,7 +508,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. @@ -524,7 +524,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 b7f8d3a810c7..aeb3cf9f0fa3 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 e05d186587c2..361a91898199 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 c5185fea7ea2..e67c48e24c31 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 4726fd95bca7..317fee656eb1 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 b3984bef60c7..280d6d960861 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/socket.2 b/lib/libc/sys/socket.2 index a3fb618a84fd..eef676e04b7f 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 e611913cc4c9..efeb8f61f44a 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 998d9a462510..7e7eee1c8c2b 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 9e88b6bf2f7d..8af30ddbff98 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 eb6064edc20d..732c78668a97 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 fdf893fd777a..84a0a0dbd20e 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 a532d59522a6..13d8dcf25f86 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 c1c0ed09959c..4a0e6ba1b36b 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 a306cc1cc770..5b76325a4610 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 |