sigsuspend(2) sigsuspend(2) NAME sigsuspend - wait for a signal SYNOPSIS #include <signal.h> int sigsuspend(const sigset_t *sigmask); DESCRIPTION The sigsuspend() function replaces the process' current 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 then sigsuspend() will never return. If the action is to execute a signal-catching function, then sigsuspend() will return 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 signals that cannot be ignored. This is enforced by the system without causing an error to be indicated. RETURN VALUE Since sigsuspend() suspends process execution indefinitely, there is no successful completion return value. If a return occurs, -1 is returned and errno is set to indicate the error. ERRORS The sigsuspend() function will fail if: [EINTR] A signal is caught by the calling process and control is returned from the signal-catching function. SEE ALSO pause(), sigaction(), sigaddset(), sigdelset(), sigemptyset(), sigfillset(), <signal.h>. CHANGE HISTORY First released in Issue 3. Entry included for alignment with the POSIX.1-1988 standard. Issue 4 The following change is incorporated for alignment with the ISO POSIX-1 standard: o The type of the argument sigmask is changed from sigset_t* to type constsigset_t*. Hewlett-Packard Company - 1 - HP-UX Release 10.20: July 1996 sigsuspend(2) sigsuspend(2) Another change is incorporated as follows: o The term "signal handler" is changed to "signal-catching function." - 2 - Formatted: April 25, 2001 sigsuspend(2) sigsuspend(2) HP-UX EXTENSIONS ERRORS [EFAULT] sigmask points to an invalid address. The reliable detection of this error is implementation dependent. AUTHOR sigsuspend() was derived from the IEEE POSIX 1003.1-1988 Standard. SEE ALSO sigaction(2), sigpending(2), sigprocmask(2), sigsetops(3C), signal(5). STANDARDS CONFORMANCE sigsuspend(): AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1 Hewlett-Packard Company - 1 - HP-UX Release 10.20: July 1996