PCNTL_SIGWAITINFO(3) 1 PCNTL_SIGWAITINFO(3)
pcntl_sigwaitinfo - Waits for signals
SYNOPSIS
int pcntl_sigwaitinfo (array $set, [array &$siginfo])
DESCRIPTION
The pcntl_sigwaitinfo(3) function suspends execution of the calling script until one of the signals given in $set are delivered. If one of
the signal is already pending (e.g. blocked by pcntl_sigprocmask(3)), pcntl_sigwaitinfo(3) will return immediately.
PARAMETERS
o $set
- Array of signals to wait for.
o $siginfo
- The $siginfo parameter is set to an array containing informations about the signal. The following elements are set for all sig-
nals:
osigno: Signal number
oerrno: An error number
ocode: Signal code
The following elements may be set for the SIGCHLD signal:
ostatus: Exit value or signal
outime: User time consumed
ostime: System time consumed
opid: Sending process ID
ouid: Real user ID of sending process
The following elements may be set for the SIGILL, SIGFPE, SIGSEGV and SIGBUS signals:
oaddr: Memory location which caused fault
The following element may be set for the SIGPOLL signal:
oband: Band event
ofd: File descriptor number
RETURN VALUES
On success, pcntl_sigwaitinfo(3) returns a signal number.
EXAMPLES
Example #1
pcntl_sigwaitinfo(3) example
<?php
echo "Blocking SIGHUP signal
";
pcntl_sigprocmask(SIG_BLOCK, array(SIGHUP));
echo "Sending SIGHUP to self
";
posix_kill(posix_getpid(), SIGHUP);
echo "Waiting for signals
";
$info = array();
pcntl_sigwaitinfo(array(SIGHUP), $info);
?>
SEE ALSO
pcntl_sigprocmask(3), pcntl_sigtimedwait(3).
PHP Documentation Group PCNTL_SIGWAITINFO(3)