sigsuspend(3P)                                     sigsuspend(3P)



NAME
     sigsuspend - waits for a signal

SYNOPSIS
     #include <signal.h>

     int sigsuspend(sigmask)
     sigset_t *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.

STATUS MESSAGES AND VALUES
     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.

     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.

SEE ALSO
     pause(2), sigprocmask(2P), sigaction(3P), sigpending(3P),
     sigsetops(3P)













January 1992                                                    1