]>
git.ipfire.org Git - thirdparty/man-pages.git/log
Alejandro Colomar [Fri, 13 Dec 2024 13:19:28 +0000 (14:19 +0100)]
man/man3/: SYNOPSIS: Use typeof() to improve readability of function pointer types
Due to different spacing, I had missed these ones in the previous
commits of this kind.
Suggested-by: Jorenar <dev@jorenar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alexander Stepchenko [Thu, 9 Jan 2025 18:06:32 +0000 (21:06 +0300)]
man/man7/user_namespaces.7: tfix
Fixes: 8c74a1cea495 (2016-07-07; "user_namespaces.7: Clarify details of CAP_SYS_ADMIN and cgroup v1 mounts")
Signed-off-by: Alexander Stepchenko <geochip@altlinux.org>
Message-ID: <
bc17315eff26eb31ecc78a2c44b89dfb077813df .
1736444255 .git.geochip@altlinux.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Christoph Hellwig [Thu, 9 Jan 2025 08:32:26 +0000 (09:32 +0100)]
man/man2/statx.2: Document STATX_DIO_READ_ALIGN
Document the new STATX_DIO_READ_ALIGN flag and the new
stx_dio_read_offset_align field guarded by it.
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
Cc: Christian Brauner <brauner@kernel.org>
Cc: Jan Kara <jack@suse.cz>
Cc: Chandan Babu R <chandan.babu@oracle.com>
Cc: Hongbo Li <lihongbo22@huawei.com>
Cc: Ryusuke Konishi <konishi.ryusuke@gmail.com>
Cc: <linux-nilfs@vger.kernel.org>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <linux-xfs@vger.kernel.org>
Reviewed-by: "Darrick J. Wong" <djwong@kernel.org>
Signed-off-by: Christoph Hellwig <hch@lst.de>
Message-ID: <
20250109083226 .GA22264@lst.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 14:23:27 +0000 (15:23 +0100)]
src/bin/diffman, man/man1/diffman: Remove program
It was useful for implementing duffman(1), but now it doesn't use it
anymore. Drop this program.
Users can do this instead:
$ MAN_KEEP_FORMATTING=1 diff -u <(man page1) <(man page2);
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 12:51:28 +0000 (13:51 +0100)]
man/man1/diffman-git.1: Add manual page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 22:56:54 +0000 (23:56 +0100)]
src/bin/: Rename duffman => diffman-git
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 12:49:20 +0000 (13:49 +0100)]
src/bin/duffman: Don't pipe to less(1)
Let the user decide to pipe or not.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 12:33:43 +0000 (13:33 +0100)]
src/bin/duffman: Always read(1) -r
In src/bin/duffman line 45:
| while read f; do \
^--^ SC2162 (info): read without -r will mangle backslashes.
Reported-by: shellcheck(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 12:32:20 +0000 (13:32 +0100)]
src/bin/duffman: Handle errors correctly
In src/bin/duffman line 30:
cd $(git rev-parse --show-toplevel);
^-- SC2046 (warning): Quote this to prevent word splitting.
^---------------------------^ SC2312 (info): Consider invoking this command separately to avoid masking its return value (or use '|| true' to ignore).
Reported-by: shellcheck(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 10 Jan 2025 00:53:14 +0000 (01:53 +0100)]
src/bin/duffman: Allow diffing two git references
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 12:27:23 +0000 (13:27 +0100)]
src/bin/duffman: Allow diffing git references, not just the working directory
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 12:24:13 +0000 (13:24 +0100)]
src/bin/duffman: Diff against HEAD, not the system pages
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 11:46:25 +0000 (12:46 +0100)]
src/bin/duffman: wsfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 9 Jan 2025 11:45:27 +0000 (12:45 +0100)]
src/bin/duffman, scripts/bash_aliases: Move duffman() to a separate script
Signed-off-by: Alejandro Colomar <alx@kernel.org>
enh [Wed, 8 Jan 2025 23:53:17 +0000 (18:53 -0500)]
man/man2/stat.2: Linux 6.11 allows using NULL with AT_EMPTY_PATH.
Cc: Dan Albert <danalbert@google.com>
Signed-off-by: Elliott Hughes <enh@google.com>
Message-ID: <CAJgzZoqAOpJajmAnr-i9h3sPC8F_Uu0A+3eg4nkP+xTAV5fPGg@mail.gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Michal Clapinski [Tue, 7 Jan 2025 13:57:00 +0000 (14:57 +0100)]
man/man2/setns.2: Add missing info about time ns
Only singlethreaded processes can setns into time ns.
Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/kernel/time/namespace.c?h=v6.12#n309>
Signed-off-by: Michal Clapinski <mclapinski@google.com>
Message-ID: <
20250107135700 .
3995936 -1-mclapinski@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 19:45:06 +0000 (20:45 +0100)]
man/man2/signal.2: VERSIONS: The typedef-less definition of signal(2) isn't hard to read
At least if you use typeof().
Acked-by: Jorenar <dev@jorenar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 19:22:04 +0000 (20:22 +0100)]
man/: Use typeof() to improve readability of function pointer types
An exception of good taste is structure members. There, for alignment
reasons, traditional syntax seems more appropriate usually.
Suggested-by: Jorenar <dev@jorenar.com>
Cc: Martin Uecker <uecker@tugraz.at>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 19:30:23 +0000 (20:30 +0100)]
share/mk/: $CLANG_CFLAGS: Add -Wno-language-extension-token
We use typeof(), which triggers that. It's now standard, so this is a
false positive, IMO.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 15:31:42 +0000 (16:31 +0100)]
src/bin/diffman: Simplify temporary file names
Now that we're using labels, the file name is unimportant.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 15:14:59 +0000 (16:14 +0100)]
src/bin/diffman: Use diff(1) labels for nicer output
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 14:34:54 +0000 (15:34 +0100)]
src/bin/diffman, man/man1/diffman.1: Use man(1) to format the pages
This allows using the environment variables that man(1) understands.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 13:48:01 +0000 (14:48 +0100)]
man/man3/: EXAMPLES: wsfix
Add a space after a cast.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 13:18:49 +0000 (14:18 +0100)]
man/man3/: EXAMPLES: Remove unnecessary parentheses
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 5 Jan 2025 12:44:32 +0000 (13:44 +0100)]
man/man3/sem_open.3: SYNOPSIS: This is a variadic function
Specify the prototype consistently with open(2).
Signed-off-by: Alejandro Colomar <alx@kernel.org>
John Garry [Tue, 26 Nov 2024 09:08:47 +0000 (09:08 +0000)]
man/man2/io_submit.2: Document RWF_NOAPPEND
Document flag introduced in Linux v6.9.
Cc: Rich Felker <dalias@libc.org>
Cc: Christian Brauner <brauner@kernel.org>
Signed-off-by: John Garry <john.g.garry@oracle.com>
Message-ID: <
20241126090847 .297371-3-john.g.garry@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
John Garry [Tue, 26 Nov 2024 09:08:46 +0000 (09:08 +0000)]
man/man2/readv.2: Document RWF_NOAPPEND
Document flag introduced in Linux v6.9.
Cc: Rich Felker <dalias@libc.org>
Cc: Christian Brauner <brauner@kernel.org>
Signed-off-by: John Garry <john.g.garry@oracle.com>
Message-ID: <
20241126090847 .297371-2-john.g.garry@oracle.com>
[alx: wfix, srcfix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
John Garry [Tue, 3 Dec 2024 14:53:59 +0000 (14:53 +0000)]
man/man2/statx.2: Update STATX_WRITE_ATOMIC filesystem support
Linux v6.13 will include atomic write support for xfs and ext4, so
update STATX_WRITE_ATOMIC commentary to mention that.
Cc: "Darrick J. Wong" <djwong@kernel.org>
Cc: <ritesh.list@gmail.com>
Signed-off-by: John Garry <john.g.garry@oracle.com>
Message-ID: <
20241203145359 .
2691972 -1-john.g.garry@oracle.com>
[alx: ffix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Arkadiusz Drabczyk [Fri, 3 Jan 2025 17:38:16 +0000 (18:38 +0100)]
man/man3/pthread_cond_init.3: Remove EINTR error code
In pthreads.7 it says:
"For each of the pthreads functions that can return an error,
POSIX.1-2001 specifies that the function can never fail with the error
EINTR."
Link: <https://lore.kernel.org/linux-man/Z3W_qgawqyEB-QrA@comp../>
Cc: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Message-ID: <
20250103173816 .6409-2-arkadiusz@drabczyk.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Arkadiusz Drabczyk [Fri, 3 Jan 2025 17:38:15 +0000 (18:38 +0100)]
man/man7/signal.7: Don't mention that pthread API can return EINTR
In pthreads.7 it says:
"For each of the pthreads functions that can return an error,
POSIX.1-2001 specifies that the function can never fail with the error
EINTR."
Link: <https://lore.kernel.org/linux-man/Z3W_qgawqyEB-QrA@comp../>
Cc: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
Message-ID: <
20250103173816 .6409-1-arkadiusz@drabczyk.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 24 Dec 2024 22:10:28 +0000 (23:10 +0100)]
man/man3/: Don't use 'length' to refer to buffer size
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 24 Dec 2024 18:50:18 +0000 (19:50 +0100)]
man/man3/stdio_ext.3: wfix
For consistency with wide characters, say characters instead of bytes.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 24 Dec 2024 18:44:59 +0000 (19:44 +0100)]
man/man3/{stdin,stdio}.3: SYNOPSIS: Consistently declare as 'extern' variables
And leave two spaces between the type name and the variable name.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 23 Dec 2024 21:25:54 +0000 (22:25 +0100)]
man/man2/ioctl_pipe.2: SYNOPSIS: Fix $1, which is not an array parameter
Link: <https://lore.kernel.org/linux-man/
20241214180423 .2thsuyyfosrlyajb@devuan/T/#u>
Reported-by: Alejandro Colomar <alx@kernel.org>
Suggested-by: Cyril Hrubis <chrubis@suse.cz>
Cc: David Howells <dhowells@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Lorenzo Stoakes [Fri, 6 Dec 2024 11:34:18 +0000 (11:34 +0000)]
man/man2/madvise.2: wfix
Cc: Jann Horn <jannh@google.com>
Suggested-by: Vlastimil Babka <vbabka@suse.cz>
Signed-off-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Message-ID: <
20241206113418 .14327-1-lorenzo.stoakes@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 22 Dec 2024 19:10:18 +0000 (20:10 +0100)]
man/man3/string.3: SYNOPSIS: Simplify
Replace the prototypes by manual-page references, and use generic text
which doesn't use the names of the parameters. It's just an overview.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 22 Dec 2024 14:28:53 +0000 (15:28 +0100)]
src/bin/diffman: Add support for mdoc(7) pages
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 22 Dec 2024 14:28:18 +0000 (15:28 +0100)]
src/bin/diffman: Run the entire groff pipeline
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 22 Dec 2024 14:21:15 +0000 (15:21 +0100)]
src/bin/diffman: Fix bug at parsing options
We don't want multiple cases to match the option.
The '*)' was matching any option.
Fixes: f2dfd79facf0 (2024-12-13, "src/bin/diffman: Add default case")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 22 Dec 2024 14:08:42 +0000 (15:08 +0100)]
src/bin/diffman, man/man1/diffman.1: -s: Add support for diff(1)'s -s flag
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 22 Dec 2024 12:50:29 +0000 (13:50 +0100)]
src/bin/mansect: Use pipefail and some safety measures
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 20 Dec 2024 21:31:50 +0000 (22:31 +0100)]
man/man3/getline.3: wfix
Fixes: ef53ef760638 (2024-12-18, "man/man3/getline.3: Clarify ERRORS")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 19 Dec 2024 10:33:43 +0000 (11:33 +0100)]
CONTRIBUTING.d/patches/subject: Use the full path always
This is easier to do, since auto-completion will do it. Also, it's more
consistent. I started using full paths a few commits ago.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 19 Dec 2024 10:30:27 +0000 (11:30 +0100)]
CONTRIBUTING: Add reference to CONTRIBUTING.d/git
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Ahelenia Ziemiańska [Wed, 18 Dec 2024 14:35:28 +0000 (15:35 +0100)]
man/man3/getopt.3: Remove _<PID>_GNU_nonoption_argv_flags_ description
Per <https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=
bf079e19f50d64aa5e05b5e17ec29afab9aabb20 >:
- this was set by bash 2.0 (1996-12)
(implemented in glibc
b07c5668f672125074dd5b0b658145e1544120be )
- it's no longer set by bash 2.01 (1997-06) because it was bad
- glibc disabled this with no way to enable it in 2001-08
(
518a0dd201c48a5c15d73c1919c304a9f8f5e3c1 )
- glibc removed it in 2017
bf079e19f50d64aa5e05b5e17ec29afab9aabb20
So this was experienced by people for 5 months at best,
and could remotely be experienced for 3 years
(if you somehow wanted this bad behaviour and added it into your shell),
over 20 years ago.
No modern reader (or, frankly, non-modern reader)
has ever used this, or could use it, really.
Link to the removal note for completeness only.
Link: <https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=
bf079e19f50d64aa5e05b5e17ec29afab9aabb20 >
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-Id: <dwfybzlb5ydbsc4puo6igj7nm7iregquv6hxhhqb53bwrvqswb@tarta.nabijaczleweli.xyz>
[alx: Add break points in URI; minor tweaks to commit message too]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
enh [Mon, 16 Dec 2024 13:57:14 +0000 (08:57 -0500)]
man/man3/getline.3: Clarify ERRORS
Signed-off-by: Elliott Hughes <enh@google.com>
Message-ID: <CAJgzZoruFUg6X=JUNJXCbBOKs13SX=dsNFNdTMct2VecUFG=ww@mail.gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 16 Dec 2024 14:09:52 +0000 (15:09 +0100)]
CONTRIBUTING.d/git: mkdir(1) parent directory before writing to file
Reported-by: Elliott Hughes <enh@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Ahelenia Ziemiańska [Mon, 16 Dec 2024 01:00:45 +0000 (02:00 +0100)]
man/man3/strverscmp.3: This is NOT the ordering used by ls -v
Compare, given:
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
int compar(const char **l, const char **r) {
return strverscmp(*l, *r);
}
int main(int argc, char ** argv) {
qsort(argv + 1, argc - 1, sizeof(*argv), compar);
for(int i = 1; i < argc; ++i)
puts(argv[i]);
}
yields:
$ /bin/ls -v1 a* # coreutils ls
a-1.0a
a-1.0.1a
$ ../vers a* # as above
a-1.0.1a
a-1.0a
$ ls -v1 a* # voreutils ls @
5781698 with strverscmp()-equivalent sorting
a-1.0.1a
a-1.0a
compare also the results for real data like
netstat-nat-1.{0,1{,.1},2,3.1,4{,.{1,2,3,4,5,6,7,8,9,10}}}.tar.gz
Thus, coreutils ls -v (and sort -V) does NOT use strverscmp(3);
it uses a modified Debian version comparison algorithm with additional
suffix processing and `ls -v`-specific exceptions.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-Id: <myuppkwnltqtxduoop7g7wfuyou5cdo6sotocrvyztmqnazvph@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 15 Dec 2024 19:40:46 +0000 (20:40 +0100)]
scripts/bash_aliases: duffman(): Silence output of cp(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 14 Dec 2024 19:58:03 +0000 (20:58 +0100)]
man/man2/get_mempolicy.2: SYNOPSIS: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 14 Dec 2024 19:23:25 +0000 (20:23 +0100)]
man/man2/: SYNOPSIS: Use array notation
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 13 Dec 2024 13:32:35 +0000 (14:32 +0100)]
src/bin/diffman: Silence shellcheck(1) diagnostic
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 13 Dec 2024 13:30:46 +0000 (14:30 +0100)]
src/bin/diffman: Add default case
SC2249 (info): Consider adding a default *) case, even if it just exits with error.
In principle, getopts(1) shouldn't return other stuff, but it doesn't
hurt to be cutious.
Reported-by: shellcheck(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 13 Dec 2024 13:19:28 +0000 (14:19 +0100)]
man/: SYNOPSIS: Use typeof() to improve readability of function pointer types
Suggested-by: Jorenar <dev@jorenar.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 13 Dec 2024 12:02:06 +0000 (13:02 +0100)]
man/man3/makecontext.3: SYNOPSIS: Add ellipsis to function type
The old syntax with empty parentheses has been removed from the language
in C23.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 11 Dec 2024 16:36:22 +0000 (17:36 +0100)]
man/man3/isalpha.3: tfix
Fixes: ba687b00ecb3 (2023-07-30, "man3/: srcfix")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Ian Rogers [Fri, 6 Dec 2024 07:38:25 +0000 (23:38 -0800)]
proc_pid_fdinfo.5: Reduce indent for most of the page
When /proc/pid/fdinfo was part of proc.5 man page the indentation made
sense. As a standalone man page the indentation doesn't need to be so
far over to the right. Remove the initial tagged pragraph, move the
"since Linux 2.6.22" to a new HISTORY subsection.
Suggested-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Message-Id: <
20241206073828 .
1119464 -1-irogers@google.com>
[alx: ffix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 6 Dec 2024 15:08:35 +0000 (16:08 +0100)]
scripts/bash_aliases: duffman: Pass any arguments (options) to diffman(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 6 Dec 2024 15:04:46 +0000 (16:04 +0100)]
src/bin/diffman, diffman.1: -U: Add support for diff(1)'s -U option
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 6 Dec 2024 14:32:48 +0000 (15:32 +0100)]
src/bin/diffman: -w: Add support for diff(1)'s -w flag
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Anhad Singh [Fri, 6 Dec 2024 07:18:23 +0000 (07:18 +0000)]
ld.so.8: tfix
Signed-off-by: Anhad Singh <andypython@protonmail.com>
Message-Id: <
20241206071814 .55913-1-andypython@protonmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Lorenzo Stoakes [Thu, 5 Dec 2024 10:41:25 +0000 (10:41 +0000)]
madvise.2: Add description of MADV_GUARD_INSTALL, MADV_GUARD_REMOVE
Lightweight guard region support has been added to Linux 6.13, which
adds MADV_GUARD_INSTALL and MADV_GUARD_REMOVE flags to the madvise()
system call. Therefore, update the manpage for madvise() and describe
these operations.
Reviewed-by: Jann Horn <jannh@google.com>
Signed-off-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Message-Id: <
20241205104125 .67518-1-lorenzo.stoakes@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 5 Dec 2024 11:50:02 +0000 (12:50 +0100)]
CONTRIBUTING.d/patches/description: Add link to history of inter-sentence space
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
tyberry@redhat.com [Tue, 26 Nov 2024 16:12:03 +0000 (11:12 -0500)]
madvise.2: MADV_SOFT_OFFLINE requests can report EBUSY
If the page could not be offlined madvise will report EBUSY.
This might occur if the page is currently in use or locked.
Signed-off-by: Tyonnchie Berry <tyberry@redhat.com>
Message-Id: <Z0XzU9R9Kx0RoeUG@redhat.com>
Acked-by: "Luis Claudio R. Goncalves" <lgoncalv@redhat.com>
[alx: wfix, ffix, and other tweaks]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 4 Dec 2024 10:06:38 +0000 (11:06 +0100)]
man/: wfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Lorenzo Stoakes [Fri, 29 Nov 2024 16:44:22 +0000 (16:44 +0000)]
process_madvise.2: Describe 6.13 behaviour permitting all madvise flags
Since Linux 6.13 it has become possible to use all madvise flags when
targeting the calling process.
Reviewed-by: David Hildenbrand <david@redhat.com>
Signed-off-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Message-Id: <
20241129164422 .89837-1-lorenzo.stoakes@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 28 Nov 2024 11:47:23 +0000 (12:47 +0100)]
readlink.2: SYNOPSIS: Use array notation
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 24 Nov 2024 20:42:00 +0000 (21:42 +0100)]
landlock_create_ruleset.2: SYNOPSIS: Add missing include
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Nov 2024 16:39:17 +0000 (17:39 +0100)]
share/mk/: $MANINTROPAGES: Remove redundant grep(1) call
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Nov 2024 16:37:54 +0000 (17:37 +0100)]
share/mk/: $MANEXT: Use extended regex
This makes the line fit in 80 columns, and also makes it simpler to
read.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Nov 2024 15:14:34 +0000 (16:14 +0100)]
scripts/bash_aliases: duffman(): Add function to diff all modified pages
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Nov 2024 15:03:34 +0000 (16:03 +0100)]
src/bin/sortman, sortman.1, share/mk/: Move sortman script to src/bin/, and add manual page
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Nov 2024 13:16:02 +0000 (14:16 +0100)]
man1/: SYNOPSIS: ffix
Use SY/YS, and other formatting improvements.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Nov 2024 11:36:08 +0000 (12:36 +0100)]
src/bin/diffman, diffman.1: Add program and its manual page
This program diffs manual pages. It's useful for reviewing changes to a
manual page:
$ diffman membarrier ./man2/membarrier.2 | less -R;
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 21 Nov 2024 23:54:37 +0000 (00:54 +0100)]
etc/checkpatch/checkpatch.conf: Ignore MACRO_ARG_PRECEDENCE
This diagnostic is useful for preventing unsafe macros, but other linter programs
provide a smaller rate of false positives, so let's turn this one off.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 21 Nov 2024 23:50:54 +0000 (00:50 +0100)]
etc/clang-tidy/config.yaml: -clang-diagnostic-sign-conversion
This diagnostic is too noisy, and isn't very useful. Turn it off.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 21 Nov 2024 23:52:18 +0000 (00:52 +0100)]
getgroups.2: EXAMPLES: Add example program
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Yuanchu Xie [Wed, 20 Nov 2024 04:52:14 +0000 (20:52 -0800)]
posix_fadvise.2: POSIX_FADV_NOREUSE now supported.
POSIX_FADV_NOREUSE is now supported in Linux. Update text regarding
former no op behavior. Indicate the readahead policy and treatment of
file pages read with this flag.
Link: <https://lore.kernel.org/linux-mm/
20221230215252 .
2628425 -2-yuzhao@google.com/>
Signed-off-by: T.J. Alumbaugh <talumbau@google.com>
Signed-off-by: Yuanchu Xie <yuanchu@google.com>
Message-Id: <
20241120045214 .
1294799 -1-yuanchu@google.com>
Acked-by: Yu Zhao <yuzhao@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Nov 2024 12:17:27 +0000 (13:17 +0100)]
alloca.3: Clarify that alloca(3)ted space is deallocated when the caller returns
Reported-by: Pali Rohár <pali@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 22:16:59 +0000 (23:16 +0100)]
mount_namespaces.7: Use correctly the terms "mount" and "mount point"
On Sun, Nov 17, 2024 at 16:12:24 +0100, Michael Kerrisk wrote:
>
> A "mount" is a tuple consisting of:
> * a mount ID
> * a source (e.g., a device)
> * a target or "mount point" (i.e. a path name)
> * the ID of the parent of this mount
> * other stuff (e.g., options)
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Cc: Jakub Wilk <jwilk@jwilk.net>
Acked-by: "Michael T. Kerrisk" <mtk.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 22:11:13 +0000 (23:11 +0100)]
cgroups.7: grfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 17:47:53 +0000 (18:47 +0100)]
man/: Terminology consistency reforms (n, size, length)
Use 'length' for the lenght of a string.
Use 'n' for the number of elements.
Use 'size' for the number of bytes. (And in wide-character string
functions, 'size' also refers to the number of wide characters.)
The change is quite large, and I might have made some mistakes.
But overall, this should improve consistency in use of these terms.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 15:24:05 +0000 (16:24 +0100)]
getdents.2: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 15:13:18 +0000 (16:13 +0100)]
wcwidth.3: Rename function parameter
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 15:11:13 +0000 (16:11 +0100)]
fmod.3: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 15:09:13 +0000 (16:09 +0100)]
remquo.3: pfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 12:14:54 +0000 (13:14 +0100)]
time.1: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 12:08:48 +0000 (13:08 +0100)]
sscanf.3: wfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 12:07:22 +0000 (13:07 +0100)]
attributes.7: wfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 12:05:50 +0000 (13:05 +0100)]
syscalls.2: tfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:59:40 +0000 (12:59 +0100)]
time.1: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:52:26 +0000 (12:52 +0100)]
sscanf.3: tfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:50:59 +0000 (12:50 +0100)]
sched_get_priority_max.2: pfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:49:01 +0000 (12:49 +0100)]
sscanf.3: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:45:14 +0000 (12:45 +0100)]
man/: tfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:34:00 +0000 (12:34 +0100)]
scanf.3: pfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:23:48 +0000 (12:23 +0100)]
proc_pid_fd.5: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:04:04 +0000 (12:04 +0100)]
getrpcent_r.3: tfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:02:24 +0000 (12:02 +0100)]
memusage.1: ffix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Nov 2024 11:01:06 +0000 (12:01 +0100)]
log1p.3: pfix
Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>