]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
7 months agoman/man2const/F_DUPFD.2const: HISTORY: Update first POSIX appearance of F_DUPFD(2const)
Seth McDonald [Mon, 5 Jan 2026 09:18:37 +0000 (19:18 +1000)] 
man/man2const/F_DUPFD.2const: HISTORY: Update first POSIX appearance of F_DUPFD(2const)

F_DUPFD(2const) 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: <24e850c16b1a16da197c3e86ec756a7f585ef732.1767599119.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man5/gai.conf: Fix RFC reference
Dr. David Alan Gilbert [Sun, 4 Jan 2026 21:49:56 +0000 (21:49 +0000)] 
man/man5/gai.conf: Fix RFC reference

Most of the RFC references correctly reference 3484, but the entry
in scopev4 points to 3438 instead.  It references section 3.2,
which 3438 doesn't have, but 3484 does have and talks about IPv4
addresses so looks right.

Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
Message-ID: <20260104214956.258199-1-dg@treblig.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoCONTRIBUTING.d/security: Add instructions for reporting security incidents
Alejandro Colomar [Sun, 4 Jan 2026 12:17:18 +0000 (13:17 +0100)] 
CONTRIBUTING.d/security: Add instructions for reporting security incidents

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/socket.7: Fix documentation for SO_ATTACH_REUSEPORT_EBPF
Vincent Bernat [Mon, 1 Dec 2025 19:57:15 +0000 (20:57 +0100)] 
man/man7/socket.7: Fix documentation for SO_ATTACH_REUSEPORT_EBPF

When using eBPF, there are two possible cases depending on the program
type.  Only the first case was described.  In the second case, the
program should not return an index, but a decision (SK_PASS/SK_DROP).
The socket should be selected using the sk_select_reuseport helper.

Signed-off-by: Vincent Bernat <vincent@bernat.ch>
Message-ID: <20251201195726.3669864-1-vincent@bernat.ch>
Acked-by: Craig Gallek <kraig@google.com>
Message-ID: <CAEfhGiwbaAuvZ=aVQoRw8+ZQPmMQnwp3WFO5ELCMPJOOa3FnWQ@mail.gmail.com>
[alx: reorganize text more schematically]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/F_GETSIG.2const: HISTORY: tfix
Seth McDonald [Tue, 30 Dec 2025 06:42:03 +0000 (16:42 +1000)] 
man/man2const/F_GETSIG.2const: HISTORY: tfix

The G and S do look surprisingly similar...

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <2f33ba3b5bd29ebd931bd213fb8f9a7b19ed9ce6.1767072049.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/sysctl.2: HISTORY: wfix
Seth McDonald [Tue, 30 Dec 2025 06:42:01 +0000 (16:42 +1000)] 
man/man2/sysctl.2: HISTORY: wfix

Include 4.4BSD in the initial list in HISTORY, rather than stating the
function's origin in 4.4BSD as a full sentence.  This is more concise
and consistent with other manual pages.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <1477de655f76e1e6e85c12cb03c068b120704511.1767072049.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/syscall.2: HISTORY: Add section
Seth McDonald [Tue, 30 Dec 2025 06:42:00 +0000 (16:42 +1000)] 
man/man2/syscall.2: HISTORY: Add section

Move the description of syscall(2)'s first appearance from NOTES to a
new HISTORY section.

Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <a2a2a51edeb0b23ebedf998cfac788dd96ee7ff3.1767072049.git.sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/mbsinit.3: wfix
Alejandro Colomar [Thu, 25 Dec 2025 21:10:13 +0000 (22:10 +0100)] 
man/man3/mbsinit.3: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/__riscv_flush_icache.3: wfix
Alejandro Colomar [Fri, 26 Dec 2025 10:47:03 +0000 (11:47 +0100)] 
man/man3/__riscv_flush_icache.3: wfix

Suggested-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3type/wint_t.3type: NAME: tfix
Alejandro Colomar [Thu, 25 Dec 2025 13:24:13 +0000 (14:24 +0100)] 
man/man3type/wint_t.3type: NAME: tfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/PR_RISCV_SET_ICACHE_FLUSH_CTX.2const: ffix
Alejandro Colomar [Thu, 25 Dec 2025 21:06:08 +0000 (22:06 +0100)] 
man/man2const/PR_RISCV_SET_ICACHE_FLUSH_CTX.2const: ffix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/PR_SET_TIMERSLACK.2const: FILES: Remove section
Alejandro Colomar [Thu, 25 Dec 2025 20:36:08 +0000 (21:36 +0100)] 
man/man2const/PR_SET_TIMERSLACK.2const: FILES: Remove section

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/PR_RISCV_SET_ICACHE_FLUSH_CTX.2const: wfix
Alejandro Colomar [Thu, 25 Dec 2025 13:56:54 +0000 (14:56 +0100)] 
man/man2const/PR_RISCV_SET_ICACHE_FLUSH_CTX.2const: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Fixes: ed40372bac58 (2024-07-22; "prctl.2: Add PR_RISCV_SET_ICACHE_FLUSH_CTX")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/PR_SET_FPEXC.2const: wfix
Alejandro Colomar [Thu, 25 Dec 2025 13:51:17 +0000 (14:51 +0100)] 
man/man2const/PR_SET_FPEXC.2const: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/PR_SET_MM_EXE_FILE.2const: wfix
Alejandro Colomar [Thu, 25 Dec 2025 13:45:29 +0000 (14:45 +0100)] 
man/man2const/PR_SET_MM_EXE_FILE.2const: wfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Fixes: 3612be041801 (2012-04-17; "prctl.2: Various edits and improvements to Cyrill's patch")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man5/sysfs.5: /sys/module/: ffix
Alejandro Colomar [Thu, 25 Dec 2025 13:41:22 +0000 (14:41 +0100)] 
man/man5/sysfs.5: /sys/module/: ffix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Fixes: 6df684e0d3e9 (2017-09-11; "sysfs.5: Various additions and improvements")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man5/sysfs.5: /sys/module/parameters: Fix incomplete sentence
Alejandro Colomar [Thu, 25 Dec 2025 13:14:30 +0000 (14:14 +0100)] 
man/man5/sysfs.5: /sys/module/parameters: Fix incomplete sentence

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Fixes: 6df684e0d3e9 (2017-09-11; "sysfs.5: Various additions and improvements")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/: Unify spelling of 'multiplexer'
Alejandro Colomar [Thu, 25 Dec 2025 21:15:32 +0000 (22:15 +0100)] 
man/: Unify spelling of 'multiplexer'

Both 'o' and 'e' are used in the manual pages:

        $ grep -rho multiplex.r man/ | sort| uniq -c
              4 multiplexer
              4 multiplexor

Let's stick to 'e', for consistency with __NR_multiplexer.

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Acked-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/: ffix
Alejandro Colomar [Thu, 25 Dec 2025 13:30:03 +0000 (14:30 +0100)] 
man/: ffix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/: pfix
Alejandro Colomar [Thu, 25 Dec 2025 13:06:28 +0000 (14:06 +0100)] 
man/: pfix

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/: Update linux.git/Documentation/ references
Alejandro Colomar [Thu, 25 Dec 2025 13:01:20 +0000 (14:01 +0100)] 
man/: Update linux.git/Documentation/ references

And remove some outdated ones.

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/address_families.7: DECnet support was removed in Linux 6.1
Alejandro Colomar [Thu, 25 Dec 2025 12:20:09 +0000 (13:20 +0100)] 
man/man7/address_families.7: DECnet support was removed in Linux 6.1

See the following commit:

linux.git 1202cdd66531 (2022-08-22; "Remove DECnet support from kernel")

The kernel documentation file, before it was removed, was
"Documentation/networking/decnet.rst".

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/bootparam.7: The IDE driver was removed in Linux 5.14
Alejandro Colomar [Thu, 25 Dec 2025 12:11:34 +0000 (13:11 +0100)] 
man/man7/bootparam.7: The IDE driver was removed in Linux 5.14

See the following commits:

linux.git b7fb14d3ac63 (2021-06-16; "ide: remove the legacy ide driver")
linux.git 898ee22c32be (2022-04-20; "Drop Documentation/ide/")

The kernel documentation file, before it was removed, was
"Documentation/ide/ide.rst".

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/semop.2: Rebrand VERSIONS as HISTORY
Seth McDonald [Thu, 25 Dec 2025 07:26:25 +0000 (07:26 +0000)] 
man/man2/semop.2: Rebrand VERSIONS as HISTORY

Rename the VERSIONS section to HISTORY.  It was actually documenting the
history of these APIs, and not different versions of it.

Fixes: 4131356cdab8 (2023-03-17; "man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <86b4c2ec94334aadcc8abc9f17b34b60716d399b.1766641593.git.sethmcmail@pm.me>
[alx: split commit in two]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/semop.2: VERSIONS: Fix incorrect history
Seth McDonald [Thu, 25 Dec 2025 07:26:25 +0000 (07:26 +0000)] 
man/man2/semop.2: VERSIONS: Fix incorrect history

Split semop(2) and semtimedop(2) in this section, and move the
previously listed standards/versions to the corresponding functions.

The VERSIONS section is really a HISTORY section that seems to have
mixed up semop(2) and semtimedop(2).  The relevant commit (4131356cdab8)
removed some context specifying which standards/versions apply to
semtimedop(2) only, causing this mix-up.  The diff for this commit on
man/man2/semop.2 is given below.

    $ git diff -U1 4131356cdab8^! man2/semop.2
    diff --git a/man2/semop.2 b/man2/semop.2
    index 7a1416a26..fe2906be4 100644
    --- a/man2/semop.2
    +++ b/man2/semop.2
    @@ -357,11 +357,8 @@ .SH ERRORS
     .IR semval .
    -.SH VERSIONS
    -.BR semtimedop ()
    -first appeared in Linux 2.5.52,
    -and was subsequently backported into Linux 2.4.22.
    -glibc support for
    -.BR semtimedop ()
    -first appeared in Linux 2.3.3.
     .SH STANDARDS
    -POSIX.1-2001, POSIX.1
    -2008, SVr4.
    +POSIX.1-2008.
    +.SH VERSIONS
    +Linux 2.5.52 (backported into Linux 2.4.22),
    +glibc 2.3.3.
    +POSIX.1-2001, SVr4.
     .\" SVr4 documents additional error conditions EINVAL, EFBIG, ENOSPC.

The removed information is restored on account of the semop(2) and
semtimedop(2) functions being described separately, removing the mix-up.

Fixes: 4131356cdab8 (2023-03-17; "man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Seth McDonald <sethmcmail@pm.me>
Message-ID: <86b4c2ec94334aadcc8abc9f17b34b60716d399b.1766641593.git.sethmcmail@pm.me>
[alx: split commit in two]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/getopt_long.3: EXAMPLES: Add missing include
Alejandro Colomar [Wed, 24 Dec 2025 21:41:13 +0000 (22:41 +0100)] 
man/man3/getopt_long.3: EXAMPLES: Add missing include

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/fmtmsg.3: EXAMPLES: Rename local variable
Alejandro Colomar [Wed, 24 Dec 2025 21:26:08 +0000 (22:26 +0100)] 
man/man3/fmtmsg.3: EXAMPLES: Rename local variable

'class' is a keyword in C++.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/strncat.3: EXAMPLES: Use a more realistic example
Alejandro Colomar [Wed, 24 Dec 2025 21:04:43 +0000 (22:04 +0100)] 
man/man3/strncat.3: EXAMPLES: Use a more realistic example

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2const/PR_RISCV_SET_ICACHE_FLUSH_CTX.2const: tfix
Alejandro Colomar [Wed, 24 Dec 2025 15:51:51 +0000 (16:51 +0100)] 
man/man2const/PR_RISCV_SET_ICACHE_FLUSH_CTX.2const: tfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/: grfix
Alejandro Colomar [Wed, 24 Dec 2025 15:48:03 +0000 (16:48 +0100)] 
man/: grfix

The American spelling is far more common:

$ grep -rhio behavior man/ | wc -l
561
$ grep -rhio behaviour man/ | wc -l
31

This change was scripted:

$ grep -rl ehaviour man | xargs sed -i 's/ehaviour/ehavior/'

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/mremap.2: ffix
Alejandro Colomar [Wed, 24 Dec 2025 15:34:46 +0000 (16:34 +0100)] 
man/man2/mremap.2: ffix

Fixes: e3fcb6c76685 (2025-08-19; "man/man2/mremap.2: Describe multiple-mapping move")
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/ioctl_kd.2: Use uint8_t instead of char for bit masks
Alejandro Colomar [Wed, 24 Dec 2025 15:21:23 +0000 (16:21 +0100)] 
man/man2/ioctl_kd.2: Use uint8_t instead of char for bit masks

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoshare/mk/: build-*-troff: Ignore adjustment diagnostics in standards.7
Alejandro Colomar [Thu, 25 Dec 2025 01:07:47 +0000 (02:07 +0100)] 
share/mk/: build-*-troff: Ignore adjustment diagnostics in standards.7

There's a very long URI that can't be adjusted.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/: Add break point in URIs
Alejandro Colomar [Wed, 24 Dec 2025 23:13:12 +0000 (00:13 +0100)] 
man/: Add break point in URIs

Allow breaking URIs after ':' and before '//'.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Document IEEE names of POSIX revisions
Alejandro Colomar [Thu, 25 Dec 2025 01:31:46 +0000 (02:31 +0100)] 
man/man7/standards.7: Document IEEE names of POSIX revisions

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Add links
Alejandro Colomar [Thu, 25 Dec 2025 01:02:26 +0000 (02:02 +0100)] 
man/man7/standards.7: Add links

Many of these are published online; add those links.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Add links to online publications of POSIX.1
Alejandro Colomar [Wed, 24 Dec 2025 17:15:52 +0000 (18:15 +0100)] 
man/man7/standards.7: Add links to online publications of POSIX.1

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Both ISO and IEC ratified these standards
Alejandro Colomar [Wed, 24 Dec 2025 16:54:02 +0000 (17:54 +0100)] 
man/man7/standards.7: Both ISO and IEC ratified these standards

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: POSIX.*: wfix
Alejandro Colomar [Wed, 24 Dec 2025 16:44:54 +0000 (17:44 +0100)] 
man/man7/standards.7: POSIX.*: wfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: ISO ratified POSIX.1 in 1996, not just POSIX.1b
Alejandro Colomar [Wed, 24 Dec 2025 16:30:25 +0000 (17:30 +0100)] 
man/man7/standards.7: ISO ratified POSIX.1 in 1996, not just POSIX.1b

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: C11: Document TC1
Alejandro Colomar [Wed, 24 Dec 2025 14:47:24 +0000 (15:47 +0100)] 
man/man7/standards.7: C11: Document TC1

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: C99: Document TCs
Alejandro Colomar [Wed, 24 Dec 2025 14:30:14 +0000 (15:30 +0100)] 
man/man7/standards.7: C99: Document TCs

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: ffix
Alejandro Colomar [Wed, 24 Dec 2025 14:19:45 +0000 (15:19 +0100)] 
man/man7/standards.7: ffix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Document K&R C
Alejandro Colomar [Wed, 24 Dec 2025 12:51:57 +0000 (13:51 +0100)] 
man/man7/standards.7: Document K&R C

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Document C96
Alejandro Colomar [Wed, 24 Dec 2025 13:23:49 +0000 (14:23 +0100)] 
man/man7/standards.7: Document C96

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Document C94
Alejandro Colomar [Wed, 24 Dec 2025 13:19:51 +0000 (14:19 +0100)] 
man/man7/standards.7: Document C94

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Document C95
Alejandro Colomar [Wed, 24 Dec 2025 12:38:42 +0000 (13:38 +0100)] 
man/man7/standards.7: Document C95

C95 added wide characters and other internationalization support.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: POSIX.1-2017: wfix
Alejandro Colomar [Wed, 24 Dec 2025 12:16:11 +0000 (13:16 +0100)] 
man/man7/standards.7: POSIX.1-2017: wfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: SUSv4 2016 edition: wfix
Alejandro Colomar [Wed, 24 Dec 2025 12:12:27 +0000 (13:12 +0100)] 
man/man7/standards.7: SUSv4 2016 edition: wfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: POSIX.1-2004 is formally POSIX.1-2001 2004 edition
Alejandro Colomar [Wed, 24 Dec 2025 12:08:15 +0000 (13:08 +0100)] 
man/man7/standards.7: POSIX.1-2004 is formally POSIX.1-2001 2004 edition

And there's also POSIX.1-2001 2002 edition, although I can't find it
online.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: POSIX.1-2013 is formally POSIX.1-2008 2013 edition
Alejandro Colomar [Wed, 24 Dec 2025 12:02:35 +0000 (13:02 +0100)] 
man/man7/standards.7: POSIX.1-2013 is formally POSIX.1-2008 2013 edition

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoetc/clang-tidy/config.yaml: Checks: -readability-use-concise-preprocessor-directives
Alejandro Colomar [Wed, 24 Dec 2025 21:18:10 +0000 (22:18 +0100)] 
etc/clang-tidy/config.yaml: Checks: -readability-use-concise-preprocessor-directives

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoshare/mk/: $CLANG_CFLAGS: -Wno-implicit-void-ptr-cast
Alejandro Colomar [Wed, 24 Dec 2025 21:29:06 +0000 (22:29 +0100)] 
share/mk/: $CLANG_CFLAGS: -Wno-implicit-void-ptr-cast

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoshare/mk/: $CLANG_CFLAGS: -Wno-c++-unterminated-string-initialization
Alejandro Colomar [Wed, 24 Dec 2025 21:20:46 +0000 (22:20 +0100)] 
share/mk/: $CLANG_CFLAGS: -Wno-c++-unterminated-string-initialization

It triggers false positives with [[gnu::nonstring]].

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/getopt.3: ffix
G. Branden Robinson [Fri, 19 Dec 2025 17:16:02 +0000 (11:16 -0600)] 
man/man3/getopt.3: ffix

Protect literals from hyphenation.

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Message-ID: <20251219171602.6255ekvsx24ocub3@illithid>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/standards.7: Document C27, C23, POSIX.1-2004, POSIX.1-2013, POSIX.1-2024...
Alejandro Colomar [Tue, 23 Dec 2025 13:39:38 +0000 (14:39 +0100)] 
man/man7/standards.7: Document C27, C23, POSIX.1-2004, POSIX.1-2013, POSIX.1-2024, SUSv5

Cc: Collin Funk <collin.funk1@gmail.com>
Reported-by: Seth McDonald <sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/statmount.2: Document that flags must be 0
Alyssa Ross [Thu, 18 Dec 2025 23:05:17 +0000 (00:05 +0100)] 
man/man2/statmount.2: Document that flags must be 0

Reading the man page for the first time, I assumed the lack of
mentioned flags meant that there weren't any, but I had to check the
kernel source to be sure.  Sure enough:

if (flags)
return -EINVAL;

Signed-off-by: Alyssa Ross <hi@alyssa.is>
Message-ID: <20251218230517.244704-1-hi@alyssa.is>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man7/rtnetlink.7: Document .ifi_change
Alyssa Ross [Thu, 18 Dec 2025 18:54:52 +0000 (19:54 +0100)] 
man/man7/rtnetlink.7: Document .ifi_change

This hasn't been "reserved for future use" since Linux 2.6.22, commit
83b496e928db (2007-05-22; "[RTNETLINK]: Allow changing of subsets of
netdevice flags in rtnl_setlink"), and it's used by iproute2.

Signed-off-by: Alyssa Ross <hi@alyssa.is>
Message-ID: <20251218185452.88205-1-hi@alyssa.is>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: Eric Dumazet <edumazet@google.com>
Cc: Jakub Kicinski <kuba@kernel.org>
Cc: Paolo Abeni <pabeni@redhat.com>
Cc: Simon Horman <horms@kernel.org>
Cc: <netdev@vger.kernel.org>
Cc: <linux-kernel@vger.kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/getopt_long.3: Document the equivalent of getopt(3)'s 'optopt'
G. Branden Robinson [Sun, 14 Dec 2025 01:37:54 +0000 (19:37 -0600)] 
man/man3/getopt_long.3: Document the equivalent of getopt(3)'s 'optopt'

Throw a bone to users of this function who need to report (in a
diagnostic message, for instance) the identity of an invalid long option
name.

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Message-ID: <20251214013754.hvrmeblfbr3cb4he@illithid>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man2/clone.2: ERRORS: Document E2BIG-based extension handshake
Florian Weimer [Mon, 15 Dec 2025 10:34:29 +0000 (11:34 +0100)] 
man/man2/clone.2: ERRORS: Document E2BIG-based extension handshake

The clone3() system call uses copy_struct_from_user() and the E2BIG
error code to handle changes to the struct clone_args size.

Signed-off-by: Florian Weimer <fweimer@redhat.com>
Message-ID: <lhua4zkxccq.fsf@oldenburg.str.redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/updwtmp.3: logwtmp(): Rename function parameter
Alejandro Colomar [Fri, 12 Dec 2025 21:29:30 +0000 (22:29 +0100)] 
man/man3/updwtmp.3: logwtmp(): Rename function parameter

For consistency with utmp(5)'s ut_user.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/aligned_alloc.3: HISTORY: Document bogus specification from C11
Alejandro Colomar [Mon, 15 Dec 2025 14:14:48 +0000 (15:14 +0100)] 
man/man3/aligned_alloc.3: HISTORY: Document bogus specification from C11

Document the turbulent past of aligned_alloc(), and how libraries have
actually implemented it.

Fixes: 7fd1e0f2be21 (2023-05-20; "posix_memalign.3: Update aligned_alloc(3) to match C17")
Reported-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Reviewed-by: "G. Branden Robinson" <branden@debian.org>
Cc: Seth McDonald <sethmcmail@pm.me>
Cc: DJ Delorie <dj@redhat.com>
Cc: John Scott <jscott@posteo.net>
Cc: Paul Floyd <pjfloyd@wanadoo.fr>
Cc: <misc@openbsd.org>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/memalign.3: wfix
Alejandro Colomar [Wed, 10 Dec 2025 13:15:48 +0000 (14:15 +0100)] 
man/man3/memalign.3: wfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: NOTES: Remove superfluous section
Alejandro Colomar [Wed, 10 Dec 2025 12:27:52 +0000 (13:27 +0100)] 
man/man3/posix_memalign.3: NOTES: Remove superfluous section

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: Remove redundant text
Alejandro Colomar [Wed, 10 Dec 2025 12:27:33 +0000 (13:27 +0100)] 
man/man3/posix_memalign.3: Remove redundant text

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: CAVEATS: Add section, and move paragraph to it
Alejandro Colomar [Wed, 10 Dec 2025 12:26:07 +0000 (13:26 +0100)] 
man/man3/posix_memalign.3: CAVEATS: Add section, and move paragraph to it

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/{aligned_alloc,posix_memalign}.3: Split aligned_alloc() from posix_memalign(3)
Alejandro Colomar [Wed, 10 Dec 2025 12:23:54 +0000 (13:23 +0100)] 
man/man3/{aligned_alloc,posix_memalign}.3: Split aligned_alloc() from posix_memalign(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/{posix_memalign,valloc}.3: Split valloc() from posix_memalign(3)
Alejandro Colomar [Wed, 10 Dec 2025 12:09:11 +0000 (13:09 +0100)] 
man/man3/{posix_memalign,valloc}.3: Split valloc() from posix_memalign(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/{posix_memalign,pvalloc}.3: Split pvalloc() from posix_memalign(3)
Alejandro Colomar [Wed, 10 Dec 2025 12:00:04 +0000 (13:00 +0100)] 
man/man3/{posix_memalign,pvalloc}.3: Split pvalloc() from posix_memalign(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/{posix_,}memalign.3: Split memalign() from posix_memalign(3)
Alejandro Colomar [Wed, 10 Dec 2025 11:50:21 +0000 (12:50 +0100)] 
man/man3/{posix_,}memalign.3: Split memalign() from posix_memalign(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: STANDARDS: aligned_alloc() and posix_memalign() conform...
Alejandro Colomar [Wed, 10 Dec 2025 11:37:25 +0000 (12:37 +0100)] 
man/man3/posix_memalign.3: STANDARDS: aligned_alloc() and posix_memalign() conform to POSIX.1-2024

Cc: Seth McDonald <sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C23
Alejandro Colomar [Wed, 10 Dec 2025 11:28:02 +0000 (12:28 +0100)] 
man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C23

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C17, not C11
Alejandro Colomar [Wed, 10 Dec 2025 11:21:04 +0000 (12:21 +0100)] 
man/man3/posix_memalign.3: STANDARDS: aligned_alloc() conforms to C17, not C11

ISO C17 removed a restriction that was in place in C11.  This
documentation doesn't conform to C11; it conforms to C17.

Fixes: 7fd1e0f2be21 (2023-05-20; "posix_memalign.3: Update aligned_alloc(3) to match C17")
Reported-by: Seth McDonald <sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: wfix
Alejandro Colomar [Wed, 10 Dec 2025 11:16:38 +0000 (12:16 +0100)] 
man/man3/posix_memalign.3: wfix

Document aligned_alloc(3), and then say memalign(3) is equivalent,
instead of the other way around.  aligned_alloc(3) is the important one.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/posix_memalign.3: Remove confusing exception
Alejandro Colomar [Wed, 10 Dec 2025 11:14:01 +0000 (12:14 +0100)] 
man/man3/posix_memalign.3: Remove confusing exception

This is already a requirement of memalign(3).  aligned_alloc(3)
is indeed exactly equivalent to memalign(3), since ISO C17.

Fixes: 7fd1e0f2be21 (2023-05-20; "posix_memalign.3: Update aligned_alloc(3) to match C17")
Reported-by: Seth McDonald <sethmcmail@pm.me>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/getopt_long*.3: Split getopt_long_only() from getopt_long(3)
Alejandro Colomar [Sun, 7 Dec 2025 16:01:47 +0000 (17:01 +0100)] 
man/man3/getopt_long*.3: Split getopt_long_only() from getopt_long(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/getopt_long.3: SYNOPSIS: Simplify feature test macro
Alejandro Colomar [Sun, 7 Dec 2025 15:45:55 +0000 (16:45 +0100)] 
man/man3/getopt_long.3: SYNOPSIS: Simplify feature test macro

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/getopt*.3: Split getopt_long*() from getopt(3)
Alejandro Colomar [Sun, 7 Dec 2025 15:15:57 +0000 (16:15 +0100)] 
man/man3/getopt*.3: Split getopt_long*() from getopt(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/*s*printf.3: Split [v]sprintf() from snprintf(3)
Alejandro Colomar [Sun, 7 Dec 2025 16:34:10 +0000 (17:34 +0100)] 
man/man3/*s*printf.3: Split [v]sprintf() from snprintf(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 months agoman/man3/*printf.3: Split *s*printf() from printf(3)
Alejandro Colomar [Fri, 5 Dec 2025 11:46:37 +0000 (12:46 +0100)] 
man/man3/*printf.3: Split *s*printf() from printf(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man5/proc.5: Remove redundant paragraph
Alejandro Colomar [Thu, 4 Dec 2025 15:36:11 +0000 (16:36 +0100)] 
man/man5/proc.5: Remove redundant paragraph

We already reference the manual pages by name.

Fixes: ba0d674b67d6 (2025-12-02; "man/man5/proc*.5: Add references to other proc*.5 pages")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoshare/mk/: help-list-variables: Don't list undefined variables
Alejandro Colomar [Thu, 4 Dec 2025 14:38:49 +0000 (15:38 +0100)] 
share/mk/: help-list-variables: Don't list undefined variables

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoshare/mk/: $UNIQ: Add dependency
Alejandro Colomar [Thu, 4 Dec 2025 14:38:17 +0000 (15:38 +0100)] 
share/mk/: $UNIQ: Add dependency

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoshare/mk/: help-list-targets: Use 'make -n'
Alejandro Colomar [Thu, 4 Dec 2025 14:03:27 +0000 (15:03 +0100)] 
share/mk/: help-list-targets: Use 'make -n'

This makes the command more portable to arbitrary makefiles,
as one can run any target without fear of running any commands.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoshare/mk/: help, help-*: Add targets to list targets, variables, and build dependencies
Alejandro Colomar [Thu, 4 Dec 2025 13:55:01 +0000 (14:55 +0100)] 
share/mk/: help, help-*: Add targets to list targets, variables, and build dependencies

Suggested-by: Paolo Bonzini <bonzini@gnu.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoGNUmakefile: wsfix
Alejandro Colomar [Thu, 4 Dec 2025 13:57:52 +0000 (14:57 +0100)] 
GNUmakefile: wsfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoshare/mk/: $TR: Add dependency
Alejandro Colomar [Thu, 4 Dec 2025 12:33:27 +0000 (13:33 +0100)] 
share/mk/: $TR: Add dependency

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/PR_SET_NAME.2const: SYNOPSIS: Fix prototype
Alejandro Colomar [Wed, 3 Dec 2025 16:54:41 +0000 (17:54 +0100)] 
man/man2const/PR_SET_NAME.2const: SYNOPSIS: Fix prototype

The array may be narrower than that.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/PR_SET_NAME.2const: SYNOPSIS: tfix
Alejandro Colomar [Wed, 3 Dec 2025 16:50:35 +0000 (17:50 +0100)] 
man/man2const/PR_SET_NAME.2const: SYNOPSIS: tfix

Fixes: a4fc95108363 (2024-05-31; "prctl.2, PR_[SG]ET_NAME.2const: Split PR_[SG]ET_NAME from prctl(2)")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man5/proc*.5: Add references to other proc*.5 pages
Alejandro Colomar [Tue, 2 Dec 2025 00:34:43 +0000 (01:34 +0100)] 
man/man5/proc*.5: Add references to other proc*.5 pages

Fixes: 0569afbbccd6 (2023-08-17; "proc*.5: Make sashimi")
Reported-by: "Michael T. Kerrisk" <mtk.manpages@gmail.com>
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/: Make sashimi of ipv6(7)
Alejandro Colomar [Tue, 2 Dec 2025 00:04:33 +0000 (01:04 +0100)] 
man/: Make sashimi of ipv6(7)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/IPV6_V6ONLY.2const: Tweak after split
Alejandro Colomar [Tue, 2 Dec 2025 00:03:32 +0000 (01:03 +0100)] 
man/man2const/IPV6_V6ONLY.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/{IPPROTO_IPV6,IPV6_V6ONLY}.2const: Split IPV6_V6ONLY from IPPROTO_IPV6...
Alejandro Colomar [Tue, 2 Dec 2025 00:01:27 +0000 (01:01 +0100)] 
man/man2const/{IPPROTO_IPV6,IPV6_V6ONLY}.2const: Split IPV6_V6ONLY from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/IPV6_UNICAST_HOPS.2const: Tweak after split
Alejandro Colomar [Mon, 1 Dec 2025 23:44:12 +0000 (00:44 +0100)] 
man/man2const/IPV6_UNICAST_HOPS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/{IPPROTO_IPV6,IPV6_UNICAST_HOPS}.2const: Split IPV6_UNICAST_HOPS from...
Alejandro Colomar [Mon, 1 Dec 2025 23:42:04 +0000 (00:42 +0100)] 
man/man2const/{IPPROTO_IPV6,IPV6_UNICAST_HOPS}.2const: Split IPV6_UNICAST_HOPS from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/IPV6_ROUTER_ALERT.2const: Tweak after split
Alejandro Colomar [Mon, 1 Dec 2025 23:35:22 +0000 (00:35 +0100)] 
man/man2const/IPV6_ROUTER_ALERT.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/{IPPROTO_IPV6,IPV6_ROUTER_ALERT}.2const: Split IPV6_ROUTER_ALERT from...
Alejandro Colomar [Mon, 1 Dec 2025 23:33:29 +0000 (00:33 +0100)] 
man/man2const/{IPPROTO_IPV6,IPV6_ROUTER_ALERT}.2const: Split IPV6_ROUTER_ALERT from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/IPV6_RECVERR.2const: Tweak after split
Alejandro Colomar [Mon, 1 Dec 2025 23:25:16 +0000 (00:25 +0100)] 
man/man2const/IPV6_RECVERR.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/{IPPROTO_IPV6,IPV6_RECVERR}.2const: Split IPV6_RECVERR from IPPROTO_IPV...
Alejandro Colomar [Mon, 1 Dec 2025 23:23:51 +0000 (00:23 +0100)] 
man/man2const/{IPPROTO_IPV6,IPV6_RECVERR}.2const: Split IPV6_RECVERR from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/man2const/IPV6_RTHDR.2const: Tweak after split
Alejandro Colomar [Mon, 1 Dec 2025 23:06:04 +0000 (00:06 +0100)] 
man/man2const/IPV6_RTHDR.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>