NAME

sigsuspend − wait for a signal

SYNOPSIS

#include <signal.h>

int sigsuspend  ( sigmask )
sigset_t *sigmask ;

DESCRIPTION

Sigsuspend replaces the process’s current signal mask with the set of signals pointed to by sigmask, and then suspends the process until delivery of a signal that either executes a signal handler or terminates the process. 

If the signal terminates the process, sigsuspend never returns. If the signal executes a signal handler, sigsuspend returns after the signal handler returns, and restores the signal mask to the set that existed prior to the sigsuspend call. 

It is impossible to block the SIGKILL or SIGSTOP signal. This is enforced by the system without causing an error to be indicated. 

RETURN VALUE

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

ERRORS

Sigsuspend fails if one or more of the following is true:

­[EINTR] Sigsuspend was interrupted by receipt of a signal. 

­[EFAULT] Sigmask points to an invalid address. The reliable detection of this error is implementation dependent. 

AUTHOR

Sigsuspend was derived from the IEEE Standard POSIX 1003.1-1988. 

SEE ALSO

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

STANDARDS CONFORMANCE

sigsuspend: XPG3, POSIX.1, FIPS 151-1

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989