NAME

sigsuspend − wait for a signal

SYNOPSIS

#include <signal.h>

int sigsuspend (sigmask)
sigset_t ∗sigmask;

DESCRIPTION

The POSIX 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 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. 

NOTES

It is not possible to block SIGKILL or SIGSTOP.  This is silently enforced. 

RETURN VALUE

Since the sigsuspend function suspends process execution indefinitely, there is no successful completion return value.  A value of −1 is returned and errno is set to indicate the error. 

ERRORS

If the following condition occurs, the sigsuspend function will return −1 and set errno to the following value:

[EINTR] A signal was caught by the calling process and control has returned from the signal-catching function. 

SEE ALSO

pause(2), sigaction(2), sigpending(2), sigprocmask(2), sigsetops(3C), signal(5). 

CX/UX Programmer’s Reference Manual