From: Alejandro Colomar Date: Mon, 14 Apr 2025 20:16:10 +0000 (+0200) Subject: man/man2/: STANDARDS: Update system calls for POSIX.1-2024 X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=6f0dc5dc5cab630184bd0cd7d3ab63794091cd22;p=thirdparty%2Fman-pages.git man/man2/: STANDARDS: Update system calls for POSIX.1-2024 Signed-off-by: Alejandro Colomar --- diff --git a/man/man2/_exit.2 b/man/man2/_exit.2 index 9d6c2505c..e1f264c95 100644 --- a/man/man2/_exit.2 +++ b/man/man2/_exit.2 @@ -58,15 +58,17 @@ These functions do not return. .SH STANDARDS .TP .BR _exit () -POSIX.1-2008. +POSIX.1-2024. .TP .BR _Exit () -C11, POSIX.1-2008. +C11, POSIX.1-2024. .SH HISTORY +.TP +.BR _exit () POSIX.1-2001, SVr4, 4.3BSD. -.P +.TP .BR _Exit () -was introduced by C99. +C99, POSIX.1-2001. .SH NOTES For a discussion on the effects of an exit, the transmission of exit status, zombie processes, signals sent, and so on, see diff --git a/man/man2/accept.2 b/man/man2/accept.2 index 8f70e8b4d..4b495bc19 100644 --- a/man/man2/accept.2 +++ b/man/man2/accept.2 @@ -266,12 +266,7 @@ of file status flags and always explicitly set all required flags on the socket returned from .BR accept (). .SH STANDARDS -.TP -.BR accept () -POSIX.1-2008. -.TP -.BR accept4 () -Linux. +POSIX.1-2024. .SH HISTORY .TP .BR accept () @@ -286,6 +281,7 @@ first appeared in 4.2BSD). .\" In addition, SUSv2 documents EFAULT and ENOSR. .TP .BR accept4 () +POSIX.1-2024. Linux 2.6.28, glibc 2.10. .SH NOTES diff --git a/man/man2/access.2 b/man/man2/access.2 index c41871b05..1549e7fc2 100644 --- a/man/man2/access.2 +++ b/man/man2/access.2 @@ -322,7 +322,7 @@ argument. .BR access () .TQ .BR faccessat () -POSIX.1-2008. +POSIX.1-2024. .TP .BR faccessat2 () Linux. diff --git a/man/man2/alarm.2 b/man/man2/alarm.2 index 322fcb843..6fb8e73fe 100644 --- a/man/man2/alarm.2 +++ b/man/man2/alarm.2 @@ -35,7 +35,7 @@ returns the number of seconds remaining until any previously scheduled alarm was due to be delivered, or zero if there was no previously scheduled alarm. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. .SH NOTES diff --git a/man/man2/bind.2 b/man/man2/bind.2 index 5d44c152a..f338a18ca 100644 --- a/man/man2/bind.2 +++ b/man/man2/bind.2 @@ -177,12 +177,17 @@ A component of the path prefix is not a directory. The socket inode would reside on a read-only filesystem. .P Other errors may be generated by the underlying protocol modules. +.SH VERSIONS +Portable programs must ensure that +.I addr.sun_path +is a null-terminated string +for +.B AF_UNIX +sockets. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.4BSD -.RB ( bind () -first appeared in 4.2BSD). +POSIX.1-2001, SVr4, 4.2BSD. .\" SVr4 documents an additional .\" .B ENOSR .\" general error condition, and diff --git a/man/man2/chdir.2 b/man/man2/chdir.2 index f0e674427..83702d2af 100644 --- a/man/man2/chdir.2 +++ b/man/man2/chdir.2 @@ -101,7 +101,7 @@ is not a valid file descriptor. .I fd does not refer to a directory. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD. .SH NOTES diff --git a/man/man2/chmod.2 b/man/man2/chmod.2 index d2d91b7d8..424d37d5c 100644 --- a/man/man2/chmod.2 +++ b/man/man2/chmod.2 @@ -339,7 +339,7 @@ that corresponds to the .I dirfd argument. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR chmod () diff --git a/man/man2/chown.2 b/man/man2/chown.2 index 88c780236..98fb5365c 100644 --- a/man/man2/chown.2 +++ b/man/man2/chown.2 @@ -274,7 +274,7 @@ used only by the superuser (that is, ordinary users cannot give away files). .\" SVr4 documents additional EINVAL, EIO, EINTR, and ENOLINK .\" error conditions. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR chown () diff --git a/man/man2/clock_getres.2 b/man/man2/clock_getres.2 index 8698477a8..27f0d09bc 100644 --- a/man/man2/clock_getres.2 +++ b/man/man2/clock_getres.2 @@ -365,7 +365,7 @@ On some architectures, an implementation of is provided in the .BR vdso (7). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SUSv2. Linux 2.6. @@ -389,6 +389,10 @@ are available. (See also .BR sysconf (3).) .\" +.P +POSIX.1-2024 made +.B CLOCK_MONOTONIC +mandatory. .SS Historical note for SMP systems Before Linux added kernel support for .B CLOCK_PROCESS_CPUTIME_ID diff --git a/man/man2/clock_nanosleep.2 b/man/man2/clock_nanosleep.2 index 74811f980..2181434f2 100644 --- a/man/man2/clock_nanosleep.2 +++ b/man/man2/clock_nanosleep.2 @@ -172,7 +172,7 @@ is not a permitted value for The kernel does not support sleeping against this .IR clockid . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. Linux 2.6, diff --git a/man/man2/connect.2 b/man/man2/connect.2 index 997739ce5..15d248fac 100644 --- a/man/man2/connect.2 +++ b/man/man2/connect.2 @@ -207,12 +207,17 @@ The server may be too busy to accept new connections. Note that for IP sockets the timeout may be very long when syncookies are enabled on the server. +.SH VERSIONS +Portable programs must ensure that +.I addr.sun_path +is a null-terminated string +for +.B AF_UNIX +sockets. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.4BSD, -.RB ( connect () -first appeared in 4.2BSD). +POSIX.1-2001, SVr4, 4.2BSD. .\" SVr4 documents the additional .\" general error codes .\" .BR EADDRNOTAVAIL , diff --git a/man/man2/dup.2 b/man/man2/dup.2 index 21635730e..a2ecf4ae3 100644 --- a/man/man2/dup.2 +++ b/man/man2/dup.2 @@ -189,14 +189,7 @@ in .B ENOMEM Insufficient kernel memory was available. .SH STANDARDS -.TP -.BR dup () -.TQ -.BR dup2 () -POSIX.1-2008. -.TP -.BR dup3 () -Linux. +POSIX.1-2024. .SH HISTORY .TP .BR dup () @@ -208,6 +201,7 @@ POSIX.1-2001, SVr4, 4.3BSD. .\" The EBUSY return is Linux-specific. .TP .BR dup3 () +POSIX.1-2024. Linux 2.6.27, glibc 2.9. .SH NOTES diff --git a/man/man2/execve.2 b/man/man2/execve.2 index 2dba25222..4b116ff23 100644 --- a/man/man2/execve.2 +++ b/man/man2/execve.2 @@ -612,7 +612,7 @@ are used to delimit the arguments. Linux (like most other modern UNIX systems) ignores the set-user-ID and set-group-ID bits on scripts. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. .\" SVr4 documents additional error diff --git a/man/man2/fcntl.2 b/man/man2/fcntl.2 index 9a76bdb7b..7f34e332e 100644 --- a/man/man2/fcntl.2 +++ b/man/man2/fcntl.2 @@ -130,7 +130,7 @@ and .BR F_DUPFD_CLOFORK , but Linux doesn't support them. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .\" .P .\" SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. .SH HISTORY diff --git a/man/man2/fcntl_locking.2 b/man/man2/fcntl_locking.2 index ba37877f6..6e17f0a7f 100644 --- a/man/man2/fcntl_locking.2 +++ b/man/man2/fcntl_locking.2 @@ -557,27 +557,24 @@ was not specified as zero. Too many segment locks open, lock table is full, or a remote locking protocol failed (e.g., locking over NFS). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .\" .P .\" SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. -.P -.BR F_OFD_SETLK , -.BR F_OFD_SETLKW , -and -.B F_OFD_GETLK -are Linux-specific (and one must define -.B _GNU_SOURCE -to obtain their definitions), -but work is being done to have them included in the next version of POSIX.1. .SH HISTORY -SVr4, 4.3BSD, POSIX.1-2001. -.P -Only the operations -.BR F_GETLK , -.BR F_SETLK , -and +.TP +.B F_GETLK +.TQ +.B F_SETLK +.TQ .B F_SETLKW -are specified in POSIX.1-2001. +SVr4, 4.3BSD, POSIX.1-2001. +.TP +.B F_OFD_SETLK +.TQ +.B F_OFD_SETLKW +.TQ +.B F_OFD_GETLK +POSIX.1-2024. .SH NOTES .SS File locking The original Linux diff --git a/man/man2/fsync.2 b/man/man2/fsync.2 index 89a923296..80461ec3a 100644 --- a/man/man2/fsync.2 +++ b/man/man2/fsync.2 @@ -147,7 +147,7 @@ to a value greater than 0. .\" -1: unavailable, 0: ask using sysconf(). .\" glibc defines them to 1. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.2BSD. .P diff --git a/man/man2/getgid.2 b/man/man2/getgid.2 index af384ad61..e56523ada 100644 --- a/man/man2/getgid.2 +++ b/man/man2/getgid.2 @@ -44,7 +44,7 @@ See .BR syscall (2) for details regarding register mapping. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.3BSD. .P diff --git a/man/man2/getgroups.2 b/man/man2/getgroups.2 index 635158282..396f1f0a7 100644 --- a/man/man2/getgroups.2 +++ b/man/man2/getgroups.2 @@ -149,7 +149,7 @@ For details, see .SH STANDARDS .TP .BR getgroups () -POSIX.1-2008. +POSIX.1-2024. .TP .BR setgroups () None. diff --git a/man/man2/gethostname.2 b/man/man2/gethostname.2 index c21c3ce1f..cc2b372b0 100644 --- a/man/man2/gethostname.2 +++ b/man/man2/gethostname.2 @@ -138,13 +138,13 @@ in this case, a terminating null byte is not included in the returned .SH STANDARDS .TP .BR gethostname () -POSIX.1-2008. +POSIX.1-2024. .TP .BR sethostname () None. .SH HISTORY SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). -POSIX.1-2001 and POSIX.1-2008 specify +POSIX.1 specifies .BR gethostname () but not .BR sethostname (). diff --git a/man/man2/getitimer.2 b/man/man2/getitimer.2 index 01d106cbc..b214ed35a 100644 --- a/man/man2/getitimer.2 +++ b/man/man2/getitimer.2 @@ -177,10 +177,10 @@ fields are zero; that is, the timer is disabled. .IR "Don't use this Linux misfeature" : it is nonportable and unnecessary. .SH STANDARDS -POSIX.1-2008. +None. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). -POSIX.1-2008 marks +POSIX.1-2008 marked .BR getitimer () and .BR setitimer () @@ -188,6 +188,7 @@ obsolete, recommending the use of the POSIX timers API .RB ( timer_gettime (2), .BR timer_settime (2), etc.) instead. +POSIX.1-2024 removed them. .SH NOTES Timers will never expire before the requested time, but may expire some (short) time afterward, which depends diff --git a/man/man2/getpeername.2 b/man/man2/getpeername.2 index c36738242..16beb3a18 100644 --- a/man/man2/getpeername.2 +++ b/man/man2/getpeername.2 @@ -68,7 +68,7 @@ The file descriptor .I sockfd does not refer to a socket. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD (first appeared in 4.2BSD). diff --git a/man/man2/getpid.2 b/man/man2/getpid.2 index f0ec3f1ff..2ae00557c 100644 --- a/man/man2/getpid.2 +++ b/man/man2/getpid.2 @@ -51,7 +51,7 @@ See .BR syscall (2) for details regarding register mapping. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.3BSD, SVr4. .SS C library/kernel differences diff --git a/man/man2/getpriority.2 b/man/man2/getpriority.2 index ada4fd3f7..d4e6c2838 100644 --- a/man/man2/getpriority.2 +++ b/man/man2/getpriority.2 @@ -136,7 +136,7 @@ and .I who values specified. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). diff --git a/man/man2/getrlimit.2 b/man/man2/getrlimit.2 index e4341cc28..3c055c006 100644 --- a/man/man2/getrlimit.2 +++ b/man/man2/getrlimit.2 @@ -527,7 +527,7 @@ T} Thread safety MT-Safe .BR getrlimit () .TQ .BR setrlimit () -POSIX.1-2008. +POSIX.1-2024. .TP .BR prlimit () Linux. diff --git a/man/man2/getrusage.2 b/man/man2/getrusage.2 index 34e81f540..8711b06ac 100644 --- a/man/man2/getrusage.2 +++ b/man/man2/getrusage.2 @@ -182,7 +182,7 @@ T{ T} Thread safety MT-Safe .TE .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .P POSIX.1 specifies .BR getrusage (), diff --git a/man/man2/getsid.2 b/man/man2/getsid.2 index b83e16704..7688dd27c 100644 --- a/man/man2/getsid.2 +++ b/man/man2/getsid.2 @@ -58,7 +58,7 @@ was found. Linux does not return .BR EPERM . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. Linux 2.0. diff --git a/man/man2/getsockname.2 b/man/man2/getsockname.2 index 1bce1360c..a7ca8573b 100644 --- a/man/man2/getsockname.2 +++ b/man/man2/getsockname.2 @@ -64,10 +64,9 @@ The file descriptor .I sockfd does not refer to a socket. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.4BSD -(first appeared in 4.2BSD). +POSIX.1-2001, SVr4, 4.2BSD. .\" SVr4 documents additional ENOMEM .\" and ENOSR error codes. .SH SEE ALSO diff --git a/man/man2/getsockopt.2 b/man/man2/getsockopt.2 index f30657705..b962669d4 100644 --- a/man/man2/getsockopt.2 +++ b/man/man2/getsockopt.2 @@ -140,7 +140,7 @@ The file descriptor .I sockfd does not refer to a socket. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD (first appeared in 4.2BSD). diff --git a/man/man2/gettimeofday.2 b/man/man2/gettimeofday.2 index b643573b4..d954a253f 100644 --- a/man/man2/gettimeofday.2 +++ b/man/man2/gettimeofday.2 @@ -172,23 +172,20 @@ but Android does not update the kernel timezone based on the device timezone in Settings, so the kernel's timezone is typically UTC. .SH STANDARDS -.TP -.BR gettimeofday () -POSIX.1-2008 (obsolete). -.TP -.BR settimeofday () None. .SH HISTORY SVr4, 4.3BSD. -POSIX.1-2001 describes +POSIX.1-2001 described .BR gettimeofday () but not .BR settimeofday (). -POSIX.1-2008 marks +POSIX.1-2008 marked .BR gettimeofday () as obsolete, recommending the use of .BR clock_gettime (2) instead. +POSIX.1-2024 removed +.BR gettimeofday (). .P Traditionally, the fields of .I struct timeval diff --git a/man/man2/getuid.2 b/man/man2/getuid.2 index de71632a4..a1dd320fc 100644 --- a/man/man2/getuid.2 +++ b/man/man2/getuid.2 @@ -28,7 +28,7 @@ and never modify .\" 0000511: getuid and friends should not modify errno .IR errno . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.3BSD. .P diff --git a/man/man2/kill.2 b/man/man2/kill.2 index 0a7d307af..255bb29b1 100644 --- a/man/man2/kill.2 +++ b/man/man2/kill.2 @@ -114,7 +114,7 @@ has not yet been .BR wait (2)ed for. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. .SS Linux notes diff --git a/man/man2/link.2 b/man/man2/link.2 index 9fd186e64..5cf47cb71 100644 --- a/man/man2/link.2 +++ b/man/man2/link.2 @@ -379,7 +379,7 @@ and .I newdirfd arguments. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR link () diff --git a/man/man2/listen.2 b/man/man2/listen.2 index beb4585b2..0af616689 100644 --- a/man/man2/listen.2 +++ b/man/man2/listen.2 @@ -79,7 +79,7 @@ The socket is not of a type that supports the .BR listen () operation. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.4BSD (first appeared in 4.2BSD). diff --git a/man/man2/lseek.2 b/man/man2/lseek.2 index e0d997286..74d82a466 100644 --- a/man/man2/lseek.2 +++ b/man/man2/lseek.2 @@ -203,17 +203,15 @@ on a terminal device fails with the error .\" Other systems return the number of written characters, .\" using SEEK_SET to set the counter. (Of written characters.) .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. -.P +.TP .B SEEK_DATA -and +.TQ .B SEEK_HOLE -are nonstandard extensions also present in Solaris, -FreeBSD, and DragonFly BSD; -they are proposed for inclusion in the next POSIX revision (Issue 8). -.\" FIXME . Review http://austingroupbugs.net/view.php?id=415 in the future +POSIX.1-2024; +Solaris, FreeBSD, DragonFly BSD. .SH NOTES See .BR open (2) diff --git a/man/man2/mkdir.2 b/man/man2/mkdir.2 index 84ae28b9d..ac0d4405e 100644 --- a/man/man2/mkdir.2 +++ b/man/man2/mkdir.2 @@ -226,7 +226,7 @@ that corresponds to the .I dirfd argument. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR mkdir () diff --git a/man/man2/mknod.2 b/man/man2/mknod.2 index 0856e2d15..e946db818 100644 --- a/man/man2/mknod.2 +++ b/man/man2/mknod.2 @@ -261,7 +261,7 @@ One should make directories with .BR mkdir (2). .\" and one should make UNIX domain sockets with socket(2) and bind(2). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR mknod () diff --git a/man/man2/mlock.2 b/man/man2/mlock.2 index 9bf711140..5c13459a3 100644 --- a/man/man2/mlock.2 +++ b/man/man2/mlock.2 @@ -300,7 +300,7 @@ and .BR mlockall () .TQ .BR munlockall () -POSIX.1-2008. +POSIX.1-2024. .TP .BR mlock2 () Linux. diff --git a/man/man2/mmap.2 b/man/man2/mmap.2 index 28ad07198..487b32d20 100644 --- a/man/man2/mmap.2 +++ b/man/man2/mmap.2 @@ -729,7 +729,7 @@ wrapper function invokes with a suitably adjusted value for .IR offset . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD. .\" SVr4 documents additional error codes ENXIO and ENODEV. diff --git a/man/man2/mprotect.2 b/man/man2/mprotect.2 index 773d93dc9..e3488c636 100644 --- a/man/man2/mprotect.2 +++ b/man/man2/mprotect.2 @@ -258,7 +258,7 @@ is equivalent to .SH STANDARDS .TP .BR mprotect () -POSIX.1-2008. +POSIX.1-2024. .TP .BR pkey_mprotect () Linux. diff --git a/man/man2/msgctl.2 b/man/man2/msgctl.2 index 2ebc986b6..1d8a8cf0d 100644 --- a/man/man2/msgctl.2 +++ b/man/man2/msgctl.2 @@ -374,7 +374,7 @@ but the caller is not privileged (Linux: does not have the .B CAP_SYS_RESOURCE capability). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .\" SVID does not document the EIDRM error condition. diff --git a/man/man2/msgget.2 b/man/man2/msgget.2 index d92e96d51..8600d6681 100644 --- a/man/man2/msgget.2 +++ b/man/man2/msgget.2 @@ -158,7 +158,7 @@ number of message queues .RB ( MSGMNI ) would be exceeded. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .SS Linux diff --git a/man/man2/msgop.2 b/man/man2/msgop.2 index 6ed8a2038..16c70bb9a 100644 --- a/man/man2/msgop.2 +++ b/man/man2/msgop.2 @@ -437,7 +437,7 @@ were specified in and this kernel was configured without .BR CONFIG_CHECKPOINT_RESTORE . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .P The .B MSG_EXCEPT diff --git a/man/man2/msync.2 b/man/man2/msync.2 index e4a801298..0fefab39b 100644 --- a/man/man2/msync.2 +++ b/man/man2/msync.2 @@ -110,7 +110,7 @@ or in .IR flags . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .P diff --git a/man/man2/nanosleep.2 b/man/man2/nanosleep.2 index 040138e93..4ef2add2b 100644 --- a/man/man2/nanosleep.2 +++ b/man/man2/nanosleep.2 @@ -133,7 +133,7 @@ these time services shall expire when the requested duration elapses, independently of the new or old value of the clock. .RE .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .P diff --git a/man/man2/nice.2 b/man/man2/nice.2 index 8bf17f486..1deaac936 100644 --- a/man/man2/nice.2 +++ b/man/man2/nice.2 @@ -86,7 +86,7 @@ wrapper function provided by glibc provides conformance to POSIX.1 by calling .BR getpriority (2) to obtain the new nice value, which is then returned to the caller. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. .\" SVr4 documents an additional diff --git a/man/man2/open.2 b/man/man2/open.2 index c31ba6c85..dcb71eba6 100644 --- a/man/man2/open.2 +++ b/man/man2/open.2 @@ -1406,7 +1406,7 @@ but Linux doesn't support it. .BR creat () .TQ .BR openat () -POSIX.1-2008. +POSIX.1-2024. .TP .BR openat2 (2) Linux. diff --git a/man/man2/pause.2 b/man/man2/pause.2 index e5d3494c8..c232978b4 100644 --- a/man/man2/pause.2 +++ b/man/man2/pause.2 @@ -35,7 +35,7 @@ is set to .B EINTR a signal was caught and the signal-catching function returned. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. .SH SEE ALSO diff --git a/man/man2/pipe.2 b/man/man2/pipe.2 index 346aeadc7..4f64c452a 100644 --- a/man/man2/pipe.2 +++ b/man/man2/pipe.2 @@ -199,18 +199,14 @@ See .BR syscall (2) for information regarding registers used for storing second file descriptor. .SH STANDARDS -.TP -.BR pipe () -POSIX.1-2008. -.TP -.BR pipe2 () -Linux. +POSIX.1-2024. .SH HISTORY .TP .BR pipe () POSIX.1-2001. .TP .BR pipe2 () +POSIX.1-2024. Linux 2.6.27, glibc 2.9. .SH EXAMPLES diff --git a/man/man2/poll.2 b/man/man2/poll.2 index 85856bb34..0af9781c0 100644 --- a/man/man2/poll.2 +++ b/man/man2/poll.2 @@ -415,16 +415,7 @@ See for a discussion on the differences between the kernel and the libc notion of the sigset. .SH STANDARDS -.TP -.BR poll () -POSIX.1-2008. -.TP -.BR ppoll () -Linux. -.\" FIXME . -.\" ppoll() is proposed for inclusion in POSIX: -.\" https://www.austingroupbugs.net/view.php?id=1263 -.\" NetBSD 3.0 has a pollts() which is like Linux ppoll(). +POSIX.1-2024. .SH HISTORY .TP .BR poll () @@ -438,6 +429,7 @@ wrapper function provides emulation using .BR select (2). .TP .BR ppoll () +POSIX.1-2024. Linux 2.6.16, glibc 2.4. .SH NOTES diff --git a/man/man2/posix_fadvise.2 b/man/man2/posix_fadvise.2 index ed0c91e06..0a124a23a 100644 --- a/man/man2/posix_fadvise.2 +++ b/man/man2/posix_fadvise.2 @@ -212,7 +212,7 @@ hidden from applications by the glibc wrapper function, which invokes the appropriate architecture-specific system call. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .P diff --git a/man/man2/pread.2 b/man/man2/pread.2 index 278e7ec81..17151547f 100644 --- a/man/man2/pread.2 +++ b/man/man2/pread.2 @@ -91,7 +91,7 @@ to any error specified for or .BR lseek (2). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .P diff --git a/man/man2/readlink.2 b/man/man2/readlink.2 index b6c663cd3..5a2004ba5 100644 --- a/man/man2/readlink.2 +++ b/man/man2/readlink.2 @@ -179,7 +179,7 @@ is relative and .I dirfd is a file descriptor referring to a file other than a directory. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR readlink () diff --git a/man/man2/readv.2 b/man/man2/readv.2 index c3b0a7091..d235422f4 100644 --- a/man/man2/readv.2 +++ b/man/man2/readv.2 @@ -391,7 +391,7 @@ These arguments contain, respectively, the low order and high order 32 bits of .BR readv () .TQ .BR writev () -POSIX.1-2008. +POSIX.1-2024. .TP .BR preadv () .TQ diff --git a/man/man2/recv.2 b/man/man2/recv.2 index 3f1439447..10823b3b9 100644 --- a/man/man2/recv.2 +++ b/man/man2/recv.2 @@ -506,10 +506,10 @@ but glibc currently types both as .\" across architectures, but socklen_t is always 32 bits, .\" as (at least with GCC) is int. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, -4.4BSD (first appeared in 4.2BSD). +4.2BSD. .P POSIX.1 describes only the .BR MSG_OOB , diff --git a/man/man2/rename.2 b/man/man2/rename.2 index 619d7e815..b5beef4b8 100644 --- a/man/man2/rename.2 +++ b/man/man2/rename.2 @@ -483,10 +483,10 @@ capability. .SH STANDARDS .TP .BR rename () -C11, POSIX.1-2008. +C11, POSIX.1-2024. .TP .BR renameat () -POSIX.1-2008. +POSIX.1-2024. .TP .BR renameat2 () Linux. diff --git a/man/man2/rmdir.2 b/man/man2/rmdir.2 index 28c55dad3..8bf31d889 100644 --- a/man/man2/rmdir.2 +++ b/man/man2/rmdir.2 @@ -86,7 +86,6 @@ has .I .. as its final component. POSIX.1 also allows -.\" POSIX.1-2001, POSIX.1-2008 .B EEXIST for this condition. .TP @@ -110,7 +109,7 @@ does not support the removal of directories. .I path refers to a directory on a read-only filesystem. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.3BSD. .SH BUGS diff --git a/man/man2/sched_get_priority_max.2 b/man/man2/sched_get_priority_max.2 index e98656bd3..eb5feafa7 100644 --- a/man/man2/sched_get_priority_max.2 +++ b/man/man2/sched_get_priority_max.2 @@ -61,7 +61,6 @@ priority range and map it to the interval given by and .BR sched_get_priority_min (). POSIX.1 requires -.\" POSIX.1-2001, POSIX.1-2008 (XBD 2.8.4) a spread of at least 32 between the maximum and the minimum values for .B SCHED_FIFO and @@ -92,7 +91,7 @@ The argument .I policy does not identify a defined scheduling policy. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SH SEE ALSO diff --git a/man/man2/sched_rr_get_interval.2 b/man/man2/sched_rr_get_interval.2 index 7736ebf41..d168ff873 100644 --- a/man/man2/sched_rr_get_interval.2 +++ b/man/man2/sched_rr_get_interval.2 @@ -70,7 +70,7 @@ quantum: the file exposes the quantum as a millisecond value, whose default is 100. Writing 0 to this file resets the quantum to the default value. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SS Linux diff --git a/man/man2/sched_setparam.2 b/man/man2/sched_setparam.2 index 76fdfb9b7..bb5a450df 100644 --- a/man/man2/sched_setparam.2 +++ b/man/man2/sched_setparam.2 @@ -110,7 +110,7 @@ The thread whose ID is .I pid could not be found. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SH SEE ALSO diff --git a/man/man2/sched_setscheduler.2 b/man/man2/sched_setscheduler.2 index 78afb5949..fbac079ef 100644 --- a/man/man2/sched_setscheduler.2 +++ b/man/man2/sched_setscheduler.2 @@ -184,7 +184,7 @@ instead of the .BR sched_* (2) system calls.) .SH STANDARDS -POSIX.1-2008 (but see BUGS below). +POSIX.1-2024 (but see BUGS below). .P .B SCHED_BATCH and diff --git a/man/man2/sched_yield.2 b/man/man2/sched_yield.2 index 2bc321694..e7c5092bc 100644 --- a/man/man2/sched_yield.2 +++ b/man/man2/sched_yield.2 @@ -31,7 +31,7 @@ In the Linux implementation, .BR sched_yield () always succeeds. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001 (but optional). POSIX.1-2008. diff --git a/man/man2/select.2 b/man/man2/select.2 index ff35d9a1b..4a8bf18aa 100644 --- a/man/man2/select.2 +++ b/man/man2/select.2 @@ -21,7 +21,7 @@ Standard C library .BI " struct timeval *_Nullable restrict " timeout ); .P .BI "void FD_CLR(int " fd ", fd_set *" set ); -.BI "int FD_ISSET(int " fd ", fd_set *" set ); +.BI "int FD_ISSET(int " fd ", const fd_set *" set ); .BI "void FD_SET(int " fd ", fd_set *" set ); .BI "void FD_ZERO(fd_set *" set ); .P @@ -432,7 +432,7 @@ Portable programs may wish to check for and loop, just as with .BR EINTR . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR select () diff --git a/man/man2/semctl.2 b/man/man2/semctl.2 index 846d49e26..bea4c38a1 100644 --- a/man/man2/semctl.2 +++ b/man/man2/semctl.2 @@ -546,7 +546,7 @@ This was rectified .\" commit a5f4db877177d2a3d7ae62a7bac3a5a27e083d7f in Linux 4.6. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .\" SVr4 documents more error conditions EINVAL and EOVERFLOW. diff --git a/man/man2/semget.2 b/man/man2/semget.2 index 6a09f3080..d206cf297 100644 --- a/man/man2/semget.2 +++ b/man/man2/semget.2 @@ -185,7 +185,7 @@ or the system wide maximum number of semaphores .RB ( SEMMNS ), would be exceeded. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY SVr4, POSIX.1-2001. .\" SVr4 documents additional error conditions EFBIG, E2BIG, EAGAIN, diff --git a/man/man2/semop.2 b/man/man2/semop.2 index 90fee48ad..3311eebb3 100644 --- a/man/man2/semop.2 +++ b/man/man2/semop.2 @@ -346,7 +346,7 @@ is greater than the implementation dependent maximum value for .IR semval . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH VERSIONS Linux 2.5.52 (backported into Linux 2.4.22), glibc 2.3.3. diff --git a/man/man2/send.2 b/man/man2/send.2 index 84ac2695a..6a58c886a 100644 --- a/man/man2/send.2 +++ b/man/man2/send.2 @@ -453,7 +453,7 @@ but glibc currently types both as .\" across architectures, but socklen_t is always 32 bits, .\" as (at least with GCC) is int. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .P .B MSG_CONFIRM is a Linux extension. diff --git a/man/man2/seteuid.2 b/man/man2/seteuid.2 index 1b803e37d..ce33ea469 100644 --- a/man/man2/seteuid.2 +++ b/man/man2/seteuid.2 @@ -117,7 +117,7 @@ are implemented as library functions that call, respectively, and .BR setresgid (2). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.3BSD. .SH SEE ALSO diff --git a/man/man2/setgid.2 b/man/man2/setgid.2 index de9b52a82..0d8f8e219 100644 --- a/man/man2/setgid.2 +++ b/man/man2/setgid.2 @@ -66,7 +66,7 @@ all of the other threads in the process also change their credentials. For details, see .BR nptl (7). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .P diff --git a/man/man2/setpgid.2 b/man/man2/setpgid.2 index 19ef3ab69..e85fce054 100644 --- a/man/man2/setpgid.2 +++ b/man/man2/setpgid.2 @@ -223,11 +223,9 @@ is not the calling process and not a child of the calling process. .BR setpgid () .TQ .BR getpgrp "() (no args)" -.TQ -.BR setpgrp "() (no args)" -POSIX.1-2008 (but see HISTORY). +POSIX.1-2024. .TP -.BR setpgrp "() (2 args)" +.BR setpgrp () .TQ .BR getpgrp "() (1 arg)" None. @@ -242,7 +240,8 @@ POSIX.1-2001. .TP .BR setpgrp "() (no args)" POSIX.1-2001. -POSIX.1-2008 marks it as obsolete. +Obsoleted in POSIX.1-2008. +Removed in POSIX.1-2024. .TP .BR setpgrp "() (2 args)" .TQ diff --git a/man/man2/setresuid.2 b/man/man2/setresuid.2 index 2f8bcd690..a5655ddc8 100644 --- a/man/man2/setresuid.2 +++ b/man/man2/setresuid.2 @@ -114,8 +114,9 @@ all of the other threads in the process also change their credentials. For details, see .BR nptl (7). .SH STANDARDS -None. +POSIX.1-2024. .SH HISTORY +POSIX.1-2024. Linux 2.1.44, glibc 2.3.2. HP-UX, FreeBSD. diff --git a/man/man2/setreuid.2 b/man/man2/setreuid.2 index c14ed4023..61fb4914d 100644 --- a/man/man2/setreuid.2 +++ b/man/man2/setreuid.2 @@ -129,7 +129,7 @@ across implementations. POSIX.1 makes no specification about the effect of these calls on the saved set-user-ID and saved set-group-ID. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.3BSD (first appeared in 4.2BSD). .P diff --git a/man/man2/setsid.2 b/man/man2/setsid.2 index e4c40beb4..b49f13931 100644 --- a/man/man2/setsid.2 +++ b/man/man2/setsid.2 @@ -45,7 +45,7 @@ Thus, in particular, .BR setsid () fails if the calling process is already a process group leader. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .SH NOTES diff --git a/man/man2/setuid.2 b/man/man2/setuid.2 index a0599e4bd..9b80cad2a 100644 --- a/man/man2/setuid.2 +++ b/man/man2/setuid.2 @@ -110,7 +110,7 @@ all of the other threads in the process also change their credentials. For details, see .BR nptl (7). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .P diff --git a/man/man2/shmctl.2 b/man/man2/shmctl.2 index 891884f6c..d2008e51f 100644 --- a/man/man2/shmctl.2 +++ b/man/man2/shmctl.2 @@ -451,7 +451,7 @@ using This feature is not available on other UNIX implementations; portable applications should avoid relying on it. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .\" SVr4 documents additional error conditions EINVAL, diff --git a/man/man2/shmget.2 b/man/man2/shmget.2 index d273966a9..4a5367eea 100644 --- a/man/man2/shmget.2 +++ b/man/man2/shmget.2 @@ -257,7 +257,7 @@ group; see the description of in .BR proc (5). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .P .B SHM_HUGETLB and diff --git a/man/man2/shmop.2 b/man/man2/shmop.2 index 12e7bd763..ef5438b07 100644 --- a/man/man2/shmop.2 +++ b/man/man2/shmop.2 @@ -207,6 +207,12 @@ from .I char\ * into .IR "void\ *" . +.P +POSIX.1-2024 +changed the error code from +.I (void\ *)\ \-1 +to +.BR SHM_FAILED . .SH NOTES After a .BR fork (2), diff --git a/man/man2/shutdown.2 b/man/man2/shutdown.2 index e12f09977..a1884594a 100644 --- a/man/man2/shutdown.2 +++ b/man/man2/shutdown.2 @@ -61,7 +61,7 @@ The file descriptor .I sockfd does not refer to a socket. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, 4.4BSD (first appeared in 4.2BSD). diff --git a/man/man2/sigaction.2 b/man/man2/sigaction.2 index 8d08a8c40..4da8b41d6 100644 --- a/man/man2/sigaction.2 +++ b/man/man2/sigaction.2 @@ -976,7 +976,7 @@ wrapper function hides these details from us, transparently calling .BR rt_sigaction () when the kernel provides it. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4. .\" SVr4 does not document the EINTR condition. diff --git a/man/man2/sigaltstack.2 b/man/man2/sigaltstack.2 index d82e33dd0..8b23bf15d 100644 --- a/man/man2/sigaltstack.2 +++ b/man/man2/sigaltstack.2 @@ -239,7 +239,7 @@ T{ T} Thread safety MT-Safe .TE .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .P .B SS_AUTODISARM is a Linux extension. diff --git a/man/man2/signal.2 b/man/man2/signal.2 index c3471e56f..86a5b767c 100644 --- a/man/man2/signal.2 +++ b/man/man2/signal.2 @@ -132,7 +132,7 @@ which provides explicit control of the semantics when a signal handler is invoked; use that interface instead of .BR signal (). .SH STANDARDS -C11, POSIX.1-2008. +C11, POSIX.1-2024. .SH HISTORY C89, POSIX.1-2001. .P diff --git a/man/man2/sigpending.2 b/man/man2/sigpending.2 index 4f8f004fe..c1ec006f0 100644 --- a/man/man2/sigpending.2 +++ b/man/man2/sigpending.2 @@ -42,7 +42,7 @@ is set to indicate the error. .I set points to memory which is not a valid part of the process address space. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SS C library/kernel differences diff --git a/man/man2/sigprocmask.2 b/man/man2/sigprocmask.2 index b79ca7159..faf17cab3 100644 --- a/man/man2/sigprocmask.2 +++ b/man/man2/sigprocmask.2 @@ -168,7 +168,7 @@ wrapper function hides these details from us, transparently calling when the kernel provides it. .\" .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SH NOTES diff --git a/man/man2/sigsuspend.2 b/man/man2/sigsuspend.2 index 4b7d4030e..5bd4d50be 100644 --- a/man/man2/sigsuspend.2 +++ b/man/man2/sigsuspend.2 @@ -64,7 +64,7 @@ points to memory which is not a valid part of the process address space. The call was interrupted by a signal; .BR signal (7). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SS C library/kernel differences diff --git a/man/man2/sigwaitinfo.2 b/man/man2/sigwaitinfo.2 index a2a466fdb..942e69670 100644 --- a/man/man2/sigwaitinfo.2 +++ b/man/man2/sigwaitinfo.2 @@ -154,7 +154,7 @@ wrapper function hides these details from us, transparently calling when the kernel provides it. .\" .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001. .SH NOTES diff --git a/man/man2/socket.2 b/man/man2/socket.2 index d80508248..7c0a5c2f6 100644 --- a/man/man2/socket.2 +++ b/man/man2/socket.2 @@ -424,17 +424,10 @@ POSIX.1-2024 specifies .BR SOCK_CLOFORK , but Linux doesn't support it. .SH STANDARDS -POSIX.1-2008. -.P -.B SOCK_NONBLOCK -and -.B SOCK_CLOEXEC -are Linux-specific. +POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.4BSD. +POSIX.1-2001, 4.2BSD. .P -.BR socket () -appeared in 4.2BSD. It is generally portable to/from non-BSD systems supporting clones of the BSD socket layer (including System\ V variants). @@ -451,6 +444,11 @@ families. However, already the BSD man page promises: "The protocol family generally is the same as the address family", and subsequent standards use AF_* everywhere. +.TP +.B SOCK_NONBLOCK +.TQ +.B SOCK_CLOEXEC +POSIX.1-2024. .SH EXAMPLES An example of the use of .BR socket () diff --git a/man/man2/socketpair.2 b/man/man2/socketpair.2 index 698f6b0ab..a25a486af 100644 --- a/man/man2/socketpair.2 +++ b/man/man2/socketpair.2 @@ -79,26 +79,21 @@ and .\" commit: 70b03759e9ecfae400605fa34f3d7154cccbbba3 (since Linux 4.12). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.4BSD. +POSIX.1-2001, 4.2BSD. .P -.BR socketpair () -first appeared in 4.2BSD. It is generally portable to/from non-BSD systems supporting clones of the BSD socket layer (including System\ V variants). -.P -Since Linux 2.6.27, -.BR socketpair () -supports the -.B SOCK_NONBLOCK -and +.TP .B SOCK_CLOEXEC -flags in the -.I type -argument, as described in -.BR socket (2). +.TQ +.B SOCK_NONBLOCK +POSIX.1-2024; +Linux 2.6.27. +(See +.BR socket (2).) .SH SEE ALSO .BR pipe (2), .BR read (2), diff --git a/man/man2/stat.2 b/man/man2/stat.2 index 07ea3f070..2d73d8afa 100644 --- a/man/man2/stat.2 +++ b/man/man2/stat.2 @@ -295,7 +295,7 @@ on a file whose size exceeds .I (1<<31)\-1 bytes. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR stat () diff --git a/man/man2/symlink.2 b/man/man2/symlink.2 index 600bfc409..afd91a2a3 100644 --- a/man/man2/symlink.2 +++ b/man/man2/symlink.2 @@ -207,7 +207,7 @@ does not support the creation of symbolic links. .I linkpath is on a read-only filesystem. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR symlink () diff --git a/man/man2/sync.2 b/man/man2/sync.2 index d6e75c505..820252430 100644 --- a/man/man2/sync.2 +++ b/man/man2/sync.2 @@ -79,7 +79,7 @@ allocate space at the time of a system call, and some previous write failed due to insufficient storage space. .SH VERSIONS -According to the standard specification (e.g., POSIX.1-2001), +According to the standard specification (i.e., POSIX.1), .BR sync () schedules the writes, but may return before the actual writing is done. @@ -95,7 +95,7 @@ the system or filesystem respectively. .SH STANDARDS .TP .BR sync () -POSIX.1-2008. +POSIX.1-2024. .TP .BR syncfs () Linux. diff --git a/man/man2/time.2 b/man/man2/time.2 index 1e22f1179..24034e3b6 100644 --- a/man/man2/time.2 +++ b/man/man2/time.2 @@ -84,11 +84,9 @@ On some architectures, an implementation of is provided in the .BR vdso (7). .SH STANDARDS -C11, POSIX.1-2008. +C11, POSIX.1-2024. .SH HISTORY -SVr4, 4.3BSD, C89, POSIX.1-2001. -.\" Under 4.3BSD, this call is obsoleted by -.\" .BR gettimeofday (2). +SVr4, 4.3BSD, C89, POSIX.1-2001, V7. .SH BUGS Error returns from this system call are indistinguishable from successful reports that the time is a few seconds diff --git a/man/man2/timer_create.2 b/man/man2/timer_create.2 index 287d7bda4..80baae619 100644 --- a/man/man2/timer_create.2 +++ b/man/man2/timer_create.2 @@ -253,7 +253,7 @@ which maps these IDs to the timer IDs employed by the kernel. .\" that glibc uses to map user-space timer IDs to kernel timer IDs .\" The kernel-level timer ID is exposed via siginfo.si_tid. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY Linux 2.6. POSIX.1-2001. diff --git a/man/man2/timer_delete.2 b/man/man2/timer_delete.2 index 997e77274..83f9adab7 100644 --- a/man/man2/timer_delete.2 +++ b/man/man2/timer_delete.2 @@ -45,7 +45,7 @@ is set to indicate the error. .I timerid is not a valid timer ID. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY Linux 2.6. POSIX.1-2001. diff --git a/man/man2/timer_getoverrun.2 b/man/man2/timer_getoverrun.2 index c094707dd..fd45f8573 100644 --- a/man/man2/timer_getoverrun.2 +++ b/man/man2/timer_getoverrun.2 @@ -92,7 +92,7 @@ timer notifications using signals. .\" FIXME . Austin bug filed, 11 Feb 09 .\" https://www.austingroupbugs.net/view.php?id=95 .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY Linux 2.6. POSIX.1-2001. diff --git a/man/man2/timer_settime.2 b/man/man2/timer_settime.2 index 774bb352f..1f02efcb6 100644 --- a/man/man2/timer_settime.2 +++ b/man/man2/timer_settime.2 @@ -172,7 +172,7 @@ is negative; or .I new_value.it_value.tv_nsec is negative or greater than 999,999,999. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY Linux 2.6. POSIX.1-2001. diff --git a/man/man2/times.2 b/man/man2/times.2 index 691995830..45d3b0852 100644 --- a/man/man2/times.2 +++ b/man/man2/times.2 @@ -103,7 +103,7 @@ and most other UNIX implementations require a non-NULL value for .IR buf . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, diff --git a/man/man2/truncate.2 b/man/man2/truncate.2 index ef95eb990..3d3ec2aeb 100644 --- a/man/man2/truncate.2 +++ b/man/man2/truncate.2 @@ -194,10 +194,10 @@ the calling signature for these system calls differ, for the reasons described in .BR syscall (2). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, -4.4BSD, SVr4 (first appeared in 4.2BSD). +SVr4, 4.2BSD. .\" POSIX.1-1996 has .\" .BR ftruncate (). .\" POSIX.1-2001 also has diff --git a/man/man2/uname.2 b/man/man2/uname.2 index 84557c46c..3ed7a7bd8 100644 --- a/man/man2/uname.2 +++ b/man/man2/uname.2 @@ -75,7 +75,7 @@ idea to use any of these constants; just use sizeof(...). SVr4 uses 257, "to support Internet hostnames" \[em] this is the largest value likely to be encountered in the wild. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY POSIX.1-2001, SVr4, 4.4BSD. .SS C library/kernel differences diff --git a/man/man2/unlink.2 b/man/man2/unlink.2 index 8ec625753..8f0840949 100644 --- a/man/man2/unlink.2 +++ b/man/man2/unlink.2 @@ -245,7 +245,7 @@ is relative and .I dirfd is a file descriptor referring to a file other than a directory. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .BR unlink () diff --git a/man/man2/utime.2 b/man/man2/utime.2 index f4b6d1dc4..94307a5b9 100644 --- a/man/man2/utime.2 +++ b/man/man2/utime.2 @@ -147,12 +147,18 @@ capability). .I path resides on a read-only filesystem. .SH STANDARDS -POSIX.1-2008. +.TP +.BR utime () +None. +.TP +.BR utimes () +POSIX.1-2024. .SH HISTORY .TP .BR utime () SVr4, POSIX.1-2001. -POSIX.1-2008 marks it as obsolete. +Obsoleted in POSIX.1-2008. +Removed in POSIX.1-2024. .TP .BR utimes () 4.3BSD, POSIX.1-2001. diff --git a/man/man2/utimensat.2 b/man/man2/utimensat.2 index f003bb259..cd81f4f3c 100644 --- a/man/man2/utimensat.2 +++ b/man/man2/utimensat.2 @@ -438,8 +438,8 @@ the wrapper function returns the error .B EINVAL in this case. .SH STANDARDS -POSIX.1-2008. -.SH VERSIONS +POSIX.1-2024. +.SH HISTORY .TP .BR utimensat () Linux 2.6.22, diff --git a/man/man2/wait.2 b/man/man2/wait.2 index d99c2a2ac..4e5d1c8ee 100644 --- a/man/man2/wait.2 +++ b/man/man2/wait.2 @@ -177,19 +177,14 @@ This macro should be employed only if .B WIFSIGNALED returned true. .TP -.BI WCOREDUMP( wstatus ) +.BI WCOREDUMP( wstatus ) " \f[R]// POSIX.1-2024\f[]" returns true if the child produced a core dump (see .BR core (5)). This macro should be employed only if .B WIFSIGNALED returned true. -.IP -This macro is not specified in POSIX.1-2001 and is not available on -some UNIX implementations (e.g., AIX, SunOS). -Therefore, enclose its use inside -.IR "#ifdef WCOREDUMP ... #endif" . .TP -.BI WIFSTOPPED( wstatus ) +.BI WIFSTOPPED( wstatus ) " \f[R]// POSIX.1-2024\f[]" returns true if the child process was stopped by delivery of a signal; this is possible only if the call was done using .B WUNTRACED @@ -466,7 +461,7 @@ See .BR getrusage (2) for details. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES diff --git a/man/man2/write.2 b/man/man2/write.2 index 5392de0ac..5b015bc37 100644 --- a/man/man2/write.2 +++ b/man/man2/write.2 @@ -218,7 +218,7 @@ catches, blocks or ignores this signal.) Other errors may occur, depending on the object connected to .IR fd . .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error diff --git a/man/man2const/F_DUPFD.2const b/man/man2const/F_DUPFD.2const index b3635982a..907a1cb86 100644 --- a/man/man2const/F_DUPFD.2const +++ b/man/man2const/F_DUPFD.2const @@ -76,7 +76,7 @@ POSIX.1-2024 specifies .BR F_DUPFD_CLOFORK , but Linux doesn't support it. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY .TP .B F_DUPFD diff --git a/man/man2const/F_GETFD.2const b/man/man2const/F_GETFD.2const index 065ba4c00..e44aa644d 100644 --- a/man/man2const/F_GETFD.2const +++ b/man/man2const/F_GETFD.2const @@ -60,7 +60,7 @@ is set to indicate the error. See .BR fcntl (2). .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY SVr4, 4.3BSD, POSIX.1-2001. .SH CAVEATS diff --git a/man/man2const/F_GETFL.2const b/man/man2const/F_GETFL.2const index 142ffcaf1..273cbaf7a 100644 --- a/man/man2const/F_GETFL.2const +++ b/man/man2const/F_GETFL.2const @@ -87,7 +87,7 @@ Attempted to clear the .B O_APPEND flag on a file that has the append-only attribute set. .SH STANDARDS -POSIX.1-2008. +POSIX.1-2024. .SH HISTORY SVr4, 4.3BSD, POSIX.1-2001. .SH BUGS diff --git a/man/man2const/F_GETSIG.2const b/man/man2const/F_GETSIG.2const index 3c13c836f..328561977 100644 --- a/man/man2const/F_GETSIG.2const +++ b/man/man2const/F_GETSIG.2const @@ -426,12 +426,12 @@ is not an allowable signal number. .B F_GETOWN .TQ .B F_SETOWN -POSIX.1-2008. -.TP +.TQ .B F_GETOWN_EX .TQ .B F_SETOWN_EX -.TQ +POSIX.1-2024. +.TP .B F_GETSIG .TQ .B F_SETSIG @@ -458,6 +458,7 @@ with the value 200809L or greater.) .B F_GETOWN_EX .TQ .B F_GETOWN_EX +POSIX.1-2024. Linux 2.6.32. .TP .B F_GETSIG