]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
3 months agoman/man3/string.3: Remove index(3) and rindex(3)
Alejandro Colomar [Wed, 25 Feb 2026 18:25:16 +0000 (19:25 +0100)] 
man/man3/string.3: Remove index(3) and rindex(3)

They're deprecated; their own manual page is enough.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/style/c: Split subsections
Alejandro Colomar [Wed, 25 Feb 2026 15:50:12 +0000 (16:50 +0100)] 
CONTRIBUTING.d/style/c: Split subsections

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/style/c: Add 'Alignment' subsection
Alejandro Colomar [Wed, 25 Feb 2026 11:46:24 +0000 (12:46 +0100)] 
CONTRIBUTING.d/style/c: Add 'Alignment' subsection

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/style/c: Use tabs for indentation
Alejandro Colomar [Wed, 25 Feb 2026 11:39:36 +0000 (12:39 +0100)] 
CONTRIBUTING.d/style/c: Use tabs for indentation

I'm going to eventually convert everything to tabs.  It's simpler, and
it allows me to paste code directly to the examples.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoetc/shellcheck/shellcheckrc, share/mk/: Move exception to shellcheckrc
Alejandro Colomar [Tue, 24 Feb 2026 13:33:53 +0000 (14:33 +0100)] 
etc/shellcheck/shellcheckrc, share/mk/: Move exception to shellcheckrc

Fixes: 78488ed5ccbb (2025-11-06; "share/mk/: $SHELLCHECKFLAGS: Disable SC2028")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/s390_guarded_storage.2: HISTORY: ffix
Seth McDonald [Sun, 22 Feb 2026 10:12:15 +0000 (20:12 +1000)] 
man/man2/s390_guarded_storage.2: HISTORY: ffix

Signed-off-by: Seth McDonald <dev@sethm.id.au>
Message-ID: <464d2acd9d6246ae40849738f6b5ff6151ae9e97.1771750388.git.dev@sethm.id.au>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/readv.2: HISTORY: ffix
Seth McDonald [Sun, 22 Feb 2026 10:12:14 +0000 (20:12 +1000)] 
man/man2/readv.2: HISTORY: ffix

Signed-off-by: Seth McDonald <dev@sethm.id.au>
Message-ID: <f336517a9084b23f49da379a4d2a73f7a86c2e32.1771750388.git.dev@sethm.id.au>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/process_madvise.2: HISTORY: ffix
Seth McDonald [Sun, 22 Feb 2026 10:12:13 +0000 (20:12 +1000)] 
man/man2/process_madvise.2: HISTORY: ffix

Signed-off-by: Seth McDonald <dev@sethm.id.au>
Message-ID: <e0ecd2307cf922ec0a7ad34d6524f0a62bfc67e0.1771750388.git.dev@sethm.id.au>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/perfmonctl.2: HISTORY: wfix
Seth McDonald [Sun, 22 Feb 2026 10:12:12 +0000 (20:12 +1000)] 
man/man2/perfmonctl.2: HISTORY: wfix

Signed-off-by: Seth McDonald <dev@sethm.id.au>
Message-ID: <5be05e964e1443e036e18acbb8c497052d524259.1771750388.git.dev@sethm.id.au>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/open_tree.2: HISTORY: ffix
Seth McDonald [Sun, 22 Feb 2026 10:12:11 +0000 (20:12 +1000)] 
man/man2/open_tree.2: HISTORY: ffix

Signed-off-by: Seth McDonald <dev@sethm.id.au>
Message-ID: <3b27c0e095e33180f26181043f64f1a52a6066e8.1771750388.git.dev@sethm.id.au>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/: Use strnul(3) where suitable
Alejandro Colomar [Sun, 22 Feb 2026 16:31:59 +0000 (17:31 +0100)] 
man/man3/: Use strnul(3) where suitable

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/: Use streq(3) where suitable
Alejandro Colomar [Sun, 22 Feb 2026 16:17:56 +0000 (17:17 +0100)] 
man/: Use streq(3) where suitable

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/strnul.3: SYNOPSIS: Document that it's a const-generic API
Alejandro Colomar [Sun, 22 Feb 2026 13:34:36 +0000 (14:34 +0100)] 
man/man3/strnul.3: SYNOPSIS: Document that it's a const-generic API

Document it as two overloads (C++-style).

Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Suggested-by: Bruno Haible <bruno@clisp.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/strnul.3: New page
Alejandro Colomar [Sat, 21 Feb 2026 15:00:25 +0000 (16:00 +0100)] 
man/man3/strnul.3: New page

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/futex_waitv.2: Move text from ERRORS to DESCRIPTION
Alejandro Colomar [Wed, 18 Feb 2026 22:05:18 +0000 (23:05 +0100)] 
man/man2/futex_waitv.2: Move text from ERRORS to DESCRIPTION

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/futex_waitv.2: NOTES: Remove section
Alejandro Colomar [Wed, 18 Feb 2026 21:57:58 +0000 (22:57 +0100)] 
man/man2/futex_waitv.2: NOTES: Remove section

The previous commit made it redundant; I forgot to remove it then.

Fixes: eb7620b01fce (2026-02-18; "man/man2/futex_waitv.2: Move text from ERRORS to DESCRIPTION")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/futex_waitv.2: Move text from ERRORS to DESCRIPTION
Alejandro Colomar [Wed, 18 Feb 2026 21:23:12 +0000 (22:23 +0100)] 
man/man2/futex_waitv.2: Move text from ERRORS to DESCRIPTION

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoshare/mk/: $CLANG_CFLAGS: -Wno-pre-c11-compat, -Wno-atomic-implicit-seq-cst
Alejandro Colomar [Tue, 17 Feb 2026 15:41:31 +0000 (16:41 +0100)] 
share/mk/: $CLANG_CFLAGS: -Wno-pre-c11-compat, -Wno-atomic-implicit-seq-cst

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/futex_waitv.2: New page
наб [Tue, 17 Feb 2026 14:31:29 +0000 (15:31 +0100)] 
man/man2/futex_waitv.2: New page

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <y2tytznhy5c6grvzvtw7px3a3qmj2u7evwaax4qzc2lf44sawd@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mincore.2: HISTORY: Update appearances of mincore(2)
Seth McDonald [Mon, 16 Feb 2026 11:45:30 +0000 (21:45 +1000)] 
man/man2/mincore.2: HISTORY: Update appearances of mincore(2)

mincore(2) was implemented in FreeBSD on 1995-10-21,[1] and was first
included in the FreeBSD 2.2 release on 1997-03.[2]

It was implemented in NetBSD on 1999-06-15,[3] and was first included in
the NetBSD 1.5 release on 2000-12-06,[4] (despite the commit message
stating its intended inclusion in NetBSD 1.4.1).

It was implemented in OpenBSD on 2001-03-09,[5] and was first included
in the OpenBSD 2.9 release on 2001-06-01.[6]

All other listed systems are taken at face value and rearranged in
chronological-ish order.

[1] Dyson, John (21 Oct 1995).  "Implement mincore system call."
FreeBSD source tree (Git repository).  Commit
02c04a2f6c83ee28ed637d120296d04da8f03372.
[2] The FreeBSD Project (29 Nov 2025).  "Prior Releases – EOL".
<https://www.freebsd.org/releases>
[3] Thorpe, Jason (15 Jun 1999).  "Several changes, developed and tested
concurrently:".  NetBSD src (CVS repository).
<https://cvsweb.netbsd.org/bsdweb.cgi/src/sys/uvm/uvm_mmap.c?rev=1.22>
[4] The NetBSD Foundation (2026).  "History of NetBSD releases".
<https://www.netbsd.org/releases/formal.html>
[5] art (9 Mar 2001).  "More syncing to NetBSD."  OpenBSD src (CVS
repository).
<https://cvsweb.openbsd.org/src/sys/uvm/uvm_mmap.c?rev=1.7&content-type=text/x-cvsweb-markup>
[6] de Raadt, Theo (1 Jun 2001).  "OpenBSD 2.9".
<https://www.openbsd.org/29.html>

Signed-off-by: Seth McDonald <dev@sethm.id.au>
Message-ID: <b1b6f011a7d36cda53abe8c561da44bff08d381b.1771232583.git.dev@sethm.id.au>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/: Document and use wN length modifier for printf(3) and scanf(3)
Alejandro Colomar [Sun, 15 Feb 2026 23:59:20 +0000 (00:59 +0100)] 
man/: Document and use wN length modifier for printf(3) and scanf(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/: EXAMPLES: Use consistent syntax for forever loops
Alejandro Colomar [Sat, 14 Feb 2026 19:43:35 +0000 (20:43 +0100)] 
man/: EXAMPLES: Use consistent syntax for forever loops

'for (;;)' is the most common spelling:

$ grep -rn 'while (true)' man/
$ grep -rn 'while (1)' man/ | wc -l
6
$ grep -rn 'for (;;)' man/ | wc -l
23

I also personally happen to like it most, mentally reading it as
'for ever'.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoStart of man-pages-NEXT: Move Changes to Changes.old
Alejandro Colomar [Wed, 11 Feb 2026 18:03:41 +0000 (19:03 +0100)] 
Start of man-pages-NEXT: Move Changes to Changes.old

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months ago*/: Say GNU+Linux instead of GNU/Linux
Alejandro Colomar [Wed, 11 Feb 2026 17:04:15 +0000 (18:04 +0100)] 
*/: Say GNU+Linux instead of GNU/Linux

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agolsm: Released 6.17
Alejandro Colomar [Wed, 11 Feb 2026 17:00:56 +0000 (18:00 +0100)] 
lsm: Released 6.17

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoChanges: Ready for 6.17 man-pages-6.17
Alejandro Colomar [Wed, 11 Feb 2026 16:47:02 +0000 (17:47 +0100)] 
Changes: Ready for 6.17

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoREADME.d/deps: Document gpg/gpg
Alejandro Colomar [Wed, 11 Feb 2026 13:57:35 +0000 (14:57 +0100)] 
README.d/deps: Document gpg/gpg

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/: HISTORY, STANDARDS: Update history of syscalls H-M
Alejandro Colomar [Wed, 11 Feb 2026 00:00:15 +0000 (01:00 +0100)] 
man/man2/: HISTORY, STANDARDS: Update history of syscalls H-M

On 2026-01-26T12:28:10+0000, Seth McDonald wrote:
> This set updates the history of system calls H to M.
>
> While I have been thorough with my research, I would encourage those
> interested to double-check that my edits make sense given the listed
> sources.  Particularly for linkat(2), SEEK_DATA/SEEK_HOLE, mkdirat(2),
> and mincore(2), since they took significantly more time and research
> than other functions.

Co-authored-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <cover.1769429341.git.sethmcmail@pm.me>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/msync.2: HISTORY: Update POSIX appearances of msync(2)
Seth McDonald [Mon, 26 Jan 2026 12:30:25 +0000 (12:30 +0000)] 
man/man2/msync.2: HISTORY: Update POSIX appearances of msync(2)

msync(2) 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", pp. 412-413.
[2] ISO/IEC 9945-1:1996, Section 12.2.4 "Memory Object Synchronization".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <d106bca86ec14c722b31febfaae0bdea6afbd8b2.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/msgop.2: STANDARDS, HISTORY: Update POSIX appearances of msg{rcv,snd}(2)
Seth McDonald [Mon, 26 Jan 2026 12:30:21 +0000 (12:30 +0000)] 
man/man2/msgop.2: STANDARDS, HISTORY: Update POSIX appearances of msg{rcv,snd}(2)

msgrcv(2) and msgsnd(2) 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][3]  And they remain as an XSI extension in
POSIX.1-2024.[4][5]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 408-411.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
806-808.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/msgrcv.html>
[3] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
809-811.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/msgsnd.html>
[4] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp.
1475-1477.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/msgrcv.html>
[5] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp.
1478-1480.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/msgsnd.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <86e7c24b14286fe05108c623d61d93106f9c9209.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/msgget.2: STANDARDS, HISTORY: Update POSIX appearances of msgget(2)
Seth McDonald [Mon, 26 Jan 2026 12:30:16 +0000 (12:30 +0000)] 
man/man2/msgget.2: STANDARDS, HISTORY: Update POSIX appearances of msgget(2)

msgget(2) 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]
And it remains an XSI extension in POSIX.1-2024.[3]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 406-407.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
804-805.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/msgget.html>
[3] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp.
1473-1474.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/msgget.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <975e61bea29f1b03d0d95fa9ea707938ee32c4f0.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/msgctl.2: STANDARDS, HISTORY: Update POSIX appearances of msgctl(2)
Seth McDonald [Mon, 26 Jan 2026 12:30:11 +0000 (12:30 +0000)] 
man/man2/msgctl.2: STANDARDS, HISTORY: Update POSIX appearances of msgctl(2)

msgctl(2) 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]
And it remains an XSI extension in POSIX.1-2024.[3]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 404-405.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
802-803.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/msgctl.html>
[3] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp.
1471-1472.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/msgctl.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <024ce32c9da51aa6da991b55ffcc3d72a9aaaa55.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mprotect.2: HISTORY: Update POSIX appearances of mprotect(2)
Seth McDonald [Mon, 26 Jan 2026 12:30:07 +0000 (12:30 +0000)] 
man/man2/mprotect.2: HISTORY: Update POSIX appearances of mprotect(2)

mprotect(2) 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. 402.
[2] ISO/IEC 9945-1:1996, Section 12.2.3 "Change Memory Protection".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <4e1acc0f5e001c3b51af8750f61d25387154e750.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/{mount_setattr,move_mount}.2: HISTORY: ffix
Seth McDonald [Mon, 26 Jan 2026 12:30:01 +0000 (12:30 +0000)] 
man/man2/{mount_setattr,move_mount}.2: HISTORY: ffix

Commas are more consistent with other man pages.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <b8f4e6fa54e7ebb38fb933438982347aa101b1bb.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mmap.2: HISTORY: Update POSIX appearances of m(un)map(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:56 +0000 (12:29 +0000)] 
man/man2/mmap.2: HISTORY: Update POSIX appearances of m(un)map(2)

mmap(2) and munmap(2) appeared in SUSv1.[1]  The functions were then
added to POSIX.1-1996.[2][3]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 398-400, 414.
[2] ISO/IEC 9945-1:1996, Section 12.2.1 "Map Process Addresses to a
Memory Object".
[3] ISO/IEC 9945-1:1996, Section 12.2.2 "Unmap Previously Mapped
Addresses".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <57292b4f60c41b05274f5906ed0b8196cb053515.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mlock.2: HISTORY: Update POSIX appearances of m(un)lock(all)(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:51 +0000 (12:29 +0000)] 
man/man2/mlock.2: HISTORY: Update POSIX appearances of m(un)lock(all)(2)

mlock(2), munlock(2), mlockall(2), and munlockall(2) appeared in
POSIX.1-1996.[1][2]

[1] ISO/IEC 9945-1:1996, Section 12.1.1 "Lock/Unlock the Address Space
of a Process".
[2] ISO/IEC 9945-1:1996, Section 12.1.2 "Lock/Unlock a Range of Process
Address Space".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <67bf0c1aa1338117e930e19dd32ebfe6bdaf8432.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mknod.2: STANDARDS: Update
Seth McDonald [Mon, 26 Jan 2026 12:29:46 +0000 (12:29 +0000)] 
man/man2/mknod.2: STANDARDS: Update

mknod(2) and mknodat(2) are specified in POSIX.1-2024 as an XSI
extension.[1]

[1] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp.
1421-1424.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/mknod.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <32bd25fd363096217afa576fd79412f0de74e0ae.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mknod.2: HISTORY: Update POSIX appearances of mknod(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:41 +0000 (12:29 +0000)] 
man/man2/mknod.2: HISTORY: Update POSIX appearances of mknod(2)

mknod(2) 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", pp. 392-393.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp.
758-760.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/mknod.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <b0feda20f21d633090a9fa7554b6d4ccb46d4295.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mknod.2: HISTORY: Change order of mknodat(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:36 +0000 (12:29 +0000)] 
man/man2/mknod.2: HISTORY: Change order of mknodat(2)

glibc 2.4 released on 2006-03-06.[1]  Linux 2.6.16 released on
2006-03-20.[2]  So chronologically list glibc before Linux.

POSIX.1-2008 released in 2008, adding mkdirat(2) as an XSI extension.[3]
glibc added mknodat(2) on 2005-12-03.[4]  So chronologically list glibc
(and Linux) before POSIX.

[1] McGrath, Roland (6 Mar 2006).  "GNU C Library version 2.4 release".
info-gnu (Mailing list).
<https://lists.gnu.org/archive/html/info-gnu/2006-03/msg00000.html>
[2] Linux Kernel Distribution System (20 Mar 2006).  "Linux kernel
2.6.16 released".  linux-kernel-announce (Mailing list).
<https://lore.kernel.org/linux-kernel-announce/200603200635.k2K6ZOsn003502@hera.kernel.org>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", pp.
1298-1301.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/mknod.html>
[4] Drepper, Ulrich (3 Dec 2005).  "* io/Makefile (routines): Add
mknodat, xmknodat, mkdirat, mkfifoat."  GNU C Library master sources
(Git repository).
<https://sourceware.org/git/?p=glibc.git;a=commit;h=e186c703dc073b8be95d0bf893bb8ebb127fe02b>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <d3da8260e1bcd6e80b24729c805aa4f4b1497a48.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mkdir.2: HISTORY: Update BSD and POSIX appearances of mkdir(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:31 +0000 (12:29 +0000)] 
man/man2/mkdir.2: HISTORY: Update BSD and POSIX appearances of mkdir(2)

mkdir(2) seems to have appeared in 4.2BSD with the system call number
136, as seen in the system's /usr/src/sys/sys/syscalls.c file.[1]  The
function also appeared in POSIX.1-1988.[2]

[1] Spinellis, Diomidis (5 Jan 2026).  Unix History Repository (Git
repository).  Tag "BSD-4_2".
<https://github.com/dspinellis/unix-history-repo/tree/BSD-4_2>
[2] IEEE Std 1003.1-1988, Section 5.4.1 "Make a Directory".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <347e36c11666dc28a3c00227ae5c513bd427e680.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mkdir.2: HISTORY: Change order of mkdirat(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:24 +0000 (12:29 +0000)] 
man/man2/mkdir.2: HISTORY: Change order of mkdirat(2)

glibc 2.4 released on 2006-03-06.[1]  Linux 2.6.16 released on
2006-03-20.[2]  So chronologically list glibc before Linux.

POSIX.1-2008 released in 2008, adding mkdirat(2) to the
specification.[3]  glibc added mkdirat(2) on 2005-12-03,[4] and the
mailing list discussion about its addition seems to suggest it was
considered before it was known that POSIX would add it.[5]  So
chronologically list glibc (and Linux) before POSIX.

[1] McGrath, Roland (6 Mar 2006).  "GNU C Library version 2.4 release".
info-gnu (Mailing list).
<https://lists.gnu.org/archive/html/info-gnu/2006-03/msg00000.html>
[2] Linux Kernel Distribution System (20 Mar 2006).  "Linux kernel
2.6.16 released".  linux-kernel-announce (Mailing list).
<https://lore.kernel.org/linux-kernel-announce/200603200635.k2K6ZOsn003502@hera.kernel.org>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", pp.
1289-1291.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/mkdir.html>
[4] Drepper, Ulrich (3 Dec 2005).  "* io/Makefile (routines): Add
mknodat, xmknodat, mkdirat, mkfifoat."  GNU C Library master sources
(Git repository).
<https://sourceware.org/git/?p=glibc.git;a=commit;h=e186c703dc073b8be95d0bf893bb8ebb127fe02b>
[5] Meyering, Jim (30 Nov 2005).  "FYI: new openat-like function:
mkdirat".  libc-alpha (Mailing list).
<https://sourceware.org/pipermail/libc-alpha/2005-November/019749.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <8b25a256e60f221d8da2f71706a0af93cf0d5976.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/lseek.2: HISTORY: Update POSIX appearances of lseek(2)
Seth McDonald [Mon, 26 Jan 2026 12:29:08 +0000 (12:29 +0000)] 
man/man2/lseek.2: HISTORY: Update POSIX appearances of lseek(2)

lseek(2) appeared in POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 6.5.3 "Reposition Read/Write File
Offset".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <2dd12d136bf0aa0637ec1bc5255ee37f502fbc5b.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/lseek.2: HISTORY: Update appearances of SEEK_{DATA,HOLE}
Seth McDonald [Mon, 26 Jan 2026 12:28:59 +0000 (12:28 +0000)] 
man/man2/lseek.2: HISTORY: Update appearances of SEEK_{DATA,HOLE}

SEEK_DATA and SEEK_HOLE appeared in Solaris no later than 2005-12-12,
when a ZFS developer stated in a blog post that "[a]t this [time of]
writing, SEEK_HOLE and SEEK_DATA are Solaris-specific."[1]  The release
notes for Solaris 10 are dated to 2005-12.[2]  So the constants were
likely added in Solaris 10.

They were added to FreeBSD on 2007-04-05,[3] before being released in
FreeBSD 7.0 - the release notes stating that "[s]upport for Sun's ZFS
has been added" for amd64, i386, and pc98.[4]

They were also added to DragonFly BSD on 2009-04-07,[5] before being
released in DragonFly BSD 2.3.1 (which strangely seems to have no
release notes).[6]

The commit adding the constants to DragonFly BSD states that the commit
contents were obtained from FreeBSD.[5]  So chronologically FreeBSD is
listed before DragonFly BSD.  And the commit adding them to FreeBSD
references their implementation in OpenSolaris.[3]  So chronologically
Solaris is listed before FreeBSD.

POSIX.1-2024 is also moved to the end of the list, since it was released
decades after any system discussed here.

[1] Bonwick, Jeff (12 Dec 2005).  "SEEK_HOLE and SEEK_DATA for sparse
files".  Jeff Bonwick's Weblog.  Archived on 25 Oct 2006.
<https://web.archive.org/web/20061025161241/http://blogs.sun.com/bonwick/entry/seek_hole_and_seek_data>
[2] Oracle (Dec 2005).  "Solaris 10 Release Notes".
<https://docs.oracle.com/cd/E19253-01/html/817-0552/index.html>
[3] Dawidek, Pawel Jakub (5 Apr 2007).  "Implement SEEK_DATA and
SEEK_HOLE extensions to lseek(2) as found in".  FreeBSD source tree (Git
repository).
<https://cgit.freebsd.org/src/commit/?id=f6521d1c31810b096dd15afff12cf194d1989a0a>
[4] The FreeBSD Project (15 May 2021).  "FreeBSD 7.0-RELEASE Release
Notes".  Section 2.2.5 "File Systems".
<https://www.freebsd.org/releases/7.0R/relnotes>
[5] Avalos, Peter (7 Apr 2009).  "Clean up sysconf and associated
headers".  DragonFly Project Source (Git repository).
<https://gitweb.dragonflybsd.org/dragonfly.git/commit/9d66746cf7a1da0544550266a1c5cb53e776aa01>
[6] Schubert, Simon (7 May 2009).  "Roll DragonFly 2.3.1".  DragonFly
Project Source (Git repository).
<https://gitweb.dragonflybsd.org/dragonfly.git/commit/33a70342dc4e7f9a4ad7c120a827234a33153ca4>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <bcf9f5113f3c88ec1a3fa2bd9ec7a397b603f7c0.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/listen.2: HISTORY: Change order
Seth McDonald [Mon, 26 Jan 2026 12:28:50 +0000 (12:28 +0000)] 
man/man2/listen.2: HISTORY: Change order

4.2BSD released way before POSIX.1-2001, so chronologically list BSD
before POSIX.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <2024c82a058d671b57508887833af98d56d56da5.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/link.2: HISTORY: Update POSIX appearances of link(2)
Seth McDonald [Mon, 26 Jan 2026 12:28:41 +0000 (12:28 +0000)] 
man/man2/link.2: HISTORY: Update POSIX appearances of link(2)

link(2) appeared in POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 5.3.4 "Link to a File".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <bec317b8ee8861467e234ae884db6d18c72d0fe6.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/link.2: HISTORY: Change order of linkat(2)
Seth McDonald [Mon, 26 Jan 2026 12:28:35 +0000 (12:28 +0000)] 
man/man2/link.2: HISTORY: Change order of linkat(2)

glibc 2.4 released on 2006-03-06.[1]  Linux 2.6.16 released on
2006-03-20.[2]  So chronologically list glibc before Linux.

POSIX.1-2008 released in 2008 (shocker!).  However, glibc's addition of
linkat(2) on 2005-12-16 declared the function in posix/unistd.h,[3]
implying it was known (or at least suspected) to have been proposed for
inclusion in POSIX.1-2008.[4]  So chronologically list POSIX before
glibc.

[1] McGrath, Roland (6 Mar 2006).  "GNU C Library version 2.4 release".
info-gnu (Mailing list).
<https://lists.gnu.org/archive/html/info-gnu/2006-03/msg00000.html>
[2] Linux Kernel Distribution System (20 Mar 2006).  "Linux kernel
2.6.16 released".  linux-kernel-announce (Mailing list).
<https://lore.kernel.org/linux-kernel-announce/200603200635.k2K6ZOsn003502@hera.kernel.org>
[3] Drepper, Ulrich (16 Dec 2005).  "*
sysdeps/unix/sysv/linux/renameat.c: Move errno setting code in".  GNU C
Library master sources (Git repository).
<https://sourceware.org/git/?p=glibc.git;a=commit;h=5c46041a9c8e0431f0b329a94becfc5d576d12cb>
[4] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", pp.
1216-1220.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/link.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <17eacf0f2d3e4e9ec0faae8dc991d570e443dc5c.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/kill.2: HISTORY: Update POSIX appearances of kill(2)
Seth McDonald [Mon, 26 Jan 2026 12:28:26 +0000 (12:28 +0000)] 
man/man2/kill.2: HISTORY: Update POSIX appearances of kill(2)

kill(2) appeared in POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 3.3.2 "Send a Signal to a Process".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <55de16b213bf725f1365203b361d73cdb2dd0b6e.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/ioctl_eventpoll.2: HISTORY: ffix
Seth McDonald [Mon, 26 Jan 2026 12:28:18 +0000 (12:28 +0000)] 
man/man2/ioctl_eventpoll.2: HISTORY: ffix

Commas are more consistent with other man pages.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <d109f3dc06e2c432faca396ebb3b1e7b28c52024.1769429341.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoAUTHORS: Update Branden's address
Alejandro Colomar [Tue, 10 Feb 2026 23:21:55 +0000 (00:21 +0100)] 
AUTHORS: Update Branden's address

Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/mount.2: ERRORS: Add ENOSPC
Chen Linxuan [Sun, 1 Feb 2026 03:59:33 +0000 (11:59 +0800)] 
man/man2/mount.2: ERRORS: Add ENOSPC

mount(2) can return ENOSPC since:
linux.git d29216842a85 (2016-09-30; "mnt: Add a per mount namespace limit on the number of mounts")

Signed-off-by: Chen Linxuan <me@black-desk.cn>
Message-ID: <20260201-add-enospc-for-mount-v2-1-43c990199cc6@black-desk.cn>
[alx: wfix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/timespec_get.3: Add ISO C23 time bases
Mark Harris [Thu, 29 Jan 2026 16:52:24 +0000 (08:52 -0800)] 
man/man3/timespec_get.3: Add ISO C23 time bases

Document new time bases TIME_MONOTONIC, TIME_ACTIVE, and
TIME_THREAD_ACTIVE, introduced in ISO C23 and supported by
glibc 2.43.[1]

[1] <https://sourceware.org/git/?p=glibc.git;a=commit;h=f28a11e43f40>

Signed-off-by: Mark Harris <mark.hsj@gmail.com>
Message-ID: <1955d9507d6ab4e482f92a4d7717872c98f39f8a.1769705123.git.mark.hsj@gmail.com>
[alx: de-duplicate glibc versions]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/timespec_get.3: Refactor to prepare for new time bases
Mark Harris [Thu, 29 Jan 2026 16:52:23 +0000 (08:52 -0800)] 
man/man3/timespec_get.3: Refactor to prepare for new time bases

Add Feature Test Macro Requirements to document functions and macros
that require ISO C11 or C23, and arrange supported time bases as a list.

Signed-off-by: Mark Harris <mark.hsj@gmail.com>
Message-ID: <ec8dfdc495cb8d58e945b370658c6945cb424327.1769705123.git.mark.hsj@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man7/feature_test_macros.7: Drop _ISOC9X_SOURCE
Mark Harris [Wed, 28 Jan 2026 06:46:24 +0000 (22:46 -0800)] 
man/man7/feature_test_macros.7: Drop _ISOC9X_SOURCE

_ISOC9X_SOURCE was a temporary macro for use before the final name
of the standard was known.  It became obsolete when _ISOC99_SOURCE
was added in glibc 2.1.3 (1999), and has not been recognized since
_ISOC11_SOURCE was added in glibc 2.16 (2012).[1]

[1] <https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=d78099052b6b>

Signed-off-by: Mark Harris <mark.hsj@gmail.com>
Message-ID: <bf785830f727b9fd7a40001b861b743f88fe2a7a.1769581651.git.mark.hsj@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man7/feature_test_macros.7: Add _ISOC23_SOURCE, _ISOC2X_SOURCE
Mark Harris [Wed, 28 Jan 2026 06:46:23 +0000 (22:46 -0800)] 
man/man7/feature_test_macros.7: Add _ISOC23_SOURCE, _ISOC2X_SOURCE

_ISOC2X_SOURCE has been recognized since glibc 2.31 (2020).[1]
_ISOC23_SOURCE has been recognized since glibc 2.40 (2024).[2]

[1] <https://sourceware.org/git/?p=glibc.git;a=commit;h=777d75fbc07b>
[2] <https://sourceware.org/git/?p=glibc.git;a=commit;h=42cc619dfbc4>

Signed-off-by: Mark Harris <mark.hsj@gmail.com>
Message-ID: <c52b599edf72f3e536ff6a5b846232ab15bc83d7.1769581650.git.mark.hsj@gmail.com>
[alx: srcfix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man7/kernel_lockdown.7: Remove Secure Boot untruth
Alyssa Ross [Tue, 3 Feb 2026 19:50:01 +0000 (20:50 +0100)] 
man/man7/kernel_lockdown.7: Remove Secure Boot untruth

This is true for Fedora, where this page was sourced from, but I don't
believe it has ever been true for the mainline kernel, because Linus
rejected it.

Link: <https://bbs.archlinux.org/viewtopic.php?pid=2088704#p2088704>
Link: <https://lore.kernel.org/lkml/CA+55aFzYbpRAdma0PvqE+9ygySuKzNKByqOzzMufBoovXVnfPw@mail.gmail.com/>
Fixes: bb509e6fcbae (2020-10-16; "kernel_lockdown.7: New page documenting the Kernel Lockdown feature")
Signed-off-by: Alyssa Ross <hi@alyssa.is>
Message-ID: <20260203195001.20131-1-hi@alyssa.is>
Acked-by: Xiu Jianfeng <xiujianfeng@huawei.com>
Message-ID: <aa62e24c-537e-4141-9507-37cd0af19dfc@huawei.com>
Acked-by: Nicolas Bouchinet <nicolas.bouchinet@oss.cyber.gouv.fr>
Message-ID: <aYYP23WUyydsMGyx@archlinux>
Cc: Heinrich Schuchardt <xypron.glpk@gmx.de>
Cc: David Howells <dhowells@redhat.com>
Cc: <linux-security-module@vger.kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/ptrace.2: Add PTRACE_SET_SYSCALL_INFO, update struct ptrace_syscall_info
Marco Cavenati [Wed, 21 Jan 2026 15:55:41 +0000 (16:55 +0100)] 
man/man2/ptrace.2: Add PTRACE_SET_SYSCALL_INFO, update struct ptrace_syscall_info

Add documentation for the new ptrace request PTRACE_SET_SYSCALL_INFO,
introduced in Linux 6.16.

Add 'reserved' and 'flags' fields of struct ptrace_syscall_info.

This description is based on kernel commit 26bb32768fe6552de044f782a58b3272073fbfc0
("ptrace: introduce PTRACE_SET_SYSCALL_INFO request") by Dmitry V. Levin.

Signed-off-by: Marco Cavenati <Marco.Cavenati@eurecom.fr>
Message-ID: <20260121155550.281916-1-Marco.Cavenati@eurecom.fr>
Reviewed-by: "Dmitry V. Levin" <ldv@strace.io>
Message-ID: <20260210205347.GA31604@strace.io>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/pthread_create.3: SYNOPSIS: Use _Nullable where appropriate
Alejandro Colomar [Tue, 10 Feb 2026 20:59:39 +0000 (21:59 +0100)] 
man/man3/pthread_create.3: SYNOPSIS: Use _Nullable where appropriate

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2const/FUTEX_WAIT{,_BITSET,_REQUEUE_PI}.2const: wfix
наб [Sat, 7 Feb 2026 19:18:38 +0000 (20:18 +0100)] 
man/man2const/FUTEX_WAIT{,_BITSET,_REQUEUE_PI}.2const: wfix

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <2ekfzlznhv7yld7dghj5rt7uvenp6uji5jrmfm6xoije6ycyny@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/: Use countof() instead of _Countof()
Alejandro Colomar [Tue, 10 Feb 2026 20:53:41 +0000 (21:53 +0100)] 
man/: Use countof() instead of _Countof()

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/: Use _Countof() instead of a custom NITEMS()
Alejandro Colomar [Tue, 10 Feb 2026 13:46:48 +0000 (14:46 +0100)] 
man/: Use _Countof() instead of a custom NITEMS()

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/_Countof.3: Add link page
Alejandro Colomar [Tue, 10 Feb 2026 13:43:42 +0000 (14:43 +0100)] 
man/man3/_Countof.3: Add link page

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/countof.3: HISTORY: Document gnulib
Alejandro Colomar [Tue, 10 Feb 2026 13:40:30 +0000 (14:40 +0100)] 
man/man3/countof.3: HISTORY: Document gnulib

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoetc/cppcheck/cppcheck.suppress: constVariablePointer: Silence diagnostic
Alejandro Colomar [Sun, 8 Feb 2026 21:53:06 +0000 (22:53 +0100)] 
etc/cppcheck/cppcheck.suppress: constVariablePointer: Silence diagnostic

The following diagnostic was triggered.  It's not a false positive, but
adding const wouldn't be helpful int his example.

remote: .tmp/man/man2/userfaultfd.2.d/userfaultfd.c:121:17: style: Variable 'addr' can be declared as pointer to const [constVariablePointer]
remote:     char       *addr;   /* Start of region handled by userfaultfd */
remote:                 ^

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man2/userfaultfd.2: EXAMPLES: Reduce scope of local variables
Alejandro Colomar [Sun, 8 Feb 2026 21:42:25 +0000 (22:42 +0100)] 
man/man2/userfaultfd.2: EXAMPLES: Reduce scope of local variables

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoshare/mk/: lint-man-poems: Don't lint copyright lines
Alejandro Colomar [Sun, 8 Feb 2026 21:32:14 +0000 (22:32 +0100)] 
share/mk/: lint-man-poems: Don't lint copyright lines

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months ago*/: Restore some old copyright notices
Alejandro Colomar [Fri, 21 Nov 2025 00:08:05 +0000 (01:08 +0100)] 
*/: Restore some old copyright notices

This commit partially reverts
9f2986c34166 (2025-05-06; "*, CREDITS: Unify copyright notices").

Some authors have given express permission for the transformation done
in that old commit, and their notices remain transformed.  But those
that didn't give express permission have their copyright notices
restored now.

It's unclear whether the transformation was legally valid.  I believe it
was, but since IANAL, and just to be cautious, we've agreed to restore
them.

This restoration, at least, unifies the formatting, to reduce entropy.

Link: <https://lore.kernel.org/linux-man/u2ogua4573d2xm2p2oiuna67kydkr3e26pt6lixeidezdw34dg@nvn64na3cptt/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoAUTHORS: Add new authors
Alejandro Colomar [Sun, 8 Feb 2026 17:56:31 +0000 (18:56 +0100)] 
AUTHORS: Add new authors

And update one entry with a more recent email address.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoREADME.d/deps: Document dependencies of the project
Alejandro Colomar [Sun, 8 Feb 2026 14:44:22 +0000 (15:44 +0100)] 
README.d/deps: Document dependencies of the project

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/git: alias.ref, alias.ref2: Hard-code short dates
Alejandro Colomar [Sun, 8 Feb 2026 19:28:10 +0000 (20:28 +0100)] 
CONTRIBUTING.d/git: alias.ref, alias.ref2: Hard-code short dates

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/git: log.date: Set to 'iso'
Alejandro Colomar [Sun, 8 Feb 2026 19:14:24 +0000 (20:14 +0100)] 
CONTRIBUTING.d/git: log.date: Set to 'iso'

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/git: core.abbrev: Set to 12
Alejandro Colomar [Sun, 8 Feb 2026 19:06:03 +0000 (20:06 +0100)] 
CONTRIBUTING.d/git: core.abbrev: Set to 12

By setting this globally to 12, we avoid having to specify it in every
config.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/git: alias.ref, alias.ref2: Simplify coloring
Alejandro Colomar [Sun, 8 Feb 2026 18:38:56 +0000 (19:38 +0100)] 
CONTRIBUTING.d/git: alias.ref, alias.ref2: Simplify coloring

Coloring should be automatic, and controlled globally with color.diff.

Link: <https://lore.kernel.org/git/aYjVlRqvafWeePvi@devuan/T/#u>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/: Document format of 'Fixes:' trailer fields
Alejandro Colomar [Tue, 3 Feb 2026 20:15:24 +0000 (21:15 +0100)] 
CONTRIBUTING.d/: Document format of 'Fixes:' trailer fields

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/patches/{description,trailer}: Split trailer into separate file
Alejandro Colomar [Sun, 8 Feb 2026 16:36:12 +0000 (17:36 +0100)] 
CONTRIBUTING.d/patches/{description,trailer}: Split trailer into separate file

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoCONTRIBUTING.d/git: Use tabs
Alejandro Colomar [Tue, 3 Feb 2026 20:05:22 +0000 (21:05 +0100)] 
CONTRIBUTING.d/git: Use tabs

Signed-off-by: Alejandro Colomar <alx@kernel.org>
3 months agoman/man3/{str,wcs}ncasecmp.3: SYNOPSIS: Remove array parameter length expressions
Alejandro Colomar [Mon, 2 Feb 2026 23:16:00 +0000 (00:16 +0100)] 
man/man3/{str,wcs}ncasecmp.3: SYNOPSIS: Remove array parameter length expressions

The arguments to these APIs may be shorter than that, as long as they
are null terminated strings.

Reported-by: Florian Weimer <fweimer@redhat.com>
Fixes: e11a82a6f709 (2025-11-24; "man/man3/: {str,wcs}n{cmp,len}(3): Remove array parameter length expressions")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/syscall.2: tfix
Alejandro Colomar [Mon, 2 Feb 2026 13:44:41 +0000 (14:44 +0100)] 
man/man2/syscall.2: tfix

I forgot to amend this.

Fixes: 59ef3a674d11 (2026-02-02; "man/man2/syscall.2: Fix numbering for notes")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/syscall.2: Fix numbering for notes
Thorsten Glaser [Mon, 2 Feb 2026 11:36:56 +0000 (12:36 +0100)] 
man/man2/syscall.2: Fix numbering for notes

Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man7/man-pages.7: Document PARAMETERS
Alejandro Colomar [Mon, 2 Feb 2026 13:35:57 +0000 (14:35 +0100)] 
man/man7/man-pages.7: Document PARAMETERS

Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man1/mansect.1: PARAMETERS: Add section
Alejandro Colomar [Thu, 29 Jan 2026 14:38:00 +0000 (15:38 +0100)] 
man/man1/mansect.1: PARAMETERS: Add section

Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agosrc/bin/mansectf, man/man1/mansectf.1: Add program and manual page
Alejandro Colomar [Wed, 28 Jan 2026 18:50:38 +0000 (19:50 +0100)] 
src/bin/mansectf, man/man1/mansectf.1: Add program and manual page

Reported-by: Seth McDonald <sethmcmail@pm.me>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: наб <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoAUTHORS: De-duplicate Andrew Lutomirski
Alejandro Colomar [Fri, 30 Jan 2026 14:46:27 +0000 (15:46 +0100)] 
AUTHORS: De-duplicate Andrew Lutomirski

Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/: HISTORY, STANDARDS: Update history of system calls CI-G
Alejandro Colomar [Fri, 23 Jan 2026 16:02:37 +0000 (17:02 +0100)] 
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.

Message-ID: <cover.1768995315.git.sethmcmail@pm.me>
Message-ID: <cover.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)
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>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <37278a0497bdc28cbeaef156d36d66530381bd6c.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2)
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>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <3efc2800fc16289dfabb65c2715e66efb094e367.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2)
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>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <8ec811d4690abb5aa56eb3014900dd82b27dda6d.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)
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>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <ffb23d5856179db3b8fd8a6514203418b28eb7be.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getresuid.2: STANDARDS, HISTORY: Update first POSIX appearance of getres...
Seth McDonald [Thu, 22 Jan 2026 02:25:48 +0000 (02:25 +0000)] 
man/man2/getresuid.2: STANDARDS, HISTORY: Update first POSIX appearance of getres[gu]id(2)

getresgid(2) and getresuid(2) first appeared in POSIX.1-2024 as an XSI
extension.[1][2]

[1] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p.
1174.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresgid.html>
[2] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p.
1175.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresuid.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <0afcc4b4083b450adfaf63958f85e99926d7fa6c.1769047228.git.sethmcmail@pm.me>
[alx: update STANDARDS too]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2)
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>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <6bcf34a705e3f58af4e47f0b55e383787ddaa959.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:39 +0000 (02:25 +0000)] 
man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2)

getpid(2) and getppid(2) first appeared in POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 4.1.1 "Get Process and Parent Process
IDs".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <db04851687858925bab6717857321aaf910c000f.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:33 +0000 (02:25 +0000)] 
man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2)

getpagesize(2) first appeared in SUSv1.[1]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", p. 254.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <825144f9529837adcba4a53ccd0395221b26b8e7.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:29 +0000 (02:25 +0000)] 
man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2)

getitimer(2) and setitimer(2) first appeared in SUSv1.[1]

[1] X/Open CAE Specification, System Interfaces and Headers Issue 4,
Version 2, Chapter 3 "System Interfaces", pp. 244-245.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <9c780e0e0176bd677be89eedc07be1e66d2365f1.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:25 +0000 (02:25 +0000)] 
man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2)

gethostname(2) first appeared in POSIX.1-2001.[1]

[1] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p.
516.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/gethostname.html>

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <94b81d0f1c2b0d082b5b8510d86ba235c21a3069.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:21 +0000 (02:25 +0000)] 
man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2)

getgroups(2) first appeared in POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 4.2.3 "Get Supplementary Group IDs".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <4ad7acf2ef8cd66a53d27a59a1d7b9933a84741f.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:17 +0000 (02:25 +0000)] 
man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2)

getgid(2), getegid(2), getuid(2), and geteuid(2) first appeared in
POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 4.2.1 "Get Real User, Effective User,
Real Group, and Effective Group IDs".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <6b987649c5ccd426ddffb770a5ba82cb88d91af9.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:12 +0000 (02:25 +0000)] 
man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2)

fdatasync(2) first appeared in POSIX.1-1996.[1]

[1] ISO/IEC 9945-1:1996, Section 6.6.2 "Synchronize the Data of a File".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <0d67e7c63fd30e88854df7fe8bdffe5607e8b777.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2)
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".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <ab31e843c470a424885b91d6f94f2a89b291135c.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2)
Seth McDonald [Thu, 22 Jan 2026 02:25:04 +0000 (02:25 +0000)] 
man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2)

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <7b237415d7b97d09966619de01d8542e4f6f4ba9.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2)
Seth McDonald [Thu, 22 Jan 2026 02:24:59 +0000 (02:24 +0000)] 
man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2)

fork(2) first appeared in POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Section 3.1.1 "Process Creation".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <7404e99ec6900a598552b310b152c325000163ff.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
4 months agoman/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants
Seth McDonald [Thu, 22 Jan 2026 02:24:54 +0000 (02:24 +0000)] 
man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants

The F_GETLK, F_SETLK, and F_SETLKW symbolic constants first appeared in
POSIX.1-1988.[1]

[1] IEEE Std 1003.1-1988, Table 6-1 "cmd Values for fcntl()".

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <a44c4965006373942afeb2f091c752b2dfbfbfd5.1769047228.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>