summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeLines
* 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>
* removexattr.2: srcfixAlejandro Colomar2023-04-08-3/+3
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* feature_test_macros.7: Document Clang fortify supportMingye Wang2023-04-05-7/+7
| | | | | | | | | | This commit lists both gcc and clang versions. It also happens to fix the "glibc 4.0" mistake in b324e17d3208c940622ab192609b836928d5aa8d. Fixes: b324e17d3208 ("Many pages: wfix") Signed-off-by: Mingye Wang <arthur200126@gmail.com> Acked-by: Sam James <sam@gentoo.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* man*/: srcfixAlejandro Colomar2023-04-05-4/+3
| | | | | Reported-by: mandoc(1) (`make lint-man-mandoc`) Signed-off-by: Alejandro Colomar <alx@kernel.org>
* cmd.mk, dist.mk: Keep file modes in the tarballAlejandro Colomar2023-04-03-2/+3
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Start of man-pages-NEXT: Move Changes to Changes.oldAlejandro Colomar2023-04-03-68/+108
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Changes: 6.04 documented also LANDLOCK_ACCESS_FS_TRUNCATEAlejandro Colomar2023-04-03-0/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* lsm: Released 6.04Alejandro Colomar2023-04-03-3/+3
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Changes: Ready for 6.04man-pages-6.04Alejandro Colomar2023-04-03-8/+67
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* difftime.3: Don't suggest redefining a reserved identifierAlejandro Colomar2023-04-03-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* getopt.3: Remove const from argvAlejandro Colomar2023-04-03-10/+12
| | | | | | | | | It is unnecessary to let readers believe it's const. Keep it as a detail in VERSIONS, which will only be found by those who need it. It is better to believe it's non-const, and rarely will one need to know that it isn't true. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* man2/: Remove repetitive documentation of [s]size_tAlejandro Colomar2023-04-03-14/+0
| | | | | | We already have an entire page for the types. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* man2/, sockaddr.3type: Move text to sockaddr.3typeAlejandro Colomar2023-04-03-21/+5
| | | | | | | Move text about socklen_t to its own page, and remove repetitive references to read accept(2) (except from the type page itself). Signed-off-by: Alejandro Colomar <alx@kernel.org>
* epoll_ctl.2: ffixAlejandro Colomar2023-04-03-2/+2
| | | | | Reported-by: `make check-catman` Signed-off-by: Alejandro Colomar <alx@kernel.org>
* man*/: ffixAlejandro Colomar2023-04-03-51/+54
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* scripts/LinuxManBook/: Make the title consistent with the name of the projectAlejandro Colomar2023-04-02-2/+2
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk: Simplify build treeAlejandro Colomar2023-04-02-32/+16
| | | | | | | Reuse $_MANDIR (.tmp/man/) for most stuff we build (with the exception of `make dist`). Signed-off-by: Alejandro Colomar <alx@kernel.org>
* verbose.mk: Fix warning from GNU Make 4.4Alejandro Colomar2023-04-02-3/+1
| | | | | | | | | | | | | | While '$(V).SILENT:' is a common idiom in make, it may be more explicit to put '.SILENT:' inside a conditional. Since we already used the conditional for something else, it's not a big change. As a nice side effect, vim now recognizes it and highlights it as a special target. With the old code, GNU Make 4.4 reported a warning about undefined variables: lib/verbose.mk:18: warning: undefined variable 'V' Signed-off-by: Alejandro Colomar <alx@kernel.org>
* landlock.7: Fix warningsAlejandro Colomar2023-04-02-1/+2
| | | | | Reported-by: `make lint check` Signed-off-by: Alejandro Colomar <alx@kernel.org>
* lint-man.mk: Fix previous commitAlejandro Colomar2023-04-02-71/+3
| | | | | | | | | I should have removed this in the previous commit, but somehow I forgot, and my initial tests didn't reveal the bug. After trying to check a specific page as a contributor would do, I noticed the problem. Fixes: aa344d4ba28c ("*.mk, CONTRIBUTING, INSTALL: lint, build, check: Reorganize some targets") Signed-off-by: Alejandro Colomar <alx@kernel.org>
* *.mk, CONTRIBUTING, INSTALL: lint, build, check: Reorganize some targetsAlejandro Colomar2023-04-02-87/+234
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Some targets which were under lint-* were really building cat pages, so let's call it build-catman, since it's what it is. As part of the build, it will report warnings, of course, as any other build system, so nothing really changed, except for the target names, and the path in the build tree where the cat pages (and intermediate files) are placed, which is now directly under <.tmp/man/*>. Some other targets were checking that the cat pages were correct after the build, so those targets have been moved to check-* targets. Document that contributors should run both the 'lint' and 'check' targets to check the correctness of their patches. `make all`, a.k.a. `make build`, now builds _all_ that can be built, including cat pages, and C programs. Implementation detail: $LINTMAN has been renamed, since now it's used also for things that are not linters. Call it $NONSO_MAN, since it's a list of the non-'.so' man pages, which are the ones we want to lint, build, and check. Future directions: I plan to implement 'build-html' using groff(1), which will reuse part of the build-catman pipeline. That will produce much higher quality HTML manual pages. Cc: G. Branden Robinson <g.branden.robinson@gmail.com> Cc: Elliott Hughes <enh@google.com> Cc: Oskari Pirhonen <xxc3ncoredxx@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc.5: NAME: Add "system information, and sysctl"наб2023-04-02-1/+1
| | | | | | | | | | procfs hosts a whole host of information about the system, as well as sysctls; proc(5) hosts a description of a lot of sysctls, and at present there's no way to find that out. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Cc: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* user_namespaces.7: Add note about PR_SET_DUMPABLE on nested usernsRodrigo Campos2023-04-01-0/+17
| | | | | | | | | | | | In order to create a nested user namespace, we need to re-set the PR_SET_DUMPABLE attribute after switching the effective UID/GID. Clarify this in the section about nested user namespaces. Having this note would have saved me some time debugging. Signed-off-by: Rodrigo Campos <rodrigo@sdfg.com.ar> Cc: Christian Brauner <brauner@kernel.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-01 12:10:38 +0000