]>
git.ipfire.org Git - thirdparty/man-pages.git/log
Aleksa Sarai [Thu, 24 Jul 2025 04:58:25 +0000 (14:58 +1000)]
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>
Alejandro Colomar [Tue, 22 Jul 2025 09:48:07 +0000 (11:48 +0200)]
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>
Alejandro Colomar [Tue, 22 Jul 2025 09:28:39 +0000 (11:28 +0200)]
share/mk/build/pdf/book/prepare.pl: Add support for man3attr
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 21 Jul 2025 12:39:11 +0000 (14:39 +0200)]
man/man3/malloc.3: STANDARDS: tfix, ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Aleksa Sarai [Mon, 21 Jul 2025 01:55:36 +0000 (11:55 +1000)]
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>
Alejandro Colomar [Sun, 20 Jul 2025 21:56:31 +0000 (23:56 +0200)]
lsm: Released 6.15
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 20 Jul 2025 19:04:13 +0000 (21:04 +0200)]
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>
Alejandro Colomar [Thu, 19 Jun 2025 00:27:48 +0000 (02:27 +0200)]
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>
Alejandro Colomar [Sat, 19 Jul 2025 22:47:42 +0000 (00:47 +0200)]
man/man2/fcntl.2, man/man2const/F_*.2const: Make sashimi of fcntl(2)
Alejandro Colomar [Sat, 19 Jul 2025 22:47:12 +0000 (00:47 +0200)]
man/man2/fcntl.2: Tweak after making sashimi of this page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 19 Jul 2025 22:36:56 +0000 (00:36 +0200)]
man/man2/fcntl_locking.2, man/man2const/F_*.2const: Tweak after split, and add link pages
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 19 Jul 2025 22:32:04 +0000 (00:32 +0200)]
man/man2/fcntl{,_locking}.2: Split locking operations from fcntl(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 19 Jul 2025 22:06:41 +0000 (00:06 +0200)]
man/man2const/F_*.2const: Tweak after split, and add link pages
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 19 Jul 2025 21:58:10 +0000 (23:58 +0200)]
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>
Alejandro Colomar [Tue, 15 Jul 2025 22:42:18 +0000 (00:42 +0200)]
man/man2const/F_{G,S}ETLEASE.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 15 Jul 2025 22:40:28 +0000 (00:40 +0200)]
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>
Alejandro Colomar [Sun, 13 Jul 2025 23:44:41 +0000 (01:44 +0200)]
man/man2const/F_NOTIFY.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 13 Jul 2025 21:19:34 +0000 (23:19 +0200)]
man/man2/fcntl.2, man/man2const/F_NOTIFY.2const: Split F_NOTIFY from fcntl(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 13 Jul 2025 21:06:57 +0000 (23:06 +0200)]
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>
Alejandro Colomar [Sat, 12 Jul 2025 23:59:09 +0000 (01:59 +0200)]
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>
Alejandro Colomar [Sat, 12 Jul 2025 23:44:11 +0000 (01:44 +0200)]
man/man2const/F_{GET,ADD}_SEALS.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 12 Jul 2025 23:41:16 +0000 (01:41 +0200)]
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>
Alejandro Colomar [Sat, 12 Jul 2025 23:31:38 +0000 (01:31 +0200)]
man/man2const/F_{G,S}ETPIPE_SZ.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 12 Jul 2025 23:28:43 +0000 (01:28 +0200)]
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>
Alejandro Colomar [Sat, 12 Jul 2025 13:59:05 +0000 (15:59 +0200)]
man/man2const/F_{G,S}ETFL.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 12 Jul 2025 13:53:29 +0000 (15:53 +0200)]
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>
Alejandro Colomar [Sat, 12 Jul 2025 12:50:19 +0000 (14:50 +0200)]
man/man2const/F_{G,S}ETFD.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 12 Jul 2025 12:43:56 +0000 (14:43 +0200)]
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>
Alejandro Colomar [Sat, 12 Jul 2025 00:14:40 +0000 (02:14 +0200)]
man/man2const/F_DUPFD{,_CLOEXEC}.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 12 Jul 2025 00:10:10 +0000 (02:10 +0200)]
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>
Vincent Lefevre [Sat, 12 Jul 2025 21:05:00 +0000 (23:05 +0200)]
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>
Elliott Hughes [Tue, 15 Jul 2025 18:42:56 +0000 (18:42 +0000)]
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>
Alejandro Colomar [Fri, 18 Jul 2025 12:29:25 +0000 (14:29 +0200)]
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>
Alejandro Colomar [Fri, 18 Jul 2025 12:08:15 +0000 (14:08 +0200)]
man/man3attr/gnu::format.3attr: Add page
Cc: Aaron Ballman <aaron@aaronballman.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 12 Jul 2025 12:12:55 +0000 (14:12 +0200)]
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>
Alejandro Colomar [Fri, 11 Jul 2025 13:35:22 +0000 (15:35 +0200)]
man/man3/stpncpy.3: RETURN VALUE: wfix
This is for consistency with wcpncpy(3).
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 11 Jul 2025 13:34:22 +0000 (15:34 +0200)]
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>
Alejandro Colomar [Fri, 6 Jun 2025 11:27:02 +0000 (13:27 +0200)]
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>
Alejandro Colomar [Fri, 27 Jun 2025 02:48:57 +0000 (04:48 +0200)]
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>
Alejandro Colomar [Mon, 23 Jun 2025 01:35:26 +0000 (03:35 +0200)]
man/man3attr/gnu::aligned.3attr: Add page
Cc: Aaron Ballman <aaron@aaronballman.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 27 Jun 2025 03:13:30 +0000 (05:13 +0200)]
man/man3attr/intro.3attr: Add page
Cc: Aaron Ballman <aaron@aaronballman.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 23 Jun 2025 01:34:29 +0000 (03:34 +0200)]
man3attr/: Add subsection for attributes
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Collin Funk [Mon, 23 Jun 2025 02:44:56 +0000 (19:44 -0700)]
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>
Benjamin Peterson [Thu, 19 Jun 2025 05:13:42 +0000 (22:13 -0700)]
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>
John Garry [Thu, 19 Jun 2025 15:44:55 +0000 (15:44 +0000)]
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>
John Garry [Thu, 19 Jun 2025 15:44:54 +0000 (15:44 +0000)]
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>
Dacian Pascu [Fri, 20 Jun 2025 14:00:11 +0000 (17:00 +0300)]
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>
Alejandro Colomar [Fri, 20 Jun 2025 18:36:48 +0000 (20:36 +0200)]
man/man3/malloc.3: Shorten parameter name (s/ptr/p/)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Matteo Croce [Wed, 11 Jun 2025 14:13:50 +0000 (16:13 +0200)]
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>
Jelle van der Waa [Mon, 16 Jun 2025 13:32:09 +0000 (15:32 +0200)]
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>
Aleksa Sarai [Wed, 18 Jun 2025 18:34:30 +0000 (04:34 +1000)]
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>
Alejandro Colomar [Fri, 13 Jun 2025 08:03:18 +0000 (10:03 +0200)]
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>
Collin Funk [Fri, 13 Jun 2025 06:14:23 +0000 (23:14 -0700)]
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>
Sebastian Andrzej Siewior [Mon, 2 Jun 2025 14:01:01 +0000 (16:01 +0200)]
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>
Florian Weimer [Thu, 5 Jun 2025 12:46:14 +0000 (14:46 +0200)]
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>
Nicolas Pitre [Sat, 7 Jun 2025 20:01:51 +0000 (16:01 -0400)]
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>
Nicolas Pitre [Sat, 7 Jun 2025 19:59:33 +0000 (15:59 -0400)]
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>
Alejandro Colomar [Sun, 8 Jun 2025 18:51:05 +0000 (20:51 +0200)]
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>
Alejandro Colomar [Sun, 8 Jun 2025 18:17:14 +0000 (20:17 +0200)]
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>
Alejandro Colomar [Thu, 5 Jun 2025 09:37:54 +0000 (11:37 +0200)]
man/man3/inet_net_pton.3: SYNOPSIS: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 4 Jun 2025 12:32:41 +0000 (14:32 +0200)]
man/man3/: Shorten parameter names
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 2 Jun 2025 13:44:15 +0000 (15:44 +0200)]
man/: SYNOPSIS: Use array notation
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 1 Jun 2025 19:43:10 +0000 (21:43 +0200)]
man/man2const/PR_SET_MM_AUXV.2const: SYNOPSIS: Fix position of #include line
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 1 Jun 2025 19:19:54 +0000 (21:19 +0200)]
man/man2const/: TH: Fix subsection
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 1 Jun 2025 14:16:16 +0000 (16:16 +0200)]
man/man2const/KEYCTL_SESSION_TO_PARENT.2const: SYNOPSIS: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Ahelenia Ziemiańska [Sat, 31 May 2025 18:03:28 +0000 (20:03 +0200)]
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>
Ahelenia Ziemiańska [Sat, 31 May 2025 18:03:26 +0000 (20:03 +0200)]
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>
Alejandro Colomar [Fri, 30 May 2025 11:33:22 +0000 (13:33 +0200)]
man/man2/mbind.2: SYNOPSIS: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 30 May 2025 11:12:40 +0000 (13:12 +0200)]
man/man2/: SYNOPSIS: Use array notation
Signed-off-by: Alejandro Colomar <alx@kernel.org>
ar
Paul Eggert [Fri, 30 May 2025 07:20:19 +0000 (00:20 -0700)]
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>
Alejandro Colomar [Thu, 29 May 2025 23:20:42 +0000 (01:20 +0200)]
man/man2/futex.2, man/man2const/FUTEX_*.2const: Make sashimi of futex(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 23:17:50 +0000 (01:17 +0200)]
man/man2/futex.2: Tweak after making sashimi of this page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 23:08:12 +0000 (01:08 +0200)]
man/man2const/FUTEX_WAIT_REQUEUE_PI.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 23:04:10 +0000 (01:04 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 22:34:39 +0000 (00:34 +0200)]
man/man2const/FUTEX_CMP_REQUEUE_PI.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 22:27:39 +0000 (00:27 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 22:05:59 +0000 (00:05 +0200)]
man/man2const/FUTEX_UNLOCK_PI.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 22:02:46 +0000 (00:02 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 21:45:18 +0000 (23:45 +0200)]
man/man2const/FUTEX_TRYLOCK_PI.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 21:42:28 +0000 (23:42 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 21:30:52 +0000 (23:30 +0200)]
man/man2const/FUTEX_LOCK_PI2.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 21:25:36 +0000 (23:25 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 21:12:12 +0000 (23:12 +0200)]
man/man2const/FUTEX_LOCK_PI.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 21:07:06 +0000 (23:07 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 11:53:18 +0000 (13:53 +0200)]
man/man2const/FUTEX_WA??_BITSET.2const: Tweak after split, and add link page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 11:33:23 +0000 (13:33 +0200)]
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>
Alejandro Colomar [Thu, 29 May 2025 10:59:29 +0000 (12:59 +0200)]
man/man2const/FUTEX_WAKE_OP.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 29 May 2025 10:54:16 +0000 (12:54 +0200)]
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>
Alejandro Colomar [Wed, 28 May 2025 23:56:14 +0000 (01:56 +0200)]
man/man2const/FUTEX_CMP_REQUEUE.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 23:49:54 +0000 (01:49 +0200)]
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>
Alejandro Colomar [Wed, 28 May 2025 23:15:19 +0000 (01:15 +0200)]
man/man2const/FUTEX_REQUEUE.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 23:08:31 +0000 (01:08 +0200)]
man/man2/futex.2, man/man2const/FUTEX_REQUEUE.2const: Split FUTEX_REQUEUE from futex(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 20:12:08 +0000 (22:12 +0200)]
man/man2const/FUTEX_FD.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 20:05:12 +0000 (22:05 +0200)]
man/man2/futex.2, man/man2const/FUTEX_FD.2const: Split FUTEX_FD from futex(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 14:39:34 +0000 (16:39 +0200)]
man/man2const/FUTEX_WAKE.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 14:02:45 +0000 (16:02 +0200)]
man/man2/futex.2, man/man2const/FUTEX_WAKE.2const: Split FUTEX_WAKE from futex(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 27 May 2025 13:39:00 +0000 (15:39 +0200)]
man/man2const/FUTEX_WAIT.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 27 May 2025 13:35:33 +0000 (15:35 +0200)]
man/man2/futex.2, man/man2const/FUTEX_WAIT.2const: Split FUTEX_WAIT from futex(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 May 2025 19:21:38 +0000 (21:21 +0200)]
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>
Alejandro Colomar [Tue, 27 May 2025 13:09:44 +0000 (15:09 +0200)]
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>