SignalWaitinfo(), SignalWaitinfo_r()

Select a pending signal

Synopsis:

#include <sys/neutrino.h>

int SignalWaitinfo( const sigset_t* set,
                    siginfo_t* info );

int SignalWaitinfo_r( const sigset_t* set,
                      siginfo_t* info );

Library:

libc

Description:

The SignalWaitinfo() and SignalWaitinfo_r() functions are identical except in the way they indicate errors. See the Returns section for details.

These kernel calls select the pending signal from the set specified by set. If no signal in set is pending at the time of the call, the thread blocks until one or more signals in set become pending or until interrupted by an unblocked, caught signal.

If the info argument isn't NULL, information on the selected signal is stored there as follows:

If, while SignalWaitinfo() is waiting, a caught signal occurs that isn't blocked, the signal handler is invoked and SignalWaitinfo() is interrupted with an error of EINTR.

Blocking states

STATE_SIGWAITINFO

The calling thread blocks waiting for a signal.

Returns:

The only difference between these functions is the way they indicate errors:

SignalWaitinfo()

A signal number. If an error occurs, -1 is returned and errno is set.

SignalWaitinfo_r()

A signal number. This function does NOT set errno. If an error occurs, the negative of a value from the Errors section is returned.

Errors:

EINTR

The call was interrupted by a signal.

EFAULT

A fault occurred when the kernel tried to access the buffers provided.

ETIMEDOUT

A kernel timeout unblocked the call. See TimerTimeout().

Classification:

QNX 6

See also:

SignalKill(), SignalKill_r()