]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/sigsetops.3
err.3: EXAMPLES: use EXIT_FAILURE rather than 1 as exit status
[thirdparty/man-pages.git] / man3 / sigsetops.3
index a2a3554401dd23a066a05842d6ef0d4e759b2176..81dd4a8caf8c515a648d27928e6cfe1196534aa9 100644 (file)
 .\" 2007-10-26 mdw   added wording that a sigset_t must be initialized
 .\"                  prior to use
 .\"
-.TH SIGSETOPS 3 2014-04-14 "Linux" "Linux Programmer's Manual"
+.TH SIGSETOPS 3 2016-03-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
 sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX
 signal set operations
 .SH SYNOPSIS
 .B #include <signal.h>
-.sp
+.PP
 .BI "int sigemptyset(sigset_t *" set );
-.sp
+.PP
 .BI "int sigfillset(sigset_t *" set );
-.sp
+.PP
 .BI "int sigaddset(sigset_t *" set ", int " signum );
-.sp
+.PP
 .BI "int sigdelset(sigset_t *" set ", int " signum );
-.sp
+.PP
 .BI "int sigismember(const sigset_t *" set ", int " signum );
-.sp
+.PP
 .in -4n
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
-.sp
+.PP
 .ad l
 .BR sigemptyset (),
 .BR sigfillset (),
@@ -57,7 +57,7 @@ Feature Test Macro Requirements for glibc (see
 .BR sigdelset (),
 .BR sigismember ():
 .RS 4
-_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
+_POSIX_C_SOURCE
 .RE
 .ad b
 .SH DESCRIPTION
@@ -120,37 +120,55 @@ is a member of
 0 if
 .I signum
 is not a member, and \-1 on error.
+.PP
 On error, these functions set
 .I errno
-to indicate the cause.
+to indicate the cause of the error.
 .SH ERRORS
 .TP
 .B EINVAL
-.I sig
+.I signum
 is not a valid signal.
 .SH ATTRIBUTES
-.SS Multithreading (see pthreads(7))
-The
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw31 lb lb
+l l l.
+Interface      Attribute       Value
+T{
 .BR sigemptyset (),
 .BR sigfillset (),
+.br
 .BR sigaddset (),
 .BR sigdelset (),
+.br
 .BR sigismember (),
 .BR sigisemptyset (),
+.br
 .BR sigorset (),
-and
 .BR sigandset ()
-functions are thread-safe.
+T}     Thread safety   MT-Safe
+.TE
 .SH CONFORMING TO
-POSIX.1-2001.
+POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
-.SS Glibc notes
+When creating a filled signal set, the glibc
+.BR sigfillset ()
+function does not include the two real-time signals used internally
+by the NPTL threading implementation.
+See
+.BR nptl (7)
+for details.
+.\"
+.SS Glibc extensions
 If the
 .B _GNU_SOURCE
 feature test macro is defined, then \fI<signal.h>\fP
 exposes three other functions for manipulating signal
 sets:
-
+.PP
 .nf
 .BI "int sigisemptyset(const sigset_t *" set );
 .BI "int sigorset(sigset_t *" dest ", const sigset_t *" left ,
@@ -158,12 +176,12 @@ sets:
 .BI "int sigandset(sigset_t *" dest ", const sigset_t *" left ,
 .BI "              const sigset_t *" right );
 .fi
-
+.PP
 .BR sigisemptyset ()
 returns 1 if
 .I set
 contains no signals, and 0 otherwise.
-
+.PP
 .BR sigorset ()
 places the union of the sets
 .I left