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.
CHANGE HISTORY
First release in Issue 3.
STANDARDS CONFORMANCE
sigpending()
: AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1
Printable version
