sigsuspend(2)                                                 sigsuspend(2)


   NAME
         sigsuspend - install a signal mask and suspend process until signal

   SYNOPSIS
         #include <signal.h>

         int sigsuspend(const sigsett *set);

   DESCRIPTION
         sigsuspend replaces the process's signal mask with the set of signals
         pointed to by the argument set 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 does not
         return.  If the action is to execute a signal catching function,
         sigsuspend returns after the signal catching function returns.  On
         return, the signal mask is restored to the set that existed before
         the call to sigsuspend.

         It is not possible to block those signals that cannot be ignored [see
         signal(5)]; this restriction is silently imposed by the system.

         sigsuspend fails if either of the following is true:

         EINTR          A signal is caught by the calling process and control
                        is returned from the signal catching function.

         EFAULT         The set argument points outside the process's
                        allocated address space.

   DIAGNOSTICS
         Since sigsuspend suspends process execution indefinitely, there is no
         successful completion return value.  On failure, it returns -1 and
         sets errno to indicate the error.

   SEE ALSO
         sigaction(2), sigprocmask(2), sigpause(2), sigsetops(3C),  signal(5).















   7/91                                                                 Page 1