diff options
author | Christian Weisgerber <naddy@cvs.openbsd.org> | 2022-03-31 17:27:33 +0000 |
---|---|---|
committer | Christian Weisgerber <naddy@cvs.openbsd.org> | 2022-03-31 17:27:33 +0000 |
commit | 58a6bdb2eecf165eb39e1ff5a8082c4bd6ec1211 (patch) | |
tree | c631dd0d4ac59c3286cbf5b06d00e840263d40da /lib/libc | |
parent | a7df80ab7071480723f6f681dc3bbfcda8caffb5 (diff) |
man pages: add missing commas between subordinate and main clauses
jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.
ok jmc@
Diffstat (limited to 'lib/libc')
43 files changed, 151 insertions, 151 deletions
diff --git a/lib/libc/asr/asr_run.3 b/lib/libc/asr/asr_run.3 index f9dba304cc1..d9b3282f3b7 100644 --- a/lib/libc/asr/asr_run.3 +++ b/lib/libc/asr/asr_run.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: asr_run.3,v 1.4 2019/10/24 05:57:41 otto Exp $ +.\" $OpenBSD: asr_run.3,v 1.5 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 2012-2014, Eric Faurot <eric@openbsd.org> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: October 24 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt ASR_RUN 3 .Os .Sh NAME @@ -240,7 +240,7 @@ structure contains the address of the DNS server that sent the response, contains the code returned by the server in the DNS response packet, and .Fa ar_count contains the number of answers in the packet. -If a response is received it is placed in a newly allocated buffer +If a response is received, it is placed in a newly allocated buffer and returned as .Fa ar_data member. diff --git a/lib/libc/compat-43/sigvec.3 b/lib/libc/compat-43/sigvec.3 index 1d44d78a725..5ad8e0a0d5d 100644 --- a/lib/libc/compat-43/sigvec.3 +++ b/lib/libc/compat-43/sigvec.3 @@ -25,9 +25,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: sigvec.3,v 1.35 2017/05/29 11:10:29 jmc Exp $ +.\" $OpenBSD: sigvec.3,v 1.36 2022/03/31 17:27:15 naddy Exp $ .\" -.Dd $Mdocdate: May 29 2017 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SIGVEC 3 .Os .Sh NAME @@ -109,7 +109,7 @@ from before the signal's delivery. If the process wishes to resume in a different context, then it must arrange to restore the previous context itself. .Pp -When a signal is delivered to a process a new signal mask is +When a signal is delivered to a process, a new signal mask is installed for the duration of the process' signal handler (or until a .Xr sigblock 3 diff --git a/lib/libc/db/man/btree.3 b/lib/libc/db/man/btree.3 index aab03d87514..e49f3000596 100644 --- a/lib/libc/db/man/btree.3 +++ b/lib/libc/db/man/btree.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: btree.3,v 1.24 2019/04/23 18:13:11 schwarze Exp $ +.\" $OpenBSD: btree.3,v 1.25 2022/03/31 17:27:15 naddy Exp $ .\" $NetBSD: btree.3,v 1.6 1996/05/03 21:26:48 cgd Exp $ .\" .\" Copyright (c) 1997, Phillip F Knaack. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)btree.3 8.4 (Berkeley) 8/18/94 .\" -.Dd $Mdocdate: April 23 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt BTREE 3 .Os .Sh NAME @@ -118,7 +118,7 @@ Obviously, using a cache increases (but only increases) the likelihood of corruption or lost data if the system crashes while a tree is being modified. If .Fa cachesize -is 0 (no size is specified) a default cache is used. +is 0 (no size is specified), a default cache is used. .It Fa maxkeypage The maximum number of keys which will be stored on any single page. Not currently implemented. @@ -130,13 +130,13 @@ by the minkeypage value, it will be stored on overflow pages instead of in the page itself. If .Fa minkeypage -is 0 (no minimum number of keys is specified) a value of 2 is used. +is 0 (no minimum number of keys is specified), a value of 2 is used. .It Fa psize Page size is the size (in bytes) of the pages used for nodes in the tree. The minimum page size is 512 bytes and the maximum page size is 64K. If .Fa psize -is 0 (no page size is specified) a page size is chosen based on the +is 0 (no page size is specified), a page size is chosen based on the underlying file system I/O block size. .It Fa compare Compare is the key comparison function. @@ -178,7 +178,7 @@ The number should represent the order as an integer; for example, big endian order would be the number 4,321. If .Fa lorder -is 0 (no order is specified) the current host order is used. +is 0 (no order is specified), the current host order is used. .El .Pp If the file already exists (and the diff --git a/lib/libc/db/man/hash.3 b/lib/libc/db/man/hash.3 index ae162925653..c4246a67903 100644 --- a/lib/libc/db/man/hash.3 +++ b/lib/libc/db/man/hash.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hash.3,v 1.20 2016/05/09 11:13:10 naddy Exp $ +.\" $OpenBSD: hash.3,v 1.21 2022/03/31 17:27:15 naddy Exp $ .\" $NetBSD: hash.3,v 1.6 1996/05/03 21:26:50 cgd Exp $ .\" .\" Copyright (c) 1997, Phillip F Knaack. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)hash.3 8.6 (Berkeley) 8/18/94 .\" -.Dd $Mdocdate: May 9 2016 $ +.Dd $Mdocdate: March 31 2022 $ .Dt HASH 3 .Os .Sh NAME @@ -110,7 +110,7 @@ The number should represent the order as an integer; for example, big endian order would be the number 4,321. If .Fa lorder -is 0 (no order is specified) the current host order is used. +is 0 (no order is specified), the current host order is used. If the file already exists, the specified value is ignored and the value specified when the tree was created is used. .El diff --git a/lib/libc/db/man/recno.3 b/lib/libc/db/man/recno.3 index 2a58f6fc920..ba7e656ab9d 100644 --- a/lib/libc/db/man/recno.3 +++ b/lib/libc/db/man/recno.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: recno.3,v 1.20 2015/09/10 10:20:55 jmc Exp $ +.\" $OpenBSD: recno.3,v 1.21 2022/03/31 17:27:15 naddy Exp $ .\" $NetBSD: recno.3,v 1.6 1996/05/03 21:26:51 cgd Exp $ .\" .\" Copyright (c) 1997, Phillip F Knaack. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)recno.3 8.5 (Berkeley) 8/18/94 .\" -.Dd $Mdocdate: September 10 2015 $ +.Dd $Mdocdate: March 31 2022 $ .Dt RECNO 3 .Os .Sh NAME @@ -118,14 +118,14 @@ This value is advisory, and the access method will allocate more memory rather than fail. If .Fa cachesize -is 0 (no size is specified) a default cache is used. +is 0 (no size is specified), a default cache is used. .It Fa psize The recno access method stores the in-memory copies of its records in a btree. This value is the size (in bytes) of the pages used for nodes in that tree. If .Fa psize -is 0 (no page size is specified) a page size is chosen based on the +is 0 (no page size is specified), a page size is chosen based on the underlying file system I/O block size. See .Xr btree 3 @@ -136,7 +136,7 @@ The number should represent the order as an integer; for example, big endian order would be the number 4,321. If .Fa lorder -is 0 (no order is specified) the current host order is used. +is 0 (no order is specified), the current host order is used. .It Fa reclen The length of a fixed-length record. .It Fa bval diff --git a/lib/libc/gen/auth_subr.3 b/lib/libc/gen/auth_subr.3 index a9834f03e26..c7bd965f944 100644 --- a/lib/libc/gen/auth_subr.3 +++ b/lib/libc/gen/auth_subr.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: auth_subr.3,v 1.25 2021/05/31 19:54:04 millert Exp $ +.\" $OpenBSD: auth_subr.3,v 1.26 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved. .\" @@ -31,7 +31,7 @@ .\" SUCH DAMAGE. .\" .\" BSDI $From: auth_subr.3,v 2.5 2000/03/30 19:11:27 polk Exp $ -.Dd $Mdocdate: May 31 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt AUTH_OPEN 3 .Os .Sh NAME @@ -388,7 +388,7 @@ passed to the login scripts for their possible use. .It Dv AUTH_INTERACTIVE If set to any value, then the session is tagged as interactive. If not set, the session is not interactive. -When the value is requested it is always either +When the value is requested, it is always either .Dv NULL or .Dq True . @@ -421,7 +421,7 @@ These variables are set by login scripts. When a new login script is run (by the .Fn auth_call -function) +function), the values from the previous login script are lost. (See .Xr login.conf 5 @@ -519,7 +519,7 @@ If no entry has been saved (either explicitly via or implicitly via .Fn auth_check_expire or -.Fn auth_check_change ) +.Fn auth_check_change ) , it returns .Dv NULL . Note that the memory containing the password file entry is freed by diff --git a/lib/libc/gen/authenticate.3 b/lib/libc/gen/authenticate.3 index c83b190540c..e8b8a68be6f 100644 --- a/lib/libc/gen/authenticate.3 +++ b/lib/libc/gen/authenticate.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: authenticate.3,v 1.18 2016/03/30 06:58:06 jmc Exp $ +.\" $OpenBSD: authenticate.3,v 1.19 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved. .\" @@ -31,7 +31,7 @@ .\" SUCH DAMAGE. .\" .\" BSDI $From: authenticate.3,v 2.7 1998/09/03 20:27:20 prb Exp $ -.Dd $Mdocdate: March 30 2016 $ +.Dd $Mdocdate: March 31 2022 $ .Dt AUTH_APPROVAL 3 .Os .Sh NAME @@ -249,7 +249,7 @@ If the class does not have the field .Dq ignorenologin and the file .Pa /etc/nologin -exists its contents will be copied to standard output and +exists, its contents will be copied to standard output and .Xr exit 3 will be called with a value of 1. .Pp diff --git a/lib/libc/gen/cgetent.3 b/lib/libc/gen/cgetent.3 index 76cb4c889f5..4932746f5fa 100644 --- a/lib/libc/gen/cgetent.3 +++ b/lib/libc/gen/cgetent.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: cgetent.3,v 1.2 2021/02/02 07:33:29 jmc Exp $ +.\" $OpenBSD: cgetent.3,v 1.3 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. @@ -30,7 +30,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: February 2 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt CGETENT 3 .Os .Sh NAME @@ -456,7 +456,7 @@ Numeric capability values may be given in one of three numeric bases. If the number starts with either .Ql 0x or -.Ql 0X +.Ql 0X , it is interpreted as a hexadecimal number (both upper and lower case a-f may be used to denote the extended hexadecimal digits). Otherwise, if the number starts with a diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3 index 727b4b0345c..d6114de1c99 100644 --- a/lib/libc/gen/getdomainname.3 +++ b/lib/libc/gen/getdomainname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getdomainname.3,v 1.26 2018/01/12 04:36:44 deraadt Exp $ +.\" $OpenBSD: getdomainname.3,v 1.27 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: January 12 2018 $ +.Dd $Mdocdate: March 31 2022 $ .Dt GETDOMAINNAME 3 .Os .Sh NAME @@ -62,7 +62,7 @@ which has length This call is restricted to the superuser and is normally used only when the system is bootstrapped. .Sh RETURN VALUES -If the call succeeds a value of 0 is returned. +If the call succeeds, a value of 0 is returned. If the call fails, a value of \-1 is returned and an error code is placed in the global variable .Va errno . diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3 index 9c267f10bfd..1f30f15fc57 100644 --- a/lib/libc/gen/gethostname.3 +++ b/lib/libc/gen/gethostname.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gethostname.3,v 1.28 2018/01/12 04:36:44 deraadt Exp $ +.\" $OpenBSD: gethostname.3,v 1.29 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: January 12 2018 $ +.Dd $Mdocdate: March 31 2022 $ .Dt GETHOSTNAME 3 .Os .Sh NAME @@ -63,7 +63,7 @@ which has length This call is restricted to the superuser and is normally used only when the system is bootstrapped. .Sh RETURN VALUES -If the call succeeds a value of 0 is returned. +If the call succeeds, a value of 0 is returned. If the call fails, a value of \-1 is returned and an error code is placed in the global variable .Va errno . diff --git a/lib/libc/gen/sleep.3 b/lib/libc/gen/sleep.3 index ac6bec387da..e51e7b62899 100644 --- a/lib/libc/gen/sleep.3 +++ b/lib/libc/gen/sleep.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sleep.3,v 1.17 2021/12/07 03:16:08 cheloha Exp $ +.\" $OpenBSD: sleep.3,v 1.18 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1986, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: December 7 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SLEEP 3 .Os .Sh NAME @@ -59,7 +59,7 @@ for the interrupting signal. If .Fn sleep sleeps for the full count of -.Fa seconds +.Fa seconds , it returns 0. Otherwise, .Fn sleep diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index a6d48715dc9..da1382a8982 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: syslog.3,v 1.36 2020/02/05 12:35:19 schwarze Exp $ +.\" $OpenBSD: syslog.3,v 1.37 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: February 5 2020 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SYSLOG 3 .Os .Sh NAME @@ -233,7 +233,7 @@ one or more of the following values: If .Fn syslog cannot pass the message to -.Xr syslogd 8 +.Xr syslogd 8 , it will attempt to write the message to the console .Pq Pa /dev/console . .It Dv LOG_NDELAY diff --git a/lib/libc/hash/MD5Init.3 b/lib/libc/hash/MD5Init.3 index 3cfca64c3b9..fa8d9fadf91 100644 --- a/lib/libc/hash/MD5Init.3 +++ b/lib/libc/hash/MD5Init.3 @@ -16,9 +16,9 @@ .\" If we meet some day, and you think this stuff is worth it, you .\" can buy me a beer in return. Poul-Henning Kamp .\" -.\" $OpenBSD: MD5Init.3,v 1.2 2019/12/05 21:45:05 jmc Exp $ +.\" $OpenBSD: MD5Init.3,v 1.3 2022/03/31 17:27:15 naddy Exp $ .\" -.Dd $Mdocdate: December 5 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt MD5INIT 3 .Os .Sh NAME @@ -157,7 +157,7 @@ and subsequently must be explicitly deallocated using after use. If the .Ar buf -argument is non-null it must point to at least MD5_DIGEST_STRING_LENGTH +argument is non-null, it must point to at least MD5_DIGEST_STRING_LENGTH characters of buffer space. .Sh SEE ALSO .Xr cksum 1 , diff --git a/lib/libc/hash/RMD160Init.3 b/lib/libc/hash/RMD160Init.3 index e6349e1d3c9..c3afa488ca7 100644 --- a/lib/libc/hash/RMD160Init.3 +++ b/lib/libc/hash/RMD160Init.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: RMD160Init.3,v 1.2 2019/12/05 21:45:05 jmc Exp $ +.\" $OpenBSD: RMD160Init.3,v 1.3 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1997, 2004 Todd C. Miller <millert@openbsd.org> .\" @@ -17,7 +17,7 @@ .\" See http://www.esat.kuleuven.ac.be/~bosselae/ripemd160.html .\" for detailed information about RIPEMD-160. .\" -.Dd $Mdocdate: December 5 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt RMD160INIT 3 .Os .Sh NAME @@ -125,7 +125,7 @@ function calculates the digest for a file and returns the result via .Fn RMD160End . If .Fn RMD160File -is unable to open the file a NULL pointer is returned. +is unable to open the file, a NULL pointer is returned. .Pp .Fn RMD160FileChunk behaves like diff --git a/lib/libc/hash/SHA1Init.3 b/lib/libc/hash/SHA1Init.3 index 723ccfb4e01..f604e6c1e7e 100644 --- a/lib/libc/hash/SHA1Init.3 +++ b/lib/libc/hash/SHA1Init.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: SHA1Init.3,v 1.2 2019/12/05 21:45:05 jmc Exp $ +.\" $OpenBSD: SHA1Init.3,v 1.3 2022/03/31 17:27:15 naddy Exp $ .\" .\" Copyright (c) 1997, 2004 Todd C. Miller <millert@openbsd.org> .\" @@ -17,7 +17,7 @@ .\" See http://csrc.nist.gov/publications/fips/fips180-1/fip180-1.txt .\" for the detailed standard .\" -.Dd $Mdocdate: December 5 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SHA1INIT 3 .Os .Sh NAME @@ -126,7 +126,7 @@ function calculates the digest for a file and returns the result via .Fn SHA1End . If .Fn SHA1File -is unable to open the file a +is unable to open the file, a .Dv NULL pointer is returned. .Pp diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index de46e70182b..035db2780b5 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getaddrinfo.3,v 1.59 2019/08/30 20:20:50 jmc Exp $ +.\" $OpenBSD: getaddrinfo.3,v 1.60 2022/03/31 17:27:16 naddy Exp $ .\" $KAME: getaddrinfo.3,v 1.36 2005/01/05 03:23:05 itojun Exp $ .\" .\" Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") @@ -16,7 +16,7 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: August 30 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt GETADDRINFO 3 .Os .Sh NAME @@ -105,7 +105,7 @@ or .Dv SOCK_RAW . When .Fa ai_socktype -is zero the caller will accept any socket type. +is zero, the caller will accept any socket type. .It Fa ai_protocol Indicates which transport protocol is desired, .Dv IPPROTO_UDP @@ -113,7 +113,7 @@ or .Dv IPPROTO_TCP . If .Fa ai_protocol -is zero the caller will accept any protocol. +is zero, the caller will accept any protocol. .It Fa ai_flags .Fa ai_flags is formed by @@ -180,7 +180,7 @@ and no service name resolution should be attempted. .It Dv AI_PASSIVE If the .Dv AI_PASSIVE -bit is set it indicates that the returned socket address structure +bit is set, it indicates that the returned socket address structure is intended for use in a call to .Xr bind 2 . In this case, if the diff --git a/lib/libc/net/inet6_opt_init.3 b/lib/libc/net/inet6_opt_init.3 index fb4253aa2c7..41ba842166b 100644 --- a/lib/libc/net/inet6_opt_init.3 +++ b/lib/libc/net/inet6_opt_init.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: inet6_opt_init.3,v 1.7 2022/03/29 18:15:52 naddy Exp $ +.\" $OpenBSD: inet6_opt_init.3,v 1.8 2022/03/31 17:27:16 naddy Exp $ .\" $KAME: inet6_opt_init.3,v 1.7 2004/12/27 05:08:23 itojun Exp $ .\" .\" Copyright (C) 2004 WIDE Project. @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: March 29 2022 $ +.Dd $Mdocdate: March 31 2022 $ .Dt INET6_OPT_INIT 3 .Os .\" @@ -97,7 +97,7 @@ The function can perform different jobs. When a valid .Fa extbuf -argument is supplied it appends an option to the extension buffer and +argument is supplied, it appends an option to the extension buffer and returns the updated total length as well as a pointer to the newly created option in .Fa databufp . @@ -173,7 +173,7 @@ or When .Fa extbuf is not -.Dv NULL +.Dv NULL , the function also sets up the appropriate padding bytes by inserting a Pad1 or PadN option of the proper length. .Pp @@ -238,7 +238,7 @@ and point to the 8-bit option type, the 8-bit option length and the option data respectively. This function does not return any PAD1 or PADN options. -When an error occurs or there are no more options the return +When an error occurs or there are no more options, the return value is \-1. .\" .Ss inet6_opt_find diff --git a/lib/libc/net/inet6_rth_space.3 b/lib/libc/net/inet6_rth_space.3 index fd69da24556..c40b45057e3 100644 --- a/lib/libc/net/inet6_rth_space.3 +++ b/lib/libc/net/inet6_rth_space.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: inet6_rth_space.3,v 1.7 2014/06/11 16:59:47 chrisz Exp $ +.\" $OpenBSD: inet6_rth_space.3,v 1.8 2022/03/31 17:27:16 naddy Exp $ .\" $KAME: inet6_rth_space.3,v 1.7 2005/01/05 03:00:44 itojun Exp $ .\" .\" Copyright (C) 2004 WIDE Project. @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: June 11 2014 $ +.Dd $Mdocdate: March 31 2022 $ .Dt INET6_RTH_SPACE 3 .Os .\" @@ -85,7 +85,7 @@ argument and containing the number of addresses specified in the .Fa segments argument. When the type is -.Dv IPV6_RTHDR_TYPE_0 +.Dv IPV6_RTHDR_TYPE_0 , the number of segments must be from 0 through 127. The return value from this function is the number of bytes required to store the routing header. diff --git a/lib/libc/net/inet_net_ntop.3 b/lib/libc/net/inet_net_ntop.3 index 816e87bf986..cac234be42c 100644 --- a/lib/libc/net/inet_net_ntop.3 +++ b/lib/libc/net/inet_net_ntop.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: inet_net_ntop.3,v 1.2 2021/09/01 15:59:22 claudio Exp $ +.\" $OpenBSD: inet_net_ntop.3,v 1.3 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: inet_net.3,v 1.1 1997/06/18 02:25:27 lukem Exp $ .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. @@ -28,7 +28,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: September 1 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt INET_NET_NTOP 3 .Os .Sh NAME @@ -110,7 +110,7 @@ is in the range and is used to explicitly specify the number of bits in the network address. When .Dq Li /bits -is not specified the number of bits in the network address is calculated +is not specified, the number of bits in the network address is calculated as the larger of the number of bits in the class to which the address belongs and the number of bits provided rounded up modulo 8. Examples: @@ -176,7 +176,7 @@ is in the range and is used to explicitly specify the number of bits in the network address. When .Dq Li /bits -is not specified 128 is used. +is not specified, 128 is used. Note that when the number of bits is specified using .Dq Li /bits notation, the value of the address still includes all bits supplied diff --git a/lib/libc/stdio/mktemp.3 b/lib/libc/stdio/mktemp.3 index decc165d32c..572e95dc4f7 100644 --- a/lib/libc/stdio/mktemp.3 +++ b/lib/libc/stdio/mktemp.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mktemp.3,v 1.54 2014/10/26 12:54:18 millert Exp $ +.\" $OpenBSD: mktemp.3,v 1.55 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: October 26 2014 $ +.Dd $Mdocdate: March 31 2022 $ .Dt MKTEMP 3 .Os .Sh NAME @@ -83,7 +83,7 @@ function generates a temporary file name based on a template as described above. Because .Fn mktemp -does not actually create the temporary file there is a window of +does not actually create the temporary file, there is a window of opportunity during which another process can open the file instead. Because of this race condition, .Fn mktemp diff --git a/lib/libc/stdio/scanf.3 b/lib/libc/stdio/scanf.3 index 59730e3feb9..5383f904925 100644 --- a/lib/libc/stdio/scanf.3 +++ b/lib/libc/stdio/scanf.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: scanf.3,v 1.25 2019/08/30 20:27:25 jmc Exp $ +.\" $OpenBSD: scanf.3,v 1.26 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -31,7 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: August 30 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SCANF 3 .Os .Sh NAME @@ -164,7 +164,7 @@ or that the conversion will be one of .Cm sc[ . .Pp If the conversion is one of -.Cm sc[ +.Cm sc[ , the expected conversion input is a multibyte character sequence. Each multibyte character in the sequence is converted with a call to the .Fn mbrtowc diff --git a/lib/libc/stdio/wprintf.3 b/lib/libc/stdio/wprintf.3 index 96c99f6aa23..05ed0842640 100644 --- a/lib/libc/stdio/wprintf.3 +++ b/lib/libc/stdio/wprintf.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: wprintf.3,v 1.9 2021/09/02 09:50:38 deraadt Exp $ +.\" $OpenBSD: wprintf.3,v 1.10 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -33,7 +33,7 @@ .\" .\" @(#)printf.3 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: September 2 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt WPRINTF 3 .Os .Sh NAME @@ -151,7 +151,7 @@ argument accessed will be used. Arguments are numbered starting at .Cm 1 . If unaccessed arguments in the format string are interspersed with ones that -are accessed the results will be indeterminate. +are accessed, the results will be indeterminate. .It Zero or more of the following flags: .Bl -tag -width "'0' (space)" diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3 index dc3e691ece2..9bd498ab50d 100644 --- a/lib/libc/stdlib/malloc.3 +++ b/lib/libc/stdlib/malloc.3 @@ -30,9 +30,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: malloc.3,v 1.128 2021/04/09 06:04:15 otto Exp $ +.\" $OpenBSD: malloc.3,v 1.129 2022/03/31 17:27:16 naddy Exp $ .\" -.Dd $Mdocdate: April 9 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt MALLOC 3 .Os .Sh NAME @@ -423,7 +423,7 @@ and multiplying .Fa oldnmemb and .Fa size -results in integer overflow +results in integer overflow, .Fn recallocarray returns .Dv NULL @@ -610,7 +610,7 @@ Here is a brief description of the error messages and what they mean: .It Dq out of memory If the .Cm X -option is specified it is an error for the allocation functions +option is specified, it is an error for the allocation functions to return .Dv NULL . .It Dq bogus pointer (double free?) diff --git a/lib/libc/stdlib/tsearch.3 b/lib/libc/stdlib/tsearch.3 index cd904356148..a7ab9850130 100644 --- a/lib/libc/stdlib/tsearch.3 +++ b/lib/libc/stdlib/tsearch.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tsearch.3,v 1.21 2019/01/25 00:19:25 millert Exp $ +.\" $OpenBSD: tsearch.3,v 1.22 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1997 Todd C. Miller <millert@openbsd.org> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: January 25 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt TSEARCH 3 .Os .Sh NAME @@ -63,7 +63,7 @@ except that if no match is found, is inserted into the tree and a pointer to it is returned. If .Fa rootp -points to a null value a new binary search tree is created. +points to a null value, a new binary search tree is created. .Pp .Fn tdelete deletes a node from the specified binary search tree and returns diff --git a/lib/libc/sys/bind.2 b/lib/libc/sys/bind.2 index c3bab1ec7dd..a6b5635fab4 100644 --- a/lib/libc/sys/bind.2 +++ b/lib/libc/sys/bind.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bind.2,v 1.22 2021/01/03 18:10:27 rob Exp $ +.\" $OpenBSD: bind.2,v 1.23 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: bind.2,v 1.8 1995/10/12 15:40:46 jtc Exp $ .\" .\" Copyright (c) 1983, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)bind.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: January 3 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt BIND 2 .Os .Sh NAME @@ -44,7 +44,7 @@ .Fn bind assigns a name to an unnamed socket. When a socket is created with -.Xr socket 2 +.Xr socket 2 , it exists in a name space (address family) but has no name assigned. .Fn bind requests that diff --git a/lib/libc/sys/chroot.2 b/lib/libc/sys/chroot.2 index 53ad392601f..d9378c8543c 100644 --- a/lib/libc/sys/chroot.2 +++ b/lib/libc/sys/chroot.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chroot.2,v 1.23 2021/01/03 18:10:27 rob Exp $ +.\" $OpenBSD: chroot.2,v 1.24 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: chroot.2,v 1.7 1995/02/27 12:32:12 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)chroot.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: January 3 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt CHROOT 2 .Os .Sh NAME @@ -50,7 +50,7 @@ to become the root directory, that is, the starting point for path searches of pathnames beginning with .Ql / . .Pp -In order for a directory to become the root directory +In order for a directory to become the root directory, a process must have execute (search) access for that directory. .Pp If the program is not currently running with an altered root directory, diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2 index 796bfd0512d..0ba8a68581d 100644 --- a/lib/libc/sys/clock_gettime.2 +++ b/lib/libc/sys/clock_gettime.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: clock_gettime.2,v 1.31 2020/10/25 00:54:51 cheloha Exp $ +.\" $OpenBSD: clock_gettime.2,v 1.32 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: October 25 2020 $ +.Dd $Mdocdate: March 31 2022 $ .Dt CLOCK_GETTIME 2 .Os .Sh NAME @@ -105,7 +105,7 @@ Only the clock may be set and only the superuser may set it. If the system .Xr securelevel 7 -is 2 or greater the time may only be advanced. +is 2 or greater, the time may only be advanced. This limitation is imposed to prevent a malicious superuser from setting arbitrary timestamps on files. .Pp diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2 index f4e57c3afc5..0aaa5c7691c 100644 --- a/lib/libc/sys/execve.2 +++ b/lib/libc/sys/execve.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: execve.2,v 1.55 2021/06/30 18:46:49 schwarze Exp $ +.\" $OpenBSD: execve.2,v 1.56 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: execve.2,v 1.9 1995/02/27 12:32:25 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)execve.2 8.3 (Berkeley) 1/24/94 .\" -.Dd $Mdocdate: June 30 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt EXECVE 2 .Os .Sh NAME @@ -65,7 +65,7 @@ An interpreter file begins with a line of the form: .Ed .Pp When an interpreter file is passed to -.Fn execve +.Fn execve , the system instead calls .Fn execve with the specified @@ -225,11 +225,11 @@ to the arguments themselves. As the .Fn execve function overlays the current process image -with a new process image the successful call +with a new process image, the successful call has no process to return to. If .Fn execve -does return to the calling process an error has occurred; the +does return to the calling process, an error has occurred; the return value will be \-1 and the global variable .Va errno is set to indicate the error. diff --git a/lib/libc/sys/getsockname.2 b/lib/libc/sys/getsockname.2 index 21b24ed2a0c..67b9aa48e85 100644 --- a/lib/libc/sys/getsockname.2 +++ b/lib/libc/sys/getsockname.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsockname.2,v 1.30 2015/09/10 17:55:21 schwarze Exp $ +.\" $OpenBSD: getsockname.2,v 1.31 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: getsockname.2,v 1.6 1995/10/12 15:41:00 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)getsockname.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: September 10 2015 $ +.Dd $Mdocdate: March 31 2022 $ .Dt GETSOCKNAME 2 .Os .Sh NAME @@ -50,7 +50,7 @@ Common uses of this function are as follows: When .Xr bind 2 is called with a port number of 0 (indicating the kernel should pick -an ephemeral port) +an ephemeral port), .Fn getsockname is used to retrieve the kernel-assigned port number. .It diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index 07369b1aa1c..8ed6136dbff 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getsockopt.2,v 1.58 2021/10/08 14:12:58 jmc Exp $ +.\" $OpenBSD: getsockopt.2,v 1.59 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: getsockopt.2,v 1.7 1995/02/27 12:33:29 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)getsockopt.2 8.3 (Berkeley) 4/19/94 .\" -.Dd $Mdocdate: October 8 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt GETSOCKOPT 2 .Os .Sh NAME @@ -55,7 +55,7 @@ they are always present at the uppermost .Dq socket level. .Pp -When manipulating socket options the level at which the +When manipulating socket options, the level at which the option resides and the name of the option must be specified. To manipulate options at the socket level, .Fa level diff --git a/lib/libc/sys/gettimeofday.2 b/lib/libc/sys/gettimeofday.2 index 33e6d27547d..24a4ca49920 100644 --- a/lib/libc/sys/gettimeofday.2 +++ b/lib/libc/sys/gettimeofday.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gettimeofday.2,v 1.32 2021/12/06 02:48:55 cheloha Exp $ +.\" $OpenBSD: gettimeofday.2,v 1.33 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\" .\" @(#)gettimeofday.2 8.2 (Berkeley) 5/26/95 .\" -.Dd $Mdocdate: December 6 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt GETTIMEOFDAY 2 .Os .Sh NAME @@ -81,7 +81,7 @@ is Only the superuser may set the clock. If the system .Xr securelevel 7 -is 2 or greater the clock may only be advanced. +is 2 or greater, the clock may only be advanced. This limitation prevents a malicious superuser from setting arbitrary timestamps on files. Setting the clock cancels any ongoing diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 7d69a2d420f..f358d13afed 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kqueue.2,v 1.45 2021/11/21 23:44:55 jan Exp $ +.\" $OpenBSD: kqueue.2,v 1.46 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 2000 Jonathan Lemon .\" All rights reserved. @@ -26,7 +26,7 @@ .\" .\" $FreeBSD: src/lib/libc/sys/kqueue.2,v 1.18 2001/02/14 08:48:35 guido Exp $ .\" -.Dd $Mdocdate: November 21 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt KQUEUE 2 .Os .Sh NAME @@ -206,7 +206,7 @@ Causes to return with .Dv EV_ERROR set without draining any pending events after updating events in the kqueue. -When a filter is successfully added the +When a filter is successfully added, the .Fa data field will be zero. This flag is useful for making bulk changes to a kqueue. diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index 69b05e7e185..2fb45c15316 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mmap.2,v 1.67 2021/06/30 18:46:49 schwarze Exp $ +.\" $OpenBSD: mmap.2,v 1.68 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: mmap.2,v 1.5 1995/06/24 10:48:59 cgd Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)mmap.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: June 30 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt MMAP 2 .Os .Sh NAME @@ -66,7 +66,7 @@ failing that it will be placed "close by". If .Fa addr is -.Dv NULL +.Dv NULL , the system can pick any address. Except for .Dv MAP_FIXED diff --git a/lib/libc/sys/mquery.2 b/lib/libc/sys/mquery.2 index ba87270f8c0..7da8cda279e 100644 --- a/lib/libc/sys/mquery.2 +++ b/lib/libc/sys/mquery.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mquery.2,v 1.12 2021/01/20 19:44:48 otto Exp $ +.\" $OpenBSD: mquery.2,v 1.13 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 2003 Artur Grabowski <art@openbsd.org> .\" All rights reserved. @@ -23,7 +23,7 @@ .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: January 20 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt MQUERY 2 .Os .Sh NAME @@ -63,7 +63,7 @@ The behavior of the function depends on the .Fa flags argument. If set to -.Dv MAP_FIXED +.Dv MAP_FIXED , the pointer .Fa addr is used as a fixed hint and @@ -78,7 +78,7 @@ if there is not .Fa size bytes free after that address. Otherwise it will return the hint addr. -If no flags are set +If no flags are set, .Fn mquery will use .Fa addr @@ -91,7 +91,7 @@ file and offset specified in the and .Fa off arguments. -When no such area can be found +When no such area can be found, .Fn mquery will return .Dv MAP_FAILED @@ -99,7 +99,7 @@ and set .Va errno to indicate the error. .Sh RETURN VALUES -When a memory range satisfying the request is found +When a memory range satisfying the request is found, .Fn mquery returns the available address. Otherwise, diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2 index 53cdabd2048..50e273b2888 100644 --- a/lib/libc/sys/nanosleep.2 +++ b/lib/libc/sys/nanosleep.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nanosleep.2,v 1.18 2021/07/25 15:47:26 cheloha Exp $ +.\" $OpenBSD: nanosleep.2,v 1.19 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: nanosleep.2,v 1.1 1997/04/17 18:12:02 jtc Exp $ .\" .\" Copyright (c) 1986, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)sleep.3 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: July 25 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt NANOSLEEP 2 .Os .Sh NAME @@ -56,7 +56,7 @@ If .Fn nanosleep sleeps the full .Fa timeout -without interruption it returns 0. +without interruption, it returns 0. Unless .Fa remainder is @@ -65,7 +65,7 @@ it is set to zero. .Pp If .Fn nanosleep -is interrupted by a signal it returns \-1 and the global variable +is interrupted by a signal, it returns \-1 and the global variable .Va errno is set to .Dv EINTR . diff --git a/lib/libc/sys/open.2 b/lib/libc/sys/open.2 index a7fa1ba24e3..c8e056bbd92 100644 --- a/lib/libc/sys/open.2 +++ b/lib/libc/sys/open.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: open.2,v 1.50 2021/01/03 18:10:27 rob Exp $ +.\" $OpenBSD: open.2,v 1.51 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: open.2,v 1.8 1995/02/27 12:35:14 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)open.2 8.2 (Berkeley) 11/16/93 .\" -.Dd $Mdocdate: January 3 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt OPEN 2 .Os .Sh NAME @@ -183,7 +183,7 @@ If is successful, the file pointer used to mark the current position within the file is set to the beginning of the file. .Pp -When a new file is created it is given the group of the directory +When a new file is created, it is given the group of the directory which contains it. .Pp The new descriptor is set to remain open across diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 55c4448382e..39f9baa0d11 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -1,8 +1,8 @@ -.\" $OpenBSD: ptrace.2,v 1.41 2021/11/21 23:44:55 jan Exp $ +.\" $OpenBSD: ptrace.2,v 1.42 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: ptrace.2,v 1.3 1996/02/23 01:39:41 jtc Exp $ .\" .\" This file is in the public domain. -.Dd $Mdocdate: November 21 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt PTRACE 2 .Os .Sh NAME @@ -231,7 +231,7 @@ On return the .Fa piod_len field in the descriptor will be updated with the actual number of bytes transferred. -If the requested I/O couldn't be successfully performed +If the requested I/O could not be successfully performed, .Fn ptrace will return .Li -1 diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index 9bd262001fa..5b318968fa6 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaction.2,v 1.75 2018/02/27 03:29:50 schwarze Exp $ +.\" $OpenBSD: sigaction.2,v 1.76 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)sigaction.2 8.2 (Berkeley) 4/3/94 .\" -.Dd $Mdocdate: February 27 2018 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SIGACTION 2 .Os .Sh NAME @@ -116,7 +116,7 @@ before the signal's delivery. If the process wishes to resume in a different context, then it must arrange to restore the previous context itself. .Pp -When a signal is delivered to a process a new signal mask is +When a signal is delivered to a process, a new signal mask is installed for the duration of the process' signal handler (or until a .Xr sigprocmask 2 diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2 index 2b6ce203287..eedefac9b07 100644 --- a/lib/libc/sys/sigaltstack.2 +++ b/lib/libc/sys/sigaltstack.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaltstack.2,v 1.24 2021/11/21 23:44:55 jan Exp $ +.\" $OpenBSD: sigaltstack.2,v 1.25 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: sigaltstack.2,v 1.3 1995/02/27 10:41:52 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1992, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)sigaltstack.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: November 21 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SIGALTSTACK 2 .Os .Sh NAME @@ -136,7 +136,7 @@ Signal stacks may or may not be protected by the hardware and are not .Dq grown automatically as is done for the normal stack. -If the stack overflows and this space is not protected +If the stack overflows and this space is not protected, unpredictable results may occur. .Sh RETURN VALUES .Rv -std diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index 5fc2194e742..89848869c92 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: socket.2,v 1.43 2019/05/26 09:47:28 krw Exp $ +.\" $OpenBSD: socket.2,v 1.44 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: socket.2,v 1.5 1995/02/27 12:37:53 cgd Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)socket.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: May 26 2019 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SOCKET 2 .Os .Sh NAME @@ -152,7 +152,7 @@ calls or some variant of the and .Xr recv 2 calls. -When a session has been completed a +When a session has been completed, a .Xr close 2 may be performed. Out-of-band data may also be transmitted as described in diff --git a/lib/libc/sys/sync.2 b/lib/libc/sys/sync.2 index f2eca1f7136..91e6851be84 100644 --- a/lib/libc/sys/sync.2 +++ b/lib/libc/sys/sync.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sync.2,v 1.16 2016/01/09 21:27:28 mmcc Exp $ +.\" $OpenBSD: sync.2,v 1.17 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: sync.2,v 1.4 1995/02/27 12:38:41 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)sync.2 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: January 9 2016 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SYNC 2 .Os .Sh NAME @@ -47,7 +47,7 @@ function forces a write of dirty (modified) buffers in the block buffer cache out to disk. The kernel keeps this information in core to reduce the number of disk I/O transfers required by the system. -As information in the cache is lost after a system crash a +As information in the cache is lost after a system crash, a .Fn sync call is issued frequently by the in-kernel process update (about every 30 seconds). diff --git a/lib/libc/sys/sysctl.2 b/lib/libc/sys/sysctl.2 index 0e0f0a4fb19..0e41e245b82 100644 --- a/lib/libc/sys/sysctl.2 +++ b/lib/libc/sys/sysctl.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sysctl.2,v 1.47 2022/02/19 09:12:09 jsg Exp $ +.\" $OpenBSD: sysctl.2,v 1.48 2022/03/31 17:27:16 naddy Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -27,7 +27,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: February 19 2022 $ +.Dd $Mdocdate: March 31 2022 $ .Dt SYSCTL 2 .Os .Sh NAME @@ -2073,16 +2073,16 @@ Get or set global information about MPLS (Multiprotocol Label Switching). Set or get the default TTL value which is used for MPLS (Shim) Header. The default is 255. .It Dv MPLSCTL_MAPTTL_IP Pq Va net.mpls.mapttl_ip -If set to 1 the TTL field is synchronized between the IP header and the +If set to 1, the TTL field is synchronized between the IP header and the MPLS label stack. -If set to 0 the IP header TTL is not modified while passing through MPLS +If set to 0, the IP header TTL is not modified while passing through MPLS and the MPLS label stack is initialized with the .Dv MPLSCTL_DEFTTL . The default is 1. .It Dv MPLSCTL_MAPTTL_IP6 Pq Va net.mpls.mapttl_ip6 -If set to 1 the TTL field is synchronized between the IPv6 header and the +If set to 1, the TTL field is synchronized between the IPv6 header and the MPLS label stack. -If set to 0 the IPv6 header TTL is not modified while passing through MPLS +If set to 0, the IPv6 header TTL is not modified while passing through MPLS and the MPLS label stack is initialized with the .Dv MPLSCTL_DEFTTL . The default is 0. diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 35376a13518..1e0f254c577 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: write.2,v 1.43 2021/11/21 23:44:55 jan Exp $ +.\" $OpenBSD: write.2,v 1.44 2022/03/31 17:27:16 naddy Exp $ .\" $NetBSD: write.2,v 1.6 1995/02/27 12:39:43 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)write.2 8.5 (Berkeley) 4/2/94 .\" -.Dd $Mdocdate: November 21 2021 $ +.Dd $Mdocdate: March 31 2022 $ .Dt WRITE 2 .Os .Sh NAME @@ -129,7 +129,7 @@ a writable set-user-ID file owned by the superuser. .Pp If .Fn write -succeeds it will update the st_ctime and st_mtime fields of the file's +succeeds, it will update the st_ctime and st_mtime fields of the file's meta-data (see .Xr stat 2 ) . .Pp |