man/man2/fcntl.2, man/man2const/F_GET_RW_HINT.2const: Split F_{G,S}ET{,_FILE}_RW_HINT from fcntl(2)

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

man/man2const/F_{GET,ADD}_SEALS.2const: Tweak after split, and add link page

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

man/man2/fcntl.2, man/man2const/F_GET_SEALS.2const: Split F_{GET,ADD}_SEALS from fcntl(2)

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

man/man2const/F_{G,S}ETPIPE_SZ.2const: Tweak after split, and add link page

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

man/man2/fcntl.2, man/man2const/F_GETPIPE_SZ.2const: Split F_{G,S}ETPIPE_SZ from fcntl(2)

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

man/man2const/F_{G,S}ETFL.2const: Tweak after split, and add link page

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

man/man2/fcntl.2, man/man2const/F_GETFL.2const: Split F_{G,S}ETFL from fcntl(2)

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

man/man2const/F_{G,S}ETFD.2const: Tweak after split, and add link page

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

man/man2/fcntl.2, man/man2const/F_GETFD.2const: Split F_{G,S}ETFD from fcntl(2)

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

man/man2const/F_DUPFD{,_CLOEXEC}.2const: Tweak after split, and add link page

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

man/man2/fcntl.2, man/man2const/F_DUPFD.2const: Split F_DUPFD and F_DUPFD_CLOEXEC from fcntl(2)

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

man/: Replace reserved exp identifier

Since exp is a library function, this is a reserved identifier, which
should not be used as a variable name / parameter.

Signed-off-by: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/printf.3: Mention Android's %m support.

In future we might want to note that it's _not_ available on iOS/macOS
and the BSDs, since that's the caveat I usually give when recommending
the use of %m.

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

man/man2/clone.2: Move ia64 to HISTORY

Reported-by: Elliott Hughes <enh@google.com>
Cc: Carlos O'Donell <carlos@redhat.com>
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Cc: Walter Harms <wharms@bfs.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

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

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

man/man2/seccomp.2: Add link to post about using seccomp(2) in filters

Suggested-by: Terence Kelly <tpkelly@eecs.umich.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/stpncpy.3: RETURN VALUE: wfix

This is for consistency with wcpncpy(3).

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

man/man3/wcpncpy.3: RETURN VALUE: Fix incorrect wording

Fixes: d91506f8faa4 (1999-08-24, 2022-12-19; "man-pages 1.26")
Reported-by: Elliott Hughes <enh@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

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>