summaryrefslogtreecommitdiffstats
path: root/man7/nptl.7
diff options
context:
space:
mode:
Diffstat (limited to 'man7/nptl.7')
-rw-r--r--man7/nptl.750
1 files changed, 25 insertions, 25 deletions
diff --git a/man7/nptl.7 b/man7/nptl.7
index 1bff274d3..052f21b9a 100644
--- a/man7/nptl.7
+++ b/man7/nptl.7
@@ -16,7 +16,7 @@ NPTL makes internal use of the first two real-time signals
(signal numbers 32 and 33).
One of these signals is used to support thread cancelation and POSIX timers
(see
-.BR timer_create (2));
+.MR timer_create 2 );
the other is used as part of a mechanism that ensures all threads in
a process always have the same UIDs and GIDs, as required by POSIX.
These signals cannot be used in applications.
@@ -31,29 +31,29 @@ as follows:
is defined with the value 34 (rather than 32).
.IP \[bu]
The
-.BR sigwaitinfo (2),
-.BR sigtimedwait (2),
+.MR sigwaitinfo 2 ,
+.MR sigtimedwait 2 ,
and
-.BR sigwait (3)
+.MR sigwait 3
interfaces silently ignore requests to wait for these two signals
if they are specified in the signal set argument of these calls.
.IP \[bu]
The
-.BR sigprocmask (2)
+.MR sigprocmask 2
and
-.BR pthread_sigmask (3)
+.MR pthread_sigmask 3
interfaces silently ignore attempts to block these two signals.
.IP \[bu]
The
-.BR sigaction (2),
-.BR pthread_kill (3),
+.MR sigaction 2 ,
+.MR pthread_kill 3 ,
and
-.BR pthread_sigqueue (3)
+.MR pthread_sigqueue 3
interfaces fail with the error
.B EINVAL
(indicating an invalid signal number) if these signals are specified.
.IP \[bu]
-.BR sigfillset (3)
+.MR sigfillset 3
does not include these two signals when it creates a full signal set.
.\"
.SS NPTL and process credential changes
@@ -69,7 +69,7 @@ arrange for all other threads in the process to also change their credentials.
.P
The implementation of each of these system calls involves the use of
a real-time signal that is sent (using
-.BR tgkill (2))
+.MR tgkill 2 )
to each of the other threads that must change its credentials.
Before sending these signals, the thread that is changing credentials
saves the new credential(s) and records the system call being employed
@@ -78,22 +78,22 @@ A signal handler in the receiving thread(s) fetches this information and
then uses the same system call to change its credentials.
.P
Wrapper functions employing this technique are provided for
-.BR setgid (2),
-.BR setuid (2),
-.BR setegid (2),
-.BR seteuid (2),
-.BR setregid (2),
-.BR setreuid (2),
-.BR setresgid (2),
-.BR setresuid (2),
+.MR setgid 2 ,
+.MR setuid 2 ,
+.MR setegid 2 ,
+.MR seteuid 2 ,
+.MR setregid 2 ,
+.MR setreuid 2 ,
+.MR setresgid 2 ,
+.MR setresuid 2 ,
and
-.BR setgroups (2).
+.MR setgroups 2 .
.\" FIXME .
.\" Maybe say something about vfork() not being serialized wrt set*id() APIs?
.\" https://sourceware.org/bugzilla/show_bug.cgi?id=14749
.SH STANDARDS
For details of the conformance of NPTL to the POSIX standard, see
-.BR pthreads (7).
+.MR pthreads 7 .
.SH NOTES
POSIX says
.\" See POSIX.1-2008 specification of pthread_mutexattr_init()
@@ -106,7 +106,7 @@ is incompatible with the mutex definition for i386,
.\" See sysdeps/x86/bits/pthreadtypes.h
meaning that 32-bit and 64-bit binaries can't share mutexes on x86-64 systems.
.SH SEE ALSO
-.BR credentials (7),
-.BR pthreads (7),
-.BR signal (7),
-.BR standards (7)
+.MR credentials 7 ,
+.MR pthreads 7 ,
+.MR signal 7 ,
+.MR standards 7