SIGSUSPEND(2-SVR4)  RISC/os Reference Manual   SIGSUSPEND(2-SVR4)



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 func-
     tion 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).












                        Printed 11/19/92                   Page 1