man/man2/mremap.2: Describe previously undocumented shrink behaviour

There is pre-existing logic that appears to be undocumented for an
mremap() shrink operation, where it turns out that the usual 'input
range must span a single mapping' requirement no longer applies.

In fact, it turns out that the input range specified by [old_address,
old_address + old_size) may span any number of mappings.

If shrinking in-place (that is, neither the MREMAP_FIXED nor
MREMAP_DONTUNMAP flags are specified), then the new span may also span
any number of VMAs - [old_address, old_address + new_size).

If shrinking and moving, the range specified by [old_address,
old_address + new_size) must span a single VMA.

There must be at least one VMA contained within the [old_address,
old_address + old_size) range, and old_address must be within the range
of a VMA.

Explicitly document this.

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

man/man2/: SYNOPSIS: Use GNU forward-declarations of parameters for sizes of array parameters

Fixes: d2c2db8830f8 (2025-03-14; "man/: SYNOPSIS: Use GNU forward-declarations of parameters for sizes of array parameters")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: EXAMPLES: Use err(3) and errc(3bsd) instead of similar macros

These functions are quite portable.  And if one doesn't have them for
some reason (but libbsd has been ported to many systems), one can write
them easily as macros, anyway.

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

man/man3/strftime.3: EXAMPLES: Validate number of arguments

The strftime example requires a format paramter.  If you don't pass one,
it crashes.  Check for the parameter.

Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
Message-ID: <20250818174553.70132-1-dave@treblig.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/operator.7: Add _Countof and alignof

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

man/man7/operator.7: Add compound literal

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

man/man7/operator.7: Add some primary expressions that look like operators

This allows comparing them with the precedence of operators.

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

man/man3/countof.3: Add page

Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3550.pdf#subsubsection.0.6.5.4.5>
Link: <https://thephd.dev/the-big-array-size-survey-for-c>
Link: <https://thephd.dev/the-big-array-size-survey-for-c-results>
Link: <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=117025>
Link: <https://github.com/llvm/llvm-project/issues/102836>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

PR_FUTEX_HASH_GET_SLOTS.2const: Add page

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

man/man2const/PR_FUTEX_HASH.2const: Update as of Linux v6.17-rc2

The PR_FUTEX_HASH prctl interface was updated shortly before the release
of v6.16.  The changes are:
-  The functionality was disabled in v6.16 and enabled v6.17-rc1 after
   some updates address the performance concerns.
-  The "IMMUTABLE" functionality was removed.

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

man/man3/posix_spawn.3: EXAMPLES: Validate the number of arguments

Make the example check for an executable name on the command line
rather than segfaulting in the child.

Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
Message-ID: <20250818225910.101238-1-dave@treblig.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/getrusage.2: Use correct unit (KiB) for .ru_maxrss

The .ru_maxrss member was documented as using "kilobytes" as its unit.
However, the value is actually in multiples of 1024 bytes, which is
correctly referred to as "kibibytes" (KiB) according to the IEC
standard.

Message-ID: <20250818075905.40146-1-himself65@outlook.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

src/bin/diffman-git: Show sections as hunk context

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

man/man2/syslog.2: SYNOPSIS: Remove incorrect include

It doesn't provide any macros, as said later in the page.  The
programmer must either define the macros itself, or use the raw values.

Fixes: e5a173829179 (2021-06-20; "syslog.2: Use syscall(SYS_...); for raw system calls")
Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=220273>
Reported-by: Nathaniel Manista <nathaniel@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/sem_post.3: ERRORS: Clarify EOVERFLOW

Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=219335>
Signed-off-by: Alex Tran <alex.t.tran@gmail.com>
Message-ID: <20250818042558.95341-1-alex.t.tran@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/mallinfo.3: Reduce MAX_ALLOCS

The current mallinfo2() example segfaults on 64bit Linux.
This happens because it builds a large 'alloc' array
on the stack, which is currently 2M entries, each of which
is a pointer, so hitting 16MB which is more than the default
Linux stack ulimit of 8MiB.

Reduce it.

Signed-off-by: "Dr. David Alan Gilbert" <dave@treblig.org>
Message-ID: <20250816204252.63616-1-dave@treblig.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/mremap.2: Describe multiple-mapping move

Document the new behaviour introduced in Linux 6.17 whereby it is now
possible to move multiple mappings in a single operation, as long as the
operation is purely a move, that is, old_size == new_size and
MREMAP_FIXED is specified.

This change also explains the limitations of this method and the
possibility of partial failure.

Finally, we pluralise language where it makes sense to so the documentation
does not contradict either this new capability nor the pre-existing edge
case.

Example code is enclosed below demonstrating the behaviour which is now
possible:

#define _GNU_SOURCE
#include <err.h>
#include <stddef.h>
#include <stdlib.h>
#include <sys/mman.h>
#include <unistd.h>

int
main(void)
{
void    *ptr, *tgt_ptr;
size_t  page_size;

page_size = sysconf(_SC_PAGESIZE);
ptr = mmap(NULL, 10 * page_size, PROT_READ | PROT_WRITE,
       MAP_ANON | MAP_PRIVATE, -1, 0);
if (ptr == MAP_FAILED)
err(EXIT_FAILURE, "mmap");

tgt_ptr = mmap(NULL, 10 * page_size, PROT_NONE,
       MAP_ANON | MAP_PRIVATE, -1, 0);
if (tgt_ptr == MAP_FAILED)
err(EXIT_FAILURE, "mmap");

/* Unmap every other page. */
for (int i = 1; i < 10; i += 2)
munmap(ptr + i * page_size, page_size);

/* Now move all 5 distinct mappings to tgt_ptr. */
ptr = mremap(ptr, 10 * page_size, 10 * page_size,
     MREMAP_MAYMOVE | MREMAP_FIXED, tgt_ptr);
if (ptr == MAP_FAILED)
err(EXIT_FAILURE, "mremap");

exit(EXIT_SUCCESS);
}

Signed-off-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Message-ID: <4e0c992a6374e417367475e3b3bbbc9d43380f4c.1754924278.git.lorenzo.stoakes@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/mremap.2: Explicitly document the simple move operation

In preparation for discussing newly introduced mremap() behaviour to
permit the move of multiple mappings at once, add a section to the
this manual page to describe these operations in general.

Signed-off-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Message-ID: <0a5d0d6e9f75e8e2de05506f73c41b069d77de36.1754924278.git.lorenzo.stoakes@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/cgroups.7: plfix

Signed-off-by: Ian <ilc@ilcharle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/getgroups.2: setgroups(2): Don't use NULL as a 0-length array

Reported-by: Christopher Bazley <chris.bazley.wg14@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/setlocale.3: SYNOPSIS: Use _Nullable

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

man/man2/mount_setattr.2: ffix

Reported-by: Askar Safin <safinaskar@zohomail.com>
Cc: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2type/open_how.2type: Move VERSIONS to HISTORY

Reported-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/mount_setattr.2: Document glibc >= 2.36 syscall wrappers

glibc 2.36 added syscall wrappers for the entire family of fd-based
mount syscalls, including mount_setattr(2).  Thus it's no longer
necessary to instruct users to do raw syscall(2) operations.

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Cc: <linux-api@vger.kernel.org>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <linux-kernel@vger.kernel.org>
Cc: "Michael T. Kerrisk" <mtk.manpages@gmail.com>
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
Cc: Jan Kara <jack@suse.cz>
Cc: Askar Safin <safinaskar@zohomail.com>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: David Howells <dhowells@redhat.com>
Cc: Christian Brauner <brauner@kernel.org>
Message-ID: <20250807-new-mount-api-v2-1-558a27b8068c@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

GNUmakefile: help: Document the usual targets

Suggested-by: Aleksa Sarai <cyphar@cyphar.com>
Acked-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/PR_GET_TIMING.2const: SYNOPSIS: tfix

Fixes: 6c6125882666 (2024-05-31; "PR_GET_TIMING.2const: Tweak after split")
Signed-off-by: Florian Schmaus <flo@geekplace.eu>
Message-ID: <20250704153630.1236769-1-flo@geekplace.eu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/openat2.2: Update RESOLVE_CACHED to mention kernel version

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Message-ID: <20250724-openat2-cached-note-v1-1-037e7398f797@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

src/bin/sortman: Fix order of intro(*) pages for subsections

Here's what changes with this patch:

$ diff -u \
<(find man -type f | ../master/src/bin/sortman) \
<(find man -type f | ./src/bin/sortman);
--- /dev/fd/63 2025-07-22 11:47:27.982307499 +0200
+++ /dev/fd/62 2025-07-22 11:47:27.982307499 +0200
@@ -805,7 +805,6 @@
 man/man2const/VT_SETMODE.2const
 man/man2const/VT_WAITACTIVE.2const
 man/man2type/open_how.2type
-man/man3attr/intro.3attr
 man/man3/intro.3
 man/man3/a64l.3
 man/man3/abort.3
@@ -2517,6 +2516,7 @@
 man/man3/yn.3
 man/man3/ynf.3
 man/man3/ynl.3
+man/man3attr/intro.3attr
 man/man3attr/gnu::aligned.3attr
 man/man3attr/gnu::format.3attr
 man/man3const/EOF.3const

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

share/mk/build/pdf/book/prepare.pl: Add support for man3attr

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

man/man3/malloc.3: STANDARDS: tfix, ffix

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

man/man2/openat2.2: HISTORY: Include epilogue about FreeBSD

While RESOLVE_BENEATH was based on FreeBSD's O_BENEATH, there was a
well-known safety issue in O_BENEATH that we explicitly avoided
replicating -- FreeBSD would only verify whether the lookup escaped the
dirfd *at the end of the path lookup*.

This meant that even with O_BENEATH, an attacker could gain information
about the structure of the filesystem outside of the dirfd through
timing attacks or other side-channels.

Once Linux had RESOLVE_BENEATH, FreeBSD implemented O_RESOLVE_BENEATH to
mimic the same behaviour[1] and eventually removed O_BENEATH entirely
from their system[2].  It seems prudent to provide this epilogue in the
HISTORY section of the openat2(2) man page (the FreeBSD man page does
for open(2) not reference this historical connection with Linux at all,
as far as I can tell).

Link: [1] <https://reviews.freebsd.org/D25886>
Link: [2] <https://reviews.freebsd.org/D28907>
Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Message-ID: <20250721-openat2-history-v1-1-994936dd224a@cyphar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

lsm: Released 6.15

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

Changes: Ready for 6.15

The commands in 4a2750a06f98 (2023-08-01; "Changes: Ready for 6.05")
need as update for the new man/ directory.  I've also added code to get
the page which link pages link to.

List of new pages:

$ git diff man-pages-6.14..HEAD \
| grep -A1 '^--- /dev/null' \
| grep -v -e '\--' -e '\--- /dev/null' \
| sed 's,+++ b/,,' \
| grep '^man/' \
| xargs grep -L '^\.so ' \
| sed 's,.*/,,';

List of new links:

$ git diff man-pages-6.14..HEAD \
| grep '^+++ ' \
| sed 's,+++ b/,,' \
| grep '^man/' \
| xargs grep -l '^\.so ' \
| sed 's,.*/,,' \
| while read -r f; do
echo "$f" \
| tr -d '\n';

find man/ -type f \
| grep "$f" \
| xargs grep '^\.so' \
| sed 's,.*/,\t\t\t(,' \
| sed 's/\./(/' \
| sed 's/$/))/';
done;

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

man/man3/malloc.3: STANDARDS, HISTORY, BUGS: Clarify (non)conformance of realloc{,array}(3)

Link: <https://nabijaczleweli.xyz/content/blogn_t/017-malloc0.html>
Link: <https://sourceware.org/pipermail/libc-alpha/1999-April/000956.html>
Link: <https://inbox.sourceware.org/libc-alpha/nbyurzcgzgd5rdybbi4no2kw5grrc32k63svf7oq73nfcbus5r@77gry66kpqfr/>
Link: <https://inbox.sourceware.org/libc-alpha/20241019014002.3684656-1-siddhesh@sourceware.org/T/#u>
Link: <https://inbox.sourceware.org/libc-alpha/qukfe5yxycbl5v7ooskvqdnm3au3orohbx4babfltegi47iyly@or6dgf7akeqv/T/#u>
Link: <https://github.com/bminor/glibc/commit/7c2b945e1fd64e0a5a4dbd6ae6592a7314dcd4b5>
Link: <https://github.com/llvm/llvm-project/issues/113065>
Link: <https://www.austingroupbugs.net/view.php?id=400>
Link: <https://www.austingroupbugs.net/view.php?id=526>
Link: <https://www.austingroupbugs.net/view.php?id=688>
Link: <https://sourceware.org/bugzilla/show_bug.cgi?id=12547>
Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/dr_400.htm>
Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n868.htm>
Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n2438.htm>
Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n2464.pdf>
Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3621.txt>
Link: <https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/realloc.html>
Link: <https://pubs.opengroup.org/onlinepubs/9699919799.2013edition/functions/realloc.html>
Link: <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=120744>
Link: <https://lore.kernel.org/lkml/20220213182443.4037039-1-keescook@chromium.org/>
Link: <https://awakened1712.github.io/hacking/hacking-whatsapp-gif-rce/>
Link: <https://gbhackers.com/whatsapp-double-free-vulnerability/>
Cc: <bug-gnulib@gnu.org>
Cc: <musl@lists.openwall.com>
Cc: <libc-alpha@sourceware.org>
Cc: наб <nabijaczleweli@nabijaczleweli.xyz>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Robert Seacord <rcseacord@gmail.com>
Cc: Elliott Hughes <enh@google.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Rich Felker <dalias@libc.org>
Cc: Adhemerval Zanella Netto <adhemerval.zanella@linaro.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: Andreas Schwab <schwab@suse.de>
Cc: Thorsten Glaser <tg@mirbsd.de>
Cc: Eric Blake <eblake@redhat.com>
Cc: Vincent Lefevre <vincent@vinc17.net>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: Wilco Dijkstra <Wilco.Dijkstra@arm.com>
Cc: DJ Delorie <dj@redhat.com>
Cc: Cristian Rodríguez <cristian@rodriguez.im>
Cc: Siddhesh Poyarekar <siddhesh@gotplt.org>
Cc: Sam James <sam@gentoo.org>
Cc: Mark Wielaard <mark@klomp.org>
Cc: "Maciej W. Rozycki" <macro@redhat.com>
Cc: Martin Uecker <ma.uecker@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Eskil Steenberg <eskil@obsession.se>
Cc: Terence Kelly <tpkelly@eecs.umich.edu>
Cc: Daniel Krügler <daniel.kruegler@googlemail.com>
Cc: Kees Cook <keescook@chromium.org>
Cc: Valdis Klētnieks <valdis.kletnieks@vt.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2/fcntl.2, man/man2const/F_*.2const: Make sashimi of fcntl(2)

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

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

man/man2/fcntl_locking.2, man/man2const/F_*.2const: Tweak after split, and add link pages

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

man/man2/fcntl{,_locking}.2: Split locking operations from fcntl(2)

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

man/man2const/F_*.2const: Tweak after split, and add link pages

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

man/man2/fcntl.2, man/man2const/F_GETSIG.2const: Split F_{G,S}ETOWN*, F_{G,S}ETSIG from fcntl(2)

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

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

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

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

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

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

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

man/man2/fcntl.2, man/man2const/F_NOTIFY.2const: Split F_NOTIFY from fcntl(2)

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

man/man2const/F_{G,S}ET{,_FILE}_RW_HINT.2const: Tweak after split, and add link pages

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

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>