Commit Graph

21760 Commits

Author SHA1 Message Date
Michael Kerrisk 7f306fae15 ld.so.8: Add self to copyright
By now, I'm responsible for quite a lot of the content in
this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17 23:16:47 +02:00
Michael Kerrisk 185f4da527 mallinfo.3: srcfix: add comments noting errors in glibc info page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17 18:49:48 +02:00
Michael Kerrisk 70fd3c08d3 mallinfo.3: The 'usmblks' is nowadays always 0
Verified from the course code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17 18:49:48 +02:00
Alejandro Colomar 7e35a02866 regex.3: Add example program
$ gcc -Wall -Wextra -Werror -pedantic regex.c -o regex
$ ./regex.3
String = "1) John Driverhacker;
2) John Doe;
3) John Foo;
"
Matches:
#0:
offset = 25; length = 7
substring = "John Do"
#1:
offset = 38; length = 8
substring = "John Foo"

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17 16:35:36 +02:00
Alejandro Colomar 740656b855 queue.3: stailq: Complete example
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17 12:26:00 +02:00
Heinrich Schuchardt 7a737de2e1 kernel_lockdown.7: Describe LSM activation
Describe the activation of the Kernel Lockdown feature via Kconfig
and the command line.

Cf. Documentation/admin-guide/kernel-parameters.rst.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17 12:23:44 +02:00
Michael Kerrisk d2bbc4b7eb kernel_lockdown.7: Add a VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16 18:08:34 +02:00
Michael Kerrisk ae53794d61 kernel_lockdown.7: Various minor edits to bring this page closer to man-pages stype
No content changes...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16 18:04:41 +02:00
Heinrich Schuchardt bb509e6fcb kernel_lockdown.7: New page documenting the Kernel Lockdown feature
Provide a man-page for kernel_lockdown. The content is taken
from a patch for the Fedora 34 man-pages available at

https://kojipkgs.fedoraproject.org//packages/man-pages/5.08/1.fc34/src/man-pages-5.08-1.fc34.src.rpm

Signed-off-by: David Howells <dhowells@redhat.com>
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16 17:54:35 +02:00
Michael Kerrisk 02667b1ee5 link.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16 08:47:15 +02:00
Alejandro Colomar 7ef4fb8fcf queue.3: list: Complete example
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-15 20:49:50 +02:00
Michael Kerrisk 4b6e3782e1 seccomp.2: Warn reader that SECCOMP_RET_TRACE can be overridden
Highlight to the reader that if another filter returns a
higher-precedence action value, then the ptracer will not
be notified.

Reported-by: Jann Horn <jannh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-15 13:06:36 +02:00
Michael Kerrisk 025584732f regex.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-14 18:39:09 +02:00
Alejandro Colomar 4f2f24ff13 regex.3: wfix
The wording was incorrect:

It stated that 'eflags' may be the OR of one or two of those two flags,
but then a third flag was documented
(which according to the previous wording could not be used?!).
Moreover, the wording also disallowed using 0 (i.e., no flags at all),
which POSIX specifically allows;
I tested the function with no flags and it worked fine for me,
so I guess it was a problem with the documentation,
and not with the implementation itself.

POSIX ref: https://pubs.opengroup.org/onlinepubs/9699919799/

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-14 18:37:33 +02:00
Michael Kerrisk 5d771a4a9d futex.2, quotactl.2: wfix: use "bitwise" rather than "bit-wise"
Most manual pages already use "bitwise".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-14 18:34:45 +02:00
Alejandro Colomar 46b0a9d69c queue.3: circleq: Complete example
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-13 17:36:17 +02:00
Michael Kerrisk 861b602b53 resolv.conf.5: Minor edits to Florian Weimer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-12 23:11:08 +02:00
Michael Kerrisk cd79eb0ded resolv.conf.5: srcfix: rewrap source lines
No content changes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-12 23:11:08 +02:00
Florian Weimer a3f91ca97b resolv.5: Document the trust-ad option
Signed-off-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-12 20:48:39 +02:00
Michael Kerrisk 92e4056a29 strsignal.3: Further addition on version range for sys_siglist
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 18:04:29 +02:00
Michael Kerrisk d5e7276516 perror.3: sys_errlist and sys_nerr are no longer exposed by <stdio.h>
The change came with the release of glibc 2.32.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 18:04:17 +02:00
Alejandro Colomar 5158e8ee72 queue.3: slist: Complete example
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 18:04:17 +02:00
Alejandro Colomar b3617b75f9 queue.3: Replace incomplete example by a complete example
I added the EXAMPLES section.
The examples in this page are incomplete
(you can't copy&paste&compile&run).
I fixed the one about TAILQ first,
and the rest should follow.

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 14:22:20 +02:00
Alejandro Colomar 8e3a414354 regex_t.3: New link to system_data_types(7)
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 14:21:58 +02:00
Alejandro Colomar adbc303656 system_data_types.7: Add 'regex_t'
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 14:21:33 +02:00
Alejandro Colomar 71030dbdd2 regex.3: Remove unnecessary include
POSIX requires that the <regex.h> header shall define
the structures and symbolic constants used by the
regcomp(),  regexec(), regerror(), and regfree() functions.

Therefore, there should be no need to include <sys/types.h>
at all.

The POSIX docs don't use that include:
https://pubs.opengroup.org/onlinepubs/9699919799/functions/regcomp.html

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11 07:38:41 +02:00
Florian Weimer 870d48813c locale.5: Decimal points, thousands separators must be one character
This is implied by POSIX because it requires that these strings in
the locale definition file contain one symbol.  Currently,
locale.5 does not document the concept of symbols, this change
glosses over that and just uses the term "single-character
string".

Signed-off-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-10 11:07:24 +02:00
Alejandro Colomar abb53fc49c system_data_types.7: Add 'fd_set'
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-10 11:02:06 +02:00
Michael Kerrisk 2c1b51b14b epoll_ctl.2: epoll instances can be nested to a maximum depth of 5
This limit appears to be an off-by-one count against
EP_MAX_NESTS (4).

Verified by experiment.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-09 23:49:54 +02:00
Michael Kerrisk be1586b2f6 epoll_ctl.2: Move some version info from CONFORMING TO to VERSIONS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-09 23:06:43 +02:00
Michael Kerrisk 2650e82753 recv.2, send.2: Add cross references to pages with further info about ancillary data
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08 07:42:24 +02:00
Michael Kerrisk ac31fab940 man.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08 07:09:00 +02:00
Michael Kerrisk 2f9b9e5a5d man.7: Clarify that alternating typeface macros print arguments without spaces
Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08 07:07:11 +02:00
Michael Kerrisk 71a382811f socket.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08 07:03:41 +02:00
Michael Kerrisk 999f8568bd socket.7: SEE ALSO: add ipv6(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08 07:02:52 +02:00
Michael Kerrisk 0f849717a9 send.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08 07:00:11 +02:00
Samanta Navarro 9d4976ce7d mmap.2, proc.5, bpf-helpers.7, cpuset.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07 19:24:59 +02:00
Michael Kerrisk f2e7c3b645 system_data_types.7: Trim "See also" list of 'off_t'
Trim the list to just be a representative sample of
the APIs that use 'off_t'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07 08:48:03 +02:00
Alejandro Colomar 0de1c1dda3 off_t.3: New link to system_data_types(7)
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07 08:45:22 +02:00
Alejandro Colomar a0321d70b7 system_data_types.7: Add 'off_t'
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07 08:45:18 +02:00
Michael Kerrisk f5506505da system_data_types.7: tfix: Oxford comma
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03 22:11:23 +02:00
Michael Kerrisk 8f75c5029c system_data_types.7: tfix: remove mention of __uint128_t and __int128_t types
Those types won't appear in this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03 22:05:07 +02:00
Alejandro Colomar 875d83cb57 Revert [u]int_*astN_t commits
Revert "uint_least8_t.3, uint_least16_t.3, uint_least32_t.3, uint_least64_t.3, uint_leastN_t.3: New links to system_data_types(7)"
This reverts commit a5d13a32b7.

Revert "system_data_types.7: Add uint_leastN_t family of types"
This reverts commit 3450a5621e.

Revert "int_least8_t.3, int_least16_t.3, int_least32_t.3, int_least64_t.3, int_leastN_t.3: New links to system_data_types(7)"
This reverts commit 876838354d.

Revert "system_data_types.7: Add int_leastN_t family of types"
This reverts commit f9b54d3a2e.

Revert "uint_fast8_t.3, uint_fast16_t.3, uint_fast32_t.3, uint_fast64_t.3, uint_fastN_t.3: New links to system_data_types(7)"
This reverts commit 496b1aad79.

Revert "system_data_types.7: Add uint_fastN_t family of types"
This reverts commit 3c9ae6e5a2.

Revert "int_fast8_t.3, int_fast16_t.3, int_fast32_t.3, int_fast64_t.3, int_fastN_t.3: New links to system_data_types(7)"
This reverts commit 9df81a23e5.

Revert "system_data_types.7: Add int_fastN_t family of types"
This reverts commit 8f12d3f683.

Reported-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03 13:44:58 +02:00
Alejandro Colomar e1d90896ba system_data_types.7: Move notes about versions to "Versions"
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03 13:39:28 +02:00
Alejandro Colomar 941e891435 void.3: New link to system_data_types(7)
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03 10:00:14 +02:00
Alejandro Colomar baab22e295 system_data_types.7: Add 'void *'
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Reported-by: David Laight <David.Laight@ACULAB.COM>
Reported-by: Jonathan Wakely <jwakely.gcc@gmail.com>
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03 09:59:07 +02:00
Alejandro Colomar c2ccd81779 system_data_types.7: Remove duplicate reference
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-02 13:39:49 +02:00
Michael Kerrisk 970c890a17 strsignal.3: Note that 'sys_siglist' is nonstandard
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-02 13:07:30 +02:00
Michael Kerrisk 2d71151934 strsignal.3: Note that starting with v2.32, glibc no longer exports 'sys_siglist'
Reported-by: Hauke Fath <hf@spg.tu-darmstadt.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-02 13:05:23 +02:00
Michael Kerrisk fdecdf810f sys_siglist.3: New link to strsignal(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-02 12:57:45 +02:00