sigpending.2 (2010 09)

s
sigpending(2) sigpending(2)
NAME
sigpending - examine pending signals
SYNOPSIS
#include <signal.h>
int sigpending(sigset_t *set);
DESCRIPTION
sigpending() stores the set of signals that are blocked from delivery and are pending to the calling
thread, at the location pointed to by set.
RETURN VALUE
Upon successful completion,
sigpending() returns 0. Otherwise −1 is returned and
errno is set to
indicate the error.
ERRORS
sigpending() fails if the following condition is encountered:
[EFAULT] set points to an invalid address. The reliable detection of this error is implementation-
dependent.
APPLICATION USAGE
Threads Considerations
The set of signals returned by
sigpending() is the union of the signals pending on the process and
calling thread. A signal may be pending on the process if all threads block the signal.
The set of signals returned by
sigpending() is only advisory. Since other threads may be executing
at the time of the call, a signal pending on the process may be delivered to a thread after this system call
returns.
For more information regarding signals and threads, refer to signal (5).
LWP (Lightweight Processes) Considerations
The set of signals returned by sigpending() is the union of the signals pending on the process and
calling LWP.
AUTHOR
sigpending() was derived from the IEEE POSIX 1003.1-1988 Standard.
SEE ALSO
sigaction(2), sigsuspend(2), sigprocmask(2), sigsetops(3C), signal(5).
CHANGE HISTORY
First release in Issue 3.
STANDARDS CONFORMANCE
sigpending() : AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1