sigsuspend(3P)                                     sigsuspend(3P)



     NAME
          sigsuspend - wait 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 pro-
          cess until delivery of a signal whose action is either to
          execute a signal-catching function or to terminate the pro-
          cess.

          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 sig-
          nals.  This is silently enforced.

     RETURN VALUE
          Since sigsuspend suspends process execution indefinitely,
          there is no successful completion return value.  If sig-
          suspend 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.

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












     April, 1990                                                     1