sigsuspend(2)                  DG/UX R4.11MU05                 sigsuspend(2)


NAME
       sigsuspend - wait for a signal

SYNOPSIS
       #include <signal.h>

       int sigsuspend (sigmask)
       sigsett *sigmask;

   where:
       sigmask   A structure containing a set of signals constituting a
                 signal mask

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.

RETURN VALUE
       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.

DIAGNOSTICS
       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), sigpending(2), sigprocmask(2), sigsetops(3C),
       <signal.h>.

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 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)