diff --git a/reference/pcntl/functions/pcntl-wait.xml b/reference/pcntl/functions/pcntl-wait.xml index 8b932df474..e8a60bfeb2 100644 --- a/reference/pcntl/functions/pcntl-wait.xml +++ b/reference/pcntl/functions/pcntl-wait.xml @@ -1,5 +1,5 @@ - + pcntl_wait @@ -14,7 +14,46 @@ int&status - &warn.undocumented.func; + The wait function suspends execution of the current process until a + child has exited, or until a signal is delivered whose action is to + terminate the current process or to call a signal handling function. If a + child has already exited by the time of the call (a so-called "zombie" + process), the function returns immediately. Any system resources used by + the child are freed. Please see your system's wait(2) man page for + specific details as to how wait works on your system. + + + pcntl_wait returns the process ID of the child which + exited. + + + pcntl_wait will store status information + in the status parameter which can be + evaluated using the following functions: + pcntl_wifexited, + pcntl_wifstopped, + pcntl_wifsignaled, + pcntl_wexitstatus, + pcntl_wtermsig and + pcntl_wstopsig. + + + + This function is equivalent to calling pcntl_waitpid + with a -1 pid and no + options. + + + + See also pcntl_fork, + pcntl_signal, + pcntl_wifexited, + pcntl_wifstopped, + pcntl_wifsignaled, + pcntl_wexitstatus, + pcntl_wtermsig, + pcntl_wstopsig and + pcntl_waitpid. diff --git a/reference/pcntl/functions/pcntl-waitpid.xml b/reference/pcntl/functions/pcntl-waitpid.xml index 4d5a26cffc..15cb87d3d7 100644 --- a/reference/pcntl/functions/pcntl-waitpid.xml +++ b/reference/pcntl/functions/pcntl-waitpid.xml @@ -1,5 +1,5 @@ - + @@ -69,6 +69,13 @@ + + + Specifying -1 as the pid is + equivalent to the functionality pcntl_wait provides + (minus options). + + pcntl_waitpid will store status information in the status parameter which can be