man/man2/: HISTORY, STANDARDS: Update history of system calls CI-G
On Wed, Jan 21, 2026 at 12:06:52PM +0000, Seth McDonald wrote:
> This patch set updates the POSIX/SUS history of system calls with
> identifiers starting with CI through G. It also attempts to provide
> chronological order where possible, similar to the last patch set.
Seth McDonald [Thu, 22 Jan 2026 02:26:05 +0000 (02:26 +0000)]
man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)
gettimeofday(2) first appeared in SUSv1.[1] The function was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 275.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p.
567.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/gettimeofday.html>
Seth McDonald [Thu, 22 Jan 2026 02:26:01 +0000 (02:26 +0000)]
man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2)
getrusage(2) first appeared in SUSv1.[1] The function was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 271.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
554-555.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getrusage.html>
Seth McDonald [Thu, 22 Jan 2026 02:25:57 +0000 (02:25 +0000)]
man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2)
getsid(2) first appeared in SUSv1.[1] The function was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2] Then POSIX.1-2008 added it to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 273.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p.
558.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getsid.html>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", p.
1073.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/getsid.html>
Seth McDonald [Thu, 22 Jan 2026 02:25:52 +0000 (02:25 +0000)]
man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)
getrlimit(2) and setrlimit(2) first appeared in SUSv1.[1] The functions
were added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI
extension (still SUS-only).[2] Then POSIX.1-2024 added them to the base
specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 269-270.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
551-553.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getrlimit.html>
[3] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp.
1176-1179.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getrlimit.html>
Seth McDonald [Thu, 22 Jan 2026 02:25:44 +0000 (02:25 +0000)]
man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2)
getpriority(2) and setpriority(2) first appeared in SUSv1.[1] The
functions were added to POSIX.1-2001 when POSIX and SUS merged, but as
an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 262-263.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
540-542.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getpriority.html>
Seth McDonald [Thu, 22 Jan 2026 02:25:08 +0000 (02:25 +0000)]
man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2)
fsync(2) first appeared in SUSv1.[1] The function was then added to
POSIX.1-1996.[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 214.
[2] ISO/IEC 9945-1:1996, Section 6.6.1 "Synchronize the State of a
File".
Seth McDonald [Thu, 22 Jan 2026 02:24:28 +0000 (02:24 +0000)]
man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
clock_getres(2), clock_gettime(2), and clock_settime(2) first appeared
in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is
redundant.
Jeff Layton [Sun, 18 Jan 2026 15:42:37 +0000 (16:42 +0100)]
man/man2const/F_[SG]ETDELEG.2const, man/man2/fcntl.2: Document F_SETDELEG and F_GETDELEG
With Linux 6.19, userland will be able to request a delegation on a file
or directory. These new objects act a lot like file leases, but are
based on NFSv4 file and directory delegations.
Add new F_GETDELEG and F_SETDELEG manpages to document them.
Signed-off-by: Jeff Layton <jlayton@kernel.org>
[alx: minor tweaks] Signed-off-by: Alejandro Colomar <alx@kernel.org>
Message-ID: <5b283a25dbe2ab9ed78719c132885d9d3157f2bb.1768750908.git.alx@kernel.org> Reviewed-by: Jeff Layton <jlayton@kernel.org>
Message-ID: <a0916b361406fa52771cf3dd507521fa1cc31d7c.camel@kernel.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man2/*: HISTORY: Update history of syscalls A-CH
On Mon, Jan 19, 2026 at 11:54:29AM +0000, Seth McDonald wrote:
> Continuing the updating of HISTORY sections, this patch set regards
> system calls whose identifiers start with A through CH. This time,
> more care was taken to ensure any modified lists are given in a
> somewhat chronological order.
>
> As hinted at previously on this [mailing] list, searching for a
> *truely* chronological ordering is likely a futile effort given the
> seemingly circular influences between many early systems. But an
> approximation of this ordering based on our limited information can
> still be useful. Which is the attitude with which these patches were
> made.
Seth McDonald [Mon, 19 Jan 2026 11:58:35 +0000 (11:58 +0000)]
man/man2/chroot.2: HISTORY: Update first SUS appearance of chroot(2)
chroot(2) first appeared in SUSv1 with the 'TO BE WITHDRAWN' marking.[1]
It was given this marking because "[t]here is no portable use that an
application could make of this interface."
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 88-89.
Seth McDonald [Mon, 19 Jan 2026 11:58:25 +0000 (11:58 +0000)]
man/man2/chown.2: HISTORY: Update first POSIX appearance of lchown(2)
lchown(2) first appeared in SUSv1.[1] The function was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2] Then POSIX.1-2008 added it to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 349.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p.
671.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/lchown.html>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", pp.
1206-1208.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/lchown.html>
Seth McDonald [Mon, 19 Jan 2026 11:56:20 +0000 (11:56 +0000)]
man/man2/chdir.2: HISTORY: Update first POSIX appearance of fchdir(2)
fchdir(2) first appeared in SUSv1.[1] The function was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2] Then POSIX.1-2008 added it to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 143.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p.
320.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/fchdir.html>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", p.
798.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/fchdir.html>
Seth McDonald [Mon, 19 Jan 2026 06:57:08 +0000 (06:57 +0000)]
man/man3type/time_t.3type: HISTORY: wfix
There are two more lines which were part of the paragraph that the
listed commit removed. On their own, they do not form a complete
sentence. So remove the missed two lines.
Günther Noack [Tue, 13 Jan 2026 19:20:53 +0000 (20:20 +0100)]
man/man7/landlock.7: Filesystem actions: Re-group description of IOCTL access right
Move the description of the LANDLOCK_ACCESS_FS_IOCTL_DEV access right
together with the file access rights.
This group of access rights applies to files (in this case device
files), and they can be added to file or directory inodes using
landlock_add_rule(2). The check for that works the same for all file
access rights, including LANDLOCK_ACCESS_FS_IOCTL_DEV.
Invoking ioctl(2) on directory FDs can not currently be restricted
with Landlock. Having it grouped separately in the documentation is a
remnant from earlier revisions of the LANDLOCK_ACCESS_FS_IOCTL_DEV
patch set.
The same change was also done in kernel documentation, linked below.
Seth McDonald [Sat, 10 Jan 2026 06:15:20 +0000 (16:15 +1000)]
man/man3type/stat.3type: HISTORY: Specify initial datatypes of .st_{blksize,blocks}
The st_blksize and st_blocks fields of the stat(3type) structure were
both specified as 'long' integers in SUSv1.[1] SUSv2 then changed them
to blksize_t(3type) and blkcnt_t(3type), respectively.[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 4 "Headers", p. 830.
[2] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1169.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/sysstat.h.html>
Seth McDonald [Sat, 10 Jan 2026 06:15:19 +0000 (16:15 +1000)]
man/man3type/stat.3type: HISTORY: Update first POSIX appearance of .st_{rdev,blksize,blocks}
The st_rdev, st_blksize, and st_blocks fields of the stat(3type)
structure first appeared in SUSv1.[1] They were added to POSIX.1-2001
when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 4 "Headers", p. 830.
[2] IEEE Std 1003.1-2001, Volume 1, Chapter 13 "Headers", p. 356.
<https://pubs.opengroup.org/onlinepubs/009604499/basedefs/sys/stat.h.html>
Seth McDonald [Fri, 9 Jan 2026 06:40:40 +0000 (16:40 +1000)]
man/man3type/wchar_t.3type: HISTORY: Update first SUS appearance of WCHAR_M{AX,IN}
WCHAR_MAX and WCHAR_MIN first appeared in SUSv2.[1]
[1] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1213.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/wchar.h.html>
Seth McDonald [Fri, 9 Jan 2026 06:40:34 +0000 (16:40 +1000)]
man/man3type/time_t.3type: HISTORY: Update first POSIX appearance of useconds_t(3type)
useconds_t(3type) first appeared in SUSv1.[1] The type was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 4 "Headers", p. 838.
[2] IEEE Std 1003.1-2001, Volume 1, Chapter 13 "Headers", p. 367.
<https://pubs.opengroup.org/onlinepubs/009604499/basedefs/sys/types.h.html>
Seth McDonald [Fri, 9 Jan 2026 06:40:33 +0000 (16:40 +1000)]
man/man3type/time_t.3type: HISTORY: Update first POSIX appearance of suseconds_t(3type)
suseconds_t(3type) first appeared in SUSv2.[1] The type was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2] Then POSIX.1-2024 added it to the base specification.[3]
[1] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1177.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/systypes.h.html>
[2] IEEE Std 1003.1-2001, Volume 1, Chapter 13 "Headers", p. 367.
<https://pubs.opengroup.org/onlinepubs/009604499/basedefs/sys/types.h.html>
[3] IEEE Std 1003.1-2024, Volume 1, Chapter 14 "Headers", p. 426.
<https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_types.h.html>
Seth McDonald [Fri, 9 Jan 2026 06:40:29 +0000 (16:40 +1000)]
man/man3type/mbstate_t.3type: HISTORY: Update first SUS appearance of mbstate_t(3type)
mbstate_t(3type) first appeared in SUSv2.[1]
[1] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1212.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/wchar.h.html>
Seth McDonald [Fri, 9 Jan 2026 06:40:23 +0000 (16:40 +1000)]
man/man3type/intptr_t.3type: HISTORY: Update first POSIX appearance of [U]INTPTR_MAX and INTPTR_MIN
INTPTR_MAX, UINTPTR_MAX, and INTPTR_MIN are defined if and only if
intptr_t(3type) and uintptr_t(3type) are declared.[1] So given that the
types are only mandatory on XSI-conformant systems, the same is true for
the macros.
Seth McDonald [Fri, 9 Jan 2026 06:40:22 +0000 (16:40 +1000)]
man/man3type/intptr_t.3type: HISTORY: Update first POSIX appearance of [u]intptr_t(3type)
intptr_t(3type) and uintptr_t(3type) first appeared in SUSv2.[1] The
types were added to POSIX.1-2001 when POSIX and SUS merged, but are only
mandatory on XSI-conformant systems.[2]
[1] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1089.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/inttypes.h.html>
[2] IEEE Std 1003.1-2001, Volume 1, Chapter 13 "Headers", p. 316.
<https://pubs.opengroup.org/onlinepubs/009604499/basedefs/stdint.h.html>
Seth McDonald [Fri, 9 Jan 2026 06:40:20 +0000 (16:40 +1000)]
man/man3type/id_t.3type: HISTORY: Update first POSIX appearance of id_t(3type)
id_t(3type) first appeared in SUSv1.[1] The type was added to
POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still
SUS-only).[2] Then POSIX.1-2008 moved it to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 4 "Headers", p. 838.
[2] IEEE Std 1003.1-2001, Volume 1, Chapter 13 "Headers", p. 366.
<https://pubs.opengroup.org/onlinepubs/009604499/basedefs/sys/types.h.html>
[3] IEEE Std 1003.1-2008, Volume 1, Chapter 13 "Headers", p. 398.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/basedefs/sys_types.h.html>
Seth McDonald [Thu, 8 Jan 2026 03:03:12 +0000 (13:03 +1000)]
man/man3type/stat.3type: SYNOPSIS: wfix
When the VERSIONS section was renamed to HISTORY, the reference to the
VERSIONS section in the SYNOPSIS was not removed. Change the comment to
refer to the HISTORY section.
Seth McDonald [Tue, 6 Jan 2026 07:08:04 +0000 (17:08 +1000)]
man/man3type/intN_t.3type: HISTORY: Update first SUS appearance of [u]intN_t(3type)
The [u]intN_t(3type) types, for N ∈ {8,16,32,64}, first appeared in
SUSv2 under the <inttypes.h> header.[1]
[1] CAE Specification, System Interfaces and Headers, Issue 5, Chapter 4
"Headers", p. 1089.
<https://pubs.opengroup.org/onlinepubs/7908799/xsh/inttypes.h.html>
projects / thirdparty / man-pages.git / log
