sigwait(2)                     DG/UX 5.4R3.00                     sigwait(2)


NAME
       sigwait - wait for an asynchronous signal

SYNOPSIS
       #include <signal.h>
       int     sigwait(sigsett *set)
       int     sigsett *set


   where:
       set       A pointer to a set of signals for which the caller will
                 wait.

DESCRIPTION
       Sigwait chooses a pending signal from set, atomically clears it from
       the system's set of pending signals, and returns that signal number.
       If no signal in set is pending at the time of the call, the tread is
       suspended until one or more signals is pending.  The signals defined
       by set are blocked at the time of the call to sigwait(2).  The effect
       of sigwait(2) on the signal actions for the signals in set is
       unspecified.

       If more than one thread is using sigwait(2) to wait for the same
       signal, one of those threads returns from sigwait(2) with the signal
       number.  Which thread returns from sigwait(2) if more than one signal
       thread is waiting is unspecified.

RETURN VALUE
       Upon successful completion, sigwait(2) returns the signal number of
       the received signal.  Otherwise, -1 is returned and errno is set to
       indicate the error.

DIAGNOSTICS
       If any of the following conditions occur, sigwait(2) return -1 and
       sets errno to the corresponding value:

       EINVAL    The set argument contains an invalid or unsupported signal
                 number.

SEE ALSO
       sigaction(2), sigprocmask(2), sigsuspend(2), pause(2).

COPYRIGHTS
       Portions of this text are reprinted from IEEE Std 1003.4a Draft 6,
       Thread Extension for Portable Operating Systems© 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 printed version, the printed version takes precedence.








Licensed material--property of copyright holder(s)                         1