sigwait(2)

NAME

sigwait - select a set of signals

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <signal.h>
int
sigwait(const sigset_t * restrict set, int * restrict sig);

DESCRIPTION

The sigwait() system call selects a set of signals, speci

fied by set. If
none of the selected signals are pending, sigwait() waits

until one or
more of the selected signals has been generated. Then

sigwait() atomically clears one of the selected signals from the set of

pending signals
for the process and sets the location pointed to by sig to

the signal
number that was cleared.

The signals specified by set should be blocked at the time

of the call to
sigwait().

RETURN VALUES

If successful, sigwait() returns 0 and sets the location

pointed to by
sig to the cleared signal number. Otherwise, an error num

ber is
returned.

ERRORS

The sigwait() system call will fail if:

[EINVAL] The set argument specifies one or more

invalid signal

numbers.

SEE ALSO

sigaction(2), sigpending(2), sigsuspend(2), pause(3),

pthread_sigmask(3)

STANDARDS

The sigwait() function conforms to ISO/IEC 9945-1:1996

(``POSIX.1'').

BSD April 27, 2000

BSD