Manuel PHP - pcntl_waitpid - Attend la fin de l'exécution d'un processus fils

Description

int pcntl_waitpid ( int $pid , int &$status [, int $options = 0 ] )

Suspend l'exécution du processus courant jusqu'à ce qu'un processus fils spécifié par le paramètre pid ait terminé, qu'un signal ait mis fin à ce processus ou qu'un signal ait appelé un gestionnaire de signaux.

Si le processus fils identifié par pid est déjà terminé au moment de l'appel de cette fonction (on les appelle des processus "zombie"), la fonction se termine immédiatement. Toute ressource système utilisée par le processus fils est libérée. Reportez-vous à la page de man waitpid(2) pour avoir des détails sur le comportement de cette fonction sur votre système.

Liste de paramètres

pid

La valeur de pid peut être une parmi les suivantes :

Valeurs possibles pour *`pid`*
< -1	attend que tous les processus fils dont l'identifiant de groupe est égal à la valeur absolue de `pid` soient terminés.
-1	attend que tous les processus fils soient terminés. Ceci est le même comportement que celui de la fonction pcntl_wait().
0	attend que tous les processus fils dont l'identifiant de groupe est égal à celui du processus courant soient terminés.
> 0	attend que le processus fils dont l'identifiant est égal à `pid` soit terminé.

Note:
Si pid vaut -1, cela équivaut à utiliser la fonction pcntl_wait() (minimum options).

status

pcntl_waitpid() enregistrera des informations sur le statut courant du processus dans le paramètre status, auquel on peut accéder grâce aux fonctions suivantes : pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() et pcntl_wstopsig().

options

Le paramètre options peut prendre la valeur zéro, ou plusieurs des constantes globales suivantes (combinez les avec l'opérateur OR) :

Valeurs possibles de *`options`*
WNOHANG	retourne immédiatement si aucun processus fils ne s'est terminé.
WUNTRACED	retourne lorsque les processus fils sont arrêtés et que leur statut n'a pas été mis à jour.

Valeurs de retour

pcntl_waitpid() retourne l'identifiant de processus du processus fils qui s'est terminé, ou bien -1 en cas d'erreur ou encore zéro si WNOHANG a été utilisée et qu'aucun processus fils n'était disponible.

Voir aussi

pcntl_fork() - Duplique le process courant
pcntl_signal() - Installe un gestionnaire de signaux
pcntl_wifexited() - Vérifie si le code de retour représente une fin normale
pcntl_wifstopped() - Retourne TRUE si le processus fils est stoppé
pcntl_wifsignaled() - Retourne TRUE si le code statut représente une fin due à un signal
pcntl_wexitstatus() - Retourne le code d'un processus fils terminé
pcntl_wtermsig() - Retourne le signal qui a provoqué la fin du processus fils
pcntl_wstopsig() - Retourne le signal qui a causé l'arrêt du processus fils