sigsuspend(3P) INTERACTIVE UNIX System (POSIX) sigsuspend(3P)
NAME
sigsuspend - wait for a signal
SYNOPSIS
int sigsuspend (sigmask)
sigset_t *sigmask;
DESCRIPTION
The sigsuspend() function replaces the process's signal mask
with the set of signals pointed to by the argument sigmask
and then suspends the process until delivery of a signal
whose action is either to execute a signal-catching function
or to terminate the process.
If the action is to terminate the process, the sigsuspend()
function does not return. If the action is to execute a
signal-catching function, the sigsuspend() returns after the
signal-catching function returns, with the signal mask
restored to the set that existed prior to the sigsuspend()
call.
It is not possible to block SIGKILL and SIGSTOP, which are
signals that cannot be ignored. This is enforced by the
system without causing an error to be indicated.
DIAGNOSTICS
After successful completion, a value of 0 is returned. Oth-
erwise, a value of -1 is returned and errno is set to indi-
cate the error. If a signal is caught by the calling pro-
cess and control is returned from the signal-catching func-
tion, the function returns -1, and errno is set to EINTR.
Rev. 1.1 Page 1