man/: SYNOPSIS: Don't highlight forward declarations of function parameters

Previously, many people confused these for actual parameters, since it's
hard to distinguish a ',' from ';'.  By removing bold/italics from
these, it will be easier to distinguish them.

The cases have been found with a script:

$ find -type f \
| xargs grep -l '^\.TH ' \
| sort \
| xargs mansect SYNOPSIS \
| man /dev/stdin \
| grep -e '^[^ ]' -e '[^ ]( [^ )].*[^)];' \
| less;

Reported-by: Mark Naughton <mnaughto@redhat.com>
Suggested-by: Mark Harris <mark.hsj@gmail.com>
Acked-by: Mark Naughton <mnaughto@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: uninstall-man: Fix support for pages with ':' in their file name

I don't know when this was exacly broken, since we didn't have such
pages until now.

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

man/man3attr/gnu::aligned.3attr: Add page

Cc: Aaron Ballman <aaron@aaronballman.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3attr/intro.3attr: Add page

Cc: Aaron Ballman <aaron@aaronballman.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man3attr/: Add subsection for attributes

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

man/man3/ftime.3: Reorder and clarify STANDARDS

Put 4.2BSD first and mention that POSIX.1-2001 marked this function as
LEGACY.

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <fcc66f4d8694f933a71688ad529e6f4f43024658.1750646692.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support in fchmodat(2)

Historically, Linux systems did not support the AT_SYMLINK_NOFOLLOW flag
to fchmodat(2).  glibc added userspace emulation support in glibc 2.32,
and Linux gained native support in 6.5.  See glibc.git 6b89c385d8bd
(2020-02-12; "io: Implement lchmod using fchmodat [BZ #14578]") and
linux.git 09da082b07bb (2023-07-27; "fs: Add fchmodat2()").

Signed-off-by: Benjamin Peterson <benjamin@locrian.net>
Message-ID: <20250619051342.145412-2-benjamin@locrian.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/statx.2: Add stx_atomic_write_unit_max_opt

XFS supports atomic writes - or untorn writes - based on two different
methods:
- HW offload in the disk
- FS method based on out-of-place writes

The value reported in stx_atomic_write_unit_max will be the max size of the
FS-based method.

The max atomic write unit size of the FS-based atomic writes will
typically be much larger than what is capable from the HW offload. However,
FS-based atomic writes will also be typically much slower.

Advertise this HW offload size limit to the user in a new statx member,
stx_atomic_write_unit_max_opt.

We want STATX_WRITE_ATOMIC to get this new member in addition to the
already-existing members, so mention that a value of 0 in
stx_atomic_write_unit_max_opt means that stx_atomic_write_unit_max holds
this optimised limit.

Linux will zero unused statx members, so stx_atomic_write_unit_max_opt
will always hold 0 for older kernel versions which do not support
this FS-based atomic write method (for XFS).

Signed-off-by: John Garry <john.g.garry@oracle.com>
Message-ID: <20250619154455.321848-3-john.g.garry@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/statx.2: Properly align stx_dio_read_offset_align

Align this member in struct statx with the members above it.

Signed-off-by: John Garry <john.g.garry@oracle.com>
Message-ID: <20250619154455.321848-2-john.g.garry@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/elf.5: Clarify string table reference for SHT_SYMTAB sections

Add clarification that for SHT_SYMTAB sections, the associated string
table section index can be found in the sh_link member, following the
same pattern documented for section header string tables.

This was discovered while writing an ELF parser, where the sh_link
field is needed to locate the string table for symbol name lookups
in SHT_SYMTAB sections.

Signed-off-by: Dacian Pascu <pascu.dacian@gmail.com>
Message-ID: <78e41dade449bafddfb730b39226f8d9cb3fefdb.1750427945.git.pascu.dacian@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/malloc.3: Shorten parameter name (s/ptr/p/)

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

man/man2/cachestat.2: Add page

The text was converted from the commit message in linux.git
cf264e1329fb (2023-06-09; "cachestat: implement cachestat syscall").

Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=cf264e1329fb0307e044f7675849f9f38b44c11a>
Signed-off-by: Nhat Pham <nphamcs@gmail.com>
Signed-off-by: Matteo Croce <teknoraver@meta.com>
Message-ID: <20250611141350.1829-1-technoboy85@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/core.5: Document the new %F identifier in core_pattern

Signed-off-by: Jelle van der Waa <jvanderw@redhat.com>
Message-ID: <20250616133212.131064-1-jvanderwaa@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/chmod.2: Document fchmodat(AT_EMPTY_PATH)

The documentation and behaviour is indentical to the equivalent flag for
fchownat(2).

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Message-ID: <20250619-fchmod-empty-path-v1-1-feff2c63abe4@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Revert "GNUmakefile: help: Show only variables assigned with '?='"

We don't use ?= anymore (except for MANWIDTH).  We'd like to use ?:=
eventually, but for now we use := surrounded by conditionals.

This reverts commit e18c21096714545db6c4855e20c43bbb1541489c.

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

INSTALL: Adjust file names to match current build system organization.

Signed-off-by: Collin Funk <collin.funk1@gmail.com>
Message-ID: <1cd0d5aa80cdc10a6c03dc8f3f2827d38bc86767.1749795252.git.collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/prctl.2, man/man2const/PR_FUTEX_HASH.2const: Document PR_FUTEX_HASH

Signed-off-by: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
Message-ID: <20250602140104.2769223-2-bigeasy@linutronix.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man1/iconv.1: Mention that -c does not change exit status

And that input decoding failures are treated as errors.

Exiting with status 0 is a POSIX conformance issue that was fixed
in glibc 2.41.

Signed-off-by: Florian Weimer <fweimer@redhat.com>
Message-ID: <87msamxso9.fsf@oldenburg.str.redhat.com>
Reviewed-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/ioctl_vt.2: Document VT_GETCONSIZECSRPOS

Corresponding code is in drivers/tty/vt/vt_ioctl.c.
New in Linux v6.16.

Signed-off-by: Nicolas Pitre <npitre@baylibre.com>
Message-ID: <4n723o1q-pr52-319q-nsr7-6442387s12s2@onlyvoer.pbz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/TIOCLINUX.2const: Document TIOCL_GETBRACKETEDPASTE

Corresponding code is in drivers/tty/vt/vt.c:tioclinux().
New in Linux v6.16.

Signed-off-by: Nicolas Pitre <npitre@baylibre.com>
Message-ID: <o5p79351-1ops-on58-3o20-rp142r6s4o21@onlyvoer.pbz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

etc/checkpatch/checkpatch.conf: Ignore TYPO_SPELLING

It suggest 'cancellation' instead of 'cancelation', but we want the
latter.  Since it hasn't caught anything useful, AFAIR, turn it off.

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

man/man3/scalb*.3: NAME: Document the meaning of the name of these functions

Cc: Alex Celeste <alexg.nvfp@gmail.com>
Reported-by: Jorenar <dev@jorenar.com>
Suggested-by: "Fred J. Tydeman" <tydeman@tybor.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/inet_net_pton.3: SYNOPSIS: ffix

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

man/man3/: Shorten parameter names

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

man/: SYNOPSIS: Use array notation

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

man/man2const/PR_SET_MM_AUXV.2const: SYNOPSIS: Fix position of #include line

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

man/man2const/: TH: Fix subsection

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

man/man2const/KEYCTL_SESSION_TO_PARENT.2const: SYNOPSIS: ffix

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

man/man2/: Fix broken references to proc_sys_vm(5)

Fixes: 0569afbbccd6 (2023-08-17; "proc*.5: Make sashimi")
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <c28f98b90ff40c3944aaa3189627d795e0c2d9f6.1748714599.git.nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Fix name of /proc/sys/vm/hugetlb_shm_group

sysctl_hugetlb_shm_group is the name of the variable in "mm/hugetlb.c".

Fixes: 090fdddb4342 (2021-05-17; "memfd_create.2, mmap.2, shmget.2: Document the EPERM for huge page allocations")
Fixes: 6cee0ddeb414 (2021-05-17; "proc.5: Document /proc/sys/vm/sysctl_hugetlb_shm_group")
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <22436441b7bac0177213c99c55187c4af085d4ca.1748714599.git.nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/mbind.2: SYNOPSIS: ffix

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

man/man2/: SYNOPSIS: Use array notation

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

man/man2/open.2: Fix doc for O_CREAT | O_DIRECTORY

Although Linux kernels before 5.7 would create a regular file when
opening a nonexistent file with O_CREAT | O_DIRECTORY, this behavior
was changed to something deeply buggy in 5.7, and when the bug was
fixed in 6.4 this combination of open flags became invalid.

Adjust the documentation to match the 6.4+ behavior,
which makes more sense anyway.

Signed-off-by: Paul Eggert <eggert@cs.ucla.edu>
Message-ID: <20250530072029.344532-1-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/futex.2, man/man2const/FUTEX_*.2const: Make sashimi of futex(2)

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

man/man2/futex.2: Tweak after making sashimi of this page

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

man/man2const/FUTEX_WAIT_REQUEUE_PI.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_WAIT_REQUEUE_PI.2const: Split FUTEX_WAIT_REQUEUE_PI from futex(2)

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

man/man2const/FUTEX_CMP_REQUEUE_PI.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_CMP_REQUEUE_PI.2const: Split FUTEX_CMP_REQUEUE_PI from futex(2)

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

man/man2const/FUTEX_UNLOCK_PI.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_UNLOCK_PI.2const: Split FUTEX_UNLOCK_PI from futex(2)

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

man/man2const/FUTEX_TRYLOCK_PI.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_TRYLOCK_PI.2const: Split FUTEX_TRYLOCK_PI from futex(2)

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

man/man2const/FUTEX_LOCK_PI2.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_LOCK_PI2.2const: Split FUTEX_LOCK_PI2 from futex(2)

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

man/man2const/FUTEX_LOCK_PI.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_LOCK_PI.2const: Split FUTEX_LOCK_PI from futex(2)

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

man/man2const/FUTEX_WA??_BITSET.2const: Tweak after split, and add link page

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

man/man2/futex.2, man/man2const/FUTEX_WAIT_BITSET.2const: Split FUTEX_WAIT_BITSET and FUTEX_WAKE_BITSET from futex(2)

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

man/man2const/FUTEX_WAKE_OP.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_WAKE_OP.2const: Split FUTEX_WAKE_OP from futex(2)

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

man/man2const/FUTEX_CMP_REQUEUE.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_CMP_REQUEUE.2const: Split FUTEX_CMP_REQUEUE from futex(2)

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

man/man2const/FUTEX_REQUEUE.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_REQUEUE.2const: Split FUTEX_REQUEUE from futex(2)

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

man/man2const/FUTEX_FD.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_FD.2const: Split FUTEX_FD from futex(2)

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

man/man2const/FUTEX_WAKE.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_WAKE.2const: Split FUTEX_WAKE from futex(2)

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

man/man2const/FUTEX_WAIT.2const: Tweak after split

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

man/man2/futex.2, man/man2const/FUTEX_WAIT.2const: Split FUTEX_WAIT from futex(2)

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

man/man2/futex.2: De-duplicate information about timeouts

And be more explicit about the one case that's different.

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

man/man2/futex.2: Prepare for sashimi

-  Remove dead code (redundant .P).
-  Adjust white space.
-  Remove redundant note.
-  Use the same language as always about returning -1 and setting errno.
-  Split errors.

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

man/man2/sched_setaffinity.2: EXAMPLES: Use 0 instead of getpid()

getpid() is superfluous here.

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <v5p4zfqrepnrorszmuie47aiulivcykicxuhtxfkqhrq5t3cis@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/link.2: Update manual page reference

proc(5) was split into many small pages recently.

Reported-by: Pali Rohár <pali@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/futex.2: wfix

Suggested-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/futex.2: tfix

Fixes: 3dfcc11d4630 (2015-12-15; "futex.2: Expand description of FUTEX_CMP_REQUEUE")
Fixes: 8297383e9eeb (2015-12-15; "futex.2: Clean-ups and FIXME removeal after feedback from Thomas Gleixner")
Reported-by: Jens Gustedt <jens.gustedt@inria.fr>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/proc_meminfo.5: Shmem also accounts for other types of shared memory

Reported-by: Carsten Grohmann <carstengrohmann@gmx.de>
Message-ID: <20250523122617.48cf9feb@max.localdomain>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/syscall.2: x86-64 + x32 syscall numbers go in eax

The kernel sign-extends eax before dispatching syscalls.
From arch/x86/entry/entry_64.S:
> movslq %eax, %rsi
> IBRS_ENTER
> UNTRAIN_RET
> CLEAR_BRANCH_HISTORY
>
> call do_syscall_64 /* returns with IRQs disabled */

This patch updates syscall.2 to document this. ARM64 exhibits a
similar behavior (w8 is extended), which is already documented.

Signed-off-by: Ben Kallus <benjamin.p.kallus.gr@dartmouth.edu>
Message-ID: <20250518234507.404608-1-benjamin.p.kallus.gr@dartmouth.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/mbrtowc.3: RETURN VALUE: Tweak description of -2 return

Signed-off-by: Steffen Nurpmeso <steffen@sdaoden.eu>
Message-ID: <f90b33d398ccf814083e300454df88e0937b94d3.1747784310.git.steffen@sdaoden.eu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/*printf.3: Document ERRORS

The printf family of functions set errno if a negative value is returned.

Source is POSIX.1, see
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/fprintf.html>
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/fwprintf.html>

Also see manual pages of FreeBSD and OpenBSD.

Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org>
Message-ID: <34octlcodbwm3kfqlouvrvhriiftmlzzobbohgzivlkgi53nfs@7gxajeb56klz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/UFFDIO_API.2const: Add an entry for UFFDIO_FEATURE_MOVE

Add the entry for UFFDIO_MOVE ioctl in UFFDIO_API man page.

Fixes: d7dec35a3b19 ("man/man2/ioctl_userfaultfd.2, man/man2const/UFFDIO_MOVE.2const: Document UFFDIO_MOVE")
Reviewed-by: Suren Baghdasaryan <surenb@google.com>
Signed-off-by: Peter Xu <peterx@redhat.com>
Message-ID: <20250514172630.569788-3-peterx@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/UFFDIO_API.2const: Update userfaultfd handshake and feature probe

There's a confusing paragraph in the man page on two-steps handshake for
userfaultfd UFFDIO_API ioctl.  In reality, after a successful UFFDIO_API
ioctl, the userfaultfd will be locked up on the features and any further
UFFDIO_API on top of an initialized userfaultfd would fail.

Modify the UFFDIO_API(2const) man page to reflect the reality.  Instead,
add a paragraph explaining the right way to probe userfaultfd features.
Add that only after the "Before Linux 4.11" paragraph, as the old kernel
doesn't support any feature anyway.

Fixes: a252b3345 ("ioctl_userfaultfd.2: Describe two-step feature handshake")
Reviewed-by: Kyle Huey <khuey@kylehuey.com>
Signed-off-by: Peter Xu <peterx@redhat.com>
Message-ID: <20250514172630.569788-2-peterx@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*: grfix

Scripted change:

$ grep -rl 'The authors of the Linux man-pages' \
| xargs sed -i '/Copyright, The authors of the Linux man-pages project/s/The/the/';

Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

README: Files: Update man/ path

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

AUTHORS: Update emails

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

README: Files: Document the AUTHORS file

Suggested-by: Dave Martin <Dave.Martin@arm.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*, AUTHORS: Consistently refer to authors

-  Rename the file CREDITS => AUTHORS

-  Say 'authors' in the copyright notice.  Scripted change:

$ grep -rn 'The contributors to the Linux man-pages' -l \
| xargs sed -i '/Copyright, The contributors to the Linux man-pages project/s/contributors to/authors of/'

Suggested-by: Dave Martin <Dave.Martin@arm.com>
Acked-by: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/: VERSIONS: POSIX.1-2024 specifies *_CLOFORK, but Linux doesn't support it

Link: <https://lore.kernel.org/all/20200515160342.GE23230@ZenIV.linux.org.uk/>
Cc: Mateusz Guzik <mjguzik@gmail.com>
Cc: Jeff Layton <jlayton@kernel.org>
Cc: Chuck Lever <chuck.lever@oracle.com>
Cc: <linux-fsdevel@vger.kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Consistently use 'path' for parameters referring to pathnames

And use 'pathname' in the descriptions.

'pathname' is the POSIXly correct term, and 'path' is a reasonable
abbreviation for it in parameter names.

Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

lsm: tfix

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

Start of man-pages-NEXT: Move Changes to Changes.old

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

Changes.old: Remove empty fields

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

lsm: Released 6.14

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

Changes: Ready for 6.14

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

man/man3/[static_]assert.3: SYNOPSIS: Use 'bool' instead of 'scalar'

The type _Bool perfectly models these APIs.  Conversion from any scalar
type to _Bool results in true if the value is non-zero, and false if it
is zero.

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

man/: Refresh pages from tzdb-2025b

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

man/man7/bpf-helpers.7: Refresh page from Linux v6.14

Scripted change:

$ ~/src/linux/linux/v6.14/scripts/bpf_doc.py \
| rst2man \
>man/man7/bpf-helpers.7;

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

CREDITS: Add commit authors

Link: <https://lore.kernel.org/linux-man/jpin2dbnp5vpitnh7l4qmvkamzq3h3xljzsznrudgioox3nn72@57uybxbe3h4p/T/#u>
Link: <https://www.linuxfoundation.org/blog/blog/copyright-notices-in-open-source-software-projects>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Carlos O'Donell <carlos@redhat.com>
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*, CREDITS: Unify copyright notices

Link: <https://lore.kernel.org/linux-man/jpin2dbnp5vpitnh7l4qmvkamzq3h3xljzsznrudgioox3nn72@57uybxbe3h4p/T/#u>
Link: <https://www.linuxfoundation.org/blog/blog/copyright-notices-in-open-source-software-projects>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Carlos O'Donell <carlos@redhat.com>
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/build/: Ignore known diagnostics

"cannot adjust line", which is due to the long URI added to See also.

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

man/, CREDITS: Move in-source contribution records to CREDITS

This information is better placed in the git logs, not in the source
code itself.  For people interested in the old history of pages, before
we used git, they will probably look at old versions of these pages,
like for example man-pages-1.70, or the 'prehistory' branch, and there
they'll find these notes.

Keep the names and emails of contributors in a new CREDITS file.

Link: <https://lore.kernel.org/linux-man/jpin2dbnp5vpitnh7l4qmvkamzq3h3xljzsznrudgioox3nn72@57uybxbe3h4p/T/#u>
Link: <https://www.linuxfoundation.org/blog/blog/copyright-notices-in-open-source-software-projects>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Carlos O'Donell <carlos@redhat.com>
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

src/bin/diffman-git: Disable adjustment by default

One can still enable it by setting an empty MANROFFOPT.

Suggested-by: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/TIOCLINUX.2const: Document CAP_SYS_ADMIN requirement for TIOCL_SETSEL modes

CAP_SYS_ADMIN was previously required for the entire TIOCL_SETSEL
subcode, but is now only needed for a subset of the selection modes,
since linux.git 2f83e38a095f (2025-01-13; "tty: Permit some
TIOCL_SETSEL modes without CAP_SYS_ADMIN").

The CAP_SYS_ADMIN requirement for TIOCL_SELMOUSEREPORT was further
corrected in linux.git ee6a44da3c87 (2025-04-11; "tty: Require
CAP_SYS_ADMIN for all usages of TIOCL_SELMOUSEREPORT").

Admittedly, there are kernels where CAP_SYS_ADMIN was briefly not
required for TIOCL_SELMOUSEREPORT, even after Linux v6.7, but this was
a mistake which is now fixed in all up-to-date stable kernels.
Therefore, we still document CAP_SYS_ADMIN as required "since Linux
6.7" in this case.

Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=2f83e38a095f8bf7c6029883d894668b03b9bd93>
Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=ee6a44da3c87cf64d67dd02be8c0127a5bf56175>
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Message-ID: <20250502102405.4891-2-gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/memfd_secret.2: It is now enabled by default

In linux.git b758fe6df50d (2023-06-09; "mm/secretmem: make it on by
default") memfd_secret was updated to be enabled by default.

Signed-off-by: Thiébaud Weksteen <tweek@google.com>
Message-ID: <20250428020252.1569621-1-tweek@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/close_range.2: EXAMPLES: Correct output of example program

The output shown for the example program listed /tmp/b twice;
the second /tmp/b should be /tmp/c.

Fixes: 336bd62ba24c (2021-03-21; "close_range.2: Include a better example program")
Signed-off-by: Quentin Armitage <quentin@armitage.org.uk>
Message-ID: <e8519ea77798c68944717bc6437052a1119a911f.camel@armitage.org.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/mmap.2: CAVEATS: Document danger of mappings larger than PTRDIFF_MAX

References:
 - C99 draft: https://www.open-std.org/jtc1/sc22/wg14/www/docs/n1124.pdf
   section "6.5.6 Additive operators", paragraph 9
 - object size restriction in GCC:
   https://gcc.gnu.org/legacy-ml/gcc/2011-08/msg00221.html
 - glibc malloc restricts object size to <=PTRDIFF_MAX in
   checked_request2size() since glibc v2.30 (released in 2019, as pointed
   out by Jakub Wilk):
   https://sourceware.org/cgit/glibc/commit/?id=9bf8e29ca136094f

Signed-off-by: Jann Horn <jannh@google.com>
Message-ID: <20250429164359.2699330-1-jannh@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/ioctl_userfaultfd.2, man/man2const/UFFDIO_MOVE.2const: Document UFFDIO_MOVE

Documentation was extracted from the original patch written by Andrea
Arcangeli and upstreamed in [1].  Minor edits were made to maintain
the same documentation style as other userfaultfd ioctl commands.

[1] <https://lore.kernel.org/all/20231206103702.3873743-3-surenb@google.com/>

Signed-off-by: Suren Baghdasaryan <surenb@google.com>
Message-ID: <20250423195309.2841410-1-surenb@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/madvise.2: Update MADV_GUARD_INSTALL, MADV_GUARD_REMOVE for Linux 6.15

Lightweight guard region support has been extended in Linux 6.15,
permitting the use of these features for file-backed and read-only
mappings.

Update the description for these operations in the madvise manpage to
describe the changed behaviour.

Signed-off-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Message-ID: <20250423183105.116978-1-lorenzo.stoakes@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/slist.3: SYNOPSIS: Add missing argument

Fixes: bb8164dec0c4 (2020-10-22; "slist.3: ffix: Use man markup")
Signed-off-by: Solomon Tan <wjsota@icloud.com>
Message-ID: <20250420124447.1552510-2-wjsota@icloud.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>