aboutsummaryrefslogtreecommitdiffstats
path: root/man/man5
AgeCommit message (Collapse)AuthorFilesLines
6 daysman/man5/proc_sys_net.5: Add reference to proc_sys_net_ipv4(5)Alejandro Colomar1-0/+4
Signed-off-by: Alejandro Colomar <alx@kernel.org>
6 daysman/man5/proc_sys_net_ipv4.5: Tweak after splitAlejandro Colomar1-20/+20
Signed-off-by: Alejandro Colomar <alx@kernel.org>
7 daysman/man7/ip.7, man/man5/proc_sys_net_ipv4.5: Split /proc/sys/net/ipv4/ from ↵Alejandro Colomar1-0/+167
ip(7) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-10-05man/: ffixAlejandro Colomar2-11/+11
Remove spaces before a tab (except in a few cases). Reported-by: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-10-05man/man5/proc_pid_smaps.5: Remove useless column in tableAlejandro Colomar1-33/+33
It was forcing some entries to go past the right margin. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-09-25man/: ffix (escape dashes)Alejandro Colomar1-2/+2
Most of these have been reported by 'make lint-man-dash'. A couple of them were found manually. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-09-21man/: Use semantic newlinesAlejandro Colomar40-184/+287
And fix related issues while at it. Silence false positives with \&. Reported-by: `make lint-man-semnl` Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-09-14man/man5/locale.5: wfixAlejandro Colomar1-1/+2
Reported-by: Christoph Anton Mitterer <calestyo@scientia.org> Suggested-by: Christoph Anton Mitterer <calestyo@scientia.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-09-14man/man5/locale.5: tfixAlejandro Colomar1-1/+1
Fixes: 73cb5f18348c (2014-03-03; "locale.5: Document LC_ADDRESS") Link: <https://www.open-std.org/jtc1/sc22/wg20/docs/n972-14652ft.pdf> Link: <https://www.cept.org/cept/cept-country-codes> Reported-by: Christoph Anton Mitterer <calestyo@scientia.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-09-07man/: Address diagnostic about mismatched quotesAlejandro Colomar1-2/+1
Most of these are false positives, in the sense that a line break is escaped, and the matching quote is in the next source line. However, let's remove those escaped line breaks, which make reading the source more difficult. For this, rename some parameters to be shorter, and allow some lines to go slightly past the 80-column right margin. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-09-06man/: ffixAlejandro Colomar1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-08-29man/: wsfixAlejandro Colomar2-2/+2
These cases were found with a script: $ grep -rn -P '^[^. #][^:%#]*[a-z] *[a-z][^;=%:]*$' Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-08-24man/man5/proc_pid_map_files.5: Remove SELinux indicator in examplesAlejandro Colomar1-2/+2
I don't see that dot in my system. Let's remove it, as it might distract the reader. $ sudo ls -l /proc/self/map_files/ | head -n3 total 0 lr-------- 1 root root 64 Aug 23 15:51 555ad39d6000-555ad39da000 -> /usr/bin/ls lr-------- 1 root root 64 Aug 23 15:51 555ad39da000-555ad39f1000 -> /usr/bin/ls Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-06-28man/man5/elf.5: Clarify string table reference for SHT_SYMTAB sectionsDacian Pascu1-0/+4
Add clarification that for SHT_SYMTAB sections, the associated string table section index can be found in the sh_link member, following the same pattern documented for section header string tables. This was discovered while writing an ELF parser, where the sh_link field is needed to locate the string table for symbol name lookups in SHT_SYMTAB sections. Signed-off-by: Dacian Pascu <pascu.dacian@gmail.com> Message-ID: <78e41dade449bafddfb730b39226f8d9cb3fefdb.1750427945.git.pascu.dacian@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-06-19man/man5/core.5: Document the new %F identifier in core_patternJelle van der Waa1-0/+5
Signed-off-by: Jelle van der Waa <jvanderw@redhat.com> Message-ID: <20250616133212.131064-1-jvanderwaa@redhat.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-31man/: Fix name of /proc/sys/vm/hugetlb_shm_groupAhelenia Ziemiańska1-1/+1
sysctl_hugetlb_shm_group is the name of the variable in "mm/hugetlb.c". Fixes: 090fdddb4342 (2021-05-17; "memfd_create.2, mmap.2, shmget.2: Document the EPERM for huge page allocations") Fixes: 6cee0ddeb414 (2021-05-17; "proc.5: Document /proc/sys/vm/sysctl_hugetlb_shm_group") Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Message-ID: <22436441b7bac0177213c99c55187c4af085d4ca.1748714599.git.nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-24man/man5/proc_meminfo.5: Shmem also accounts for other types of shared memoryAlejandro Colomar1-1/+5
Reported-by: Carsten Grohmann <carstengrohmann@gmx.de> Message-ID: <20250523122617.48cf9feb@max.localdomain> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-17*: grfixAlejandro Colomar143-143/+143
Scripted change: $ grep -rl 'The authors of the Linux man-pages' \ | xargs sed -i '/Copyright, The authors of the Linux man-pages project/s/The/the/'; Reported-by: Josh Triplett <josh@joshtriplett.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-10*, AUTHORS: Consistently refer to authorsAlejandro Colomar143-143/+143
- Rename the file CREDITS => AUTHORS - Say 'authors' in the copyright notice. Scripted change: $ grep -rn 'The contributors to the Linux man-pages' -l \ | xargs sed -i '/Copyright, The contributors to the Linux man-pages project/s/contributors to/authors of/' Suggested-by: Dave Martin <Dave.Martin@arm.com> Acked-by: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-07man/: Refresh pages from tzdb-2025bAlejandro Colomar1-59/+71
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-06*, CREDITS: Unify copyright noticesAlejandro Colomar143-381/+145
Link: <https://lore.kernel.org/linux-man/jpin2dbnp5vpitnh7l4qmvkamzq3h3xljzsznrudgioox3nn72@57uybxbe3h4p/T/#u> Link: <https://www.linuxfoundation.org/blog/blog/copyright-notices-in-open-source-software-projects> Cc: "G. Branden Robinson" <branden@debian.org> Cc: Carlos O'Donell <carlos@redhat.com> Cc: Eugene Syromyatnikov <evgsyr@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-05-06man/, CREDITS: Move in-source contribution records to CREDITSAlejandro Colomar23-83/+2
This information is better placed in the git logs, not in the source code itself. For people interested in the old history of pages, before we used git, they will probably look at old versions of these pages, like for example man-pages-1.70, or the 'prehistory' branch, and there they'll find these notes. Keep the names and emails of contributors in a new CREDITS file. Link: <https://lore.kernel.org/linux-man/jpin2dbnp5vpitnh7l4qmvkamzq3h3xljzsznrudgioox3nn72@57uybxbe3h4p/T/#u> Link: <https://www.linuxfoundation.org/blog/blog/copyright-notices-in-open-source-software-projects> Cc: "G. Branden Robinson" <branden@debian.org> Cc: Carlos O'Donell <carlos@redhat.com> Cc: Eugene Syromyatnikov <evgsyr@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-03-30man/: srcfix (\fX => \f[X])Alejandro Colomar32-270/+485
While doing this global change, fix other minor issues found nearby. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-02-02man/man5/proc_pid_limits.5: tfixAlejandro Colomar1-1/+1
Reported-by: "Tomerius, Kai" <Kai.Tomerius@elektrobit.com> Fixes: 07c3768e9db8 (2023-08-15; "proc.5, proc_pid_limits.5: Split /proc/PID/limits from proc(5)") 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-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-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-06-28proc_sysrq-trigger.5: ffixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-28man/: ffix (Use TQ where appropriate)Alejandro Colomar2-5/+15
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-16man/, share/mk/: srcfix, and remove corresponding XFAIL exceptionsAlejandro Colomar1-1/+2
And remove them from XFAIL, since they don't fail anymore. Reported-by: mandoc(1) (`make lint-man-mandoc`) Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-15man/: srcfix: Use \[rs] instead of \eAlejandro Colomar15-48/+48
Scripted change: $ find man -type f \ | xargs grep -l '\\e' \ | xargs sed -i 's/\\e/\\[rs]/g'; Link: <https://lore.kernel.org/linux-man/20240611122453.qn6jyl4go4bvwkqm@illithid/> Suggested-by: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-05-26proc.5: Make literals boldMatteo Croce1-3/+3
Format the equal signs in the procfs mount options in bold to make it clear that they are literal values. Signed-off-by: Matteo Croce <teknoraver@meta.com> Message-ID: <20240520105956.71532-1-technoboy85@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-05-19proc.5: ffixAlejandro Colomar1-1/+0
Fixes: dd465607bc58 ("proc.5: Document 'subset' mount option.") Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-05-17proc.5: Document 'subset' mount option.Matteo Croce1-1/+7
The 'subset=pid' option was added in commit 6814ef2d, document it. This option mounts a procfs where only the numeric directories related to the PIDs are present. # mount -t proc proc_pid pid -o subset=pid # mount |grep -w proc_pid proc_pid on /tmp/proc/pid type proc (rw,relatime,subset=pid) # ll -d pid/{1,$$,cmdline,version} ls: cannot access 'pid/cmdline': No such file or directory ls: cannot access 'pid/version': No such file or directory dr-xr-xr-x. 9 root root 0 May 14 09:43 pid/1 dr-xr-xr-x. 9 root root 0 May 14 09:43 pid/25146 The only non-numeric entries in that procfs instance are 'self' and 'thread-self': # ls pid |grep -vx '[[:digit:]]*' self thread-self # Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Matteo Croce <teknoraver@meta.com> Message-ID: <20240514202819.95347-1-technoboy85@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-05-08elf.5, ld.so.8: Undeprecate DT_RPATH; explain DT_RPATH vs DT_RUNPATHJoachim Wuttke1-2/+2
In elf.5 and ld.so.8, remove deprecation of DT_RPATH In elf.5, amend the description of DT_RUNPATH and DT_RPATH. Rationale: There is no credible path towards removal of DT_RPATH. Lots of software depend on DT_RPATH as is. It is used e.g. for testing and in binary installers. Cc: Joseph Myers <josmyers@redhat.com> Cc: Mike Frysinger <vapier@gentoo.org> Cc: <bug-binutils@gnu.org> Signed-off-by: Joachim Wuttke <j.wuttke@fz-juelich.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-05-02man/, share/mk/: Move man*/ to man/Alejandro Colomar158-0/+18440
This is a scripted change: $ mkdir man/; $ mv man* man/; $ ln -st . man/man*; $ find share/mk/ -type f \ | xargs grep -l '^MANDIR *:=' \ | xargs sed -i '/^MANDIR *:=/s,$,/man,'; $ find share/mk/dist/ -type f \ | xargs grep -l man \ | xargs sed -i 's,man%,man/%,g'; Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/> Cc: Petr Vorel <pvorel@suse.cz> Cc: Jakub Wilk <jwilk@jwilk.net> Cc: Stefan Puiu <stefan.puiu@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2022-09-09Revert "src.mk, All pages: Move man* to man/"Alejandro Colomar42-16811/+0
This reverts commit 70ac1c4785fc1e158ab2349a962dba2526bf4fbc. Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/> Reported-by: Petr Vorel <pvorel@suse.cz> Reported-by: Jakub Wilk <jwilk@jwilk.net> Cc: Stefan Puiu <stefan.puiu@gmail.com> Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
2022-09-05src.mk, All pages: Move man* to man/Alejandro Colomar42-0/+16811
The root of the repository is becoming a bit overpopulated and unorganized, due to the recent addition of more mandirs, and more informative and configuration files too. Let's create a specific mandir <man/> that contains the mandirs <man[1-8]*>. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>