]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
4 years agoepoll_ctl.2: epoll instances can be nested to a maximum depth of 5
Michael Kerrisk [Fri, 9 Oct 2020 21:47:01 +0000 (23:47 +0200)] 
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>
4 years agoepoll_ctl.2: Move some version info from CONFORMING TO to VERSIONS
Michael Kerrisk [Fri, 9 Oct 2020 21:06:43 +0000 (23:06 +0200)] 
epoll_ctl.2: Move some version info from CONFORMING TO to VERSIONS

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agorecv.2, send.2: Add cross references to pages with further info about ancillary data
Michael Kerrisk [Thu, 8 Oct 2020 05:19:25 +0000 (07:19 +0200)] 
recv.2, send.2: Add cross references to pages with further info about ancillary data

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoman.7: srcfix
Michael Kerrisk [Thu, 8 Oct 2020 05:09:00 +0000 (07:09 +0200)] 
man.7: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoman.7: Clarify that alternating typeface macros print arguments without spaces
Michael Kerrisk [Thu, 8 Oct 2020 05:07:11 +0000 (07:07 +0200)] 
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>
4 years agosocket.7: ffix
Michael Kerrisk [Thu, 8 Oct 2020 05:03:41 +0000 (07:03 +0200)] 
socket.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosocket.7: SEE ALSO: add ipv6(7)
Michael Kerrisk [Thu, 8 Oct 2020 05:02:52 +0000 (07:02 +0200)] 
socket.7: SEE ALSO: add ipv6(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosend.2: wfix
Michael Kerrisk [Thu, 8 Oct 2020 05:00:11 +0000 (07:00 +0200)] 
send.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agommap.2, proc.5, bpf-helpers.7, cpuset.7: tfix
Samanta Navarro [Sun, 4 Oct 2020 11:44:34 +0000 (11:44 +0000)] 
mmap.2, proc.5, bpf-helpers.7, cpuset.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Trim "See also" list of 'off_t'
Michael Kerrisk [Wed, 7 Oct 2020 06:48:03 +0000 (08:48 +0200)] 
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>
4 years agooff_t.3: New link to system_data_types(7)
Alejandro Colomar [Mon, 5 Oct 2020 22:12:48 +0000 (00:12 +0200)] 
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>
4 years agosystem_data_types.7: Add 'off_t'
Alejandro Colomar [Mon, 5 Oct 2020 22:12:47 +0000 (00:12 +0200)] 
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>
4 years agosystem_data_types.7: tfix: Oxford comma
Michael Kerrisk [Sat, 3 Oct 2020 20:11:23 +0000 (22:11 +0200)] 
system_data_types.7: tfix: Oxford comma

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: tfix: remove mention of __uint128_t and __int128_t types
Michael Kerrisk [Sat, 3 Oct 2020 20:02:37 +0000 (22:02 +0200)] 
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>
4 years agoRevert [u]int_*astN_t commits
Alejandro Colomar [Sat, 3 Oct 2020 09:48:48 +0000 (11:48 +0200)] 
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 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>
4 years agosystem_data_types.7: Move notes about versions to "Versions"
Alejandro Colomar [Sat, 3 Oct 2020 09:28:48 +0000 (11:28 +0200)] 
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>
4 years agovoid.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 2 Oct 2020 19:28:16 +0000 (21:28 +0200)] 
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>
4 years agosystem_data_types.7: Add 'void *'
Alejandro Colomar [Fri, 2 Oct 2020 19:28:15 +0000 (21:28 +0200)] 
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>
4 years agosystem_data_types.7: Remove duplicate reference
Alejandro Colomar [Fri, 2 Oct 2020 09:15:05 +0000 (11:15 +0200)] 
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>
4 years agostrsignal.3: Note that 'sys_siglist' is nonstandard
Michael Kerrisk [Fri, 2 Oct 2020 11:07:30 +0000 (13:07 +0200)] 
strsignal.3: Note that 'sys_siglist' is nonstandard

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrsignal.3: Note that starting with v2.32, glibc no longer exports 'sys_siglist'
Michael Kerrisk [Fri, 2 Oct 2020 10:59:41 +0000 (12:59 +0200)] 
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>
4 years agosys_siglist.3: New link to strsignal(3)
Michael Kerrisk [Fri, 2 Oct 2020 10:53:09 +0000 (12:53 +0200)] 
sys_siglist.3: New link to strsignal(3)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopsignal.3, strsignal.3: Consolidate information on 'sys_siglist' in one page (strsign...
Michael Kerrisk [Fri, 2 Oct 2020 10:50:00 +0000 (12:50 +0200)] 
psignal.3, strsignal.3: Consolidate information on 'sys_siglist' in one page (strsignal(3))

Through some accident, 'sys_siglist' has been documented in
two different pages. Consolidate the information to one page
(strsignal(3)) and add 'sys_siglist" to the NAME line of that
page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouint_least8_t.3, uint_least16_t.3, uint_least32_t.3, uint_least64_t.3, uint_leastN_t...
Alejandro Colomar [Thu, 1 Oct 2020 14:35:36 +0000 (16:35 +0200)] 
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)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add uint_leastN_t family of types
Alejandro Colomar [Thu, 1 Oct 2020 14:35:35 +0000 (16:35 +0200)] 
system_data_types.7: Add uint_leastN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoint_least8_t.3, int_least16_t.3, int_least32_t.3, int_least64_t.3, int_leastN_t.3...
Alejandro Colomar [Thu, 1 Oct 2020 14:35:34 +0000 (16:35 +0200)] 
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)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add int_leastN_t family of types
Alejandro Colomar [Thu, 1 Oct 2020 14:35:33 +0000 (16:35 +0200)] 
system_data_types.7: Add int_leastN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouint_fast8_t.3, uint_fast16_t.3, uint_fast32_t.3, uint_fast64_t.3, uint_fastN_t.3...
Alejandro Colomar [Thu, 1 Oct 2020 14:32:04 +0000 (16:32 +0200)] 
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)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add uint_fastN_t family of types
Alejandro Colomar [Thu, 1 Oct 2020 14:32:03 +0000 (16:32 +0200)] 
system_data_types.7: Add uint_fastN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoint_fast8_t.3, int_fast16_t.3, int_fast32_t.3, int_fast64_t.3, int_fastN_t.3: New...
Alejandro Colomar [Thu, 1 Oct 2020 14:32:02 +0000 (16:32 +0200)] 
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)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add int_fastN_t family of types
Alejandro Colomar [Thu, 1 Oct 2020 14:32:01 +0000 (16:32 +0200)] 
system_data_types.7: Add int_fastN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Move "Bugs" after "Notes", as man-pages(7) specifies
Alejandro Colomar [Thu, 1 Oct 2020 13:29:04 +0000 (15:29 +0200)] 
system_data_types.7: Move "Bugs" after "Notes", as man-pages(7) specifies

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouintptr_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 1 Oct 2020 10:16:00 +0000 (12:16 +0200)] 
uintptr_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>
4 years agosystem_data_types.7: Add 'uintptr_t'
Alejandro Colomar [Thu, 1 Oct 2020 10:15:59 +0000 (12:15 +0200)] 
system_data_types.7: Add 'uintptr_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agointptr_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 1 Oct 2020 10:15:58 +0000 (12:15 +0200)] 
intptr_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>
4 years agosystem_data_types.7: Add 'intptr_t'
Alejandro Colomar [Thu, 1 Oct 2020 10:15:57 +0000 (12:15 +0200)] 
system_data_types.7: Add 'intptr_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:48 +0000 (12:15 +0200)] 
system_data_types.7: srcfix

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>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:47 +0000 (12:15 +0200)] 
system_data_types.7: srcfix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:46 +0000 (12:15 +0200)] 
system_data_types.7: srcfix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomalloc_get_state.3: ffix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:45 +0000 (12:15 +0200)] 
malloc_get_state.3: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofeature_test_macros.7: Update list of macros that inhibit default definitions
Jakub Wilk [Thu, 1 Oct 2020 09:54:19 +0000 (11:54 +0200)] 
feature_test_macros.7: Update list of macros that inhibit default definitions

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Improve "Include" wording and format, and explain it in NOTES
Alejandro Colomar [Tue, 29 Sep 2020 14:22:19 +0000 (16:22 +0200)] 
system_data_types.7: Improve "Include" wording and format, and explain it in 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>
4 years agoopenat2.2: tfix: fix minor reference typo
Aleksa Sarai [Tue, 29 Sep 2020 22:35:09 +0000 (08:35 +1000)] 
openat2.2: tfix: fix minor reference typo

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosched_getattr.2: Update to include changed size semantics
Aleksa Sarai [Tue, 29 Sep 2020 22:35:08 +0000 (08:35 +1000)] 
sched_getattr.2: Update to include changed size semantics

Due to a userspace breakage, commit 1251201c0d34 ("sched/core: Fix
uclamp ABI bug, clean up and robustify sched_read_attr() ABI logic
and code") changed the semantics of sched_getattr(2) when the
userspace struct is smaller than the kernel struct. Now, any
trailing non-zero data in the kernel structure is ignored when
copying to userspace. We also document the original error code
correctly (it was EFBIG not E2BIG) in the BUGS section.

Ref: 1251201c0d34 ("sched/core: Fix uclamp ABI bug, clean up and
                 robustify sched_read_attr() ABI logic and code")

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoman_show_fixme.sh: Fix misquoted double quotes in regexps
Michael Kerrisk [Wed, 30 Sep 2020 07:29:59 +0000 (09:29 +0200)] 
man_show_fixme.sh: Fix misquoted double quotes in regexps

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoxdr.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 20:01:46 +0000 (22:01 +0200)] 
xdr.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agorpc.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 20:00:26 +0000 (22:00 +0200)] 
rpc.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofeature_test_macros.7: ffix
Michael Kerrisk [Tue, 29 Sep 2020 19:33:20 +0000 (21:33 +0200)] 
feature_test_macros.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetutent.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 19:31:39 +0000 (21:31 +0200)] 
getutent.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoperf_event_open.2: srcfix
Michael Kerrisk [Tue, 29 Sep 2020 14:41:26 +0000 (16:41 +0200)] 
perf_event_open.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoproc.5: ffix + srcfix
Michael Kerrisk [Tue, 29 Sep 2020 14:26:52 +0000 (16:26 +0200)] 
proc.5: ffix + srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoadjtimex.2, futex.2, semop.2, slabinfo.5, feature_test_macros.7, keyrings.7: srcfix
Michael Kerrisk [Tue, 29 Sep 2020 14:17:52 +0000 (16:17 +0200)] 
adjtimex.2, futex.2, semop.2, slabinfo.5, feature_test_macros.7, keyrings.7: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrftime.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 13:42:42 +0000 (15:42 +0200)] 
strftime.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoFILE.3: New link to system_data_types(7)
Alejandro Colomar [Sun, 27 Sep 2020 21:13:45 +0000 (23:13 +0200)] 
FILE.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>
4 years agosystem_data_types.7: Add 'FILE'
Tycho Andersen [Tue, 29 Sep 2020 13:33:03 +0000 (15:33 +0200)] 
system_data_types.7: Add 'FILE'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years ago_exit.2, access.2, acct.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres...
Michael Kerrisk [Tue, 29 Sep 2020 13:06:31 +0000 (15:06 +0200)] 
_exit.2, access.2, acct.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, fsync.2, futimesat.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getrlimit.2, getsid.2, gettimeofday.2, kill.2, link.2, madvise.2, mincore.2, mkdir.2, mknod.2, nanosleep.2, nice.2, open.2, posix_fadvise.2, pread.2, process_vm_readv.2, readlink.2, readv.2, rename.2, select.2, semop.2, seteuid.2, setpgid.2, setreuid.2, sigaction.2, sigaltstack.2, sigpending.2, sigprocmask.2, sigsuspend.2, sigwaitinfo.2, stat.2, stime.2, symlink.2, sync.2, syscall.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, truncate.2, unlink.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, bsd_signal.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, confstr.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent_r.3, getopt.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getw.3, grantpt.3, group_member.3, gsignal.3, hypot.3, ilogb.3, inet.3, inet_net_pton.3, initgroups.3, insque.3, isalpha.3, isfdtype.3, isgreater.3, iswblank.3, j0.3, killpg.3, ldexp.3, lgamma.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, malloc.3, mbsnrtowcs.3, memchr.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_receive.3, mq_send.3, nan.3, newlocale.3, nextafter.3, nl_langinfo.3, on_exit.3, open_memstream.3, opendir.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_cleanup_push_defer_np.3, pthread_kill.3, pthread_mutex_consistent.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_spin_init.3, pthread_spin_lock.3, ptsname.3, putenv.3, putpwent.3, qecvt.3, qsort.3, rand.3, random.3, random_r.3, rcmd.3, readdir_r.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sockatmark.3, sqrt.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strfromd.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpnam.3, toascii.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, unlockpt.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wordexp.3, wprintf.3, y0.3: srcfix: use better macros in SYNOPSIS

Around the text:
"Feature Test Macro Requirements for glibc..."
replace ".in -4n/.in" with ".RS -4/.RE".
The latter form is more idiomatic use of man macros.
The nroff output is unchanged.

Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agochmod.2, connect.2, recv.2: srcfix
Michael Kerrisk [Tue, 29 Sep 2020 12:26:18 +0000 (14:26 +0200)] 
chmod.2, connect.2, recv.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoclone.2, io_submit.2, select.2, shmget.2, getcontext.3, malloc_info.3, mtrace.3,...
Michael Kerrisk [Tue, 29 Sep 2020 12:24:12 +0000 (14:24 +0200)] 
clone.2, io_submit.2, select.2, shmget.2, getcontext.3, malloc_info.3, mtrace.3, posix_spawn.3, strfromd.3, proc.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Minor edits to Alejandro Colomar's patch
Michael Kerrisk [Tue, 29 Sep 2020 11:48:52 +0000 (13:48 +0200)] 
system_data_types.7: Minor edits to Alejandro Colomar's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouint8_t.3, uint16_t.3, uint32_t.3, uint64_t.3, uintN_t.3: New links to system_data_ty...
Alejandro Colomar [Tue, 29 Sep 2020 10:30:30 +0000 (12:30 +0200)] 
uint8_t.3, uint16_t.3, uint32_t.3, uint64_t.3, uintN_t.3: New links 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>
4 years agosystem_data_types.7: Add uintN_t family of types
Alejandro Colomar [Tue, 29 Sep 2020 10:30:29 +0000 (12:30 +0200)] 
system_data_types.7: Add uintN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoint8_t.3, int16_t.3, int32_t.3, int64_t.3, intN_t.3: New links to system_data_types(7)
Alejandro Colomar [Tue, 29 Sep 2020 10:30:28 +0000 (12:30 +0200)] 
int8_t.3, int16_t.3, int32_t.3, int64_t.3, intN_t.3: New links 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>
4 years agosystem_data_types.7: Add intN_t family of types
Alejandro Colomar [Tue, 29 Sep 2020 10:30:27 +0000 (12:30 +0200)] 
system_data_types.7: Add intN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouintmax_t.3: New link to system_data_types(7)
Alejandro Colomar [Tue, 29 Sep 2020 10:30:26 +0000 (12:30 +0200)] 
uintmax_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>
4 years agosystem_data_types.7: Add 'uintmax_t'
Alejandro Colomar [Tue, 29 Sep 2020 10:30:25 +0000 (12:30 +0200)] 
system_data_types.7: Add 'uintmax_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agointmax_t.3: New link to system_data_types(7)
Alejandro Colomar [Tue, 29 Sep 2020 10:30:24 +0000 (12:30 +0200)] 
intmax_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>
4 years agosystem_data_types.7: Add 'intmax_t'
Alejandro Colomar [Tue, 29 Sep 2020 10:30:23 +0000 (12:30 +0200)] 
system_data_types.7: Add 'intmax_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostatx.2: Minor edits to Ira Weiny's
Michael Kerrisk [Tue, 29 Sep 2020 08:25:02 +0000 (10:25 +0200)] 
statx.2: Minor edits to Ira Weiny's

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostatx.2: Add STATX_ATTR_DAX
Ira Weiny [Tue, 5 May 2020 00:20:16 +0000 (17:20 -0700)] 
statx.2: Add STATX_ATTR_DAX

Linux 5.8 adds STATX_ATTR_DAX support.

https://lore.kernel.org/lkml/20200428002142.404144-4-ira.weiny@intel.com/
https://lore.kernel.org/lkml/20200504161352.GA13783@magnolia/

Add the text to the statx man page.

Signed-off-by: Ira Weiny <ira.weiny@intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoioctl_fslabel.2: ffix
Michael Kerrisk [Mon, 28 Sep 2020 10:40:13 +0000 (12:40 +0200)] 
ioctl_fslabel.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: ffix
Alejandro Colomar [Sun, 27 Sep 2020 21:13:43 +0000 (23:13 +0200)] 
system_data_types.7: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agova_list.3: New link to system_data_types(7)
Alejandro Colomar [Sat, 26 Sep 2020 17:08:15 +0000 (19:08 +0200)] 
va_list.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>
4 years agosystem_data_types.7: Add va_list
Alejandro Colomar [Sat, 26 Sep 2020 17:08:14 +0000 (19:08 +0200)] 
system_data_types.7: Add va_list

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoseccomp.2: ffix
Michael Kerrisk [Sat, 26 Sep 2020 13:49:32 +0000 (15:49 +0200)] 
seccomp.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agortld-audit.7: srcfix: semantic newlines
Michael Kerrisk [Fri, 25 Sep 2020 10:48:52 +0000 (12:48 +0200)] 
rtld-audit.7: srcfix: semantic newlines

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agortld-audit.7: Clarify la_version handshake
Florian Weimer [Fri, 25 Sep 2020 08:48:37 +0000 (10:48 +0200)] 
rtld-audit.7: Clarify la_version handshake

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>
4 years agosystem_data_types.7: Minor tweaks to Alejandro Colomar's float_t/double_t patches
Michael Kerrisk [Fri, 25 Sep 2020 11:58:47 +0000 (13:58 +0200)] 
system_data_types.7: Minor tweaks to Alejandro Colomar's float_t/double_t patches

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Fri, 25 Sep 2020 11:28:23 +0000 (13:28 +0200)] 
system_data_types.7: srcfix

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>
4 years agodouble_t.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 25 Sep 2020 07:31:38 +0000 (09:31 +0200)] 
double_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>
4 years agosystem_data_types.7: Add double_t
Alejandro Colomar [Fri, 25 Sep 2020 11:22:18 +0000 (13:22 +0200)] 
system_data_types.7: Add double_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofloat_t.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 25 Sep 2020 07:31:36 +0000 (09:31 +0200)] 
float_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>
4 years agosystem_data_types.7: Add float_t
Alejandro Colomar [Fri, 25 Sep 2020 11:19:23 +0000 (13:19 +0200)] 
system_data_types.7: Add float_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Fri, 25 Sep 2020 08:03:30 +0000 (10:03 +0200)] 
system_data_types.7: srcfix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoseccomp.2: Use ARRAY_SIZE() macro instead of raw sizeof division
Alejandro Colomar [Fri, 25 Sep 2020 07:31:40 +0000 (09:31 +0200)] 
seccomp.2: Use ARRAY_SIZE() macro instead of raw sizeof division

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoseccomp.2: Remove unneeded cast
Alejandro Colomar [Fri, 25 Sep 2020 07:31:39 +0000 (09:31 +0200)] 
seccomp.2: Remove unneeded cast

From the email discussion:

> Hi Alex,
>
> On 9/25/20 9:31 AM, Alejandro Colomar wrote:
>> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
>> ---
>>   man2/seccomp.2 | 2 +-
>>   1 file changed, 1 insertion(+), 1 deletion(-)
>>
>> diff --git a/man2/seccomp.2 b/man2/seccomp.2
>> index 58033da1c..d6b856c32 100644
>> --- a/man2/seccomp.2
>> +++ b/man2/seccomp.2
>> @@ -1101,7 +1101,7 @@ install_filter(int syscall_nr, int t_arch, int f_errno)
>>       };
>>
>>       struct sock_fprog prog = {
>> -        .len = (unsigned short) (sizeof(filter) / sizeof(filter[0])),
>> +        .len = sizeof(filter) / sizeof(filter[0]),
>>           .filter = filter,
>>       };
>
> I have a small doubt about this change. With the change,
> there are no compilation warnings.
>
> But, if we change the code to something slightly different:
>
> [[
>      size_t x = (sizeof(filter) / sizeof(filter[0]));
>      struct sock_fprog prog = {
>          .len = x,
>          .filter = filter,
>      };
> ]]
>
> The "cc -Wconversion" gives us the following warning:
>
>      warning: conversion from ‘size_t’ {aka ‘long unsigned int’}
>      to ‘short unsigned int’ may change value
>
> Presumably we don't get a warning for an assignment of the form
>
>      .len = (sizeof(filter) / sizeof(filter[0]))
>
> because the compiler is smart enough to work out that the
> value of the constant expression is within the range of
> "unsigned short".
>
> Your thoughts?

Hi Michael,

I'd say that the cast doesn't fix any problems at all.  It silences a
valid warning, and I'd use a pragma for that (to be more explicit about
the intention of silencing a warning) if I do want -Wconversion enabled
(which usually I don't want, because it's too noisy) and I'm sure that
this won't overflow.  I'd limit the use casts to only when I *really*
need to.

I guess that if you enable -O3, the warning will vanish again because
the compiler will optimize away 'x' (but I didn't test).

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolconv.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 25 Sep 2020 07:31:34 +0000 (09:31 +0200)] 
lconv.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>
4 years agosystem_data_types.7: Add lconv
Alejandro Colomar [Fri, 25 Sep 2020 07:31:33 +0000 (09:31 +0200)] 
system_data_types.7: Add lconv

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetgrent_r.3: Declare variables with different types in different lines
Alejandro Colomar [Fri, 25 Sep 2020 07:31:41 +0000 (09:31 +0200)] 
getgrent_r.3: Declare variables with different types in different lines

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: ffix
Alejandro Colomar [Fri, 25 Sep 2020 07:31:32 +0000 (09:31 +0200)] 
system_data_types.7: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolldiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 10:13:09 +0000 (12:13 +0200)] 
lldiv_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>
4 years agosystem_data_types.7: Add lldiv_t
Alejandro Colomar [Thu, 24 Sep 2020 10:13:08 +0000 (12:13 +0200)] 
system_data_types.7: Add lldiv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoldiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 10:13:07 +0000 (12:13 +0200)] 
ldiv_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>
4 years agosystem_data_types.7: Add ldiv_t
Alejandro Colomar [Thu, 24 Sep 2020 10:13:06 +0000 (12:13 +0200)] 
system_data_types.7: Add ldiv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agodiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 10:13:05 +0000 (12:13 +0200)] 
div_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>
4 years agosystem_data_types.7: Add div_t
Alejandro Colomar [Thu, 24 Sep 2020 10:13:04 +0000 (12:13 +0200)] 
system_data_types.7: Add div_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoimaxdiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 09:58:55 +0000 (11:58 +0200)] 
imaxdiv_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>
4 years agosystem_data_types.7: Add imaxdiv_t
Alejandro Colomar [Thu, 24 Sep 2020 09:58:54 +0000 (11:58 +0200)] 
system_data_types.7: Add imaxdiv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrfromd.3: tfix
Michael Kerrisk [Thu, 24 Sep 2020 08:02:00 +0000 (10:02 +0200)] 
strfromd.3: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocore.5: srcfix
Michael Kerrisk [Thu, 24 Sep 2020 08:00:16 +0000 (10:00 +0200)] 
core.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocore.5: ffix
Michael Kerrisk [Thu, 24 Sep 2020 07:59:57 +0000 (09:59 +0200)] 
core.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>