aboutsummaryrefslogtreecommitdiffstats
path: root/man7
AgeCommit message (Collapse)AuthorFilesLines
2020-10-07system_data_types.7: Add 'off_t'Alejandro Colomar1-0/+50
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03system_data_types.7: tfix: Oxford commaMichael Kerrisk1-8/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03system_data_types.7: tfix: remove mention of __uint128_t and __int128_t typesMichael Kerrisk1-6/+2
Those types won't appear in this page. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03Revert [u]int_*astN_t commitsAlejandro Colomar1-304/+0
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 a5d13a32b79508c3224b678c67c1d5bcec0dd78e. Revert "system_data_types.7: Add uint_leastN_t family of types" This reverts commit 3450a5621e2a0bbba96add77002d5bf92412fd80. 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 876838354df6f32a3ba6c91698bdd8fb25e8167b. Revert "system_data_types.7: Add int_leastN_t family of types" This reverts commit f9b54d3a2eb5da554f9c6979b588fec534082586. 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 496b1aad79db5662cac02b4a2c51851c8b37a5c5. Revert "system_data_types.7: Add uint_fastN_t family of types" This reverts commit 3c9ae6e5a264f1346260931132661cceb74f2539. 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 9df81a23e563ca1e65aafaaec981321816e35f25. Revert "system_data_types.7: Add int_fastN_t family of types" This reverts commit 8f12d3f6838e1b65e872211286cb33418953a94d. 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-03system_data_types.7: Move notes about versions to "Versions"Alejandro Colomar1-16/+18
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-03system_data_types.7: Add 'void *'Alejandro Colomar1-2/+74
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-02system_data_types.7: Remove duplicate referenceAlejandro Colomar1-1/+0
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Add uint_leastN_t family of typesAlejandro Colomar1-0/+75
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Add int_leastN_t family of typesAlejandro Colomar1-0/+72
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Add uint_fastN_t family of typesAlejandro Colomar1-0/+80
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Add int_fastN_t family of typesAlejandro Colomar1-0/+77
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Move "Bugs" after "Notes", as man-pages(7) specifiesAlejandro Colomar1-8/+8
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Add 'uintptr_t'Alejandro Colomar1-0/+68
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Add 'intptr_t'Alejandro Colomar1-0/+65
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: srcfixAlejandro Colomar1-34/+0
We used .br to force a simple line break (with no extra blank line) after the tag. Recently, we added .RS/.RS, and .RS comes just after the tag, and I realized by accident that .RS already forces a simple line break. Therefore, .br is completely redundant here, and can be removed. This way we get rid of "raw" *roff requests in this page. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: srcfixAlejandro Colomar1-4/+12
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: srcfixAlejandro Colomar1-35/+70
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01feature_test_macros.7: Update list of macros that inhibit default definitionsJakub Wilk1-1/+4
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-01system_data_types.7: Improve "Include" wording and format, and explain it in ↵Alejandro Colomar1-183/+119
NOTES The previous format/wording for the includes wasn't very clear. Improve it a bit following Branden's proposal. It also helps reduce lines of code. Add a subsection in NOTES explaining the conventions used. Remove the comment for helping maintain the page, as the NOTES section is now clear enough. Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com> Reported-by: Dave Martin <Dave.Martin@arm.com> 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-09-29feature_test_macros.7: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29adjtimex.2, futex.2, semop.2, slabinfo.5, feature_test_macros.7, keyrings.7: ↵Michael Kerrisk2-4/+2
srcfix Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29system_data_types.7: Add 'FILE'Tycho Andersen1-0/+24
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29system_data_types.7: Minor edits to Alejandro Colomar's patchMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29system_data_types.7: Add uintN_t family of typesAlejandro Colomar1-0/+82
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29system_data_types.7: Add intN_t family of typesAlejandro Colomar1-0/+79
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29system_data_types.7: Add 'uintmax_t'Alejandro Colomar1-0/+55
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29system_data_types.7: Add 'intmax_t'Alejandro Colomar1-0/+56
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-28system_data_types.7: ffixAlejandro Colomar1-29/+29
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-26system_data_types.7: Add va_listAlejandro Colomar1-0/+31
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25rtld-audit.7: srcfix: semantic newlinesMichael Kerrisk1-3/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25rtld-audit.7: Clarify la_version handshakeFlorian Weimer1-11/+25
Returning its argument without further checks is almost always wrong for la_version. Reviewed-by: Carlos O'Donell <carlos@redhat.com> Signed-off-by: Florian Weimer <fweimer@redhat.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: Minor tweaks to Alejandro Colomar's float_t/double_t ↵Michael Kerrisk1-8/+8
patches Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: srcfixAlejandro Colomar1-139/+192
The contents of each type are a logical block that is indented as a block. They are not separate paragraphs that happen to be indented separately, but a set of continuous paragraphs, all at the same level, indented as a block from the list entry--the name of the type--. Therefore, it makes more sense to use block indentation, represented by .RS/.RE, rather than indenting each paragraph separately. That way it's also easier to further indent a separate paragraph inside a block, which happens for example in the case of float_t & double_t. It's simply much easier now to use .IP specifically in those cases where you want to indent just a single paragraph. Also added an ending separator comment line just after the last type. [mtk: minor edits to commit message] Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: Add double_tAlejandro Colomar1-0/+42
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: Add float_tAlejandro Colomar1-0/+42
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: srcfixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: Add lconvAlejandro Colomar1-0/+47
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25system_data_types.7: ffixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24system_data_types.7: Add lldiv_tAlejandro Colomar1-0/+22
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24system_data_types.7: Add ldiv_tAlejandro Colomar1-0/+22
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24system_data_types.7: Add div_tAlejandro Colomar1-0/+22
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24system_data_types.7: Add imaxdiv_tAlejandro Colomar1-0/+22
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24pldd.1, bpf.2, clone.2, dup.2, ioctl_fat.2, nfsservctl.2, ↵Michael Kerrisk8-14/+14
open_by_handle_at.2, perf_event_open.2, pivot_root.2, request_key.2, sched_setaffinity.2, seccomp.2, select.2, statx.2, dl_iterate_phdr.3, dlinfo.3, dlopen.3, insque.3, newlocale.3, printf.3, pthread_setname_np.3, rpc.3, stdarg.3, strfmon.3, veth.4, proc.5, slabinfo.5, cgroup_namespaces.7, cgroups.7, cpuset.7, fanotify.7, inotify.7, mount_namespaces.7, sock_diag.7, user_namespaces.7, ld.so.8: Use \(aq instead of ' inside monospace fonts Use \(aq to get an unslanted single quote inside monospace code blocks. Using a simple ' results in a slanted quote inside PDFs. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-23system_data_types.7: Add 'fexcept_t'Alejandro Colomar1-1/+16
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-23system_data_types.7: Reword description of fenv_t to avoid simply quoting ↵Michael Kerrisk1-4/+3
POSIX text The existing text comes straight from POSIX. In copyright terms, this is at least a gray area, and in any case, simply reproducing the text of the standard has limited value, since people can consult the standard directly. So, rewrite the text, to simply quote the description from fenv(3). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: ffixAlejandro Colomar1-3/+3
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add 'id_t'Michael Kerrisk1-0/+22
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add self to copyright noticeMichael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add 'gid_t'Michael Kerrisk1-0/+35
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add 'uid_t'Michael Kerrisk1-0/+32
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22credentials.7: SEE ALSO: add system_data_types(7)Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add further POSIX details for size_t, ssize_t, and ↵Michael Kerrisk1-2/+18
suseconds_t The implementation shall support one or more programming environments where these types are no wider than 'long'. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Document pid_tMichael Kerrisk1-0/+54
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add description of sigset_tMichael Kerrisk1-0/+27
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22system_data_types.7: Add brief description of regmatch_tMichael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-21system_data_types.7: Document fenv_tAlejandro Colomar1-0/+16
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-21system_data_types.7: wfixAlejandro Colomar1-1/+1
A limit can be defined by other than POSIX Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-21system_data_types.7: Minor tweaks to Alejandro Colomar's patchMichael Kerrisk1-10/+15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-21system_data_types.7: Describe use of printf()/scanf() modifiers for integer ↵Alejandro Colomar1-0/+73
data types Add note about length modifiers and conversions to [u]intmax_t, and add a corresponding example. 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-09-20system_data_types.7: Minor tweaks to Alejandro Colomar's patchMichael Kerrisk1-3/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-20system_data_types.7: Specify the length modifiers for the variables that ↵Alejandro Colomar1-0/+56
have them Reported-by: Florian Weimer <fweimer@redhat.com> Reported-by: Paul Eggert <eggert@cs.ucla.edu> Reviewed-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-09-20system_data_types.7: Defer to sigaction(2) for further information on siginfo_tMichael Kerrisk1-2/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-20system_data_types.7: ffixMichael Kerrisk1-9/+7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-20system_data_types.7: Document siginfo_tAlejandro Colomar1-3/+36
Note: There are a few members of this structure that are not required by POSIX (XSI extensions, and such). I simply chose to not document them at all. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19ip.7: Minor wording fixesMichael Kerrisk1-7/+7
Mainly cleaning up usages of "only". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19ip.7: Minor edits to Stephen Smalley's patchMichael Kerrisk1-8/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19ip.7: Document IP_PASSSEC for UDP socketsStephen Smalley1-6/+42
Document the IP_PASSSEC socket option and SCM_SECURITY ancillary/control message type for UDP sockets. IP_PASSSEC for UDP sockets was introduced in Linux 2.6.17 [1]. Example NetLabel and IPSEC configurations and usage of this option can be found in the SELinux Notebook [2] and SELinux testsuite [3]. [1] https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=2c7946a7bf45ae86736ab3b43d0085e43947945c [2] https://github.com/SELinuxProject/selinux-notebook [3] https://github.com/SELinuxProject/selinux-testsuite Reviewed-by: Paul Moore <paul@paul-moore.com> Signed-off-by: Stephen Smalley <stephen.smalley.work@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19ip.7, unix.7: Minor edits to Stephen Smalley's patchesMichael Kerrisk2-17/+18
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19unix.7: srcfix: rewrap source lines in Stephen Smalley's patchMichael Kerrisk1-11/+9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19ip.7: srcfix: rewrap source lines in Stephen Smalley's patchMichael Kerrisk1-16/+16
(No content changes.) Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19socket.7,ip.7: Document SO_PEERSEC for AF_INET socketsStephen Smalley2-1/+57
Augment the description of SO_PEERSEC to cover AF_INET sockets in addition to the prior description for AF_UNIX. SO_PEERSEC for TCP sockets was introduced in Linux 2.6.17 [1], and SO_PEERSEC for SCTP sockets was introduced in Linux 4.17 [2]. This does not cover usage of SCM_SECURITY for UDP sockets, which was also introduced in the same commit for 2.6.17. Examples of the necessary labeled IPSEC and NetLabel configurations to enable use of SO_PEERSEC for TCP and SCTP sockets can be found in the SELinux Notebook [3] and the selinux-testsuite [4]. [1] https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=2c7946a7bf45ae86736ab3b43d0085e43947945c [2] https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=d452930fd3b9031e59abfeddb2fa383f1403d61a [3] https://github.com/SELinuxProject/selinux-notebook [4] https://github.com/SELinuxProject/selinux-testsuite Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19socket.7, unix.7: Add initial description for SO_PEERSECStephen Smalley2-0/+51
SO_PEERSEC was introduced for AF_UNIX stream sockets connected via connect(2) in Linux 2.6.2 [1] and later augmented to support AF_UNIX stream and datagram sockets created via socketpair(2) in Linux 4.18 [2]. Document SO_PEERSEC in the socket.7 and unix.7 man pages following the example of the existing SO_PEERCRED descriptions. SO_PEERSEC is also supported on AF_INET sockets when using labeled IPSEC or NetLabel but defer adding a description of that support to a separate patch. The module-independent description of the security context returned by SO_PEERSEC is from Simon McVittie. [1] https://git.kernel.org/pub/scm/linux/kernel/git/tglx/history.git/commit/?id=da6e57a2e6bd7939f610d957afacaf6a131e75ed [2] https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=0b811db2cb2aabc910e53d34ebb95a15997c33e7 Reviewed-by: Serge Hallyn <serge@hallyn.com> Cowritten-by: Simon McVittie <smcv@collabora.com> Signed-off-by: Stephen Smalley <stephen.smalley.work@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19sigevent.7: ffixMichael Kerrisk1-16/+16
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19sigevent.7: Note that 'sigev_notify_thread_id' is Linux-specificMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19system_data_types.7: ffixMichael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-19system_data_types.7: Minor tweaksMichael Kerrisk1-3/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Defer to aio(7) for further information about 'struct ↵Michael Kerrisk1-2/+2
aiocb' Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Document aiocbAlejandro Colomar1-4/+36
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: srcfix: cosmetic: Visually separate typesAlejandro Colomar1-0/+12
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Add reference to sigevent(7)Michael Kerrisk1-2/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Document sigeventAlejandro Colomar1-5/+52
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: ffixAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Document regmatch_tAlejandro Colomar1-2/+21
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: ffixAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: srcfix: Add FIXME notesAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Document regoff_tAlejandro Colomar1-1/+29
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Document ptrdiff_tAlejandro Colomar1-1/+24
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: wfix: sort referenced typesAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: srcfix: Remove TODO commentAlejandro Colomar1-3/+0
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Add read(2) and write(2) to "See also" for size_tMichael Kerrisk1-0/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-18system_data_types.7: Document size_tAlejandro Colomar1-4/+99
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-17feature_test_macros.7: tfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-17intro.2, intro.3, feature_test_macros.7, standards.7: SEE ALSO: add ↵Michael Kerrisk2-2/+4
system_data_types(7) Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-17system_data_types.7: Add SEE ALSO references to feature_test_macros(7) and ↵Michael Kerrisk1-0/+3
standards(7) Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-17system_data_types.7: Add a new page to document system data typesAlejandro Colomar1-0/+280
The initial version documents sigval, ssize_t, suseconds_t, time_t, timer_t, timespec, and timeval. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-15man-pages.7: Add some more requests re code examplesMichael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-15man-pages.7: Soften the statement that ideal programs should be shortMichael Kerrisk1-2/+4
Sometimes, a longer program is needed. See https://twitter.com/shuveb/status/1305689727715086337. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-15fanotify.7: ffixMichael Kerrisk1-10/+11
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-15add_key.2, clock_getres.2, clone.2, futex.2, getdents.2, getpid.2, ↵Alejandro Colomar2-11/+16
getrlimit.2, ioctl_ns.2, kcmp.2, keyctl.2, memfd_create.2, request_key.2, stat.2, timer_create.2, wait.2, clock_getcpuclockid.3, dl_iterate_phdr.3, getgrent_r.3, getpwent_r.3, getpwnam.3, posix_spawn.3, pthread_getcpuclockid.3, strcat.3, feature_test_macros.7, user_namespaces.7: Switch printf() casts to use [u]intmax_t + %ju / %jd Let's move to the 21st century. Instead of casting system data types to long/long long/etc. in printf() calls, instead cast to intmax_t or uintmax_t, the largest available signed/unsigned integer types. [mtk: rewrote commit message] Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-13rtld-audit.7: Use "%u" rather than "%d" when printing 'unsigned int' valuesAlejandro Colomar1-3/+3
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-12eventfd.2, mprotect.2, pidfd_open.2, spu_run.2, timer_create.2, bswap.3, ↵Alejandro Colomar1-2/+2
dl_iterate_phdr.3, endian.3, pthread_attr_init.3, pthread_getattr_np.3, vcs.4, rtld-audit.7: In printf(): s/0x%/%#/ except when followed by X instead of x Use printf()'s '#' flag character to prepend the string "0x". However, when the number is printed in uppercase, and the prefix is in lowercase, the string "0x" needs to be manually written. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-12msgctl.2, outb.2, abs.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, ↵Alejandro Colomar2-3/+3
encrypt.3, ffs.3, lrint.3, lround.3, ntp_gettime.3, printf.3, random.3, scalbln.3, scanf.3, strtol.3, strtoul.3, utmp.5, feature_test_macros.7, rtld-audit.7: Omit 'int' keyword for 'short', 'long' and 'long long' types, both signed and 'unsigned' For consistency. The types are written both with and without the redundant 'int' keyword all over the man-pages. However, the most used form, by far, is the one without 'int'. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11unix.7: Use sizeof() to get buffer size (instead of hardcoding macro name)Alejandro Colomar1-7/+7
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11aio.7: Use perror() directlyAlejandro Colomar1-4/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11rtnetlink.7: ffixMichael Kerrisk1-24/+38
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11rtnetlink.7: tfixMichael Kerrisk1-9/+9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11rtnetlink.7: ffixMichael Kerrisk1-9/+10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11locale.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-07pthreads.7: Explicitly note that pthreads APIs return an errno-style value ↵Michael Kerrisk1-0/+4
on error Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-06user_namespaces.7: Remove unneeded castAlejandro Colomar1-1/+1
Casting `void *` to `struct child_args *` is already done implicitly. Explicitly casting can silence warnings when mistakes are made, so it's better to remove those casts when possible. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-06sock_diag.7: Remove unneeded castsAlejandro Colomar1-2/+2
The type `struct sockaddr_nl *` is implicitly casted to `void *`. Explicitly casting can silence warnings when mistakes are made, so it's better to remove those casts when possible. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05fanotify.7: Pass array to read(2) directly instead of a pointer to itAlejandro Colomar1-2/+2
It doesn't make any sense to pass a pointer to the array to read(2). It might make sense to pass a pointer to the first element of the array, but that is already implicitly done when passing the array, which decays to that pointer, so it's simpler to pass the array. And anyway, the cast was unneeded, as any pointer is implicitly cast to `void *`. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05sprof.1, eventfd.2, execve.2, futex.2, getdents.2, mprotect.2, ↵Michael Kerrisk5-15/+11
open_by_handle_at.2, recvmmsg.2, sched_setaffinity.2, CPU_SET.3, backtrace.3, bsearch.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, envz_add.3, fopencookie.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getgrent_r.3, getgrouplist.3, getifaddrs.3, getprotoent_r.3, getservent_r.3, hsearch.3, mallinfo.3, malloc_info.3, mbstowcs.3, mtrace.3, pthread_create.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, qsort.3, rand.3, strcat.3, strtok.3, tsearch.3, wordexp.3, core.5, aio.7, inotify.7, sock_diag.7, unix.7, user_namespaces.7: Use C99 style to declare loop counter variables Rather than: sometype x; for (x = ....; ...) use for (sometype x = ...; ...) This brings the declaration and use closer together (thus aiding readability) and also clearly indicates the scope of the loop counter variable. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05getgrouplist.3, insque.3, malloc_info.3, pthread_create.3, tsearch.3, aio.7: ↵Michael Kerrisk1-4/+2
Use C99-style declarations for readability Rather than writing things such as: struct sometype *x; ... x = malloc(sizeof(*x)); let's use C99 style so that the type info is in the same line as the allocation: struct sometype *x = malloc(sizeof(*x)); Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05aio.7: Use sizeof consistentlyAlejandro Colomar1-2/+2
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05unix.7: Use sizeof consistentlyAlejandro Colomar1-4/+4
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05fanotify.7: Use sizeof consistentlyAlejandro Colomar1-2/+1
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05cpuset.7: tfixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-04unix.7: wsfixAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7: srcfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify_init.2, fanotify.7: Minor edits to Amir Goldstein's patchesMichael Kerrisk1-8/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify_init.2, fanotify.7: srcfix: Semantic newlinesMichael Kerrisk1-3/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7, fanotify_init.2: Document FAN_REPORT_NAMEAmir Goldstein1-17/+64
Document fanotify_init(2) flag FAN_REPORT_NAME and the format of the event info type FAN_EVENT_INFO_TYPE_DFID_NAME. The fanotify_fid.c example is extended to also report the name of the created file or subdirectory. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7, fanotify_init.2: Document FAN_REPORT_DIR_FIDAmir Goldstein1-4/+26
Document fanotify_init(2) flag FAN_REPORT_DIR_FID and event info type FAN_EVENT_INFO_TYPE_DFID. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7, fanotify_mark.2: Generalize documentation of FAN_REPORT_FIDAmir Goldstein1-44/+49
With fanotify_init(2) flag FAN_REPORT_FID, the group identifies filesystem objects by file handles in a single event info record of type FAN_EVENT_INFO_TYPE_FID. We intend to add support for new fanotify_init(2) flags for which the group identifies filesystem objects by file handles and add more event info record types. To that end, start by changing the language of the man page to refer to a "group that identifies filesystem objects by file handles" instead of referring to the FAN_REPORT_FID flag and document the extended event format structure in a more generic manner that allows more than a single event info record and not only a record of type FAN_EVENT_INFO_TYPE_FID. Clarify that the object identified by the file handle refers to the directory in directory entry modification events. Remove a note about directory entry modification events and monitoring a mount point that I found to be too confusing and out of context. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-26bpf-helpers.7: Really resync against latest kernel sourceMichael Kerrisk1-123/+669
Jakub points out that my last resync may accidentally have been against an old version of the kernel source, since the resync resulted in many deleted lines. I suspect he may be right. Let's resync against today's current kernel. Reported-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-25getgrouplist.3, inotify.7: Use sizeof consistentlyAlejandro Colomar1-1/+1
Use ``sizeof`` consistently through all the examples in the following way: - Never use a space after ``sizeof``, and always use parentheses around the argument. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#spaces Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-22capabilities.7: tfixSteve Hilder1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-22bpf-helpers.7: Resync with current kernel sourceMichael Kerrisk1-432/+65
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-22cgroups.7: wfixThomas Piekarski1-2/+1
Removing repeated word "the" Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-22time_namespaces.7: wfixThomas Piekarski1-1/+0
Removing repeated word "the" Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-13intro.1, clock_getres.2, execve.2, fcntl.2, iopl.2, lseek.2, mknod.2, ↵Michael Kerrisk50-50/+50
mmap.2, mount.2, mq_getsetattr.2, pidfd_open.2, prctl.2, setns.2, sgetmask.2, sigaction.2, stat.2, statx.2, sync.2, syscalls.2, syslog.2, timerfd_create.2, umask.2, a64l.3, aio_init.3, atoi.3, dladdr.3, fread.3, getpt.3, isfdtype.3, malloc_stats.3, malloc_trim.3, mkfifo.3, mq_close.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, posix_memalign.3, posix_openpt.3, pthread_atfork.3, pthread_rwlockattr_setkind_np.3, regex.3, scanf.3, sem_close.3, sem_destroy.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sigset.3, sigvec.3, strftime.3, termios.3, console_codes.4, dsp56k.4, fd.4, lp.4, mouse.4, pts.4, sk98lin.4, dir_colors.5, proc.5, resolv.conf.5, termcap.5, utmp.5, aio.7, armscii-8.7, arp.7, capabilities.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, environ.7, glob.7, inode.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, keyrings.7, koi8-r.7, koi8-u.7, mailaddr.7, man-pages.7, netdevice.7, operator.7, persistent-keyring.7, process-keyring.7, pthreads.7, pty.7, raw.7, regex.7, session-keyring.7, shm_overview.7, signal.7, socket.7, suffixes.7, thread-keyring.7, unicode.7, units.7, uri.7, user-keyring.7, user-session-keyring.7, iconvconfig.8, ld.so.8, zic.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-13drop "coding: UTF-8" headerMike Frysinger21-21/+0
This header is used inconsistently -- man pages are UTF-8 encoded but not setting this marker. It's only respected by the man-db package, and seems a bit anachronistic at this point when UTF-8 is the standard default nowadays. Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09man-pages.7: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09man-pages.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09man-pages.7: ffixMichael Kerrisk1-3/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09man-pages.7: srcfixMichael Kerrisk1-4/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09man-pages.7: Add some notes on generating optimal glyphsMichael Kerrisk1-4/+16
Getting nice renderings of ^ ` and ~ requires special steps in the page source. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09pldd.1, bpf.2, execve.2, futex.2, ioctl_fat.2, ioctl_tty.2, keyctl.2, ↵Michael Kerrisk7-22/+22
signalfd.2, timerfd_create.2, __ppc_get_timebase.3, a64l.3, frexp.3, pthread_setname_np.3, regex.3, rpmatch.3, scanf.3, strfmon.3, strftime.3, termios.3, console_codes.4, vcs.4, veth.4, core.5, dir_colors.5, termcap.5, ascii.7, charsets.7, glob.7, man-pages.7, operator.7, regex.7, user_namespaces.7, zic.8: Use "\(ha" rather than "^" in code This renders better in PDF. Reported-by: Geoff Clare <gwc@opengroup.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09glob.7, zic.8: Use \` rather than `Michael Kerrisk1-1/+1
\` produces better rendering in PDF. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-06intro.1, clock_getres.2, clone.2, futex.2, ioctl_fat.2, mkdir.2, mknod.2, ↵Michael Kerrisk12-17/+17
mmap.2, open.2, statx.2, umask.2, userfaultfd.2, glob.3, mkfifo.3, termios.3, wordexp.3, console_codes.4, sk98lin.4, vcs.4, dir_colors.5, hosts.equiv.5, proc.5, termcap.5, utmp.5, ascii.7, bpf-helpers.7, charsets.7, environ.7, glob.7, mailaddr.7, netlink.7, operator.7, suffixes.7, tcp.7, unicode.7, uri.7, zic.8: Use "\(ti" instead of "~" A naked tilde ("~") renders poorly in PDF. Instead use "\(ti", which renders better in a PDF, and produces the same glyph when rendering on a terminal. Reported-by: Geoff Clare <gwc@opengroup.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-04math_error.7: tfixMichael Kerrisk1-1/+1
Reported-by: John Scott <jscott@posteo.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-30socket.2, address_families.7: wfix: multiplexor ==> multiplexerMichael Kerrisk1-1/+1
Both are used, but "multiplexer" seems to be majority usage in English. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-29pty.7: Explicitly mention CONFIG_LEGACY_PTYSMichael Kerrisk1-2/+7
Explicitly mention CONFIG_LEGACY_PTYS, and note that it is disabled by default since Linux 2.6.30. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-29pty.7: Relocate a paragraph to NOTESMichael Kerrisk1-10/+12
The paragraph noting applications that use pseudoterminals is better placed in NOTES than in the DESCRTIPTION. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24Various pages: Drop t comment headerMike Frysinger17-17/+0
Historically, a comment of the following form at the top of a manual page was used to indicate too man(1) that the use of tbl(1) was required in order to process tables: '\" t However, at least as far back as 2001 (according to Branden), man-db's man(1) automatically uses tbl(1) as needed, rendering this comment unnecessary. And indeed many existing pages in man-pages that have tables don't have this comment at the top of the file. So, drop the comment from those files where it is present. [mtk: completely rewrote commit message] Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com> Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24Various pages: Trim leading blank comment lineMike Frysinger7-7/+0
Very few pages do this, so trim them. Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24Various pages: Use standard .\" comment styleMike Frysinger2-4/+4
The \" comment produces blank lines. Use the .\" that the vast majority of the codebase uses instead. Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-17capabilities.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-17capabilities.7: CAP_SYS_RESOURCE: add two more items for POSIX message queuesSaikiran Madugula1-1/+4
CAP_SYS_RESOURCE also allows overriding /proc/sys/fs/mqueue/msg_max and /proc/sys/fs/mqueue/msgsize_max. Signed-off-by: Saikiran Madugula <hummerbliss@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-17cgroup_namespaces.7: wfixBenjamin Peterson1-1/+1
Signed-off-by: Benjamin Peterson <benjamin@python.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06intro.1, localedef.1, memusage.1, memusagestat.1, bpf.2, execve.2, fork.2, ↵Michael Kerrisk37-103/+103
keyctl.2, request_key.2, sigaction.2, signal.2, socket.2, dlopen.3, getauxval.3, gnu_get_libc_version.3, pthread_atfork.3, sem_post.3, setjmp.3, strftime.3, veth.4, locale.5, nscd.conf.5, resolv.conf.5, address_families.7, armscii-8.7, ascii.7, capabilities.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, keyrings.7, koi8-r.7, koi8-u.7, libc.7, locale.7, man.7, network_namespaces.7, persistent-keyring.7, session-keyring.7, signal.7, unicode.7, uri.7, user-keyring.7, user-session-keyring.7: ffix: replace - with real\- Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06math_error.7: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-02man7/*: ffix: change '-' to '\-' for options and to '\(en' for a rangeBjarni Ingi Gislason7-16/+16
Change '-' to '\-' for the prefix of names to indicate an option. Change '-' to '\(en' for a range. Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-30cgroups.7, cpuset.7: Update kernel cgroup documentation referencesSven Hoexter2-23/+74
cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder and converted from .txt files to .rst Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-25ip.7: Remove mention of ipfw(4) which was in long obsolete ipchains projectMichael Kerrisk1-9/+0
Reported-by: Stephen Hemminger <stephen@networkplumber.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-24capabilities.7: Clarify that CAP_SYS_NICE relates to *lowering* the nice valueDan Kenigsberg1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-24standards.7: Add an entry for POSIX.1-1988Michael Kerrisk1-1/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-24standards.7: Correct various details in the explanation of XPG/POSIX/SUSMichael Kerrisk1-13/+20
As reported by mail from Geoff Clare, there are some details that need correcting: Subject: standards(7) (was: man-pages-5.07 released) Date: Wed, 10 Jun 2020 10:53:14 +0100 From: Geoff Clare <gwc@opengroup.org> ... The first isn't really a problem, just an oddity. You list POSIX.1b as "formerly known as POSIX.4", but you don't do the equivalent for POSIX.1c ("formerly known as POSIX.4a"). There are several problems with the XPG3 entry: "first significant release" - although I suppose XPG3 could be considered more significant than XPG2 because it was the first one to incorporate POSIX.1, I don't think it's fair to imply that XPG2 was not significant. (E.g. XPG2 was significant in that it was the first release to include I18N, and the first that had a conformance test suite.) "produced by the X/Open Company, a multivendor consortium" - this conflates two different things called X/Open. X/Open Company Limited is the UK company that did the editing work, organised meetings, etc. X/Open Group is the consortium whose members developed the technical content. "This multivolume guide was based on the POSIX standards" - at the time there was only one POSIX standard, namely POSIX.1-1988. The first release to incorporate POSIX.2 was XPG4 (which you may consider worth noting in the XPG4 entry). To fix these problems I would suggest changing the entry to: XPG3 Released in 1989, this was the first release of the X/Open Portability Guide to be based on a POSIX standard (POSIX.1-1988). This multivolume guide was developed by the X/Open Group, a multivendor consortium. Under SUSv2 I would suggest changing: Sometimes also referred to as XPG5. to: Sometimes also referred to (incorrectly) as XPG5. Under POSIX.1-2001, SUSv3: "XSI conformance constitutes the Single UNIX Specification version 3 (SUSv3)" is problematic. I think I touched on this in the previous discussion. I would suggest deleting that sentence and instead inserting, before "Two Technical Corrigenda ...", the following: The Single UNIX Specification version 3 (SUSv3) comprises the Base Specifications containing XBD, XSH, XCU and XRAT as above, plus X/Open Curses Issue 4 version 2 as an extra volume that is not in POSIX.1-2001. Something similar is needed in the POSIX.1-2008, SUSv4 entry where it talks about "the same four parts". The extra volume this time is X/Open Curses Issue 7. ]] Cowritten-by: Geoff Clare <gwc@opengroup.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-24capabilities.7: srcfixMichael Kerrisk1-2/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-24capabilities.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-24capabilities.7: Clarify wording around increasing process nice valueMichael Kerrisk1-1/+1
The fact that a more negative nice value means higher priority is a continuing source of confusion. Reported-by: Dan Kenigsberg <danken@redhat.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-21connect.2, pidfd_send_signal.2, ptrace.2, socket.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-21man7/*: srcfix: trim trailing spaceBjarni Ingi Gislason4-11/+11
Trim tailing space in "strings". There is no change in the output from "nroff" and "groff". ### Output is from: test-groff -b -mandoc -T utf8 -rF0 -t -w w -z [ "test-groff" is a developmental version of "groff" ] troff: <attributes.7>:510: warning: trailing space troff: <attributes.7>:512: warning: trailing space troff: <attributes.7>:513: warning: trailing space troff: <attributes.7>:516: warning: trailing space troff: <attributes.7>:649: warning: trailing space troff: <attributes.7>:681: warning: trailing space troff: <attributes.7>:720: warning: trailing space #### troff: <environ.7>:181: warning: trailing space troff: <environ.7>:182: warning: trailing space #### troff: <ip.7>:820: warning: trailing space #### troff: <signal.7>:316: warning: trailing space Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> #### Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-19symlink.7: Minor fixes to Aleksa Sarai's patchMichael Kerrisk1-9/+15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-19symlink.7: Document magic links more completelyAleksa Sarai1-9/+22
Traditionally, magic links have not been a well-understood topic in Linux. This helps clarify some of the terminology used in openat2.2. Signed-off-by: Aleksa Sarai <cyphar@cyphar.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-19man-pages.7: wfixJakub Wilk1-1/+1
Reorder full wordings to match the order of abbreviations. Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-12capabilities.7: Document CAP_BPFMichael Kerrisk1-2/+14
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-12capabilities.7: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-12capabilities.7: Add CAP_PERFMONMichael Kerrisk1-2/+19
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-11address_families.7: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-11chroot.2, utimensat.2, vfork.2, getcwd.3, getdtablesize.3, ualarm.3, ↵Michael Kerrisk1-1/+0
usleep.3, rtnetlink.7: srcfix Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-11dup.2, fallocate.2, futex.2, ioctl_fat.2, ioctl_ficlonerange.2, ↵Michael Kerrisk1-2/+2
ioctl_fideduperange.2, madvise.2, membarrier.2, mprotect.2, open.2, openat2.2, perf_event_open.2, perfmonctl.2, pipe.2, process_vm_readv.2, s390_pci_mmio_write.2, s390_runtime_instr.2, s390_sthyi.2, set_thread_area.2, sigprocmask.2, subpage_prot.2, unshare.2, cmsg.3, newlocale.3, pthread_setname_np.3, strfmon.3, strfromd.3, tsearch.3, tcp.7, ld.so.8: ffix Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-10cgroups.7: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-10cgroup_namespaces.7: ffixMichael Kerrisk1-8/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-10capabilities.7: SEE ALSO: add getpcaps(8)Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09iconv.1, locale.1, memusage.1, memusagestat.1, pldd.1, sprof.1, _syscall.2, ↵Michael Kerrisk27-27/+27
add_key.2, adjtimex.2, bind.2, bpf.2, chown.2, clone.2, close.2, copy_file_range.2, eventfd.2, fanotify_init.2, fanotify_mark.2, fork.2, fsync.2, futex.2, getdents.2, getrlimit.2, getxattr.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, ioctl_fat.2, ioctl_getfsmap.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, kcmp.2, keyctl.2, listen.2, listxattr.2, mbind.2, membarrier.2, memfd_create.2, mkdir.2, move_pages.2, mremap.2, msync.2, nfsservctl.2, open.2, perf_event_open.2, pidfd_send_signal.2, pipe.2, pivot_root.2, pkey_alloc.2, process_vm_readv.2, ptrace.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, s390_runtime_instr.2, sched_setaffinity.2, seccomp.2, send.2, sendmmsg.2, sigaltstack.2, signalfd.2, socket.2, socketpair.2, splice.2, spu_create.2, spu_run.2, statfs.2, syscall.2, sysctl.2, sysfs.2, tee.2, timer_getoverrun.2, timer_settime.2, umount.2, userfaultfd.2, utimensat.2, wait4.2, INFINITY.3, __ppc_get_timebase.3, __setfpucw.3, abort.3, aio_cancel.3, aio_error.3, aio_read.3, aio_return.3, atexit.3, backtrace.3, basename.3, bsearch.3, bswap.3, cacos.3, cacosh.3, catan.3, catanh.3, cexp2.3, clock_getcpuclockid.3, clog2.3, cmsg.3, confstr.3, div.3, dl_iterate_phdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, err.3, expm1.3, fdim.3, flockfile.3, fmtmsg.3, frexp.3, ftw.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo_a.3, getauxval.3, getdate.3, getdtablesize.3, getgrent_r.3, getgrouplist.3, gethostbyname.3, getline.3, getnameinfo.3, getopt.3, getprotoent_r.3, getpwent_r.3, getpwnam.3, getservent_r.3, getsubopt.3, getutent.3, glob.3, gnu_get_libc_version.3, hsearch.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, insque.3, killpg.3, makecontext.3, mallinfo.3, malloc.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbstowcs.3, mcheck.3, mempcpy.3, mq_getattr.3, mq_notify.3, mtrace.3, newlocale.3, nextafter.3, ntp_gettime.3, offsetof.3, open_memstream.3, pow.3, printf.3, pthread_attr_init.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setstack.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_detach.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_mutex_consistent.3, pthread_mutexattr_setrobust.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_spin_init.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, qsort.3, rand.3, random.3, remainder.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, sem_getvalue.3, sem_wait.3, setaliasent.3, setlogmask.3, sigwait.3, sincos.3, sockatmark.3, stdarg.3, stpcpy.3, strcat.3, strfmon.3, strptime.3, strtod.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, tsearch.3, uselocale.3, wcstok.3, wcstombs.3, wordexp.3, y0.3, loop.4, vcs.4, veth.4, charmap.5, core.5, filesystems.5, gai.conf.5, hosts.5, hosts.equiv.5, locale.5, nss.5, repertoiremap.5, securetty.5, shells.5, ttytype.5, ascii.7, complex.7, cpuset.7, credentials.7, fanotify.7, hier.7, inotify.7, ip.7, mount_namespaces.7, mq_overview.7, netlink.7, network_namespaces.7, pid_namespaces.7, pkeys.7, rtld-audit.7, rtnetlink.7, sem_overview.7, signal-safety.7, sock_diag.7, spufs.7, standards.7, symlink.7, tcp.7, time_namespaces.7, unix.7, user_namespaces.7, xattr.7, ldconfig.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09openat2.2, proc.5, bpf-helpers.7: srcfix: strip trailing whitespaceMichael Kerrisk1-5/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09user_namespaces.7: Clarify "system time"Michael Kerrisk1-1/+1
From an email conversation with Léo Stefanesco: > In the man7.org version of the man page for user_namespaces(7), it reads: > > there are many privileged operations that affect > resources that are not associated with any namespace type, > for example, changing the system time > (governed by CAP_SYS_TIME) > > which is not consistent with time_namespaces(7). In fact, strictly peaking the text still is correct, even after the arrival of time namespaces. Time namespaces virtualize only the boot-time and monotonic clocks, not the "real time" (i.e., calendar time), which is the time referred in the passage you quote. That said, the text is perhaps now a little misleading, and a little clarification would help. I changed the text to: there are many privileged operations that affect resources are not associated with any namespace type, for example, changing the system **(i.e., calendar)** time (governed by CAP_SYS_TIME) Reported-by: Léo Stefanesco <leo.lveb@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09bpf-helpers.7: Resync against kernel 5.7Michael Kerrisk1-45/+300
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-08fanotify.7, fanotify_mark.2: Clarify FAN_ONDIR in output maskAmir Goldstein1-0/+18
FAN_ONDIR was an input only flag before introducing FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can also be in output mask. Move the text describing its role in the output mask to fanotify.7 where the other output mask bits are documented. [mtk: commit message tidy-up] Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Amir Goldstein <amir73il@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-08fanotify.7, fanotify_mark.2: Revert "fanotify.7, fanotify_mark.2: Document ↵Amir Goldstein1-63/+10
FAN_DIR_MODIFY" This reverts commit a93e5c9593a95d09a1c9deb94dfdecbb970b8162. FAN_DIR_MODIFY was disabled for v5.7 release by kernel commit f17936993af0 ("fanotify: turn off support for FAN_DIR_MODIFY"). Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Amir Goldstein <amir73il@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-31man-pages.7: Rename EXAMPLE to EXAMPLESMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-31Various pages: retitle EXAMPLE section heading to EXAMPLESMichael Kerrisk21-21/+21
EXAMPLES appears to be the wider majority usage across various projects' manual pages, and is also what is used in the POSIX manual pages. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-31man-pages.7: Add REPORTING BUGS sectionMichael Kerrisk1-0/+10
man-pages doesn't have a REPORTING BUGS section in manual pages, but many other projects do. Make some recommendations about placement of that section.
2020-05-31man-pages.7: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-31man-pages.7: Describe COPYRIGHT sectionMichael Kerrisk1-0/+9
man-pages doesn't use COPYRIGHT sections in manual pages, but various projects do. Make some recommendations about placement of the section. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-31man-pages.7: Mention AUTHORS in summary section listMichael Kerrisk1-1/+1
Although man-pages doesn't use AUTHORS sections, many projects do use an AUTHORS section in their manual pages, so mention it in man-pages to suggest some guidance on the position at which to place that section. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-26pipe.2, socketpair.2, dlopen.3, posix_memalign.3, signal-safety.7: Correct ↵Michael Kerrisk1-60/+60
bogus POSIX.1 standards names POSIX.1-2003 ==> POSIX.1-2001 TC1 POSIX.1-2004 ==> POSIX.1-2001 TC2 POSIX.1-2013 ==> POSIX.1-2008 TC1 POSIX.1-2016 ==> POSIX.1-2008 TC2 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-26mount_namespaces.7: SEE ALSO: add mount(8), umount(8)Michael Kerrisk1-1/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-21mount_namespaces.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-21standards.7: Remove mention of bogus "POSIX" namesMichael Kerrisk1-10/+4
The terms POSIX.1-{2003,2004,2013,2016} were inventions of my imagination, as confirmed by consulting Geoff Clare of The Open Group. Remove these names. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-21standards.7: Add some more standardsMichael Kerrisk1-0/+12
Add: SUSv4 2016 edition, POSIX.1-2017, and SUSv4 2018 edition Reported-by: Geoff Clare <gwc@opengroup.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-19hier.7: Updating from FHS 2.3 to 3.0Thomas Piekarski1-4/+25
Adding description of new directories (/run, /usr/libexec, /usr/share/color,/usr/share/ppd, /var/lib/color), stating /usr/X11R6 as removed and updating URL to and version of FHS. See https://bugzilla.kernel.org/show_bug.cgi?id=206693 Reported-by: Gary Perkins <glperkins@lit.edu> Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-19cgroups.7: Note the existence of the clone3() CLONE_INTO_CGROUP flagMichael Kerrisk1-0/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-19pipe.2, sigaltstack.2, abort.3, signal.7: Place SH sections in standard orderMichael Kerrisk1-26/+26
Fix various pages that deviated from the norm described in man-pages(7). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-19gettid.2, open.2, seccomp.2, pthread_mutex_consistent.3, signal.7, xattr.7: ↵Michael Kerrisk2-2/+2
Put SEE ALSO entries in alphabetical order Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-18Various pages: Add missing commas in SEE ALSO part IIKir Kolyshkin2-2/+2
This is a sequel to commit baf17bc4f2a3f3b02d, addressing the issues with missing commas in the middle of SEE ALSO lists that emerged since. The awk script from the original commit was not working and had to be slightly modified (s/["]SEE ALSO["]/"?SEE ALSO/), otherwise it works like a charm. Here's the fixed script and its output just before this commit: for f in man*/*; do awk ' /^.SH "?SEE ALSO/ { sa=1; print "== " FILENAME " =="; print; next } /^\.(PP|SH)/ { sa=0; no=0; next } /^\.BR/ { if (sa==1) { print; if (no == 1) print "Missing comma in " FILENAME " +" FNR-1; no=0 } } /^\.BR .*)$/ { if (sa==1) no=1; next } /\.\\"/ {next} /.*/ { if (sa==1) { print; next } } ' $f; done | grep Missing Missing comma in man1/memusage.1 +272 Missing comma in man2/adjtimex.2 +597 Missing comma in man2/adjtimex.2 +598 Missing comma in man2/mkdir.2 +252 Missing comma in man2/sigaction.2 +1045 Missing comma in man2/sigaction.2 +1047 Missing comma in man3/mbsnrtowcs.3 +198 Missing comma in man3/ntp_gettime.3 +142 Missing comma in man3/strcmp.3 +219 Missing comma in man3/strtol.3 +302 Missing comma in man3/wcstombs.3 +120 Missing comma in man7/user_namespaces.7 +1378 Missing comma in man7/xattr.7 +198 Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-15ip.7: tfixOndrej Slamecka1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
generated by cgit 1.2.3-korg (git 2.43.0) at 2025-11-29 12:07:03 +0000