CVS commit: src/lib/libc/sys

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sun May 19 16:04:46 UTC 2024

Modified Files:
src/lib/libc/sys: dup.2

Log Message:
Amend for oldfd == newfd returning EINVAL in dup3


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/lib/libc/sys/dup.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/dup.2
diff -u src/lib/libc/sys/dup.2:1.33 src/lib/libc/sys/dup.2:1.34
--- src/lib/libc/sys/dup.2:1.33	Mon Jul  3 17:32:50 2017
+++ src/lib/libc/sys/dup.2	Sun May 19 12:04:46 2024
@@ -1,4 +1,4 @@
-.\"	$NetBSD: dup.2,v 1.33 2017/07/03 21:32:50 wiz Exp $
+.\"	$NetBSD: dup.2,v 1.34 2024/05/19 16:04:46 christos Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)dup.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd December 24, 2013
+.Dd May 19, 2024
 .Dt DUP 2
 .Os
 .Sh NAME
@@ -117,7 +117,14 @@ and can to some extent be adjusted with
 .Pp
 The
 .Fn dup3
-call includes an additional
+call fails and returns 
+.Er EINVAL
+if the numeric value in the
+.Ar oldfd 
+argument is equal to the one in the
+.Ar newfd
+argument.
+It also includes an additional
 .Fa flags
 argument supporting a subset of the
 .Xr open 2
@@ -207,11 +214,15 @@ and
 .Fa newfd
 is not in the range of valid file descriptors.
 .It Bq Er EINVAL
-.Fa flags
-contained an invalid value.
-Only
+In the
 .Fn dup3
-can generate this error.
+call either the
+.Fa flags
+argument contained an invalid value or the
+.Ar oldfd
+argument is equal to the
+.Ar newfd
+argument.
 .It Bq Er EMFILE
 Too many descriptors are active.
 Only

CVS commit: src/lib/libc/sys

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sun May 19 16:04:46 UTC 2024

Modified Files:
src/lib/libc/sys: dup.2

Log Message:
Amend for oldfd == newfd returning EINVAL in dup3


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/lib/libc/sys/dup.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Apr 28 23:10:26 UTC 2024

Modified Files:
src/lib/libc/sys: execve.2

Log Message:
execve(2): brush up markup


To generate a diff of this commit:
cvs rdiff -u -r1.46 -r1.47 src/lib/libc/sys/execve.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/execve.2
diff -u src/lib/libc/sys/execve.2:1.46 src/lib/libc/sys/execve.2:1.47
--- src/lib/libc/sys/execve.2:1.46	Sun Apr 28 22:21:21 2024
+++ src/lib/libc/sys/execve.2	Sun Apr 28 23:10:26 2024
@@ -1,4 +1,4 @@
-.\"	$NetBSD: execve.2,v 1.46 2024/04/28 22:21:21 rillig Exp $
+.\"	$NetBSD: execve.2,v 1.47 2024/04/28 23:10:26 uwe Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -75,35 +75,32 @@ and
 .Xr a.out 5 .
 .Pp
 An interpreter file begins with a line of the form:
-.Pp
-.Bd -ragged -offset indent -compact
-.Sy 

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Apr 28 23:10:26 UTC 2024

Modified Files:
src/lib/libc/sys: execve.2

Log Message:
execve(2): brush up markup


To generate a diff of this commit:
cvs rdiff -u -r1.46 -r1.47 src/lib/libc/sys/execve.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Roland Illig]

Module Name:src
Committed By:   rillig
Date:   Sun Apr 28 22:21:21 UTC 2024

Modified Files:
src/lib/libc/sys: execve.2

Log Message:
execve.2: fix typo in markup


To generate a diff of this commit:
cvs rdiff -u -r1.45 -r1.46 src/lib/libc/sys/execve.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/execve.2
diff -u src/lib/libc/sys/execve.2:1.45 src/lib/libc/sys/execve.2:1.46
--- src/lib/libc/sys/execve.2:1.45	Wed Sep 18 04:57:53 2019
+++ src/lib/libc/sys/execve.2	Sun Apr 28 22:21:21 2024
@@ -1,4 +1,4 @@
-.\"	$NetBSD: execve.2,v 1.45 2019/09/18 04:57:53 wiz Exp $
+.\"	$NetBSD: execve.2,v 1.46 2024/04/28 22:21:21 rillig Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -83,7 +83,7 @@ An interpreter file begins with a line o
 .Ed
 .Pp
 When an interpreter file is
-.Sy execve Ar d ,
+.Sy execve Ap d ,
 the system actually
 .Sy execve Ap s
 the specified

CVS commit: src/lib/libc/sys

[Roland Illig]

Module Name:src
Committed By:   rillig
Date:   Sun Apr 28 22:21:21 UTC 2024

Modified Files:
src/lib/libc/sys: execve.2

Log Message:
execve.2: fix typo in markup


To generate a diff of this commit:
cvs rdiff -u -r1.45 -r1.46 src/lib/libc/sys/execve.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sun Jan 21 00:35:57 UTC 2024

Modified Files:
src/lib/libc/sys: Lint_ptrace.c

Log Message:
fix alpha, grr.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/libc/sys/Lint_ptrace.c

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/Lint_ptrace.c
diff -u src/lib/libc/sys/Lint_ptrace.c:1.3 src/lib/libc/sys/Lint_ptrace.c:1.4
--- src/lib/libc/sys/Lint_ptrace.c:1.3	Sat Jan 20 09:52:49 2024
+++ src/lib/libc/sys/Lint_ptrace.c	Sat Jan 20 19:35:57 2024
@@ -1,10 +1,11 @@
-/* $NetBSD: Lint_ptrace.c,v 1.3 2024/01/20 14:52:49 christos Exp $ */
+/* $NetBSD: Lint_ptrace.c,v 1.4 2024/01/21 00:35:57 christos Exp $ */
 
 /*
  * This file placed in the public domain.
  * Chris Demetriou, November 5, 1997.
  */
 
+#include 	/* XXX: alpha  needs sigset_t! */
 #include 
 #include 
 

CVS commit: src/lib/libc/sys

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sun Jan 21 00:35:57 UTC 2024

Modified Files:
src/lib/libc/sys: Lint_ptrace.c

Log Message:
fix alpha, grr.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/libc/sys/Lint_ptrace.c

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Wed Oct 25 18:23:10 UTC 2023

Modified Files:
src/lib/libc/sys: mremap.2

Log Message:
mremap(2): Use .Lk for links in text.

.%U is only for links in reference sections.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/lib/libc/sys/mremap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Wed Oct 25 18:23:10 UTC 2023

Modified Files:
src/lib/libc/sys: mremap.2

Log Message:
mremap(2): Use .Lk for links in text.

.%U is only for links in reference sections.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/lib/libc/sys/mremap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mremap.2
diff -u src/lib/libc/sys/mremap.2:1.9 src/lib/libc/sys/mremap.2:1.10
--- src/lib/libc/sys/mremap.2:1.9	Fri Mar  3 12:53:04 2023
+++ src/lib/libc/sys/mremap.2	Wed Oct 25 18:23:10 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mremap.2,v 1.9 2023/03/03 12:53:04 riastradh Exp $
+.\"	$NetBSD: mremap.2,v 1.10 2023/10/25 18:23:10 riastradh Exp $
 .\"
 .\" Copyright (c) 2007 Thomas Klausner and Joerg Sonnenberger
 .\" All rights reserved.
@@ -262,5 +262,5 @@ use
 .El
 .Pp
 See
-.%U https://gnats.NetBSD.org/55177
+.Lk https://gnats.NetBSD.org/55177 "PR lib/55177"
 for details.

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Sun Oct 15 20:37:04 UTC 2023

Modified Files:
src/lib/libc/sys: stat.2

Log Message:
document S_ISWHT, sort these macros


To generate a diff of this commit:
cvs rdiff -u -r1.59 -r1.60 src/lib/libc/sys/stat.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Sun Oct 15 20:37:04 UTC 2023

Modified Files:
src/lib/libc/sys: stat.2

Log Message:
document S_ISWHT, sort these macros


To generate a diff of this commit:
cvs rdiff -u -r1.59 -r1.60 src/lib/libc/sys/stat.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/stat.2
diff -u src/lib/libc/sys/stat.2:1.59 src/lib/libc/sys/stat.2:1.60
--- src/lib/libc/sys/stat.2:1.59	Sun Sep  1 19:45:48 2019
+++ src/lib/libc/sys/stat.2	Sun Oct 15 20:37:04 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: stat.2,v 1.59 2019/09/01 19:45:48 sevan Exp $
+.\"	$NetBSD: stat.2,v 1.60 2023/10/15 20:37:04 jschauma Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993, 1994
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)stat.2	8.4 (Berkeley) 5/1/95
 .\"
-.Dd September 1, 2019
+.Dd October 15, 2023
 .Dt STAT 2
 .Os
 .Sh NAME
@@ -225,12 +225,14 @@ Test for a character special file.
 Test for a directory.
 .It Fn S_ISFIFO "m"
 Test for a pipe or FIFO special file.
-.It Fn S_ISREG "m"
-Test for a regular file.
 .It Fn S_ISLNK "m"
 Test for a symbolic link.
+.It Fn S_ISREG "m"
+Test for a regular file.
 .It Fn S_ISSOCK "m"
 Test for a socket.
+.It Fn S_ISWHT "m"
+Test for a whiteout file.
 .El
 .Pp
 The macros evaluate to a non-zero value if the test

CVS commit: src/lib/libc/sys

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Tue Aug  1 23:33:05 UTC 2023

Modified Files:
src/lib/libc/sys: select.2

Log Message:
select.2: note when pselect(2) was added


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/lib/libc/sys/select.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/select.2
diff -u src/lib/libc/sys/select.2:1.44 src/lib/libc/sys/select.2:1.45
--- src/lib/libc/sys/select.2:1.44	Fri Jul  7 01:31:25 2023
+++ src/lib/libc/sys/select.2	Tue Aug  1 23:33:04 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: select.2,v 1.44 2023/07/07 01:31:25 riastradh Exp $
+.\"	$NetBSD: select.2,v 1.45 2023/08/01 23:33:04 gutteridge Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)select.2	8.2 (Berkeley) 3/25/94
 .\"
-.Dd November 28, 2013
+.Dd August 1, 2023
 .Dt SELECT 2
 .Os
 .Sh NAME
@@ -273,6 +273,10 @@ The
 .Fn select
 function call appeared in
 .Bx 4.2 .
+The
+.Fn pselect
+function call first appeared in
+.Nx 3.0 .
 .Sh BUGS
 Although the provision of
 .Xr getdtablesize 3

CVS commit: src/lib/libc/sys

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Tue Aug  1 23:33:05 UTC 2023

Modified Files:
src/lib/libc/sys: select.2

Log Message:
select.2: note when pselect(2) was added


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/lib/libc/sys/select.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Jul 28 23:41:16 UTC 2023

Modified Files:
src/lib/libc/sys: epoll.2 kqueue.2

Log Message:
Fix some macro( usage)s


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/epoll.2
cvs rdiff -u -r1.59 -r1.60 src/lib/libc/sys/kqueue.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Jul 28 23:41:16 UTC 2023

Modified Files:
src/lib/libc/sys: epoll.2 kqueue.2

Log Message:
Fix some macro( usage)s


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/epoll.2
cvs rdiff -u -r1.59 -r1.60 src/lib/libc/sys/kqueue.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/epoll.2
diff -u src/lib/libc/sys/epoll.2:1.1 src/lib/libc/sys/epoll.2:1.2
--- src/lib/libc/sys/epoll.2:1.1	Fri Jul 28 18:19:00 2023
+++ src/lib/libc/sys/epoll.2	Fri Jul 28 23:41:16 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: epoll.2,v 1.1 2023/07/28 18:19:00 christos Exp $
+.\"	$NetBSD: epoll.2,v 1.2 2023/07/28 23:41:16 wiz Exp $
 .\"
 .\" Copyright (c) 2023 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -94,16 +94,16 @@ The
 field is passed through the kernel and is intended to be used to identify the
 event.
 When used with
-.Fa epoll_ctl ,
+.Fn epoll_ctl ,
 the
 .Va events
 field consists of a mask of the events that the
 .Nm
 instance should watch for, and when being used with
-.Fa epoll_wait ,
-.Fa epoll_pwait ,
+.Fn epoll_wait ,
+.Fn epoll_pwait ,
 and
-.Fa epoll_pwait2
+.Fn epoll_pwait2
 consists of a mask of the events that occurred.
 The following are possible values for
 .Va events :
@@ -155,7 +155,7 @@ of
 to set the
 .Xr close 2
 on
-.Xr exec 2
+.Xr exec 3
 flag.
 .Pp
 .Fn epoll_ctl
@@ -216,9 +216,9 @@ should be specified as
 .Dv NULL .
 Additionally,
 a sigmask may be specified to
-.Fa epoll_pwait
+.Fn epoll_pwait
 and
-.Fa epoll_pwait2
+.Fn epoll_pwait2
 in
 .Fa sigmask
 to set the sigmask while

Index: src/lib/libc/sys/kqueue.2
diff -u src/lib/libc/sys/kqueue.2:1.59 src/lib/libc/sys/kqueue.2:1.60
--- src/lib/libc/sys/kqueue.2:1.59	Fri Jul 28 18:19:00 2023
+++ src/lib/libc/sys/kqueue.2	Fri Jul 28 23:41:16 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: kqueue.2,v 1.59 2023/07/28 18:19:00 christos Exp $
+.\"	$NetBSD: kqueue.2,v 1.60 2023/07/28 23:41:16 wiz Exp $
 .\"
 .\" Copyright (c) 2000 Jonathan Lemon
 .\" All rights reserved.
@@ -571,7 +571,7 @@ contains the number of times the timeout
 This filter automatically sets
 .Dv EV_CLEAR
 in
-.va flags
+.Va flags
 for periodic timers.
 Timers created with
 .Dv NOTE_ABSTIME
@@ -582,7 +582,7 @@ or
 are also specified.
 .Dv CLOCK_REALTIME
 is the reference clock for timers created with
-.Dv NOTE_ABSTIME.
+.Dv NOTE_ABSTIME .
 .Pp
 The filter accepts the following flags in the
 .Va fflags

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Jul 28 23:41:02 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
Remove Pp that have no effect.


To generate a diff of this commit:
cvs rdiff -u -r1.50 -r1.51 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.50 src/lib/libc/sys/socket.2:1.51
--- src/lib/libc/sys/socket.2:1.50	Thu Jul 20 23:28:44 2023
+++ src/lib/libc/sys/socket.2	Fri Jul 28 23:41:02 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.50 2023/07/20 23:28:44 gutteridge Exp $
+.\"	$NetBSD: socket.2,v 1.51 2023/07/28 23:41:02 wiz Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -53,7 +53,6 @@ which should be used.
 These families are defined in the include file
 .Ao Pa sys/socket.h Ac .
 The currently understood formats are:
-.Pp
 .Bl -column -offset indent ".Dv PF_APPLETALK"
 .It Dv PF_LOCAL Ta local domain Po previously Tn UNIX domain Pc protocols
 .It Dv PF_INET Ta Tn ARPA Internet protocols
@@ -68,7 +67,6 @@ The socket has the indicated
 .Fa type ,
 which specifies the semantics of communication.
 Currently defined types are:
-.Pp
 .Bl -tag -offset indent -width Dv
 .It Dv SOCK_STREAM
 Provides sequenced, reliable, two-way connection based byte streams.
@@ -91,7 +89,6 @@ Not implemented.
 .Pp
 The following flags can be or'ed to the socket type to add conditions to
 the returned file descriptor:
-.Pp
 .Bl -tag -offset indent -width Dv
 .It Dv SOCK_CLOEXEC
 Set the close on exec property.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Jul 28 23:41:02 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
Remove Pp that have no effect.


To generate a diff of this commit:
cvs rdiff -u -r1.50 -r1.51 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Thu Jul 20 23:28:44 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket.2: simplify and improve some phrasing


To generate a diff of this commit:
cvs rdiff -u -r1.49 -r1.50 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.49 src/lib/libc/sys/socket.2:1.50
--- src/lib/libc/sys/socket.2:1.49	Thu Jun  8 00:27:34 2023
+++ src/lib/libc/sys/socket.2	Thu Jul 20 23:28:44 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.49 2023/06/08 00:27:34 uwe Exp $
+.\"	$NetBSD: socket.2,v 1.50 2023/07/20 23:28:44 gutteridge Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -89,9 +89,8 @@ system call.
 Not implemented.
 .El
 .Pp
-The following flags can be or'ed to the type to condition the returned
-file descriptor:
-The following flags are valid:
+The following flags can be or'ed to the socket type to add conditions to
+the returned file descriptor:
 .Pp
 .Bl -tag -offset indent -width Dv
 .It Dv SOCK_CLOEXEC

CVS commit: src/lib/libc/sys

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Thu Jul 20 23:28:44 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket.2: simplify and improve some phrasing


To generate a diff of this commit:
cvs rdiff -u -r1.49 -r1.50 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Fri Jul  7 01:31:25 UTC 2023

Modified Files:
src/lib/libc/sys: poll.2 select.2

Log Message:
select(2), poll(2): Clarify return values.


To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/lib/libc/sys/poll.2
cvs rdiff -u -r1.43 -r1.44 src/lib/libc/sys/select.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/poll.2
diff -u src/lib/libc/sys/poll.2:1.37 src/lib/libc/sys/poll.2:1.38
--- src/lib/libc/sys/poll.2:1.37	Tue Feb  9 09:01:29 2021
+++ src/lib/libc/sys/poll.2	Fri Jul  7 01:31:25 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: poll.2,v 1.37 2021/02/09 09:01:29 wiz Exp $
+.\"	$NetBSD: poll.2,v 1.38 2023/07/07 01:31:25 riastradh Exp $
 .\"
 .\" Copyright (c) 1998, 2005, 2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -210,8 +210,10 @@ Sockets produce POLLIN rather than POLLH
 end is closed.
 .Sh RETURN VALUES
 .Fn poll
-returns the number of descriptors that are ready for I/O, or \-1 if an
-error occurred.
+returns the number of descriptors that are ready for I/O, or returns
+\-1 and sets
+.Dv errno
+if an error occurred.
 If the time limit expires,
 .Fn poll
 returns 0.

Index: src/lib/libc/sys/select.2
diff -u src/lib/libc/sys/select.2:1.43 src/lib/libc/sys/select.2:1.44
--- src/lib/libc/sys/select.2:1.43	Wed Oct 25 17:39:47 2017
+++ src/lib/libc/sys/select.2	Fri Jul  7 01:31:25 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: select.2,v 1.43 2017/10/25 17:39:47 abhinav Exp $
+.\"	$NetBSD: select.2,v 1.44 2023/07/07 01:31:25 riastradh Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -155,7 +155,9 @@ interface instead, which tends to be mor
 .Fn select
 returns the number of ready descriptors that are contained in
 the descriptor sets,
-or \-1 if an error occurred.
+or returns \-1 and sets
+.Dv errno
+if an error occurred.
 If the time limit expires,
 .Fn select
 returns 0.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Fri Jul  7 01:31:25 UTC 2023

Modified Files:
src/lib/libc/sys: poll.2 select.2

Log Message:
select(2), poll(2): Clarify return values.


To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/lib/libc/sys/poll.2
cvs rdiff -u -r1.43 -r1.44 src/lib/libc/sys/select.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Sun Jul  2 13:25:52 UTC 2023

Modified Files:
src/lib/libc/sys: getrandom.2

Log Message:
getrandom(2): Reduce editorializing tone in man page.

XXX pullup-10


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/lib/libc/sys/getrandom.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/getrandom.2
diff -u src/lib/libc/sys/getrandom.2:1.2 src/lib/libc/sys/getrandom.2:1.3
--- src/lib/libc/sys/getrandom.2:1.2	Fri Jun 30 21:44:22 2023
+++ src/lib/libc/sys/getrandom.2	Sun Jul  2 13:25:52 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: getrandom.2,v 1.2 2023/06/30 21:44:22 riastradh Exp $
+.\"	$NetBSD: getrandom.2,v 1.3 2023/07/02 13:25:52 riastradh Exp $
 .\"
 .\" Copyright (c) 2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -124,7 +124,7 @@ since
 never blocks.
 The combination
 .Dv GRND_INSECURE Ns Li "|" Ns Li GRND_RANDOM
-is nonsensical and fails with
+always fails with
 .Er EINVAL .
 .Sh RETURN VALUES
 If successful,
@@ -240,5 +240,5 @@ see
 .Pp
 The
 .Nm
-interface is unnecessarily complicated for no real value to
-applications, because of hysterical raisins.
+interface has more options than real-world applications need, with
+confusing and unclear semantics inherited from Linux.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Sun Jul  2 13:25:52 UTC 2023

Modified Files:
src/lib/libc/sys: getrandom.2

Log Message:
getrandom(2): Reduce editorializing tone in man page.

XXX pullup-10


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/lib/libc/sys/getrandom.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Jun  8 00:27:34 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): change type flags list back to -tag

On second thought, convert the list of type flags back to -tag, but
don't make it -compact.  This way it's easier to see that it's related
to the list above.


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.48 src/lib/libc/sys/socket.2:1.49
--- src/lib/libc/sys/socket.2:1.48	Tue Jun  6 23:31:01 2023
+++ src/lib/libc/sys/socket.2	Thu Jun  8 00:27:34 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.48 2023/06/06 23:31:01 uwe Exp $
+.\"	$NetBSD: socket.2,v 1.49 2023/06/08 00:27:34 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -93,14 +93,16 @@ The following flags can be or'ed to the 
 file descriptor:
 The following flags are valid:
 .Pp
-.Bl -column -offset indent ".Dv SOCK_NOSIGPIPE"
-.It Dv SOCK_CLOEXEC Ta Set the close on exec property.
-.It Dv SOCK_NONBLOCK Ta Set non-blocking I/O.
-.It Dv SOCK_NOSIGPIPE Ta Return Xo
+.Bl -tag -offset indent -width Dv
+.It Dv SOCK_CLOEXEC
+Set the close on exec property.
+.It Dv SOCK_NONBLOCK
+Set non-blocking I/O.
+.It Dv SOCK_NOSIGPIPE
+Return
 .Er EPIPE
 instead of raising
 .Dv SIGPIPE .
-.Xc
 .El
 .Pp
 The

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Jun  8 00:27:34 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): change type flags list back to -tag

On second thought, convert the list of type flags back to -tag, but
don't make it -compact.  This way it's easier to see that it's related
to the list above.


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jun  6 23:31:01 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): fix macro invocation in a column


To generate a diff of this commit:
cvs rdiff -u -r1.47 -r1.48 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.47 src/lib/libc/sys/socket.2:1.48
--- src/lib/libc/sys/socket.2:1.47	Tue Jun  6 23:29:16 2023
+++ src/lib/libc/sys/socket.2	Tue Jun  6 23:31:01 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.47 2023/06/06 23:29:16 uwe Exp $
+.\"	$NetBSD: socket.2,v 1.48 2023/06/06 23:31:01 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -96,7 +96,11 @@ The following flags are valid:
 .Bl -column -offset indent ".Dv SOCK_NOSIGPIPE"
 .It Dv SOCK_CLOEXEC Ta Set the close on exec property.
 .It Dv SOCK_NONBLOCK Ta Set non-blocking I/O.
-.It Dv SOCK_NOSIGPIPE Ta Return Er EPIPE instead of raising Dv SIGPIPE .
+.It Dv SOCK_NOSIGPIPE Ta Return Xo
+.Er EPIPE
+instead of raising
+.Dv SIGPIPE .
+.Xc
 .El
 .Pp
 The

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jun  6 23:31:01 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): fix macro invocation in a column


To generate a diff of this commit:
cvs rdiff -u -r1.47 -r1.48 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jun  6 23:29:16 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): use "provides" consistently in "type" descriptions


To generate a diff of this commit:
cvs rdiff -u -r1.46 -r1.47 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.46 src/lib/libc/sys/socket.2:1.47
--- src/lib/libc/sys/socket.2:1.46	Tue Jun  6 23:27:15 2023
+++ src/lib/libc/sys/socket.2	Tue Jun  6 23:29:16 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.46 2023/06/06 23:27:15 uwe Exp $
+.\"	$NetBSD: socket.2,v 1.47 2023/06/06 23:29:16 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -81,7 +81,7 @@ Provides access to internal network prot
 Available only to the super-user.
 Not described here.
 .It Dv SOCK_SEQPACKET
-Provide a sequenced, reliable, two-way connection-based data
+Provides a sequenced, reliable, two-way connection-based data
 transmission path for datagrams of fixed maximum length.
 A consumer may be required to read an entire packet with each read
 system call.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jun  6 23:29:16 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): use "provides" consistently in "type" descriptions


To generate a diff of this commit:
cvs rdiff -u -r1.46 -r1.47 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jun  6 23:27:15 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): use .Bl -column where appropriate


To generate a diff of this commit:
cvs rdiff -u -r1.45 -r1.46 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valery Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jun  6 23:27:15 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): use .Bl -column where appropriate


To generate a diff of this commit:
cvs rdiff -u -r1.45 -r1.46 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.45 src/lib/libc/sys/socket.2:1.46
--- src/lib/libc/sys/socket.2:1.45	Tue Jun  6 09:14:27 2023
+++ src/lib/libc/sys/socket.2	Tue Jun  6 23:27:15 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.45 2023/06/06 09:14:27 riastradh Exp $
+.\"	$NetBSD: socket.2,v 1.46 2023/06/06 23:27:15 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -54,21 +54,14 @@ These families are defined in the includ
 .Ao Pa sys/socket.h Ac .
 The currently understood formats are:
 .Pp
-.Bl -tag -offset indent -width 20n -compact
-.It Dv PF_LOCAL
-local (previously UNIX) domain protocols
-.It Dv PF_INET
-ARPA Internet protocols
-.It Dv PF_INET6
-IPv6 (Internet Protocol version 6) protocols
-.It Dv PF_NS
-Xerox Network Systems protocols
-.It Dv PF_APPLETALK
-AppleTalk protocols
-.It Dv PF_BLUETOOTH
-Bluetooth protocols
-.It Dv PF_CAN
-CAN bus protocols
+.Bl -column -offset indent ".Dv PF_APPLETALK"
+.It Dv PF_LOCAL Ta local domain Po previously Tn UNIX domain Pc protocols
+.It Dv PF_INET Ta Tn ARPA Internet protocols
+.It Dv PF_INET6 Ta Tn IPv6 (Internet Protocol version 6) protocols
+.It Dv PF_NS Ta Xerox Network Systems protocols
+.It Dv PF_APPLETALK Ta AppleTalk protocols
+.It Dv PF_BLUETOOTH Ta Bluetooth protocols
+.It Dv PF_CAN Ta Tn CAN bus protocols
 .El
 .Pp
 The socket has the indicated
@@ -76,7 +69,7 @@ The socket has the indicated
 which specifies the semantics of communication.
 Currently defined types are:
 .Pp
-.Bl -tag -offset indent -width 20n
+.Bl -tag -offset indent -width Dv
 .It Dv SOCK_STREAM
 Provides sequenced, reliable, two-way connection based byte streams.
 An out-of-band data transmission mechanism may be supported.
@@ -100,16 +93,10 @@ The following flags can be or'ed to the 
 file descriptor:
 The following flags are valid:
 .Pp
-.Bl -tag -offset indent -width 20n -compact
-.It Dv SOCK_CLOEXEC
-Set the close on exec property.
-.It Dv SOCK_NONBLOCK
-Sets non-blocking I/O.
-.It Dv SOCK_NOSIGPIPE
-Return
-.Er EPIPE
-instead of raising
-.Dv SIGPIPE .
+.Bl -column -offset indent ".Dv SOCK_NOSIGPIPE"
+.It Dv SOCK_CLOEXEC Ta Set the close on exec property.
+.It Dv SOCK_NONBLOCK Ta Set non-blocking I/O.
+.It Dv SOCK_NOSIGPIPE Ta Return Er EPIPE instead of raising Dv SIGPIPE .
 .El
 .Pp
 The

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Tue Jun  6 09:14:27 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): Move prose list of socket type summaries into a table.


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.44 src/lib/libc/sys/socket.2:1.45
--- src/lib/libc/sys/socket.2:1.44	Tue Jun  6 09:10:08 2023
+++ src/lib/libc/sys/socket.2	Tue Jun  6 09:14:27 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.44 2023/06/06 09:10:08 riastradh Exp $
+.\"	$NetBSD: socket.2,v 1.45 2023/06/06 09:14:27 riastradh Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -76,12 +76,24 @@ The socket has the indicated
 which specifies the semantics of communication.
 Currently defined types are:
 .Pp
-.Bl -tag -offset indent -compact
+.Bl -tag -offset indent -width 20n
 .It Dv SOCK_STREAM
+Provides sequenced, reliable, two-way connection based byte streams.
+An out-of-band data transmission mechanism may be supported.
 .It Dv SOCK_DGRAM
+Supports datagrams: connectionless, unreliable messages of a
+fixed\(emtypically small\(emmaximum length.
 .It Dv SOCK_RAW
+Provides access to internal network protocols and interfaces.
+Available only to the super-user.
+Not described here.
 .It Dv SOCK_SEQPACKET
+Provide a sequenced, reliable, two-way connection-based data
+transmission path for datagrams of fixed maximum length.
+A consumer may be required to read an entire packet with each read
+system call.
 .It Dv SOCK_RDM
+Not implemented.
 .El
 .Pp
 The following flags can be or'ed to the type to condition the returned
@@ -100,34 +112,6 @@ instead of raising
 .Dv SIGPIPE .
 .El
 .Pp
-A
-.Dv SOCK_STREAM
-type provides sequenced, reliable,
-two-way connection based byte streams.
-An out-of-band data transmission mechanism may be supported.
-A
-.Dv SOCK_DGRAM
-socket supports
-datagrams (connectionless, unreliable messages of
-a fixed (typically small) maximum length).
-A
-.Dv SOCK_SEQPACKET
-socket may provide a sequenced, reliable,
-two-way connection-based data transmission path for datagrams
-of fixed maximum length; a consumer may be required to read
-an entire packet with each read system call.
-This facility is protocol specific, and presently implemented
-only for
-.Dv PF_NS .
-.Dv SOCK_RAW
-sockets provide access to internal network protocols and interfaces.
-The types
-.Dv SOCK_RAW ,
-which is available only to the super-user, and
-.Dv SOCK_RDM ,
-which is planned,
-but not yet implemented, are not described here.
-.Pp
 The
 .Fa protocol
 specifies a particular protocol to be used with the socket.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Tue Jun  6 09:14:27 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): Move prose list of socket type summaries into a table.


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Tue Jun  6 09:10:08 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): Tidy up markup a bit.

Use a tag list, not a literal block with hand-formatted text, for
protocols and socket type flags.


To generate a diff of this commit:
cvs rdiff -u -r1.43 -r1.44 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socket.2
diff -u src/lib/libc/sys/socket.2:1.43 src/lib/libc/sys/socket.2:1.44
--- src/lib/libc/sys/socket.2:1.43	Tue Jun 28 20:12:52 2022
+++ src/lib/libc/sys/socket.2	Tue Jun  6 09:10:08 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socket.2,v 1.43 2022/06/28 20:12:52 rillig Exp $
+.\"	$NetBSD: socket.2,v 1.44 2023/06/06 09:10:08 riastradh Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -54,33 +54,41 @@ These families are defined in the includ
 .Ao Pa sys/socket.h Ac .
 The currently understood formats are:
 .Pp
-.Bd -literal -offset indent -compact
-PF_LOCAL	local (previously UNIX) domain protocols
-PF_INET		ARPA Internet protocols
-PF_INET6	IPv6 (Internet Protocol version 6) protocols
-PF_NS		Xerox Network Systems protocols
-PF_APPLETALK	AppleTalk protocols
-PF_BLUETOOTH	Bluetooth protocols
-PF_CAN		CAN bus protocols
-.Ed
+.Bl -tag -offset indent -width 20n -compact
+.It Dv PF_LOCAL
+local (previously UNIX) domain protocols
+.It Dv PF_INET
+ARPA Internet protocols
+.It Dv PF_INET6
+IPv6 (Internet Protocol version 6) protocols
+.It Dv PF_NS
+Xerox Network Systems protocols
+.It Dv PF_APPLETALK
+AppleTalk protocols
+.It Dv PF_BLUETOOTH
+Bluetooth protocols
+.It Dv PF_CAN
+CAN bus protocols
+.El
 .Pp
 The socket has the indicated
 .Fa type ,
 which specifies the semantics of communication.
 Currently defined types are:
 .Pp
-.Bd -literal -offset indent -compact
-SOCK_STREAM
-SOCK_DGRAM
-SOCK_RAW
-SOCK_SEQPACKET
-SOCK_RDM
-.Ed
+.Bl -tag -offset indent -compact
+.It Dv SOCK_STREAM
+.It Dv SOCK_DGRAM
+.It Dv SOCK_RAW
+.It Dv SOCK_SEQPACKET
+.It Dv SOCK_RDM
+.El
 .Pp
 The following flags can be or'ed to the type to condition the returned
 file descriptor:
 The following flags are valid:
-.Bl -column SOCK_NONBLOCK -offset indent
+.Pp
+.Bl -tag -offset indent -width 20n -compact
 .It Dv SOCK_CLOEXEC
 Set the close on exec property.
 .It Dv SOCK_NONBLOCK

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Tue Jun  6 09:10:08 UTC 2023

Modified Files:
src/lib/libc/sys: socket.2

Log Message:
socket(2): Tidy up markup a bit.

Use a tag list, not a literal block with hand-formatted text, for
protocols and socket type flags.


To generate a diff of this commit:
cvs rdiff -u -r1.43 -r1.44 src/lib/libc/sys/socket.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Sun Mar  5 16:24:31 UTC 2023

Modified Files:
src/lib/libc/sys: open.2

Log Message:
Document the error code when O_REGULAR is specified and the last
path component is not a regular file.


To generate a diff of this commit:
cvs rdiff -u -r1.65 -r1.66 src/lib/libc/sys/open.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Sun Mar  5 16:24:31 UTC 2023

Modified Files:
src/lib/libc/sys: open.2

Log Message:
Document the error code when O_REGULAR is specified and the last
path component is not a regular file.


To generate a diff of this commit:
cvs rdiff -u -r1.65 -r1.66 src/lib/libc/sys/open.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/open.2
diff -u src/lib/libc/sys/open.2:1.65 src/lib/libc/sys/open.2:1.66
--- src/lib/libc/sys/open.2:1.65	Wed Mar 17 08:13:29 2021
+++ src/lib/libc/sys/open.2	Sun Mar  5 16:24:31 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: open.2,v 1.65 2021/03/17 08:13:29 wiz Exp $
+.\"	$NetBSD: open.2,v 1.66 2023/03/05 16:24:31 thorpej Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)open.2	8.2 (Berkeley) 11/16/93
 .\"
-.Dd March 17, 2021
+.Dd March 5, 2023
 .Dt OPEN 2
 .Os
 .Sh NAME
@@ -365,6 +365,9 @@ was specified, but the last path compone
 specifies returning
 .Bq Er ELOOP
 for this case.
+.It Bq Er EFTYPE
+.Dv O_REGULAR
+is specified and the last path component is not a regular file.
 .It Bq Er EINTR
 The
 .Fn open

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Fri Mar  3 12:53:04 UTC 2023

Modified Files:
src/lib/libc/sys: mremap.2

Log Message:
mremap(2): Note MAP_REMAPDUP bug.

XXX pullup-10, unless we fix the bug first


To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/lib/libc/sys/mremap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mremap.2
diff -u src/lib/libc/sys/mremap.2:1.8 src/lib/libc/sys/mremap.2:1.9
--- src/lib/libc/sys/mremap.2:1.8	Wed Mar  1 20:08:41 2023
+++ src/lib/libc/sys/mremap.2	Fri Mar  3 12:53:04 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mremap.2,v 1.8 2023/03/01 20:08:41 riastradh Exp $
+.\"	$NetBSD: mremap.2,v 1.9 2023/03/03 12:53:04 riastradh Exp $
 .\"
 .\" Copyright (c) 2007 Thomas Klausner and Joerg Sonnenberger
 .\" All rights reserved.
@@ -231,3 +231,36 @@ system call appeared in
 It was based on the code that supports
 .Fn mremap
 compatibility for Linux binaries.
+.Sh BUGS
+If a mapping is created by
+.Xr mmap 2
+with
+.Dv MAP_PRIVATE
+and then duplicated by
+.Nm
+with
+.Dv MAP_REMAPDUP ,
+calling
+.Xr fork 2
+destroys the coupling between the original and duplicate mapping.
+Workarounds:
+.Bl -dash
+.It
+Create the original mapping with
+.Dv MAP_SHARED .
+.It
+Use
+.Xr minherit 2
+with
+.Dv MAP_INHERIT_NONE
+on the writable mapping.
+.It
+Don't use
+.Xr fork 2 ;
+use
+.Xr posix_spawn 2 .
+.El
+.Pp
+See
+.%U https://gnats.NetBSD.org/55177
+for details.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Fri Mar  3 12:53:04 UTC 2023

Modified Files:
src/lib/libc/sys: mremap.2

Log Message:
mremap(2): Note MAP_REMAPDUP bug.

XXX pullup-10, unless we fix the bug first


To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/lib/libc/sys/mremap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Wed Mar  1 20:08:42 UTC 2023

Modified Files:
src/lib/libc/sys: mremap.2

Log Message:
mremap(2): Fix example to use MAP_PRIVATE.

It is a historical accident that MAP_PRIVATE is assumed when neither
it nor MAP_SHARED is specified.

XXX pullup-9
XXX pullup-10


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/lib/libc/sys/mremap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mremap.2
diff -u src/lib/libc/sys/mremap.2:1.7 src/lib/libc/sys/mremap.2:1.8
--- src/lib/libc/sys/mremap.2:1.7	Thu May  3 05:09:48 2018
+++ src/lib/libc/sys/mremap.2	Wed Mar  1 20:08:41 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mremap.2,v 1.7 2018/05/03 05:09:48 wiz Exp $
+.\"	$NetBSD: mremap.2,v 1.8 2023/03/01 20:08:41 riastradh Exp $
 .\"
 .\" Copyright (c) 2007 Thomas Klausner and Joerg Sonnenberger
 .\" All rights reserved.
@@ -137,7 +137,7 @@ main(int argc, char *argv[])
 	// protections only
 	maprw = mmap(NULL, page,
 	PROT_MPROTECT(PROT_EXEC|PROT_WRITE|PROT_READ),
-MAP_ANON, -1, 0);
+MAP_ANON|MAP_PRIVATE, -1, 0);
 	if (maprw == MAP_FAILED)
 		err(EXIT_FAILURE, "mmap failed");
 

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Wed Mar  1 20:08:42 UTC 2023

Modified Files:
src/lib/libc/sys: mremap.2

Log Message:
mremap(2): Fix example to use MAP_PRIVATE.

It is a historical accident that MAP_PRIVATE is assumed when neither
it nor MAP_SHARED is specified.

XXX pullup-9
XXX pullup-10


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/lib/libc/sys/mremap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Wed Mar  1 15:11:28 UTC 2023

Modified Files:
src/lib/libc/sys: mmap.2

Log Message:
mmap(2): minor markup tweaks


To generate a diff of this commit:
cvs rdiff -u -r1.55 -r1.56 src/lib/libc/sys/mmap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Wed Mar  1 15:11:28 UTC 2023

Modified Files:
src/lib/libc/sys: mmap.2

Log Message:
mmap(2): minor markup tweaks


To generate a diff of this commit:
cvs rdiff -u -r1.55 -r1.56 src/lib/libc/sys/mmap.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mmap.2
diff -u src/lib/libc/sys/mmap.2:1.55 src/lib/libc/sys/mmap.2:1.56
--- src/lib/libc/sys/mmap.2:1.55	Sun Sep  8 17:24:49 2019
+++ src/lib/libc/sys/mmap.2	Wed Mar  1 15:11:28 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mmap.2,v 1.55 2019/09/08 17:24:49 sevan Exp $
+.\"	$NetBSD: mmap.2,v 1.56 2023/03/01 15:11:28 uwe Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -61,8 +61,10 @@ Any such extension beyond the end of the
 If
 .Fa addr
 is non-zero, it is used as a hint to the system.
-(As a convenience to the system, the actual address of the region may differ
-from the address supplied.)
+.Po
+As a convenience to the system, the actual address of the region may differ
+from the address supplied.
+.Pc
 If
 .Fa addr
 is zero, an address will be selected by the system.
@@ -74,7 +76,7 @@ deletes any previous mapping in the allo
 The protections (region accessibility) are specified in the
 .Fa prot
 argument by
-.Em OR Ns 'ing
+.Em or\^ Ap ing
 the following values:
 .Bl -tag -width PROT_WRITEXX -offset indent
 .It Dv PROT_EXEC
@@ -94,7 +96,7 @@ extension, the
 macro can be used to request additional permissions for later use with
 .Fn mprotect 2 .
 For example
-.Dv PROT_MPROTECT(PROT_READ)
+.Li PROT_MPROTECT(PROT_READ)
 requests that future
 .Dv PROT_READ
 mappings are allowed and can be enabled using
@@ -132,15 +134,18 @@ must be specified.
 Sharing, mapping type and options are specified in the
 .Fa flags
 argument by
-.Em OR Ns 'ing
+.Em or\^ Ap ing
 the following values:
-.Bl -tag -width MAP_HASSEMAPHOREXX -offset indent
-.It Dv MAP_ALIGNED(n)
+.Bl -tag -width ".Dv MAP_HASSEMAPHORE" -offset indent
+.It Dv MAP_ALIGNED Ns Li \&( Ns Ar n Ns Li \&)
 Request that the allocation be aligned to the given boundary.
 The parameter
 .Ar n
-should be the base 2 logarithm of the desired alignment (e.g., to
-request alignment to 16K, use 14 as the value for n).
+should be the base\~2 logarithm of the desired alignment
+.Po
+e.g., to request alignment to 16K, use 14 as the value for
+.Ar n
+.Pc .
 The alignment must be equal to or greater than the platform's page
 size as returned by
 .Xr sysconf 3
@@ -205,7 +210,7 @@ Only reserve address space, but do not r
 resources for this mapping.
 Access to the address space is not guaranteed and may result in a segmentation
 violation.
-Unimplemented.
+.Em Unimplemented .
 .It Dv MAP_PRIVATE
 Modifications made by this process are private, however modifications made by
 other processes using
@@ -216,14 +221,14 @@ Only valid for
 .Xr mremap 2 .
 .It Dv MAP_RENAME
 Assign the referenced private pages to the file descriptor provided.
-Unimplemented.
+.Em Unimplemented .
 .It Dv MAP_SHARED
 Modifications are shared.
 .It Dv MAP_STACK
 Allocate a memory segment that can be used either for a process or thread stack.
 This currently has no effect, but its use is reserved for architectures
 that might require special treatment of that address space.
-Unimplemented.
+.Em Unimplemented .
 .It Dv MAP_TRYFIXED
 Attempt to use the address
 .Fa addr

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 19:01:19 UTC 2022

Modified Files:
src/lib/libc/sys: fcntl.2

Log Message:
fcntl(2): Fix wrong markup in a couple of places


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/lib/libc/sys/fcntl.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/fcntl.2
diff -u src/lib/libc/sys/fcntl.2:1.48 src/lib/libc/sys/fcntl.2:1.49
--- src/lib/libc/sys/fcntl.2:1.48	Sun Dec  4 11:25:09 2022
+++ src/lib/libc/sys/fcntl.2	Sun Dec  4 19:01:19 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: fcntl.2,v 1.48 2022/12/04 11:25:09 uwe Exp $
+.\"	$NetBSD: fcntl.2,v 1.49 2022/12/04 19:01:19 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -143,7 +143,7 @@ The argument
 is interpreted as an int.
 .It Dv F_CLOSEM
 Close all file descriptors greater than or equal to
-.Ar fd .
+.Fa fd .
 .It Dv F_MAXFD
 Return the maximum file descriptor number currently open by the process.
 .It Dv F_GETNOSIGPIPE
@@ -161,7 +161,7 @@ in the buffer pointed to by
 .Fa arg .
 .Fa arg
 should be pointing to a buffer of at least
-.Fa MAXPATHLEN .
+.Dv MAXPATHLEN .
 .El
 .Pp
 The set of valid flags for the

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 19:01:19 UTC 2022

Modified Files:
src/lib/libc/sys: fcntl.2

Log Message:
fcntl(2): Fix wrong markup in a couple of places


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/lib/libc/sys/fcntl.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 16:21:54 UTC 2022

Modified Files:
src/lib/libc/sys: _lwp_suspend.2 _lwp_wait.2 _lwp_wakeup.2

Log Message:
Bump date for the fixed RETURN VALUES in previous


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/lib/libc/sys/_lwp_suspend.2
cvs rdiff -u -r1.6 -r1.7 src/lib/libc/sys/_lwp_wait.2 \
src/lib/libc/sys/_lwp_wakeup.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 16:21:54 UTC 2022

Modified Files:
src/lib/libc/sys: _lwp_suspend.2 _lwp_wait.2 _lwp_wakeup.2

Log Message:
Bump date for the fixed RETURN VALUES in previous


To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/lib/libc/sys/_lwp_suspend.2
cvs rdiff -u -r1.6 -r1.7 src/lib/libc/sys/_lwp_wait.2 \
src/lib/libc/sys/_lwp_wakeup.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/_lwp_suspend.2
diff -u src/lib/libc/sys/_lwp_suspend.2:1.5 src/lib/libc/sys/_lwp_suspend.2:1.6
--- src/lib/libc/sys/_lwp_suspend.2:1.5	Sun Dec  4 16:17:50 2022
+++ src/lib/libc/sys/_lwp_suspend.2	Sun Dec  4 16:21:54 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: _lwp_suspend.2,v 1.5 2022/12/04 16:17:50 uwe Exp $
+.\"	$NetBSD: _lwp_suspend.2,v 1.6 2022/12/04 16:21:54 uwe Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 13, 2003
+.Dd December 4, 2022
 .Dt _LWP_SUSPEND 2
 .Os
 .Sh NAME

Index: src/lib/libc/sys/_lwp_wait.2
diff -u src/lib/libc/sys/_lwp_wait.2:1.6 src/lib/libc/sys/_lwp_wait.2:1.7
--- src/lib/libc/sys/_lwp_wait.2:1.6	Sun Dec  4 16:17:50 2022
+++ src/lib/libc/sys/_lwp_wait.2	Sun Dec  4 16:21:54 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: _lwp_wait.2,v 1.6 2022/12/04 16:17:50 uwe Exp $
+.\"	$NetBSD: _lwp_wait.2,v 1.7 2022/12/04 16:21:54 uwe Exp $
 .\"
 .\" Copyright (c) 2003, 2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 23, 2020
+.Dd December 4, 2022
 .Dt _LWP_WAIT 2
 .Os
 .Sh NAME
Index: src/lib/libc/sys/_lwp_wakeup.2
diff -u src/lib/libc/sys/_lwp_wakeup.2:1.6 src/lib/libc/sys/_lwp_wakeup.2:1.7
--- src/lib/libc/sys/_lwp_wakeup.2:1.6	Sun Dec  4 16:17:50 2022
+++ src/lib/libc/sys/_lwp_wakeup.2	Sun Dec  4 16:21:54 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: _lwp_wakeup.2,v 1.6 2022/12/04 16:17:50 uwe Exp $
+.\"	$NetBSD: _lwp_wakeup.2,v 1.7 2022/12/04 16:21:54 uwe Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 13, 2003
+.Dd December 4, 2022
 .Dt _LWP_WAKEUP 2
 .Os
 .Sh NAME

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 16:17:50 UTC 2022

Modified Files:
src/lib/libc/sys: _lwp_create.2 _lwp_ctl.2 _lwp_detach.2 _lwp_getname.2
_lwp_kill.2 _lwp_park.2 _lwp_setname.2 _lwp_suspend.2 _lwp_unpark.2
_lwp_unpark_all.2 _lwp_wait.2 _lwp_wakeup.2

Log Message:
Tweak markup in _lwp_*(2) manual pages

Use .Rv where possible.  Some manual pages claimed that the error "is
returned", but RTFS and some quick testing indicate that this is wrong.

The commit message from 2003 says that:

  Note our current implementation mis-matches [man pages] slightly
  (error codes are stuffed into errno, where they should simply be
  returned by these calls).  This will be addressed shortly.

That hasn't happened in the 20 years, so we might as well make the man
pages reflect the reality.


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/lib/libc/sys/_lwp_create.2
cvs rdiff -u -r1.5 -r1.6 src/lib/libc/sys/_lwp_ctl.2 \
src/lib/libc/sys/_lwp_wait.2 src/lib/libc/sys/_lwp_wakeup.2
cvs rdiff -u -r1.4 -r1.5 src/lib/libc/sys/_lwp_detach.2 \
src/lib/libc/sys/_lwp_kill.2 src/lib/libc/sys/_lwp_suspend.2 \
src/lib/libc/sys/_lwp_unpark.2
cvs rdiff -u -r1.2 -r1.3 src/lib/libc/sys/_lwp_getname.2 \
src/lib/libc/sys/_lwp_setname.2
cvs rdiff -u -r1.12 -r1.13 src/lib/libc/sys/_lwp_park.2
cvs rdiff -u -r1.7 -r1.8 src/lib/libc/sys/_lwp_unpark_all.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/_lwp_create.2
diff -u src/lib/libc/sys/_lwp_create.2:1.10 src/lib/libc/sys/_lwp_create.2:1.11
--- src/lib/libc/sys/_lwp_create.2:1.10	Sun Dec  4 11:25:09 2022
+++ src/lib/libc/sys/_lwp_create.2	Sun Dec  4 16:17:50 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: _lwp_create.2,v 1.10 2022/12/04 11:25:09 uwe Exp $
+.\"	$NetBSD: _lwp_create.2,v 1.11 2022/12/04 16:17:50 uwe Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -51,20 +51,23 @@ The signal stack of the newly created li
 disabled.
 If this context specifies invalid register values (for example privilege
 escalation by setting machine dependent bits forbidden for user processes),
-or does not specify cpu register values (uc_flags does not have the
-_UC_CPU bit set), the call will fail and errno will be set to
+or does not specify cpu register values
+.Fa ( uc_flags
+does not have the
+.Dv _UC_CPU
+bit set), the call will fail and errno will be set to
 .Er EINVAL .
 .Pp
 The following flags affect the creation of the new LWP:
-.Bl -tag -width LWP_SUSPENDED
-.It LWP_DETACHED
+.Bl -tag -width Dv
+.It Dv LWP_DETACHED
 The LWP is created detached.
 The resources associated with a detached LWP will be automatically
 reclaimed by the system when the LWP exits.
 Otherwise, a terminated LWP's resources will not be reclaimed until
 its status is reported to another LWP via
 .Xr _lwp_wait 2 .
-.It LWP_SUSPENDED
+.It Dv LWP_SUSPENDED
 The LWP is created suspended, and will not begin execution until
 it is resumed by another LWP via
 .Xr _lwp_continue 2 .
@@ -74,15 +77,11 @@ it is resumed by another LWP via
 The LWP ID of the new LWP is stored in the location pointed to by
 .Fa new_lwp .
 .Sh RETURN VALUES
-Upon successful completion,
-.Fn _lwp_create
-returns a value of 0.
-Otherwise, a value of -1 is returned and errno is set to one of the values
-documented below.
+.Rv -std _lwp_create
 .Sh ERRORS
 .Fn _lwp_create
 will fail and no LWP will be created if:
-.Bl -tag -width 10n
+.Bl -tag -width Er
 .It Bq Er EAGAIN
 The system-imposed limit on the total
 number of LWPs under execution would be exceeded.
@@ -94,7 +93,9 @@ or
 .Fa new_lwp
 is outside the process's allocated address space.
 .It Bq Er EINVAL
-The ucontext_t passed is invalid.
+The
+.Vt ucontext_t
+passed is invalid.
 .It Bq Er ENOMEM
 There is insufficient swap space for the new LWP.
 .El

Index: src/lib/libc/sys/_lwp_ctl.2
diff -u src/lib/libc/sys/_lwp_ctl.2:1.5 src/lib/libc/sys/_lwp_ctl.2:1.6
--- src/lib/libc/sys/_lwp_ctl.2:1.5	Fri Apr 13 15:14:58 2012
+++ src/lib/libc/sys/_lwp_ctl.2	Sun Dec  4 16:17:50 2022
@@ -1,4 +1,4 @@
-.\" $NetBSD: _lwp_ctl.2,v 1.5 2012/04/13 15:14:58 yamt Exp $
+.\" $NetBSD: _lwp_ctl.2,v 1.6 2022/12/04 16:17:50 uwe Exp $
 .\"
 .\" Copyright (c)2007 YAMAMOTO Takashi,
 .\" All rights reserved.
@@ -49,7 +49,7 @@ It takes the following arguments.
 .Bl -tag -width features
 .It Fa features
 The bitwise-OR of the following flags.
-.Bl -tag -width LWPCTL_FEATURE_CURCPU
+.Bl -tag -width Dv
 .It Dv LWPCTL_FEATURE_CURCPU
 Request
 .Vt lc_curcpu .
@@ -68,8 +68,8 @@ The per-LWP communication area is descri
 structure.
 It has following members, depending on
 .Fa features .
-.Bl -tag -width int_lc_curcpu
-.It Vt int lc_curcpu
+.Bl -tag -width Fa
+.It Vt int Fa lc_curcpu
 The integral identifier of the CPU on which the LWP is running,
 or
 .Dv LWPCTL_CPU_NONE
@@ -79,10 +79,13 @@ userland.
 It's 

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 16:17:50 UTC 2022

Modified Files:
src/lib/libc/sys: _lwp_create.2 _lwp_ctl.2 _lwp_detach.2 _lwp_getname.2
_lwp_kill.2 _lwp_park.2 _lwp_setname.2 _lwp_suspend.2 _lwp_unpark.2
_lwp_unpark_all.2 _lwp_wait.2 _lwp_wakeup.2

Log Message:
Tweak markup in _lwp_*(2) manual pages

Use .Rv where possible.  Some manual pages claimed that the error "is
returned", but RTFS and some quick testing indicate that this is wrong.

The commit message from 2003 says that:

  Note our current implementation mis-matches [man pages] slightly
  (error codes are stuffed into errno, where they should simply be
  returned by these calls).  This will be addressed shortly.

That hasn't happened in the 20 years, so we might as well make the man
pages reflect the reality.


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/lib/libc/sys/_lwp_create.2
cvs rdiff -u -r1.5 -r1.6 src/lib/libc/sys/_lwp_ctl.2 \
src/lib/libc/sys/_lwp_wait.2 src/lib/libc/sys/_lwp_wakeup.2
cvs rdiff -u -r1.4 -r1.5 src/lib/libc/sys/_lwp_detach.2 \
src/lib/libc/sys/_lwp_kill.2 src/lib/libc/sys/_lwp_suspend.2 \
src/lib/libc/sys/_lwp_unpark.2
cvs rdiff -u -r1.2 -r1.3 src/lib/libc/sys/_lwp_getname.2 \
src/lib/libc/sys/_lwp_setname.2
cvs rdiff -u -r1.12 -r1.13 src/lib/libc/sys/_lwp_park.2
cvs rdiff -u -r1.7 -r1.8 src/lib/libc/sys/_lwp_unpark_all.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 11:18:58 UTC 2022

Modified Files:
src/lib/libc/sys: flock.2

Log Message:
flock(2): s/Eq/Er/ typo in the ERRORS section


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/lib/libc/sys/flock.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/flock.2
diff -u src/lib/libc/sys/flock.2:1.24 src/lib/libc/sys/flock.2:1.25
--- src/lib/libc/sys/flock.2:1.24	Wed Jul 28 11:31:06 2021
+++ src/lib/libc/sys/flock.2	Sun Dec  4 11:18:58 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: flock.2,v 1.24 2021/07/28 11:31:06 wiz Exp $
+.\"	$NetBSD: flock.2,v 1.25 2022/12/04 11:18:58 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -137,7 +137,7 @@ does not include exactly one of
 .Dv LOCK_SH ,
 or
 .Dv LOCK_UN .
-.It Bq Eq ENOMEM
+.It Bq Er ENOMEM
 The file lock limit for the current unprivileged user
 has been reached.
 It can be modified using the

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Sun Dec  4 11:18:58 UTC 2022

Modified Files:
src/lib/libc/sys: flock.2

Log Message:
flock(2): s/Eq/Er/ typo in the ERRORS section


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/lib/libc/sys/flock.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Nov 29 20:50:37 UTC 2022

Modified Files:
src/lib/libc/sys: socketpair.2

Log Message:
socketpair(2): Formatting nits


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/lib/libc/sys/socketpair.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socketpair.2
diff -u src/lib/libc/sys/socketpair.2:1.24 src/lib/libc/sys/socketpair.2:1.25
--- src/lib/libc/sys/socketpair.2:1.24	Tue Nov 29 20:26:39 2022
+++ src/lib/libc/sys/socketpair.2	Tue Nov 29 20:50:37 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socketpair.2,v 1.24 2022/11/29 20:26:39 jschauma Exp $
+.\"	$NetBSD: socketpair.2,v 1.25 2022/11/29 20:50:37 uwe Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -53,9 +53,9 @@ and using the optionally specified
 .Fa protocol .
 The descriptors used in referencing the new sockets
 are returned in
-.Fa sv[0]
+.Fa sv Ns Li [0]
 and
-.Fa sv[1] .
+.Fa sv Ns Li [1] .
 The two sockets are indistinguishable.
 .Pp
 Possible values for the
@@ -67,25 +67,24 @@ and
 .Dv SOCK_SEQPACKET ;
 the only supported value for the
 .Fa protocol
-is
-.Ar 0 ,
+is 0,
 which will let the system select an appropriate
 protocol for the requested socket
-.Fa type.
+.Fa type .
 .Pp
 Any combination of the following flags may
 additionally be used in the
 .Fa type
 argument:
 .Pp
-.Bl -tag -width "SOCK_NONBLOCKX" -offset indent -compact
-.It SOCK_CLOEXEC
+.Bl -tag -width Dv -offset indent -compact
+.It Dv SOCK_CLOEXEC
 Set close-on-exec flag on both the new descriptors.
-.It SOCK_NONBLOCK
+.It Dv SOCK_NONBLOCK
 Set non-blocking I/O mode on both the new sockets.
 .El
 .Sh RETURN VALUES
-A 0 is returned if the call succeeds, \-1 if it fails.
+.Rv -std
 .Sh ERRORS
 The call succeeds unless:
 .Bl -tag -width Er

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Nov 29 20:50:37 UTC 2022

Modified Files:
src/lib/libc/sys: socketpair.2

Log Message:
socketpair(2): Formatting nits


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/lib/libc/sys/socketpair.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Tue Nov 29 20:26:39 UTC 2022

Modified Files:
src/lib/libc/sys: socketpair.2

Log Message:
document the only supported type protocol, document type flags

This uses language taken from OpenBSD's manual page.


To generate a diff of this commit:
cvs rdiff -u -r1.23 -r1.24 src/lib/libc/sys/socketpair.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/socketpair.2
diff -u src/lib/libc/sys/socketpair.2:1.23 src/lib/libc/sys/socketpair.2:1.24
--- src/lib/libc/sys/socketpair.2:1.23	Mon Jun 27 08:21:08 2011
+++ src/lib/libc/sys/socketpair.2	Tue Nov 29 20:26:39 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: socketpair.2,v 1.23 2011/06/27 08:21:08 wiz Exp $
+.\"	$NetBSD: socketpair.2,v 1.24 2022/11/29 20:26:39 jschauma Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)socketpair.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd June 24, 2011
+.Dd November 29, 2022
 .Dt SOCKETPAIR 2
 .Os
 .Sh NAME
@@ -58,12 +58,32 @@ and
 .Fa sv[1] .
 The two sockets are indistinguishable.
 .Pp
-The
+Possible values for the
 .Fa type
+argument are
+.Dv SOCK_STREAM ,
+.Dv SOCK_DGRAM ,
 and
+.Dv SOCK_SEQPACKET ;
+the only supported value for the
 .Fa protocol
-argument values are described in
-.Xr socket 2 .
+is
+.Ar 0 ,
+which will let the system select an appropriate
+protocol for the requested socket
+.Fa type.
+.Pp
+Any combination of the following flags may
+additionally be used in the
+.Fa type
+argument:
+.Pp
+.Bl -tag -width "SOCK_NONBLOCKX" -offset indent -compact
+.It SOCK_CLOEXEC
+Set close-on-exec flag on both the new descriptors.
+.It SOCK_NONBLOCK
+Set non-blocking I/O mode on both the new sockets.
+.El
 .Sh RETURN VALUES
 A 0 is returned if the call succeeds, \-1 if it fails.
 .Sh ERRORS
@@ -95,6 +115,13 @@ The
 .Fn socketpair
 function call appeared in
 .Bx 4.2 .
+.Pp
+Support for the
+.Dv SOCK_CLOEXEC
+and
+.Dv SOCK_NONBLOCK
+flags appeared in
+.Nx 6.0 .
 .Sh BUGS
 This call is currently implemented only for the
 .Dv PF_LOCAL

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Tue Nov 29 20:26:39 UTC 2022

Modified Files:
src/lib/libc/sys: socketpair.2

Log Message:
document the only supported type protocol, document type flags

This uses language taken from OpenBSD's manual page.


To generate a diff of this commit:
cvs rdiff -u -r1.23 -r1.24 src/lib/libc/sys/socketpair.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue Oct 18 07:33:15 UTC 2022

Modified Files:
src/lib/libc/sys: _exit.2

Log Message:
avoid unnecessary Ns macro


To generate a diff of this commit:
cvs rdiff -u -r1.19 -r1.20 src/lib/libc/sys/_exit.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Tue Oct 18 07:33:15 UTC 2022

Modified Files:
src/lib/libc/sys: _exit.2

Log Message:
avoid unnecessary Ns macro


To generate a diff of this commit:
cvs rdiff -u -r1.19 -r1.20 src/lib/libc/sys/_exit.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/_exit.2
diff -u src/lib/libc/sys/_exit.2:1.19 src/lib/libc/sys/_exit.2:1.20
--- src/lib/libc/sys/_exit.2:1.19	Tue Oct 18 02:31:39 2022
+++ src/lib/libc/sys/_exit.2	Tue Oct 18 07:33:15 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: _exit.2,v 1.19 2022/10/18 02:31:39 jschauma Exp $
+.\"	$NetBSD: _exit.2,v 1.20 2022/10/18 07:33:15 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -71,7 +71,7 @@ is set as defined by
 (Note that only the least significant 8 bits of
 .Em status
 are preserved and returned to the parent via
-.Xr wait 2 Ns .)
+.Xr wait 2 . )
 .It
 The parent process-ID of all of the calling process's existing child
 processes are set to 1; the initialization process

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Tue Oct 18 02:31:39 UTC 2022

Modified Files:
src/lib/libc/sys: _exit.2

Log Message:
Note that the exit status may be truncated to the least significant 8 bits.


To generate a diff of this commit:
cvs rdiff -u -r1.18 -r1.19 src/lib/libc/sys/_exit.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/_exit.2
diff -u src/lib/libc/sys/_exit.2:1.18 src/lib/libc/sys/_exit.2:1.19
--- src/lib/libc/sys/_exit.2:1.18	Mon Sep  8 17:54:34 2003
+++ src/lib/libc/sys/_exit.2	Tue Oct 18 02:31:39 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: _exit.2,v 1.18 2003/09/08 17:54:34 wiz Exp $
+.\"	$NetBSD: _exit.2,v 1.19 2022/10/18 02:31:39 jschauma Exp $
 .\"
 .\" Copyright (c) 1980, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)_exit.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd April 23, 2002
+.Dd October 17, 2022
 .Dt EXIT 2
 .Os
 .Sh NAME
@@ -68,6 +68,10 @@ the
 .Em status
 is set as defined by
 .Xr wait 2 .
+(Note that only the least significant 8 bits of
+.Em status
+are preserved and returned to the parent via
+.Xr wait 2 Ns .)
 .It
 The parent process-ID of all of the calling process's existing child
 processes are set to 1; the initialization process

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Tue Oct 18 02:31:39 UTC 2022

Modified Files:
src/lib/libc/sys: _exit.2

Log Message:
Note that the exit status may be truncated to the least significant 8 bits.


To generate a diff of this commit:
cvs rdiff -u -r1.18 -r1.19 src/lib/libc/sys/_exit.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Mon Oct 17 18:41:06 UTC 2022

Modified Files:
src/lib/libc/sys: wait.2

Log Message:
add missing 'the'


To generate a diff of this commit:
cvs rdiff -u -r1.40 -r1.41 src/lib/libc/sys/wait.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/wait.2
diff -u src/lib/libc/sys/wait.2:1.40 src/lib/libc/sys/wait.2:1.41
--- src/lib/libc/sys/wait.2:1.40	Mon Sep  2 00:12:11 2019
+++ src/lib/libc/sys/wait.2	Mon Oct 17 18:41:06 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: wait.2,v 1.40 2019/09/02 00:12:11 sevan Exp $
+.\"	$NetBSD: wait.2,v 1.41 2022/10/17 18:41:06 jschauma Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993, 1994
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)wait.2	8.2 (Berkeley) 4/19/94
 .\"
-.Dd September 2, 2019
+.Dd October 17, 2022
 .Dt WAIT 2
 .Os
 .Sh NAME
@@ -410,7 +410,7 @@ structure contains the full 32 bit exit 
 .Xr _exit 2 ;
 the
 .Fa status
-argument of other calls only returns 8 lowest bits of the exit status.
+argument of other calls only returns the 8 lowest bits of the exit status.
 .Pp
 When the
 .Dv WNOHANG

CVS commit: src/lib/libc/sys

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Mon Oct 17 18:41:06 UTC 2022

Modified Files:
src/lib/libc/sys: wait.2

Log Message:
add missing 'the'


To generate a diff of this commit:
cvs rdiff -u -r1.40 -r1.41 src/lib/libc/sys/wait.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sun Oct 16 20:37:03 UTC 2022

Modified Files:
src/lib/libc/sys: gettimeofday.2

Log Message:
Add EINVAL doc from Jan Schaumann


To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 src/lib/libc/sys/gettimeofday.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/gettimeofday.2
diff -u src/lib/libc/sys/gettimeofday.2:1.29 src/lib/libc/sys/gettimeofday.2:1.30
--- src/lib/libc/sys/gettimeofday.2:1.29	Wed Dec  9 03:30:03 2015
+++ src/lib/libc/sys/gettimeofday.2	Sun Oct 16 16:37:03 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: gettimeofday.2,v 1.29 2015/12/09 08:30:03 wiz Exp $
+.\"	$NetBSD: gettimeofday.2,v 1.30 2022/10/16 20:37:03 christos 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 December 8, 2015
+.Dd October 16, 2022
 .Dt GETTIMEOFDAY 2
 .Os
 .Sh NAME
@@ -133,6 +133,12 @@ The following error codes may be set in
 .Bl -tag -width Er
 .It Bq Er EFAULT
 An argument address referenced invalid memory.
+.It Bq Er EINVAL
+.Fn settimeofday :
+.Ar tp.tv_sec
+is outside the range [0..2^36] or
+.Ar tp.tv_usec
+is outside the range [0..999,999].
 .It Bq Er EPERM
 A user other than the super user attempted to set the time, or the specified
 time was less than the current time, which was not permitted at the current

CVS commit: src/lib/libc/sys

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Sun Oct 16 20:37:03 UTC 2022

Modified Files:
src/lib/libc/sys: gettimeofday.2

Log Message:
Add EINVAL doc from Jan Schaumann


To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 src/lib/libc/sys/gettimeofday.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Mon Aug  1 14:22:32 UTC 2022

Modified Files:
src/lib/libc/sys: clone.2

Log Message:
clone(2): document that _GNU_SOURCE must be defined for the prototypes


To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/lib/libc/sys/clone.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/clone.2
diff -u src/lib/libc/sys/clone.2:1.14 src/lib/libc/sys/clone.2:1.15
--- src/lib/libc/sys/clone.2:1.14	Tue May 12 11:39:08 2020
+++ src/lib/libc/sys/clone.2	Mon Aug  1 14:22:32 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: clone.2,v 1.14 2020/05/12 11:39:08 kamil Exp $
+.\"	$NetBSD: clone.2,v 1.15 2022/08/01 14:22:32 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 12, 2020
+.Dd August 1, 2022
 .Dt CLONE 2
 .Os
 .Sh NAME
@@ -37,6 +37,7 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
+.Fd #define _GNU_SOURCE
 .In sched.h
 .Ft pid_t
 .Fn clone "int (*func)(void *arg)" "void *stack" "int flags" "void *arg"

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Mon Aug  1 14:22:32 UTC 2022

Modified Files:
src/lib/libc/sys: clone.2

Log Message:
clone(2): document that _GNU_SOURCE must be defined for the prototypes


To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/lib/libc/sys/clone.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Sun Jul 31 06:21:42 UTC 2022

Modified Files:
src/lib/libc/sys: __quotactl.2

Log Message:
__quotactl(2): typo.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/libc/sys/__quotactl.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/__quotactl.2
diff -u src/lib/libc/sys/__quotactl.2:1.3 src/lib/libc/sys/__quotactl.2:1.4
--- src/lib/libc/sys/__quotactl.2:1.3	Mon Feb 13 19:50:15 2012
+++ src/lib/libc/sys/__quotactl.2	Sun Jul 31 06:21:41 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: __quotactl.2,v 1.3 2012/02/13 19:50:15 dholland Exp $
+.\"	$NetBSD: __quotactl.2,v 1.4 2022/07/31 06:21:41 dholland Exp $
 .\"
 .\" Copyright (c) 1983, 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -275,7 +275,7 @@ for more information.
 Normally
 quotaon 8
 is run during the boot sequence after
-quotacheck 8 .
+.Xr quotacheck 8 .
 Also see
 .Xr quota_quotaon 3 .
 .\" 

CVS commit: src/lib/libc/sys

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Sun Jul 31 06:21:42 UTC 2022

Modified Files:
src/lib/libc/sys: __quotactl.2

Log Message:
__quotactl(2): typo.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/libc/sys/__quotactl.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jul 26 00:25:45 UTC 2022

Modified Files:
src/lib/libc/sys: mincore.2

Log Message:
mincore(2) - use .Rv -std


To generate a diff of this commit:
cvs rdiff -u -r1.20 -r1.21 src/lib/libc/sys/mincore.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mincore.2
diff -u src/lib/libc/sys/mincore.2:1.20 src/lib/libc/sys/mincore.2:1.21
--- src/lib/libc/sys/mincore.2:1.20	Mon Jul 25 22:50:42 2022
+++ src/lib/libc/sys/mincore.2	Tue Jul 26 00:25:45 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mincore.2,v 1.20 2022/07/25 22:50:42 riastradh Exp $
+.\"	$NetBSD: mincore.2,v 1.21 2022/07/26 00:25:45 uwe Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -65,10 +65,7 @@ In order to guarantee
 that pages will remain in core, the address range must be locked with
 .Xr mlock 2 .
 .Sh RETURN VALUES
-.Fn mincore
-returns 0 on success, or \-1 on failure and sets the variable
-.Va errno
-to indicate the error.
+.Rv -std mincore
 .Sh ERRORS
 The
 .Fn mincore

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Tue Jul 26 00:25:45 UTC 2022

Modified Files:
src/lib/libc/sys: mincore.2

Log Message:
mincore(2) - use .Rv -std


To generate a diff of this commit:
cvs rdiff -u -r1.20 -r1.21 src/lib/libc/sys/mincore.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Mon Jul 25 22:50:42 UTC 2022

Modified Files:
src/lib/libc/sys: mincore.2

Log Message:
mincore(2): Clarify units of len argument: bytes, not pages.

Minor tidying while here:

- Use .Fa, not .Ar, for function arguments.
- Reduce verbiage of opening sentence.


To generate a diff of this commit:
cvs rdiff -u -r1.19 -r1.20 src/lib/libc/sys/mincore.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/mincore.2
diff -u src/lib/libc/sys/mincore.2:1.19 src/lib/libc/sys/mincore.2:1.20
--- src/lib/libc/sys/mincore.2:1.19	Thu May 13 10:20:58 2004
+++ src/lib/libc/sys/mincore.2	Mon Jul 25 22:50:42 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mincore.2,v 1.19 2004/05/13 10:20:58 wiz Exp $
+.\"	$NetBSD: mincore.2,v 1.20 2022/07/25 22:50:42 riastradh Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -44,14 +44,16 @@
 .Sh DESCRIPTION
 The
 .Fn mincore
-system call
-allows a process to obtain information about whether pages are
-core resident.
+system call tells whether the pages covering
+.Fa len
+bytes of data starting at
+.Fa addr
+are core resident in the process.
 The status of the memory range is returned in the character-per-page array
-.Ar vec .
+.Fa vec .
 If the page is resident, the least significant bit of the corresponding
 character in
-.Ar vec
+.Fa vec
 will be set.
 Other bits are reserved for additional information
 which future implementations may return.
@@ -73,13 +75,13 @@ The
 call will fail if:
 .Bl -tag -width Er
 .It Bq Er EFAULT
-.Ar vec
+.Fa vec
 points to an illegal address.
 .It Bq Er EINVAL
-.Ar addr
+.Fa addr
 is not a multiple of the system page size.
 .It Bq Er EINVAL
-.Ar len
+.Fa len
 is equal to 0.
 .It Bq Er ENOMEM
 The address range specified is invalid for the calling process,

CVS commit: src/lib/libc/sys

[Taylor R Campbell]

Module Name:src
Committed By:   riastradh
Date:   Mon Jul 25 22:50:42 UTC 2022

Modified Files:
src/lib/libc/sys: mincore.2

Log Message:
mincore(2): Clarify units of len argument: bytes, not pages.

Minor tidying while here:

- Use .Fa, not .Ar, for function arguments.
- Reduce verbiage of opening sentence.


To generate a diff of this commit:
cvs rdiff -u -r1.19 -r1.20 src/lib/libc/sys/mincore.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Roland Illig]

Module Name:src
Committed By:   rillig
Date:   Tue Jun 28 20:24:08 UTC 2022

Modified Files:
src/lib/libc/sys: bind.2

Log Message:
bind.2: add references to specific protocol families

Referring the reader to "the manual entries in section 4" was too
unspecific to be useful, as that section contains device drivers as
well.


To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/lib/libc/sys/bind.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/bind.2
diff -u src/lib/libc/sys/bind.2:1.31 src/lib/libc/sys/bind.2:1.32
--- src/lib/libc/sys/bind.2:1.31	Sun Mar 28 03:29:31 2021
+++ src/lib/libc/sys/bind.2	Tue Jun 28 20:24:08 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: bind.2,v 1.31 2021/03/28 03:29:31 dholland Exp $
+.\"	$NetBSD: bind.2,v 1.32 2022/06/28 20:24:08 rillig Exp $
 .\"
 .\" Copyright (c) 1983, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)bind.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd March 27, 2021
+.Dd June 28, 2022
 .Dt BIND 2
 .Os
 .Sh NAME
@@ -133,7 +133,9 @@ The name would reside on a read-only fil
 .Xr connect 2 ,
 .Xr getsockname 2 ,
 .Xr listen 2 ,
-.Xr socket 2
+.Xr socket 2 ,
+.Xr inet 4 ,
+.Xr inet6 4
 .Sh HISTORY
 The
 .Fn bind

CVS commit: src/lib/libc/sys

[Roland Illig]

Module Name:src
Committed By:   rillig
Date:   Tue Jun 28 20:24:08 UTC 2022

Modified Files:
src/lib/libc/sys: bind.2

Log Message:
bind.2: add references to specific protocol families

Referring the reader to "the manual entries in section 4" was too
unspecific to be useful, as that section contains device drivers as
well.


To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/lib/libc/sys/bind.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Sat May 21 01:38:14 UTC 2022

Modified Files:
src/lib/libc/sys: sigaction.2

Log Message:
fix typo in sigaction(2)


To generate a diff of this commit:
cvs rdiff -u -r1.51 -r1.52 src/lib/libc/sys/sigaction.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Sat May 21 01:38:14 UTC 2022

Modified Files:
src/lib/libc/sys: sigaction.2

Log Message:
fix typo in sigaction(2)


To generate a diff of this commit:
cvs rdiff -u -r1.51 -r1.52 src/lib/libc/sys/sigaction.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/sigaction.2
diff -u src/lib/libc/sys/sigaction.2:1.51 src/lib/libc/sys/sigaction.2:1.52
--- src/lib/libc/sys/sigaction.2:1.51	Tue May 22 05:39:44 2018
+++ src/lib/libc/sys/sigaction.2	Sat May 21 01:38:14 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: sigaction.2,v 1.51 2018/05/22 05:39:44 wiz Exp $
+.\"	$NetBSD: sigaction.2,v 1.52 2022/05/21 01:38:14 dholland Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -287,7 +287,7 @@ flag in
 .Xr termios 4 .
 .El
 .Pp
-If the signal handler is called due to signal delively resulting from reasons
+If the signal handler is called due to signal delivery resulting from reasons
 other than direct calls to
 .Xr kill 2
 or

CVS commit: src/lib/libc/sys

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Thu Mar 24 01:52:48 UTC 2022

Modified Files:
src/lib/libc/sys: fork.2

Log Message:
fork.2: add _exit(2) xref and spell "ID" consistently


To generate a diff of this commit:
cvs rdiff -u -r1.25 -r1.26 src/lib/libc/sys/fork.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/fork.2
diff -u src/lib/libc/sys/fork.2:1.25 src/lib/libc/sys/fork.2:1.26
--- src/lib/libc/sys/fork.2:1.25	Sun Sep  1 19:40:07 2019
+++ src/lib/libc/sys/fork.2	Thu Mar 24 01:52:48 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: fork.2,v 1.25 2019/09/01 19:40:07 sevan Exp $
+.\"	$NetBSD: fork.2,v 1.26 2022/03/24 01:52:48 gutteridge Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -117,11 +117,12 @@ This limit is configuration-dependent; o
 the limit
 .Dv RLIMIT_NPROC
 on the total number of
-processes under execution by this user id would be exceeded.
+processes under execution by this user ID would be exceeded.
 .It Bq Er ENOMEM
 There is insufficient swap space for the new process.
 .El
 .Sh SEE ALSO
+.Xr _exit 2 ,
 .Xr execve 2 ,
 .Xr setrlimit 2 ,
 .Xr vfork 2 ,

CVS commit: src/lib/libc/sys

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Thu Mar 24 01:52:48 UTC 2022

Modified Files:
src/lib/libc/sys: fork.2

Log Message:
fork.2: add _exit(2) xref and spell "ID" consistently


To generate a diff of this commit:
cvs rdiff -u -r1.25 -r1.26 src/lib/libc/sys/fork.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Wed Mar 16 00:50:41 UTC 2022

Modified Files:
src/lib/libc/sys: setpgid.2

Log Message:
setpgid.2: Mention that both child and parent need to call it.

Absence of this standard info was noticed by riastradh@.


To generate a diff of this commit:
cvs rdiff -u -r1.23 -r1.24 src/lib/libc/sys/setpgid.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[David A. Holland]

Module Name:src
Committed By:   dholland
Date:   Wed Mar 16 00:50:41 UTC 2022

Modified Files:
src/lib/libc/sys: setpgid.2

Log Message:
setpgid.2: Mention that both child and parent need to call it.

Absence of this standard info was noticed by riastradh@.


To generate a diff of this commit:
cvs rdiff -u -r1.23 -r1.24 src/lib/libc/sys/setpgid.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/setpgid.2
diff -u src/lib/libc/sys/setpgid.2:1.23 src/lib/libc/sys/setpgid.2:1.24
--- src/lib/libc/sys/setpgid.2:1.23	Fri Sep 19 16:02:58 2014
+++ src/lib/libc/sys/setpgid.2	Wed Mar 16 00:50:40 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: setpgid.2,v 1.23 2014/09/19 16:02:58 wiz Exp $
+.\"	$NetBSD: setpgid.2,v 1.24 2022/03/16 00:50:40 dholland Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)setpgid.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd December 18, 2003
+.Dd March 15, 2022
 .Dt SETPGID 2
 .Os
 .Sh NAME
@@ -62,6 +62,14 @@ is used instead.
 If the invoker is not the super-user, then the affected process
 must have the same effective user-id as the invoker or be a descendant
 of the invoking process.
+.Pp
+In general to set the process group of a newly forked subprocess, both
+the child and parent processes should call
+.Fn setpgid
+to ensure that the process group change takes effect in a timely
+fashion.
+One call will succeed and the other will fail, depending on process
+scheduling.
 .Sh RETURN VALUES
 .Fn setpgid
 returns 0 when the operation was successful.

CVS commit: src/lib/libc/sys

[Paul Goyette]

Module Name:src
Committed By:   pgoyette
Date:   Sun Feb 13 16:51:56 UTC 2022

Modified Files:
src/lib/libc/sys: kqueue.2

Log Message:
Fix typo


To generate a diff of this commit:
cvs rdiff -u -r1.57 -r1.58 src/lib/libc/sys/kqueue.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/kqueue.2
diff -u src/lib/libc/sys/kqueue.2:1.57 src/lib/libc/sys/kqueue.2:1.58
--- src/lib/libc/sys/kqueue.2:1.57	Sat Oct 23 01:28:34 2021
+++ src/lib/libc/sys/kqueue.2	Sun Feb 13 16:51:56 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: kqueue.2,v 1.57 2021/10/23 01:28:34 thorpej Exp $
+.\"	$NetBSD: kqueue.2,v 1.58 2022/02/13 16:51:56 pgoyette Exp $
 .\"
 .\" Copyright (c) 2000 Jonathan Lemon
 .\" All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\" $FreeBSD: src/lib/libc/sys/kqueue.2,v 1.22 2001/06/27 19:55:57 dd Exp $
 .\"
-.Dd October 22, 2021
+.Dd February 13, 2022
 .Dt KQUEUE 2
 .Os
 .Sh NAME
@@ -462,7 +462,7 @@ The file referenced by the descriptor wa
 .It Dv NOTE_LINK
 The link count on the file changed.
 .It Dv NOTE_OPEN
-The file refrenced by the descriptor was opened.
+The file referenced by the descriptor was opened.
 .It Dv NOTE_READ
 A read occurred on the file referenced by the descriptor.
 .It Dv NOTE_RENAME

CVS commit: src/lib/libc/sys

[Paul Goyette]

Module Name:src
Committed By:   pgoyette
Date:   Sun Feb 13 16:51:56 UTC 2022

Modified Files:
src/lib/libc/sys: kqueue.2

Log Message:
Fix typo


To generate a diff of this commit:
cvs rdiff -u -r1.57 -r1.58 src/lib/libc/sys/kqueue.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Nov 19 23:51:17 UTC 2021

Modified Files:
src/lib/libc/sys: chmod.2

Log Message:
Mention that fchmod conforms to XPG 4.2. Bump date.


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/lib/libc/sys/chmod.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/chmod.2
diff -u src/lib/libc/sys/chmod.2:1.48 src/lib/libc/sys/chmod.2:1.49
--- src/lib/libc/sys/chmod.2:1.48	Sun Sep  1 19:13:57 2019
+++ src/lib/libc/sys/chmod.2	Fri Nov 19 23:51:16 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: chmod.2,v 1.48 2019/09/01 19:13:57 sevan Exp $
+.\"	$NetBSD: chmod.2,v 1.49 2021/11/19 23:51:16 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)chmod.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd September 1, 2019
+.Dd November 20, 2021
 .Dt CHMOD 2
 .Os
 .Sh NAME
@@ -283,6 +283,11 @@ The
 .Fn chmod
 function conforms to
 .St -p1003.1-90 .
+The
+.Fn fchmod
+function conforms to
+.St -xpg4.2 .
+The
 .Fn fchmodat
 function conforms to
 .St -p1003.1-2008 .

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Nov 19 23:51:17 UTC 2021

Modified Files:
src/lib/libc/sys: chmod.2

Log Message:
Mention that fchmod conforms to XPG 4.2. Bump date.


To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/lib/libc/sys/chmod.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Mon Nov  1 05:29:35 UTC 2021

Modified Files:
src/lib/libc/sys: sigaltstack.2

Log Message:
Don't mention the "struct sigaltstack" name of "stack_t".


To generate a diff of this commit:
cvs rdiff -u -r1.25 -r1.26 src/lib/libc/sys/sigaltstack.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/sigaltstack.2
diff -u src/lib/libc/sys/sigaltstack.2:1.25 src/lib/libc/sys/sigaltstack.2:1.26
--- src/lib/libc/sys/sigaltstack.2:1.25	Mon Jul  3 21:32:50 2017
+++ src/lib/libc/sys/sigaltstack.2	Mon Nov  1 05:29:35 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: sigaltstack.2,v 1.25 2017/07/03 21:32:50 wiz Exp $
+.\"	$NetBSD: sigaltstack.2,v 1.26 2021/11/01 05:29:35 thorpej Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)sigaltstack.2	8.2 (Berkeley) 5/1/95
 .\"
-.Dd March 2, 2012
+.Dd October 31, 2021
 .Dt SIGALTSTACK 2
 .Os
 .Sh NAME
@@ -40,7 +40,7 @@
 .Sh SYNOPSIS
 .In signal.h
 .Bd -literal
-typedef struct sigaltstack {
+typedef struct {
 	void   *ss_sp;
 	size_t	ss_size;
 	int ss_flags;

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Mon Nov  1 05:29:35 UTC 2021

Modified Files:
src/lib/libc/sys: sigaltstack.2

Log Message:
Don't mention the "struct sigaltstack" name of "stack_t".


To generate a diff of this commit:
cvs rdiff -u -r1.25 -r1.26 src/lib/libc/sys/sigaltstack.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Wed Oct 27 04:48:34 UTC 2021

Modified Files:
src/lib/libc/sys: __sigaction14_sigtramp.c

Log Message:
- Use the signal trampoline version constants from .
- Declare the sigtramp externs as as char arrays, not int arrays; not all
  platforms have fixed-sized 32-bit instructions.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/__sigaction14_sigtramp.c

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/__sigaction14_sigtramp.c
diff -u src/lib/libc/sys/__sigaction14_sigtramp.c:1.1 src/lib/libc/sys/__sigaction14_sigtramp.c:1.2
--- src/lib/libc/sys/__sigaction14_sigtramp.c:1.1	Tue Oct 26 16:16:36 2021
+++ src/lib/libc/sys/__sigaction14_sigtramp.c	Wed Oct 27 04:48:33 2021
@@ -1,4 +1,4 @@
-/*	$NetBSD: __sigaction14_sigtramp.c,v 1.1 2021/10/26 16:16:36 christos Exp $	*/
+/*	$NetBSD: __sigaction14_sigtramp.c,v 1.2 2021/10/27 04:48:33 thorpej Exp $	*/
 
 /*-
  * Copyright (c) 2002 The NetBSD Foundation, Inc.
@@ -31,7 +31,7 @@
 
 #include 
 #if defined(LIBC_SCCS) && !defined(lint)
-__RCSID("$NetBSD: __sigaction14_sigtramp.c,v 1.1 2021/10/26 16:16:36 christos Exp $");
+__RCSID("$NetBSD: __sigaction14_sigtramp.c,v 1.2 2021/10/27 04:48:33 thorpej Exp $");
 #endif /* LIBC_SCCS and not lint */
 
 #include 
@@ -41,12 +41,6 @@ __RCSID("$NetBSD: __sigaction14_sigtramp
 
 #include "extern.h"
 
-#ifndef __SIGTRAMP_SIGCONTEXT_VERSION
-#define __SIGTRAMP_SIGCONTEXT_VERSION 1
-#endif
-#ifndef __SIGTRAMP_SIGINFO_VERSION
-#define __SIGTRAMP_SIGINFO_VERSION 2
-#endif
 #define C(a,b) __CONCAT(a,b)
 #define __SIGTRAMP_SIGCONTEXT  \
 C(__sigtramp_sigcontext_,__SIGTRAMP_SIGCONTEXT_VERSION)
@@ -60,7 +54,7 @@ __weak_alias(__sigaction14, __libc_sigac
 int
 __libc_sigaction14(int sig, const struct sigaction *act, struct sigaction *oact)
 {
-	extern const int __SIGTRAMP_SIGINFO[];
+	extern const char __SIGTRAMP_SIGINFO[];
 
 	/*
 	 * If no sigaction, use the "default" trampoline since it won't
@@ -75,7 +69,7 @@ __libc_sigaction14(int sig, const struct
 	 * set in the sigaction.
 	 */
 	if ((act->sa_flags & SA_SIGINFO) == 0) {
-		extern const int __SIGTRAMP_SIGCONTEXT[];
+		extern const char __SIGTRAMP_SIGCONTEXT[];
 		int sav = errno;
 		int rv =  __sigaction_sigtramp(sig, act, oact,
 		__SIGTRAMP_SIGCONTEXT, __SIGTRAMP_SIGCONTEXT_VERSION);

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Wed Oct 27 04:48:34 UTC 2021

Modified Files:
src/lib/libc/sys: __sigaction14_sigtramp.c

Log Message:
- Use the signal trampoline version constants from .
- Declare the sigtramp externs as as char arrays, not int arrays; not all
  platforms have fixed-sized 32-bit instructions.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/__sigaction14_sigtramp.c

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Wed Oct 20 03:26:20 UTC 2021

Modified Files:
src/lib/libc/sys: kqueue.2

Log Message:
Oops, forgot to note the history of NOTE_OPEN, NOTE_CLOSE, NOTE_CLOSE_WRITE,
and NOTE_READ.


To generate a diff of this commit:
cvs rdiff -u -r1.55 -r1.56 src/lib/libc/sys/kqueue.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/kqueue.2
diff -u src/lib/libc/sys/kqueue.2:1.55 src/lib/libc/sys/kqueue.2:1.56
--- src/lib/libc/sys/kqueue.2:1.55	Wed Oct 20 03:08:19 2021
+++ src/lib/libc/sys/kqueue.2	Wed Oct 20 03:26:20 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: kqueue.2,v 1.55 2021/10/20 03:08:19 thorpej Exp $
+.\"	$NetBSD: kqueue.2,v 1.56 2021/10/20 03:26:20 thorpej Exp $
 .\"
 .\" Copyright (c) 2000 Jonathan Lemon
 .\" All rights reserved.
@@ -860,3 +860,14 @@ filter flags for
 .Dv EVFILT_TIMER
 was added in
 .Nx 10.0 .
+.Pp
+Support for
+.Dv NOTE_OPEN ,
+.Dv NOTE_CLOSE ,
+.Dv NOTE_CLOSE_WRITE ,
+and
+NOTE_READ
+filter flags for
+.Dv EVFILT_VNODE
+was added in
+.Nx 10.0 .

CVS commit: src/lib/libc/sys

[Jason R Thorpe]

Module Name:src
Committed By:   thorpej
Date:   Wed Oct 20 03:26:20 UTC 2021

Modified Files:
src/lib/libc/sys: kqueue.2

Log Message:
Oops, forgot to note the history of NOTE_OPEN, NOTE_CLOSE, NOTE_CLOSE_WRITE,
and NOTE_READ.


To generate a diff of this commit:
cvs rdiff -u -r1.55 -r1.56 src/lib/libc/sys/kqueue.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:59:27 UTC 2021

Modified Files:
src/lib/libc/sys: timerfd.2

Log Message:
Spell the number of nanoseconds as 10^9.  Forgotten in previous.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/libc/sys/timerfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/timerfd.2
diff -u src/lib/libc/sys/timerfd.2:1.3 src/lib/libc/sys/timerfd.2:1.4
--- src/lib/libc/sys/timerfd.2:1.3	Thu Sep 23 13:58:26 2021
+++ src/lib/libc/sys/timerfd.2	Thu Sep 23 13:59:27 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: timerfd.2,v 1.3 2021/09/23 13:58:26 uwe Exp $
+.\" $NetBSD: timerfd.2,v 1.4 2021/09/23 13:59:27 uwe Exp $
 .\"
 .\" Copyright (c) 2021 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -266,8 +266,8 @@ argument.
 .It Bq Er EINVAL
 A nanosecond field in the
 .Fa tim
-argument specified a value less than zero or greater than or equal to
-.Dv 10e9 .
+argument specified a value less than zero or greater than or equal
+to\~10^9.
 .El
 .Pp
 A read from a

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:59:27 UTC 2021

Modified Files:
src/lib/libc/sys: timerfd.2

Log Message:
Spell the number of nanoseconds as 10^9.  Forgotten in previous.


To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/libc/sys/timerfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:58:26 UTC 2021

Modified Files:
src/lib/libc/sys: timerfd.2

Log Message:
Minor markup tweaks.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/lib/libc/sys/timerfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/timerfd.2
diff -u src/lib/libc/sys/timerfd.2:1.2 src/lib/libc/sys/timerfd.2:1.3
--- src/lib/libc/sys/timerfd.2:1.2	Sun Sep 19 17:10:41 2021
+++ src/lib/libc/sys/timerfd.2	Thu Sep 23 13:58:26 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: timerfd.2,v 1.2 2021/09/19 17:10:41 wiz Exp $
+.\" $NetBSD: timerfd.2,v 1.3 2021/09/23 13:58:26 uwe Exp $
 .\"
 .\" Copyright (c) 2021 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -30,12 +30,16 @@
 .Dd September 17, 2021
 .Dt TIMERFD 2
 .Os
+.\"
+.\"
 .Sh NAME
 .Nm timerfd ,
 .Nm timerfd_create ,
 .Nm timerfd_gettime ,
 .Nm timerfd_settime
 .Nd create and interact with a timer descriptor
+.\"
+.\"
 .Sh SYNOPSIS
 .In sys/timerfd.h
 .Ft int
@@ -45,6 +49,8 @@
 .Ft int
 .Fn timerfd_settime "int fd" "int flags" \
 "const struct itimerspec *tim" "struct itimerspec *otim"
+.\"
+.\"
 .Sh DESCRIPTION
 .Nm
 presents an interface to interval timers associated with a file descriptor.
@@ -75,7 +81,7 @@ are
 and
 .Dv CLOCK_MONOTONIC .
 The following flags define the behavior of the resulting object:
-.Bl -tag -width "TFD_NONBLOCK"
+.Bl -tag -width Dv
 .It Dv TFD_CLOEXEC
 This is an alias for the
 .Dv O_CLOEXEC
@@ -96,12 +102,10 @@ timer expires, an internal counter is in
 Reads from an
 .Nm
 object return the value of this counter in the caller's buffer as an
-unsigned 64-bit integer and reset the counter to
-.Dv 0 .
+unsigned 64-bit integer and reset the counter to\~0.
 If the value of the
 .Nm
-object's counter is
-.Dv 0 ,
+object's counter is\~0,
 then reads will block, unless the
 .Nm
 object is set for non-blocking I/O.
@@ -123,8 +127,7 @@ see
 specified in the
 .Fa tim
 argument.
-If the value is
-.Dv 0 ,
+If the value is\~0,
 the timer is disarmed.
 If the argument
 .Fa otim
@@ -173,24 +176,19 @@ system call returns the current settings
 object in the
 .Fa tim
 argument.
+.\"
+.\"
 .Sh RETURN VALUES
 The
 .Fn timerfd_create
-system call returns
-.Dv -1
-if an error occurs, otherwise the return value is a descriptor representing the
+system call returns\~\-1 if an error occurs,
+otherwise the return value is a descriptor representing the
 .Nm
 object.
 .Pp
-The
-.Fn timerfd_gettime
-and
-.Fn timerfd_settime
-system calls return
-.Dv 0
-upon success or
-.Dv -1
-if an error occurs.
+.Rv -std timerfd_gettime timerfd_settime
+.\"
+.\"
 .Sh ERRORS
 The
 .Fn timerfd
@@ -299,6 +297,8 @@ or
 The size of the read buffer is less than 8 bytes
 .Pq the size required to hold an unsigned 64-bit integer .
 .El
+.\"
+.\"
 .Sh SEE ALSO
 .Xr clock_settime 2 ,
 .Xr close 2 ,
@@ -311,6 +311,8 @@ The size of the read buffer is less than
 .Xr timer_create 2 ,
 .Xr timer_gettime 2 ,
 .Xr timer_settime 2
+.\"
+.\"
 .Sh HISTORY
 The
 .Nm

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:58:26 UTC 2021

Modified Files:
src/lib/libc/sys: timerfd.2

Log Message:
Minor markup tweaks.


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/lib/libc/sys/timerfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:49:59 UTC 2021

Modified Files:
src/lib/libc/sys: timer_settime.2

Log Message:
Spell the number of nanoseconds as 10^9.

10^9 is 1e9 (it's "e" that spells 10 here), not 10e9.  The target
audience of this man page is not likely to be very fluent in floating
point, so avoid significand/exponent spelling and use the spelling
that it is familiar with.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/lib/libc/sys/timer_settime.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/timer_settime.2
diff -u src/lib/libc/sys/timer_settime.2:1.9 src/lib/libc/sys/timer_settime.2:1.10
--- src/lib/libc/sys/timer_settime.2:1.9	Tue Nov  6 23:25:44 2012
+++ src/lib/libc/sys/timer_settime.2	Thu Sep 23 13:49:59 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: timer_settime.2,v 1.9 2012/11/06 23:25:44 wiz Exp $
+.\"	$NetBSD: timer_settime.2,v 1.10 2021/09/23 13:49:59 uwe Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -160,7 +160,8 @@ function will fail if:
 .It Bq Er EINVAL
 A nanosecond field in the
 .Ar tim
-structure specified a value less than zero or greater than or equal to 10e9.
+structure specified a value less than zero or greater than or equal
+to\~10^9.
 .El
 .Sh SEE ALSO
 .Xr clock_gettime 2 ,

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:49:59 UTC 2021

Modified Files:
src/lib/libc/sys: timer_settime.2

Log Message:
Spell the number of nanoseconds as 10^9.

10^9 is 1e9 (it's "e" that spells 10 here), not 10e9.  The target
audience of this man page is not likely to be very fluent in floating
point, so avoid significand/exponent spelling and use the spelling
that it is familiar with.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/lib/libc/sys/timer_settime.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:16:13 UTC 2021

Modified Files:
src/lib/libc/sys: eventfd.2

Log Message:
Markup fixes.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/eventfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/eventfd.2
diff -u src/lib/libc/sys/eventfd.2:1.1 src/lib/libc/sys/eventfd.2:1.2
--- src/lib/libc/sys/eventfd.2:1.1	Sun Sep 19 15:51:28 2021
+++ src/lib/libc/sys/eventfd.2	Thu Sep 23 13:16:13 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: eventfd.2,v 1.1 2021/09/19 15:51:28 thorpej Exp $
+.\" $NetBSD: eventfd.2,v 1.2 2021/09/23 13:16:13 uwe Exp $
 .\"
 .\" Copyright (c) 2021 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -30,11 +30,15 @@
 .Dd September 17, 2021
 .Dt EVENTFD 2
 .Os
+.\"
+.\"
 .Sh NAME
 .Nm eventfd ,
 .Nm eventfd_read ,
 .Nm eventfd_write
 .Nd create and interact with a counting event descriptor
+.\"
+.\"
 .Sh SYNOPSIS
 .In sys/eventfd.h
 .Ft int
@@ -43,6 +47,8 @@
 .Fn eventfd_read "int efd" "eventfd_t *valp"
 .Ft int
 .Fn eventfd_write "int efd" "eventfd_t val"
+.\"
+.\"
 .Sh DESCRIPTION
 The
 .Nm
@@ -52,10 +58,7 @@ respectively.
 When the object's value is non-zero, the file descriptor is considered
 .Dq readable ,
 and when the count is less than the maximum value
-.Po
-.Dv UINT64_MAX
-- 1
-.Pc
+.Li UINT64_MAX\^-\^1
 it is considered
 .Dq writable .
 When an
@@ -65,11 +68,11 @@ object is no longer needed, it may be di
 .Pp
 All I/O to an
 .Nm
-object is 8 bytes in length, which is the space required to store an
+object is 8\~bytes in length, which is the space required to store an
 unsigned 64-bit integer.
-Any read or write with a buffer smaller than 8 bytes will fail with
-.Dv EINVAL .
-Only the first 8 bytes of the buffer will be used.
+Any read or write with a buffer smaller than 8\~bytes will fail with
+.Er EINVAL .
+Only the first 8\~bytes of the buffer will be used.
 .Pp
 The
 .Fn eventfd
@@ -79,7 +82,7 @@ The initial value of the object is speci
 .Fa val
 argument.
 The following flags define the behavior of the resulting object:
-.Bl -tag -width "EFD_SEMAPHORE"
+.Bl -tag -width Dv
 .It Dv EFD_CLOEXEC
 This is an alias for the
 .Dv O_CLOEXEC
@@ -111,24 +114,20 @@ If the
 .Nm
 object was created in
 .Dq semaphore mode ,
-reads return the value
-.Dv 1
-and object's counter is decremented by
-.Dv 1 .
+reads return the value\~1
+and object's counter is decremented by\~1.
 .It
 If the
 .Nm
 object was not created in
 .Dq semaphore mode ,
 reads return the current value of the object's counter
-reset the counter to
-.Dv 0 .
+and reset the counter to\~0.
 .El
 .Pp
 If the value of the
 .Nm
-object's counter is
-.Dv 0 ,
+object's counter is\~0,
 then reads will block, unless the
 .Nm
 object is set for non-blocking I/O.
@@ -155,37 +154,32 @@ objects, and are simply wrappers around 
 and
 .Xr write 2
 system calls:
-.Bl -tag -width "eventfd_writeXX"
-.It Fn eventfd_read
+.Bl -tag -width Fn
+.It Fn eventfd_read efd valp
 Reads the unsigned 64-bit integer value of the
 .Nm
 object and returns it in
 .Fa valp .
-.It Fn eventfd_write
+.It Fn eventfd_write efd val
 Writes the unsigned 64-bit integer value
 .Fa val
 to the
 .Nm
 object.
 .El
+.\"
+.\"
 .Sh RETURN VALUES
 The
 .Fn eventfd
-system call returns
-.Dv -1
-if an error occurs, otherwise the return value is a descriptor representing the
+system call returns\~\-1 if an error occurs,
+otherwise the return value is a descriptor representing the
 .Nm
 object.
 .Pp
-The
-.Fn eventfd_read
-and
-.Fn eventfd_write
-functions return
-.Dv 0
-upon success or
-.Dv -1
-if an error occurs.
+.Rv -std eventfd_read eventfd_write
+.\"
+.\"
 .Sh ERRORS
 The
 .Fn eventfd
@@ -213,9 +207,7 @@ function fails if:
 .It Bq Er EAGAIN
 The value of the
 .Nm
-object is
-.Dv 0
-and the
+object is\~0 and the
 .Nm
 object is set for non-blocking I/O.
 .El
@@ -230,10 +222,7 @@ The resulting value of the
 object after adding the value
 .Fa val
 would exceed the maximum value
-.Po
-.Dv UINT64_MAX
-- 1
-.Pc
+.Li UINT64_MAX\^-\^1
 and the
 .Nm
 object is set for non-blocking I/O.
@@ -250,9 +239,11 @@ a read from or write to an
 object fails if:
 .Bl -tag -width Er
 .It Bq Er EINVAL
-The size of the buffer is less than 8 bytes
+The size of the buffer is less than 8\~bytes
 .Pq the size required to hold an unsigned 64-bit integer .
 .El
+.\"
+.\"
 .Sh SEE ALSO
 .Xr close 2 ,
 .Xr kevent 2 ,
@@ -261,6 +252,8 @@ The size of the buffer is less than 8 by
 .Xr read 2 ,
 .Xr select 2 ,
 .Xr write 2
+.\"
+.\"
 .Sh HISTORY
 The
 .Nm

CVS commit: src/lib/libc/sys

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu Sep 23 13:16:13 UTC 2021

Modified Files:
src/lib/libc/sys: eventfd.2

Log Message:
Markup fixes.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/eventfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sun Sep 19 17:10:42 UTC 2021

Modified Files:
src/lib/libc/sys: timerfd.2

Log Message:
Sort errors, remove extra comma.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/timerfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/lib/libc/sys/timerfd.2
diff -u src/lib/libc/sys/timerfd.2:1.1 src/lib/libc/sys/timerfd.2:1.2
--- src/lib/libc/sys/timerfd.2:1.1	Sun Sep 19 15:51:28 2021
+++ src/lib/libc/sys/timerfd.2	Sun Sep 19 17:10:41 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: timerfd.2,v 1.1 2021/09/19 15:51:28 thorpej Exp $
+.\" $NetBSD: timerfd.2,v 1.2 2021/09/19 17:10:41 wiz Exp $
 .\"
 .\" Copyright (c) 2021 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .Nm timerfd ,
 .Nm timerfd_create ,
 .Nm timerfd_gettime ,
-.Nm timerfd_settime ,
+.Nm timerfd_settime
 .Nd create and interact with a timer descriptor
 .Sh SYNOPSIS
 .In sys/timerfd.h
@@ -225,16 +225,16 @@ system call fails if:
 The argument
 .Fa fd
 is not a valid file descriptor.
+.It Bq Er EFAULT
+The
+.Fa tim
+argument points outside the allocated address space.
 .It Bq Er EINVAL
 The argument
 .Fa fd
 does not refer to a
 .Nm timerfd
 object.
-.It Bq Er EFAULT
-The
-.Fa tim
-argument points outside the allocated address space.
 .El
 .Pp
 The
@@ -245,6 +245,12 @@ system call fails if:
 The argument
 .Fa fd
 is not a valid file descriptor.
+.It Bq Er EFAULT
+The
+.Fa tim
+or
+.Fa otim
+arguments point outside the allocated address space.
 .It Bq Er EINVAL
 The argument
 .Fa fd
@@ -264,21 +270,12 @@ A nanosecond field in the
 .Fa tim
 argument specified a value less than zero or greater than or equal to
 .Dv 10e9 .
-.It Bq Er EFAULT
-The
-.Fa tim
-or
-.Fa otim
-arguments point outside the allocated address space.
 .El
 .Pp
 A read from a
 .Nm
 object fails if:
 .Bl -tag -width Er
-.It Bq Er EINVAL
-The size of the read buffer is less than 8 bytes
-.Pq the size required to hold an unsigned 64-bit integer .
 .It Bq Er EAGAIN
 The value of the
 .Nm
@@ -298,6 +295,9 @@ flag, and the system realtime clock was 
 .Xr clock_settime 2
 or
 .Xr settimeofday 2 .
+.It Bq Er EINVAL
+The size of the read buffer is less than 8 bytes
+.Pq the size required to hold an unsigned 64-bit integer .
 .El
 .Sh SEE ALSO
 .Xr clock_settime 2 ,

CVS commit: src/lib/libc/sys

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Sun Sep 19 17:10:42 UTC 2021

Modified Files:
src/lib/libc/sys: timerfd.2

Log Message:
Sort errors, remove extra comma.


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libc/sys/timerfd.2

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.