SIGSUSPEND(2P) SIGSUSPEND(2P)
NAME
sigsuspend - wait for a signal
SYNOPSIS
#include <signal.h>
int sigsuspend(sigmask)
sigsett *sigmask;
DESCRIPTION
sigsuspend replaces the process's signal mask with the set
of signals pointed to by 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, sigsuspend will
not return. If the action is to execute a signal-catching
function, sigsuspend will return after the signal-catching
function returns, with the signal mask restored to the set
that existed prior to the sigsuspend call.
SIGKILL and SIGSTOP cannot be caught or ignored. SIGCONT
cannot be ignored. It is not possible to block these
signals. This is silently enforced.
RETURN VALUE
Since sigsuspend suspends process execution indefinitely,
there is no successful completion return value. If
sigsuspend returns, it will return -1 and errno will be set
to indicate the error.
ERRORS
If the following condition occurs, sigsuspend will return -1
and set errno to the corresponding value:
[EINTR] A signal is caught by the calling process and
control is returned from the signal-catching
function.
Page 1 May 1989
SIGSUSPEND(2P) SIGSUSPEND(2P)
SEE ALSO
pause(2), sigaction(2), sigsetops(2), sigpending(2),
sigprocmask(2).
Page 2 May 1989