diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:51:52 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:51:52 +0000 |
| commit | 4ad94864781f48b1a4b77f9cfb934622bf756ba1 (patch) | |
| tree | 3900955c1886e6d2570fea7125ee1f01bafe876d /upstream/archlinux/man2 | |
| parent | Adding upstream version 4.22.0. (diff) | |
| download | manpages-l10n-4ad94864781f48b1a4b77f9cfb934622bf756ba1.tar.xz manpages-l10n-4ad94864781f48b1a4b77f9cfb934622bf756ba1.zip | |
Adding upstream version 4.23.0.upstream/4.23.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/archlinux/man2')
277 files changed, 739 insertions, 621 deletions
diff --git a/upstream/archlinux/man2/_exit.2 b/upstream/archlinux/man2/_exit.2 index 71ae8584..ccfd4150 100644 --- a/upstream/archlinux/man2/_exit.2 +++ b/upstream/archlinux/man2/_exit.2 @@ -6,7 +6,7 @@ .\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified 2001-11-17, aeb .\" -.TH _exit 2 2023-10-31 "Linux man-pages 6.06" +.TH _exit 2 2024-05-02 "Linux man-pages 6.8" .SH NAME _exit, _Exit \- terminate the calling process .SH LIBRARY diff --git a/upstream/archlinux/man2/_syscall.2 b/upstream/archlinux/man2/_syscall.2 index 26d0a85b..0350cf59 100644 --- a/upstream/archlinux/man2/_syscall.2 +++ b/upstream/archlinux/man2/_syscall.2 @@ -16,7 +16,7 @@ .\" 2007-10-23 mtk: created as a new page, by taking the content .\" specific to the _syscall() macros from intro(2). .\" -.TH _syscall 2 2023-10-31 "Linux man-pages 6.06" +.TH _syscall 2 2024-05-02 "Linux man-pages 6.8" .SH NAME _syscall \- invoking a system call without library support (OBSOLETE) .SH SYNOPSIS @@ -123,7 +123,7 @@ passed by-value or by-pointer (for aggregates like structs). .\" Otherwise, the use of a _syscall macro is required. .\" .SH EXAMPLES -.\" [[deprecated]] SRC BEGIN (_syscall.c) +.\" SRC BEGIN (_syscall.c) .EX #include <stdio.h> #include <stdlib.h> diff --git a/upstream/archlinux/man2/accept.2 b/upstream/archlinux/man2/accept.2 index 1115414d..47d72175 100644 --- a/upstream/archlinux/man2/accept.2 +++ b/upstream/archlinux/man2/accept.2 @@ -10,7 +10,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2008-12-04, mtk, Add documentation of accept4() .\" -.TH accept 2 2023-10-31 "Linux man-pages 6.06" +.TH accept 2 2024-05-02 "Linux man-pages 6.8" .SH NAME accept, accept4 \- accept a connection on a socket .SH LIBRARY diff --git a/upstream/archlinux/man2/access.2 b/upstream/archlinux/man2/access.2 index 611f8008..9f262435 100644 --- a/upstream/archlinux/man2/access.2 +++ b/upstream/archlinux/man2/access.2 @@ -20,7 +20,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-06-10, mtk, various parts rewritten, and added BUGS section. .\" -.TH access 2 2024-01-01 "Linux man-pages 6.06" +.TH access 2 2024-05-02 "Linux man-pages 6.8" .SH NAME access, faccessat, faccessat2 \- check user's permissions for a file .SH LIBRARY diff --git a/upstream/archlinux/man2/acct.2 b/upstream/archlinux/man2/acct.2 index 8eaddac2..09a2b82a 100644 --- a/upstream/archlinux/man2/acct.2 +++ b/upstream/archlinux/man2/acct.2 @@ -9,7 +9,7 @@ .\" Modified 1998-11-04 by Tigran Aivazian <tigran@sco.com> .\" Modified 2004-05-27, 2004-06-17, 2004-06-23 by Michael Kerrisk .\" -.TH acct 2 2023-10-31 "Linux man-pages 6.06" +.TH acct 2 2024-05-02 "Linux man-pages 6.8" .SH NAME acct \- switch process accounting on or off .SH LIBRARY diff --git a/upstream/archlinux/man2/add_key.2 b/upstream/archlinux/man2/add_key.2 index de942796..d9f5225b 100644 --- a/upstream/archlinux/man2/add_key.2 +++ b/upstream/archlinux/man2/add_key.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH add_key 2 2023-10-31 "Linux man-pages 6.06" +.TH add_key 2 2024-05-02 "Linux man-pages 6.8" .SH NAME add_key \- add a key to the kernel's key management facility .SH LIBRARY @@ -96,7 +96,7 @@ argument to .BR add_key () are the following: .TP -.I """keyring""" +.I \[dq]keyring\[dq] Keyrings are special key types that may contain links to sequences of other keys of any type. If this interface is used to create a keyring, then @@ -105,17 +105,17 @@ should be NULL and .I plen should be zero. .TP -.I """user""" +.I \[dq]user\[dq] This is a general purpose key type whose payload may be read and updated by user-space applications. The key is kept entirely within kernel memory. The payload for keys of this type is a blob of arbitrary data of up to 32,767 bytes. .TP -.IR """logon""" " (since Linux 3.3)" +.IR \[dq]logon\[dq] " (since Linux 3.3)" .\" commit 9f6ed2ca257fa8650b876377833e6f14e272848b This key type is essentially the same as -.IR """user""" , +.IR \[dq]user\[dq] , but it does not permit the key to read. This is suitable for storing payloads that you do not want to be readable from user space. @@ -127,10 +127,10 @@ by checking to ensure that the .I description contains a ':' that is preceded by other characters. .TP -.IR """big_key""" " (since Linux 3.13)" +.IR \[dq]big_key\[dq] " (since Linux 3.13)" .\" commit ab3c3587f8cda9083209a61dbe3a4407d3cada10 This key type is similar to -.IR """user""" , +.IR \[dq]user\[dq] , but may hold a payload of up to 1\ MiB. If the key payload is large enough, then it may be stored encrypted in tmpfs @@ -175,11 +175,11 @@ The payload data was invalid. .B EINVAL .I type was -.I """logon""" +.I \[dq]logon\[dq] and the .I description was not qualified with a prefix string of the form -.IR """service:""" . +.IR \[dq]service:\[dq] . .TP .B EKEYEXPIRED The keyring has expired. @@ -202,7 +202,7 @@ Key types that begin with a period are reserved to the implementation. .B EPERM .I type was -.I """keyring""" +.I \[dq]keyring\[dq] and the .I description started with a period (\[aq].\[aq]). diff --git a/upstream/archlinux/man2/adjtimex.2 b/upstream/archlinux/man2/adjtimex.2 index 71b32d7a..246a0371 100644 --- a/upstream/archlinux/man2/adjtimex.2 +++ b/upstream/archlinux/man2/adjtimex.2 @@ -8,7 +8,7 @@ .\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl> .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH adjtimex 2 2023-10-31 "Linux man-pages 6.06" +.TH adjtimex 2 2024-05-02 "Linux man-pages 6.8" .SH NAME adjtimex, clock_adjtime, ntp_adjtime \- tune kernel clock .SH LIBRARY diff --git a/upstream/archlinux/man2/alarm.2 b/upstream/archlinux/man2/alarm.2 index bd10e840..f12d19ce 100644 --- a/upstream/archlinux/man2/alarm.2 +++ b/upstream/archlinux/man2/alarm.2 @@ -7,7 +7,7 @@ .\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer <aeb@cwi.nl> .\" Modified Wed Nov 6 03:46:05 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH alarm 2 2023-10-31 "Linux man-pages 6.06" +.TH alarm 2 2024-05-02 "Linux man-pages 6.8" .SH NAME alarm \- set an alarm clock for delivery of a signal .SH LIBRARY diff --git a/upstream/archlinux/man2/alloc_hugepages.2 b/upstream/archlinux/man2/alloc_hugepages.2 index 9cbc9397..2c44c4ca 100644 --- a/upstream/archlinux/man2/alloc_hugepages.2 +++ b/upstream/archlinux/man2/alloc_hugepages.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH alloc_hugepages 2 2023-10-31 "Linux man-pages 6.06" +.TH alloc_hugepages 2 2024-05-02 "Linux man-pages 6.8" .SH NAME alloc_hugepages, free_hugepages \- allocate or free huge pages .SH SYNOPSIS diff --git a/upstream/archlinux/man2/arch_prctl.2 b/upstream/archlinux/man2/arch_prctl.2 index dcb31afe..93502219 100644 --- a/upstream/archlinux/man2/arch_prctl.2 +++ b/upstream/archlinux/man2/arch_prctl.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH arch_prctl 2 2023-10-31 "Linux man-pages 6.06" +.TH arch_prctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME arch_prctl \- set architecture-specific thread state .SH LIBRARY @@ -14,8 +14,8 @@ Standard C library .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> .P -.BI "int syscall(SYS_arch_prctl, int " code ", unsigned long " addr ); -.BI "int syscall(SYS_arch_prctl, int " code ", unsigned long *" addr ); +.BI "int syscall(SYS_arch_prctl, int " op ", unsigned long " addr ); +.BI "int syscall(SYS_arch_prctl, int " op ", unsigned long *" addr ); .fi .P .IR Note : @@ -26,8 +26,8 @@ necessitating the use of .SH DESCRIPTION .BR arch_prctl () sets architecture-specific process or thread state. -.I code -selects a subfunction +.I op +selects an operation and passes argument .I addr to it; @@ -120,8 +120,8 @@ is set to indicate the error. points to an unmapped address or is outside the process address space. .TP .B EINVAL -.I code -is not a valid subcommand. +.I op +is not a valid operation. .TP .B ENODEV .B ARCH_SET_CPUID diff --git a/upstream/archlinux/man2/bdflush.2 b/upstream/archlinux/man2/bdflush.2 index 452248f2..39a36d6e 100644 --- a/upstream/archlinux/man2/bdflush.2 +++ b/upstream/archlinux/man2/bdflush.2 @@ -5,7 +5,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH bdflush 2 2023-10-31 "Linux man-pages 6.06" +.TH bdflush 2 2024-05-02 "Linux man-pages 6.8" .SH NAME bdflush \- start, flush, or tune buffer-dirty-flush daemon .SH SYNOPSIS diff --git a/upstream/archlinux/man2/bind.2 b/upstream/archlinux/man2/bind.2 index a7af6e34..190cfa73 100644 --- a/upstream/archlinux/man2/bind.2 +++ b/upstream/archlinux/man2/bind.2 @@ -18,7 +18,7 @@ .\" $Id: bind.2,v 1.3 1999/04/23 19:56:07 freitag Exp $ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH bind 2 2023-10-31 "Linux man-pages 6.06" +.TH bind 2 2024-05-02 "Linux man-pages 6.8" .SH NAME bind \- bind a name to a socket .SH LIBRARY diff --git a/upstream/archlinux/man2/bpf.2 b/upstream/archlinux/man2/bpf.2 index 7b33da5b..eac71c29 100644 --- a/upstream/archlinux/man2/bpf.2 +++ b/upstream/archlinux/man2/bpf.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH bpf 2 2023-11-01 "Linux man-pages 6.06" +.TH bpf 2 2024-05-02 "Linux man-pages 6.8" .SH NAME bpf \- perform a command on an extended BPF map or program .SH SYNOPSIS @@ -1143,7 +1143,7 @@ provided in the kernel source tree. .P Since Linux 4.15, .\" commit 290af86629b25ffd1ed6232c4e9107da031705cb -the kernel may configured with the +the kernel may be configured with the .B CONFIG_BPF_JIT_ALWAYS_ON option. In this case, the JIT compiler is always enabled, and the @@ -1192,7 +1192,7 @@ riscv (since Linux 5.1). .\" commit 2353ecc6f91fd15b893fa01bf85a1c7a823ee4f2 .PD .SH EXAMPLES -.\" [[FIXME]] SRC BEGIN (bpf.c) +.\" SRC BEGIN (bpf.c) .EX /* bpf+sockets example: * 1. create array map of 256 elements diff --git a/upstream/archlinux/man2/brk.2 b/upstream/archlinux/man2/brk.2 index 91b8d81a..499b6865 100644 --- a/upstream/archlinux/man2/brk.2 +++ b/upstream/archlinux/man2/brk.2 @@ -7,7 +7,7 @@ .\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith <faith@cs.unc.edu> .\" -.TH brk 2 2023-10-31 "Linux man-pages 6.06" +.TH brk 2 2024-05-02 "Linux man-pages 6.8" .SH NAME brk, sbrk \- change data segment size .SH LIBRARY diff --git a/upstream/archlinux/man2/cacheflush.2 b/upstream/archlinux/man2/cacheflush.2 index ce8e797f..553f2151 100644 --- a/upstream/archlinux/man2/cacheflush.2 +++ b/upstream/archlinux/man2/cacheflush.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH cacheflush 2 2023-10-31 "Linux man-pages 6.06" +.TH cacheflush 2 2024-05-02 "Linux man-pages 6.8" .SH NAME cacheflush \- flush contents of instruction and/or data cache .SH LIBRARY diff --git a/upstream/archlinux/man2/capget.2 b/upstream/archlinux/man2/capget.2 index 11fa5619..9c6f6595 100644 --- a/upstream/archlinux/man2/capget.2 +++ b/upstream/archlinux/man2/capget.2 @@ -11,7 +11,7 @@ .\" 64-bit capability sets in Linux 2.6.2[45]. .\" Modified 2009-01-26, andi kleen .\" -.TH capget 2 2023-10-31 "Linux man-pages 6.06" +.TH capget 2 2024-05-02 "Linux man-pages 6.8" .SH NAME capget, capset \- set/get capabilities of thread(s) .SH LIBRARY diff --git a/upstream/archlinux/man2/chdir.2 b/upstream/archlinux/man2/chdir.2 index 4b43371f..118c53f2 100644 --- a/upstream/archlinux/man2/chdir.2 +++ b/upstream/archlinux/man2/chdir.2 @@ -10,7 +10,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers <jsm28@cam.ac.uk> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH chdir 2 2023-10-31 "Linux man-pages 6.06" +.TH chdir 2 2024-05-02 "Linux man-pages 6.8" .SH NAME chdir, fchdir \- change working directory .SH LIBRARY diff --git a/upstream/archlinux/man2/chmod.2 b/upstream/archlinux/man2/chmod.2 index 71ba1f01..5ae91181 100644 --- a/upstream/archlinux/man2/chmod.2 +++ b/upstream/archlinux/man2/chmod.2 @@ -9,7 +9,7 @@ .\" <michael@cantor.informatik.rwth-aachen.de>: NFS details .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH chmod 2 2023-10-31 "Linux man-pages 6.06" +.TH chmod 2 2024-05-02 "Linux man-pages 6.8" .SH NAME chmod, fchmod, fchmodat \- change permissions of a file .SH LIBRARY diff --git a/upstream/archlinux/man2/chown.2 b/upstream/archlinux/man2/chown.2 index 5c138533..1da7218a 100644 --- a/upstream/archlinux/man2/chown.2 +++ b/upstream/archlinux/man2/chown.2 @@ -15,7 +15,7 @@ .\" (bsdgroups versus sysvgroups, and the effect of the parent .\" directory's set-group-ID mode bit). .\" -.TH chown 2 2023-10-31 "Linux man-pages 6.06" +.TH chown 2 2024-05-02 "Linux man-pages 6.8" .SH NAME chown, fchown, lchown, fchownat \- change ownership of a file .SH LIBRARY @@ -427,6 +427,7 @@ to perform a lookup in the system password file). #include <pwd.h> #include <stdio.h> #include <stdlib.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/chroot.2 b/upstream/archlinux/man2/chroot.2 index ceb351fd..ee7192d2 100644 --- a/upstream/archlinux/man2/chroot.2 +++ b/upstream/archlinux/man2/chroot.2 @@ -10,7 +10,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers <jsm28@cam.ac.uk> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH chroot 2 2023-10-31 "Linux man-pages 6.06" +.TH chroot 2 2024-05-02 "Linux man-pages 6.8" .SH NAME chroot \- change root directory .SH LIBRARY diff --git a/upstream/archlinux/man2/clock_getres.2 b/upstream/archlinux/man2/clock_getres.2 index 7f9ad02b..4c4f81ef 100644 --- a/upstream/archlinux/man2/clock_getres.2 +++ b/upstream/archlinux/man2/clock_getres.2 @@ -9,7 +9,7 @@ .\" 2003-08-24 aeb, large parts rewritten .\" 2004-08-06 Christoph Lameter <clameter@sgi.com>, SMP note .\" -.TH clock_getres 2 2023-11-11 "Linux man-pages 6.06" +.TH clock_getres 2 2024-05-02 "Linux man-pages 6.8" .SH NAME clock_getres, clock_gettime, clock_settime \- clock and time functions .SH LIBRARY @@ -377,6 +377,8 @@ Linux 2.6. On POSIX systems on which these functions are available, the symbol .B _POSIX_TIMERS is defined in \fI<unistd.h>\fP to a value greater than 0. +POSIX.1-2008 makes these functions mandatory. +.P The symbols .BR _POSIX_MONOTONIC_CLOCK , .BR _POSIX_CPUTIME , @@ -388,7 +390,6 @@ indicate that are available. (See also .BR sysconf (3).) -POSIX.1-2008 makes these APIs mandatory. .\" .SS Historical note for SMP systems Before Linux added kernel support for diff --git a/upstream/archlinux/man2/clock_nanosleep.2 b/upstream/archlinux/man2/clock_nanosleep.2 index 04bacfc2..0095f41e 100644 --- a/upstream/archlinux/man2/clock_nanosleep.2 +++ b/upstream/archlinux/man2/clock_nanosleep.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH clock_nanosleep 2 2023-11-11 "Linux man-pages 6.06" +.TH clock_nanosleep 2 2024-05-02 "Linux man-pages 6.8" .SH NAME clock_nanosleep \- high-resolution sleep with specifiable clock .SH LIBRARY @@ -19,7 +19,7 @@ Real-time library .nf .P .BI "int clock_nanosleep(clockid_t " clockid ", int " flags , -.BI " const struct timespec *" request , +.BI " const struct timespec *" t , .BI " struct timespec *_Nullable " remain ); .fi .P @@ -94,7 +94,7 @@ can also be passed in If .I flags is 0, then the value specified in -.I request +.I t is interpreted as an interval relative to the current value of the clock specified by .IR clockid . @@ -104,11 +104,11 @@ If is .BR TIMER_ABSTIME , then -.I request +.I t is interpreted as an absolute time as measured by the clock, .IR clockid . If -.I request +.I t is less than or equal to the current value of the clock, then .BR clock_nanosleep () @@ -117,7 +117,7 @@ returns immediately without suspending the calling thread. .BR clock_nanosleep () suspends the execution of the calling thread until either at least the time specified by -.I request +.I t has elapsed, or a signal is delivered that causes a signal handler to be called or that terminates the process. @@ -146,7 +146,7 @@ then it returns one of the positive error number listed in ERRORS. .SH ERRORS .TP .B EFAULT -.I request +.I t or .I remain specified an invalid address. @@ -180,7 +180,7 @@ Linux 2.6, glibc 2.1. .SH NOTES If the interval specified in -.I request +.I t is not an exact multiple of the granularity underlying clock (see .BR time (7)), then the interval will be rounded up to the next multiple. @@ -216,7 +216,7 @@ argument is unused, and unnecessary, when is .BR TIMER_ABSTIME . (An absolute sleep can be restarted using the same -.I request +.I t argument.) .P POSIX.1 specifies that diff --git a/upstream/archlinux/man2/clone.2 b/upstream/archlinux/man2/clone.2 index a73af0dc..d528f012 100644 --- a/upstream/archlinux/man2/clone.2 +++ b/upstream/archlinux/man2/clone.2 @@ -38,7 +38,7 @@ .\" 2008-11-19, mtk, document CLONE_NEWIPC .\" 2008-11-19, Jens Axboe, mtk, document CLONE_IO .\" -.TH clone 2 2023-11-01 "Linux man-pages 6.06" +.TH clone 2 2024-05-02 "Linux man-pages 6.8" .SH NAME clone, __clone2, clone3 \- create a child process .SH LIBRARY @@ -1745,7 +1745,7 @@ does not take arguments and .IR child_tid . .SH NOTES -One use of these systems calls +One use of these system calls is to implement threads: multiple flows of control in a program that run concurrently in a shared address space. .P @@ -1850,6 +1850,7 @@ so we should include it for portability. #include <stdlib.h> #include <string.h> #include <sys/mman.h> +#include <sys/types.h> #include <sys/utsname.h> #include <sys/wait.h> #include <unistd.h> diff --git a/upstream/archlinux/man2/close.2 b/upstream/archlinux/man2/close.2 index 5b6665f6..346d1d8e 100644 --- a/upstream/archlinux/man2/close.2 +++ b/upstream/archlinux/man2/close.2 @@ -13,7 +13,7 @@ .\" Modified 2000-07-22 by Nicolás Lichtmaier <nick@debian.org> .\" added note about close(2) not guaranteeing that data is safe on close. .\" -.TH close 2 2023-10-31 "Linux man-pages 6.06" +.TH close 2 2024-05-02 "Linux man-pages 6.8" .SH NAME close \- close a file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/close_range.2 b/upstream/archlinux/man2/close_range.2 index 017f95f9..738bf8f7 100644 --- a/upstream/archlinux/man2/close_range.2 +++ b/upstream/archlinux/man2/close_range.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH close_range 2 2023-10-31 "Linux man-pages 6.06" +.TH close_range 2 2024-05-02 "Linux man-pages 6.8" .SH NAME close_range \- close all file descriptors in a given range .SH LIBRARY @@ -11,10 +11,14 @@ Standard C library .RI ( libc ", " \-lc ) .SH SYNOPSIS .nf -.B #include <linux/close_range.h> +.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" +.B #include <unistd.h> .P -.BI "int close_range(unsigned int " first ", unsigned int " last , -.BI " unsigned int " flags ); +.BR "#include <linux/close_range.h>" " /* Definition of " CLOSE_RANGE_* +.BR "" " constants */" +.P +.BI "int close_range(unsigned int " first ", unsigned int " last \ +", int " flags ); .fi .SH DESCRIPTION The @@ -205,7 +209,7 @@ result from the calls to #include <limits.h> #include <stdio.h> #include <stdlib.h> -#include <sys/syscall.h> +#include <sys/types.h> #include <unistd.h> \& /* Show the contents of the symbolic links in /proc/self/fd */ @@ -259,7 +263,7 @@ main(int argc, char *argv[]) \& printf("========= About to call close_range() =======\en"); \& - if (syscall(SYS_close_range, 3, \[ti]0U, 0) == \-1) { + if (close_range(3, \[ti]0U, 0) == \-1) { perror("close_range"); exit(EXIT_FAILURE); } diff --git a/upstream/archlinux/man2/connect.2 b/upstream/archlinux/man2/connect.2 index 16ad92bd..0a810ddb 100644 --- a/upstream/archlinux/man2/connect.2 +++ b/upstream/archlinux/man2/connect.2 @@ -16,7 +16,7 @@ .\" Modified 1998, 1999 by Andi Kleen .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH connect 2 2023-11-01 "Linux man-pages 6.06" +.TH connect 2 2024-05-02 "Linux man-pages 6.8" .SH NAME connect \- initiate a connection on a socket .SH LIBRARY diff --git a/upstream/archlinux/man2/copy_file_range.2 b/upstream/archlinux/man2/copy_file_range.2 index 65beac38..e3d584fb 100644 --- a/upstream/archlinux/man2/copy_file_range.2 +++ b/upstream/archlinux/man2/copy_file_range.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH copy_file_range 2 2023-10-31 "Linux man-pages 6.06" +.TH copy_file_range 2 2024-05-02 "Linux man-pages 6.8" .SH NAME copy_file_range \- Copy a range of data from one file to another .SH LIBRARY @@ -252,6 +252,7 @@ the call failed to copy, while still reporting success. #include <stdio.h> #include <stdlib.h> #include <sys/stat.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/create_module.2 b/upstream/archlinux/man2/create_module.2 index 14bd594d..c792b10a 100644 --- a/upstream/archlinux/man2/create_module.2 +++ b/upstream/archlinux/man2/create_module.2 @@ -5,7 +5,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH create_module 2 2023-10-31 "Linux man-pages 6.06" +.TH create_module 2 2024-05-02 "Linux man-pages 6.8" .SH NAME create_module \- create a loadable module entry .SH SYNOPSIS diff --git a/upstream/archlinux/man2/delete_module.2 b/upstream/archlinux/man2/delete_module.2 index bd3b3146..34cfae61 100644 --- a/upstream/archlinux/man2/delete_module.2 +++ b/upstream/archlinux/man2/delete_module.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH delete_module 2 2023-10-31 "Linux man-pages 6.06" +.TH delete_module 2 2024-05-02 "Linux man-pages 6.8" .SH NAME delete_module \- unload a kernel module .SH LIBRARY diff --git a/upstream/archlinux/man2/dup.2 b/upstream/archlinux/man2/dup.2 index 2549d9fd..de7c9779 100644 --- a/upstream/archlinux/man2/dup.2 +++ b/upstream/archlinux/man2/dup.2 @@ -14,7 +14,7 @@ .\" details for dup2(). .\" 2008-10-09, mtk: add description of dup3() .\" -.TH dup 2 2023-10-31 "Linux man-pages 6.06" +.TH dup 2 2024-05-02 "Linux man-pages 6.8" .SH NAME dup, dup2, dup3 \- duplicate a file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/epoll_create.2 b/upstream/archlinux/man2/epoll_create.2 index 153fb385..134ad56d 100644 --- a/upstream/archlinux/man2/epoll_create.2 +++ b/upstream/archlinux/man2/epoll_create.2 @@ -8,7 +8,7 @@ .\" Modified 2005-04-04 by Marko Kohtala <marko.kohtala@gmail.com> .\" 2008-10-10, mtk: add description of epoll_create1() .\" -.TH epoll_create 2 2023-10-31 "Linux man-pages 6.06" +.TH epoll_create 2 2024-05-02 "Linux man-pages 6.8" .SH NAME epoll_create, epoll_create1 \- open an epoll file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/epoll_ctl.2 b/upstream/archlinux/man2/epoll_ctl.2 index 3a19826d..43cec6d2 100644 --- a/upstream/archlinux/man2/epoll_ctl.2 +++ b/upstream/archlinux/man2/epoll_ctl.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH epoll_ctl 2 2023-10-31 "Linux man-pages 6.06" +.TH epoll_ctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME epoll_ctl \- control interface for an epoll file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/epoll_wait.2 b/upstream/archlinux/man2/epoll_wait.2 index bfdad49c..05d9c728 100644 --- a/upstream/archlinux/man2/epoll_wait.2 +++ b/upstream/archlinux/man2/epoll_wait.2 @@ -6,7 +6,7 @@ .\" .\" 2007-04-30: mtk, Added description of epoll_pwait() .\" -.TH epoll_wait 2 2023-10-31 "Linux man-pages 6.06" +.TH epoll_wait 2 2024-05-02 "Linux man-pages 6.8" .SH NAME epoll_wait, epoll_pwait, epoll_pwait2 \- wait for an I/O event on an epoll file descriptor @@ -77,7 +77,7 @@ of \-1 causes .BR epoll_wait () to block indefinitely, while specifying a .I timeout -equal to zero cause +equal to zero causes .BR epoll_wait () to return immediately, even if no events are available. .P @@ -173,8 +173,8 @@ can block indefinitely. .SH RETURN VALUE On success, .BR epoll_wait () -returns the number of file descriptors ready for the requested I/O, or zero -if no file descriptor became ready during the requested +returns the number of file descriptors ready for the requested I/O operation, +or zero if no file descriptor became ready during the requested .I timeout milliseconds. On failure, diff --git a/upstream/archlinux/man2/eventfd.2 b/upstream/archlinux/man2/eventfd.2 index a44f6711..23a07308 100644 --- a/upstream/archlinux/man2/eventfd.2 +++ b/upstream/archlinux/man2/eventfd.2 @@ -6,7 +6,7 @@ .\" .\" 2008-10-10, mtk: describe eventfd2(), and EFD_NONBLOCK and EFD_CLOEXEC .\" -.TH eventfd 2 2023-10-31 "Linux man-pages 6.06" +.TH eventfd 2 2024-05-02 "Linux man-pages 6.8" .SH NAME eventfd \- create a file descriptor for event notification .SH LIBRARY @@ -385,6 +385,7 @@ Parent read 28 (0x1c) from efd #include <stdio.h> #include <stdlib.h> #include <sys/eventfd.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/execve.2 b/upstream/archlinux/man2/execve.2 index 73da5701..6fee3125 100644 --- a/upstream/archlinux/man2/execve.2 +++ b/upstream/archlinux/man2/execve.2 @@ -14,7 +14,7 @@ .\" 2007-09-14 Ollie Wild <aaw@google.com>, mtk .\" Add text describing limits on command-line arguments + environment .\" -.TH execve 2 2023-11-01 "Linux man-pages 6.06" +.TH execve 2 2024-05-02 "Linux man-pages 6.8" .SH NAME execve \- execute program .SH LIBRARY diff --git a/upstream/archlinux/man2/execveat.2 b/upstream/archlinux/man2/execveat.2 index 566314ec..66a9645d 100644 --- a/upstream/archlinux/man2/execveat.2 +++ b/upstream/archlinux/man2/execveat.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH execveat 2 2023-10-31 "Linux man-pages 6.06" +.TH execveat 2 2024-05-02 "Linux man-pages 6.8" .SH NAME execveat \- execute program relative to a directory file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/exit_group.2 b/upstream/archlinux/man2/exit_group.2 index f17d9a32..eb4e9c2c 100644 --- a/upstream/archlinux/man2/exit_group.2 +++ b/upstream/archlinux/man2/exit_group.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH exit_group 2 2023-10-31 "Linux man-pages 6.06" +.TH exit_group 2 2024-05-02 "Linux man-pages 6.8" .SH NAME exit_group \- exit all threads in a process .SH LIBRARY diff --git a/upstream/archlinux/man2/fallocate.2 b/upstream/archlinux/man2/fallocate.2 index 1ce8a196..20d446ac 100644 --- a/upstream/archlinux/man2/fallocate.2 +++ b/upstream/archlinux/man2/fallocate.2 @@ -6,7 +6,7 @@ .\" 2011-09-19: Added FALLOC_FL_PUNCH_HOLE .\" 2011-09-19: Substantial restructuring of the page .\" -.TH fallocate 2 2023-10-31 "Linux man-pages 6.06" +.TH fallocate 2 2024-05-02 "Linux man-pages 6.8" .SH NAME fallocate \- manipulate file space .SH LIBRARY diff --git a/upstream/archlinux/man2/fanotify_init.2 b/upstream/archlinux/man2/fanotify_init.2 index d0860043..d323696b 100644 --- a/upstream/archlinux/man2/fanotify_init.2 +++ b/upstream/archlinux/man2/fanotify_init.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2013, Heinrich Schuchardt <xypron.glpk@gmx.de> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH fanotify_init 2 2023-10-31 "Linux man-pages 6.06" +.TH fanotify_init 2 2024-05-02 "Linux man-pages 6.8" .SH NAME fanotify_init \- create and initialize fanotify group .SH LIBRARY diff --git a/upstream/archlinux/man2/fanotify_mark.2 b/upstream/archlinux/man2/fanotify_mark.2 index 7f3a3513..eed41497 100644 --- a/upstream/archlinux/man2/fanotify_mark.2 +++ b/upstream/archlinux/man2/fanotify_mark.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2013, Heinrich Schuchardt <xypron.glpk@gmx.de> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH fanotify_mark 2 2023-10-31 "Linux man-pages 6.06" +.TH fanotify_mark 2 2024-05-02 "Linux man-pages 6.8" .SH NAME fanotify_mark \- add, remove, or modify an fanotify mark on a filesystem object diff --git a/upstream/archlinux/man2/fcntl.2 b/upstream/archlinux/man2/fcntl.2 index 05d2e5d2..76a8bae0 100644 --- a/upstream/archlinux/man2/fcntl.2 +++ b/upstream/archlinux/man2/fcntl.2 @@ -44,7 +44,7 @@ .\" 2017-06-26, Jens Axboe <axboe@kernel.dk> .\" Document F_{GET,SET}_RW_HINT and F_{GET,SET}_FILE_RW_HINT .\" -.TH fcntl 2 2023-10-31 "Linux man-pages 6.06" +.TH fcntl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME fcntl \- manipulate file descriptor .SH LIBRARY @@ -54,21 +54,21 @@ Standard C library .nf .B #include <fcntl.h> .P -.BI "int fcntl(int " fd ", int " cmd ", ... /* " arg " */ );" +.BI "int fcntl(int " fd ", int " op ", ... /* " arg " */ );" .fi .SH DESCRIPTION .BR fcntl () performs one of the operations described below on the open file descriptor .IR fd . The operation is determined by -.IR cmd . +.IR op . .P .BR fcntl () can take an optional third argument. Whether or not this argument is required is determined by -.IR cmd . +.IR op . The required argument type is indicated in parentheses after each -.I cmd +.I op name (in most cases, the required type is .IR int , and we identify the argument using the name @@ -83,7 +83,7 @@ The preferred method of checking whether the host kernel supports a particular operation is to invoke .BR fcntl () with the desired -.I cmd +.I op value and then test whether the call failed with .BR EINVAL , indicating that the kernel does not recognize this value. @@ -121,7 +121,7 @@ see the description of in .BR open (2). .SS File descriptor flags -The following commands manipulate the flags associated with +The following operations manipulate the flags associated with a file descriptor. Currently, only one such flag is defined: .BR FD_CLOEXEC , @@ -198,7 +198,7 @@ and file creation flags in .I arg are ignored. -On Linux, this command can change only the +On Linux, this operation can change only the .BR O_APPEND , .BR O_ASYNC , .BR O_DIRECT , @@ -529,9 +529,9 @@ structure. By contrast with traditional record locks, the .I l_pid field of that structure must be set to zero -when using the commands described below. +when using the operations described below. .P -The commands for working with open file description locks are analogous +The operations for working with open file description locks are analogous to those used with traditional locks: .TP .BR F_OFD_SETLK " (\fIstruct flock *\fP)" @@ -722,7 +722,7 @@ one must also enable generation of signals on the file descriptor. This is done by using the .BR fcntl () .B F_SETFL -command to set the +operation to set the .B O_ASYNC file status flag on the file descriptor. Subsequently, a @@ -732,7 +732,7 @@ on the file descriptor. The .BR fcntl () .B F_SETSIG -command can be used to obtain delivery of a signal other than +operation can be used to obtain delivery of a signal other than .BR SIGIO . .IP Sending a signal to the owner process (group) specified by @@ -1120,7 +1120,7 @@ accessed by another process (e.g., flushing cached buffers) and then either remove or downgrade its lease. A lease is removed by performing an .B F_SETLEASE -command specifying +operation specifying .I arg as .BR F_UNLCK . @@ -1130,7 +1130,7 @@ then it is sufficient for the lease holder to downgrade the lease to a read lease. This is done by performing an .B F_SETLEASE -command specifying +operation specifying .I arg as .BR F_RDLCK . @@ -1179,11 +1179,11 @@ The default signal used to notify the lease holder is .BR SIGIO , but this can be changed using the .B F_SETSIG -command to +operation to .BR fcntl (). If a .B F_SETSIG -command is performed (even one specifying +operation is performed (even one specifying .BR SIGIO ), and the signal handler is established using @@ -1289,7 +1289,7 @@ The default signal is .BR SIGIO , but this can be changed using the .B F_SETSIG -command to +operation to .BR fcntl (). (Note that .B SIGIO @@ -1639,7 +1639,7 @@ A bit mask identifying the seals that have been set for the inode referred to by .IR fd . .TP -All other commands +All other operations Zero. .P On error, \-1 is returned, and @@ -1659,7 +1659,7 @@ another process. is not an open file descriptor .TP .B EBADF -.I cmd +.I op is .B F_SETLK or @@ -1668,7 +1668,7 @@ and the file descriptor open mode doesn't match with the type of lock requested. .TP .B EBUSY -.I cmd +.I op is .B F_SETPIPE_SZ and the new pipe capacity specified in @@ -1677,7 +1677,7 @@ is smaller than the amount of buffer space currently used to store data in the pipe. .TP .B EBUSY -.I cmd +.I op is .BR F_ADD_SEALS , .I arg @@ -1689,14 +1689,14 @@ and there exists a writable, shared mapping on the file referred to by .B EDEADLK It was detected that the specified .B F_SETLKW -command would cause a deadlock. +operation would cause a deadlock. .TP .B EFAULT .I lock is outside your accessible address space. .TP .B EINTR -.I cmd +.I op is .B F_SETLKW or @@ -1705,7 +1705,7 @@ and the operation was interrupted by a signal; see .BR signal (7). .TP .B EINTR -.I cmd +.I op is .BR F_GETLK , .BR F_SETLK , @@ -1719,11 +1719,11 @@ NFS), but can sometimes happen locally. .TP .B EINVAL The value specified in -.I cmd +.I op is not recognized by this kernel. .TP .B EINVAL -.I cmd +.I op is .B F_ADD_SEALS and @@ -1731,7 +1731,7 @@ and includes an unrecognized sealing bit. .TP .B EINVAL -.I cmd +.I op is .B F_ADD_SEALS or @@ -1741,7 +1741,7 @@ and the filesystem containing the inode referred to by does not support sealing. .TP .B EINVAL -.I cmd +.I op is .B F_DUPFD and @@ -1753,7 +1753,7 @@ in .BR getrlimit (2)). .TP .B EINVAL -.I cmd +.I op is .B F_SETSIG and @@ -1761,7 +1761,7 @@ and is not an allowable signal number. .TP .B EINVAL -.I cmd +.I op is .BR F_OFD_SETLK , .BR F_OFD_SETLKW , @@ -1772,7 +1772,7 @@ and was not specified as zero. .TP .B EMFILE -.I cmd +.I op is .B F_DUPFD and the per-process limit on the number of open file descriptors @@ -1785,13 +1785,13 @@ protocol failed (e.g., locking over NFS). .B ENOTDIR .B F_NOTIFY was specified in -.IR cmd , +.IR op , but .I fd does not refer to a directory. .TP .B EPERM -.I cmd +.I op is .B F_SETPIPE_SZ and the soft or hard user pipe limit has been reached; see @@ -1803,7 +1803,7 @@ Attempted to clear the flag on a file that has the append-only attribute set. .TP .B EPERM -.I cmd +.I op was .BR F_ADD_SEALS , but @@ -1897,7 +1897,7 @@ Consequently, an system call was added in Linux 2.4. The newer system call employs a different structure for file locking, .IR flock64 , -and corresponding commands, +and corresponding operations, .BR F_GETLK64 , .BR F_SETLK64 , and @@ -1940,7 +1940,7 @@ Consequently, an system call was added in Linux 2.4. The newer system call employs a different structure for file locking, .IR flock64 , -and corresponding commands, +and corresponding operations, .BR F_GETLK64 , .BR F_SETLK64 , and diff --git a/upstream/archlinux/man2/flock.2 b/upstream/archlinux/man2/flock.2 index 1ef6962f..7bad7f97 100644 --- a/upstream/archlinux/man2/flock.2 +++ b/upstream/archlinux/man2/flock.2 @@ -12,7 +12,7 @@ .\" FIXME Maybe document LOCK_MAND, LOCK_RW, LOCK_READ, LOCK_WRITE .\" which only have effect for SAMBA. .\" -.TH flock 2 2023-10-31 "Linux man-pages 6.06" +.TH flock 2 2024-05-02 "Linux man-pages 6.8" .SH NAME flock \- apply or remove an advisory lock on an open file .SH LIBRARY @@ -22,13 +22,13 @@ Standard C library .nf .B #include <sys/file.h> .P -.BI "int flock(int " fd ", int " operation ); +.BI "int flock(int " fd ", int " op ); .fi .SH DESCRIPTION Apply or remove an advisory lock on the open file specified by .IR fd . The argument -.I operation +.I op is one of the following: .RS 4 .TP 9 @@ -111,7 +111,7 @@ delivery of a signal caught by a handler; see .BR signal (7). .TP .B EINVAL -.I operation +.I op is invalid. .TP .B ENOLCK diff --git a/upstream/archlinux/man2/fork.2 b/upstream/archlinux/man2/fork.2 index a08f38b8..39c2860b 100644 --- a/upstream/archlinux/man2/fork.2 +++ b/upstream/archlinux/man2/fork.2 @@ -16,7 +16,7 @@ .\" Greatly expanded, to describe all attributes that differ .\" parent and child. .\" -.TH fork 2 2023-10-31 "Linux man-pages 6.06" +.TH fork 2 2024-05-02 "Linux man-pages 6.8" .SH NAME fork \- create a child process .SH LIBRARY @@ -307,6 +307,7 @@ for more examples. #include <stdint.h> #include <stdio.h> #include <stdlib.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/fsync.2 b/upstream/archlinux/man2/fsync.2 index 8c1749dc..0e293fd7 100644 --- a/upstream/archlinux/man2/fsync.2 +++ b/upstream/archlinux/man2/fsync.2 @@ -15,7 +15,7 @@ .\" 2006-04-28, mtk, substantial rewrite of various parts. .\" 2012-02-27 Various changes by Christoph Hellwig <hch@lst.de> .\" -.TH fsync 2 2023-10-31 "Linux man-pages 6.06" +.TH fsync 2 2024-05-02 "Linux man-pages 6.8" .SH NAME fsync, fdatasync \- synchronize a file's in-core state with storage device .SH LIBRARY diff --git a/upstream/archlinux/man2/futex.2 b/upstream/archlinux/man2/futex.2 index 690fb776..89f71bff 100644 --- a/upstream/archlinux/man2/futex.2 +++ b/upstream/archlinux/man2/futex.2 @@ -19,7 +19,7 @@ .\" FIXME Do we need to add some text regarding Torvald Riegel's 2015-01-24 mail .\" http://thread.gmane.org/gmane.linux.kernel/1703405/focus=1873242 .\" -.TH futex 2 2023-10-31 "Linux man-pages 6.06" +.TH futex 2 2024-05-02 "Linux man-pages 6.8" .SH NAME futex \- fast user-space locking .SH LIBRARY diff --git a/upstream/archlinux/man2/futimesat.2 b/upstream/archlinux/man2/futimesat.2 index ef9751cd..f2c83863 100644 --- a/upstream/archlinux/man2/futimesat.2 +++ b/upstream/archlinux/man2/futimesat.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH futimesat 2 2023-10-31 "Linux man-pages 6.06" +.TH futimesat 2 2024-05-02 "Linux man-pages 6.8" .SH NAME futimesat \- change timestamps of a file relative to a \ directory file descriptor diff --git a/upstream/archlinux/man2/get_kernel_syms.2 b/upstream/archlinux/man2/get_kernel_syms.2 index e059e793..7a15f085 100644 --- a/upstream/archlinux/man2/get_kernel_syms.2 +++ b/upstream/archlinux/man2/get_kernel_syms.2 @@ -5,7 +5,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH get_kernel_syms 2 2023-10-31 "Linux man-pages 6.06" +.TH get_kernel_syms 2 2024-05-02 "Linux man-pages 6.8" .SH NAME get_kernel_syms \- retrieve exported kernel and module symbols .SH SYNOPSIS diff --git a/upstream/archlinux/man2/get_mempolicy.2 b/upstream/archlinux/man2/get_mempolicy.2 index 3d308c61..8b061dbf 100644 --- a/upstream/archlinux/man2/get_mempolicy.2 +++ b/upstream/archlinux/man2/get_mempolicy.2 @@ -7,7 +7,7 @@ .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com> .\" more precise specification of behavior. .\" -.TH get_mempolicy 2 2023-10-31 "Linux man-pages 6.06" +.TH get_mempolicy 2 2024-05-02 "Linux man-pages 6.8" .SH NAME get_mempolicy \- retrieve NUMA memory policy for a thread .SH LIBRARY @@ -137,7 +137,9 @@ specifies but not .BR MPOL_F_ADDR , and the thread's current policy is -.BR MPOL_INTERLEAVE , +.B MPOL_INTERLEAVE +or +.BR MPOL_WEIGHTED_INTERLEAVE , then .BR get_mempolicy () will return in the location pointed to by a non-NULL @@ -205,8 +207,10 @@ specified .B MPOL_F_NODE but not .B MPOL_F_ADDR -and the current thread policy is not -.BR MPOL_INTERLEAVE . +and the current thread policy is neither +.B MPOL_INTERLEAVE +nor +.BR MPOL_WEIGHTED_INTERLEAVE . Or, .I flags specified diff --git a/upstream/archlinux/man2/get_robust_list.2 b/upstream/archlinux/man2/get_robust_list.2 index 4b8533bb..c6efa2a1 100644 --- a/upstream/archlinux/man2/get_robust_list.2 +++ b/upstream/archlinux/man2/get_robust_list.2 @@ -7,7 +7,7 @@ .\" FIXME Something could be added to this page (or exit(2)) .\" about exit_robust_list processing .\" -.TH get_robust_list 2 2023-10-31 "Linux man-pages 6.06" +.TH get_robust_list 2 2024-05-02 "Linux man-pages 6.8" .SH NAME get_robust_list, set_robust_list \- get/set list of robust futexes .SH LIBRARY diff --git a/upstream/archlinux/man2/getcpu.2 b/upstream/archlinux/man2/getcpu.2 index 90c93e43..b98de536 100644 --- a/upstream/archlinux/man2/getcpu.2 +++ b/upstream/archlinux/man2/getcpu.2 @@ -4,7 +4,7 @@ .\" .\" 2008, mtk, various edits .\" -.TH getcpu 2 2023-10-31 "Linux man-pages 6.06" +.TH getcpu 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getcpu \- determine CPU and NUMA node on which the calling thread is running .SH LIBRARY diff --git a/upstream/archlinux/man2/getdents.2 b/upstream/archlinux/man2/getdents.2 index d57204bd..b77e7c81 100644 --- a/upstream/archlinux/man2/getdents.2 +++ b/upstream/archlinux/man2/getdents.2 @@ -8,7 +8,7 @@ .\" Derived from 'readdir.2'. .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH getdents 2 2023-10-31 "Linux man-pages 6.06" +.TH getdents 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getdents, getdents64 \- get directory entries .SH LIBRARY @@ -67,7 +67,7 @@ structure is declared as follows: .EX struct linux_dirent { unsigned long d_ino; /* Inode number */ - unsigned long d_off; /* Offset to next \fIlinux_dirent\fP */ + unsigned long d_off; /* Not an offset; see below */ unsigned short d_reclen; /* Length of this \fIlinux_dirent\fP */ char d_name[]; /* Filename (null\-terminated) */ /* length is actually (d_reclen \- 2 \- @@ -84,8 +84,12 @@ struct linux_dirent { .I d_ino is an inode number. .I d_off -is the distance from the start of the directory to the start of the next -.IR linux_dirent . +is a filesystem-specific value with no specific meaning to user space, +though on older filesystems it used to be +the distance from the start of the directory to the start of the next +.IR linux_dirent ; +see +.BR readdir (3) . .I d_reclen is the size of this entire .IR linux_dirent . @@ -167,7 +171,7 @@ structures of the following type: .EX struct linux_dirent64 { ino64_t d_ino; /* 64\-bit inode number */ - off64_t d_off; /* 64\-bit offset to next structure */ + off64_t d_off; /* Not an offset; see getdents() */ unsigned short d_reclen; /* Size of this dirent */ unsigned char d_type; /* File type */ char d_name[]; /* Filename (null\-terminated) */ @@ -258,6 +262,7 @@ inode# file type d_reclen d_off d_name #include <stdio.h> #include <stdlib.h> #include <sys/syscall.h> +#include <sys/types.h> #include <unistd.h> \& struct linux_dirent { diff --git a/upstream/archlinux/man2/getdomainname.2 b/upstream/archlinux/man2/getdomainname.2 index 24cf7736..db6ded25 100644 --- a/upstream/archlinux/man2/getdomainname.2 +++ b/upstream/archlinux/man2/getdomainname.2 @@ -6,7 +6,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2008-11-27 by mtk .\" -.TH getdomainname 2 2023-10-31 "Linux man-pages 6.06" +.TH getdomainname 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getdomainname, setdomainname \- get/set NIS domain name .SH LIBRARY diff --git a/upstream/archlinux/man2/getgid.2 b/upstream/archlinux/man2/getgid.2 index 61b838cc..5e1dc6cf 100644 --- a/upstream/archlinux/man2/getgid.2 +++ b/upstream/archlinux/man2/getgid.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getgid 2 2023-10-31 "Linux man-pages 6.06" +.TH getgid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getgid, getegid \- get group identity .SH LIBRARY diff --git a/upstream/archlinux/man2/getgroups.2 b/upstream/archlinux/man2/getgroups.2 index cddba228..240d22e8 100644 --- a/upstream/archlinux/man2/getgroups.2 +++ b/upstream/archlinux/man2/getgroups.2 @@ -9,7 +9,7 @@ .\" 2008-05-03, mtk, expanded and rewrote parts of DESCRIPTION and RETURN .\" VALUE, made style of page more consistent with man-pages style. .\" -.TH getgroups 2 2023-10-31 "Linux man-pages 6.06" +.TH getgroups 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getgroups, setgroups \- get/set list of supplementary group IDs .SH LIBRARY diff --git a/upstream/archlinux/man2/gethostname.2 b/upstream/archlinux/man2/gethostname.2 index 23dc9398..205cba9f 100644 --- a/upstream/archlinux/man2/gethostname.2 +++ b/upstream/archlinux/man2/gethostname.2 @@ -9,7 +9,7 @@ .\" Modified 2004-06-17 by mtk .\" Modified 2008-11-27 by mtk .\" -.TH gethostname 2 2023-10-31 "Linux man-pages 6.06" +.TH gethostname 2 2024-05-02 "Linux man-pages 6.8" .SH NAME gethostname, sethostname \- get/set hostname .SH LIBRARY diff --git a/upstream/archlinux/man2/getitimer.2 b/upstream/archlinux/man2/getitimer.2 index 67ffe281..730dec92 100644 --- a/upstream/archlinux/man2/getitimer.2 +++ b/upstream/archlinux/man2/getitimer.2 @@ -10,7 +10,7 @@ .\" 2005-04-06 mtk, Matthias Lang <matthias@corelatus.se> .\" Noted MAX_SEC_IN_JIFFIES ceiling .\" -.TH getitimer 2 2023-10-31 "Linux man-pages 6.06" +.TH getitimer 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getitimer, setitimer \- get or set value of an interval timer .SH LIBRARY diff --git a/upstream/archlinux/man2/getpagesize.2 b/upstream/archlinux/man2/getpagesize.2 index 0c5f2d23..206ac10c 100644 --- a/upstream/archlinux/man2/getpagesize.2 +++ b/upstream/archlinux/man2/getpagesize.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getpagesize 2 2023-10-31 "Linux man-pages 6.06" +.TH getpagesize 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getpagesize \- get memory page size .SH LIBRARY @@ -37,6 +37,19 @@ returns the number of bytes in a memory page, where "page" is a fixed-length block, the unit for memory allocation and file mapping performed by .BR mmap (2). +.SH VERSIONS +A user program should not hard-code a page size, +neither as a literal nor using the +.B PAGE_SIZE +macro, +because some architectures support multiple page sizes. +.P +This manual page is in section 2 because +Alpha, SPARC, and SPARC64 +all have a Linux system call +.BR getpagesize () +though other architectures do not, +and use the ELF auxiliary vector instead. .SH STANDARDS None. .SH HISTORY @@ -44,46 +57,11 @@ This call first appeared in 4.2BSD. SVr4, 4.4BSD, SUSv2. In SUSv2 the .BR getpagesize () -call is labeled LEGACY, and in POSIX.1-2001 -it has been dropped; -HP-UX does not have this call. -.SH NOTES -Portable applications should employ -.I sysconf(_SC_PAGESIZE) -instead of -.BR getpagesize (): -.P -.in +4n -.EX -#include <unistd.h> -long sz = sysconf(_SC_PAGESIZE); -.EE -.in +call was labeled LEGACY, +and it was removed in POSIX.1-2001. .P -(Most systems allow the synonym -.B _SC_PAGE_SIZE -for -.BR _SC_PAGESIZE .) -.P -Whether -.BR getpagesize () -is present as a Linux system call depends on the architecture. -If it is, it returns the kernel symbol -.BR PAGE_SIZE , -whose value depends on the architecture and machine model. -Generally, one uses binaries that are dependent on the architecture but not -on the machine model, in order to have a single binary -distribution per architecture. -This means that a user program -should not find -.B PAGE_SIZE -at compile time from a header file, -but use an actual system call, at least for those architectures -(like sun4) where this dependency exists. -Here glibc 2.0 fails because its -.BR getpagesize () -returns a statically derived value, and does not use a system call. -Things are OK in glibc 2.1. +glibc 2.0 returned a constant +even on architectures with multiple page sizes. .SH SEE ALSO .BR mmap (2), .BR sysconf (3) diff --git a/upstream/archlinux/man2/getpeername.2 b/upstream/archlinux/man2/getpeername.2 index be6f521a..391ced06 100644 --- a/upstream/archlinux/man2/getpeername.2 +++ b/upstream/archlinux/man2/getpeername.2 @@ -11,7 +11,7 @@ .\" Modified 17 Jul 2002, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added 'socket' to NAME, so that "man -k socket" will show this page. .\" -.TH getpeername 2 2023-10-31 "Linux man-pages 6.06" +.TH getpeername 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getpeername \- get name of connected peer socket .SH LIBRARY diff --git a/upstream/archlinux/man2/getpid.2 b/upstream/archlinux/man2/getpid.2 index 6d8b39f7..a2c7418f 100644 --- a/upstream/archlinux/man2/getpid.2 +++ b/upstream/archlinux/man2/getpid.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getpid 2 2023-10-31 "Linux man-pages 6.06" +.TH getpid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getpid, getppid \- get process identification .SH LIBRARY diff --git a/upstream/archlinux/man2/getpriority.2 b/upstream/archlinux/man2/getpriority.2 index 6a6380a2..49d85a91 100644 --- a/upstream/archlinux/man2/getpriority.2 +++ b/upstream/archlinux/man2/getpriority.2 @@ -14,7 +14,7 @@ .\" Clarified meaning of 0 value for 'who' argument .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH getpriority 2 2023-10-31 "Linux man-pages 6.06" +.TH getpriority 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getpriority, setpriority \- get/set program scheduling priority .SH LIBRARY diff --git a/upstream/archlinux/man2/getrandom.2 b/upstream/archlinux/man2/getrandom.2 index aef6508e..bbc682e6 100644 --- a/upstream/archlinux/man2/getrandom.2 +++ b/upstream/archlinux/man2/getrandom.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getrandom 2 2023-10-31 "Linux man-pages 6.06" +.TH getrandom 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getrandom \- obtain a series of random bytes .SH LIBRARY diff --git a/upstream/archlinux/man2/getresuid.2 b/upstream/archlinux/man2/getresuid.2 index f31a4497..b83ec211 100644 --- a/upstream/archlinux/man2/getresuid.2 +++ b/upstream/archlinux/man2/getresuid.2 @@ -5,7 +5,7 @@ .\" .\" Modified, 2003-05-26, Michael Kerrisk, <mtk.manpages@gmail.com> .\" -.TH getresuid 2 2023-10-31 "Linux man-pages 6.06" +.TH getresuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getresuid, getresgid \- get real, effective, and saved user/group IDs .SH LIBRARY diff --git a/upstream/archlinux/man2/getrlimit.2 b/upstream/archlinux/man2/getrlimit.2 index f64100b8..d9b375db 100644 --- a/upstream/archlinux/man2/getrlimit.2 +++ b/upstream/archlinux/man2/getrlimit.2 @@ -42,7 +42,7 @@ .\" 2008-05-07, mtk / Peter Zijlstra, Added description of RLIMIT_RTTIME .\" 2010-11-06, mtk: Added documentation of prlimit() .\" -.TH getrlimit 2 2023-10-31 "Linux man-pages 6.06" +.TH getrlimit 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getrlimit, setrlimit, prlimit \- get/set resource limits .SH LIBRARY @@ -717,7 +717,7 @@ Linux doesn't return an error when an attempt to set .B RLIMIT_CPU has failed, for compatibility reasons. .\" -.SS Representation of """large""" resource limit values on 32-bit platforms +.SS Representation of \[dq]large\[dq] resource limit values on 32-bit platforms The glibc .BR getrlimit () and diff --git a/upstream/archlinux/man2/getrusage.2 b/upstream/archlinux/man2/getrusage.2 index 107365a2..1970afad 100644 --- a/upstream/archlinux/man2/getrusage.2 +++ b/upstream/archlinux/man2/getrusage.2 @@ -17,7 +17,7 @@ .\" document ru_maxrss .\" 2010-05-24, mtk, enhanced description of various fields .\" -.TH getrusage 2 2023-10-31 "Linux man-pages 6.06" +.TH getrusage 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getrusage \- get resource usage .SH LIBRARY @@ -239,15 +239,12 @@ implementation.) .SH NOTES Resource usage metrics are preserved across an .BR execve (2). -.P -See also the description of -.IR /proc/ pid /stat -in -.BR proc (5). .SH SEE ALSO .BR clock_gettime (2), .BR getrlimit (2), .BR times (2), .BR wait (2), .BR wait4 (2), -.BR clock (3) +.BR clock (3), +.BR proc_pid_stat (5), +.BR proc_pid_io (5) diff --git a/upstream/archlinux/man2/getsid.2 b/upstream/archlinux/man2/getsid.2 index ecdcdbec..ff24bf5e 100644 --- a/upstream/archlinux/man2/getsid.2 +++ b/upstream/archlinux/man2/getsid.2 @@ -5,7 +5,7 @@ .\" .\" Modified Thu Oct 31 14:18:40 1996 by Eric S. Raymond <esr@y\thyrsus.com> .\" Modified 2001-12-17, aeb -.TH getsid 2 2023-10-31 "Linux man-pages 6.06" +.TH getsid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getsid \- get session ID .SH LIBRARY diff --git a/upstream/archlinux/man2/getsockname.2 b/upstream/archlinux/man2/getsockname.2 index 44d4f885..02ca3181 100644 --- a/upstream/archlinux/man2/getsockname.2 +++ b/upstream/archlinux/man2/getsockname.2 @@ -9,7 +9,7 @@ .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Sun Mar 28 21:26:46 1999 by Andries Brouwer <aeb@cwi.nl> .\" -.TH getsockname 2 2023-10-31 "Linux man-pages 6.06" +.TH getsockname 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getsockname \- get socket name .SH LIBRARY diff --git a/upstream/archlinux/man2/getsockopt.2 b/upstream/archlinux/man2/getsockopt.2 index 448235c3..2547ecef 100644 --- a/upstream/archlinux/man2/getsockopt.2 +++ b/upstream/archlinux/man2/getsockopt.2 @@ -13,7 +13,7 @@ .\" Modified 1999 by Andi Kleen <ak@muc.de>. .\" Removed most stuff because it is in socket.7 now. .\" -.TH getsockopt 2 2023-10-31 "Linux man-pages 6.06" +.TH getsockopt 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getsockopt, setsockopt \- get and set options on sockets .SH LIBRARY diff --git a/upstream/archlinux/man2/gettid.2 b/upstream/archlinux/man2/gettid.2 index 007a6a73..8947c0c8 100644 --- a/upstream/archlinux/man2/gettid.2 +++ b/upstream/archlinux/man2/gettid.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH gettid 2 2023-10-31 "Linux man-pages 6.06" +.TH gettid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME gettid \- get thread identification .SH LIBRARY diff --git a/upstream/archlinux/man2/gettimeofday.2 b/upstream/archlinux/man2/gettimeofday.2 index fcdcd9b1..aba47ea9 100644 --- a/upstream/archlinux/man2/gettimeofday.2 +++ b/upstream/archlinux/man2/gettimeofday.2 @@ -17,7 +17,7 @@ .\" Modified, 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirement. .\" -.TH gettimeofday 2 2023-10-31 "Linux man-pages 6.06" +.TH gettimeofday 2 2024-05-02 "Linux man-pages 6.8" .SH NAME gettimeofday, settimeofday \- get / set time .SH LIBRARY diff --git a/upstream/archlinux/man2/getuid.2 b/upstream/archlinux/man2/getuid.2 index e669f7fd..132ad431 100644 --- a/upstream/archlinux/man2/getuid.2 +++ b/upstream/archlinux/man2/getuid.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Historical remark, aeb, 2004-06-05 -.TH getuid 2 2023-10-31 "Linux man-pages 6.06" +.TH getuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getuid, geteuid \- get user identity .SH LIBRARY diff --git a/upstream/archlinux/man2/getunwind.2 b/upstream/archlinux/man2/getunwind.2 index 6fb96e33..8ee2781a 100644 --- a/upstream/archlinux/man2/getunwind.2 +++ b/upstream/archlinux/man2/getunwind.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getunwind 2 2023-10-31 "Linux man-pages 6.06" +.TH getunwind 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getunwind \- copy the unwind data to caller's buffer .SH LIBRARY diff --git a/upstream/archlinux/man2/getxattr.2 b/upstream/archlinux/man2/getxattr.2 index e65a2a6d..498a7cc3 100644 --- a/upstream/archlinux/man2/getxattr.2 +++ b/upstream/archlinux/man2/getxattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH getxattr 2 2023-10-31 "Linux man-pages 6.06" +.TH getxattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value .SH LIBRARY diff --git a/upstream/archlinux/man2/idle.2 b/upstream/archlinux/man2/idle.2 index 53a48ed4..5b5078da 100644 --- a/upstream/archlinux/man2/idle.2 +++ b/upstream/archlinux/man2/idle.2 @@ -9,7 +9,7 @@ .\" N.B. calling "idle" from user process used to hang process! .\" Modified Thu Oct 31 14:41:15 1996 by Eric S. Raymond <esr@thyrsus.com> .\" " -.TH idle 2 2023-10-31 "Linux man-pages 6.06" +.TH idle 2 2024-05-02 "Linux man-pages 6.8" .SH NAME idle \- make process 0 idle .SH SYNOPSIS diff --git a/upstream/archlinux/man2/init_module.2 b/upstream/archlinux/man2/init_module.2 index b667b841..3c01d6e4 100644 --- a/upstream/archlinux/man2/init_module.2 +++ b/upstream/archlinux/man2/init_module.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH init_module 2 2023-10-31 "Linux man-pages 6.06" +.TH init_module 2 2024-05-02 "Linux man-pages 6.8" .SH NAME init_module, finit_module \- load a kernel module .SH LIBRARY @@ -107,6 +107,10 @@ Ignore symbol version hashes. .TP .B MODULE_INIT_IGNORE_VERMAGIC Ignore kernel version magic. +.TP +.BR MODULE_INIT_COMPRESSED_FILE " (since Linux 5.17)" +.\" commit b1ae6dc41eaaa98bb75671e0f3665bfda248c3e7 +Use in-kernel module decompression. .P There are some safety checks built into a module to ensure that it matches the kernel against which it is loaded. @@ -136,6 +140,40 @@ If the kernel is built to permit forced loading (i.e., configured with then loading continues, otherwise it fails with the error .B ENOEXEC as expected for malformed modules. +.P +If the kernel was build with +.BR CONFIG_MODULE_DECOMPRESS , +the in-kernel decompression feature can be used. +User-space code can check if the kernel supports decompression +by reading the +.I /sys/module/compression +attribute. +If the kernel supports decompression, +the compressed file can directly be passed to +.BR finit_module () +using the +.B MODULE_INIT_COMPRESSED_FILE +flag. +The in-kernel module decompressor supports the following compression algorithms: +.P +.RS 4 +.PD 0 +.IP \[bu] 3 +.I gzip +(since Linux 5.17) +.IP \[bu] +.I xz +(since Linux 5.17) +.IP \[bu] +.I zstd +.\" commit 169a58ad824d896b9e291a27193342616e651b82 +(since Linux 6.2) +.PD +.RE +.P +The kernel only implements a single decompression method. +This is selected during module generation accordingly to the compression method +chosen in the kernel configuration. .SH RETURN VALUE On success, these system calls return 0. On error, \-1 is returned and @@ -223,10 +261,23 @@ is too large. .I flags is invalid. .TP +.B EINVAL +The decompressor sanity checks failed, +while loading a compressed module with flag +.B MODULE_INIT_COMPRESSED_FILE +set. +.TP .B ENOEXEC .I fd does not refer to an open file. .TP +.BR EOPNOTSUPP " (since Linux 5.17)" +The flag +.B MODULE_INIT_COMPRESSED_FILE +is set to load a compressed module, +and the kernel was built without +.BR CONFIG_MODULE_DECOMPRESS . +.TP .BR ETXTBSY " (since Linux 4.7)" .\" commit 39d637af5aa7577f655c58b9e55587566c63a0af The file referred to by diff --git a/upstream/archlinux/man2/inotify_add_watch.2 b/upstream/archlinux/man2/inotify_add_watch.2 index f25a8240..feb41178 100644 --- a/upstream/archlinux/man2/inotify_add_watch.2 +++ b/upstream/archlinux/man2/inotify_add_watch.2 @@ -6,7 +6,7 @@ .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version .\" 2006-02-07 mtk, various changes .\" -.TH inotify_add_watch 2 2023-10-31 "Linux man-pages 6.06" +.TH inotify_add_watch 2 2024-05-02 "Linux man-pages 6.8" .SH NAME inotify_add_watch \- add a watch to an initialized inotify instance .SH LIBRARY diff --git a/upstream/archlinux/man2/inotify_init.2 b/upstream/archlinux/man2/inotify_init.2 index 91c28cfb..938b141d 100644 --- a/upstream/archlinux/man2/inotify_init.2 +++ b/upstream/archlinux/man2/inotify_init.2 @@ -7,7 +7,7 @@ .\" 2006-02-07 mtk, minor changes .\" 2008-10-10 mtk: add description of inotify_init1() .\" -.TH inotify_init 2 2023-10-31 "Linux man-pages 6.06" +.TH inotify_init 2 2024-05-02 "Linux man-pages 6.8" .SH NAME inotify_init, inotify_init1 \- initialize an inotify instance .SH LIBRARY diff --git a/upstream/archlinux/man2/inotify_rm_watch.2 b/upstream/archlinux/man2/inotify_rm_watch.2 index 02a045c7..59e83963 100644 --- a/upstream/archlinux/man2/inotify_rm_watch.2 +++ b/upstream/archlinux/man2/inotify_rm_watch.2 @@ -5,7 +5,7 @@ .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version .\" 2006-02-07 mtk, minor changes .\" -.TH inotify_rm_watch 2 2023-10-31 "Linux man-pages 6.06" +.TH inotify_rm_watch 2 2024-05-02 "Linux man-pages 6.8" .SH NAME inotify_rm_watch \- remove an existing watch from an inotify instance .SH LIBRARY diff --git a/upstream/archlinux/man2/intro.2 b/upstream/archlinux/man2/intro.2 index dd70500a..0ad135cc 100644 --- a/upstream/archlinux/man2/intro.2 +++ b/upstream/archlinux/man2/intro.2 @@ -6,7 +6,7 @@ .\" new _syscall(2) page, and substantially enhanced and rewrote .\" the remaining material on this page. .\" -.TH intro 2 2023-10-31 "Linux man-pages 6.06" +.TH intro 2 2024-05-02 "Linux man-pages 6.8" .SH NAME intro \- introduction to system calls .SH DESCRIPTION diff --git a/upstream/archlinux/man2/io_cancel.2 b/upstream/archlinux/man2/io_cancel.2 index 5ab47e7b..04276087 100644 --- a/upstream/archlinux/man2/io_cancel.2 +++ b/upstream/archlinux/man2/io_cancel.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_cancel 2 2023-10-31 "Linux man-pages 6.06" +.TH io_cancel 2 2024-05-02 "Linux man-pages 6.8" .SH NAME io_cancel \- cancel an outstanding asynchronous I/O operation .SH LIBRARY diff --git a/upstream/archlinux/man2/io_destroy.2 b/upstream/archlinux/man2/io_destroy.2 index 7b97a979..1ff387b9 100644 --- a/upstream/archlinux/man2/io_destroy.2 +++ b/upstream/archlinux/man2/io_destroy.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_destroy 2 2023-10-31 "Linux man-pages 6.06" +.TH io_destroy 2 2024-05-02 "Linux man-pages 6.8" .SH NAME io_destroy \- destroy an asynchronous I/O context .SH LIBRARY diff --git a/upstream/archlinux/man2/io_getevents.2 b/upstream/archlinux/man2/io_getevents.2 index a40950d5..080fcedd 100644 --- a/upstream/archlinux/man2/io_getevents.2 +++ b/upstream/archlinux/man2/io_getevents.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_getevents 2 2023-10-31 "Linux man-pages 6.06" +.TH io_getevents 2 2024-05-02 "Linux man-pages 6.8" .SH NAME io_getevents \- read asynchronous I/O events from the completion queue .SH LIBRARY diff --git a/upstream/archlinux/man2/io_setup.2 b/upstream/archlinux/man2/io_setup.2 index 1dfd3a94..bdb44cf2 100644 --- a/upstream/archlinux/man2/io_setup.2 +++ b/upstream/archlinux/man2/io_setup.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_setup 2 2023-10-31 "Linux man-pages 6.06" +.TH io_setup 2 2024-05-02 "Linux man-pages 6.8" .SH NAME io_setup \- create an asynchronous I/O context .SH LIBRARY diff --git a/upstream/archlinux/man2/io_submit.2 b/upstream/archlinux/man2/io_submit.2 index 5398d53e..803cb2ba 100644 --- a/upstream/archlinux/man2/io_submit.2 +++ b/upstream/archlinux/man2/io_submit.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_submit 2 2023-10-31 "Linux man-pages 6.06" +.TH io_submit 2 2024-05-02 "Linux man-pages 6.8" .SH NAME io_submit \- submit asynchronous I/O blocks for processing .SH LIBRARY diff --git a/upstream/archlinux/man2/ioctl.2 b/upstream/archlinux/man2/ioctl.2 index 75c8ad11..65aeb387 100644 --- a/upstream/archlinux/man2/ioctl.2 +++ b/upstream/archlinux/man2/ioctl.2 @@ -10,7 +10,7 @@ .\" Modified 1999-06-25 by Rachael Munns <vashti@dream.org.uk> .\" Modified 2000-09-21 by Andries Brouwer <aeb@cwi.nl> .\" -.TH ioctl 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl \- control device .SH LIBRARY @@ -20,8 +20,8 @@ Standard C library .nf .B #include <sys/ioctl.h> .P -.BI "int ioctl(int " fd ", unsigned long " request ", ...);" "\f[R] /* glibc, BSD */\f[]" -.BI "int ioctl(int " fd ", int " request ", ...);" "\f[R] /* musl, other UNIX */\f[]" +.BI "int ioctl(int " fd ", unsigned long " op ", ...);" "\f[R] /* glibc, BSD */\f[]" +.BI "int ioctl(int " fd ", int " op ", ...);" "\f[R] /* musl, other UNIX */\f[]" .fi .SH DESCRIPTION The @@ -30,12 +30,12 @@ system call manipulates the underlying device parameters of special files. In particular, many operating characteristics of character special files (e.g., terminals) may be controlled with .BR ioctl () -requests. +operations. The argument .I fd must be an open file descriptor. .P -The second argument is a device-dependent request code. +The second argument is a device-dependent operation code. The third argument is an untyped pointer to memory. It's traditionally .BI "char *" argp @@ -45,7 +45,7 @@ was valid C), and will be so named for this discussion. .P An .BR ioctl () -.I request +.I op has encoded in it whether the argument is an .I in parameter or @@ -55,7 +55,7 @@ parameter, and the size of the argument in bytes. Macros and defines used in specifying an .BR ioctl () -.I request +.I op are located in the file .IR <sys/ioctl.h> . See NOTES. @@ -63,7 +63,7 @@ See NOTES. Usually, on success zero is returned. A few .BR ioctl () -requests use the return value as an output parameter +operations use the return value as an output parameter and return a nonnegative value on success. On error, \-1 is returned, and .I errno @@ -79,7 +79,7 @@ is not a valid file descriptor. references an inaccessible memory area. .TP .B EINVAL -.I request +.I op or .I argp is not valid. @@ -89,7 +89,7 @@ is not valid. is not associated with a character special device. .TP .B ENOTTY -The specified request does not apply to the kind of object that the +The specified operation does not apply to the kind of object that the file descriptor .I fd references. @@ -106,7 +106,7 @@ Version\~7 AT&T UNIX has .PD 0 .in +4n .nf -.BI "ioctl(int " fildes ", int " request ", struct sgttyb *" argp ); +.BI "ioctl(int " fildes ", int " op ", struct sgttyb *" argp ); .fi .in .P @@ -117,7 +117,7 @@ has historically been used by .BR stty (2) and .BR gtty (2), -and is polymorphic by request type (like a +and is polymorphic by operation type (like a .B void * would be, if it had been available)). .P @@ -129,7 +129,7 @@ without a type at all. .PD 0 .in +4n .nf -.BI "ioctl(int " d ", unsigned long " request ", char *" argp ); +.BI "ioctl(int " d ", unsigned long " op ", char *" argp ); .fi .in .P @@ -143,7 +143,7 @@ SysVr4 has .PD 0 .in +4n .nf -.BI "int ioctl(int " fildes ", int " request ", ... /* " arg " */);" +.BI "int ioctl(int " fildes ", int " op ", ... /* " arg " */);" .fi .in .P @@ -159,7 +159,9 @@ flag. .\" .SS ioctl structure .\" added two sections - aeb -Ioctl command values are 32-bit constants. +Ioctl +.I op +values are 32-bit constants. In principle these constants are completely arbitrary, but people have tried to build some structure into them. .P diff --git a/upstream/archlinux/man2/ioctl_console.2 b/upstream/archlinux/man2/ioctl_console.2 index 06d01a6e..21990937 100644 --- a/upstream/archlinux/man2/ioctl_console.2 +++ b/upstream/archlinux/man2/ioctl_console.2 @@ -19,14 +19,14 @@ .\" VT_UNLOCKSWITCH (since Linux 1.3.47, needs CAP_SYS_TTY_CONFIG) .\" VT_GETHIFONTMASK (since Linux 2.6.18) .\" -.TH ioctl_console 2 2023-12-21 "Linux man-pages 6.06" +.TH ioctl_console 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_console \- ioctls for console terminal and virtual consoles .SH DESCRIPTION The following Linux-specific .BR ioctl (2) -requests are supported for console terminals and virtual consoles. -Each requires a third argument, assumed here to be +operations are supported for console terminals and virtual consoles. +Each operation requires a third argument, assumed here to be .IR argp . .TP .B KDGETLED @@ -546,7 +546,7 @@ points to a struct vt_mode { char mode; /* vt mode */ char waitv; /* if set, hang on writes if not active */ - short relsig; /* signal to raise on release req */ + short relsig; /* signal to raise on release op */ short acqsig; /* signal to raise on acquisition */ short frsig; /* unused (set to 0) */ }; @@ -861,7 +861,7 @@ is invalid. .TP .B ENOTTY The file descriptor is not associated with a character special device, -or the specified request does not apply to it. +or the specified operation does not apply to it. .TP .B EPERM Insufficient permission. diff --git a/upstream/archlinux/man2/ioctl_fat.2 b/upstream/archlinux/man2/ioctl_fat.2 index b028898f..6d81d1fd 100644 --- a/upstream/archlinux/man2/ioctl_fat.2 +++ b/upstream/archlinux/man2/ioctl_fat.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2014, Heinrich Schuchardt <xypron.glpk@gmx.de> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH ioctl_fat 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_fat 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_fat \- manipulating the FAT filesystem .SH LIBRARY diff --git a/upstream/archlinux/man2/ioctl_ficlonerange.2 b/upstream/archlinux/man2/ioctl_ficlonerange.2 index 01f06856..073f265f 100644 --- a/upstream/archlinux/man2/ioctl_ficlonerange.2 +++ b/upstream/archlinux/man2/ioctl_ficlonerange.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2016, Oracle. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_ficlonerange 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_ficlonerange 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_ficlonerange, ioctl_ficlone \- share some the data of one file with another file diff --git a/upstream/archlinux/man2/ioctl_fideduperange.2 b/upstream/archlinux/man2/ioctl_fideduperange.2 index 4b04efa5..a3e0036d 100644 --- a/upstream/archlinux/man2/ioctl_fideduperange.2 +++ b/upstream/archlinux/man2/ioctl_fideduperange.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2016, Oracle. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_fideduperange 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_fideduperange 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_fideduperange \- share some the data of one file with another file .SH LIBRARY @@ -116,7 +116,7 @@ deduplicated is returned in and a status code for the deduplication operation is returned in .IR status . If even a single byte in the range does not match, the deduplication -request will be ignored and +operation request will be ignored and .I status set to .BR FILE_DEDUPE_RANGE_DIFFERS . diff --git a/upstream/archlinux/man2/ioctl_fslabel.2 b/upstream/archlinux/man2/ioctl_fslabel.2 index 6abc8348..b3aece0b 100644 --- a/upstream/archlinux/man2/ioctl_fslabel.2 +++ b/upstream/archlinux/man2/ioctl_fslabel.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2018, Red Hat, Inc. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_fslabel 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_fslabel 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_fslabel \- get or set a filesystem label .SH LIBRARY diff --git a/upstream/archlinux/man2/ioctl_getfsmap.2 b/upstream/archlinux/man2/ioctl_getfsmap.2 index 99dccdfc..28db00ca 100644 --- a/upstream/archlinux/man2/ioctl_getfsmap.2 +++ b/upstream/archlinux/man2/ioctl_getfsmap.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2017, Oracle. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_getfsmap 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_getfsmap 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_getfsmap \- retrieve the physical layout of the filesystem .SH LIBRARY @@ -124,7 +124,7 @@ By convention, the field .I fsmap_head.fmh_keys[0] must contain the low key and .I fsmap_head.fmh_keys[1] -must contain the high key for the request. +must contain the high key for the operation. .P For convenience, if .I fmr_length @@ -328,10 +328,10 @@ physical storage address space than the high key, or a nonzero value was passed in one of the fields that must be zero. .TP .B ENOMEM -Insufficient memory to process the request. +Insufficient memory to process the operation. .TP .B EOPNOTSUPP -The filesystem does not support this command. +The filesystem does not support this operation. .TP .B EUCLEAN The filesystem metadata is corrupt and needs repair. diff --git a/upstream/archlinux/man2/ioctl_iflags.2 b/upstream/archlinux/man2/ioctl_iflags.2 index c066c9e6..c4ab2b20 100644 --- a/upstream/archlinux/man2/ioctl_iflags.2 +++ b/upstream/archlinux/man2/ioctl_iflags.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ioctl_iflags 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_iflags 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_iflags \- ioctl() operations for inode flags .SH DESCRIPTION diff --git a/upstream/archlinux/man2/ioctl_ns.2 b/upstream/archlinux/man2/ioctl_ns.2 index 0f8563e1..5fe5b762 100644 --- a/upstream/archlinux/man2/ioctl_ns.2 +++ b/upstream/archlinux/man2/ioctl_ns.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ioctl_ns 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_ns 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_ns \- ioctl() operations for Linux namespaces .SH DESCRIPTION @@ -20,7 +20,7 @@ The form of the calls is: .P .in +4n .EX -new_fd = ioctl(fd, request); +new_fd = ioctl(fd, op); .EE .in .P diff --git a/upstream/archlinux/man2/ioctl_pagemap_scan.2 b/upstream/archlinux/man2/ioctl_pagemap_scan.2 index 64763da4..baf86ff7 100644 --- a/upstream/archlinux/man2/ioctl_pagemap_scan.2 +++ b/upstream/archlinux/man2/ioctl_pagemap_scan.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH ioctl_pagemap_scan 2 2024-01-28 "Linux man-pages 6.06" +.TH ioctl_pagemap_scan 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_pagemap_scan \- get and/or clear page flags .SH LIBRARY diff --git a/upstream/archlinux/man2/ioctl_pipe.2 b/upstream/archlinux/man2/ioctl_pipe.2 index fe99cd8d..b11d700f 100644 --- a/upstream/archlinux/man2/ioctl_pipe.2 +++ b/upstream/archlinux/man2/ioctl_pipe.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH ioctl_pipe 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_pipe 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_pipe \- ioctl() operations for General notification mechanism .SH SYNOPSIS diff --git a/upstream/archlinux/man2/ioctl_tty.2 b/upstream/archlinux/man2/ioctl_tty.2 index 8ade11e8..7571ab8c 100644 --- a/upstream/archlinux/man2/ioctl_tty.2 +++ b/upstream/archlinux/man2/ioctl_tty.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ioctl_tty 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_tty 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_tty \- ioctls for terminals and serial lines .SH LIBRARY @@ -18,12 +18,12 @@ Standard C library .BR " Bnnn" ", " BOTHER ", " CBAUD ", " CLOCAL , .BR " TC*" { FLUSH , ON , OFF "} and other constants */" .P -.BI "int ioctl(int " fd ", int " cmd ", ...);" +.BI "int ioctl(int " fd ", int " op ", ...);" .fi .SH DESCRIPTION The .BR ioctl (2) -call for terminals and serial ports accepts many possible command arguments. +call for terminals and serial ports accepts many possible operation arguments. Most require a third argument, of varying type, here called .I argp or @@ -735,7 +735,7 @@ Get the .I tty_struct corresponding to .IR fd . -This command was removed in Linux 2.5.67. +This operation was removed in Linux 2.5.67. .\" commit b3506a09d15dc5aee6d4bb88d759b157016e1864 .\" Author: Andries E. Brouwer <andries.brouwer@cwi.nl> .\" Date: Tue Apr 1 04:42:46 2003 -0800 @@ -764,10 +764,10 @@ to indicate the error. .SH ERRORS .TP .B EINVAL -Invalid command parameter. +Invalid operation parameter. .TP .B ENOIOCTLCMD -Unknown command. +Unknown operation. .TP .B ENOTTY Inappropriate diff --git a/upstream/archlinux/man2/ioctl_userfaultfd.2 b/upstream/archlinux/man2/ioctl_userfaultfd.2 index 390fb8bb..6dcd84c1 100644 --- a/upstream/archlinux/man2/ioctl_userfaultfd.2 +++ b/upstream/archlinux/man2/ioctl_userfaultfd.2 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ioctl_userfaultfd 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_userfaultfd 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioctl_userfaultfd \- create a file descriptor for handling page faults in user space @@ -17,7 +17,7 @@ Standard C library .BR "#include <linux/userfaultfd.h>" " /* Definition of " UFFD* " constants */" .B #include <sys/ioctl.h> .P -.BI "int ioctl(int " fd ", int " cmd ", ...);" +.BI "int ioctl(int " fd ", int " op ", ...);" .fi .SH DESCRIPTION Various @@ -28,18 +28,18 @@ using calls of the form: .P .in +4n .EX -ioctl(fd, cmd, argp); +ioctl(fd, op, argp); .EE .in .P In the above, .I fd is a file descriptor referring to a userfaultfd object, -.I cmd -is one of the commands listed below, and +.I op +is one of the operations listed below, and .I argp is a pointer to a data structure that is specific to -.IR cmd . +.IR op . .P The various .BR ioctl (2) diff --git a/upstream/archlinux/man2/ioperm.2 b/upstream/archlinux/man2/ioperm.2 index 565c16a8..4e9daa81 100644 --- a/upstream/archlinux/man2/ioperm.2 +++ b/upstream/archlinux/man2/ioperm.2 @@ -12,7 +12,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH ioperm 2 2023-10-31 "Linux man-pages 6.06" +.TH ioperm 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioperm \- set port input/output permissions .SH LIBRARY diff --git a/upstream/archlinux/man2/iopl.2 b/upstream/archlinux/man2/iopl.2 index 7f754df3..7a9a0d7f 100644 --- a/upstream/archlinux/man2/iopl.2 +++ b/upstream/archlinux/man2/iopl.2 @@ -10,7 +10,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH iopl 2 2023-10-31 "Linux man-pages 6.06" +.TH iopl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME iopl \- change I/O privilege level .SH LIBRARY diff --git a/upstream/archlinux/man2/ioprio_set.2 b/upstream/archlinux/man2/ioprio_set.2 index 16b0ff03..de9911c5 100644 --- a/upstream/archlinux/man2/ioprio_set.2 +++ b/upstream/archlinux/man2/ioprio_set.2 @@ -7,7 +7,7 @@ .\" with various additions by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" -.TH ioprio_set 2 2023-10-31 "Linux man-pages 6.06" +.TH ioprio_set 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ioprio_get, ioprio_set \- get/set I/O scheduling class and priority .SH LIBRARY diff --git a/upstream/archlinux/man2/ipc.2 b/upstream/archlinux/man2/ipc.2 index c6734938..0b1b9453 100644 --- a/upstream/archlinux/man2/ipc.2 +++ b/upstream/archlinux/man2/ipc.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH ipc 2 2023-10-31 "Linux man-pages 6.06" +.TH ipc 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ipc \- System V IPC system calls .SH LIBRARY diff --git a/upstream/archlinux/man2/kcmp.2 b/upstream/archlinux/man2/kcmp.2 index 991448eb..cef32acd 100644 --- a/upstream/archlinux/man2/kcmp.2 +++ b/upstream/archlinux/man2/kcmp.2 @@ -5,7 +5,7 @@ .\" .\" Kernel commit d97b46a64674a267bc41c9e16132ee2a98c3347d .\" -.TH kcmp 2 2023-10-31 "Linux man-pages 6.06" +.TH kcmp 2 2024-05-02 "Linux man-pages 6.8" .SH NAME kcmp \- compare two processes to determine if they share a kernel resource .SH LIBRARY @@ -347,6 +347,7 @@ Child duplicated FD 3 to create FD 5 #include <stdio.h> #include <stdlib.h> #include <sys/syscall.h> +#include <sys/types.h> #include <sys/wait.h> #include <unistd.h> \& diff --git a/upstream/archlinux/man2/kexec_load.2 b/upstream/archlinux/man2/kexec_load.2 index 93f98f0c..bc657d72 100644 --- a/upstream/archlinux/man2/kexec_load.2 +++ b/upstream/archlinux/man2/kexec_load.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH kexec_load 2 2023-10-31 "Linux man-pages 6.06" +.TH kexec_load 2 2024-05-02 "Linux man-pages 6.8" .SH NAME kexec_load, kexec_file_load \- load a new kernel for later execution .SH LIBRARY diff --git a/upstream/archlinux/man2/keyctl.2 b/upstream/archlinux/man2/keyctl.2 index db020bff..d91b0886 100644 --- a/upstream/archlinux/man2/keyctl.2 +++ b/upstream/archlinux/man2/keyctl.2 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH keyctl 2 2023-11-01 "Linux man-pages 6.06" +.TH keyctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME keyctl \- manipulate the kernel's key management facility .SH LIBRARY @@ -1415,7 +1415,7 @@ The .I arg2 argument is a pointer to a set of parameters containing serial numbers for three -.I """user""" +.I \[dq]user\[dq] keys used in the Diffie-Hellman calculation, packaged in a structure of the following form: .IP @@ -1897,7 +1897,7 @@ was .B KEYCTL_READ and the key type does not support reading (e.g., the type is -.IR """login""" ). +.IR \[dq]login\[dq] ). .TP .B EOPNOTSUPP .I operation diff --git a/upstream/archlinux/man2/kill.2 b/upstream/archlinux/man2/kill.2 index 6d14ff31..1b85a1dc 100644 --- a/upstream/archlinux/man2/kill.2 +++ b/upstream/archlinux/man2/kill.2 @@ -21,7 +21,7 @@ .\" Modified 2004-06-24 by aeb .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr .\" -.TH kill 2 2023-10-31 "Linux man-pages 6.06" +.TH kill 2 2024-05-02 "Linux man-pages 6.8" .SH NAME kill \- send signal to a process .SH LIBRARY diff --git a/upstream/archlinux/man2/landlock_add_rule.2 b/upstream/archlinux/man2/landlock_add_rule.2 index 86e06a4c..84ad253a 100644 --- a/upstream/archlinux/man2/landlock_add_rule.2 +++ b/upstream/archlinux/man2/landlock_add_rule.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH landlock_add_rule 2 2023-10-31 "Linux man-pages 6.06" +.TH landlock_add_rule 2 2024-05-02 "Linux man-pages 6.8" .SH NAME landlock_add_rule \- add a new Landlock rule to a ruleset .SH LIBRARY diff --git a/upstream/archlinux/man2/landlock_create_ruleset.2 b/upstream/archlinux/man2/landlock_create_ruleset.2 index 367645c9..071ed461 100644 --- a/upstream/archlinux/man2/landlock_create_ruleset.2 +++ b/upstream/archlinux/man2/landlock_create_ruleset.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH landlock_create_ruleset 2 2023-10-31 "Linux man-pages 6.06" +.TH landlock_create_ruleset 2 2024-05-02 "Linux man-pages 6.8" .SH NAME landlock_create_ruleset \- create a new Landlock ruleset .SH LIBRARY diff --git a/upstream/archlinux/man2/landlock_restrict_self.2 b/upstream/archlinux/man2/landlock_restrict_self.2 index dc73c6de..c8e606a8 100644 --- a/upstream/archlinux/man2/landlock_restrict_self.2 +++ b/upstream/archlinux/man2/landlock_restrict_self.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH landlock_restrict_self 2 2023-10-31 "Linux man-pages 6.06" +.TH landlock_restrict_self 2 2024-05-02 "Linux man-pages 6.8" .SH NAME landlock_restrict_self \- enforce a Landlock ruleset .SH LIBRARY diff --git a/upstream/archlinux/man2/link.2 b/upstream/archlinux/man2/link.2 index b6373b92..ec519e9f 100644 --- a/upstream/archlinux/man2/link.2 +++ b/upstream/archlinux/man2/link.2 @@ -9,7 +9,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2005-04-04, as per suggestion by Michael Hardt for rename.2 .\" -.TH link 2 2023-10-31 "Linux man-pages 6.06" +.TH link 2 2024-05-02 "Linux man-pages 6.8" .SH NAME link, linkat \- make a new name for a file .SH LIBRARY diff --git a/upstream/archlinux/man2/listen.2 b/upstream/archlinux/man2/listen.2 index 035d315f..f9726b2b 100644 --- a/upstream/archlinux/man2/listen.2 +++ b/upstream/archlinux/man2/listen.2 @@ -14,7 +14,7 @@ .\" Modified 11 May 2001 by Sam Varshavchik <mrsam@courier-mta.com> .\" .\" -.TH listen 2 2023-10-31 "Linux man-pages 6.06" +.TH listen 2 2024-05-02 "Linux man-pages 6.8" .SH NAME listen \- listen for connections on a socket .SH LIBRARY diff --git a/upstream/archlinux/man2/listxattr.2 b/upstream/archlinux/man2/listxattr.2 index 16aea8b4..856c3710 100644 --- a/upstream/archlinux/man2/listxattr.2 +++ b/upstream/archlinux/man2/listxattr.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH listxattr 2 2023-10-31 "Linux man-pages 6.06" +.TH listxattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME listxattr, llistxattr, flistxattr \- list extended attribute names .SH LIBRARY diff --git a/upstream/archlinux/man2/llseek.2 b/upstream/archlinux/man2/llseek.2 index 1a97e131..f1a26397 100644 --- a/upstream/archlinux/man2/llseek.2 +++ b/upstream/archlinux/man2/llseek.2 @@ -6,7 +6,7 @@ .\" .\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH _llseek 2 2023-10-31 "Linux man-pages 6.06" +.TH _llseek 2 2024-05-02 "Linux man-pages 6.8" .SH NAME _llseek \- reposition read/write file offset .SH LIBRARY diff --git a/upstream/archlinux/man2/lookup_dcookie.2 b/upstream/archlinux/man2/lookup_dcookie.2 index 6bd79f2b..255b71dd 100644 --- a/upstream/archlinux/man2/lookup_dcookie.2 +++ b/upstream/archlinux/man2/lookup_dcookie.2 @@ -4,7 +4,7 @@ .\" .\" Modified 2004-06-17 Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH lookup_dcookie 2 2023-10-31 "Linux man-pages 6.06" +.TH lookup_dcookie 2 2024-05-02 "Linux man-pages 6.8" .SH NAME lookup_dcookie \- return a directory entry's path .SH LIBRARY diff --git a/upstream/archlinux/man2/lseek.2 b/upstream/archlinux/man2/lseek.2 index 316f4447..a6bbc0f1 100644 --- a/upstream/archlinux/man2/lseek.2 +++ b/upstream/archlinux/man2/lseek.2 @@ -15,7 +15,7 @@ .\" Modified 2003-08-21 by Andries Brouwer <aeb@cwi.nl> .\" 2011-09-18, mtk, Added SEEK_DATA + SEEK_HOLE .\" -.TH lseek 2 2023-10-31 "Linux man-pages 6.06" +.TH lseek 2 2024-05-02 "Linux man-pages 6.8" .SH NAME lseek \- reposition read/write file offset .SH LIBRARY diff --git a/upstream/archlinux/man2/madvise.2 b/upstream/archlinux/man2/madvise.2 index 29459851..d6fa162d 100644 --- a/upstream/archlinux/man2/madvise.2 +++ b/upstream/archlinux/man2/madvise.2 @@ -12,7 +12,7 @@ .\" 2011-09-18, Doug Goldstein <cardoe@cardoe.com> .\" Document MADV_HUGEPAGE and MADV_NOHUGEPAGE .\" -.TH madvise 2 2023-10-31 "Linux man-pages 6.06" +.TH madvise 2 2024-05-02 "Linux man-pages 6.8" .SH NAME madvise \- give advice about use of memory .SH LIBRARY diff --git a/upstream/archlinux/man2/mbind.2 b/upstream/archlinux/man2/mbind.2 index 4c84c8e3..45bf077b 100644 --- a/upstream/archlinux/man2/mbind.2 +++ b/upstream/archlinux/man2/mbind.2 @@ -15,7 +15,7 @@ .\" Author: Lee Schermerhorn <lee.schermerhorn@hp.com> .\" Date: Thu Oct 25 14:16:32 2012 +0200 .\" -.TH mbind 2 2023-12-09 "Linux man-pages 6.06" +.TH mbind 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mbind \- set memory policy for a memory range .SH LIBRARY @@ -105,6 +105,7 @@ argument must specify one of .BR MPOL_DEFAULT , .BR MPOL_BIND , .BR MPOL_INTERLEAVE , +.BR MPOL_WEIGHTED_INTERLEAVE , .BR MPOL_PREFERRED , or .B MPOL_LOCAL @@ -243,6 +244,23 @@ at least 1\ MB or bigger with a fairly uniform access pattern. Accesses to a single page of the area will still be limited to the memory bandwidth of a single node. .TP +.BR MPOL_WEIGHTED_INTERLEAVE " (since Linux 6.9)" +.\" commit fa3bea4e1f8202d787709b7e3654eb0a99aed758 +This mode interleaves page allocations across the nodes specified in +.I nodemask +according to the weights in +.IR /sys/kernel/mm/mempolicy/weighted_interleave . +For example, if bits 0, 2, and 5 are set in +.IR nodemask , +and the contents of +.IR /sys/kernel/mm/mempolicy/weighted_interleave/node0 , +.IR /sys/ .\|.\|. /node2 , +and +.IR /sys/ .\|.\|. /node5 +are 4, 7, and 9, respectively, +then pages in this region will be allocated on nodes 0, 2, and 5 +in a 4:7:9 ratio. +.TP .B MPOL_PREFERRED This mode sets the preferred node for allocation. The kernel will try to allocate pages from this diff --git a/upstream/archlinux/man2/membarrier.2 b/upstream/archlinux/man2/membarrier.2 index 33fd354a..94337ed3 100644 --- a/upstream/archlinux/man2/membarrier.2 +++ b/upstream/archlinux/man2/membarrier.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH membarrier 2 2023-10-31 "Linux man-pages 6.06" +.TH membarrier 2 2024-05-02 "Linux man-pages 6.8" .SH NAME membarrier \- issue memory barriers on a set of threads .SH LIBRARY diff --git a/upstream/archlinux/man2/memfd_create.2 b/upstream/archlinux/man2/memfd_create.2 index 8082b13f..45f97a4b 100644 --- a/upstream/archlinux/man2/memfd_create.2 +++ b/upstream/archlinux/man2/memfd_create.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH memfd_create 2 2023-10-31 "Linux man-pages 6.06" +.TH memfd_create 2 2024-05-02 "Linux man-pages 6.8" .SH NAME memfd_create \- create an anonymous file .SH LIBRARY @@ -417,6 +417,7 @@ Existing seals: WRITE SHRINK #include <stdlib.h> #include <string.h> #include <sys/mman.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/memfd_secret.2 b/upstream/archlinux/man2/memfd_secret.2 index f0f111cd..2e0b151a 100644 --- a/upstream/archlinux/man2/memfd_secret.2 +++ b/upstream/archlinux/man2/memfd_secret.2 @@ -7,7 +7,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH memfd_secret 2 2023-10-31 "Linux man-pages 6.06" +.TH memfd_secret 2 2024-05-02 "Linux man-pages 6.8" .SH NAME memfd_secret \- create an anonymous RAM-based file to access secret memory regions diff --git a/upstream/archlinux/man2/migrate_pages.2 b/upstream/archlinux/man2/migrate_pages.2 index 44aa04be..da74af1c 100644 --- a/upstream/archlinux/man2/migrate_pages.2 +++ b/upstream/archlinux/man2/migrate_pages.2 @@ -6,7 +6,7 @@ .\" This manpage is Copyright (C) 2006 Silicon Graphics, Inc. .\" Christoph Lameter .\" -.TH migrate_pages 2 2023-10-31 "Linux man-pages 6.06" +.TH migrate_pages 2 2024-05-02 "Linux man-pages 6.8" .SH NAME migrate_pages \- move all pages in a process to another set of nodes .SH LIBRARY diff --git a/upstream/archlinux/man2/mincore.2 b/upstream/archlinux/man2/mincore.2 index 169fda21..487a754d 100644 --- a/upstream/archlinux/man2/mincore.2 +++ b/upstream/archlinux/man2/mincore.2 @@ -11,7 +11,7 @@ .\" after message from <gordon.jin@intel.com> .\" 2007-01-08 mtk, rewrote various parts .\" -.TH mincore 2 2023-10-31 "Linux man-pages 6.06" +.TH mincore 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mincore \- determine whether pages are resident in memory .SH LIBRARY diff --git a/upstream/archlinux/man2/mkdir.2 b/upstream/archlinux/man2/mkdir.2 index 36b2a856..1b3e3c24 100644 --- a/upstream/archlinux/man2/mkdir.2 +++ b/upstream/archlinux/man2/mkdir.2 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH mkdir 2 2023-10-31 "Linux man-pages 6.06" +.TH mkdir 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mkdir, mkdirat \- create a directory .SH LIBRARY diff --git a/upstream/archlinux/man2/mknod.2 b/upstream/archlinux/man2/mknod.2 index 3a78be46..89c50f77 100644 --- a/upstream/archlinux/man2/mknod.2 +++ b/upstream/archlinux/man2/mknod.2 @@ -9,7 +9,7 @@ .\" Modified 2003-04-23 by Michael Kerrisk .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH mknod 2 2023-10-31 "Linux man-pages 6.06" +.TH mknod 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mknod, mknodat \- create a special or ordinary file .SH LIBRARY diff --git a/upstream/archlinux/man2/mlock.2 b/upstream/archlinux/man2/mlock.2 index c9535e56..077b574a 100644 --- a/upstream/archlinux/man2/mlock.2 +++ b/upstream/archlinux/man2/mlock.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH mlock 2 2023-10-31 "Linux man-pages 6.06" +.TH mlock 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mlock, mlock2, munlock, mlockall, munlockall \- lock and unlock memory .SH LIBRARY diff --git a/upstream/archlinux/man2/mmap.2 b/upstream/archlinux/man2/mmap.2 index 1e6d881b..5c88feb3 100644 --- a/upstream/archlinux/man2/mmap.2 +++ b/upstream/archlinux/man2/mmap.2 @@ -18,7 +18,7 @@ .\" 2007-07-10, mtk, Added an example program. .\" 2008-11-18, mtk, document MAP_STACK .\" -.TH mmap 2 2023-10-31 "Linux man-pages 6.06" +.TH mmap 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mmap, munmap \- map or unmap files or devices into memory .SH LIBRARY @@ -940,6 +940,7 @@ to output the desired bytes. #include <stdlib.h> #include <sys/mman.h> #include <sys/stat.h> +#include <sys/types.h> #include <unistd.h> \& #define handle_error(msg) \e diff --git a/upstream/archlinux/man2/mmap2.2 b/upstream/archlinux/man2/mmap2.2 index 35e33af4..4258c31b 100644 --- a/upstream/archlinux/man2/mmap2.2 +++ b/upstream/archlinux/man2/mmap2.2 @@ -6,7 +6,7 @@ .\" Added description of mmap2 .\" Modified, 2004-11-25, mtk -- removed stray #endif in prototype .\" -.TH mmap2 2 2023-10-31 "Linux man-pages 6.06" +.TH mmap2 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mmap2 \- map files or devices into memory .SH LIBRARY diff --git a/upstream/archlinux/man2/modify_ldt.2 b/upstream/archlinux/man2/modify_ldt.2 index c9be272f..7d98c97d 100644 --- a/upstream/archlinux/man2/modify_ldt.2 +++ b/upstream/archlinux/man2/modify_ldt.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH modify_ldt 2 2023-10-31 "Linux man-pages 6.06" +.TH modify_ldt 2 2024-05-02 "Linux man-pages 6.8" .SH NAME modify_ldt \- get or set a per-process LDT entry .SH LIBRARY diff --git a/upstream/archlinux/man2/mount.2 b/upstream/archlinux/man2/mount.2 index 381e8d7b..e5f63565 100644 --- a/upstream/archlinux/man2/mount.2 +++ b/upstream/archlinux/man2/mount.2 @@ -17,7 +17,7 @@ .\" 2008-10-06, mtk: move umount*() material into separate umount.2 page. .\" 2008-10-06, mtk: Add discussion of namespaces. .\" -.TH mount 2 2023-10-31 "Linux man-pages 6.06" +.TH mount 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mount \- mount filesystem .SH LIBRARY diff --git a/upstream/archlinux/man2/mount_setattr.2 b/upstream/archlinux/man2/mount_setattr.2 index 42aed03d..e3336976 100644 --- a/upstream/archlinux/man2/mount_setattr.2 +++ b/upstream/archlinux/man2/mount_setattr.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mount_setattr 2 2023-10-31 "Linux man-pages 6.06" +.TH mount_setattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mount_setattr \- change properties of a mount or mount tree .SH LIBRARY @@ -667,6 +667,18 @@ Currently, the following filesystems support ID-mapped mounts: .IP \[bu] .B overlayfs (ID-mapped lower and upper layers supported since Linux 5.19) +.IP \[bu] +.B squashfs +(since Linux 6.2) +.IP \[bu] +.B tmpfs +(since Linux 6.3) +.IP \[bu] +.B cephfs +(since Linux 6.7) +.IP \[bu] +.B hugetlbfs +(since Linux 6.9) .PD .RE .IP \[bu] diff --git a/upstream/archlinux/man2/move_pages.2 b/upstream/archlinux/man2/move_pages.2 index b7374bad..303beed4 100644 --- a/upstream/archlinux/man2/move_pages.2 +++ b/upstream/archlinux/man2/move_pages.2 @@ -8,7 +8,7 @@ .\" (e.g., compare with recommendation in mbind(2)). .\" Does this page need to give advice on this topic? .\" -.TH move_pages 2 2023-10-31 "Linux man-pages 6.06" +.TH move_pages 2 2024-05-02 "Linux man-pages 6.8" .SH NAME move_pages \- move individual pages of a process to another node .SH LIBRARY diff --git a/upstream/archlinux/man2/mprotect.2 b/upstream/archlinux/man2/mprotect.2 index bdad746d..a4b1ce35 100644 --- a/upstream/archlinux/man2/mprotect.2 +++ b/upstream/archlinux/man2/mprotect.2 @@ -10,7 +10,7 @@ .\" 2007-06-02, mtk: Fairly substantial rewrites and additions, and .\" a much improved example program. .\" -.TH mprotect 2 2023-10-31 "Linux man-pages 6.06" +.TH mprotect 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mprotect, pkey_mprotect \- set protection on a region of memory .SH LIBRARY diff --git a/upstream/archlinux/man2/mq_getsetattr.2 b/upstream/archlinux/man2/mq_getsetattr.2 index c5fa12eb..97a2b7d8 100644 --- a/upstream/archlinux/man2/mq_getsetattr.2 +++ b/upstream/archlinux/man2/mq_getsetattr.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_getsetattr 2 2023-10-31 "Linux man-pages 6.06" +.TH mq_getsetattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mq_getsetattr \- get/set message queue attributes .SH SYNOPSIS diff --git a/upstream/archlinux/man2/mremap.2 b/upstream/archlinux/man2/mremap.2 index cade8399..120a0513 100644 --- a/upstream/archlinux/man2/mremap.2 +++ b/upstream/archlinux/man2/mremap.2 @@ -8,7 +8,7 @@ .\" Update for Linux 1.3.87 and later .\" 2005-10-11 mtk: Added NOTES for MREMAP_FIXED; revised EINVAL text. .\" -.TH mremap 2 2024-01-16 "Linux man-pages 6.06" +.TH mremap 2 2024-05-02 "Linux man-pages 6.8" .SH NAME mremap \- remap a virtual memory address .SH LIBRARY diff --git a/upstream/archlinux/man2/msgctl.2 b/upstream/archlinux/man2/msgctl.2 index beefa480..47fcb4e7 100644 --- a/upstream/archlinux/man2/msgctl.2 +++ b/upstream/archlinux/man2/msgctl.2 @@ -16,7 +16,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, MSG_INFO, MSG_STAT descriptions .\" 2018-03-20, dbueso: Added MSG_STAT_ANY description. .\" -.TH msgctl 2 2023-10-31 "Linux man-pages 6.06" +.TH msgctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME msgctl \- System V message control operations .SH LIBRARY @@ -26,12 +26,12 @@ Standard C library .nf .B #include <sys/msg.h> .P -.BI "int msgctl(int " msqid ", int " cmd ", struct msqid_ds *" buf ); +.BI "int msgctl(int " msqid ", int " op ", struct msqid_ds *" buf ); .fi .SH DESCRIPTION .BR msgctl () performs the control operation specified by -.I cmd +.I op on the System\ V message queue with identifier .IR msqid . .P @@ -142,7 +142,7 @@ l l. Bits 0100, 0010, and 0001 (the execute bits) are unused by the system. .P Valid values for -.I cmd +.I op are: .TP .B IPC_STAT @@ -320,7 +320,7 @@ is set to indicate the error. .TP .B EACCES The argument -.I cmd +.I op is equal to .B IPC_STAT or @@ -333,7 +333,7 @@ capability in the user namespace that governs its IPC namespace. .TP .B EFAULT The argument -.I cmd +.I op has the value .B IPC_SET or @@ -347,7 +347,7 @@ The message queue was removed. .TP .B EINVAL Invalid value for -.I cmd +.I op or .IR msqid . Or: for a @@ -358,7 +358,7 @@ referred to an array slot that is currently unused. .TP .B EPERM The argument -.I cmd +.I op has the value .B IPC_SET or @@ -402,7 +402,7 @@ a recompilation under glibc-2.1.91 or later should suffice. (The kernel distinguishes old and new calls by an .B IPC_64 flag in -.IR cmd .) +.IR op .) .SH NOTES The .BR IPC_INFO , diff --git a/upstream/archlinux/man2/msgget.2 b/upstream/archlinux/man2/msgget.2 index 0ff07144..042a9bfd 100644 --- a/upstream/archlinux/man2/msgget.2 +++ b/upstream/archlinux/man2/msgget.2 @@ -12,7 +12,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH msgget 2 2023-10-31 "Linux man-pages 6.06" +.TH msgget 2 2024-05-02 "Linux man-pages 6.8" .SH NAME msgget \- get a System V message queue identifier .SH LIBRARY diff --git a/upstream/archlinux/man2/msgop.2 b/upstream/archlinux/man2/msgop.2 index b80e7125..59141898 100644 --- a/upstream/archlinux/man2/msgop.2 +++ b/upstream/archlinux/man2/msgop.2 @@ -17,7 +17,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH MSGOP 2 2023-10-31 "Linux man-pages 6.06" +.TH MSGOP 2 2024-05-02 "Linux man-pages 6.8" .SH NAME msgrcv, msgsnd \- System V message queue operations .SH LIBRARY diff --git a/upstream/archlinux/man2/msync.2 b/upstream/archlinux/man2/msync.2 index 5f52982d..5955034d 100644 --- a/upstream/archlinux/man2/msync.2 +++ b/upstream/archlinux/man2/msync.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH msync 2 2023-10-31 "Linux man-pages 6.06" +.TH msync 2 2024-05-02 "Linux man-pages 6.8" .SH NAME msync \- synchronize a file with a memory map .SH LIBRARY diff --git a/upstream/archlinux/man2/nanosleep.2 b/upstream/archlinux/man2/nanosleep.2 index e174d111..1eee1e1e 100644 --- a/upstream/archlinux/man2/nanosleep.2 +++ b/upstream/archlinux/man2/nanosleep.2 @@ -12,7 +12,7 @@ .\" NOTES: describe case where clock_nanosleep() can be preferable. .\" NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP .\" Replace crufty discussion of HZ with a pointer to time(7). -.TH nanosleep 2 2023-10-31 "Linux man-pages 6.06" +.TH nanosleep 2 2024-05-02 "Linux man-pages 6.8" .SH NAME nanosleep \- high-resolution sleep .SH LIBRARY @@ -22,7 +22,7 @@ Standard C library .nf .B #include <time.h> .P -.BI "int nanosleep(const struct timespec *" req , +.BI "int nanosleep(const struct timespec *" duration , .BI " struct timespec *_Nullable " rem ); .fi .P @@ -39,7 +39,7 @@ Feature Test Macro Requirements for glibc (see .BR nanosleep () suspends the execution of the calling thread until either at least the time specified in -.I *req +.I *duration has elapsed, or the delivery of a signal that triggers the invocation of a handler in the calling thread or that terminates the process. @@ -80,7 +80,7 @@ does not interact with signals; and it makes the task of resuming a sleep that has been interrupted by a signal handler easier. .SH RETURN VALUE -On successfully sleeping for the requested interval, +On successfully sleeping for the requested duration, .BR nanosleep () returns 0. If the call is interrupted by a signal handler or encounters an error, @@ -138,8 +138,9 @@ have no effect on threads that are blocked waiting for a relative time service based upon this clock, including the .BR nanosleep () function; ... -Consequently, these time services shall expire when the requested relative -interval elapses, independently of the new or old value of the clock. +Consequently, +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. @@ -158,8 +159,8 @@ or This special extension was removed in Linux 2.5.39, and is thus not available in Linux 2.6.0 and later kernels. .SH NOTES -If the interval specified in -.I req +If the +.I duration is not an exact multiple of the granularity underlying clock (see .BR time (7)), then the interval will be rounded up to the next multiple. diff --git a/upstream/archlinux/man2/nfsservctl.2 b/upstream/archlinux/man2/nfsservctl.2 index d2ffeffe..d8dfb54e 100644 --- a/upstream/archlinux/man2/nfsservctl.2 +++ b/upstream/archlinux/man2/nfsservctl.2 @@ -2,7 +2,7 @@ .\" This text is in the public domain. .\" %%%LICENSE_END .\" -.TH nfsservctl 2 2023-10-31 "Linux man-pages 6.06" +.TH nfsservctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME nfsservctl \- syscall interface to kernel nfs daemon .SH LIBRARY diff --git a/upstream/archlinux/man2/nice.2 b/upstream/archlinux/man2/nice.2 index 0a2b49c2..3a3089b8 100644 --- a/upstream/archlinux/man2/nice.2 +++ b/upstream/archlinux/man2/nice.2 @@ -8,7 +8,7 @@ .\" Modified 2001-06-04 by aeb .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH nice 2 2023-10-31 "Linux man-pages 6.06" +.TH nice 2 2024-05-02 "Linux man-pages 6.8" .SH NAME nice \- change process priority .SH LIBRARY diff --git a/upstream/archlinux/man2/open.2 b/upstream/archlinux/man2/open.2 index f81058e7..822608fd 100644 --- a/upstream/archlinux/man2/open.2 +++ b/upstream/archlinux/man2/open.2 @@ -28,7 +28,7 @@ .\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and .\" O_TTYINIT. Eventually these may need to be documented. --mtk .\" -.TH open 2 2024-01-16 "Linux man-pages 6.06" +.TH open 2 2024-05-02 "Linux man-pages 6.8" .SH NAME open, openat, creat \- open and possibly create a file .SH LIBRARY @@ -1021,7 +1021,7 @@ For details, see the descriptions of and .I /proc/sys/fs/protected_regular in -.BR proc (5). +.BR proc_sys_fs (5). .TP .B EBADF .RB ( openat ()) diff --git a/upstream/archlinux/man2/open_by_handle_at.2 b/upstream/archlinux/man2/open_by_handle_at.2 index 591af265..b5db15c1 100644 --- a/upstream/archlinux/man2/open_by_handle_at.2 +++ b/upstream/archlinux/man2/open_by_handle_at.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH open_by_handle_at 2 2023-10-31 "Linux man-pages 6.06" +.TH open_by_handle_at 2 2024-05-02 "Linux man-pages 6.8" .SH NAME name_to_handle_at, open_by_handle_at \- obtain handle for a pathname and open file via a handle @@ -641,6 +641,7 @@ main(int argc, char *argv[]) #include <stdio.h> #include <stdlib.h> #include <string.h> +#include <sys/types.h> #include <unistd.h> \& /* Scan /proc/self/mountinfo to find the line whose mount ID matches diff --git a/upstream/archlinux/man2/openat2.2 b/upstream/archlinux/man2/openat2.2 index 53db59f7..b0a5ab30 100644 --- a/upstream/archlinux/man2/openat2.2 +++ b/upstream/archlinux/man2/openat2.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2019 Aleksa Sarai <cyphar@cyphar.com> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH openat2 2 2023-10-31 "Linux man-pages 6.06" +.TH openat2 2 2024-05-02 "Linux man-pages 6.8" .SH NAME openat2 \- open and possibly create a file (extended) .SH LIBRARY @@ -374,7 +374,7 @@ in the kernel's lookup cache. If any kind of revalidation or I/O is needed to satisfy the lookup, .BR openat2 () fails with the error -.B EAGAIN . +.BR EAGAIN . This is useful in providing a fast-path open that can be performed without resorting to thread offload, or other mechanisms that an application might use to offload slower operations. @@ -421,7 +421,7 @@ information. The caller should retry without .B RESOLVE_CACHED set in -.I how.resolve . +.IR how.resolve . .TP .B EINVAL An unknown flag or invalid value was specified in diff --git a/upstream/archlinux/man2/outb.2 b/upstream/archlinux/man2/outb.2 index 17da297f..a7f98771 100644 --- a/upstream/archlinux/man2/outb.2 +++ b/upstream/archlinux/man2/outb.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH outb 2 2023-10-31 "Linux man-pages 6.06" +.TH outb 2 2024-05-02 "Linux man-pages 6.8" .SH NAME outb, outw, outl, outsb, outsw, outsl, inb, inw, inl, insb, insw, insl, diff --git a/upstream/archlinux/man2/pause.2 b/upstream/archlinux/man2/pause.2 index 3e2ebf97..9b68e159 100644 --- a/upstream/archlinux/man2/pause.2 +++ b/upstream/archlinux/man2/pause.2 @@ -7,7 +7,7 @@ .\" Modified 1995 by Mike Battersby (mib@deakin.edu.au) .\" Modified 2000 by aeb, following Michael Kerrisk .\" -.TH pause 2 2023-10-31 "Linux man-pages 6.06" +.TH pause 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pause \- wait for signal .SH LIBRARY diff --git a/upstream/archlinux/man2/pciconfig_read.2 b/upstream/archlinux/man2/pciconfig_read.2 index bb1abcec..75823d85 100644 --- a/upstream/archlinux/man2/pciconfig_read.2 +++ b/upstream/archlinux/man2/pciconfig_read.2 @@ -5,7 +5,7 @@ .\" May be freely distributed and modified. .\" %%%LICENSE_END .\" -.TH pciconfig_read 2 2023-10-31 "Linux man-pages 6.06" +.TH pciconfig_read 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pciconfig_read, pciconfig_write, pciconfig_iobase \- pci device information handling diff --git a/upstream/archlinux/man2/perf_event_open.2 b/upstream/archlinux/man2/perf_event_open.2 index 55d4ff07..e4ce6e62 100644 --- a/upstream/archlinux/man2/perf_event_open.2 +++ b/upstream/archlinux/man2/perf_event_open.2 @@ -5,7 +5,7 @@ .\" This document is based on the perf_event.h header file, the .\" tools/perf/design.txt file, and a lot of bitter experience. .\" -.TH perf_event_open 2 2023-11-19 "Linux man-pages 6.06" +.TH perf_event_open 2 2024-05-02 "Linux man-pages 6.8" .SH NAME perf_event_open \- set up performance monitoring .SH LIBRARY @@ -3976,6 +3976,7 @@ instruction count of a call to #include <string.h> #include <sys/ioctl.h> #include <sys/syscall.h> +#include <sys/types.h> #include <unistd.h> \& static long diff --git a/upstream/archlinux/man2/perfmonctl.2 b/upstream/archlinux/man2/perfmonctl.2 index 2926674b..a2232870 100644 --- a/upstream/archlinux/man2/perfmonctl.2 +++ b/upstream/archlinux/man2/perfmonctl.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH perfmonctl 2 2023-10-31 "Linux man-pages 6.06" +.TH perfmonctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME perfmonctl \- interface to IA-64 performance monitoring unit .SH SYNOPSIS diff --git a/upstream/archlinux/man2/personality.2 b/upstream/archlinux/man2/personality.2 index 1f83faf5..3364e0e9 100644 --- a/upstream/archlinux/man2/personality.2 +++ b/upstream/archlinux/man2/personality.2 @@ -10,7 +10,7 @@ .\" changed prototype, documented 0xffffffff, aeb, 030101 .\" Modified 2004-11-03 patch from Martin Schulze <joey@infodrom.org> .\" -.TH personality 2 2023-10-31 "Linux man-pages 6.06" +.TH personality 2 2024-05-02 "Linux man-pages 6.8" .SH NAME personality \- set the process execution domain .SH LIBRARY diff --git a/upstream/archlinux/man2/pidfd_getfd.2 b/upstream/archlinux/man2/pidfd_getfd.2 index f991f8c7..1b393d4c 100644 --- a/upstream/archlinux/man2/pidfd_getfd.2 +++ b/upstream/archlinux/man2/pidfd_getfd.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pidfd_getfd 2 2023-10-31 "Linux man-pages 6.06" +.TH pidfd_getfd 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pidfd_getfd \- obtain a duplicate of another process's file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/pidfd_open.2 b/upstream/archlinux/man2/pidfd_open.2 index 36350291..5b1076be 100644 --- a/upstream/archlinux/man2/pidfd_open.2 +++ b/upstream/archlinux/man2/pidfd_open.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pidfd_open 2 2023-10-31 "Linux man-pages 6.06" +.TH pidfd_open 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pidfd_open \- obtain a file descriptor that refers to a process .SH LIBRARY @@ -214,6 +214,7 @@ event. #include <stdio.h> #include <stdlib.h> #include <sys/syscall.h> +#include <sys/types.h> #include <unistd.h> \& static int diff --git a/upstream/archlinux/man2/pidfd_send_signal.2 b/upstream/archlinux/man2/pidfd_send_signal.2 index b0cea18f..b766fd44 100644 --- a/upstream/archlinux/man2/pidfd_send_signal.2 +++ b/upstream/archlinux/man2/pidfd_send_signal.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pidfd_send_signal 2 2023-11-01 "Linux man-pages 6.06" +.TH pidfd_send_signal 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pidfd_send_signal \- send a signal to a process specified by a file descriptor .SH LIBRARY diff --git a/upstream/archlinux/man2/pipe.2 b/upstream/archlinux/man2/pipe.2 index 556f2582..2b0647cd 100644 --- a/upstream/archlinux/man2/pipe.2 +++ b/upstream/archlinux/man2/pipe.2 @@ -13,7 +13,7 @@ .\" to EXAMPLE text. .\" 2008-10-10, mtk: add description of pipe2() .\" -.TH pipe 2 2023-10-31 "Linux man-pages 6.06" +.TH pipe 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pipe, pipe2 \- create pipe .SH LIBRARY @@ -246,6 +246,7 @@ and echoes it on standard output. #include <stdio.h> #include <stdlib.h> #include <string.h> +#include <sys/types.h> #include <sys/wait.h> #include <unistd.h> \& diff --git a/upstream/archlinux/man2/pivot_root.2 b/upstream/archlinux/man2/pivot_root.2 index 0c901fd6..ade03d7e 100644 --- a/upstream/archlinux/man2/pivot_root.2 +++ b/upstream/archlinux/man2/pivot_root.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pivot_root 2 2023-10-31 "Linux man-pages 6.06" +.TH pivot_root 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pivot_root \- change the root mount .SH LIBRARY @@ -66,7 +66,7 @@ must yield the same directory as \fInew_root\fP. .IP \[bu] .I new_root must be a path to a mount point, but can't be -.IR """/""" . +.IR \[dq]/\[dq] . A path that is not already a mount point can be converted into one by bind mounting the path onto itself. .IP \[bu] @@ -115,7 +115,7 @@ is on the current root mount. (This error covers the pathological case where .I new_root is -.IR """/""" .) +.IR \[dq]/\[dq] .) .TP .B EINVAL .I new_root @@ -227,7 +227,7 @@ working directory refer to the new root mount point During the subsequent .BR umount () call, resolution of -.I """.""" +.I \[dq].\[dq] starts with .I new_root and then moves up the list of mounts stacked at diff --git a/upstream/archlinux/man2/pkey_alloc.2 b/upstream/archlinux/man2/pkey_alloc.2 index a5494ccd..daa6bce2 100644 --- a/upstream/archlinux/man2/pkey_alloc.2 +++ b/upstream/archlinux/man2/pkey_alloc.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pkey_alloc 2 2023-10-31 "Linux man-pages 6.06" +.TH pkey_alloc 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pkey_alloc, pkey_free \- allocate or free a protection key .SH LIBRARY diff --git a/upstream/archlinux/man2/poll.2 b/upstream/archlinux/man2/poll.2 index 0abd6f20..c78ad3a9 100644 --- a/upstream/archlinux/man2/poll.2 +++ b/upstream/archlinux/man2/poll.2 @@ -7,7 +7,7 @@ .\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and .\" formatting changes. .\" -.TH poll 2 2023-10-31 "Linux man-pages 6.06" +.TH poll 2 2024-05-02 "Linux man-pages 6.8" .SH NAME poll, ppoll \- wait for some event on a file descriptor .SH LIBRARY @@ -563,6 +563,7 @@ at which point the file descriptor was closed and the program terminated. #include <poll.h> #include <stdio.h> #include <stdlib.h> +#include <sys/types.h> #include <unistd.h> \& #define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \e diff --git a/upstream/archlinux/man2/posix_fadvise.2 b/upstream/archlinux/man2/posix_fadvise.2 index 0e499ad7..39ba082b 100644 --- a/upstream/archlinux/man2/posix_fadvise.2 +++ b/upstream/archlinux/man2/posix_fadvise.2 @@ -6,7 +6,7 @@ .\" 2005-04-08 mtk, noted kernel version and added BUGS .\" 2010-10-09, mtk, document arm_fadvise64_64() .\" -.TH posix_fadvise 2 2023-10-31 "Linux man-pages 6.06" +.TH posix_fadvise 2 2024-05-02 "Linux man-pages 6.8" .SH NAME posix_fadvise \- predeclare an access pattern for file data .SH LIBRARY diff --git a/upstream/archlinux/man2/prctl.2 b/upstream/archlinux/man2/prctl.2 index 8de8bbba..ce3b3c8b 100644 --- a/upstream/archlinux/man2/prctl.2 +++ b/upstream/archlinux/man2/prctl.2 @@ -36,7 +36,7 @@ .\" 2014-11-10 Dave Hansen, document PR_MPX_{EN,DIS}ABLE_MANAGEMENT .\" .\" -.TH prctl 2 2023-10-31 "Linux man-pages 6.06" +.TH prctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME prctl \- operations on a process or thread .SH LIBRARY @@ -46,7 +46,7 @@ Standard C library .nf .B #include <sys/prctl.h> .P -.BI "int prctl(int " operation ", ..." +.BI "int prctl(int " op ", ..." .BI " \fR/*\fP unsigned long " arg2 ", unsigned long " arg3 , .BI " unsigned long " arg4 ", unsigned long " arg5 " \fR*/\fP );" .fi @@ -379,7 +379,7 @@ can operate only when this bit is Applications that use the O32 FPXX ABI can operate with either .B FR=0 or -.B FR=1 . +.BR FR=1 . .TP .B PR_FP_MODE_FRE Enable emulation of 32-bit floating-point mode. @@ -2096,7 +2096,7 @@ and (if it returns) .B PR_GET_SECCOMP return the nonnegative values described above. All other -.I operation +.I op values return 0 on success. On error, \-1 is returned, and .I errno @@ -2104,7 +2104,7 @@ is set to indicate the error. .SH ERRORS .TP .B EACCES -.I operation +.I op is .B PR_SET_SECCOMP and @@ -2120,7 +2120,7 @@ attribute (see the discussion of above). .TP .B EACCES -.I operation +.I op is .BR PR_SET_MM , and @@ -2130,7 +2130,7 @@ is the file is not executable. .TP .B EBADF -.I operation +.I op is .BR PR_SET_MM , .I arg3 @@ -2141,7 +2141,7 @@ and the file descriptor passed in is not valid. .TP .B EBUSY -.I operation +.I op is .BR PR_SET_MM , .I arg3 @@ -2156,7 +2156,7 @@ symbolic link, which is prohibited. is an invalid address. .TP .B EFAULT -.I operation +.I op is .BR PR_SET_SECCOMP , .I arg2 @@ -2169,7 +2169,7 @@ and is an invalid address. .TP .B EFAULT -.I operation +.I op is .B PR_SET_SYSCALL_USER_DISPATCH and @@ -2178,12 +2178,12 @@ has an invalid address. .TP .B EINVAL The value of -.I operation +.I op is not recognized, or not supported on this system. .TP .B EINVAL -.I operation +.I op is .B PR_MCE_KILL or @@ -2197,10 +2197,10 @@ arguments were not specified as zero. .B EINVAL .I arg2 is not valid value for this -.IR operation . +.IR op . .TP .B EINVAL -.I operation +.I op is .B PR_SET_SECCOMP or @@ -2209,7 +2209,7 @@ and the kernel was not configured with .BR CONFIG_SECCOMP . .TP .B EINVAL -.I operation +.I op is .BR PR_SET_SECCOMP , .I arg2 @@ -2219,7 +2219,7 @@ and the kernel was not configured with .BR CONFIG_SECCOMP_FILTER . .TP .B EINVAL -.I operation +.I op is .BR PR_SET_MM , and one of the following is true @@ -2259,7 +2259,7 @@ resource limit to be exceeded. .RE .TP .B EINVAL -.I operation +.I op is .B PR_SET_PTRACER and @@ -2269,7 +2269,7 @@ is not 0, or the PID of an existing process. .TP .B EINVAL -.I operation +.I op is .B PR_SET_PDEATHSIG and @@ -2277,7 +2277,7 @@ and is not a valid signal number. .TP .B EINVAL -.I operation +.I op is .B PR_SET_DUMPABLE and @@ -2288,7 +2288,7 @@ nor .BR SUID_DUMP_USER . .TP .B EINVAL -.I operation +.I op is .B PR_SET_TIMING and @@ -2297,7 +2297,7 @@ is not .BR PR_TIMING_STATISTICAL . .TP .B EINVAL -.I operation +.I op is .B PR_SET_NO_NEW_PRIVS and @@ -2311,7 +2311,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_GET_NO_NEW_PRIVS and @@ -2323,7 +2323,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_SET_THP_DISABLE and @@ -2334,7 +2334,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_GET_THP_DISABLE and @@ -2346,7 +2346,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_CAP_AMBIENT and an unused argument @@ -2371,7 +2371,7 @@ and does not specify a valid capability. .TP .B EINVAL -.I operation +.I op was .B PR_GET_SPECULATION_CTRL or @@ -2381,7 +2381,7 @@ and unused arguments to are not 0. .TP .B EINVAL -.I operation +.I op is .B PR_PAC_RESET_KEYS and the arguments are invalid or unsupported. @@ -2390,7 +2390,7 @@ See the description of above for details. .TP .B EINVAL -.I operation +.I op is .B PR_SVE_SET_VL and the arguments are invalid or unsupported, @@ -2400,13 +2400,13 @@ See the description of above for details. .TP .B EINVAL -.I operation +.I op is .B PR_SVE_GET_VL and SVE is not available on this platform. .TP .B EINVAL -.I operation +.I op is .B PR_SET_SYSCALL_USER_DISPATCH and one of the following is true: @@ -2428,7 +2428,7 @@ is invalid. .RE .TP .B EINVAL -.I operation +.I op is .B PR_SET_TAGGED_ADDR_CTRL and the arguments are invalid or unsupported. @@ -2437,7 +2437,7 @@ See the description of above for details. .TP .B EINVAL -.I operation +.I op is .B PR_GET_TAGGED_ADDR_CTRL and the arguments are invalid or unsupported. @@ -2446,13 +2446,13 @@ See the description of above for details. .TP .B ENODEV -.I operation +.I op was .B PR_SET_SPECULATION_CTRL the kernel or CPU does not support the requested speculation misfeature. .TP .B ENXIO -.I operation +.I op was .B PR_MPX_ENABLE_MANAGEMENT or @@ -2461,7 +2461,7 @@ and the kernel or the CPU does not support MPX management. Check that the kernel and processor have MPX support. .TP .B ENXIO -.I operation +.I op was .B PR_SET_SPECULATION_CTRL implies that the control of the selected speculation misfeature is not possible. @@ -2470,7 +2470,7 @@ See for the bit fields to determine which option is available. .TP .B EOPNOTSUPP -.I operation +.I op is .B PR_SET_FP_MODE and @@ -2478,7 +2478,7 @@ and has an invalid or unsupported value. .TP .B EPERM -.I operation +.I op is .BR PR_SET_SECUREBITS , and the caller does not have the @@ -2490,7 +2490,7 @@ or tried to set a flag whose corresponding locked flag was set .BR capabilities (7)). .TP .B EPERM -.I operation +.I op is .B PR_SET_SPECULATION_CTRL wherein the speculation was disabled with @@ -2498,7 +2498,7 @@ wherein the speculation was disabled with and caller tried to enable it again. .TP .B EPERM -.I operation +.I op is .BR PR_SET_KEEPCAPS , and the caller's @@ -2508,7 +2508,7 @@ flag is set .BR capabilities (7)). .TP .B EPERM -.I operation +.I op is .BR PR_CAPBSET_DROP , and the caller does not have the @@ -2516,7 +2516,7 @@ and the caller does not have the capability. .TP .B EPERM -.I operation +.I op is .BR PR_SET_MM , and the caller does not have the @@ -2524,7 +2524,7 @@ and the caller does not have the capability. .TP .B EPERM -.I operation +.I op is .B PR_CAP_AMBIENT and @@ -2539,7 +2539,7 @@ or the securebit has been set. .TP .B ERANGE -.I operation +.I op was .B PR_SET_SPECULATION_CTRL and @@ -2559,7 +2559,7 @@ with prototype .P .in +4n .EX -.BI "ptrdiff_t prctl(int " operation ", int " arg2 ", int " arg3 ); +.BI "ptrdiff_t prctl(int " op ", int " arg2 ", int " arg3 ); .EE .in .P diff --git a/upstream/archlinux/man2/pread.2 b/upstream/archlinux/man2/pread.2 index 3bfecf1e..07ffb183 100644 --- a/upstream/archlinux/man2/pread.2 +++ b/upstream/archlinux/man2/pread.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pread 2 2023-10-31 "Linux man-pages 6.06" +.TH pread 2 2024-05-02 "Linux man-pages 6.8" .SH NAME pread, pwrite \- read from or write to a file descriptor at a given offset .SH LIBRARY diff --git a/upstream/archlinux/man2/process_madvise.2 b/upstream/archlinux/man2/process_madvise.2 index e6f78bf6..bff6591f 100644 --- a/upstream/archlinux/man2/process_madvise.2 +++ b/upstream/archlinux/man2/process_madvise.2 @@ -5,7 +5,7 @@ .\" .\" Commit ecb8ac8b1f146915aa6b96449b66dd48984caacc .\" -.TH process_madvise 2 2023-10-31 "Linux man-pages 6.06" +.TH process_madvise 2 2024-05-02 "Linux man-pages 6.8" .SH NAME process_madvise \- give advice about use of memory to a process .SH LIBRARY @@ -13,23 +13,12 @@ Standard C library .RI ( libc ", " \-lc ) .SH SYNOPSIS .nf -.BR "#include <sys/mman.h>" " /* Definition of " MADV_* " constants */" -.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" -.BR "#include <sys/uio.h>" " /* Definition of " "struct iovec" " type */" -.B #include <unistd.h> +.B #include <sys/mman.h> .P -.BI "ssize_t syscall(SYS_process_madvise, int " pidfd , -.BI " const struct iovec *" iovec ", size_t " vlen \ -", int " advice , -.BI " unsigned int " flags ");" +.BI "ssize_t process_madvise(int " pidfd ", const struct iovec " iovec [. n ], +.BI " size_t " n ", int " advice \ +", unsigned int " flags ); .fi -.P -.IR Note : -glibc provides no wrapper for -.BR process_madvise (), -necessitating the use of -.BR syscall (2). -.\" FIXME: See <https://sourceware.org/bugzilla/show_bug.cgi?id=27380> .SH DESCRIPTION The .BR process_madvise () @@ -38,7 +27,7 @@ address ranges of another process or of the calling process. It provides the advice for the address ranges described by .I iovec and -.IR vlen . +.IR n . The goal of such advice is to improve system or application performance. .P The @@ -54,7 +43,7 @@ points to an array of structures, described in .BR iovec (3type). .P -.I vlen +.I n specifies the number of elements in the array of .I iovec structures. @@ -91,12 +80,12 @@ argument is reserved for future use; currently, this argument must be specified as 0. .P The -.I vlen +.I n and .I iovec arguments are checked before applying any advice. If -.I vlen +.I n is too big, or .I iovec is invalid, @@ -163,7 +152,7 @@ overflows a value. .TP .B EINVAL -.I vlen +.I n is too large. .TP .B ENOMEM @@ -187,7 +176,9 @@ errors. Linux. .SH HISTORY Linux 5.10. -.\" commit ecb8ac8b1f146915aa6b96449b66dd48984caacc +.\" Linux commit ecb8ac8b1f146915aa6b96449b66dd48984caacc +glibc 2.36. +.\" glibc commit d19ee3473d68ca0e794f3a8b7677a0983ae1342e .P Support for this system call is optional, depending on the setting of the diff --git a/upstream/archlinux/man2/process_vm_readv.2 b/upstream/archlinux/man2/process_vm_readv.2 index 810eed24..0bfaa118 100644 --- a/upstream/archlinux/man2/process_vm_readv.2 +++ b/upstream/archlinux/man2/process_vm_readv.2 @@ -6,7 +6,7 @@ .\" .\" Commit fcf634098c00dd9cd247447368495f0b79be12d1 .\" -.TH process_vm_readv 2 2023-10-31 "Linux man-pages 6.06" +.TH process_vm_readv 2 2024-05-02 "Linux man-pages 6.8" .SH NAME process_vm_readv, process_vm_writev \- transfer data between process address spaces diff --git a/upstream/archlinux/man2/ptrace.2 b/upstream/archlinux/man2/ptrace.2 index 565f0cc5..4703e352 100644 --- a/upstream/archlinux/man2/ptrace.2 +++ b/upstream/archlinux/man2/ptrace.2 @@ -83,7 +83,7 @@ .\" .\" and others that can be found in the arch/*/include/uapi/asm/ptrace files .\" -.TH ptrace 2 2023-10-31 "Linux man-pages 6.06" +.TH ptrace 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ptrace \- process trace .SH LIBRARY @@ -93,7 +93,7 @@ Standard C library .nf .B #include <sys/ptrace.h> .P -.BI "long ptrace(enum __ptrace_request " request ", pid_t " pid , +.BI "long ptrace(enum __ptrace_request " op ", pid_t " pid , .BI " void *" addr ", void *" data ); .fi .SH DESCRIPTION @@ -155,7 +155,7 @@ The tracer will be notified at its next call to value containing information that indicates the cause of the stop in the tracee. While the tracee is stopped, -the tracer can use various ptrace requests to inspect and modify the tracee. +the tracer can use various ptrace operations to inspect and modify the tracee. The tracer then causes the tracee to continue, optionally ignoring the delivered signal (or even delivering a different signal instead). @@ -175,12 +175,12 @@ executing in a normal, untraced mode via .BR PTRACE_DETACH . .P The value of -.I request -determines the action to be performed: +.I op +determines the operation to be performed: .TP .B PTRACE_TRACEME Indicate that this process is to be traced by its parent. -A process probably shouldn't make this request if its parent +A process probably shouldn't make this operation if its parent isn't expecting to trace it. .RI ( pid , .IR addr , @@ -190,12 +190,12 @@ are ignored.) .IP The .B PTRACE_TRACEME -request is used only by the tracee; -the remaining requests are used only by the tracer. -In the following requests, +operation is used only by the tracee; +the remaining operations are used only by the tracer. +In the following operations, .I pid specifies the thread ID of the tracee to be acted on. -For requests other than +For operations other than .BR PTRACE_ATTACH , .BR PTRACE_SEIZE , .BR PTRACE_INTERRUPT , @@ -212,7 +212,7 @@ in the tracee's memory, returning the word as the result of the .BR ptrace () call. Linux does not have separate text and data address spaces, -so these two requests are currently equivalent. +so these two operations are currently equivalent. .RI ( data is ignored; but see NOTES.) .TP @@ -246,7 +246,7 @@ As for .B PTRACE_PEEKTEXT and .BR PTRACE_PEEKDATA , -these two requests are currently equivalent. +these two operations are currently equivalent. .TP .B PTRACE_POKEUSER .\" PTRACE_POKEUSR in kernel source, but glibc uses PTRACE_POKEUSER, @@ -740,7 +740,7 @@ argument. The .I addr argument is ignored. -This request is currently +This operation is currently .\" As of 4.19-rc2 supported only on arm (and arm64, though only for backwards compatibility), .\" commit 27aa55c5e5123fa8b8ad0156559d34d7edff58ca @@ -770,7 +770,7 @@ argument is treated as for The .I addr argument is ignored. -These requests are currently +These operations are currently .\" As at 3.7 supported only on x86. .TP @@ -1211,7 +1211,7 @@ ptrace operation returned .I waitpid(WNOHANG) may return 0 instead. In other words, the tracee may be "not yet fully dead", -but already refusing ptrace requests. +but already refusing ptrace operations. .P The tracer can't assume that the tracee .I always @@ -1355,7 +1355,7 @@ If the selected thread is traced, it enters signal-delivery-stop. At this point, the signal is not yet delivered to the process, and can be suppressed by the tracer. If the tracer doesn't suppress the signal, -it passes the signal to the tracee in the next ptrace restart request. +it passes the signal to the tracee in the next ptrace restart operation. This second step of signal delivery is called .I "signal injection" in this manual page. @@ -1390,7 +1390,7 @@ ptrace(PTRACE_restart, pid, 0, sig) .P where .B PTRACE_restart -is one of the restarting ptrace requests. +is one of the restarting ptrace operations. If .I sig is 0, then a signal is not delivered. @@ -1434,7 +1434,7 @@ Ptrace users should not try to "create a new signal" this way: use .BR tgkill (2) instead. .P -The fact that signal injection requests may be ignored +The fact that signal injection operations may be ignored when restarting the tracee after ptrace stops that are not signal-delivery-stops is a cause of confusion among ptrace users. @@ -1798,7 +1798,7 @@ for example, a system call etc.), expiration of a POSIX timer, change of state on a POSIX message queue, -or completion of an asynchronous I/O request. +or completion of an asynchronous I/O operation. .TP .IR si_code " == SI_KERNEL (0x80)" .B SIGTRAP @@ -2097,7 +2097,7 @@ use .B PTRACE_INTERRUPT command. .P -The request +The operation .P .in +4n .EX @@ -2385,21 +2385,21 @@ the report is sent only once. .SH RETURN VALUE On success, the .B PTRACE_PEEK* -requests return the requested data (but see NOTES), +operations return the requested data (but see NOTES), the .B PTRACE_SECCOMP_GET_FILTER -request returns the number of instructions in the BPF program, +operation returns the number of instructions in the BPF program, the .B PTRACE_GET_SYSCALL_INFO -request returns the number of bytes available to be written by the kernel, -and other requests return zero. +operation returns the number of bytes available to be written by the kernel, +and other operations return zero. .P -On error, all requests return \-1, and +On error, all operations return \-1, and .I errno is set to indicate the error. Since the value returned by a successful .B PTRACE_PEEK* -request may be \-1, the caller must clear +operation may be \-1, the caller must clear .I errno before the call, and then check it afterward to determine whether or not an error occurred. @@ -2423,11 +2423,11 @@ more or less arbitrarily. An attempt was made to set an invalid option. .TP .B EIO -.I request +.I op is invalid, or an attempt was made to read from or write to an invalid area in the tracer's or the tracee's memory, or there was a word-alignment violation, -or an invalid signal was specified during a restart request. +or an invalid signal was specified during a restart operation. .TP .B EPERM The specified process cannot be traced. @@ -2445,7 +2445,7 @@ or (before Linux 2.6.26) be .B ESRCH The specified process does not exist, or is not currently being traced by the caller, or is not stopped -(for requests that require a stopped tracee). +(for operations that require a stopped tracee). .SH STANDARDS None. .SH HISTORY @@ -2462,7 +2462,7 @@ are interpreted according to the prototype given, glibc currently declares .BR ptrace () as a variadic function with only the -.I request +.I op argument fixed. It is recommended to always supply four arguments, even if the requested operation does not use them, @@ -2829,7 +2829,7 @@ At the system call level, the .BR PTRACE_PEEKDATA , and .B PTRACE_PEEKUSER -requests have a different API: they store the result +operations have a different API: they store the result at the address specified by the .I data parameter, and the return value is the error flag. diff --git a/upstream/archlinux/man2/query_module.2 b/upstream/archlinux/man2/query_module.2 index c74803b1..c9382b0d 100644 --- a/upstream/archlinux/man2/query_module.2 +++ b/upstream/archlinux/man2/query_module.2 @@ -5,7 +5,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH query_module 2 2023-10-31 "Linux man-pages 6.06" +.TH query_module 2 2024-05-02 "Linux man-pages 6.8" .SH NAME query_module \- query the kernel for various bits pertaining to modules .SH SYNOPSIS diff --git a/upstream/archlinux/man2/quotactl.2 b/upstream/archlinux/man2/quotactl.2 index dc7f588d..8a11c2b5 100644 --- a/upstream/archlinux/man2/quotactl.2 +++ b/upstream/archlinux/man2/quotactl.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH quotactl 2 2023-10-31 "Linux man-pages 6.06" +.TH quotactl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME quotactl \- manipulate disk quotas .SH LIBRARY @@ -17,7 +17,7 @@ Standard C library " constants" .RB " (or " <linux/dqblk_xfs.h> "; see NOTES) */" .P -.BI "int quotactl(int " cmd ", const char *_Nullable " special ", int " id , +.BI "int quotactl(int " op ", const char *_Nullable " special ", int " id , .BI " caddr_t " addr ); .fi .SH DESCRIPTION @@ -35,14 +35,14 @@ The .BR quotactl () call manipulates disk quotas. The -.I cmd -argument indicates a command to be applied to the user or +.I op +argument indicates an operation to be applied to the user or group ID specified in .IR id . To initialize the -.I cmd +.I op argument, use the -.I QCMD(subcmd, type) +.I QCMD(subop, type) macro. The .I type @@ -55,7 +55,7 @@ for group quotas, or (since Linux 4.1) .BR PRJQUOTA , for project quotas. The -.I subcmd +.I subop value is described below. .P The @@ -65,14 +65,14 @@ of the (mounted) block special device for the filesystem being manipulated. .P The .I addr -argument is the address of an optional, command-specific, data structure +argument is the address of an optional, operation-specific, data structure that is copied in or out of the system. The interpretation of .I addr is given with each operation below. .P The -.I subcmd +.I subop value is one of the following operations: .TP .B Q_QUOTAON @@ -649,7 +649,7 @@ structure) which identify what types of quota should be removed. (Note that the quota type passed in the -.I cmd +.I op argument is ignored, but should remain valid in order to pass preliminary quotactl syscall handler checks.) .IP @@ -681,7 +681,7 @@ is set to indicate the error. .SH ERRORS .TP .B EACCES -.I cmd +.I op is .BR Q_QUOTAON , and the quota file pointed to by @@ -691,7 +691,7 @@ is not on the filesystem pointed to by .IR special . .TP .B EBUSY -.I cmd +.I op is .BR Q_QUOTAON , but another @@ -705,20 +705,20 @@ or is invalid. .TP .B EINVAL -.I cmd +.I op or .I type is invalid. .TP .B EINVAL -.I cmd +.I op is .BR Q_QUOTAON , but the specified quota file is corrupted. .TP .BR EINVAL " (since Linux 5.5)" .\" 3dd4d40b420846dd35869ccc8f8627feef2cff32 -.I cmd +.I op is .BR Q_XQUOTARM , but @@ -747,7 +747,7 @@ The caller lacked the required privilege for the specified operation. .TP .B ERANGE -.I cmd +.I op is .BR Q_SETQUOTA , but the specified limits are out of the range allowed by the quota format. @@ -757,13 +757,13 @@ No disk quota is found for the indicated user. Quotas have not been turned on for this filesystem. .TP .B ESRCH -.I cmd +.I op is .BR Q_QUOTAON , but the specified quota format was not found. .TP .B ESRCH -.I cmd +.I op is .B Q_GETNEXTQUOTA or diff --git a/upstream/archlinux/man2/read.2 b/upstream/archlinux/man2/read.2 index d70fa14a..1a8cee49 100644 --- a/upstream/archlinux/man2/read.2 +++ b/upstream/archlinux/man2/read.2 @@ -13,7 +13,7 @@ .\" Modified Sat Jul 12 20:45:39 1997 by Michael Haardt .\" <michael@cantor.informatik.rwth-aachen.de> .\" -.TH read 2 2023-10-31 "Linux man-pages 6.06" +.TH read 2 2024-05-02 "Linux man-pages 6.8" .SH NAME read \- read from a file descriptor .SH LIBRARY @@ -216,7 +216,7 @@ perform a (or .BR readv (2)) at the same time, then the I/O operations were not atomic -with respect updating the file offset, +with respect to updating the file offset, with the result that the reads in the two processes might (incorrectly) overlap in the blocks of data that they obtained. This problem was fixed in Linux 3.14. diff --git a/upstream/archlinux/man2/readahead.2 b/upstream/archlinux/man2/readahead.2 index c8bf1e2c..586498a9 100644 --- a/upstream/archlinux/man2/readahead.2 +++ b/upstream/archlinux/man2/readahead.2 @@ -5,7 +5,7 @@ .\" 2004-05-40 Created by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2004-10-05 aeb, minor correction .\" -.TH readahead 2 2023-10-31 "Linux man-pages 6.06" +.TH readahead 2 2024-05-02 "Linux man-pages 6.8" .SH NAME readahead \- initiate file readahead into page cache .SH LIBRARY diff --git a/upstream/archlinux/man2/readdir.2 b/upstream/archlinux/man2/readdir.2 index 21abb81f..7f65d6aa 100644 --- a/upstream/archlinux/man2/readdir.2 +++ b/upstream/archlinux/man2/readdir.2 @@ -7,7 +7,7 @@ .\" In 1.3.X, returns only one entry each time; return value is different. .\" Modified 2004-12-01, mtk, fixed headers listed in SYNOPSIS .\" -.TH readdir 2 2023-10-31 "Linux man-pages 6.06" +.TH readdir 2 2024-05-02 "Linux man-pages 6.8" .SH NAME readdir \- read directory entry .SH LIBRARY diff --git a/upstream/archlinux/man2/readlink.2 b/upstream/archlinux/man2/readlink.2 index e7b9998c..26c9c1c1 100644 --- a/upstream/archlinux/man2/readlink.2 +++ b/upstream/archlinux/man2/readlink.2 @@ -13,7 +13,7 @@ .\" 2011-09-20, Guillem Jover <guillem@hadrons.org>: .\" Added text on dynamically allocating buffer + example program .\" -.TH readlink 2 2023-11-01 "Linux man-pages 6.06" +.TH readlink 2 2024-05-02 "Linux man-pages 6.8" .SH NAME readlink, readlinkat \- read value of a symbolic link .SH LIBRARY @@ -260,6 +260,7 @@ reports a size of zero. #include <stdio.h> #include <stdlib.h> #include <sys/stat.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/readv.2 b/upstream/archlinux/man2/readv.2 index 27ca77fb..f9cbec5e 100644 --- a/upstream/archlinux/man2/readv.2 +++ b/upstream/archlinux/man2/readv.2 @@ -9,7 +9,7 @@ .\" add more details. .\" 2010-11-16, mtk, Added documentation of preadv() and pwritev() .\" -.TH readv 2 2023-10-31 "Linux man-pages 6.06" +.TH readv 2 2024-05-02 "Linux man-pages 6.8" .SH NAME readv, writev, preadv, pwritev, preadv2, pwritev2 \- read or write data into multiple buffers diff --git a/upstream/archlinux/man2/reboot.2 b/upstream/archlinux/man2/reboot.2 index 8c5751af..eef5e925 100644 --- a/upstream/archlinux/man2/reboot.2 +++ b/upstream/archlinux/man2/reboot.2 @@ -5,7 +5,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH reboot 2 2023-10-31 "Linux man-pages 6.06" +.TH reboot 2 2024-05-02 "Linux man-pages 6.8" .SH NAME reboot \- reboot or enable/disable Ctrl-Alt-Del .SH LIBRARY @@ -21,7 +21,7 @@ Standard C library .BR "#include <sys/syscall.h> " "/* Definition of " SYS_* " constants */" .B #include <unistd.h> .P -.BI "int syscall(SYS_reboot, int " magic ", int " magic2 ", int " cmd ", void *" arg ); +.BI "int syscall(SYS_reboot, int " magic ", int " magic2 ", int " op ", void *" arg ); .P /* Under glibc and most alternative libc's (including uclibc, dietlibc, musl and a few others), some of the constants involved have gotten @@ -31,7 +31,7 @@ Standard C library .BR "#include <sys/reboot.h> " "/* Definition of " RB_* " constants */" .B #include <unistd.h> .P -.BI "int reboot(int " cmd ); +.BI "int reboot(int " op ); .fi .SH DESCRIPTION The @@ -66,7 +66,7 @@ are permitted as values for (The hexadecimal values of these constants are meaningful.) .P The -.I cmd +.I op argument can have the following values: .TP .B LINUX_REBOOT_CMD_CAD_OFF @@ -157,7 +157,7 @@ if is called from a PID namespace other than the initial PID namespace with one of the -.I cmd +.I op values listed below, it performs a "reboot" of that namespace: the "init" process of the PID namespace is immediately terminated, @@ -165,7 +165,7 @@ with the effects described in .BR pid_namespaces (7). .P The values that can be supplied in -.I cmd +.I op when calling .BR reboot () in this case are as follows: @@ -191,7 +191,7 @@ in the parent process reports that the child was killed with a signal. .P For the other -.I cmd +.I op values, .BR reboot () returns \-1 and @@ -200,13 +200,13 @@ is set to .BR EINVAL . .SH RETURN VALUE For the values of -.I cmd +.I op that stop or restart the system, a successful call to .BR reboot () does not return. For the other -.I cmd +.I op values, zero is returned on success. In all cases, \-1 is returned on failure, and .I errno @@ -218,7 +218,8 @@ Problem with getting user-space data under .BR LINUX_REBOOT_CMD_RESTART2 . .TP .B EINVAL -Bad magic numbers or \fIcmd\fP. +Bad magic numbers or +.IR op . .TP .B EPERM The calling process has insufficient privilege to call diff --git a/upstream/archlinux/man2/recv.2 b/upstream/archlinux/man2/recv.2 index 06658e12..4a10bfea 100644 --- a/upstream/archlinux/man2/recv.2 +++ b/upstream/archlinux/man2/recv.2 @@ -10,7 +10,7 @@ .\" Modified 1998,1999 by Andi Kleen .\" 2001-06-19 corrected SO_EE_OFFENDER, bug report by James Hawtin .\" -.TH recv 2 2023-10-31 "Linux man-pages 6.06" +.TH recv 2 2024-05-02 "Linux man-pages 6.8" .SH NAME recv, recvfrom, recvmsg \- receive a message from a socket .SH LIBRARY @@ -123,7 +123,7 @@ is a per-call option, whereas is a setting on the open file description (see .BR open (2)), which will affect all threads in the calling process -and as well as other processes that hold file descriptors +as well as other processes that hold file descriptors referring to the same open file description. .TP .BR MSG_ERRQUEUE " (since Linux 2.2)" diff --git a/upstream/archlinux/man2/recvmmsg.2 b/upstream/archlinux/man2/recvmmsg.2 index ca3edbd2..a0479009 100644 --- a/upstream/archlinux/man2/recvmmsg.2 +++ b/upstream/archlinux/man2/recvmmsg.2 @@ -8,7 +8,7 @@ .\" Author: Arnaldo Carvalho de Melo <acme@redhat.com> .\" Date: Mon Oct 12 23:40:10 2009 -0700 .\" -.TH recvmmsg 2 2023-10-31 "Linux man-pages 6.06" +.TH recvmmsg 2 2024-05-02 "Linux man-pages 6.8" .SH NAME recvmmsg \- receive multiple messages on a socket .SH LIBRARY diff --git a/upstream/archlinux/man2/remap_file_pages.2 b/upstream/archlinux/man2/remap_file_pages.2 index 7dc9efeb..b347eaed 100644 --- a/upstream/archlinux/man2/remap_file_pages.2 +++ b/upstream/archlinux/man2/remap_file_pages.2 @@ -5,7 +5,7 @@ .\" 2003-12-10 Initial creation, Michael Kerrisk <mtk.manpages@gmail.com> .\" 2004-10-28 aeb, corrected prototype, prot must be 0 .\" -.TH remap_file_pages 2 2023-10-31 "Linux man-pages 6.06" +.TH remap_file_pages 2 2024-05-02 "Linux man-pages 6.8" .SH NAME remap_file_pages \- create a nonlinear file mapping .SH LIBRARY diff --git a/upstream/archlinux/man2/removexattr.2 b/upstream/archlinux/man2/removexattr.2 index aeceb4ca..7c3da95e 100644 --- a/upstream/archlinux/man2/removexattr.2 +++ b/upstream/archlinux/man2/removexattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH removexattr 2 2023-10-31 "Linux man-pages 6.06" +.TH removexattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME removexattr, lremovexattr, fremovexattr \- remove an extended attribute .SH LIBRARY diff --git a/upstream/archlinux/man2/rename.2 b/upstream/archlinux/man2/rename.2 index 6bbb3beb..e4f9cec9 100644 --- a/upstream/archlinux/man2/rename.2 +++ b/upstream/archlinux/man2/rename.2 @@ -10,7 +10,7 @@ .\" Modified Thu Mar 3 09:49:35 2005 by Michael Haardt <michael@moria.de> .\" 2007-03-25, mtk, added various text to DESCRIPTION. .\" -.TH rename 2 2023-10-31 "Linux man-pages 6.06" +.TH rename 2 2024-05-02 "Linux man-pages 6.8" .SH NAME rename, renameat, renameat2 \- change the name or location of a file .SH LIBRARY diff --git a/upstream/archlinux/man2/request_key.2 b/upstream/archlinux/man2/request_key.2 index 58c8b4fe..febeef70 100644 --- a/upstream/archlinux/man2/request_key.2 +++ b/upstream/archlinux/man2/request_key.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH request_key 2 2023-10-31 "Linux man-pages 6.06" +.TH request_key 2 2024-05-02 "Linux man-pages 6.8" .SH NAME request_key \- request a key from the kernel's key management facility .SH LIBRARY @@ -227,7 +227,7 @@ The authorization key is constructed as follows: .RS .IP \[bu] 3 The key type is -.IR """.request_key_auth""" . +.IR \[dq].request_key_auth\[dq] . .IP \[bu] The key's UID and GID are the same as the corresponding filesystem IDs of the requesting process. @@ -263,10 +263,10 @@ This program is supplied with the following command-line arguments: .RS .IP [0] 5 The string -.IR """/sbin/request\-key""" . +.IR \[dq]/sbin/request\-key\[dq] . .IP [1] The string -.I """create""" +.I \[dq]create\[dq] (indicating that a key is to be created). .IP [2] The ID of the key that is to be instantiated. diff --git a/upstream/archlinux/man2/restart_syscall.2 b/upstream/archlinux/man2/restart_syscall.2 index 41b3335a..70edc0c4 100644 --- a/upstream/archlinux/man2/restart_syscall.2 +++ b/upstream/archlinux/man2/restart_syscall.2 @@ -10,7 +10,7 @@ .\" .\" See also Section 11.3.3 of Understanding the Linux Kernel, 3rd edition .\" -.TH restart_syscall 2 2023-10-31 "Linux man-pages 6.06" +.TH restart_syscall 2 2024-05-02 "Linux man-pages 6.8" .SH NAME restart_syscall \- restart a system call after interruption by a stop signal .SH SYNOPSIS diff --git a/upstream/archlinux/man2/rmdir.2 b/upstream/archlinux/man2/rmdir.2 index c5c50d97..038b5232 100644 --- a/upstream/archlinux/man2/rmdir.2 +++ b/upstream/archlinux/man2/rmdir.2 @@ -7,7 +7,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH rmdir 2 2023-10-31 "Linux man-pages 6.06" +.TH rmdir 2 2024-05-02 "Linux man-pages 6.8" .SH NAME rmdir \- delete a directory .SH LIBRARY diff --git a/upstream/archlinux/man2/rt_sigqueueinfo.2 b/upstream/archlinux/man2/rt_sigqueueinfo.2 index cdbf7559..12d7a039 100644 --- a/upstream/archlinux/man2/rt_sigqueueinfo.2 +++ b/upstream/archlinux/man2/rt_sigqueueinfo.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH rt_sigqueueinfo 2 2023-10-31 "Linux man-pages 6.06" +.TH rt_sigqueueinfo 2 2024-05-02 "Linux man-pages 6.8" .SH NAME rt_sigqueueinfo, rt_tgsigqueueinfo \- queue a signal and data .SH LIBRARY diff --git a/upstream/archlinux/man2/s390_guarded_storage.2 b/upstream/archlinux/man2/s390_guarded_storage.2 index 9f801093..1ca61e35 100644 --- a/upstream/archlinux/man2/s390_guarded_storage.2 +++ b/upstream/archlinux/man2/s390_guarded_storage.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH s390_guarded_storage 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_guarded_storage 2 2024-05-02 "Linux man-pages 6.8" .SH NAME s390_guarded_storage \- operations with z/Architecture guarded storage facility .SH LIBRARY diff --git a/upstream/archlinux/man2/s390_pci_mmio_write.2 b/upstream/archlinux/man2/s390_pci_mmio_write.2 index ae015b1c..ea6361db 100644 --- a/upstream/archlinux/man2/s390_pci_mmio_write.2 +++ b/upstream/archlinux/man2/s390_pci_mmio_write.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH s390_pci_mmio_write 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_pci_mmio_write 2 2024-05-02 "Linux man-pages 6.8" .SH NAME s390_pci_mmio_write, s390_pci_mmio_read \- transfer data to/from PCI MMIO memory page diff --git a/upstream/archlinux/man2/s390_runtime_instr.2 b/upstream/archlinux/man2/s390_runtime_instr.2 index 1db4a498..e358ce16 100644 --- a/upstream/archlinux/man2/s390_runtime_instr.2 +++ b/upstream/archlinux/man2/s390_runtime_instr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH s390_runtime_instr 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_runtime_instr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation .SH LIBRARY diff --git a/upstream/archlinux/man2/s390_sthyi.2 b/upstream/archlinux/man2/s390_sthyi.2 index 6a925581..9ab4af2e 100644 --- a/upstream/archlinux/man2/s390_sthyi.2 +++ b/upstream/archlinux/man2/s390_sthyi.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH s390_sthyi 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_sthyi 2 2024-05-02 "Linux man-pages 6.8" .SH NAME s390_sthyi \- emulate STHYI instruction .SH LIBRARY diff --git a/upstream/archlinux/man2/sched_get_priority_max.2 b/upstream/archlinux/man2/sched_get_priority_max.2 index e4c3e743..14e9d9f8 100644 --- a/upstream/archlinux/man2/sched_get_priority_max.2 +++ b/upstream/archlinux/man2/sched_get_priority_max.2 @@ -7,7 +7,7 @@ .\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de> .\" revision .\" -.TH sched_get_priority_max 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_get_priority_max 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_get_priority_max, sched_get_priority_min \- get static priority range .SH LIBRARY diff --git a/upstream/archlinux/man2/sched_rr_get_interval.2 b/upstream/archlinux/man2/sched_rr_get_interval.2 index 110f9a29..bc3a1d30 100644 --- a/upstream/archlinux/man2/sched_rr_get_interval.2 +++ b/upstream/archlinux/man2/sched_rr_get_interval.2 @@ -7,7 +7,7 @@ .\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de> .\" revision .\" -.TH sched_rr_get_interval 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_rr_get_interval 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_rr_get_interval \- get the SCHED_RR interval for the named process .SH LIBRARY diff --git a/upstream/archlinux/man2/sched_setaffinity.2 b/upstream/archlinux/man2/sched_setaffinity.2 index d7455b34..fb49b56e 100644 --- a/upstream/archlinux/man2/sched_setaffinity.2 +++ b/upstream/archlinux/man2/sched_setaffinity.2 @@ -12,7 +12,7 @@ .\" 2008-11-12, mtk, removed CPU_*() macro descriptions to a .\" separate CPU_SET(3) page. .\" -.TH sched_setaffinity 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setaffinity 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_setaffinity, sched_getaffinity \- \ set and get a thread's CPU affinity mask diff --git a/upstream/archlinux/man2/sched_setattr.2 b/upstream/archlinux/man2/sched_setattr.2 index b55af427..0932ae46 100644 --- a/upstream/archlinux/man2/sched_setattr.2 +++ b/upstream/archlinux/man2/sched_setattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sched_setattr 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_setattr, sched_getattr \- set and get scheduling policy and attributes diff --git a/upstream/archlinux/man2/sched_setparam.2 b/upstream/archlinux/man2/sched_setparam.2 index 5e72087b..714f06a2 100644 --- a/upstream/archlinux/man2/sched_setparam.2 +++ b/upstream/archlinux/man2/sched_setparam.2 @@ -8,7 +8,7 @@ .\" revision .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH sched_setparam 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setparam 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_setparam, sched_getparam \- set and get scheduling parameters .SH LIBRARY diff --git a/upstream/archlinux/man2/sched_setscheduler.2 b/upstream/archlinux/man2/sched_setscheduler.2 index 185bc906..e45a973f 100644 --- a/upstream/archlinux/man2/sched_setscheduler.2 +++ b/upstream/archlinux/man2/sched_setscheduler.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH sched_setscheduler 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setscheduler 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_setscheduler, sched_getscheduler \- set and get scheduling policy/parameters diff --git a/upstream/archlinux/man2/sched_yield.2 b/upstream/archlinux/man2/sched_yield.2 index 0d2b7665..97360c91 100644 --- a/upstream/archlinux/man2/sched_yield.2 +++ b/upstream/archlinux/man2/sched_yield.2 @@ -7,7 +7,7 @@ .\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de> .\" revision .\" -.TH sched_yield 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_yield 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sched_yield \- yield the processor .SH LIBRARY diff --git a/upstream/archlinux/man2/seccomp.2 b/upstream/archlinux/man2/seccomp.2 index 522b4090..ea394297 100644 --- a/upstream/archlinux/man2/seccomp.2 +++ b/upstream/archlinux/man2/seccomp.2 @@ -6,7 +6,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH seccomp 2 2023-10-31 "Linux man-pages 6.06" +.TH seccomp 2 2024-05-02 "Linux man-pages 6.8" .SH NAME seccomp \- operate on Secure Computing state of the process .SH LIBRARY diff --git a/upstream/archlinux/man2/seccomp_unotify.2 b/upstream/archlinux/man2/seccomp_unotify.2 index 1bd5eb4d..eb294cf3 100644 --- a/upstream/archlinux/man2/seccomp_unotify.2 +++ b/upstream/archlinux/man2/seccomp_unotify.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH seccomp_unotify 2 2023-10-31 "Linux man-pages 6.06" +.TH seccomp_unotify 2 2024-05-02 "Linux man-pages 6.8" .SH NAME seccomp_unotify \- Seccomp user-space notification mechanism .SH LIBRARY diff --git a/upstream/archlinux/man2/select.2 b/upstream/archlinux/man2/select.2 index a43bbdb9..6ace9548 100644 --- a/upstream/archlinux/man2/select.2 +++ b/upstream/archlinux/man2/select.2 @@ -17,7 +17,7 @@ .\" 2005-03-11, mtk, modified pselect() text (it is now a system .\" call in Linux 2.6.16. .\" -.TH select 2 2023-10-31 "Linux man-pages 6.06" +.TH select 2 2024-05-02 "Linux man-pages 6.8" .SH NAME select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO, fd_set \- synchronous I/O multiplexing diff --git a/upstream/archlinux/man2/select_tut.2 b/upstream/archlinux/man2/select_tut.2 index ab6c8c30..42968e54 100644 --- a/upstream/archlinux/man2/select_tut.2 +++ b/upstream/archlinux/man2/select_tut.2 @@ -9,7 +9,7 @@ .\" various other changes .\" 2008-01-26, mtk, substantial changes and rewrites .\" -.TH SELECT_TUT 2 2023-10-31 "Linux man-pages 6.06" +.TH SELECT_TUT 2 2024-05-02 "Linux man-pages 6.8" .SH NAME select, pselect \- synchronous I/O multiplexing .SH LIBRARY @@ -344,6 +344,7 @@ from one TCP port to another. #include <string.h> #include <sys/select.h> #include <sys/socket.h> +#include <sys/types.h> #include <unistd.h> \& static int forward_port; diff --git a/upstream/archlinux/man2/semctl.2 b/upstream/archlinux/man2/semctl.2 index f8a322a1..ab46fb79 100644 --- a/upstream/archlinux/man2/semctl.2 +++ b/upstream/archlinux/man2/semctl.2 @@ -20,7 +20,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, SEM_INFO, SEM_STAT descriptions. .\" 2018-03-20, dbueso: Added SEM_STAT_ANY description. .\" -.TH semctl 2 2023-10-31 "Linux man-pages 6.06" +.TH semctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME semctl \- System V semaphore control operations .SH LIBRARY @@ -30,12 +30,12 @@ Standard C library .nf .B #include <sys/sem.h> .P -.BI "int semctl(int " semid ", int " semnum ", int " cmd ", ...);" +.BI "int semctl(int " semid ", int " semnum ", int " op ", ...);" .fi .SH DESCRIPTION .BR semctl () performs the control operation specified by -.I cmd +.I op on the System\ V semaphore set identified by .IR semid , or on the @@ -44,7 +44,7 @@ semaphore of that set. (The semaphores in a set are numbered starting at 0.) .P This function has three or four arguments, depending on -.IR cmd . +.IR op . When there are four, the fourth has the type .IR "union semun" . The \fIcalling program\fP must define this union as follows: @@ -149,7 +149,7 @@ In effect, "write" means "alter" for a semaphore set. Bits 0100, 0010, and 0001 (the execute bits) are unused by the system. .P Valid values for -.I cmd +.I op are: .TP .B IPC_STAT @@ -380,7 +380,7 @@ The calling process must have alter permission on the semaphore set. On success, .BR semctl () returns a nonnegative value depending on -.I cmd +.I op as follows: .TP .B GETNCNT @@ -422,7 +422,7 @@ as for .BR SEM_STAT . .P All other -.I cmd +.I op values return 0 on success. .P On failure, @@ -434,7 +434,7 @@ to indicate the error. .TP .B EACCES The argument -.I cmd +.I op has one of the values .BR GETALL , .BR GETPID , @@ -464,7 +464,7 @@ The semaphore set was removed. .TP .B EINVAL Invalid value for -.I cmd +.I op or .IR semid . Or: for a @@ -475,7 +475,7 @@ referred to an array slot that is currently unused. .TP .B EPERM The argument -.I cmd +.I op has the value .B IPC_SET or @@ -493,7 +493,7 @@ capability. .TP .B ERANGE The argument -.I cmd +.I op has the value .B SETALL or @@ -575,7 +575,7 @@ a recompilation under glibc-2.1.91 or later should suffice. (The kernel distinguishes old and new calls by an .B IPC_64 flag in -.IR cmd .) +.IR op .) .P In some earlier versions of glibc, the .I semun diff --git a/upstream/archlinux/man2/semget.2 b/upstream/archlinux/man2/semget.2 index b1fcb45a..82b023fd 100644 --- a/upstream/archlinux/man2/semget.2 +++ b/upstream/archlinux/man2/semget.2 @@ -14,7 +14,7 @@ .\" Rewrote BUGS note about semget()'s failure to initialize .\" semaphore values .\" -.TH semget 2 2023-10-31 "Linux man-pages 6.06" +.TH semget 2 2024-05-02 "Linux man-pages 6.8" .SH NAME semget \- get a System V semaphore set identifier .SH LIBRARY diff --git a/upstream/archlinux/man2/semop.2 b/upstream/archlinux/man2/semop.2 index 23402861..ecc47dc2 100644 --- a/upstream/archlinux/man2/semop.2 +++ b/upstream/archlinux/man2/semop.2 @@ -12,7 +12,7 @@ .\" 2005-04-08, mtk, Noted kernel version numbers for semtimedop() .\" 2007-07-09, mtk, Added an EXAMPLE code segment. .\" -.TH semop 2 2023-10-31 "Linux man-pages 6.06" +.TH semop 2 2024-05-02 "Linux man-pages 6.8" .SH NAME semop, semtimedop \- System V semaphore operations .SH LIBRARY diff --git a/upstream/archlinux/man2/send.2 b/upstream/archlinux/man2/send.2 index 1fbd790e..785b9117 100644 --- a/upstream/archlinux/man2/send.2 +++ b/upstream/archlinux/man2/send.2 @@ -9,7 +9,7 @@ .\" Modified Oct 2003 by aeb .\" Modified 2004-07-01 by mtk .\" -.TH send 2 2023-10-31 "Linux man-pages 6.06" +.TH send 2 2024-05-02 "Linux man-pages 6.8" .SH NAME send, sendto, sendmsg \- send a message on a socket .SH LIBRARY @@ -184,7 +184,7 @@ is a per-call option, whereas is a setting on the open file description (see .BR open (2)), which will affect all threads in the calling process -and as well as other processes that hold file descriptors +as well as other processes that hold file descriptors referring to the same open file description. .TP .BR MSG_EOR " (since Linux 2.2)" diff --git a/upstream/archlinux/man2/sendfile.2 b/upstream/archlinux/man2/sendfile.2 index db0e3939..a400bd6d 100644 --- a/upstream/archlinux/man2/sendfile.2 +++ b/upstream/archlinux/man2/sendfile.2 @@ -11,7 +11,7 @@ .\" .\" 2005-03-31 Martin Pool <mbp@sourcefrog.net> mmap() improvements .\" -.TH sendfile 2 2023-12-21 "Linux man-pages 6.06" +.TH sendfile 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sendfile \- transfer data between file descriptors .SH LIBRARY diff --git a/upstream/archlinux/man2/sendmmsg.2 b/upstream/archlinux/man2/sendmmsg.2 index f1f9456e..e44bb374 100644 --- a/upstream/archlinux/man2/sendmmsg.2 +++ b/upstream/archlinux/man2/sendmmsg.2 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sendmmsg 2 2023-10-31 "Linux man-pages 6.06" +.TH sendmmsg 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sendmmsg \- send multiple messages on a socket .SH LIBRARY diff --git a/upstream/archlinux/man2/set_mempolicy.2 b/upstream/archlinux/man2/set_mempolicy.2 index ccefec19..bc89e119 100644 --- a/upstream/archlinux/man2/set_mempolicy.2 +++ b/upstream/archlinux/man2/set_mempolicy.2 @@ -7,7 +7,7 @@ .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com> .\" more precise specification of behavior. .\" -.TH set_mempolicy 2 2023-10-31 "Linux man-pages 6.06" +.TH set_mempolicy 2 2024-05-02 "Linux man-pages 6.8" .SH NAME set_mempolicy \- set default NUMA memory policy for a thread and its children .SH LIBRARY @@ -63,6 +63,7 @@ argument must specify one of .BR MPOL_DEFAULT , .BR MPOL_BIND , .BR MPOL_INTERLEAVE , +.BR MPOL_WEIGHTED_INTERLEAVE , .BR MPOL_PREFERRED , or .B MPOL_LOCAL @@ -199,6 +200,23 @@ the memory bandwidth of a single node. .\" To be effective the memory area should be fairly large, .\" at least 1 MB or bigger. .TP +.BR MPOL_WEIGHTED_INTERLEAVE " (since Linux 6.9)" +.\" commit fa3bea4e1f8202d787709b7e3654eb0a99aed758 +This mode interleaves page allocations across the nodes specified in +.I nodemask +according to the weights in +.IR /sys/kernel/mm/mempolicy/weighted_interleave . +For example, if bits 0, 2, and 5 are set in +.IR nodemask , +and the contents of +.IR /sys/kernel/mm/mempolicy/weighted_interleave/node0 , +.IR /sys/ .\|.\|. /node2 , +and +.IR /sys/ .\|.\|. /node5 +are 4, 7, and 9, respectively, +then pages in this region will be allocated on nodes 0, 2, and 5 +in a 4:7:9 ratio. +.TP .B MPOL_PREFERRED This mode sets the preferred node for allocation. The kernel will try to allocate pages from this node first diff --git a/upstream/archlinux/man2/set_thread_area.2 b/upstream/archlinux/man2/set_thread_area.2 index 6406cfb1..90ac2056 100644 --- a/upstream/archlinux/man2/set_thread_area.2 +++ b/upstream/archlinux/man2/set_thread_area.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH set_thread_area 2 2023-10-31 "Linux man-pages 6.06" +.TH set_thread_area 2 2024-05-02 "Linux man-pages 6.8" .SH NAME get_thread_area, set_thread_area \- manipulate thread-local storage information .SH LIBRARY diff --git a/upstream/archlinux/man2/set_tid_address.2 b/upstream/archlinux/man2/set_tid_address.2 index aa90b057..c3911c8d 100644 --- a/upstream/archlinux/man2/set_tid_address.2 +++ b/upstream/archlinux/man2/set_tid_address.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH set_tid_address 2 2023-10-31 "Linux man-pages 6.06" +.TH set_tid_address 2 2024-05-02 "Linux man-pages 6.8" .SH NAME set_tid_address \- set pointer to thread ID .SH LIBRARY diff --git a/upstream/archlinux/man2/seteuid.2 b/upstream/archlinux/man2/seteuid.2 index a82ab6eb..c922717e 100644 --- a/upstream/archlinux/man2/seteuid.2 +++ b/upstream/archlinux/man2/seteuid.2 @@ -6,7 +6,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH seteuid 2 2024-02-11 "Linux man-pages 6.06" +.TH seteuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME seteuid, setegid \- set effective user or group ID .SH LIBRARY diff --git a/upstream/archlinux/man2/setfsgid.2 b/upstream/archlinux/man2/setfsgid.2 index e87e5160..fcbca170 100644 --- a/upstream/archlinux/man2/setfsgid.2 +++ b/upstream/archlinux/man2/setfsgid.2 @@ -9,7 +9,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH setfsgid 2 2023-10-31 "Linux man-pages 6.06" +.TH setfsgid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setfsgid \- set group identity used for filesystem checks .SH LIBRARY diff --git a/upstream/archlinux/man2/setfsuid.2 b/upstream/archlinux/man2/setfsuid.2 index 01102bf5..a7be0f62 100644 --- a/upstream/archlinux/man2/setfsuid.2 +++ b/upstream/archlinux/man2/setfsuid.2 @@ -9,7 +9,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH setfsuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setfsuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setfsuid \- set user identity used for filesystem checks .SH LIBRARY diff --git a/upstream/archlinux/man2/setgid.2 b/upstream/archlinux/man2/setgid.2 index 52bdd29c..ffb9ceee 100644 --- a/upstream/archlinux/man2/setgid.2 +++ b/upstream/archlinux/man2/setgid.2 @@ -7,7 +7,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2002-03-09 by aeb .\" -.TH setgid 2 2023-10-31 "Linux man-pages 6.06" +.TH setgid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setgid \- set group identity .SH LIBRARY diff --git a/upstream/archlinux/man2/setns.2 b/upstream/archlinux/man2/setns.2 index 50573c7d..f9ea5016 100644 --- a/upstream/archlinux/man2/setns.2 +++ b/upstream/archlinux/man2/setns.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-only .\" -.TH setns 2 2023-10-31 "Linux man-pages 6.06" +.TH setns 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setns \- reassociate thread with a namespace .SH LIBRARY diff --git a/upstream/archlinux/man2/setpgid.2 b/upstream/archlinux/man2/setpgid.2 index 27d057c2..e7f2293d 100644 --- a/upstream/archlinux/man2/setpgid.2 +++ b/upstream/archlinux/man2/setpgid.2 @@ -17,7 +17,7 @@ .\" 2007-07-25, mtk, fairly substantial rewrites and rearrangements .\" of text. .\" -.TH setpgid 2 2023-10-31 "Linux man-pages 6.06" +.TH setpgid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setpgid, getpgid, setpgrp, getpgrp \- set/get process group .SH LIBRARY diff --git a/upstream/archlinux/man2/setresuid.2 b/upstream/archlinux/man2/setresuid.2 index f5ecf3b3..ce8c35ce 100644 --- a/upstream/archlinux/man2/setresuid.2 +++ b/upstream/archlinux/man2/setresuid.2 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified, 2003-05-26, Michael Kerrisk, <mtk.manpages@gmail.com> -.TH setresuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setresuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setresuid, setresgid \- set real, effective, and saved user or group ID .SH LIBRARY diff --git a/upstream/archlinux/man2/setreuid.2 b/upstream/archlinux/man2/setreuid.2 index daf2c5a5..3481369e 100644 --- a/upstream/archlinux/man2/setreuid.2 +++ b/upstream/archlinux/man2/setreuid.2 @@ -15,7 +15,7 @@ .\" 2004-07-04 by aeb .\" 2004-05-27 by Michael Kerrisk .\" -.TH setreuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setreuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setreuid, setregid \- set real and/or effective user or group ID .SH LIBRARY diff --git a/upstream/archlinux/man2/setsid.2 b/upstream/archlinux/man2/setsid.2 index 2adc19bf..a0f0506c 100644 --- a/upstream/archlinux/man2/setsid.2 +++ b/upstream/archlinux/man2/setsid.2 @@ -9,7 +9,7 @@ .\" tiny changes from a man page by Charles Livingston). .\" Modified Sun Jul 21 14:45:46 1996 <aeb@cwi.nl> .\" -.TH setsid 2 2023-10-31 "Linux man-pages 6.06" +.TH setsid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setsid \- creates a session and sets the process group ID .SH LIBRARY diff --git a/upstream/archlinux/man2/setuid.2 b/upstream/archlinux/man2/setuid.2 index 4d8ffb7d..b45782d6 100644 --- a/upstream/archlinux/man2/setuid.2 +++ b/upstream/archlinux/man2/setuid.2 @@ -8,7 +8,7 @@ .\" <richard@greenend.org.uk>, aeb 970616. .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements -.TH setuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setuid 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setuid \- set user identity .SH LIBRARY diff --git a/upstream/archlinux/man2/setup.2 b/upstream/archlinux/man2/setup.2 index c10fb44d..16c5078f 100644 --- a/upstream/archlinux/man2/setup.2 +++ b/upstream/archlinux/man2/setup.2 @@ -11,7 +11,7 @@ .\" Modified Wed Nov 6 04:05:28 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Sat Jan 29 01:08:23 2000 by aeb .\" -.TH setup 2 2023-10-31 "Linux man-pages 6.06" +.TH setup 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setup \- setup devices and filesystems, mount root filesystem .SH LIBRARY diff --git a/upstream/archlinux/man2/setxattr.2 b/upstream/archlinux/man2/setxattr.2 index df821e59..1730dedc 100644 --- a/upstream/archlinux/man2/setxattr.2 +++ b/upstream/archlinux/man2/setxattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH setxattr 2 2023-10-31 "Linux man-pages 6.06" +.TH setxattr 2 2024-05-02 "Linux man-pages 6.8" .SH NAME setxattr, lsetxattr, fsetxattr \- set an extended attribute value .SH LIBRARY diff --git a/upstream/archlinux/man2/sgetmask.2 b/upstream/archlinux/man2/sgetmask.2 index 07e413a1..0296a69e 100644 --- a/upstream/archlinux/man2/sgetmask.2 +++ b/upstream/archlinux/man2/sgetmask.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sgetmask 2 2023-10-31 "Linux man-pages 6.06" +.TH sgetmask 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sgetmask, ssetmask \- manipulation of signal mask (obsolete) .SH LIBRARY diff --git a/upstream/archlinux/man2/shmctl.2 b/upstream/archlinux/man2/shmctl.2 index 0ede555d..73cc7732 100644 --- a/upstream/archlinux/man2/shmctl.2 +++ b/upstream/archlinux/man2/shmctl.2 @@ -24,7 +24,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, SHM_INFO, SHM_STAT descriptions. .\" 2018-03-20, dbueso: Added SHM_STAT_ANY description. .\" -.TH shmctl 2 2023-10-31 "Linux man-pages 6.06" +.TH shmctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME shmctl \- System V shared memory control .SH LIBRARY @@ -34,12 +34,12 @@ Standard C library .nf .B #include <sys/shm.h> .P -.BI "int shmctl(int " shmid ", int " cmd ", struct shmid_ds *" buf ); +.BI "int shmctl(int " shmid ", int " op ", struct shmid_ds *" buf ); .fi .SH DESCRIPTION .BR shmctl () performs the control operation specified by -.I cmd +.I op on the System\ V shared memory segment whose identifier is given in .IR shmid . .P @@ -153,7 +153,7 @@ call with the flag.) .P Valid values for -.I cmd +.I op are: .TP .B IPC_STAT @@ -309,7 +309,9 @@ meaning that any user can employ this operation (just as any user may read to obtain the same information). .P The caller can prevent or allow swapping of a shared -memory segment with the following \fIcmd\fP values: +memory segment with the following +.I op +values: .TP .BR SHM_LOCK " (Linux-specific)" Prevent swapping of the shared memory segment. @@ -379,7 +381,7 @@ capability in the user namespace that governs its IPC namespace. .TP .B EFAULT The argument -.I cmd +.I op has value .B IPC_SET or @@ -392,8 +394,10 @@ isn't accessible. \fIshmid\fP points to a removed identifier. .TP .B EINVAL -\fIshmid\fP is not a valid identifier, or \fIcmd\fP -is not a valid command. +.I shmid +is not a valid identifier, or +.I op +is not a valid operation. Or: for a .B SHM_STAT or @@ -468,7 +472,7 @@ a recompilation under glibc-2.1.91 or later should suffice. (The kernel distinguishes old and new calls by an .B IPC_64 flag in -.IR cmd .) +.IR op .) .SH NOTES The .BR IPC_INFO , diff --git a/upstream/archlinux/man2/shmget.2 b/upstream/archlinux/man2/shmget.2 index ac3e2b75..ed40ff2a 100644 --- a/upstream/archlinux/man2/shmget.2 +++ b/upstream/archlinux/man2/shmget.2 @@ -15,7 +15,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH shmget 2 2023-10-31 "Linux man-pages 6.06" +.TH shmget 2 2024-05-02 "Linux man-pages 6.8" .SH NAME shmget \- allocates a System V shared memory segment .SH LIBRARY diff --git a/upstream/archlinux/man2/shmop.2 b/upstream/archlinux/man2/shmop.2 index f5b70a48..74af4fe1 100644 --- a/upstream/archlinux/man2/shmop.2 +++ b/upstream/archlinux/man2/shmop.2 @@ -17,7 +17,7 @@ .\" Changed wording and placement of sentence regarding attachment .\" of segments marked for destruction .\" -.TH SHMOP 2 2023-10-31 "Linux man-pages 6.06" +.TH SHMOP 2 2024-05-02 "Linux man-pages 6.8" .SH NAME shmat, shmdt \- System V shared memory operations .SH LIBRARY @@ -319,27 +319,28 @@ The following header file is included by the "reader" and "writer" programs: \& Licensed under GNU General Public License v2 or later. */ -#include <sys/types.h> -#include <sys/ipc.h> -#include <sys/shm.h> -#include <sys/sem.h> +#ifndef SVSHM_STRING_H +#define SVSHM_STRING_H +\& #include <stdio.h> #include <stdlib.h> -#include <string.h> +#include <sys/sem.h> \& #define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \e } while (0) \& union semun { /* Used in calls to semctl() */ int val; - struct semid_ds * buf; - unsigned short * array; + struct semid_ds *buf; + unsigned short *array; #if defined(__linux__) - struct seminfo * __buf; + struct seminfo *__buf; #endif }; \& #define MEM_SIZE 4096 +\& +#endif // include guard .EE .\" SRC END .in diff --git a/upstream/archlinux/man2/shutdown.2 b/upstream/archlinux/man2/shutdown.2 index 7dde6565..bc8cd185 100644 --- a/upstream/archlinux/man2/shutdown.2 +++ b/upstream/archlinux/man2/shutdown.2 @@ -9,7 +9,7 @@ .\" Modified Tue Oct 22 22:04:51 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 1998 by Andi Kleen .\" -.TH shutdown 2 2023-10-31 "Linux man-pages 6.06" +.TH shutdown 2 2024-05-02 "Linux man-pages 6.8" .SH NAME shutdown \- shut down part of a full-duplex connection .SH LIBRARY diff --git a/upstream/archlinux/man2/sigaction.2 b/upstream/archlinux/man2/sigaction.2 index 85c6c00f..94206768 100644 --- a/upstream/archlinux/man2/sigaction.2 +++ b/upstream/archlinux/man2/sigaction.2 @@ -25,7 +25,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH sigaction 2 2023-10-31 "Linux man-pages 6.06" +.TH sigaction 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH LIBRARY @@ -1020,14 +1020,21 @@ or similar. POSIX.1-1990 specified only .BR SA_NOCLDSTOP . POSIX.1-2001 added -.BR SA_NOCLDSTOP , .BR SA_NOCLDWAIT , .BR SA_NODEFER , .BR SA_ONSTACK , .BR SA_RESETHAND , .BR SA_RESTART , and -.BR SA_SIGINFO . +.B SA_SIGINFO +as XSI extensions. +POSIX.1-2008 moved +.BR SA_NODEFER , +.BR SA_RESETHAND , +.BR SA_RESTART , +and +.B SA_SIGINFO +to the base specifications. Use of these latter values in .I sa_flags may be less portable in applications intended for older diff --git a/upstream/archlinux/man2/sigaltstack.2 b/upstream/archlinux/man2/sigaltstack.2 index 8b91da5a..ebccc41c 100644 --- a/upstream/archlinux/man2/sigaltstack.2 +++ b/upstream/archlinux/man2/sigaltstack.2 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" aeb, various minor fixes -.TH sigaltstack 2 2023-10-31 "Linux man-pages 6.06" +.TH sigaltstack 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigaltstack \- set and/or get signal stack context .SH LIBRARY diff --git a/upstream/archlinux/man2/signal.2 b/upstream/archlinux/man2/signal.2 index cfb0aef9..9b26eca5 100644 --- a/upstream/archlinux/man2/signal.2 +++ b/upstream/archlinux/man2/signal.2 @@ -13,7 +13,7 @@ .\" various sections. .\" 2008-07-11, mtk: rewrote and expanded portability discussion. .\" -.TH signal 2 2023-10-31 "Linux man-pages 6.06" +.TH signal 2 2024-05-02 "Linux man-pages 6.8" .SH NAME signal \- ANSI C signal handling .SH LIBRARY diff --git a/upstream/archlinux/man2/signalfd.2 b/upstream/archlinux/man2/signalfd.2 index e0c0a47e..f734d4dd 100644 --- a/upstream/archlinux/man2/signalfd.2 +++ b/upstream/archlinux/man2/signalfd.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH signalfd 2 2023-10-31 "Linux man-pages 6.06" +.TH signalfd 2 2024-05-02 "Linux man-pages 6.8" .SH NAME signalfd \- create a file descriptor for accepting signals .SH LIBRARY @@ -469,6 +469,7 @@ $ #include <stdio.h> #include <stdlib.h> #include <sys/signalfd.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/sigpending.2 b/upstream/archlinux/man2/sigpending.2 index 7f321f5e..06f8a7ad 100644 --- a/upstream/archlinux/man2/sigpending.2 +++ b/upstream/archlinux/man2/sigpending.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigpending 2 2023-10-31 "Linux man-pages 6.06" +.TH sigpending 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigpending, rt_sigpending \- examine pending signals .SH LIBRARY diff --git a/upstream/archlinux/man2/sigprocmask.2 b/upstream/archlinux/man2/sigprocmask.2 index 28a5f908..12cb10aa 100644 --- a/upstream/archlinux/man2/sigprocmask.2 +++ b/upstream/archlinux/man2/sigprocmask.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigprocmask 2 2023-10-31 "Linux man-pages 6.06" +.TH sigprocmask 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigprocmask, rt_sigprocmask \- examine and change blocked signals .SH LIBRARY diff --git a/upstream/archlinux/man2/sigreturn.2 b/upstream/archlinux/man2/sigreturn.2 index b230591c..d842a2a4 100644 --- a/upstream/archlinux/man2/sigreturn.2 +++ b/upstream/archlinux/man2/sigreturn.2 @@ -7,7 +7,7 @@ .\" 2008-06-26, mtk, added some more detail on the work done by sigreturn() .\" 2014-12-05, mtk, rewrote all of the rest of the original page .\" -.TH sigreturn 2 2023-10-31 "Linux man-pages 6.06" +.TH sigreturn 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigreturn, rt_sigreturn \- return from signal handler and cleanup stack frame .SH LIBRARY diff --git a/upstream/archlinux/man2/sigsuspend.2 b/upstream/archlinux/man2/sigsuspend.2 index 945d30d6..7dda742e 100644 --- a/upstream/archlinux/man2/sigsuspend.2 +++ b/upstream/archlinux/man2/sigsuspend.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigsuspend 2 2023-10-31 "Linux man-pages 6.06" +.TH sigsuspend 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigsuspend, rt_sigsuspend \- wait for a signal .SH LIBRARY diff --git a/upstream/archlinux/man2/sigwaitinfo.2 b/upstream/archlinux/man2/sigwaitinfo.2 index 656c8f18..18b1c1f8 100644 --- a/upstream/archlinux/man2/sigwaitinfo.2 +++ b/upstream/archlinux/man2/sigwaitinfo.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigwaitinfo 2 2023-10-31 "Linux man-pages 6.06" +.TH sigwaitinfo 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sigwaitinfo, sigtimedwait, rt_sigtimedwait \- synchronously wait for queued signals diff --git a/upstream/archlinux/man2/socket.2 b/upstream/archlinux/man2/socket.2 index d1ab728a..c3d43d77 100644 --- a/upstream/archlinux/man2/socket.2 +++ b/upstream/archlinux/man2/socket.2 @@ -12,7 +12,7 @@ .\" Modified 2002-07-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH socket 2 2024-01-28 "Linux man-pages 6.06" +.TH socket 2 2024-05-02 "Linux man-pages 6.8" .SH NAME socket \- create an endpoint for communication .SH LIBRARY diff --git a/upstream/archlinux/man2/socketcall.2 b/upstream/archlinux/man2/socketcall.2 index 57fbf13f..62448f75 100644 --- a/upstream/archlinux/man2/socketcall.2 +++ b/upstream/archlinux/man2/socketcall.2 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Tue Oct 22 22:11:53 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH socketcall 2 2023-10-31 "Linux man-pages 6.06" +.TH socketcall 2 2024-05-02 "Linux man-pages 6.8" .SH NAME socketcall \- socket system calls .SH LIBRARY diff --git a/upstream/archlinux/man2/socketpair.2 b/upstream/archlinux/man2/socketpair.2 index 880f9a0b..efefc7b2 100644 --- a/upstream/archlinux/man2/socketpair.2 +++ b/upstream/archlinux/man2/socketpair.2 @@ -11,7 +11,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2008-10-11, mtk: Add description of SOCK_NONBLOCK and SOCK_CLOEXEC .\" -.TH socketpair 2 2023-10-31 "Linux man-pages 6.06" +.TH socketpair 2 2024-05-02 "Linux man-pages 6.8" .SH NAME socketpair \- create a pair of connected sockets .SH LIBRARY diff --git a/upstream/archlinux/man2/splice.2 b/upstream/archlinux/man2/splice.2 index 2c44ed18..33e883b1 100644 --- a/upstream/archlinux/man2/splice.2 +++ b/upstream/archlinux/man2/splice.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH splice 2 2023-10-31 "Linux man-pages 6.06" +.TH splice 2 2024-05-02 "Linux man-pages 6.8" .SH NAME splice \- splice data to/from a pipe .SH LIBRARY diff --git a/upstream/archlinux/man2/spu_create.2 b/upstream/archlinux/man2/spu_create.2 index 9cab20ad..6604cf62 100644 --- a/upstream/archlinux/man2/spu_create.2 +++ b/upstream/archlinux/man2/spu_create.2 @@ -8,7 +8,7 @@ .\" 2007-07-10, some polishing by mtk .\" 2007-09-28, updates for newer kernels by Jeremy Kerr <jk@ozlabs.org> .\" -.TH spu_create 2 2023-10-31 "Linux man-pages 6.06" +.TH spu_create 2 2024-05-02 "Linux man-pages 6.8" .SH NAME spu_create \- create a new spu context .SH LIBRARY diff --git a/upstream/archlinux/man2/spu_run.2 b/upstream/archlinux/man2/spu_run.2 index 62762c86..53d833be 100644 --- a/upstream/archlinux/man2/spu_run.2 +++ b/upstream/archlinux/man2/spu_run.2 @@ -9,7 +9,7 @@ .\" 2007-09-28, updates for newer kernels, added example .\" by Jeremy Kerr <jk@ozlabs.org> .\" -.TH spu_run 2 2023-10-31 "Linux man-pages 6.06" +.TH spu_run 2 2024-05-02 "Linux man-pages 6.8" .SH NAME spu_run \- execute an SPU context .SH LIBRARY diff --git a/upstream/archlinux/man2/stat.2 b/upstream/archlinux/man2/stat.2 index 295d0b49..eb1c8174 100644 --- a/upstream/archlinux/man2/stat.2 +++ b/upstream/archlinux/man2/stat.2 @@ -16,7 +16,7 @@ .\" 2007-06-08 mtk: Added example program .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH stat 2 2023-10-31 "Linux man-pages 6.06" +.TH stat 2 2024-05-02 "Linux man-pages 6.8" .SH NAME stat, fstat, lstat, fstatat \- get file status .SH LIBRARY diff --git a/upstream/archlinux/man2/statfs.2 b/upstream/archlinux/man2/statfs.2 index 8b2783c4..65c8a04e 100644 --- a/upstream/archlinux/man2/statfs.2 +++ b/upstream/archlinux/man2/statfs.2 @@ -5,7 +5,7 @@ .\" Modified 2003-08-17 by Walter Harms .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH statfs 2 2023-10-31 "Linux man-pages 6.06" +.TH statfs 2 2024-05-02 "Linux man-pages 6.8" .SH NAME statfs, fstatfs \- get filesystem statistics .SH LIBRARY diff --git a/upstream/archlinux/man2/statx.2 b/upstream/archlinux/man2/statx.2 index 4174d368..2d972b97 100644 --- a/upstream/archlinux/man2/statx.2 +++ b/upstream/archlinux/man2/statx.2 @@ -8,7 +8,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH statx 2 2023-10-31 "Linux man-pages 6.06" +.TH statx 2 2024-05-02 "Linux man-pages 6.8" .SH NAME statx \- get file status (extended) .SH LIBRARY diff --git a/upstream/archlinux/man2/stime.2 b/upstream/archlinux/man2/stime.2 index 0362b687..93a9fd64 100644 --- a/upstream/archlinux/man2/stime.2 +++ b/upstream/archlinux/man2/stime.2 @@ -7,7 +7,7 @@ .\" Modified 2001-03-16 by Andries Brouwer <aeb@cwi.nl> .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH stime 2 2023-10-31 "Linux man-pages 6.06" +.TH stime 2 2024-05-02 "Linux man-pages 6.8" .SH NAME stime \- set time .SH SYNOPSIS diff --git a/upstream/archlinux/man2/subpage_prot.2 b/upstream/archlinux/man2/subpage_prot.2 index d943de48..8a0e2b85 100644 --- a/upstream/archlinux/man2/subpage_prot.2 +++ b/upstream/archlinux/man2/subpage_prot.2 @@ -7,7 +7,7 @@ .\" in Linux commit fa28237cfcc5827553044cbd6ee52e33692b0faa .\" both written by Paul Mackerras <paulus@samba.org> .\" -.TH subpage_prot 2 2023-10-31 "Linux man-pages 6.06" +.TH subpage_prot 2 2024-05-02 "Linux man-pages 6.8" .SH NAME subpage_prot \- define a subpage protection for an address range .SH LIBRARY diff --git a/upstream/archlinux/man2/swapon.2 b/upstream/archlinux/man2/swapon.2 index 4db52438..7d7fe41b 100644 --- a/upstream/archlinux/man2/swapon.2 +++ b/upstream/archlinux/man2/swapon.2 @@ -22,7 +22,7 @@ .\" Author: Rafael Aquini <aquini@redhat.com> .\" Date: Wed Jul 3 15:02:46 2013 -0700 .\" -.TH swapon 2 2023-12-22 "Linux man-pages 6.06" +.TH swapon 2 2024-05-02 "Linux man-pages 6.8" .SH NAME swapon, swapoff \- start/stop swapping to file/device .SH LIBRARY diff --git a/upstream/archlinux/man2/symlink.2 b/upstream/archlinux/man2/symlink.2 index d7b9548e..22981341 100644 --- a/upstream/archlinux/man2/symlink.2 +++ b/upstream/archlinux/man2/symlink.2 @@ -10,7 +10,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH symlink 2 2023-10-31 "Linux man-pages 6.06" +.TH symlink 2 2024-05-02 "Linux man-pages 6.8" .SH NAME symlink, symlinkat \- make a new name for a file .SH LIBRARY diff --git a/upstream/archlinux/man2/sync.2 b/upstream/archlinux/man2/sync.2 index 20975794..671ab6a4 100644 --- a/upstream/archlinux/man2/sync.2 +++ b/upstream/archlinux/man2/sync.2 @@ -13,7 +13,7 @@ .\" Modified 2001-10-10 by aeb, following Michael Kerrisk. .\" 2011-09-07, mtk, Added syncfs() documentation, .\" -.TH sync 2 2023-10-31 "Linux man-pages 6.06" +.TH sync 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sync, syncfs \- commit filesystem caches to disk .SH LIBRARY diff --git a/upstream/archlinux/man2/sync_file_range.2 b/upstream/archlinux/man2/sync_file_range.2 index a051178c..2466a681 100644 --- a/upstream/archlinux/man2/sync_file_range.2 +++ b/upstream/archlinux/man2/sync_file_range.2 @@ -7,7 +7,7 @@ .\" Andrew Morton's comments in fs/sync.c .\" 2010-10-09, mtk, Document sync_file_range2() .\" -.TH sync_file_range 2 2023-10-31 "Linux man-pages 6.06" +.TH sync_file_range 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sync_file_range \- sync a file segment with disk .SH LIBRARY diff --git a/upstream/archlinux/man2/syscall.2 b/upstream/archlinux/man2/syscall.2 index 80df9e72..3773098c 100644 --- a/upstream/archlinux/man2/syscall.2 +++ b/upstream/archlinux/man2/syscall.2 @@ -12,7 +12,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added mips and arm64. .\" -.TH syscall 2 2023-10-31 "Linux man-pages 6.06" +.TH syscall 2 2024-05-02 "Linux man-pages 6.8" .SH NAME syscall \- indirect system call .SH LIBRARY @@ -347,6 +347,7 @@ architectures may indiscriminately clobber other registers not listed here. #define _GNU_SOURCE #include <signal.h> #include <sys/syscall.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/syscalls.2 b/upstream/archlinux/man2/syscalls.2 index 97293c27..d9931877 100644 --- a/upstream/archlinux/man2/syscalls.2 +++ b/upstream/archlinux/man2/syscalls.2 @@ -9,7 +9,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH syscalls 2 2024-01-16 "Linux man-pages 6.06" +.TH syscalls 2 2024-05-02 "Linux man-pages 6.8" .SH NAME syscalls \- Linux system calls .SH SYNOPSIS @@ -324,7 +324,9 @@ T} \fBgetpeername\fP(2) 2.0 T{ See notes on \fBsocketcall\fP(2) T} -\fBgetpagesize\fP(2) 2.0 Not on x86 +\fBgetpagesize\fP(2) 2.0 T{ +Alpha, SPARC/SPARC64 only +T} \fBgetpgid\fP(2) 1.0 \fBgetpgrp\fP(2) 1.0 \fBgetpid\fP(2) 1.0 @@ -467,7 +469,9 @@ T} \fBname_to_handle_at\fP(2) 2.6.39 \fBnanosleep\fP(2) 2.0 .\" 5590ff0d5528b60153c0b4e7b771472b5a95e297 -\fBnewfstatat\fP(2) 2.6.16 See \fBstat\fP(2) +\fBnewfstatat\fP(2) 2.6.16 T{ +See \fBstat\fP(2) +T} \fBnfsservctl\fP(2) 2.2 Removed in 3.1 \fBnice\fP(2) 1.0 \fBold_adjtimex\fP(2) 2.0 T{ @@ -675,8 +679,7 @@ T} \fBsetns\fP(2) 3.0 \fBsetpgid\fP(2) 1.0 \fBsetpgrp\fP(2) 2.0 T{ -Alternative name for -\fBsetpgid\fP(2) on Alpha +Alternative name for \fBsetpgid\fP(2) on Alpha T} \fBsetpriority\fP(2) 1.0 \fBsetregid\fP(2) 1.0 @@ -985,7 +988,7 @@ details such as the size of their arguments. the glibc wrapper functions do some work to ensure that the right system call is invoked, and that ABI compatibility is preserved for old binaries.) -Examples of systems calls that exist in multiple versions are +Examples of system calls that exist in multiple versions are the following: .IP \[bu] 3 By now there are three different versions of diff --git a/upstream/archlinux/man2/sysctl.2 b/upstream/archlinux/man2/sysctl.2 index 7e9f185b..7f0bbcb0 100644 --- a/upstream/archlinux/man2/sysctl.2 +++ b/upstream/archlinux/man2/sysctl.2 @@ -7,7 +7,7 @@ .\" Modified Tue Oct 22 22:28:41 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Mon Jan 5 20:31:04 1998 by aeb. .\" -.TH sysctl 2 2023-10-31 "Linux man-pages 6.06" +.TH sysctl 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sysctl \- read/write system parameters .SH SYNOPSIS diff --git a/upstream/archlinux/man2/sysfs.2 b/upstream/archlinux/man2/sysfs.2 index a3ce6936..82377a9a 100644 --- a/upstream/archlinux/man2/sysfs.2 +++ b/upstream/archlinux/man2/sysfs.2 @@ -4,7 +4,7 @@ .\" .\" Created Wed Aug 9 1995 Thomas K. Dyas <tdyas@eden.rutgers.edu> .\" -.TH sysfs 2 2023-10-31 "Linux man-pages 6.06" +.TH sysfs 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sysfs \- get filesystem type information .SH SYNOPSIS diff --git a/upstream/archlinux/man2/sysinfo.2 b/upstream/archlinux/man2/sysinfo.2 index 843b4cc2..2bc1481d 100644 --- a/upstream/archlinux/man2/sysinfo.2 +++ b/upstream/archlinux/man2/sysinfo.2 @@ -12,7 +12,7 @@ .\" Modified Tue Oct 22 22:29:51 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Mon Aug 25 16:06:11 1997 by Nicolás Lichtmaier <nick@debian.org> .\" -.TH sysinfo 2 2023-10-31 "Linux man-pages 6.06" +.TH sysinfo 2 2024-05-02 "Linux man-pages 6.8" .SH NAME sysinfo \- return system information .SH LIBRARY diff --git a/upstream/archlinux/man2/syslog.2 b/upstream/archlinux/man2/syslog.2 index f544f935..f561b971 100644 --- a/upstream/archlinux/man2/syslog.2 +++ b/upstream/archlinux/man2/syslog.2 @@ -10,7 +10,7 @@ .\" 2008-02-15, Michael Kerrisk <mtk.manpages@gmail.com> .\" Update LOG_BUF_LEN details; update RETURN VALUE section. .\" -.TH syslog 2 2023-10-31 "Linux man-pages 6.06" +.TH syslog 2 2024-05-02 "Linux man-pages 6.8" .SH NAME syslog, klogctl \- read and/or clear kernel message ring buffer; set console_loglevel diff --git a/upstream/archlinux/man2/tee.2 b/upstream/archlinux/man2/tee.2 index 6dcb104b..2e28eab4 100644 --- a/upstream/archlinux/man2/tee.2 +++ b/upstream/archlinux/man2/tee.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tee 2 2023-10-31 "Linux man-pages 6.06" +.TH tee 2 2024-05-02 "Linux man-pages 6.8" .SH NAME tee \- duplicating pipe content .SH LIBRARY @@ -140,6 +140,7 @@ Tue Oct 28 10:06:00 CET 2014 #include <limits.h> #include <stdio.h> #include <stdlib.h> +#include <sys/types.h> #include <unistd.h> \& int diff --git a/upstream/archlinux/man2/time.2 b/upstream/archlinux/man2/time.2 index d728fa44..0b5f3e2d 100644 --- a/upstream/archlinux/man2/time.2 +++ b/upstream/archlinux/man2/time.2 @@ -6,7 +6,7 @@ .\" Modified Sat Jul 24 14:13:40 1993 by Rik Faith <faith@cs.unc.edu> .\" Additions by Joseph S. Myers <jsm28@cam.ac.uk>, 970909 .\" -.TH time 2 2023-11-11 "Linux man-pages 6.06" +.TH time 2 2024-05-02 "Linux man-pages 6.8" .SH NAME time \- get time in seconds .SH LIBRARY diff --git a/upstream/archlinux/man2/timer_create.2 b/upstream/archlinux/man2/timer_create.2 index 3afc36b5..2b139c40 100644 --- a/upstream/archlinux/man2/timer_create.2 +++ b/upstream/archlinux/man2/timer_create.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_create 2 2023-11-11 "Linux man-pages 6.06" +.TH timer_create 2 2024-05-02 "Linux man-pages 6.8" .SH NAME timer_create \- create a POSIX per-process timer .SH LIBRARY diff --git a/upstream/archlinux/man2/timer_delete.2 b/upstream/archlinux/man2/timer_delete.2 index 670e09d1..e7c99b5e 100644 --- a/upstream/archlinux/man2/timer_delete.2 +++ b/upstream/archlinux/man2/timer_delete.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_delete 2 2023-10-31 "Linux man-pages 6.06" +.TH timer_delete 2 2024-05-02 "Linux man-pages 6.8" .SH NAME timer_delete \- delete a POSIX per-process timer .SH LIBRARY diff --git a/upstream/archlinux/man2/timer_getoverrun.2 b/upstream/archlinux/man2/timer_getoverrun.2 index 68b8b27b..5724354d 100644 --- a/upstream/archlinux/man2/timer_getoverrun.2 +++ b/upstream/archlinux/man2/timer_getoverrun.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_getoverrun 2 2023-10-31 "Linux man-pages 6.06" +.TH timer_getoverrun 2 2024-05-02 "Linux man-pages 6.8" .SH NAME timer_getoverrun \- get overrun count for a POSIX per-process timer .SH LIBRARY diff --git a/upstream/archlinux/man2/timer_settime.2 b/upstream/archlinux/man2/timer_settime.2 index 064693ba..64535311 100644 --- a/upstream/archlinux/man2/timer_settime.2 +++ b/upstream/archlinux/man2/timer_settime.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_settime 2 2023-10-31 "Linux man-pages 6.06" +.TH timer_settime 2 2024-05-02 "Linux man-pages 6.8" .SH NAME timer_settime, timer_gettime \- arm/disarm and fetch state of POSIX per-process timer diff --git a/upstream/archlinux/man2/timerfd_create.2 b/upstream/archlinux/man2/timerfd_create.2 index abd5e265..782d747f 100644 --- a/upstream/archlinux/man2/timerfd_create.2 +++ b/upstream/archlinux/man2/timerfd_create.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH timerfd_create 2 2023-10-31 "Linux man-pages 6.06" +.TH timerfd_create 2 2024-05-02 "Linux man-pages 6.8" .SH NAME timerfd_create, timerfd_settime, timerfd_gettime \- timers that notify via file descriptors @@ -604,6 +604,7 @@ a.out 3 1 100 #include <stdio.h> #include <stdlib.h> #include <sys/timerfd.h> +#include <sys/types.h> #include <time.h> #include <unistd.h> \& diff --git a/upstream/archlinux/man2/times.2 b/upstream/archlinux/man2/times.2 index fa853a7c..9e43b24d 100644 --- a/upstream/archlinux/man2/times.2 +++ b/upstream/archlinux/man2/times.2 @@ -15,7 +15,7 @@ .\" Added notes on nonstandard behavior: Linux allows 'buf' to .\" be NULL, but POSIX.1 doesn't specify this and it's nonportable. .\" -.TH times 2 2023-10-31 "Linux man-pages 6.06" +.TH times 2 2024-05-02 "Linux man-pages 6.8" .SH NAME times \- get process times .SH LIBRARY diff --git a/upstream/archlinux/man2/tkill.2 b/upstream/archlinux/man2/tkill.2 index 127ee7cc..49703fb6 100644 --- a/upstream/archlinux/man2/tkill.2 +++ b/upstream/archlinux/man2/tkill.2 @@ -6,7 +6,7 @@ .\" 2004-05-31, added tgkill, ahu, aeb .\" 2008-01-15 mtk -- rewrote DESCRIPTION .\" -.TH tkill 2 2023-10-31 "Linux man-pages 6.06" +.TH tkill 2 2024-05-02 "Linux man-pages 6.8" .SH NAME tkill, tgkill \- send a signal to a thread .SH LIBRARY diff --git a/upstream/archlinux/man2/truncate.2 b/upstream/archlinux/man2/truncate.2 index 4107b7b3..b69fe3b5 100644 --- a/upstream/archlinux/man2/truncate.2 +++ b/upstream/archlinux/man2/truncate.2 @@ -12,7 +12,7 @@ .\" Modified 2002-04-06 by Andries Brouwer <aeb@cwi.nl> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH truncate 2 2023-10-31 "Linux man-pages 6.06" +.TH truncate 2 2024-05-02 "Linux man-pages 6.8" .SH NAME truncate, ftruncate \- truncate a file to a specified length .SH LIBRARY diff --git a/upstream/archlinux/man2/umask.2 b/upstream/archlinux/man2/umask.2 index f031a3ff..e96b964b 100644 --- a/upstream/archlinux/man2/umask.2 +++ b/upstream/archlinux/man2/umask.2 @@ -11,7 +11,7 @@ .\" <nick@debian.com> with Lars Wirzenius <liw@iki.fi> suggestion .\" 2006-05-13, mtk, substantial rewrite of description of 'mask' .\" 2008-01-09, mtk, a few rewrites and additions. -.TH umask 2 2023-10-31 "Linux man-pages 6.06" +.TH umask 2 2024-05-02 "Linux man-pages 6.8" .SH NAME umask \- set file mode creation mask .SH LIBRARY diff --git a/upstream/archlinux/man2/umount.2 b/upstream/archlinux/man2/umount.2 index 85a37b7d..5ded249a 100644 --- a/upstream/archlinux/man2/umount.2 +++ b/upstream/archlinux/man2/umount.2 @@ -7,7 +7,7 @@ .\" 2008-10-06, mtk: Created this as a new page by splitting .\" umount/umount2 material out of mount.2 .\" -.TH umount 2 2023-10-31 "Linux man-pages 6.06" +.TH umount 2 2024-05-02 "Linux man-pages 6.8" .SH NAME umount, umount2 \- unmount filesystem .SH LIBRARY diff --git a/upstream/archlinux/man2/uname.2 b/upstream/archlinux/man2/uname.2 index be0b1550..a25e1a09 100644 --- a/upstream/archlinux/man2/uname.2 +++ b/upstream/archlinux/man2/uname.2 @@ -4,7 +4,7 @@ .\" .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH uname 2 2023-10-31 "Linux man-pages 6.06" +.TH uname 2 2024-05-02 "Linux man-pages 6.8" .SH NAME uname \- get name and information about current kernel .SH LIBRARY diff --git a/upstream/archlinux/man2/unimplemented.2 b/upstream/archlinux/man2/unimplemented.2 index cbb61d3e..2798f3f9 100644 --- a/upstream/archlinux/man2/unimplemented.2 +++ b/upstream/archlinux/man2/unimplemented.2 @@ -4,7 +4,7 @@ .\" .\" Updated, aeb, 980612 .\" -.TH UNIMPLEMENTED 2 2023-10-31 "Linux man-pages 6.06" +.TH UNIMPLEMENTED 2 2024-05-02 "Linux man-pages 6.8" .SH NAME afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream, lock, madvise1, mpx, prof, profil, putmsg, putpmsg, security, diff --git a/upstream/archlinux/man2/unlink.2 b/upstream/archlinux/man2/unlink.2 index 3018bb10..044ef5d7 100644 --- a/upstream/archlinux/man2/unlink.2 +++ b/upstream/archlinux/man2/unlink.2 @@ -10,7 +10,7 @@ .\" Modified 2001-05-17 by aeb .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH unlink 2 2023-10-31 "Linux man-pages 6.06" +.TH unlink 2 2024-05-02 "Linux man-pages 6.8" .SH NAME unlink, unlinkat \- delete a name and possibly the file it refers to .SH LIBRARY @@ -117,7 +117,7 @@ on .IR pathname . If the .B AT_REMOVEDIR -flag is specified, then +flag is specified, it performs the equivalent of .BR rmdir (2) on diff --git a/upstream/archlinux/man2/unshare.2 b/upstream/archlinux/man2/unshare.2 index bbb15484..be7755bb 100644 --- a/upstream/archlinux/man2/unshare.2 +++ b/upstream/archlinux/man2/unshare.2 @@ -15,7 +15,7 @@ .\" by clone, which would require porting and maintaining all commands .\" such as login, and su, that establish a user session. .\" -.TH unshare 2 2023-10-31 "Linux man-pages 6.06" +.TH unshare 2 2024-05-02 "Linux man-pages 6.8" .SH NAME unshare \- disassociate parts of the process execution context .SH LIBRARY diff --git a/upstream/archlinux/man2/uselib.2 b/upstream/archlinux/man2/uselib.2 index b8f0d307..623a599a 100644 --- a/upstream/archlinux/man2/uselib.2 +++ b/upstream/archlinux/man2/uselib.2 @@ -8,7 +8,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2005-01-09 by aeb .\" -.TH uselib 2 2023-10-31 "Linux man-pages 6.06" +.TH uselib 2 2024-05-02 "Linux man-pages 6.8" .SH NAME uselib \- load shared library .SH SYNOPSIS diff --git a/upstream/archlinux/man2/userfaultfd.2 b/upstream/archlinux/man2/userfaultfd.2 index c1f60cb3..ff662367 100644 --- a/upstream/archlinux/man2/userfaultfd.2 +++ b/upstream/archlinux/man2/userfaultfd.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH userfaultfd 2 2024-02-12 "Linux man-pages 6.06" +.TH userfaultfd 2 2024-05-02 "Linux man-pages 6.8" .SH NAME userfaultfd \- create a file descriptor for handling page faults in user space .SH LIBRARY diff --git a/upstream/archlinux/man2/ustat.2 b/upstream/archlinux/man2/ustat.2 index f7a8c648..7d82a382 100644 --- a/upstream/archlinux/man2/ustat.2 +++ b/upstream/archlinux/man2/ustat.2 @@ -7,7 +7,7 @@ .\" Modified 2001-03-22 by aeb .\" Modified 2003-08-04 by aeb .\" -.TH ustat 2 2023-10-31 "Linux man-pages 6.06" +.TH ustat 2 2024-05-02 "Linux man-pages 6.8" .SH NAME ustat \- get filesystem statistics .SH LIBRARY diff --git a/upstream/archlinux/man2/utime.2 b/upstream/archlinux/man2/utime.2 index 7ba1a396..5338951b 100644 --- a/upstream/archlinux/man2/utime.2 +++ b/upstream/archlinux/man2/utime.2 @@ -8,7 +8,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2004-10-10 by Andries Brouwer <aeb@cwi.nl> .\" -.TH utime 2 2023-10-31 "Linux man-pages 6.06" +.TH utime 2 2024-05-02 "Linux man-pages 6.8" .SH NAME utime, utimes \- change file last access and modification times .SH LIBRARY diff --git a/upstream/archlinux/man2/utimensat.2 b/upstream/archlinux/man2/utimensat.2 index a91e5915..359db994 100644 --- a/upstream/archlinux/man2/utimensat.2 +++ b/upstream/archlinux/man2/utimensat.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH utimensat 2 2024-01-01 "Linux man-pages 6.06" +.TH utimensat 2 2024-05-02 "Linux man-pages 6.8" .SH NAME utimensat, futimens \- change file timestamps with nanosecond precision .SH LIBRARY diff --git a/upstream/archlinux/man2/vfork.2 b/upstream/archlinux/man2/vfork.2 index 6175ea1c..752a0a6c 100644 --- a/upstream/archlinux/man2/vfork.2 +++ b/upstream/archlinux/man2/vfork.2 @@ -6,7 +6,7 @@ .\" 1999-11-10: Merged text taken from the page contributed by .\" Reed H. Petty (rhp@draper.net) .\" -.TH vfork 2 2023-10-31 "Linux man-pages 6.06" +.TH vfork 2 2024-05-02 "Linux man-pages 6.8" .SH NAME vfork \- create a child process and block parent .SH LIBRARY diff --git a/upstream/archlinux/man2/vhangup.2 b/upstream/archlinux/man2/vhangup.2 index 31612479..6a67b432 100644 --- a/upstream/archlinux/man2/vhangup.2 +++ b/upstream/archlinux/man2/vhangup.2 @@ -5,7 +5,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH vhangup 2 2023-10-31 "Linux man-pages 6.06" +.TH vhangup 2 2024-05-02 "Linux man-pages 6.8" .SH NAME vhangup \- virtually hangup the current terminal .SH LIBRARY diff --git a/upstream/archlinux/man2/vm86.2 b/upstream/archlinux/man2/vm86.2 index 93747159..a542c040 100644 --- a/upstream/archlinux/man2/vm86.2 +++ b/upstream/archlinux/man2/vm86.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH vm86 2 2023-10-31 "Linux man-pages 6.06" +.TH vm86 2 2024-05-02 "Linux man-pages 6.8" .SH NAME vm86old, vm86 \- enter virtual 8086 mode .SH LIBRARY diff --git a/upstream/archlinux/man2/vmsplice.2 b/upstream/archlinux/man2/vmsplice.2 index 81a6d2f1..47507e69 100644 --- a/upstream/archlinux/man2/vmsplice.2 +++ b/upstream/archlinux/man2/vmsplice.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH vmsplice 2 2023-10-31 "Linux man-pages 6.06" +.TH vmsplice 2 2024-05-02 "Linux man-pages 6.8" .SH NAME vmsplice \- splice user pages to/from a pipe .SH LIBRARY diff --git a/upstream/archlinux/man2/wait.2 b/upstream/archlinux/man2/wait.2 index f9d519d5..d4281c07 100644 --- a/upstream/archlinux/man2/wait.2 +++ b/upstream/archlinux/man2/wait.2 @@ -26,7 +26,7 @@ .\" 2005-05-10, mtk, __W* flags can't be used with waitid() .\" 2008-07-04, mtk, removed erroneous text about SA_NOCLDSTOP .\" -.TH wait 2 2023-10-31 "Linux man-pages 6.06" +.TH wait 2 2024-05-02 "Linux man-pages 6.8" .SH NAME wait, waitpid, waitid \- wait for process to change state .SH LIBRARY @@ -661,6 +661,7 @@ $ #include <stdint.h> #include <stdio.h> #include <stdlib.h> +#include <sys/types.h> #include <sys/wait.h> #include <unistd.h> \& diff --git a/upstream/archlinux/man2/wait4.2 b/upstream/archlinux/man2/wait4.2 index 2772ebd7..9096527b 100644 --- a/upstream/archlinux/man2/wait4.2 +++ b/upstream/archlinux/man2/wait4.2 @@ -10,7 +10,7 @@ .\" Rewrote much of this page, and removed much duplicated text, .\" replacing with pointers to wait.2 .\" -.TH wait4 2 2023-10-31 "Linux man-pages 6.06" +.TH wait4 2 2024-05-02 "Linux man-pages 6.8" .SH NAME wait3, wait4 \- wait for process to change state, BSD style .SH LIBRARY diff --git a/upstream/archlinux/man2/write.2 b/upstream/archlinux/man2/write.2 index b94305e1..cbcfeed6 100644 --- a/upstream/archlinux/man2/write.2 +++ b/upstream/archlinux/man2/write.2 @@ -16,7 +16,7 @@ .\" gave some examples of why this might occur. .\" Noted what happens if write() is interrupted by a signal. .\" -.TH write 2 2023-10-31 "Linux man-pages 6.06" +.TH write 2 2024-05-02 "Linux man-pages 6.8" .SH NAME write \- write to a file descriptor .SH LIBRARY |