sigsuspend(2)             SYSTEM CALLS              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  sig-
     nal  catching  function returns.  On return, the signal mask
     is restored to the set that existed before the call to  sig-
     suspend.   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).

















                                                                1