mirror of https://github.com/mkerrisk/man-pages
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:
parent
85a7ae7344
commit
dae872dd27
24
man2/readv.2
24
man2/readv.2
|
@ -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),
|
||||||
|
|
|
@ -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),
|
||||||
|
|
|
@ -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>
|
||||||
|
|
|
@ -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),
|
||||||
|
|
|
@ -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)
|
||||||
|
|
Loading…
Reference in New Issue