diff options
Diffstat (limited to 'man2/sigprocmask.2')
| -rw-r--r-- | man2/sigprocmask.2 | 40 |
1 files changed, 20 insertions, 20 deletions
diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2 index a89c1ed..f0017b4 100644 --- a/man2/sigprocmask.2 +++ b/man2/sigprocmask.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigprocmask 2 2023-03-30 "Linux man-pages 6.05.01" +.TH sigprocmask 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigprocmask, rt_sigprocmask \- examine and change blocked signals .SH LIBRARY @@ -14,33 +14,33 @@ Standard C library .RI ( libc ", " \-lc ) .SH SYNOPSIS .B #include <signal.h> -.PP +.P .nf /* Prototype for the glibc wrapper function */ .BI "int sigprocmask(int " how ", const sigset_t *_Nullable restrict " set , .BI " sigset_t *_Nullable restrict " oldset ); -.PP +.P .BR "#include <signal.h>" " /* Definition of " SIG_* " constants */" .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> -.PP +.P /* Prototype for the underlying system call */ .BI "int syscall(SYS_rt_sigprocmask, int " how , .BI " const kernel_sigset_t *_Nullable " set , .BI " kernel_sigset_t *_Nullable " oldset , .BI " size_t " sigsetsize ); -.PP +.P /* Prototype for the legacy system call */ .BI "[[deprecated]] int syscall(SYS_sigprocmask, int " how , .BI " const old_kernel_sigset_t *_Nullable " set , .BI " old_kernel_sigset_t *_Nullable " oldset ); .fi -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .BR sigprocmask (): .nf _POSIX_C_SOURCE @@ -53,7 +53,7 @@ blocked for the caller (see also .BR signal (7) for more details). -.PP +.P The behavior of the call is dependent on the value of .IR how , as follows. @@ -72,12 +72,12 @@ It is permissible to attempt to unblock a signal which is not blocked. .B SIG_SETMASK The set of blocked signals is set to the argument .IR set . -.PP +.P If .I oldset is non-NULL, the previous value of the signal mask is stored in .IR oldset . -.PP +.P If .I set is NULL, then the signal mask is unchanged (i.e., @@ -86,12 +86,12 @@ is ignored), but the current value of the signal mask is nevertheless returned in .I oldset (if it is not NULL). -.PP +.P A set of functions for modifying and inspecting variables of type .I sigset_t ("signal sets") is described in .BR sigsetops (3). -.PP +.P The use of .BR sigprocmask () is unspecified in a multithreaded process; see @@ -127,7 +127,7 @@ In this manual page, the former is referred to as (it is nevertheless named .I sigset_t in the kernel sources). -.PP +.P The glibc wrapper function for .BR sigprocmask () silently ignores attempts to block the two real-time signals that @@ -135,7 +135,7 @@ are used internally by the NPTL threading implementation. See .BR nptl (7) for details. -.PP +.P The original Linux system call was named .BR sigprocmask (). However, with the addition of real-time signals in Linux 2.2, @@ -164,7 +164,7 @@ This argument is currently required to have a fixed architecture specific value .IR sizeof(kernel_sigset_t) ). .\" sizeof(kernel_sigset_t) == _NSIG / 8, .\" which equals to 8 on most architectures, but e.g. on MIPS it's 16. -.PP +.P The glibc .BR sigprocmask () wrapper function hides these details from us, transparently calling @@ -179,15 +179,15 @@ POSIX.1-2001. It is not possible to block .BR SIGKILL " or " SIGSTOP . Attempts to do so are silently ignored. -.PP +.P Each of the threads in a process has its own signal mask. -.PP +.P A child created via .BR fork (2) inherits a copy of its parent's signal mask; the signal mask is preserved across .BR execve (2). -.PP +.P If .BR SIGBUS , .BR SIGFPE , @@ -201,11 +201,11 @@ unless the signal was generated by .BR sigqueue (3), or .BR raise (3). -.PP +.P See .BR sigsetops (3) for details on manipulating signal sets. -.PP +.P Note that it is permissible (although not very useful) to specify both .I set and |