diff options
Diffstat (limited to 'man3/sigpause.3')
-rw-r--r-- | man3/sigpause.3 | 57 |
1 files changed, 27 insertions, 30 deletions
diff --git a/man3/sigpause.3 b/man3/sigpause.3 index a65ef208b..492d9fabc 100644 --- a/man3/sigpause.3 +++ b/man3/sigpause.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigpause 3 2023-02-05 "Linux man-pages 6.03" +.TH sigpause 3 2023-07-20 "Linux man-pages 6.05.01" .SH NAME sigpause \- atomically release blocked signals and wait for interrupt .SH LIBRARY @@ -13,9 +13,9 @@ Standard C library .nf .B #include <signal.h> .PP -.BI "int sigpause(int " sigmask "); /* BSD (but see NOTES) */" +.BI "[[deprecated]] int sigpause(int " sigmask "); /* BSD (but see NOTES) */" .PP -.BI "int sigpause(int " sig "); /* System V / UNIX 95 */" +.BI "[[deprecated]] int sigpause(int " sig "); /* POSIX.1 / SysV / UNIX 95 */" .fi .SH DESCRIPTION Don't use this function. @@ -40,19 +40,17 @@ set to .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). -.ad l -.nh .TS allbox; lbx lb lb l l l. Interface Attribute Value T{ +.na +.nh .BR sigpause () T} Thread safety MT-Safe .TE -.hy -.ad .sp 1 .\" FIXME: The marking is different from that in the glibc manual, .\" marking in glibc manual is more detailed: @@ -62,29 +60,7 @@ T} Thread safety MT-Safe .\" glibc manual says /!linux!bsd indicate the preceding marker only applies .\" when the underlying kernel is neither Linux nor a BSD kernel. .\" So, it is safe in Linux kernel. -.SH STANDARDS -The System V version of -.BR sigpause () -is standardized in POSIX.1-2001. -It is also specified in POSIX.1-2008, where it is marked obsolete. -.SH NOTES -.SS History -The classical BSD version of this function appeared in 4.2BSD. -It sets the process's signal mask to -.IR sigmask . -UNIX 95 standardized the incompatible System V version of -this function, which removes only the specified signal -.I sig -from the process's signal mask. -.\" __xpg_sigpause: UNIX 95, spec 1170, SVID, SVr4, XPG -The unfortunate situation with two incompatible functions with the -same name was solved by the -.BR \%sigsuspend (2) -function, that takes a -.I "sigset_t\ *" -argument (instead of an -.IR int ). -.SS Linux notes +.SH VERSIONS On Linux, this routine is a system call only on the Sparc (sparc64) architecture. .PP @@ -119,6 +95,27 @@ should be amended to use .\" For the BSD version, one usually uses a zero .\" .I sigmask .\" to indicate that no signals are to be blocked. +.SH STANDARDS +POSIX.1-2008. +.SH HISTORY +POSIX.1-2001. +Obsoleted in POSIX.1-2008. +.PP +The classical BSD version of this function appeared in 4.2BSD. +It sets the process's signal mask to +.IR sigmask . +UNIX 95 standardized the incompatible System V version of +this function, which removes only the specified signal +.I sig +from the process's signal mask. +.\" __xpg_sigpause: UNIX 95, spec 1170, SVID, SVr4, XPG +The unfortunate situation with two incompatible functions with the +same name was solved by the +.BR \%sigsuspend (2) +function, that takes a +.I "sigset_t\ *" +argument (instead of an +.IR int ). .SH SEE ALSO .BR kill (2), .BR sigaction (2), |