PCNTL_WIFSTOPPED(3) 1 PCNTL_WIFSTOPPED(3)pcntl_wifstopped - Checks whether the child process is currently stoppedSYNOPSIS
bool pcntl_wifstopped (int $status)
DESCRIPTION
Checks whether the child process which caused the return is currently stopped; this is only possible if the call to pcntl_waitpid(3) was
done using the option WUNTRACED.
PARAMETERS
o $status
-The $status parameter is the status parameter supplied to a successful call to pcntl_waitpid(3).
RETURN VALUES
Returns TRUE if the child process which caused the return is currently stopped, FALSE otherwise.
SEE ALSO pcntl_waitpid(3).
PHP Documentation Group PCNTL_WIFSTOPPED(3)
Check Out this Related Man Page
PCNTL_WAITPID(3) 1 PCNTL_WAITPID(3)pcntl_waitpid - Waits on or returns the status of a forked childSYNOPSIS
int pcntl_waitpid (int $pid, int &$status, [int $options])
DESCRIPTION
Suspends execution of the current process until a child as specified by the $pid argument 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 as requested by $pid has already exited by the time of the call (a so-called "zombie" process), the function returns immedi-
ately. Any system resources used by the child are freed. Please see your system's waitpid(2) man page for specific details as to how wait-
pid works on your system.
PARAMETERS
o $pid
- The value of $pid can be one of the following:
possible values for $pid
+-----+---------------------------------------------------+
| | |
|< -1 | |
| | |
| | wait for any child process whose process group |
| | ID is equal to the absolute value of $pid. |
| | |
| | |
| -1 | |
| | |
| | wait for any child process; this is the same be- |
| | haviour that the wait function exhibits. |
| | |
| | |
| 0 | |
| | |
| | wait for any child process whose process group |
| | ID is equal to that of the calling process. |
| | |
| | |
|> 0 | |
| | |
| | wait for the child whose process ID is equal to |
| | the value of $pid. |
| | |
+-----+---------------------------------------------------+
Note
Specifying -1 as the $pid is equivalent to the functionality pcntl_wait(3) provides (minus $options).
o $status
-pcntl_waitpid(3) will store status information in the $status parameter which can be evaluated using the following functions:
pcntl_wifexited(3), pcntl_wifstopped(3), pcntl_wifsignaled(3), pcntl_wexitstatus(3), pcntl_wtermsig(3) and pcntl_wstopsig(3).
o $options
- The value of $options is the value of zero or more of the following two global constants OR'ed together:
possible values for $options
+----------+---------------------------------------------------+
| | |
| WNOHANG | |
| | |
| | return immediately if no child has exited. |
| | |
| | |
|WUNTRACED | |
| | |
| | return for children which are stopped, and whose |
| | status has not been reported. |
| | |
+----------+---------------------------------------------------+
RETURN VALUES pcntl_waitpid(3) returns the process ID of the child which exited, -1 on error or zero if WNOHANG was used and no child was available
SEE ALSO pcntl_fork(3), pcntl_signal(3), pcntl_wifexited(3), pcntl_wifstopped(3), pcntl_wifsignaled(3), pcntl_wexitstatus(3), pcntl_wtermsig(3),
pcntl_wstopsig(3).
PHP Documentation Group PCNTL_WAITPID(3)