]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
7 months agoman/man3/: SYNOPSIS: Use typeof() to improve readability of function pointer types
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>
7 months agoman/man7/user_namespaces.7: tfix
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>
7 months agoman/man2/statx.2: Document STATX_DIO_READ_ALIGN
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>
7 months agosrc/bin/diffman, man/man1/diffman: Remove program
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>
7 months agoman/man1/diffman-git.1: Add manual page
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>
7 months agosrc/bin/: Rename duffman => diffman-git
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>
7 months agosrc/bin/duffman: Don't pipe to less(1)
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>
7 months agosrc/bin/duffman: Always read(1) -r
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>
7 months agosrc/bin/duffman: Handle errors correctly
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>
7 months agosrc/bin/duffman: Allow diffing two git references
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>
7 months agosrc/bin/duffman: Allow diffing git references, not just the working directory
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>
7 months agosrc/bin/duffman: Diff against HEAD, not the system pages
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>
7 months agosrc/bin/duffman: wsfix
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>
7 months agosrc/bin/duffman, scripts/bash_aliases: Move duffman() to a separate script
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>
7 months agoman/man2/stat.2: Linux 6.11 allows using NULL with AT_EMPTY_PATH.
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>
7 months agoman/man2/setns.2: Add missing info about time ns
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>
7 months agoman/man2/signal.2: VERSIONS: The typedef-less definition of signal(2) isn't hard...
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>
7 months agoman/: Use typeof() to improve readability of function pointer types
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>
7 months agoshare/mk/: $CLANG_CFLAGS: Add -Wno-language-extension-token
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>
7 months agosrc/bin/diffman: Simplify temporary file names
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>
7 months agosrc/bin/diffman: Use diff(1) labels for nicer output
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>
7 months agosrc/bin/diffman, man/man1/diffman.1: Use man(1) to format the pages
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>
7 months agoman/man3/: EXAMPLES: wsfix
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>
7 months agoman/man3/: EXAMPLES: Remove unnecessary parentheses
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>
7 months agoman/man3/sem_open.3: SYNOPSIS: This is a variadic function
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>
7 months agoman/man2/io_submit.2: Document RWF_NOAPPEND
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>
7 months agoman/man2/readv.2: Document RWF_NOAPPEND
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>
7 months agoman/man2/statx.2: Update STATX_WRITE_ATOMIC filesystem support
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>
7 months agoman/man3/pthread_cond_init.3: Remove EINTR error code
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>
7 months agoman/man7/signal.7: Don't mention that pthread API can return EINTR
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>
7 months agoman/man3/: Don't use 'length' to refer to buffer size
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>
7 months agoman/man3/stdio_ext.3: wfix
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>
7 months agoman/man3/{stdin,stdio}.3: SYNOPSIS: Consistently declare as 'extern' variables
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>
7 months agoman/man2/ioctl_pipe.2: SYNOPSIS: Fix $1, which is not an array parameter
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>
7 months agoman/man2/madvise.2: wfix
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>
7 months agoman/man3/string.3: SYNOPSIS: Simplify
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>
7 months agosrc/bin/diffman: Add support for mdoc(7) pages
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>
7 months agosrc/bin/diffman: Run the entire groff pipeline
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>
7 months agosrc/bin/diffman: Fix bug at parsing options
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>
7 months agosrc/bin/diffman, man/man1/diffman.1: -s: Add support for diff(1)'s -s flag
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>
7 months agosrc/bin/mansect: Use pipefail and some safety measures
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>
7 months agoman/man3/getline.3: wfix
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>
7 months agoCONTRIBUTING.d/patches/subject: Use the full path always
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>
7 months agoCONTRIBUTING: Add reference to CONTRIBUTING.d/git
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>
7 months agoman/man3/getopt.3: Remove _<PID>_GNU_nonoption_argv_flags_ description
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>
7 months agoman/man3/getline.3: Clarify ERRORS
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>
7 months agoCONTRIBUTING.d/git: mkdir(1) parent directory before writing to file
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>
7 months agoman/man3/strverscmp.3: This is NOT the ordering used by ls -v
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>
7 months agoscripts/bash_aliases: duffman(): Silence output of cp(1)
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>
7 months agoman/man2/get_mempolicy.2: SYNOPSIS: ffix
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>
7 months agoman/man2/: SYNOPSIS: Use array notation
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>
8 months agosrc/bin/diffman: Silence shellcheck(1) diagnostic
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>
8 months agosrc/bin/diffman: Add default case
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>
8 months agoman/: SYNOPSIS: Use typeof() to improve readability of function pointer types
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>
8 months agoman/man3/makecontext.3: SYNOPSIS: Add ellipsis to function type
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>
8 months agoman/man3/isalpha.3: tfix
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>
8 months agoproc_pid_fdinfo.5: Reduce indent for most of the page
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>
8 months agoscripts/bash_aliases: duffman: Pass any arguments (options) to diffman(1)
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>
8 months agosrc/bin/diffman, diffman.1: -U: Add support for diff(1)'s -U option
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>
8 months agosrc/bin/diffman: -w: Add support for diff(1)'s -w flag
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>
8 months agold.so.8: tfix
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>
8 months agomadvise.2: Add description of MADV_GUARD_INSTALL, MADV_GUARD_REMOVE
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>
8 months agoCONTRIBUTING.d/patches/description: Add link to history of inter-sentence space
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>
8 months agomadvise.2: MADV_SOFT_OFFLINE requests can report EBUSY
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>
8 months agoman/: wfix
Alejandro Colomar [Wed, 4 Dec 2024 10:06:38 +0000 (11:06 +0100)] 
man/: wfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoprocess_madvise.2: Describe 6.13 behaviour permitting all madvise flags
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>
8 months agoreadlink.2: SYNOPSIS: Use array notation
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>
8 months agolandlock_create_ruleset.2: SYNOPSIS: Add missing include
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>
8 months agoshare/mk/: $MANINTROPAGES: Remove redundant grep(1) call
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>
8 months agoshare/mk/: $MANEXT: Use extended regex
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>
8 months agoscripts/bash_aliases: duffman(): Add function to diff all modified pages
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>
8 months agosrc/bin/sortman, sortman.1, share/mk/: Move sortman script to src/bin/, and add manua...
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>
8 months agoman1/: SYNOPSIS: ffix
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>
8 months agosrc/bin/diffman, diffman.1: Add program and its manual page
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>
8 months agoetc/checkpatch/checkpatch.conf: Ignore MACRO_ARG_PRECEDENCE
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>
8 months agoetc/clang-tidy/config.yaml: -clang-diagnostic-sign-conversion
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>
8 months agogetgroups.2: EXAMPLES: Add example program
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>
8 months agoposix_fadvise.2: POSIX_FADV_NOREUSE now supported.
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>
8 months agoalloca.3: Clarify that alloca(3)ted space is deallocated when the caller returns
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>
8 months agomount_namespaces.7: Use correctly the terms "mount" and "mount point"
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>
8 months agocgroups.7: grfix
Alejandro Colomar [Sun, 17 Nov 2024 22:11:13 +0000 (23:11 +0100)] 
cgroups.7: grfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>
8 months agoman/: Terminology consistency reforms (n, size, length)
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>
8 months agogetdents.2: ffix
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>
8 months agowcwidth.3: Rename function parameter
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>
8 months agofmod.3: ffix
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>
8 months agoremquo.3: pfix
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>
8 months agotime.1: ffix
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>
8 months agosscanf.3: wfix
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>
8 months agoattributes.7: wfix
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>
8 months agosyscalls.2: tfix
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>
8 months agotime.1: ffix
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>
8 months agosscanf.3: tfix
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>
8 months agosched_get_priority_max.2: pfix
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>
8 months agosscanf.3: ffix
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>
8 months agoman/: tfix
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>
8 months agoscanf.3: pfix
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>
8 months agoproc_pid_fd.5: ffix
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>
8 months agogetrpcent_r.3: tfix
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>
8 months agomemusage.1: ffix
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>
8 months agolog1p.3: pfix
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>