readv.2, pthread_tryjoin_np.3, stailq.3, strlen.3, wcslen.3: Arrange .SH sections in correct order

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2021-08-18 07:38:15 +02:00
parent 85a7ae7344
commit dae872dd27
5 changed files with 37 additions and 37 deletions

View File

@ -406,6 +406,18 @@ that the system is running a Linux kernel older than version 2.6.18
And since glibc 2.20 And since glibc 2.20
(which requires a minimum Linux kernel version of 2.6.32), (which requires a minimum Linux kernel version of 2.6.32),
the glibc wrapper functions always just directly invoke the system calls. the glibc wrapper functions always just directly invoke the system calls.
.SH BUGS
Linux 5.9 and 5.10 have a bug where
.BR preadv2()
with the
.BR RWF_NOWAIT
flag may return 0 even when not at end of file.
.\" See
.\" <https://lore.kernel.org/linux-fsdevel/fea8b16d-5a69-40f9-b123-e84dcd6e8f2e@www.fastmail.com/T/#u>
.\" The bug was introduced in
.\" efa8480a831 fs: RWF_NOWAIT should imply IOCB_NOIO
.\"and fixed in
.\" 06c0444290 mm/filemap.c: generic_file_buffered_read() now uses find_get_pages_contig
.SH EXAMPLES .SH EXAMPLES
The following code sample demonstrates the use of The following code sample demonstrates the use of
.BR writev (): .BR writev ():
@ -425,18 +437,6 @@ iov[1].iov_len = strlen(str1);
nwritten = writev(STDOUT_FILENO, iov, 2); nwritten = writev(STDOUT_FILENO, iov, 2);
.EE .EE
.in .in
.SH BUGS
Linux 5.9 and 5.10 have a bug where
.BR preadv2()
with the
.BR RWF_NOWAIT
flag may return 0 even when not at end of file.
.\" See
.\" <https://lore.kernel.org/linux-fsdevel/fea8b16d-5a69-40f9-b123-e84dcd6e8f2e@www.fastmail.com/T/#u>
.\" The bug was introduced in
.\" efa8480a831 fs: RWF_NOWAIT should imply IOCB_NOIO
.\"and fixed in
.\" 06c0444290 mm/filemap.c: generic_file_buffered_read() now uses find_get_pages_contig
.SH SEE ALSO .SH SEE ALSO
.BR pread (2), .BR pread (2),
.BR read (2), .BR read (2),

View File

@ -140,6 +140,18 @@ T} Thread safety MT-Safe
.SH CONFORMING TO .SH CONFORMING TO
These functions are nonstandard GNU extensions; These functions are nonstandard GNU extensions;
hence the suffix "_np" (nonportable) in the names. hence the suffix "_np" (nonportable) in the names.
.SH BUGS
The
.BR pthread_timedjoin_np ()
function measures time by internally calculating a relative sleep interval
that is then measured against the
.BR CLOCK_MONOTONIC
clock instead of the
.BR CLOCK_REALTIME
clock.
Consequently, the timeout is unaffected by discontinuous changes to the
.BR CLOCK_REALTIME
clock.
.SH EXAMPLES .SH EXAMPLES
The following code waits to join for up to 5 seconds: The following code waits to join for up to 5 seconds:
.PP .PP
@ -162,18 +174,6 @@ if (s != 0) {
} }
.EE .EE
.in .in
.SH BUGS
The
.BR pthread_timedjoin_np ()
function measures time by internally calculating a relative sleep interval
that is then measured against the
.BR CLOCK_MONOTONIC
clock instead of the
.BR CLOCK_REALTIME
clock.
Consequently, the timeout is unaffected by discontinuous changes to the
.BR CLOCK_REALTIME
clock.
.SH SEE ALSO .SH SEE ALSO
.BR clock_gettime (2), .BR clock_gettime (2),
.BR pthread_exit (3), .BR pthread_exit (3),

View File

@ -309,6 +309,15 @@ returns an initializer that can be assigned to the queue
Not in POSIX.1, POSIX.1-2001, or POSIX.1-2008. Not in POSIX.1, POSIX.1-2001, or POSIX.1-2008.
Present on the BSDs Present on the BSDs
(STAILQ macros first appeared in 4.4BSD). (STAILQ macros first appeared in 4.4BSD).
.SH NOTES
Some BSDs provide SIMPLEQ instead of STAILQ.
They are identical, but for historical reasons
they were named differently on different BSDs.
STAILQ originated on FreeBSD, and SIMPLEQ originated on NetBSD.
For compatibility reasons, some systems provide both sets of macros.
Glibc provides both STAILQ and SIMPLEQ,
which are identical except for a missing SIMPLEQ equivalent to
.BR STAILQ_CONCAT ().
.SH BUGS .SH BUGS
.BR STAILQ_FOREACH () .BR STAILQ_FOREACH ()
doesn't allow doesn't allow
@ -321,15 +330,6 @@ fixes this limitation by allowing
.I var .I var
to safely be removed from the list and freed from within the loop to safely be removed from the list and freed from within the loop
without interfering with the traversal. without interfering with the traversal.
.SH NOTES
Some BSDs provide SIMPLEQ instead of STAILQ.
They are identical, but for historical reasons
they were named differently on different BSDs.
STAILQ originated on FreeBSD, and SIMPLEQ originated on NetBSD.
For compatibility reasons, some systems provide both sets of macros.
Glibc provides both STAILQ and SIMPLEQ,
which are identical except for a missing SIMPLEQ equivalent to
.BR STAILQ_CONCAT ().
.SH EXAMPLES .SH EXAMPLES
.EX .EX
#include <stddef.h> #include <stddef.h>

View File

@ -64,13 +64,13 @@ T} Thread safety MT-Safe
.hy .hy
.ad .ad
.sp 1 .sp 1
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C89, C99, C11, SVr4, 4.3BSD.
.SH NOTES .SH NOTES
In cases where the input buffer may not contain In cases where the input buffer may not contain
a terminating null byte, a terminating null byte,
.BR strnlen (3) .BR strnlen (3)
should be used instead. should be used instead.
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C89, C99, C11, SVr4, 4.3BSD.
.SH SEE ALSO .SH SEE ALSO
.BR string (3), .BR string (3),
.BR strnlen (3), .BR strnlen (3),

View File

@ -56,12 +56,12 @@ T} Thread safety MT-Safe
.hy .hy
.ad .ad
.sp 1 .sp 1
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C99.
.SH NOTES .SH NOTES
In cases where the input buffer may not contain In cases where the input buffer may not contain
a terminating null wide character, a terminating null wide character,
.BR wcsnlen (3) .BR wcsnlen (3)
should be used instead. should be used instead.
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C99.
.SH SEE ALSO .SH SEE ALSO
.BR strlen (3) .BR strlen (3)