aboutsummaryrefslogtreecommitdiffstats
AgeCommit message (Collapse)AuthorFilesLines
2025-01-11src/bin/duffman: Don't pipe to less(1)Alejandro Colomar1-2/+1
Let the user decide to pipe or not. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-11src/bin/duffman: Always read(1) -rAlejandro Colomar1-1/+1
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>
2025-01-11src/bin/duffman: Handle errors correctlyAlejandro Colomar1-1/+2
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>
2025-01-11src/bin/duffman: Allow diffing two git referencesAlejandro Colomar1-4/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-11src/bin/duffman: Allow diffing git references, not just the working directoryAlejandro Colomar1-5/+13
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-11src/bin/duffman: Diff against HEAD, not the system pagesAlejandro Colomar1-3/+34
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-10src/bin/duffman: wsfixAlejandro Colomar1-10/+9
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-10src/bin/duffman, scripts/bash_aliases: Move duffman() to a separate scriptAlejandro Colomar2-20/+21
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-09man/man2/stat.2: Linux 6.11 allows using NULL with AT_EMPTY_PATH.enh1-1/+3
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>
2025-01-07man/man2/setns.2: Add missing info about time nsMichal Clapinski1-1/+11
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>
2025-01-05man/man2/signal.2: VERSIONS: The typedef-less definition of signal(2) isn't ↵Alejandro Colomar1-2/+2
hard to read At least if you use typeof(). Acked-by: Jorenar <dev@jorenar.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-05man/: Use typeof() to improve readability of function pointer typesAlejandro Colomar7-17/+17
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>
2025-01-05share/mk/: $CLANG_CFLAGS: Add -Wno-language-extension-tokenAlejandro Colomar1-0/+1
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>
2025-01-05src/bin/diffman: Simplify temporary file namesAlejandro Colomar1-7/+2
Now that we're using labels, the file name is unimportant. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-05src/bin/diffman: Use diff(1) labels for nicer outputAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-05src/bin/diffman, man/man1/diffman.1: Use man(1) to format the pagesAlejandro Colomar2-14/+8
This allows using the environment variables that man(1) understands. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-05man/man3/: EXAMPLES: wsfixAlejandro Colomar2-2/+2
Add a space after a cast. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-05man/man3/: EXAMPLES: Remove unnecessary parenthesesAlejandro Colomar3-3/+3
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-05man/man3/sem_open.3: SYNOPSIS: This is a variadic functionAlejandro Colomar1-3/+2
Specify the prototype consistently with open(2). Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-01-04man/man2/io_submit.2: Document RWF_NOAPPENDJohn Garry1-0/+10
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>
2025-01-04man/man2/readv.2: Document RWF_NOAPPENDJohn Garry1-0/+23
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>
2025-01-04man/man2/statx.2: Update STATX_WRITE_ATOMIC filesystem supportJohn Garry1-0/+9
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>
2025-01-04man/man3/pthread_cond_init.3: Remove EINTR error codeArkadiusz Drabczyk1-3/+0
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>
2025-01-04man/man7/signal.7: Don't mention that pthread API can return EINTRArkadiusz Drabczyk1-4/+0
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>
2024-12-24man/man3/: Don't use 'length' to refer to buffer sizeAlejandro Colomar17-106/+106
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-24man/man3/stdio_ext.3: wfixAlejandro Colomar1-1/+1
For consistency with wide characters, say characters instead of bytes. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-24man/man3/{stdin,stdio}.3: SYNOPSIS: Consistently declare as 'extern' variablesAlejandro Colomar2-6/+6
And leave two spaces between the type name and the variable name. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-23man/man2/ioctl_pipe.2: SYNOPSIS: Fix $1, which is not an array parameterAlejandro Colomar1-2/+2
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>
2024-12-23man/man2/madvise.2: wfixLorenzo Stoakes1-1/+2
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>
2024-12-22man/man3/string.3: SYNOPSIS: SimplifyAlejandro Colomar1-150/+76
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>
2024-12-22src/bin/diffman: Add support for mdoc(7) pagesAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-22src/bin/diffman: Run the entire groff pipelineAlejandro Colomar1-2/+11
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-22src/bin/diffman: Fix bug at parsing optionsAlejandro Colomar1-5/+5
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>
2024-12-22src/bin/diffman, man/man1/diffman.1: -s: Add support for diff(1)'s -s flagAlejandro Colomar2-2/+7
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-22src/bin/mansect: Use pipefail and some safety measuresAlejandro Colomar1-1/+4
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-20man/man3/getline.3: wfixAlejandro Colomar1-2/+2
Fixes: ef53ef760638 (2024-12-18, "man/man3/getline.3: Clarify ERRORS") Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-19CONTRIBUTING.d/patches/subject: Use the full path alwaysAlejandro Colomar1-7/+4
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>
2024-12-19CONTRIBUTING: Add reference to CONTRIBUTING.d/gitAlejandro Colomar1-0/+3
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-19man/man3/getopt.3: Remove _<PID>_GNU_nonoption_argv_flags_ descriptionAhelenia Ziemiańska1-9/+6
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>
2024-12-18man/man3/getline.3: Clarify ERRORSenh1-4/+6
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>
2024-12-16CONTRIBUTING.d/git: mkdir(1) parent directory before writing to fileAlejandro Colomar1-0/+1
Reported-by: Elliott Hughes <enh@google.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-16man/man3/strverscmp.3: This is NOT the ordering used by ls -vAhelenia Ziemiańska1-15/+8
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>
2024-12-15scripts/bash_aliases: duffman(): Silence output of cp(1)Alejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-14man/man2/get_mempolicy.2: SYNOPSIS: ffixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-14man/man2/: SYNOPSIS: Use array notationAlejandro Colomar2-5/+5
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-13src/bin/diffman: Silence shellcheck(1) diagnosticAlejandro Colomar1-0/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-13src/bin/diffman: Add default caseAlejandro Colomar1-0/+1
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>
2024-12-13man/: SYNOPSIS: Use typeof() to improve readability of function pointer typesAlejandro Colomar27-69/+79
Suggested-by: Jorenar <dev@jorenar.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-13man/man3/makecontext.3: SYNOPSIS: Add ellipsis to function typeAlejandro Colomar1-3/+3
The old syntax with empty parentheses has been removed from the language in C23. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-11man/man3/isalpha.3: tfixAlejandro Colomar1-12/+12
Fixes: ba687b00ecb3 (2023-07-30, "man3/: srcfix") Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-06proc_pid_fdinfo.5: Reduce indent for most of the pageIan Rogers1-36/+25
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>
2024-12-06scripts/bash_aliases: duffman: Pass any arguments (options) to diffman(1)Alejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-06src/bin/diffman, diffman.1: -U: Add support for diff(1)'s -U optionAlejandro Colomar2-2/+10
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-06src/bin/diffman: -w: Add support for diff(1)'s -w flagAlejandro Colomar2-1/+25
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-06ld.so.8: tfixAnhad Singh1-1/+1
Signed-off-by: Anhad Singh <andypython@protonmail.com> Message-Id: <20241206071814.55913-1-andypython@protonmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-05madvise.2: Add description of MADV_GUARD_INSTALL, MADV_GUARD_REMOVELorenzo Stoakes1-0/+102
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>
2024-12-05CONTRIBUTING.d/patches/description: Add link to history of inter-sentence spaceAlejandro Colomar1-1/+3
Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-05madvise.2: MADV_SOFT_OFFLINE requests can report EBUSYtyberry@redhat.com1-0/+7
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>
2024-12-04man/: wfixAlejandro Colomar4-4/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-04process_madvise.2: Describe 6.13 behaviour permitting all madvise flagsLorenzo Stoakes1-1/+7
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>
2024-11-28readlink.2: SYNOPSIS: Use array notationAlejandro Colomar1-3/+3
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-26landlock_create_ruleset.2: SYNOPSIS: Add missing includeAlejandro Colomar1-0/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-26share/mk/: $MANINTROPAGES: Remove redundant grep(1) callAlejandro Colomar1-1/+0
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-26share/mk/: $MANEXT: Use extended regexAlejandro Colomar2-7/+7
This makes the line fit in 80 columns, and also makes it simpler to read. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-26scripts/bash_aliases: duffman(): Add function to diff all modified pagesAlejandro Colomar1-0/+20
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-26src/bin/sortman, sortman.1, share/mk/: Move sortman script to src/bin/, and ↵Alejandro Colomar3-2/+34
add manual page Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-25man1/: SYNOPSIS: ffixAlejandro Colomar13-39/+66
Use SY/YS, and other formatting improvements. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-25src/bin/diffman, diffman.1: Add program and its manual pageAlejandro Colomar2-0/+73
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>
2024-11-22etc/checkpatch/checkpatch.conf: Ignore MACRO_ARG_PRECEDENCEAlejandro Colomar1-0/+1
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>
2024-11-22etc/clang-tidy/config.yaml: -clang-diagnostic-sign-conversionAlejandro Colomar1-0/+1
This diagnostic is too noisy, and isn't very useful. Turn it off. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-22getgroups.2: EXAMPLES: Add example programAlejandro Colomar1-0/+61
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-20posix_fadvise.2: POSIX_FADV_NOREUSE now supported.Yuanchu Xie1-1/+9
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>
2024-11-19alloca.3: Clarify that alloca(3)ted space is deallocated when the caller returnsAlejandro Colomar1-1/+2
Reported-by: Pali Rohár <pali@kernel.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17mount_namespaces.7: Use correctly the terms "mount" and "mount point"Alejandro Colomar1-2/+3
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>
2024-11-17cgroups.7: grfixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17man/: Terminology consistency reforms (n, size, length)Alejandro Colomar67-425/+425
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>
2024-11-17getdents.2: ffixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17wcwidth.3: Rename function parameterAlejandro Colomar1-6/+6
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17fmod.3: ffixAlejandro Colomar1-1/+3
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17remquo.3: pfixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17time.1: ffixAlejandro Colomar1-1/+3
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17sscanf.3: wfixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17attributes.7: wfixAlejandro Colomar1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17syscalls.2: tfixAlejandro Colomar1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17time.1: ffixAlejandro Colomar1-1/+3
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17sscanf.3: tfixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17sched_get_priority_max.2: pfixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17sscanf.3: ffixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17man/: tfixAlejandro Colomar4-4/+4
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17scanf.3: pfixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17proc_pid_fd.5: ffixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17getrpcent_r.3: tfixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17memusage.1: ffixAlejandro Colomar1-1/+3
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17log1p.3: pfixAlejandro Colomar1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17listmount.2: Fix off-by-one bug in description about continuing the iterationJeff Layton1-1/+1
The "+1" is wrong, since the kernel already increments the last_id. Cc: Miklos Szeredi <miklos@szeredi.hu> Cc: Josef Bacik <josef@toxicpanda.com> Cc: Christian Brauner <brauner@kernel.org> Signed-off-by: Jeff Layton <jlayton@kernel.org> Message-ID: <20241113-main-v1-1-a6b738d56e55@kernel.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17printf.3: wfixKen Pizzini1-2/+5
Improve description of %a format. The description of the %a/%A specifiers in the printf(3) man page could stand some improvement. In particular, it is not clear from the current document what base is used for the "p±d" part of the format. It can be inferred from the nature of %a that the base should be a power of two. And it can be further inferred from the nature of hexadecimal floating-point literals in C (as specified by C99 and later) that the base must exactly be the number two, but it would be helpful for the printf(3) man page to state this explicitly. My first expectation when reading the man page was that the exponent would be taken in base 16; after experimentation my second thought was that it would be base FLT_RADIX (which is 2 on IEEE 754 floating-point systems, but 16 on S/390). Only by going back to the standard [1] could I determine that the exponent in p-notation must always be taken from a base of 2. Link: [1] POSIX.1-2024 <https://pubs.opengroup.org/onlinepubs/9799919799/functions/printf.html> Cc: Jonathan Wakely <jwakely@redhat.com> Signed-off-by: Ken Pizzini <ken@gnu.org> Message-ID: <b932f13642502e063ef139d57b8f3c496023bf4a.1731707666.git.ken@gnu.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-17printf.3: wfixKen Pizzini1-2/+2
Improve terminology in %a description The term "decimal point" does not technically apply when using bases other than 10; the more generic term is "radix point". Update the description of the a/A conversion specifier (i.e., for hexadecimal floating point output) in printf(3) to use this terminology. I do note that POSIX.1-2024 [1] does use the term "decimal-point character" here, but I still maintain that using "radix point" is a better term for that object in the %a description. (Confusingly, POSIX does refer to "radix character" in the descriptions of %f and %e, where reference to "decimal" instead of "radix" would actually make sense.) Link: [1] <https://pubs.opengroup.org/onlinepubs/9799919799/functions/printf.html> Signed-off-by: Ken Pizzini <ken@gnu.org> Message-ID: <db91cc6f-93cc-4e99-806c-7a8b86232848@vagg4fs7.msa.explicate.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-14lsearch.3: Dereference 'nmemb' pointerAlejandro Colomar1-2/+2
nmemb is a pointer, so it needs to be dereferenced to calculate the size of the array. Reported-by: Martin Uecker <uecker@tugraz.at> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-13pthread_cond_init.3: tfixAlejandro Colomar1-1/+1
Reported-by: Antti Antinoja <antti@c1.fi> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-13rtnetlink.7: Document struct ifa_cacheinfoAlex Henrie1-1/+18
struct ifa_cacheinfo contains the address's creation time, update time, preferred lifetime remaining, and valid lifetime remaining. Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/include/uapi/linux/if_addr.h?h=v6.11#n60> Cc: <netdev@vger.kernel.org> Signed-off-by: Alex Henrie <alexhenrie24@gmail.com> Message-ID: <20241111062205.207027-1-alexhenrie24@gmail.com> Reviewed-by: Kuniyuki Iwashima <kuniyu@amazon.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-13mremap.2: Update information about MREMAP_DONTUNMAP restrictionsAlex Henrie1-1/+7
Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=a4609387859f0281951f5e476d9f76d7fb9ab321> Cc: Brian Geffon <bgeffon@google.com> Cc: <linux-mm@kvack.org> Signed-off-by: Alex Henrie <alexhenrie24@gmail.com> Message-ID: <20241111061139.206404-1-alexhenrie24@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-07CONTRIBUTING.d/lint: 'make build' does not build everything anymoreAlejandro Colomar1-2/+2
Fixes: 082547cb6fbb ("share/mk/: Reduce the work of 'make && make install'") Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/patches: Patches should contain a description.Alejandro Colomar1-0/+4
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/patches: Minor tweaks after splitting the fileAlejandro Colomar1-10/+9
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/sendmail: Add file documenting how to send patchesAlejandro Colomar2-48/+51
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/base: Add file documenting the base commit of patch setsAlejandro Colomar2-3/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/range-diff: Add file documenting the range-diff ↵Alejandro Colomar2-31/+37
between patch revisions Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/diff: Add file documenting the diff of a patchAlejandro Colomar2-4/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/description: Add file documenting the description of ↵Alejandro Colomar2-39/+55
a patch Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/subject: Add file documenting the subject of a patchAlejandro Colomar2-21/+41
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/patches: Move file into a subdirectoryAlejandro Colomar2-1/+1
This is in preparation of a split that will happen soon. The file has grown too much, and I will split it in smaller ones that cover different aspects of patches. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06bind.2: move EADDRNOTAVAIL to general errorsPhilipp Takacs1-4/+4
EADDRNOTAVAIL is not a socket specific error Message-ID: <eee2fe5c6c3d6203e1e528a998b0de2c.philipp@bureaucracy.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-05fanotify_mark.2, fanotify.7: Update documentation of fanotify w.r.t fsidAmir Goldstein2-6/+32
Clarify the conditions for getting the -EXDEV and -ENODEV errors. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Message-ID: <20241105144939.181820-1-amir73il@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-05pthread_cancel.3: tfixAlejandro Colomar1-1/+1
Reported-by: Jona Christopher Sahnwaldt <jcsahnwaldt@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-04scripts/bash_aliases: man_gitstaged(): Trim the dirname(1) only for files ↵Alejandro Colomar1-4/+4
within man/ I changed the behavior at some point to trim the dirname(1) for every file. However, that was mainly due to the inconvenience of not having a man/ directory. Also, I haven't been consistent with that behavior, and have been manually adding back the dirname(1), so let's bring back the old behavior --which is BTW still what the comment says it does--. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-04CONTRIBUTING.d/git: Specify format.thread=shallowAlejandro Colomar1-1/+1
Setting it to true is equivalent to "shallow", but set it explicitly. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03CONTRIBUTING.d/git: Recommend merge.verifySignatures=trueAlejandro Colomar1-0/+5
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03CONTRIBUTING.d/git: Sort alphabeticallyAlejandro Colomar1-6/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03share/mk/: wsfixAlejandro Colomar6-8/+8
Add some spaces for readability and consistency. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03LICENSES/GPL-3.0-or-later.txt: Add license textAlejandro Colomar1-0/+232
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03share/mk/: lint-c: Skip some false positivesAlejandro Colomar2-0/+2
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03etc/clang-tidy/config.yaml: -misc-include-cleanerAlejandro Colomar1-0/+1
We want to enable this warning again in the future, but for now it has too many false positives. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03etc/clang-tidy/config.yaml: -cppcoreguidelines-macro-to-enum, ↵Alejandro Colomar1-0/+2
-readability-avoid-nested-conditional-operator Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03man/: EXAMPLES: Fix includesAlejandro Colomar6-2/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03pdfman.1: srcfixAlejandro Colomar1-1/+0
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03share/mk/: [un]install-bin: Add target to [un]install shell scriptsAlejandro Colomar4-2/+44
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03etc/shellcheck/shellcheckrc: disable=SC2250Alejandro Colomar1-0/+1
Adding braces unnecessarily adds noise and thus hurts readability. Ignore advice. === In src/bin/mansect line 23: -e '(?s)^\.SH ('"$s"')$(?:(?!^\.(lf 1|TH|SH) ).)*'; ^-- SC2250 (style): Prefer putting braces around variable references even when not strictly required. === Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03etc/shellcheck/shellcheckrc: disable=SC2016Alejandro Colomar1-0/+1
This triggers false positives with trivial PCRE2 regexes. === In src/bin/mansect line 23: -e '(?s)^\.SH ('"$s"')$(?:(?!^\.(lf 1|TH|SH) ).)*'; ^----------------------------^ SC2016 (info): Expressions don't expand in single quotes, use double quotes for that. === Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03etc/shellcheck/shellcheckrc: disable=SC2038Alejandro Colomar1-0/+1
We don't want to support arbitrary manual-page file names. === In src/bin/mansect line 17: find -H "$@" -not -type d \ ^-----------------------^ SC2038 (warning): Use -print0/-0 or -exec + to allow for non-alphanumeric filenames. === Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03share/mk/, etc/shellcheck/: lint-sh: Add target to lint shell scriptsAlejandro Colomar8-1/+84
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03src/bin/pdfman: Pipe to read(1) with lastpipeAlejandro Colomar1-1/+5
This is more readable than nested command substitution. We already require bash(1) for ${!#}, so we can abuse it a little bit more. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03src/bin/pdfman: Use command substitution instead of shell magicAlejandro Colomar1-1/+1
This is significantly more readable. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03src/bin/pdfman, scripts/bash_aliases, pdfman.1: Make pdfman a standalone ↵Alejandro Colomar3-11/+36
program, and add a manual page Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03scripts/bash_aliases: pdfman(): Don't have custom error messageAlejandro Colomar1-5/+0
Run man(1) transparently, and let it report the error. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03scripts/bash_aliases: pdfman(): Use -Tpdf directlyAlejandro Colomar1-3/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03scripts/bash_aliases: man_lsfunc(), man_lsvar(): Use pcre2grep(1) instead of ↵Alejandro Colomar1-3/+3
pcregrep(1) pcregrep(1) is obsolete. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03scripts/bash_aliases: man_lsfunc(), man_lsvar(): Use mansect(1)Alejandro Colomar1-39/+6
Remove the man_section() function, and call the mansect(1) program instead. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03src/bin/mansect, mansect.1: Add program and its manual pageAlejandro Colomar2-0/+87
Preprocess with preconv(1). This doesn't process the pages in a significant way, and has the benefit that it writes the name of the pages in the output. Cc: "G. Branden Robinson" <branden@debian.org> Cc: Colin Watson <cjwatson@debian.org> Cc: <groff@gnu.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01signal.7: Better description for SIGFPEVincent Lefevre1-1/+1
SIGFPE has comment "Floating-point exception", which corresponds to the FPE acronym. But this is misleading as this signal may also be generated by an integer division by 0. Change it to "Erroneous arithmetic operation" from POSIX. Note: the GNU C Library manual says "fatal arithmetic error". Link: <https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/signal.h.html> Link: <https://www.gnu.org/software/libc/manual/html_node/Program-Error-Signals.html> Signed-off-by: Vincent Lefevre <vincent@vinc17.net> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01CONTRIBUTING.d/git: Recommend am.messageid=trueAlejandro Colomar1-0/+6
This is useful for maintainers. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01CONTRIBUTING.d/patches: Documentation patches should be sent alongside the ↵Alejandro Colomar1-0/+20
features Link: <https://lwn.net/Articles/989380/> Cc: Jiri Olsa <jolsa@kernel.org> Cc: Günther Noack <gnoack@google.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01dup.2: ERRORS: Add ENOMEMLevi Zim1-0/+3
dup2(2) could return ENOMEM under extreme condition. For example, when sysctl fs.nr_open=2147483584, and RLIMIT_NOFILE is also 2147483584. The following program fails with ENOMEM: int main(void) { if (dup2(0, 2000000000) == -1) err(1, "dup2"); return 0; } This ENOMEM comes from an allocation error here: <https://elixir.bootlin.com/linux/v6.1/source/mm/util.c#L596> ENOMEM is already documented for open(2). Signed-off-by: Levi Zim <rsworktech@outlook.com> [alx: tweak commit message] Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01bind.2: ERRORS: Document possible errors from protocolLucas Culverhouse1-0/+2
When looking through the errors of socket(2) I noticed that it specifies the selected underlying protocol may extend the potential errors returned. For example, using AF_PACKET and SOCK_RAW can return EPERM if the user does not have CAP_NET_RAW or uid 0 (this is all fully documented). However, AF_PACKET and SOCK_RAW extend the potential errors returned from bind(2) as well. For example, calling bind(2) with an invalid sll_ifindex set on the sock_addr passed in will return ENODEV. While this possibility is documented in the raw(7) manual page, the bind(2) manual page does not mention that its potential set of errors can be extended by the underlying protocol. This patch simply duplicates the relevant language from the socket(2) manual page to the bind(2) manual page. It is possible further extensions for send(2), recv(2), setsockopt(2), etc. are also undocumented, but I have not yet verified this. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-08timespec_get.3, timespec_getres.3: Add page and link pageнаб2-0/+89
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Message-ID: <lacitlat2jwybavkgkmmsxfbzcbz532uihejn5k2boe2x5eyyy@tarta.nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01console_codes.4, inode.7: srcfixG. Branden Robinson2-3/+7
Prepare for `MR` macro migration. Rewrite man page cross references inside tbl(1) text blocks to use man(7) macros instead of troff(1) font selection escape sequences. $ cat fix-man-page-refs-in-tbl-tables-1.sed # Rewrite man page cross references inside tbl(1) text blocks to use # man(7) macros instead of troff(1) font selection escape sequences. /^\.\\"/b # Case: (handled in commit 9d21f97766, 2024-07-27) # T{ # See \fBchown\fP(2) for # T} /T{$/,/^T}/s/ \\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\) /\ .BR \1 \2\ / # Case: # T{ # the map that is loaded by the utility \fBmapscrn\fP(8). # T} /T{$/,/^T}/s/ \\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\([^0-9a-z]\+\)$/\ .BR \1 \2\3/ # Case: # T{ # by \fBxterm\fP(1)'s \fBhpLowerleftBugCompat\fP resource). # T} /T{$/,/^T}/s/ \\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\([^ ]\+\) \(.*\)/\ .BR \1 \2\3\ \4/ Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032603.khxdcqiqc2pxooky@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01lirc.4: srcfixG. Branden Robinson1-1/+3
Prepare for `MR` macro migration. Migrate man page cross references in "SEE ALSO" section from using font selection escape sequences to font alternation macros to set man page cross references. This is an oddball case where `\-` appears in the man page title and, for no obvious reason, a nonbreaking space escape sequence was applied between list items. (I can _guess_ why: someone was trying to defeat line adjustment, and didn't notice that they were trying to do so right before a paragraph break, so adjustment wouldn't have happened anyway.) Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032556.mmrwd27rpr3zzb5s@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01suffixes.7: srcfixG. Branden Robinson1-3/+15
Prepare for `MR` macro migration. Migrate man page cross references in table rows from using font selection escape sequences to font alternation macros to set man page cross references. These are a handful of cases that made a sed(1)-scripted migration ordering-dependent with its substitution ('s') commands. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032548.olkeoqjwpj76h42b@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01utmp.5: srcfixG. Branden Robinson1-4/+11
Prepare for `MR` macro migration. Migrate man page cross references in unfilled examples from using font selection escape sequences to font alternation macros to set man page cross references. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032530.wrvbtb4wisgnkcns@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01utmp.5: srcfixG. Branden Robinson1-1/+1
Set init(1) man page cross references like all the others in the page. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032523.qsfzdca46pcr524f@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01wctrans.3, wctype.3: srcfixG. Branden Robinson2-20/+22
Convert from unfilled text using `nf` and `fi` requests to `IP` macro calls and tbl(1) tables. This change increases the item indentation slightly, as I elected not to specify one in the `IP` calls. The content still fits easily in an 80-column terminal. The reason for this change is to make the man page cross references susceptible to scripted rewriting (and ultimately to make them hyperlinkable). See, e.g., <https://lore.kernel.org/linux-man/20240831182027.b6pduwkthk5b3tcf@illithid/>. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032513.afty634vpnhe24zi@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01namespaces.7: srcfixG. Branden Robinson1-4/+12
Use *roff requests to shut off adjustment and hyphenation for the rightmost column of the table, which uses text blocks. (In man pages, use of such requests _outside_ of tbl(1) text blocks remains discouraged by groff(1) and mandoc(1) developers.) Also break filled input lines less aggressively. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032505.ralmc2yuwd4psgos@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-09-01namespaces.7: ffixG. Branden Robinson1-0/+2
Put a paragraph break above the table to ensure separation from the preceding paragraph with the man(7) macros from groff >= 1.23 and forthcoming mandoc(1) release. Draw a horizontal rule under the column headings. Link: <https://cvsweb.bsd.lv/mandoc/man_term.c?rev=1.241&content-type=text/x-cvsweb-markup> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240901032453.3dmhjz7urk2saizq@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-31CONTRIBUTING.d/git: Recommend format.thread=trueAlejandro Colomar1-0/+4
This generates patch sets as threads, with a Message-ID pre-set for the first mail. Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-31namespaces.7: ffixG. Branden Robinson1-2/+2
Prepare for `MR` macro migration. Let the table columns breathe again. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240831182057.u6mza33uhz55j3xd@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-31man/: srcfixG. Branden Robinson3-6/+6
Prepare for `MR` macro migration. Explicitly set the width of certain table columns so that they don't change or cause "can't break line" warnings from troff(1) when the rows are converted to use text blocks. Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240831182045.kvhjjxbztnhudjga@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-31man/: srcfixG. Branden Robinson2-62/+186
Prepare for `MR` macro migration. Migrate table entries from using font selection escape sequences to font alternation macros to set man page cross references. This change was automatically driven by the following sed(1) script. $ cat fix-man-page-refs-in-tbl-tables-2.sed # Rewrite man page cross references on tbl(1) rows that # precede text blocks to themselves use text blocks, # and convert them to use man(7) macros # instead of troff(1) font selection escape sequences # (which cannot be done outside a text block). /^\.\\"/b /^\\fB[^\\]*\\fP([0-9][a-z]*).*T{/s/\\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\(.*\)/T{\ .BR \1 \2\ T}\3/ Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Message-ID: <20240831182027.b6pduwkthk5b3tcf@illithid> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-30tzset.3: CAVEATS: Document the inability of tzset() to report errorsAlejandro Colomar1-0/+3
NetBSD has tzalloc(3), which returns NULL to report invalid tme zones. Cc: Paul Eggert <eggert@cs.ucla.edu> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-30ctime.3: EXAMPLES: Document how to detect invalid or ambiguous timesAlejandro Colomar1-1/+77
This example documents how to detect some corner cases of mktime(3), such as DST transitions and other jumps in the calendar. Link: <https://www.redhat.com/en/blog/brief-history-mktime> Cc: DJ Delorie <dj@redhat.com> Cc: Carlos O'Donell <carlos@redhat.com> Cc: Paul Eggert <eggert@cs.ucla.edu> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-30ctime.3: CAVEATS: Add note about tm_isdst handling in mktime(3)DJ Delorie1-0/+39
Handling of "invalid" values for tm_isdst is not clearly specified in any standard, and implementations vary as to how they react when you (for example) pass tm_isdst=1 at a time when DST is not in effect. Add a note about this, and a suggestion for a workaround. I go into further detail about this in the link below. Link: <https://www.redhat.com/en/blog/brief-history-mktime> Cc: Paul Eggert <eggert@cs.ucla.edu> Cc: Carlos O'Donell <carlos@redhat.com> Signed-off-by: DJ Delorie <dj@redhat.com> Message-ID: <xncylqiznb.fsf@greed.delorie.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-29pipe.7: Document change to default pipe size when soft limit is exceededKienan Stewart1-1/+3
See Linux commit 46c4c9d1beb7f5b4cec4dd90e7728720583ee348 ("pipe: increase minimum default pipe size to 2 pages"). Cc: Alex Xu (Hello71) <alex_y_xu@yahoo.ca> Signed-off-by: Kienan Stewart <kstewart@efficios.com> Message-ID: <20240829204448.2027276-2-kstewart@efficios.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-29pipe.7: Reference potential lower default in "Pipe capacity" sub-sectionKienan Stewart1-0/+3
The default capacity of pipes is two pages for users exceeding the pipe-user-pages-soft limit. Before Linux 5.14, it was only one page. Signed-off-by: Kienan Stewart <kstewart@efficios.com> Message-ID: <20240829154304.2010305-2-kstewart@efficios.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-28dlinfo.3: Document the RTLD_DI_PHDR requestFlorian Weimer1-1/+14
First added in glibc 2.36, backported upstream to glibc 2.34, so mention 2.34.1 for the first version. Signed-off-by: Florian Weimer <fweimer@redhat.com> Message-ID: <87o75chpwb.fsf@oldenburg.str.redhat.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-28share/mk/: build-pdf-book: Rename book to "GNU/Linux Programmer's Manual"Alejandro Colomar2-2/+2
The manual pages in this project had historically used the 5th argument to TH, with the string "Linux Programmer's Manual". This was showed as the center-top title of the pages. This was incidentally consistent with the UNIX Programmer's Manual. A few years ago, I removed the 5th argument to TH to use the default string, to follow conventions. At the same time, I put the project name and version in the 4th argument to TH: "Linux man-pages X.Y". When we added the scripts written by Deri to produce a PDF book, the title of the book was "The Linux Manpage Book", and the front page said "GNU/Linux\nTHE MAN PAGES BOOK". For consistency with the project name, I changed those some time ago to be title: "The Linux man-pages Book" and front: "GNU/Linux\nTHE MAN-PAGES BOOK". However, for consistency with the UNIX Programmer's Manual, and with the old title used within the project, I'm now (partially) restoring the title of the book and its front page to be both: "GNU/Linux Programmer's Manual". (It's not fully restorative, because it has GNU/Linux where the old title had just Linux, but half of our documentation is for glibc, so I think it's deserved.) (I was never convinced by the old front text: why should it have the word "book"?) Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu> Cc: "G. Branden Robinson" <branden@debian.org> Cc: Deri James <deri@chuzzlewit.myzen.co.uk> Cc: "Michael T. Kerrisk" <mtk.manpages@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-28statx.2: Document AT_EMPTY_PATH allows using NULL instead of "" for pathnameXi Ruoyao1-6/+13
Link: <https://git.kernel.org/torvalds/c/0ef625bba6fb> Cc: Mateusz Guzik <mjguzik@gmail.com> Cc: Christian Brauner <brauner@kernel.org> Cc: <linux-fsdevel@vger.kernel.org> Signed-off-by: Xi Ruoyao <xry111@xry111.site> Message-ID: <20240827102518.43332-2-xry111@xry111.site> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-27share/mk/: $CLANG_CFLAGS: -Wno-used-but-marked-unusedAlejandro Colomar1-1/+2
This diagnostic is triggered by valid calls to printf(3). Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-27splice.2: EXAMPLES: Add example programAlejandro Colomar1-1/+50
This example demonstrates the use of off_out, which the tee(2) example doesn't use. Here's a run of the program: $ gcc -Wall -Wextra splice.c $ ./a.out New offset is 22 $ echo $? 0 $ hd out 00000000 00 00 00 00 00 00 00 00 00 00 48 65 6c 6c 6f 2c |..........Hello,| 00000010 20 77 6f 72 6c 64 | world| 00000016 Link: <https://lore.kernel.org/linux-man/4xw464u2munxbgujopgfggxvnvgxa2b5lh35eriaeziapaa4uq@z6jmdim6f5mo/T/#t> Co-developed-by: Absee Seeab <doesnt.look.like.temp.mail@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-27splice.2: off_{in,out} are updated by splice(2)Alejandro Colomar1-1/+4
Link: <https://lore.kernel.org/linux-man/4xw464u2munxbgujopgfggxvnvgxa2b5lh35eriaeziapaa4uq@z6jmdim6f5mo/T/#t> Reported-by: Absee Seeab <doesnt.look.like.temp.mail@gmail.com> Co-developed-by: Absee Seeab <doesnt.look.like.temp.mail@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-27share/mk/: $CLANG_CFLAGS: -Wno-unreachable-codeAlejandro Colomar1-0/+1
The example program in ctime(3) triggers that diagnostic due to a compile-time check of the signedness of time_t. The code is legitimate. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-24ctime.3: Move NOTES to a subsection within CAVEATSAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-23ctime.3: Document how to check errors from mktime(3)Alejandro Colomar1-1/+103
-1 is a valid successful time_t, for one second before the Epoch. And mktime(3) is allowed (like most libc calls) to set errno on success. This makes it impossible to determine errors from the return value or errno. ISO C specifies that tp->tm_wday is unmodified after a failed call, and puts an example where this is used to determine errors. It is indeed the only way to check for errors from this call. Document this detail in the RETURN VALUE section, add a CAVEATS section that warns about this, and write an example program that shows how to properly call this function. Most code I've been able to find in several search engines either doesn't check for errors after mktime(3), or checks them incorrectly, so this documentation should help fix those. This is guaranteed since ISO C23 and POSIX.1-2024. Prior to those standards, there was no standard way to check for errors. However, there are no known implementations that do not conform to this. Link: <https://lore.kernel.org/linux-man/20240823131024.GD2713@cventin.lip.ens-lyon.fr/T/#t> Link: <https://lore.kernel.org/linux-man/6un6baaq5tez23irtycuvzqtuh7a4sdrf2px7tnyb3y6iqoxmq@2ofln4cd27ep/T/#t> Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3147.txt> Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3148.doc> Link: <https://austingroupbugs.net/view.php?id=1614> Link: <https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3220.pdf#subsubsection.7.29.2.3> Reported-by: Paul Eggert <eggert@cs.ucla.edu> Cc: Vincent Lefevre <vincent@vinc17.net> Cc: DJ Delorie <dj@redhat.com> Cc: Carlos O'Donell <carlos@redhat.com> Cc: Xi Ruoyao <xry111@xry111.site> Cc: Brian Inglis <Brian.Inglis@SystematicSW.ab.ca> Cc: "Robert C. Seacord" <rcseacord@gmail.com> Cc: Jens Gustedt <jens.gustedt@inria.fr> Cc: Robert Elz <kre@munnari.oz.au> Cc: Andrew Josey <ajosey@opengroup.org> Cc: Geoff Clare <gwc@opengroup.org> Cc: Hans Åberg <haberg-1@telia.com> Cc: GNU C Library <libc-alpha@sourceware.org> Cc: Austin Group <austin-group-l@opengroup.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_*.2const: Make sashimiAlejandro Colomar26-1900/+2489
2024-08-21keyctl.2: Tweak after making sashimi of this pageAlejandro Colomar1-6/+5
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_RESTRICT_KEYRING.2const: Tweak after splitAlejandro Colomar1-44/+15
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_RESTRICT_KEYRING.2const: Split KEYCTL_RESTRICT_KEYRING from ↵Alejandro Colomar2-91/+140
keyctl(2) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_DH_COMPUTE.2const: Tweak after splitAlejandro Colomar1-81/+46
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_DH_COMPUTE.2const: Split KEYCTL_DH_COMPUTE from keyctl(2)Alejandro Colomar2-278/+317
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_GET_PERSISTENT.2const: Tweak after splitAlejandro Colomar1-39/+17
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_GET_PERSISTENT.2const: Split KEYCTL_GET_PERSISTENT from ↵Alejandro Colomar2-76/+122
keyctl(2) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_INVALIDATE.2const: Tweak after splitAlejandro Colomar1-25/+7
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_INVALIDATE.2const: Split KEYCTL_INVALIDATE from keyctl(2)Alejandro Colomar2-42/+89
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_SESSION_TO_PARENT.2const: Tweak after splitAlejandro Colomar1-32/+17
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_SESSION_TO_PARENT.2const: Split KEYCTL_SESSION_TO_PARENT ↵Alejandro Colomar2-60/+108
from keyctl(2) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_GET_SECURITY.2const: Tweak after splitAlejandro Colomar1-34/+16
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_GET_SECURITY.2const: Split KEYCTL_GET_SECURITY from keyctl(2)Alejandro Colomar2-62/+107
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_ASSUME_AUTHORITY.2const: Tweak after splitAlejandro Colomar1-31/+13
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_ASSUME_AUTHORITY.2const: Split KEYCTL_ASSUME_AUTHORITY from ↵Alejandro Colomar2-80/+125
keyctl(2) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_SET_TIMEOUT.2const: Tweak after splitAlejandro Colomar1-28/+10
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_SET_TIMEOUT.2const: Split KEYCTL_SET_TIMEOUT from keyctl(2)Alejandro Colomar2-47/+94
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_SET_REQKEY_KEYRING.2const: Tweak after splitAlejandro Colomar1-28/+8
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_SET_REQKEY_KEYRING.2const: Split KEYCTL_SET_REQKEY_KEYRING ↵Alejandro Colomar2-99/+144
from keyctl(2) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_INSTANTIATE.2const: Tweak after splitAlejandro Colomar1-77/+40
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_INSTANTIATE.2const, KEYCTL_INSTANTIATE_IOV.2const, ↵Alejandro Colomar5-170/+242
KEYCTL_NEGATE.2const, KEYCTL_REJECT.2const: Split KEYCTL_INSTANTIATE*, KEYCTL_NEGATE, KEYCTL_REJECT from keyctl(2) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_READ.2const: Tweak after splitAlejandro Colomar1-40/+15
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_READ.2const: Split KEYCTL_READ from keyctl(2)Alejandro Colomar2-75/+121
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_SEARCH.2const: Tweak after splitAlejandro Colomar1-42/+23
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_SEARCH.2const: Split KEYCTL_SEARCH from keyctl(2)Alejandro Colomar2-79/+125
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_UNLINK.2const: Tweak after splitAlejandro Colomar1-30/+9
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_UNLINK.2const: Split KEYCTL_UNLINK from keyctl(2)Alejandro Colomar2-39/+88
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21KEYCTL_LINK.2const: Tweak after splitAlejandro Colomar1-38/+11
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-21keyctl.2, KEYCTL_LINK.2const: Split KEYCTL_LINK from keyctl(2)Alejandro Colomar2-68/+117
Signed-off-by: Alejandro Colomar <alx@kernel.org>