summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeLines
* man3/: Add pagesunitAlejandro Colomar2024-03-20-6/+1630
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* unitd.8: Add pageAlejandro Colomar2024-03-20-0/+78
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* man*/: Remove all pagesAlejandro Colomar2024-03-20-290533/+0
| | | | | | | | | | | | This commit will start a new branch with no pages at all. It's intended to be useful for other projects that want to test their pages, so that they just need to check out this branch and copy the files into man*/. Then, all the existing targets in the Makefile would be available to be run on those pages. Since we support mdoc(7), and even pages with ':' in their file names since recently, I expect this to be universally usable. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Changes: Ready for 6.7man-pages-6.7Alejandro Colomar2024-03-19-9/+19
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* Changes: git(1) already shows contributorsAlejandro Colomar2024-03-19-12/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* GNUmakefile, INSTALL, RELEASE: Expand 'make help' to document dependenciesAlejandro Colomar2024-03-19-34/+18
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* GNUmakefile: help: Add a simple helpAlejandro Colomar2024-03-19-0/+16
| | | | | | | It documents how to actually get the targets and variables with a pipeline. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* GNUmakefile: Use a more portable $SHELLAlejandro Colomar2024-03-19-2/+3
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* GNUmakefile: Remove helpAlejandro Colomar2024-03-19-182/+0
| | | | | | | | | | | | | | | | | It gets out of date easily, and it's always more accurate to actually read the makefiles, or run a command that parses them for us. In the case of .PHONY targets, or available variables, here are two commands that can help: $ make nothing -p \ | grep '^\.PHONY:' \ | tr ' ' '\n' \ | grep -v '^\.PHONY:' \ | sort; $ grep -rho '^[^[:space:]].*=' GNUmakefile share/mk/configure/; Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/lint, share/mk/: Move *.grep filesAlejandro Colomar2024-03-19-5/+5
| | | | | | They're part of the build system, so put them under <share/mk/>. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: Split long lineAlejandro Colomar2024-03-19-1/+7
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: Rename variablesAlejandro Colomar2024-03-19-12/+13
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: We don't use man2html(1) any moreAlejandro Colomar2024-03-19-15/+0
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: $htmlext: Remove unused variableAlejandro Colomar2024-03-19-4/+0
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: Print SED rather than CPAlejandro Colomar2024-03-19-1/+1
| | | | | | That's what we use. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: wsfixAlejandro Colomar2024-03-19-5/+5
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: sort(1) input to tar(1)Alejandro Colomar2024-03-18-0/+2
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: Consistency fixes in copyright linesAlejandro Colomar2024-03-18-36/+36
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: build-html: Skip known errors (in groff-1.23.0)Alejandro Colomar2024-03-18-1/+4
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* LICENSES/: Add LGPL-3.0-or-later and LGPL-3.0-linking-exceptionAlejandro Colomar2024-03-18-0/+320
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: Update licenseAlejandro Colomar2024-03-18-51/+27
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/: Use grohtml(1) instead of man2html(1)Alejandro Colomar2024-03-18-40/+103
| | | | | | | | | | man2html(1) crashes on tzfile(5), and the upstream project is defunct. Link: <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1067022> Cc: Paul Eggert <eggert@cs.ucla.edu> Cc: "G. Branden Robinson" <branden@debian.org> Cc: Robert Luberda <robert@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc_pid_io.5: Move note to CAVEATSAlejandro Colomar2024-03-18-6/+5
| | | | | Cc: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* bpf.2: wfixJing Peng2024-03-18-1/+1
| | | | | Signed-off-by: Jing Peng <pj.hades@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* ip.7: Some socket options are not supported by SOCK_STREAMOliver Crumrine2024-03-17-0/+13
| | | | | | | | | | | | | | | | | It was not made clear in several socket options that they were not supported by SOCK_STREAM; this patch fixes that. Socket options not supported by SOCK_STREAM are handled in the ip_cmsg_recv_offset() function in <net/ipv4/ip_sockglue.c>. The function is called for udp sockets, and indirectly by ping and raw sockets, but not for STREAM sockets, as they don't support these options. Link: <https://lore.kernel.org/linux-man/ejhphmjh74ebtk4br3id66f27a4yoh4aukrcz7m6dp7acsu6zr@crtueyadqzmp/T/#mb298ac7f71a348d1e6b423cfa32bfad9c28efa40> Link: <https://lore.kernel.org/linux-man/ejhphmjh74ebtk4br3id66f27a4yoh4aukrcz7m6dp7acsu6zr@crtueyadqzmp/T/#u> Signed-off-by: Oliver Crumrine <ozlinuxc@gmail.com> Cc: Peter Seiderer <ps.report@gmx.net> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc_pid_io.5: Dewafflifyнаб2024-03-17-37/+31
| | | | | | | | | | | | | | | | | | | | | | | | | | | This page copies verbatim the contents of Documentation/filesystems/proc.rst, added wholesale in commit f9c99463b0cd05603d125c915e2886d55a686b82 ("[PATCH] Documentation for io-accounting / reporting via procfs") in 2007. As such, it mirrors the sensibilities of the time ‒ writing "successful read returns" as "data pulled from storage. actually just the data the process gave to read(). this also means from non-regular files! whether the data was pulled from storage doesn't matter actually (obligatory cache mention)" for the modern reader this is just a lot of waffling (note also that processes give no data to read()!) ‒ and sensibilities of the sheepish implementer in kernel documentation ‒ "an attempt" for a well-defined kernel behaviour, mentioning the "current implementation", consistent mentions of specific kernel-internal caching mechanisms, "the big inaccuracy here". Re-write to be more useful and less misleading as documentation; the syscall enumeration is accurate for kernel v6.8, but the sysc? stats are also bumped by kernel_{read,write}(), which is sometimes used by too many syscalls in too many scenarios to usefully enumerate. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc_pid_io.5: Stats include childrenнаб2024-03-17-9/+18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This file is like getrusage(2) RUSAGE_SELF + RUSAGE_CHILDREN, the current wording implies it's like just RUSAGE_SELF. Compare: #include <fcntl.h> #include <signal.h> #include <string.h> #include <sys/wait.h> #include <unistd.h> void copy() { char buf[1024]; int fd = open("/proc/self/io", 0); write(1, buf, read(fd, buf, sizeof(buf))); close(fd); } int main() { copy(); copy(); if (!fork()) { zero:; int fd = open("/dev/zero", 0); char buf[64 * 1024] = {}; write(1, buf, 10000); for (int i = 0; i < 1000; ++i) read(fd, buf, sizeof(buf)); _exit(0); } sleep(1); copy(); wait(NULL); copy(); signal(SIGCHLD, SIG_IGN); if (!fork()) goto zero; sleep(1); copy(); wait(NULL); copy(); } yielding rchar: 3980 wchar: 0 syscr: 9 syscw: 0 read_bytes: 2968 write_bytes: 0 cancelled_write_bytes: 0 rchar: 4076 wchar: 96 syscr: 10 syscw: 1 read_bytes: 2968 write_bytes: 96 cancelled_write_bytes: 0 rchar: 4175 wchar: 195 syscr: 11 syscw: 2 read_bytes: 2968 write_bytes: 195 cancelled_write_bytes: 0 rchar: 65540276 wchar: 10296 syscr: 1012 syscw: 4 read_bytes: 2968 write_bytes: 10296 cancelled_write_bytes: 0 rchar: 65540387 wchar: 10407 syscr: 1013 syscw: 5 read_bytes: 2968 write_bytes: 10407 cancelled_write_bytes: 0 rchar: 65540498 wchar: 10518 syscr: 1014 syscw: 6 read_bytes: 2968 write_bytes: 10518 cancelled_write_bytes: 0 Just s/process/& and its waited-for children/ but re-broken per review. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* tzfile.5: ffixAlejandro Colomar2024-03-17-2/+2
| | | | | | Cc: "G. Branden Robinson" <branden@debian.org> Cc: Paul Eggert <eggert@cs.ucla.edu> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* tzfile.5: Avoid crashing man2html(1)Alejandro Colomar2024-03-17-14/+14
| | | | | | | | Link: <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1067022> Cc: Paul Eggert <eggert@cs.ucla.edu> Cc: "G. Branden Robinson" <branden@debian.org> Cc: Robert Luberda <robert@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* tzfile.5, tzselect.8, zdump.8, zic.8: Refresh pagesAlejandro Colomar2024-03-16-151/+153
| | | | | | Refreshed from tzdb-2024a. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* bpf-helpers.7: Refresh pageAlejandro Colomar2024-03-16-63/+106
| | | | | | | | Scripted change: $ ~/src/linux/linux/6.8/scripts/bpf_doc.py | rst2man > man7/bpf-helpers.7 Signed-off-by: Alejandro Colomar <alx@kernel.org>
* getgrouplist.3: Use same type in both sides of comparisonAlejandro Colomar2024-03-16-5/+5
| | | | | | This removes a warning. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* unix.7: EXAMPLES: server.c: End connection with ENDLili Püspök2024-03-16-1/+5
| | | | | | | | | | | | | | Client wants to send END while server already closed the connection on DOWN, so connection is broken instead of the Result = 0 in the sample on sending a single DOWN. Now, the server disconnects only on first END. After DOWN, all further processing of number stops. Patch does not handle cases of double END sending, multiple clients etc. Fixes: 15545eb6d7ae ("unix.7: Add example") Cc: Heinrich Schuchardt <xypron.glpk@gmx.de> Signed-off-by: Lili Püspök <poordirtylili@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* printf.3: Return the number of bytes printed, not charactersJeremy Baxter2024-03-16-1/+1
| | | | | | | | | | | | From <https://pubs.opengroup.org/onlinepubs/9699919799/functions/printf.html>: Upon successful completion, the dprintf(), fprintf(), and printf() functions shall return the number of bytes transmitted. Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=218600> Reported-by: <quirin.blaeser@freenet.de> Signed-off-by: Jeremy Baxter <jtbx@disroot.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* utf-8.7: ffixAlejandro Colomar2024-03-14-15/+8
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* utf-8.7: ffixSamanta Navarro2024-03-14-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* printf.h.3head: tfixSamanta Navarro2024-03-14-1/+1
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* getrusage.2, proc_pid_io.5: Crosslinkнаб2024-03-14-1/+3
| | | | | | | These serve the same purpose from different perspectives. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* getrusage.2: proc(5) /proc/pid/stat -> proc_pid_stat(5)наб2024-03-14-6/+2
| | | | | | Fixes: bbc21bc4dbef ("proc.5, proc_pid_stat.5: Split /proc/PID/stat from proc(5)") Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc_pid_io.5: Mention atomicity in atomicity noteнаб2024-03-14-5/+4
| | | | | | | | | And drop "current implementation" (wording still literal from Documentation/filesystems/proc.rst). Of course this describes the current implementation. Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* proc_pid_io.5: wfixнаб2024-03-14-4/+4
| | | | | Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* scripts/LinuxManBook/build.sh, share/mk/: Use command variablesAlejandro Colomar2024-03-14-10/+37
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* logb.3: floor(log2(fabs(x))) has rounding errorsAlejandro Colomar2024-03-12-2/+3
| | | | | | | | | Link: <https://inbox.sourceware.org/libc-alpha/20240305150131.GD3653@qaa.vinc17.org/T/#m3ceecda630012995339bcc5448fee451cf277a8b> Reported-by: Vincent Lefevre <vincent@vinc17.net> Suggested-by: Vincent Lefevre <vincent@vinc17.net> Cc: Morten Welinder <mwelinder@gmail.com> Cc: Adhemerval Zanella Netto <adhemerval.zanella@linaro.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* scripts/LinuxManBook/prepare.pl: Support some autogenerated pages from other ↵Deri2024-03-12-12/+14
| | | | | | | | | projects And remove a warning about an experimental perl feature, by using a while instead of a for loop. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* TIMESPEC_TO_TIMEVAL.3, TIMEVAL_TO_TIMESPEC.3: Document these macrosAlejandro Colomar2024-03-12-0/+33
| | | | | | Reported-by: Guillem Jover <guillem@hadrons.org> Reviewed-by: Oskari Pirhonen <xxc3ncoredxx@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* share/mk/configure/build-depends/cc.mk: Use -Wno-unsafe-buffer-usage with ↵Alejandro Colomar2024-03-12-1/+3
| | | | | | | | clang(1) That warning has false positives, such as in unix(7). Signed-off-by: Alejandro Colomar <alx@kernel.org>
* unix.7: Use a 'ssize_t' for the return value of read(2) and write(2)Alejandro Colomar2024-03-12-21/+23
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
* unix.7: Use 'int' to iterate over 'argv'Alejandro Colomar2024-03-12-1/+1
| | | | | | | 'argc' is an 'int', so we should compare it with a variable of the same type. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* unix.7: Use int main(void)Alejandro Colomar2024-03-12-1/+1
| | | | | | The arguments were unused. Signed-off-by: Alejandro Colomar <alx@kernel.org>
* unix.7: Remove spurious #includeAlejandro Colomar2024-03-12-1/+2
| | | | Signed-off-by: Alejandro Colomar <alx@kernel.org>
generated by cgit v1.2.3 (git 2.39.1) at 2024-05-17 11:04:48 +0000