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



NAME
     sigsuspend - wait for a signal

SYNOPSIS
     #include <signal.h>

     int sigsuspend(sigmask)
     sigsett *sigmask;

DESCRIPTION
     sigsuspend changes the calling process' signal mask to the
     set of signals indicated by sigmask and then suspends the
     process until a signal is delivered 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 a signal-catching function is executed, sig-
     suspend returns after the signal-catching function returns
     and the process' signal mask is restored to the set of sig-
     nals that existed prior to the sigsuspend call.

     Signals that cannot be ignored (SIGKILL and SIGSTOP) cannot
     be blocked.  This is silently enforced.

RETURN VALUES
     Since sigsuspend suspends the process indefinitely, there is
     no successful completion return value.  If an error occurs,
     sigsuspend returns -1 and errno is set to indicate the
     error.

ERRORS
     If any of the following conditions occur, sigsuspend returns
     -1 and sets errno to the corresponding value:

     [EINTR]             A signal is caught by the calling pro-
                         cess and control is returned from the
                         signal-catching function.

     [EFAULT]            sigmask points outside the process'
                         allocated address space.

SEE ALSO
     pause(2), sigaction(2), sigpending(2), sigprocmask(2), sig-
     setops(3).










                         Printed 1/15/91                   Page 1