NAME
sigpending — examine pending signals
SYNOPSIS
#include <signal.h>
int sigpending(sigset_t *set);
DESCRIPTION
sigpending()
stores sets of signals that are blocked from delivery and are pending
to the calling process, 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
No errors are defined.
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.
CHANGE HISTORY
First release in Issue 3.
sigpending HP-UX EXTENSIONS
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.
AUTHOR
sigpending()
was derived from the
IEEE POSIX
1003.1-1988 Standard.
STANDARDS CONFORMANCE
sigpending()
: AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1