mirror of https://github.com/mkerrisk/man-pages
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:
parent
632d115294
commit
16cc03ca92
|
@ -216,7 +216,7 @@ This system call first appeared in Linux 2.6.10.
|
||||||
.SH CONFORMING TO
|
.SH CONFORMING TO
|
||||||
This system call is a nonstandard Linux extension.
|
This system call is a nonstandard Linux extension.
|
||||||
.SH NOTES
|
.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
|
A wrapper is provided in the
|
||||||
.IR libkeyutils
|
.IR libkeyutils
|
||||||
package.
|
package.
|
||||||
|
|
|
@ -177,10 +177,8 @@ and
|
||||||
in the same thread is dangerous, as they may overwrite each other's
|
in the same thread is dangerous, as they may overwrite each other's
|
||||||
TLS entries.
|
TLS entries.
|
||||||
.PP
|
.PP
|
||||||
As of version 2.7, glibc provides no prototype for
|
Glibc does not provide a wrapper for this system call; call it using
|
||||||
.BR arch_prctl ().
|
.BR syscall (2).
|
||||||
You have to declare it yourself for now.
|
|
||||||
This may be fixed in future glibc versions.
|
|
||||||
.PP
|
.PP
|
||||||
.I FS
|
.I FS
|
||||||
may be already used by the threading library.
|
may be already used by the threading library.
|
||||||
|
|
|
@ -211,13 +211,13 @@ SVr4.
|
||||||
Library support for
|
Library support for
|
||||||
.BR getdents64 ()
|
.BR getdents64 ()
|
||||||
was added in glibc 2.30;
|
was added in glibc 2.30;
|
||||||
there is no glibc wrapper for
|
Glibc does not provide a wrapper for
|
||||||
.BR getdents ().
|
.BR getdents ();
|
||||||
Calling
|
call
|
||||||
.BR getdents ()
|
.BR getdents ()
|
||||||
(or
|
(or
|
||||||
.BR getdents64 ()
|
.BR getdents64 ()
|
||||||
on earlier glibc versions) requires the use of
|
on earlier glibc versions) using
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
In that case you will need to define the
|
In that case you will need to define the
|
||||||
.I linux_dirent
|
.I linux_dirent
|
||||||
|
|
|
@ -68,7 +68,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
|
||||||
is Linux-specific and should not be used
|
is Linux-specific and should not be used
|
||||||
in programs that are intended to be portable.
|
in programs that are intended to be portable.
|
||||||
.SH NOTES
|
.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
|
You could invoke it using
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
But instead, you probably want to use the
|
But instead, you probably want to use the
|
||||||
|
|
|
@ -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
|
is Linux-specific and should not be used in programs
|
||||||
that are intended to be portable.
|
that are intended to be portable.
|
||||||
.SH NOTES
|
.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
|
You could invoke it using
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
But instead, you probably want to use the
|
But instead, you probably want to use the
|
||||||
|
|
|
@ -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
|
is Linux-specific and should not be used in
|
||||||
programs that are intended to be portable.
|
programs that are intended to be portable.
|
||||||
.SH NOTES
|
.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
|
You could invoke it using
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
But instead, you probably want to use the
|
But instead, you probably want to use the
|
||||||
|
|
|
@ -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
|
is Linux-specific and should not be used in programs
|
||||||
that are intended to be portable.
|
that are intended to be portable.
|
||||||
.SH NOTES
|
.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
|
You could invoke it using
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
But instead, you probably want to use the
|
But instead, you probably want to use the
|
||||||
|
|
|
@ -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
|
is Linux-specific and should not be used in
|
||||||
programs that are intended to be portable.
|
programs that are intended to be portable.
|
||||||
.SH NOTES
|
.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
|
You could invoke it using
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
But instead, you probably want to use the
|
But instead, you probably want to use the
|
||||||
|
|
|
@ -335,8 +335,7 @@ system call first appeared in Linux 3.17.
|
||||||
.SH CONFORMING TO
|
.SH CONFORMING TO
|
||||||
These system calls are Linux-specific.
|
These system calls are Linux-specific.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Currently, there is no glibc support for these system calls.
|
Glibc does not provide a wrapper for this system call; call it using
|
||||||
Call them using
|
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR reboot (2),
|
.BR reboot (2),
|
||||||
|
|
|
@ -1953,7 +1953,7 @@ This system call first appeared in Linux 2.6.10.
|
||||||
.SH CONFORMING TO
|
.SH CONFORMING TO
|
||||||
This system call is a nonstandard Linux extension.
|
This system call is a nonstandard Linux extension.
|
||||||
.SH NOTES
|
.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
|
A wrapper is provided in the
|
||||||
.IR libkeyutils
|
.IR libkeyutils
|
||||||
library.
|
library.
|
||||||
|
|
|
@ -121,7 +121,7 @@ first appeared in Linux 5.6.
|
||||||
.BR pidfd_getfd ()
|
.BR pidfd_getfd ()
|
||||||
is Linux specific.
|
is Linux specific.
|
||||||
.SH NOTES
|
.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).
|
.BR syscall (2).
|
||||||
.PP
|
.PP
|
||||||
For a description of PID file descriptors, see
|
For a description of PID file descriptors, see
|
||||||
|
|
|
@ -91,7 +91,7 @@ first appeared in Linux 5.3.
|
||||||
.BR pidfd_open ()
|
.BR pidfd_open ()
|
||||||
is Linux specific.
|
is Linux specific.
|
||||||
.SH NOTES
|
.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).
|
.BR syscall (2).
|
||||||
.PP
|
.PP
|
||||||
The following code sequence can be used to obtain a file descriptor
|
The following code sequence can be used to obtain a file descriptor
|
||||||
|
|
|
@ -135,7 +135,7 @@ first appeared in Linux 5.1.
|
||||||
.BR pidfd_send_signal ()
|
.BR pidfd_send_signal ()
|
||||||
is Linux specific.
|
is Linux specific.
|
||||||
.SH NOTES
|
.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).
|
.BR syscall (2).
|
||||||
.\"
|
.\"
|
||||||
.SS PID file descriptors
|
.SS PID file descriptors
|
||||||
|
|
|
@ -439,7 +439,7 @@ in Linux 2.6.13.
|
||||||
.SH CONFORMING TO
|
.SH CONFORMING TO
|
||||||
This system call is a nonstandard Linux extension.
|
This system call is a nonstandard Linux extension.
|
||||||
.SH NOTES
|
.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
|
A wrapper is provided in the
|
||||||
.IR libkeyutils
|
.IR libkeyutils
|
||||||
package.
|
package.
|
||||||
|
|
|
@ -144,9 +144,8 @@ This Linux-specific system call is available only on the s390 architecture.
|
||||||
.PP
|
.PP
|
||||||
The guarded storage facility is available beginning with System z14.
|
The guarded storage facility is available beginning with System z14.
|
||||||
.SH NOTES
|
.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)
|
.BR syscall (2)
|
||||||
to call it.
|
|
||||||
.PP
|
.PP
|
||||||
The description of the guarded storage facility along with related
|
The description of the guarded storage facility along with related
|
||||||
instructions and Guarded Storage Control Block and
|
instructions and Guarded Storage Control Block and
|
||||||
|
|
|
@ -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.
|
This Linux-specific system call is available only on the s390 architecture.
|
||||||
The required PCI support is available beginning with System z EC12.
|
The required PCI support is available beginning with System z EC12.
|
||||||
.SH NOTES
|
.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)
|
.BR syscall (2)
|
||||||
to call it.
|
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR syscall (2)
|
.BR syscall (2)
|
||||||
|
|
|
@ -97,9 +97,8 @@ This Linux-specific system call is available only on the s390 architecture.
|
||||||
The run-time instrumentation facility is available
|
The run-time instrumentation facility is available
|
||||||
beginning with System z EC12.
|
beginning with System z EC12.
|
||||||
.SH NOTES
|
.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)
|
.BR syscall (2)
|
||||||
to call it.
|
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.I asm/runtime_instr.h
|
.I asm/runtime_instr.h
|
||||||
|
|
|
@ -126,9 +126,8 @@ This system call is available since Linux 4.15.
|
||||||
.SH CONFORMING TO
|
.SH CONFORMING TO
|
||||||
This Linux-specific system call is available only on the s390 architecture.
|
This Linux-specific system call is available only on the s390 architecture.
|
||||||
.SH NOTES
|
.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)
|
.BR syscall (2)
|
||||||
to call it.
|
|
||||||
.PP
|
.PP
|
||||||
For details of the STHYI instruction, see
|
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
|
.UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm
|
||||||
|
|
|
@ -858,6 +858,9 @@ Tile (since Linux 4.3)
|
||||||
PA-RISC (since Linux 4.6)
|
PA-RISC (since Linux 4.6)
|
||||||
.\" User mode Linux since Linux 4.6
|
.\" User mode Linux since Linux 4.6
|
||||||
.PD
|
.PD
|
||||||
|
.PP
|
||||||
|
Glibc does not provide a wrapper for this system call; call it using
|
||||||
|
.BR syscall (2).
|
||||||
.\"
|
.\"
|
||||||
.SS Caveats
|
.SS Caveats
|
||||||
There are various subtleties to consider when applying seccomp filters
|
There are various subtleties to consider when applying seccomp filters
|
||||||
|
|
|
@ -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
|
it is available only if the kernel was configured with the
|
||||||
.B CONFIG_SYSCTL_SYSCALL
|
.B CONFIG_SYSCTL_SYSCALL
|
||||||
option.
|
option.
|
||||||
Furthermore,
|
Furthermore, glibc does not provide a wrapper for this system call,
|
||||||
glibc does not provide a wrapper for this system call,
|
|
||||||
necessitating the use of
|
necessitating the use of
|
||||||
.BR syscall (2).
|
.BR syscall (2).
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
|
|
Loading…
Reference in New Issue