sigsuspend(2)              DG/UX 4.30               sigsuspend(2)



     NAME
          sigsuspend - Wait for a signal.

     SYNOPSIS
          #include <signal.h>

          int sigsuspend (sigmask)
          sigset_t *sigmask;

     DESCRIPTION
          The 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 terminate the process, the sigsuspend()
          function shall not return.  If the action is to execute a
          signal-catching function, the sigsuspend() shall 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 those signals that cannot be
          ignored, as documented in <signal.h> this shall be enforced
          by the system without causing an error to be indicated.

     RETURNS
          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 any of the following conditions occur, the sigsuspend()
          function shall 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(2), <signal.h>, sigpending(2),
          sigprocmask(2), sigsetops(3)

     COPYRIGHTS
          Portions of this text are reprinted from IEEE Std 1003.1-
          1988, Portable Operating System Interface for Computer
          Environment, copyright © 1988 by the Institute of Electrical
          and Electronics Engineers, Inc., with the permission of the
          IEEE Standards Department.  To purchase IEEE Standards, call



     Licensed material--property of copyright holder(s)         Page 1

     sigsuspend(2)              DG/UX 4.30               sigsuspend(2)



          800/678-IEEE.

          In the event of a discrepancy between the electronic and the
          original printed version, the original version takes
          precedence.


















































     Licensed material--property of copyright holder(s)         Page 2