]>
git.ipfire.org Git - thirdparty/man-pages.git/log
Alejandro Colomar [Mon, 8 Apr 2024 17:15:35 +0000 (19:15 +0200)]
share/mk/: $TROFFFLAGS: Use a larger font size
Link: <https://journals.uc.edu/index.php/vl/article/view/5765>
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Suggested-by: "G. Branden Robinson" <branden@debian.org>
Cc: "Thomas E. Dickey" dickey@his.com
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Michael Weiß [Wed, 3 Apr 2024 11:42:23 +0000 (13:42 +0200)]
init_module.2: Document MODULE_INIT_COMPRESS_FILE flag
finit_module() supports the MODULE_INIT_COMPRESS_FILE flag since
Linux 5.17. See commit
b1ae6dc41eaaa ("module: add in-kernel support
for decompressing")
During implementation of a secure module loader in GyroidOS, we
wanted to filter unsafe module parameters. To verify that only the
two documented flags which are disabling sanity checks are unsafe,
we had a look in the current kernel implementation.
We discovered that this new flag MODULE_INIT_COMPRESS_FILE was added.
Having a deeper look at the code, we also discovered that a new error
code EOPNOTSUPP is possible within newer kernels.
The inital commit only supported gzip and xz compression algorithms.
Support for zstd was added in Linux 6.2 by commit
169a58ad824d8
("module/decompress: Support zstd in-kernel decompression")
Signed-off-by: Michael Weiß <michael.weiss@aisec.fraunhofer.de>
Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Cc: Stephen Boyd <swboyd@chromium.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
наб [Wed, 3 Apr 2024 15:06:45 +0000 (17:06 +0200)]
sigwait.3: Note sigprocmask(2) requirement, explicitly link sigtimedwait(2)/NOTES
This comes from a real user complaint. sigwait(3) is the most obvious
of the family, and it doesn't mention any of the usage details.
Most of these can be crosslinked, but not mentioning the sigprocmask(2)
requirement is malice.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Elliott Hughes [Sat, 30 Mar 2024 00:10:26 +0000 (17:10 -0700)]
getpagesize.2, syscalls.2: Modernization
Remove the HP-UX portability advice, since getpagesize() is a slightly
better option than sysconf() for Linux systems.
Explain why this function exists, and why this man page is in the wrong
section. (The previous text tried to do both at the same, which was
confusing.) Also explain how the vast majority of architectures that
don't have a syscall (but do support multiple page sizes) actually work.
Also de-emphasize the glibc 2.0 bug, since most people don't need to
worry about compatibility with versions of glibc from 1997.
Finally, change "not on x86" in syscalls.2 to say where there _is_ a
syscall.
Co-developed-by: Elliott Hughes <enh@google.com>
Co-developed-by: Alejandro Colomar <alx@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Fedor Lapshin [Fri, 29 Mar 2024 00:21:11 +0000 (03:21 +0300)]
getgrouplist.3: EXAMPLES: Fix error handling for getpwnam(3)
Signed-off-by: Fedor Lapshin <fe.lap.prog@gmail.com>
Co-developed-by: Alejandro Colomar <alx@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 29 Mar 2024 17:36:40 +0000 (18:36 +0100)]
share/mk/: Useful Use of Cat
Simplify a pipeline, by using cat(1) to actually catenate stuff.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Mar 2024 12:59:17 +0000 (13:59 +0100)]
share/mk/: Reorganize files for generating the PDF book
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Mar 2024 12:10:34 +0000 (13:10 +0100)]
share/mk/: Generate the fonts during the build
Suggested-by: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 01:00:26 +0000 (02:00 +0100)]
etc/clang-tidy/config.yaml: -llvm-header-guard
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 00:46:05 +0000 (01:46 +0100)]
etc/cpplint/cpplint.cfg: -build/header_guard
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 01:00:03 +0000 (02:00 +0100)]
share/mk/: $CFLAGS: -Wno-reserved-identifier, -Wno-unused-macros
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 00:37:51 +0000 (01:37 +0100)]
share/mk/: lint-c-iwyu: Add exceptions
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 01:06:08 +0000 (02:06 +0100)]
shmop.2: EXAMPLES: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 00:46:38 +0000 (01:46 +0100)]
man*/: EXAMPLES: Add include guards
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 00:35:11 +0000 (01:35 +0100)]
man*/: EXAMPLES: Fix includes
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 26 Mar 2024 00:58:34 +0000 (01:58 +0100)]
share/mk/: lint-c: Lint headers from EXAMPLES
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 25 Mar 2024 11:54:36 +0000 (12:54 +0100)]
share/mk/: Sync with liba2i's build system
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 24 Mar 2024 12:10:37 +0000 (13:10 +0100)]
share/mk/: build-pdf*, install-pdf*: Rename targets for consistency
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 24 Mar 2024 11:55:15 +0000 (12:55 +0100)]
share/mk/, scripts/LinuxManBook/build.sh: Embed script in the makefiles
This is done for simplifying, and as a side effect, it also allows
much more control on the script (e.g., TROFFFLAGS).
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 24 Mar 2024 11:39:46 +0000 (12:39 +0100)]
share/mk/: [un]install-pdf: Add target to install the PDF book
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 24 Mar 2024 04:32:17 +0000 (05:32 +0100)]
share/mk/: $EXTRAVERSION: Add variable to append to the version
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 24 Mar 2024 04:30:52 +0000 (05:30 +0100)]
share/mk/: Derive $DISTNAME from $DISTVERSION
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 23 Mar 2024 22:48:30 +0000 (23:48 +0100)]
share/mk/: Reorganize build system
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 22 Mar 2024 23:59:17 +0000 (00:59 +0100)]
share/mk/: dist: Don't stamp the version on the manual pages
This will allow downstream packages to set their own version, just by
setting $DISTVERSION.
It will be stamped at `make install` time.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 22 Mar 2024 23:56:47 +0000 (00:56 +0100)]
share/mk/: $MANPAGEDATECMD: Use a variable for setting the date of manual pages
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 22 Mar 2024 23:44:50 +0000 (00:44 +0100)]
share/mk/: build-*: Specify manual pages' version and date
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 22 Mar 2024 23:20:05 +0000 (00:20 +0100)]
share/mk/: Fix includes
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 22 Mar 2024 22:49:39 +0000 (23:49 +0100)]
share/mk/: build-man: Split rule
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 22 Mar 2024 20:55:08 +0000 (21:55 +0100)]
share/mk/: Use more robust regex
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 20 Mar 2024 14:56:21 +0000 (15:56 +0100)]
share/mk/: build-book, build-man, install-man: Specify version and date
Each page has its own date.
Add new 'build-man' target, which stamps the date and version in the
pages (in $builddir, not the source ones).
Build-system internal stuff:
$CURDIR will be used for the build system, while $srcdir will be
used for the project root of the repository. This helps use
this build system in other projects.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 20 Mar 2024 21:05:08 +0000 (22:05 +0100)]
scripts/LinuxManBook/prepare.pl: Use more robust pipelines
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 20 Mar 2024 14:13:16 +0000 (15:13 +0100)]
GNUmakefile: help: wfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 22:09:25 +0000 (23:09 +0100)]
share/mk/: Reorganize dependencies
Use one directory per each (Debian) package, and one file per command.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 19:47:15 +0000 (20:47 +0100)]
GNUmakefile: help: Hide variables not meant for users
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 18:21:39 +0000 (19:21 +0100)]
Start of man-pages-NEXT: Move Changes to Changes.old
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 18:19:43 +0000 (19:19 +0100)]
lsm: Released 6.7
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 18:01:04 +0000 (19:01 +0100)]
Changes: Ready for 6.7
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 17:42:07 +0000 (18:42 +0100)]
Changes: git(1) already shows contributors
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 17:29:58 +0000 (18:29 +0100)]
GNUmakefile, INSTALL, RELEASE: Expand 'make help' to document dependencies
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 17:14:33 +0000 (18:14 +0100)]
GNUmakefile: help: Add a simple help
It documents how to actually get the targets and variables with a
pipeline.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 17:13:45 +0000 (18:13 +0100)]
GNUmakefile: Use a more portable $SHELL
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 16:54:52 +0000 (17:54 +0100)]
GNUmakefile: Remove help
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>
Alejandro Colomar [Tue, 19 Mar 2024 16:23:01 +0000 (17:23 +0100)]
share/lint, share/mk/: Move *.grep files
They're part of the build system, so put them under <share/mk/>.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 12:48:41 +0000 (13:48 +0100)]
share/mk/: Split long line
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 12:30:30 +0000 (13:30 +0100)]
share/mk/: Rename variables
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 01:25:42 +0000 (02:25 +0100)]
share/mk/: We don't use man2html(1) any more
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 19 Mar 2024 00:17:21 +0000 (01:17 +0100)]
share/mk/: $htmlext: Remove unused variable
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 23:56:27 +0000 (00:56 +0100)]
share/mk/: Print SED rather than CP
That's what we use.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 23:54:15 +0000 (00:54 +0100)]
share/mk/: wsfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 16:20:26 +0000 (17:20 +0100)]
share/mk/: sort(1) input to tar(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 15:50:28 +0000 (16:50 +0100)]
share/mk/: Consistency fixes in copyright lines
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 15:27:49 +0000 (16:27 +0100)]
share/mk/: build-html: Skip known errors (in groff-1.23.0)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 15:20:58 +0000 (16:20 +0100)]
LICENSES/: Add LGPL-3.0-or-later and LGPL-3.0-linking-exception
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 15:19:24 +0000 (16:19 +0100)]
share/mk/: Update license
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 18 Mar 2024 14:35:10 +0000 (15:35 +0100)]
share/mk/: Use grohtml(1) instead of man2html(1)
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>
Alejandro Colomar [Mon, 18 Mar 2024 10:00:14 +0000 (11:00 +0100)]
proc_pid_io.5: Move note to CAVEATS
Cc: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Jing Peng [Sun, 17 Mar 2024 23:48:24 +0000 (19:48 -0400)]
bpf.2: wfix
Signed-off-by: Jing Peng <pj.hades@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Oliver Crumrine [Sun, 17 Mar 2024 13:55:50 +0000 (09:55 -0400)]
ip.7: Some socket options are not supported by SOCK_STREAM
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>
наб [Sun, 17 Mar 2024 15:37:52 +0000 (16:37 +0100)]
proc_pid_io.5: Dewafflify
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>
наб [Sun, 17 Mar 2024 11:01:43 +0000 (12:01 +0100)]
proc_pid_io.5: Stats include children
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>
Alejandro Colomar [Sun, 17 Mar 2024 12:47:28 +0000 (13:47 +0100)]
tzfile.5: ffix
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 17 Mar 2024 11:23:25 +0000 (12:23 +0100)]
tzfile.5: Avoid crashing man2html(1)
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>
Alejandro Colomar [Sat, 16 Mar 2024 22:04:46 +0000 (23:04 +0100)]
tzfile.5, tzselect.8, zdump.8, zic.8: Refresh pages
Refreshed from tzdb-2024a.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 16 Mar 2024 21:57:05 +0000 (22:57 +0100)]
bpf-helpers.7: Refresh page
Scripted change:
$ ~/src/linux/linux/6.8/scripts/bpf_doc.py | rst2man > man7/bpf-helpers.7
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sat, 16 Mar 2024 01:01:20 +0000 (02:01 +0100)]
getgrouplist.3: Use same type in both sides of comparison
This removes a warning.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Lili Püspök [Wed, 6 Mar 2024 20:02:47 +0000 (21:02 +0100)]
unix.7: EXAMPLES: server.c: End connection with END
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>
Jeremy Baxter [Fri, 15 Mar 2024 01:07:14 +0000 (14:07 +1300)]
printf.3: Return the number of bytes printed, not characters
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>
Alejandro Colomar [Thu, 14 Mar 2024 16:44:12 +0000 (17:44 +0100)]
utf-8.7: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Samanta Navarro [Thu, 14 Mar 2024 12:22:42 +0000 (12:22 +0000)]
utf-8.7: ffix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Samanta Navarro [Thu, 14 Mar 2024 12:21:50 +0000 (12:21 +0000)]
printf.h.3head: tfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
наб [Wed, 13 Mar 2024 14:26:54 +0000 (15:26 +0100)]
getrusage.2, proc_pid_io.5: Crosslink
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>
наб [Wed, 13 Mar 2024 14:26:52 +0000 (15:26 +0100)]
getrusage.2: proc(5) /proc/pid/stat -> proc_pid_stat(5)
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>
наб [Wed, 13 Mar 2024 14:26:50 +0000 (15:26 +0100)]
proc_pid_io.5: Mention atomicity in atomicity note
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>
наб [Wed, 13 Mar 2024 14:26:48 +0000 (15:26 +0100)]
proc_pid_io.5: wfix
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 12 Mar 2024 17:45:42 +0000 (18:45 +0100)]
scripts/LinuxManBook/build.sh, share/mk/: Use command variables
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 12 Mar 2024 17:25:17 +0000 (18:25 +0100)]
logb.3: floor(log2(fabs(x))) has rounding errors
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>
Deri [Tue, 12 Mar 2024 13:46:24 +0000 (14:46 +0100)]
scripts/LinuxManBook/prepare.pl: Support some autogenerated pages from other 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>
Alejandro Colomar [Thu, 7 Mar 2024 02:21:28 +0000 (03:21 +0100)]
TIMESPEC_TO_TIMEVAL.3, TIMEVAL_TO_TIMESPEC.3: Document these macros
Reported-by: Guillem Jover <guillem@hadrons.org>
Reviewed-by: Oskari Pirhonen <xxc3ncoredxx@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 7 Mar 2024 01:58:50 +0000 (02:58 +0100)]
share/mk/configure/build-depends/cc.mk: Use -Wno-unsafe-buffer-usage with clang(1)
That warning has false positives, such as in unix(7).
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 6 Mar 2024 11:25:26 +0000 (12:25 +0100)]
unix.7: Use a 'ssize_t' for the return value of read(2) and write(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 6 Mar 2024 11:23:32 +0000 (12:23 +0100)]
unix.7: Use 'int' to iterate over 'argv'
'argc' is an 'int', so we should compare it with a variable of the same
type.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 6 Mar 2024 11:22:10 +0000 (12:22 +0100)]
unix.7: Use int main(void)
The arguments were unused.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 6 Mar 2024 11:21:37 +0000 (12:21 +0100)]
unix.7: Remove spurious #include
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 6 Mar 2024 11:20:46 +0000 (12:20 +0100)]
unix.7: Build example programs
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Hugo Gabriel Eyherabide [Tue, 5 Mar 2024 05:14:06 +0000 (07:14 +0200)]
read.2: tfix
Signed-off-by: Hugo Gabriel Eyherabide <hugogabiel.eyherabide@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 5 Mar 2024 01:15:14 +0000 (02:15 +0100)]
log2.3, log10.3: wfix
Reported-by: Morten Welinder <mwelinder@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 5 Mar 2024 01:01:34 +0000 (02:01 +0100)]
cbrt.3: wfix: Cube roots are rarely representable
On Thu, Feb 29, 2024 at 07:28:10PM -0500, Morten Welinder wrote:
> The phrase "every representable real value has a representable real
> cube root" is wrong. In fact, a representable cube root is quite
> rare.
Link: <https://lore.kernel.org/linux-man/ZeYKUOKYS7G90SaV@debian/T/#mff0ab388000c6afdb5e5162804d4a0073de481de>
Reported-by: Morten Welinder <mwelinder@gmail.com>
Cowritten-by: Morten Welinder <mwelinder@gmail.com>
Cc: Adhemerval Zanella Netto <adhemerval.zanella@linaro.org>
Cc: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 5 Mar 2024 00:44:44 +0000 (01:44 +0100)]
significand.3: significand() uses FLT_RADIX, not 2
It's implemented using scalb(), which uses FLT_RADIX.
Reported-by: Morten Welinder <mwelinder@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 4 Mar 2024 23:20:09 +0000 (00:20 +0100)]
logb.3: logb(x) is floor(log2(fabs(x)))
log2(3) doesn't accept negative input, but it seems logb(3) does accept
it.
Link: <https://lore.kernel.org/linux-man/ZeYKUOKYS7G90SaV@debian/T/#u>
Reported-by: Morten Welinder <mwelinder@gmail.com>
Cc: Adhemerval Zanella Netto <adhemerval.zanella@linaro.org>
Cc: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 10 Mar 2024 13:55:54 +0000 (14:55 +0100)]
share/mk/: dist: Don't package .git/
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 4 Mar 2024 12:02:29 +0000 (13:02 +0100)]
clock_getres.2: HISTORY: Clarify that POSIX.1-2008 only makes mandatory the functions
The different clocks are still optional.
Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=218452>
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Reported-by: Enrique Garcia <cquike@arcor.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 4 Mar 2024 11:45:24 +0000 (12:45 +0100)]
cgroups.7: tfix
Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=218105>
Reported-by: Göran Uddeborg <goeran@uddeborg.se>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Mon, 4 Mar 2024 11:43:42 +0000 (12:43 +0100)]
share/mk/: Add missing include
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 5 Mar 2024 01:22:46 +0000 (02:22 +0100)]
clock_nanosleep.2: Use 't' rather than 'request'
It seems much more clear.
Cc: Elliott Hughes <enh@google.com>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 3 Mar 2024 12:01:57 +0000 (13:01 +0100)]
nanosleep.2: Use 'duration' rather than 'request'
It seems much more clear.
Suggested-by: Elliott Hughes <enh@google.com>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 31 Oct 2023 21:36:33 +0000 (22:36 +0100)]
man*/: epoll_*(), fcntl(), flock(), ioctl(), msgctl(), *prctl(), ptrace(), quotactl(), reboot(), semctl(), shmctl(), lockf(): Consistently use 'op' and 'operation'
Reported-by: Bruno Haible <bruno@clisp.org>
Cc: Elliott Hughes <enh@google.com>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Jakub Wilk [Wed, 28 Feb 2024 19:08:28 +0000 (20:08 +0100)]
Changes.old: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 Feb 2024 12:44:42 +0000 (13:44 +0100)]
share/mk/: distcheck: Rewrite most of it
This implementation is simpler.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 Feb 2024 12:49:55 +0000 (13:49 +0100)]
share/mk/: build-ex-src: Support long $DISTNAME
When $DISTNAME is too long, mandoc(1) breaks the last line. The last
two lines can always be removed safely, which makes it work also in this
case.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 28 Feb 2024 10:42:17 +0000 (11:42 +0100)]
share/mk/: Fix path
Signed-off-by: Alejandro Colomar <alx@kernel.org>