summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeLines
...
* landlock.7: Use LANDLOCK_* constants for compatibility tableGünther Noack2023-04-19-3/+3
| | | | | | | Link: <https://lore.kernel.org/linux-man/5d90e3b0-1577-7efd-03b8-f94b6e50fbc1@digikod.net/> Cc: Mickaël Salaün <mic@digikod.net> Signed-off-by: Günther Noack <gnoack3000@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* landlock.7: Check syscall result with == -1 instead of <= 0Günther Noack2023-04-19-1/+1
| | | | | | | Link: <https://lore.kernel.org/linux-man/5d90e3b0-1577-7efd-03b8-f94b6e50fbc1@digikod.net/> Reported-by: Mickaël Salaün <mic@digikod.net> Signed-off-by: Günther Noack <gnoack3000@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* man*/: ffixGuillem Jover2023-04-18-5/+5
| | | | | | | Escape dashes on UUIDs, URLs, and file and package names. Signed-off-by: Guillem Jover <guillem@hadrons.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* landlock.7: Explain the best-effort fallback mechanism in the exampleGünther Noack2023-04-17-4/+69
| | | | | Signed-off-by: Günther Noack <gnoack3000@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* INSTALL: Fix references to lib/ -> share/mk/Alejandro Colomar2023-04-17-5/+5
| | | | | Fixes: edaa12e6b ("*.mk: Move makefiles from lib/ to share/mk/") Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc.5: tfixGuillem Jover2023-04-17-1/+1
| | | | | | | | Use Ctrl-Alt-Del instead of ctrl-alt-del, as used in all other instances. Signed-off-by: Guillem Jover <guillem@hadrons.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc.5: Document that /proc/PID/oom_adj is no longer presentGuillem Jover2023-04-17-1/+2
| | | | | | | See kernel commit 01dc52ebdf472f77cca623ca693ca24cfc0f1bbe. Signed-off-by: Guillem Jover <guillem@hadrons.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc.5: A process can increase its own /proc/PID/oom_adj settingGuillem Jover2023-04-17-1/+4
| | | | | | | See kernel commit 8fb4fc68ca391862b061b3d358a288ccf6abed39. Signed-off-by: Guillem Jover <guillem@hadrons.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc.5: Document exact /proc/PID/exe behavior on unlinked pathnamesGuillem Jover2023-04-17-1/+1
| | | | | | | Add the space which gets appended before the "(deleted)" marker. Signed-off-by: Guillem Jover <guillem@hadrons.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* ip.7: ffixAlejandro Colomar2023-04-14-6/+6
| | | | | | Fixes: 51f5698d3ce9 "...: ffix: replace .sp by .PP" Fixes: 6545cc56e02e "...: ffix" Signed-off-by: Alejandro Colomar <alx@kernel.org>
* ip.7: Add "Special and reserved addresses" sectionSeth David Schoen2023-04-14-8/+72
| | | | | | | | | | | | | | | Break out the discussion of special and reserved IPv4 addresses into a subsection, formatted as a pair of definition lists, and briefly describing three cases in which Linux no longer treats addresses specially, where other systems do or did. Also add a specific example to the NOTES paragraph that discourages the use of IP broadcasting, so people can more easily understand what they are supposed to do instead. Suggested-by: John Gilmore <gnu@toad.com> Signed-off-by: Seth David Schoen <schoen@loyalty.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk, INSTALL: build-src-c: Optimize pipelineAlejandro Colomar2023-04-14-5/+3
| | | | | | | | | Calling man(1) is slow. Since we only need to format the page, calling mandoc(1) is faster and simpler (we could also use groff(1), but mandoc(1) is probably faster and simpler than groff(1) too). This brings times down ~3x in my system. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* src.mk: Optimize pipelineAlejandro Colomar2023-04-14-5/+3
| | | | | | | | | | This pipeline is run for every make(1) invokation, and it was very slow, due to running a new sed(1) process for every manual page. Remove the while loop, and rewrite so that all the commands in the pipeline are only run once. This brings times down ~10x in my system, from 1.5 s, to just 0.14 s. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* resolv.conf.5: Add option no-aaaaLukas Javorsky2023-04-14-0/+23
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: Move makefiles from lib/ to share/mk/Alejandro Colomar2023-04-14-59/+62
| | | | | | | | | According to the FHS, lib/ is for arch-dependent files, while share/ is for arch-independent files. While moving, create a more organized directory structure. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* build.mk: srcfixAlejandro Colomar2023-04-14-2/+2
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Makefile: help-variables: Make .PHONYAlejandro Colomar2023-04-14-0/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Makefile: tfixAlejandro Colomar2023-04-12-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: $Z: Support installing xz(1) compressed pagesAlejandro Colomar2023-04-12-2/+8
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: Add *FLAGS variables for compression commandsAlejandro Colomar2023-04-12-20/+52
| | | | | | | Also, document the LZIP variable. Fixes: 69ad95988f40 ("*.mk: dist, dist-lz: Create tarballs compressed with lzip(1)") Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: $Z: Support installing lzip(1) compressed pagesAlejandro Colomar2023-04-12-2/+8
| | | | | Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: dist, dist-lz: Create tarballs compressed with lzip(1)Alejandro Colomar2023-04-12-1/+8
| | | | | Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* dist.mk, version.mk: Create reproducible tarballsman-pages-6.05-a1Alejandro Colomar2023-04-11-2/+10
| | | | | | | | | Anyone can create a tarball from a release tag, and it should be identical to the release tarball, so that the PGP signature made at the release matches. This is useful for distributors. Suggested-by: Marcos Fouces <marcos@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* fts.3: SYNOPSIS: Fix nullabilityAlejandro Colomar2023-04-11-2/+2
| | | | | Reported-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* fts.3: Note fts_open() behaviour with empty stringsнаб2023-04-11-0/+11
| | | | | | | | | | | | This is undocumented in BSD, too, and present in the original SCCS check-in (5.1 (Berkeley) 12/30/89). This is very surprising, since in most other cases FTS is rather quite sane about error reporting, but /any/ empty string in the input vector blows out the creation entirely. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* dist.mk: dist: Don't pollute stderr unnecessarilyAlejandro Colomar2023-04-11-1/+1
| | | | | | | | | | When running 'make dist' from a tarball (so we don't have git), we'll see tons of errors saying we're not in a git tree. However, that's not meaningful, because that command is a no-op in such a scenario: the (date) placeholder is not there anymore to be replaced. Let's hide the errors, unless V=1. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* dist.mk: dist-bz2: Use a timestamp newer than the .tarAlejandro Colomar2023-04-11-0/+1
| | | | | | Otherwise, make(1) goes crazy. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* RELEASE, dist.mk: Use make(1)'s -B to force recreation of the dist filesAlejandro Colomar2023-04-11-12/+7
| | | | | | | | | | | | | | Using FORCE unnecessarily restarts the entire build, even if we _know_ nothing changed. That's boring. Trust ourselves, and write the commands in the RELEASE file as using '-B', to remind ourselves. Forgetting to use -B will result in incorrect timestamps or versioning in the distributed pages, so don't forget it ;). While we're at it, let's also use -j4 directly, so I don't read the paragraph reminding me to use -j _after_ I've already run it. Let's write -j4 instead of -j so that we don't crash some innocent's system. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* bpf-helpers.7: Refresh page (Linux 6.2)Alejandro Colomar2023-04-11-197/+243
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* scanf.3: srcfixAlejandro Colomar2023-04-11-1/+1
| | | | | | | | That extra whitespace cuased issues to the Debian packaging tool that autodetects the licenses from the SPDX header. Cc: Marcos Fouces <marcos@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* CONTRIBUTING: Remove old linksAlejandro Colomar2023-04-10-4/+0
| | | | | | I removed those pages from the website. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* README: Reorganize, and add some infoAlejandro Colomar2023-04-10-10/+21
| | | | | | | | | | | | | - Add "History" section, with a link to aeb's website with man-pages-1.* tarballs. - Move "Maintainers" to a subsection in the new "History" section. - Organize "Versions" into subsections ("Tarballs", "Git", and "Online pages"). - Add links to the cgit websites of the git repositories. - Add link to the PDF online man-pages book. - wsfix in mtk's entry. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* README: See also: Add 'Downstream packages', and 'Related projects'Alejandro Colomar2023-04-10-0/+28
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* CONTRIBUTING: Add Linux API mailing listAlejandro Colomar2023-04-10-0/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* erofs.5: Minor tweaks to наб's patchAlejandro Colomar2023-04-10-5/+9
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* filesystems.5, erofs.5: add erofs documentationнаб2023-04-10-1/+102
| | | | | | | | | | | | | | | | | | | | Modelled after tmpfs(5) ‒ there's a listing of mount options, and a summary of limitations. The feature flags are described in mkfs.erofs, and they're versioned and maintained upstream quite well there, so no need to duplicate those, since you only care on image creation. The real value add is the mount options, but I cannot figure out how device_id and fsid interact with the system at large, so I just noted they're there. State as of Linux 6.3-rc5. Also, remove explicit .TP indent in filesystems.5 since we're already touching this hunk: all entries sans iso9660 and Reiserfs fall within the default prevailing indent, so no need to specify a wide one. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* dist.mk: dist, dist-bz2: Create tarballs compressed with bzip2(1)Alejandro Colomar2023-04-09-1/+6
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Makefile: help-variables: Document $CP command variableAlejandro Colomar2023-04-09-0/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: $Z: Support installing bzip2 compressed pagesAlejandro Colomar2023-04-09-3/+11
| | | | | | Gentoo currently installs pages compressed with this format. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* install-man.mk: tfixAlejandro Colomar2023-04-09-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* install-man.mk: Fix symlink installationAlejandro Colomar2023-04-09-1/+2
| | | | | | | Some pages have not only an '.so ' line, but also comments; ignore the comments. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* ioctl_pipe.2: Add pageCyril Hrubis2023-04-08-0/+64
| | | | | | Cc: David Howells <dhowells@redhat.com> Signed-off-by: Cyril Hrubis <chrubis@suse.cz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* ioctl_userfaultfd.2: Add UFFD_FEATURE_EXACT_ADDRESSNadav Amit2023-04-08-0/+8
| | | | | | | Describe the new UFFD_FEATURE_EXACT_ADDRESS API feature. Signed-off-by: Nadav Amit <namit@vmware.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* personality.2: review, update for Linux 6.2наб2023-04-08-31/+72
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Settle on "no effect", concretify vaguely-described behaviours; both [to be documented]s replaced with documentation (these match my 6.2 checkout, if there were subtleties in the history they got lost). Added the full system names to the PER_s that lacked them. Didn't validate or chase down the versions except for PER_RISCOS. Having these be sorted instead of in the original enumeration order is really more trouble than it's worth. Cf. the UAPI definition: /* * Personality types. * * These go in the low byte. Avoid using the top bit, it will * conflict with error returns. */ enum { PER_LINUX = 0x0000, PER_LINUX_32BIT = 0x0000 | ADDR_LIMIT_32BIT, PER_LINUX_FDPIC = 0x0000 | FDPIC_FUNCPTRS, PER_SVR4 = 0x0001 | STICKY_TIMEOUTS | MMAP_PAGE_ZERO, PER_SVR3 = 0x0002 | STICKY_TIMEOUTS | SHORT_INODE, PER_SCOSVR3 = 0x0003 | STICKY_TIMEOUTS | WHOLE_SECONDS | SHORT_INODE, PER_OSR5 = 0x0003 | STICKY_TIMEOUTS | WHOLE_SECONDS, PER_WYSEV386 = 0x0004 | STICKY_TIMEOUTS | SHORT_INODE, PER_ISCR4 = 0x0005 | STICKY_TIMEOUTS, PER_BSD = 0x0006, PER_SUNOS = 0x0006 | STICKY_TIMEOUTS, PER_XENIX = 0x0007 | STICKY_TIMEOUTS | SHORT_INODE, PER_LINUX32 = 0x0008, PER_LINUX32_3GB = 0x0008 | ADDR_LIMIT_3GB, PER_IRIX32 = 0x0009 | STICKY_TIMEOUTS,/* IRIX5 32-bit */ PER_IRIXN32 = 0x000a | STICKY_TIMEOUTS,/* IRIX6 new 32-bit */ PER_IRIX64 = 0x000b | STICKY_TIMEOUTS,/* IRIX6 64-bit */ PER_RISCOS = 0x000c, PER_SOLARIS = 0x000d | STICKY_TIMEOUTS, PER_UW7 = 0x000e | STICKY_TIMEOUTS | MMAP_PAGE_ZERO, PER_OSF4 = 0x000f, /* OSF/1 v4 */ PER_HPUX = 0x0010, PER_MASK = 0x00ff, }; PER_LINUX is a base personality, PER_LINUX_{32BIT,FDPIC} are PER_LINUX|ADDR_LIMIT_32BIT and PER_LINUX|FDPIC_FUNCPTRS, resp. PER_BSD is a base personality, PER_SUNOS is PER_BSD|STICKY_TIMEOUTS. PER_LINUX32 is a base personality, PER_LINUX32_3GB is PER_LINUX32|ADDR_LIMIT_3GB. I updated these all to be "Same as {base personality}, but implies {...}.". PER_SCOSVR3 has an "also", since it's the only one where the base case PER_OSR5 has a list. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* rtnetlink.7: Document IFLA_PERM_ADDRESSLinus Heckemann2023-04-08-0/+3
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* stat.3type: tfixDaniel Verkamp2023-04-08-1/+1
| | | | | Signed-off-by: Daniel Verkamp <daniel@drv.nu> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* mlock.2: wfixAvinesh Kumar2023-04-08-3/+3
| | | | | Signed-off-by: Avinesh Kumar <akumar@suse.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc.5: note effective removal of /proc/execdomains in v4.1наб2023-04-08-1/+2
| | | | | | | | | | | The file was turned into a fixed string in upstream commit 973f911f55a0e510dd6db8bbb29cd82ff138d3c0 ("Remove execution domain support"); the entire mechanism was fully removed in a patchset by Weinberger ending at commit 720d70716d137c0cb83b9a5279c384286c02a1c0 ("sparc: Fix execution domain removal"). Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* malloc_usable_size.3: The returned value should not be trustedAlejandro Colomar2023-04-08-18/+15
| | | | | | | | | | | | | | | | | | | It might very well return a value larger than the actual usable size, so writing to the excess bytes is Undefined Behavior. There's absolutely no promise about the value, except that it is no less than the size that was once passed to malloc(3). Link: <https://github.com/systemd/systemd/issues/22801#issuecomment-1343041481> Link: <https://inbox.sourceware.org/libc-alpha/20221124213258.305192-1-siddhesh@gotplt.org/T/> Reported-by: Mingye Wang <arthur200126@gmail.com> Reported-by: Siddhesh Poyarekar <siddhesh@gotplt.org> Cc: DJ Delorie <dj@redhat.com> Cc: Sam James <sam@gentoo.org> Cc: Florian Weimer <fweimer@redhat.com> Cc: Andreas Schwab <schwab@linux-m68k.org> Cc: Zack Weinberg <zack@owlfolio.org> Cc: Wilco Dijkstra <Wilco.Dijkstra@arm.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* bash_aliases: Optimize man_section()Alejandro Colomar2023-04-08-1/+2
| | | | | | | | | | | | | | | | | | | mandoc(1) renders pages much faster than groff(1), which is itself much faster than using man(1). This might seem irrelevant for a single page, but this function is called in a loop in man_lsfunc() and man_lsvar(), where this brings times down considerably. For comparison, `time man_lsfunc man*` took around 55 s (on my system) before this change. With groff(1), it would take around 14 s, and with mandoc(1) (this patch), it takes 4 s. Cc: Ingo Schwarze <schwarze@openbsd.org> Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com> Cc: Gavin Smith <gavinsmith0123@gmail.com> Cc: Dirk Gouders <dirk@gouders.net> Cc: Colin Watson <cjwatson@debian.org> Cc: Eli Zaretskii <eliz@gnu.org> Cc: Larry McVoy <lm@mcvoy.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-01 11:08:18 +0000