Various pages: Normalize NOTES about nonexistent glibc wrappers

See previous commit.

This commit normalizes texts under sections other than SYNOPSIS
(most of them in NOTES).

Signed-off-by: Ganimedes Colomar <gacoan.linux@gmail.com>
Cowritten-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Ganimedes Colomar 2020-12-30 16:20:26 +01:00 committed by Michael Kerrisk
parent 632d115294
commit 16cc03ca92
20 changed files with 26 additions and 31 deletions

View File

@ -216,7 +216,7 @@ This system call first appeared in Linux 2.6.10.
.SH CONFORMING TO
This system call is a nonstandard Linux extension.
.SH NOTES
No wrapper for this system call is provided in glibc.
Glibc does not provide a wrapper for this system call.
A wrapper is provided in the
.IR libkeyutils
package.

View File

@ -177,10 +177,8 @@ and
in the same thread is dangerous, as they may overwrite each other's
TLS entries.
.PP
As of version 2.7, glibc provides no prototype for
.BR arch_prctl ().
You have to declare it yourself for now.
This may be fixed in future glibc versions.
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.PP
.I FS
may be already used by the threading library.

View File

@ -211,13 +211,13 @@ SVr4.
Library support for
.BR getdents64 ()
was added in glibc 2.30;
there is no glibc wrapper for
.BR getdents ().
Calling
Glibc does not provide a wrapper for
.BR getdents ();
call
.BR getdents ()
(or
.BR getdents64 ()
on earlier glibc versions) requires the use of
on earlier glibc versions) using
.BR syscall (2).
In that case you will need to define the
.I linux_dirent

View File

@ -68,7 +68,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used
in programs that are intended to be portable.
.SH NOTES
Glibc does not provide a wrapper function for this system call.
Glibc does not provide a wrapper for this system call.
You could invoke it using
.BR syscall (2).
But instead, you probably want to use the

View File

@ -57,7 +57,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used in programs
that are intended to be portable.
.SH NOTES
Glibc does not provide a wrapper function for this system call.
Glibc does not provide a wrapper for this system call.
You could invoke it using
.BR syscall (2).
But instead, you probably want to use the

View File

@ -94,7 +94,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used in
programs that are intended to be portable.
.SH NOTES
Glibc does not provide a wrapper function for this system call.
Glibc does not provide a wrapper for this system call.
You could invoke it using
.BR syscall (2).
But instead, you probably want to use the

View File

@ -72,7 +72,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used in programs
that are intended to be portable.
.SH NOTES
Glibc does not provide a wrapper function for this system call.
Glibc does not provide a wrapper for this system call.
You could invoke it using
.BR syscall (2).
But instead, you probably want to use the

View File

@ -247,7 +247,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
is Linux-specific and should not be used in
programs that are intended to be portable.
.SH NOTES
Glibc does not provide a wrapper function for this system call.
Glibc does not provide a wrapper for this system call.
You could invoke it using
.BR syscall (2).
But instead, you probably want to use the

View File

@ -335,8 +335,7 @@ system call first appeared in Linux 3.17.
.SH CONFORMING TO
These system calls are Linux-specific.
.SH NOTES
Currently, there is no glibc support for these system calls.
Call them using
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.SH SEE ALSO
.BR reboot (2),

View File

@ -1953,7 +1953,7 @@ This system call first appeared in Linux 2.6.10.
.SH CONFORMING TO
This system call is a nonstandard Linux extension.
.SH NOTES
No wrapper for this system call is provided in glibc.
Glibc does not provide a wrapper for this system call.
A wrapper is provided in the
.IR libkeyutils
library.

View File

@ -121,7 +121,7 @@ first appeared in Linux 5.6.
.BR pidfd_getfd ()
is Linux specific.
.SH NOTES
Currently, there is no glibc wrapper for this system call; call it using
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.PP
For a description of PID file descriptors, see

View File

@ -91,7 +91,7 @@ first appeared in Linux 5.3.
.BR pidfd_open ()
is Linux specific.
.SH NOTES
Currently, there is no glibc wrapper for this system call; call it using
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.PP
The following code sequence can be used to obtain a file descriptor

View File

@ -135,7 +135,7 @@ first appeared in Linux 5.1.
.BR pidfd_send_signal ()
is Linux specific.
.SH NOTES
Currently, there is no glibc wrapper for this system call; call it using
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.\"
.SS PID file descriptors

View File

@ -439,7 +439,7 @@ in Linux 2.6.13.
.SH CONFORMING TO
This system call is a nonstandard Linux extension.
.SH NOTES
No wrapper for this system call is provided in glibc.
Glibc does not provide a wrapper for this system call.
A wrapper is provided in the
.IR libkeyutils
package.

View File

@ -144,9 +144,8 @@ This Linux-specific system call is available only on the s390 architecture.
.PP
The guarded storage facility is available beginning with System z14.
.SH NOTES
Glibc does not provide a wrapper for this system call, use
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2)
to call it.
.PP
The description of the guarded storage facility along with related
instructions and Guarded Storage Control Block and

View File

@ -103,8 +103,7 @@ These system calls are available since Linux 3.19.
This Linux-specific system call is available only on the s390 architecture.
The required PCI support is available beginning with System z EC12.
.SH NOTES
Glibc does not provide a wrapper for this system call, use
Glibc does not provide wrappers for these system calls; call them using
.BR syscall (2)
to call it.
.SH SEE ALSO
.BR syscall (2)

View File

@ -97,9 +97,8 @@ This Linux-specific system call is available only on the s390 architecture.
The run-time instrumentation facility is available
beginning with System z EC12.
.SH NOTES
Glibc does not provide a wrapper for this system call, use
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2)
to call it.
.PP
The
.I asm/runtime_instr.h

View File

@ -126,9 +126,8 @@ This system call is available since Linux 4.15.
.SH CONFORMING TO
This Linux-specific system call is available only on the s390 architecture.
.SH NOTES
Glibc does not provide a wrapper for this system call, use
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2)
to call it.
.PP
For details of the STHYI instruction, see
.UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm

View File

@ -858,6 +858,9 @@ Tile (since Linux 4.3)
PA-RISC (since Linux 4.6)
.\" User mode Linux since Linux 4.6
.PD
.PP
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.\"
.SS Caveats
There are various subtleties to consider when applying seccomp filters

View File

@ -120,8 +120,7 @@ Note that on older kernels where this system call still exists,
it is available only if the kernel was configured with the
.B CONFIG_SYSCTL_SYSCALL
option.
Furthermore,
glibc does not provide a wrapper for this system call,
Furthermore, glibc does not provide a wrapper for this system call,
necessitating the use of
.BR syscall (2).
.SH BUGS