sigpause(3C)sigpause(3C)NAMEsigpause - signal management
SYNOPSIS
Obsolescent
DESCRIPTION
The function, along with the and functions provide simplified signal
management.
The function removes sig from the calling thread's signal mask and sus‐
pends the calling thread until a signal is received. The function
restores the thread's signal mask to its original state before return‐
ing.
RETURN VALUE
The function suspends execution of the thread until a signal is
received, whereupon it shall return and set to
ERRORS
[EINVAL] sig is not a valid signal number.
WARNINGS
The compiler option must be set to use sigpause(). The use of the
function without the option is unspecified.
should not be used in conjunction with signal(2) and sigspace(2).
OBSOLESCENT FUNCTION
will be obsoleted in the near future. The obsolescent function blocks
signals according to the value of mask, then atomically waits for an
unmasked signal to arrive. On return, restores the current signal mask
to the value that existed before the call. When no signals are to be
blocked, a value of is used for mask.
terminates when it is interrupted by a signal. When terminates, it
returns −l and sets to
The obsolescent function is typically used in conjunction with the
obsoleted function.
Threads Considerations
Since blocked signal masks are maintained at the thread level, the
obsolescent function modifies only the calling thread's blocked signal
mask. suspends only the calling thread until it receives a signal.
If other threads in the process do not block the signal, the signal may
be delivered to another thread in the process and the thread in may
continue waiting. For this reason, the use of sigwait(2) is recom‐
mended instead of for multi-threaded applications.
For more information regarding signals and threads, refer to signal(5).
LP64 Programs
This obsolescent accepts a long (64 bit) value. However, as for ILP32
programs, supports signals numbered 1 through 32. The upper 32 bits of
the mask argument are ignored.
Author
was developed by the University of California, Berkeley.
SEE ALSOkill(1), kill(2), pause(2), signal(2), wait(2), abort(3C), setjmp(3C),
sighold(3C), sigignore(3C), sigrelse(3C), sigset(3C), signal(5).
STANDARDS CONFORMANCEsigpause(3C)