CVS commit: src/lib/libc/sys
Module Name:src Committed By: christos Date: Thu Oct 3 16:59:15 UTC 2024 Modified Files: src/lib/libc/sys: Makefile.inc Log Message: typo To generate a diff of this commit: cvs rdiff -u -r1.256 -r1.257 src/lib/libc/sys/Makefile.inc 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/Makefile.inc diff -u src/lib/libc/sys/Makefile.inc:1.256 src/lib/libc/sys/Makefile.inc:1.257 --- src/lib/libc/sys/Makefile.inc:1.256 Thu Oct 3 12:58:17 2024 +++ src/lib/libc/sys/Makefile.inc Thu Oct 3 12:59:15 2024 @@ -1,4 +1,4 @@ -# $NetBSD: Makefile.inc,v 1.256 2024/10/03 16:58:17 christos Exp $ +# $NetBSD: Makefile.inc,v 1.257 2024/10/03 16:59:15 christos Exp $ # @(#)Makefile.inc 8.3 (Berkeley) 10/24/94 # sys sources @@ -383,7 +383,7 @@ MLINKS+=setuid.2 setegid.2 setuid.2 sete MLINKS+=shmat.2 shmdt.2 MLINKS+=symlink.2 symlinkat.2 MLINKS+=timer_settime.2 timer_gettime.2 timer_settime.2 timer_getoverrun.2 -MLINKS+=semop2. semtimedop.2 +MLINKS+=semop.2 semtimedop.2 MLINKS+=sigqueue.2 sigqueueinfo.2 MLINKS+=sigtimedwait.2 sigwaitinfo.2 MLINKS+=sigtimedwait.2 sigwait.2
CVS commit: src/lib/libc/sys
Module Name:src Committed By: christos Date: Thu Oct 3 16:59:15 UTC 2024 Modified Files: src/lib/libc/sys: Makefile.inc Log Message: typo To generate a diff of this commit: cvs rdiff -u -r1.256 -r1.257 src/lib/libc/sys/Makefile.inc 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
Module Name:src
Committed By: christos
Date: Thu Oct 3 16:58:17 UTC 2024
Modified Files:
src/lib/libc/sys: Makefile.inc semop.2
Log Message:
new semtimedop(2) GSoC 2024 (Shivraj Jamgade)
To generate a diff of this commit:
cvs rdiff -u -r1.255 -r1.256 src/lib/libc/sys/Makefile.inc
cvs rdiff -u -r1.17 -r1.18 src/lib/libc/sys/semop.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/Makefile.inc
diff -u src/lib/libc/sys/Makefile.inc:1.255 src/lib/libc/sys/Makefile.inc:1.256
--- src/lib/libc/sys/Makefile.inc:1.255 Sun May 19 21:30:33 2024
+++ src/lib/libc/sys/Makefile.inc Thu Oct 3 12:58:17 2024
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile.inc,v 1.255 2024/05/20 01:30:33 christos Exp $
+# $NetBSD: Makefile.inc,v 1.256 2024/10/03 16:58:17 christos Exp $
# @(#)Makefile.inc 8.3 (Berkeley) 10/24/94
# sys sources
@@ -146,7 +146,7 @@ ASM=\
__quotactl.S \
rasctl.S readlinkat.S reboot.S \
rename.S renameat.S revoke.S rmdir.S \
- semconfig.S semget.S semop.S \
+ semconfig.S semget.S semop.S semtimedop.S \
setegid.S seteuid.S \
setgid.S setgroups.S __setitimer50.S __setlogin.S setpgid.S \
setpriority.S \
@@ -383,6 +383,7 @@ MLINKS+=setuid.2 setegid.2 setuid.2 sete
MLINKS+=shmat.2 shmdt.2
MLINKS+=symlink.2 symlinkat.2
MLINKS+=timer_settime.2 timer_gettime.2 timer_settime.2 timer_getoverrun.2
+MLINKS+=semop2. semtimedop.2
MLINKS+=sigqueue.2 sigqueueinfo.2
MLINKS+=sigtimedwait.2 sigwaitinfo.2
MLINKS+=sigtimedwait.2 sigwait.2
Index: src/lib/libc/sys/semop.2
diff -u src/lib/libc/sys/semop.2:1.17 src/lib/libc/sys/semop.2:1.18
--- src/lib/libc/sys/semop.2:1.17 Mon Mar 22 15:30:55 2010
+++ src/lib/libc/sys/semop.2 Thu Oct 3 12:58:17 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: semop.2,v 1.17 2010/03/22 19:30:55 joerg Exp $
+.\" $NetBSD: semop.2,v 1.18 2024/10/03 16:58:17 christos Exp $
.\"
.\" Copyright (c) 1995 Frank van der Linden
.\" All rights reserved.
@@ -29,11 +29,11 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd November 3, 2005
+.Dd October 3, 2024
.Dt SEMOP 2
.Os
.Sh NAME
-.Nm semop
+.Nm semop, semtimedop
.Nd semaphore operations
.Sh LIBRARY
.Lb libc
@@ -41,6 +41,8 @@
.In sys/sem.h
.Ft int
.Fn semop "int semid" "struct sembuf *sops" "size_t nsops"
+.Ft int
+.Fn semtimedop "int semid" "struct sembuf *sops" "size_t nsops" "struct timespec *timeout"
.Sh DESCRIPTION
.Fn semop
provides a number of atomic operations on a set of semaphores.
@@ -114,9 +116,37 @@ This is useful to prevent other processe
forever, should the process that has the semaphore locked terminate in a
critical section.
.El
+.Pp
+.Fn semtimedop
+is similar to
+.Fn semop ,
+but it also allows specifying a timeout.
+When the semaphore is not available,
+the thread typically sleeps until the semaphore is available.
+.Fn semtimedop
+allows specifying a maximum amount of time in
+.Fa timeout
+argument that a thread should sleep while waiting for the semaphore to be available.
+If the specified time limit has been reached,
+.Fn semtimedop
+fails with
+.Er EAGAIN
+(and none of the operations in
+.Fa sops
+are performed).
+If
+.Fa timeout
+is
+.Dv NULL ,
+.Fn semtimedop
+behaves exactly like
+.Fn semop .
.Sh RETURN VALUES
-Upon successful completion, a value of 0 is returned.
-Otherwise, \-1 is returned and the global variable
+Upon successful completion both
+.Fn semop
+and
+.Fn semtimedop
+return a value of 0. Otherwise, \-1 is returned and the global variable
.Va errno
is set to indicate the error.
.Sh ERRORS
@@ -156,7 +186,56 @@ was set in
.It Bq Er EFAULT
.Fa sops
points to an illegal address.
+.It Bq Er EINTR
+While blocked in this system call, the thread caught a signal.
.El
+.Pp
+In addition,
+.Fn semtimedop
+will fail if:
+.Bl -tag -width Er
+.It Bq Er EAGAIN
+An operation could not proceed immediately and either
+.Dv IPC_NOWAIT
+was specified in
+.Va sem_flg
+or the time limit specified in
+.Fa timeout
+expired.
+.It Bq Er EFAULT
+An address specified in the
+.Fa timeout
+argument isn't accessible.
+.El
+.Sh EXAMPLES
+The following example shows how to perform a semaphore operation with a timeout:
+.Bd -literal -offset indent
+
+/* Performs a semaphore operation with a 5 sec timeout*/
+
+struct sembuf sops[1];/* Semaphore operation structure */
+struct timespec timeout; /* Timeout structure */
+
+/* Create semaphore set with 1 semaphore */
+int semid = semget(key, 1, 0666 | IPC_CREAT);
+
+/* Initialize semaphore to 0 */
+if (semctl(semid, 0, SETVAL, 0) == -1) {
+warn("semctl SETVAL");
+exit(EXIT_FAILURE);
+}
+
+sops[0].sem_num = 0; /* Operation on semaphore 0 */
+sops[0].sem_op = -1; /* Decrement semaphore by 1 */
+sops[0].sem_flg = 0; /* No flags */
+
+timeout.tv_sec = 5; /* 5 seconds */
+timeout.tv_nsec = 0;
CVS commit: src/lib/libc/sys
Module Name:src Committed By: christos Date: Thu Oct 3 16:58:17 UTC 2024 Modified Files: src/lib/libc/sys: Makefile.inc semop.2 Log Message: new semtimedop(2) GSoC 2024 (Shivraj Jamgade) To generate a diff of this commit: cvs rdiff -u -r1.255 -r1.256 src/lib/libc/sys/Makefile.inc cvs rdiff -u -r1.17 -r1.18 src/lib/libc/sys/semop.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
Module Name:src Committed By: riastradh Date: Mon Sep 9 01:20:20 UTC 2024 Modified Files: src/lib/libc/sys: select.2 Log Message: select(2): Cite standards conformance in man page. (Should we cite the earliest standard, or the most recent standard, if they're the same as far as anyone has noticed?) PR standards/4: the history and standards conformance of pselect(2) is not documented To generate a diff of this commit: cvs rdiff -u -r1.45 -r1.46 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.45 src/lib/libc/sys/select.2:1.46 --- src/lib/libc/sys/select.2:1.45 Tue Aug 1 23:33:04 2023 +++ src/lib/libc/sys/select.2 Mon Sep 9 01:20:20 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: select.2,v 1.45 2023/08/01 23:33:04 gutteridge Exp $ +.\" $NetBSD: select.2,v 1.46 2024/09/09 01:20:20 riastradh 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 August 1, 2023 +.Dd September 9, 2024 .Dt SELECT 2 .Os .Sh NAME @@ -268,6 +268,21 @@ One of its components is negative or too .Xr send 2 , .Xr write 2 , .Xr getdtablesize 3 +.Sh STANDARDS +The +.Fn select +function, along with +.Fn FD_CLR , +.Fn FD_ISSET , +.Fn FD_SET , and +.Fn FD_ZERO , +conforms to +.St -xpg4.2 . +.Pp +The +.Fn pselect +function conforms to +.St -p1003.1-2004 . .Sh HISTORY The .Fn select
CVS commit: src/lib/libc/sys
Module Name:src Committed By: riastradh Date: Mon Sep 9 01:20:20 UTC 2024 Modified Files: src/lib/libc/sys: select.2 Log Message: select(2): Cite standards conformance in man page. (Should we cite the earliest standard, or the most recent standard, if they're the same as far as anyone has noticed?) PR standards/4: the history and standards conformance of pselect(2) is not documented To generate a diff of this commit: cvs rdiff -u -r1.45 -r1.46 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
Module Name:src Committed By: uwe Date: Sat Jul 20 13:12:19 UTC 2024 Modified Files: src/lib/libc/sys: link.2 Log Message: link(2): links to directories are refused at the VFS level Drop the condition that "the caller is the super-user and the file system ... supports linking to directories." >From nabijaczleweli. To generate a diff of this commit: cvs rdiff -u -r1.33 -r1.34 src/lib/libc/sys/link.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/link.2 diff -u src/lib/libc/sys/link.2:1.33 src/lib/libc/sys/link.2:1.34 --- src/lib/libc/sys/link.2:1.33 Sun Sep 1 19:52:32 2019 +++ src/lib/libc/sys/link.2 Sat Jul 20 13:12:19 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: link.2,v 1.33 2019/09/01 19:52:32 sevan Exp $ +.\" $NetBSD: link.2,v 1.34 2024/07/20 13:12:19 uwe Exp $ .\" .\" Copyright (c) 1980, 1991, 1993, 2011 .\" The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\" .\" @(#)link.2 8.3 (Berkeley) 1/12/94 .\" -.Dd September 1, 2019 +.Dd July 20, 2024 .Dt LINK 2 .Os .Sh NAME @@ -78,8 +78,7 @@ and .Fa name2 must be in the same file system. .Fa name1 -may not be a directory unless the caller is the super-user -and the file system containing it supports linking to directories. +may not be a directory. .Pp .Fn linkat works the same way as @@ -188,11 +187,7 @@ does not support links. .It Bq Er EPERM The file named by .Fa name1 -is a directory and the effective -user ID is not super-user, -or the file system containing the file does not permit the use of -.Fn link -on a directory. +is a directory. .It Bq Er EROFS The requested link requires writing in a directory on a read-only file system.
CVS commit: src/lib/libc/sys
Module Name:src Committed By: uwe Date: Sat Jul 20 13:12:19 UTC 2024 Modified Files: src/lib/libc/sys: link.2 Log Message: link(2): links to directories are refused at the VFS level Drop the condition that "the caller is the super-user and the file system ... supports linking to directories." >From nabijaczleweli. To generate a diff of this commit: cvs rdiff -u -r1.33 -r1.34 src/lib/libc/sys/link.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
Module Name:src Committed By: rin Date: Sat Jul 6 02:23:39 UTC 2024 Modified Files: src/lib/libc/sys: dup.2 Log Message: dup(2): Trailing whitespace To generate a diff of this commit: cvs rdiff -u -r1.34 -r1.35 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.34 src/lib/libc/sys/dup.2:1.35 --- src/lib/libc/sys/dup.2:1.34 Sun May 19 16:04:46 2024 +++ src/lib/libc/sys/dup.2 Sat Jul 6 02:23:39 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: dup.2,v 1.34 2024/05/19 16:04:46 christos Exp $ +.\" $NetBSD: dup.2,v 1.35 2024/07/06 02:23:39 rin Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -117,10 +117,10 @@ and can to some extent be adjusted with .Pp The .Fn dup3 -call fails and returns +call fails and returns .Er EINVAL if the numeric value in the -.Ar oldfd +.Ar oldfd argument is equal to the one in the .Ar newfd argument.
CVS commit: src/lib/libc/sys
Module Name:src Committed By: rin Date: Sat Jul 6 02:23:39 UTC 2024 Modified Files: src/lib/libc/sys: dup.2 Log Message: dup(2): Trailing whitespace To generate a diff of this commit: cvs rdiff -u -r1.34 -r1.35 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
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
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
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 \&#! -.Em interpreter -.Bq Em arg +.Bd -ragged -offset indent +.Ic \&#! Ns Ar interpreter Op Ar arg .Ed .Pp When an interpreter file is -.Sy execve Ap d , +.Nm Ap d , the system actually -.Sy execve Ap s +.Nm Ap s the specified -.Em interpreter . +.Ar interpreter . If the optional -.Em arg +.Ar arg is specified, it becomes the first argument to the -.Em interpreter , +.Ar interpreter , and the name of the originally -.Sy execve Ap d +.Nm Ap d file becomes the second argument; otherwise, the name of the originally -.Sy execve Ap d +.Nm Ap d file becomes the first argument. The original arguments are shifted over to become the subsequent arguments. The zeroth argument, normally the name of the -.Fn execve Ns d +.Nm Ap d file, is left unchanged. The interpreter named by -.Em interpreter +.Ar interpreter must not itself be an interpreter file. (See .Xr script 7 @@ -127,8 +124,8 @@ character pointers to null-terminated st A pointer to this array is normally stored in the global variable .Va environ . These strings pass information to the -new process that is not directly an argument to the command (see -.Xr environ 7 ) . +new process that is not directly an argument to the command +.Pq see Xr environ 7 . .Pp File descriptors open in the calling process image remain open in the new process image, except for those for which the close-on-exec @@ -140,12 +137,18 @@ Descriptors that remain open are unaffec .Fn execve . .Pp In the case of a new setuid or setgid executable being executed, if -file descriptors 0, 1, or 2 (representing stdin, stdout, and stderr) +file descriptors 0, 1, or 2 +.Po +representing +.Em stdin , stdout , +and +.Em stderr +.Pc are currently unallocated, these descriptors will be opened to point to some system file like .Pa /dev/null . The intent is to ensure these descriptors are not unallocated, since -many libraries make assumptions about the use of these 3 file descriptors. +many libraries make assumptions about the use of these three file descriptors. .Pp Signals set to be ignored in the calling process are set to be ignored in the new process. @@ -157,8 +160,7 @@ The signal stack is reset to be undefine for more information). .Pp If the set-user-ID mode bit of the new process image file is set -(see -.Xr chmod 2 ) , +.Pq see Xr chmod 2 , the effective user ID of the new process image is set to the owner ID of the new process image file. If the set-group-ID mode bit of the new process image file is set, @@ -171,8 +173,8 @@ process image. After any set-user-ID and set-group-ID processing, the effective user ID is recorded as the saved set-user-ID, and the effective group ID is recorded as the saved set-group-ID. -These values may be used in changing the effective IDs later (see -.Xr setuid 2 ) . +These values may be used in changing the effective IDs later +.Pq see Xr setuid 2 . The set-ID bits are not honored if the respective file system has the .Cm nosuid option enabled or if the new process file is an interpreter file. @@ -182,20 +184,19 @@ tracing is disabled if effective IDs are The new process also inherits the following attributes from the calling process: .Pp -.Bl -column parent_process_ID -offset indent -compact -.It process ID Ta see Xr getpid 2 +.Bl -column "parent process ID" -offset indent -compact +.It process IDTa see Xr getpid 2 .It parent process ID Ta see Xr getppid 2 -.It process group ID Ta see Xr getpgrp 2 -.It access groups Ta see Xr getgroups 2 +.It process group ID Ta see Xr getpgrp 2 +.It access groups Ta see Xr getgroups 2 .It working directory Ta see Xr chdir 2 -.It root directory Ta see Xr chroot 2 -.It control terminal Ta see Xr termios 4 -.It resource usages Ta see Xr getrusage 2 -.It interval timers Ta see Xr getitimer 2 -.It resource limits Ta see Xr getrlimit 2 -.It file mode mask Ta see Xr umask 2 -.It signal mask Ta see Xr sigaction 2 , -.Xr sigprocmask 2 +.It root directoryTa see Xr chroot 2 +.It
CVS commit: src/lib/libc/sys
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.
