Description
int
pcntl_waitpid ( int pid, int &status [, int options] )
pcntl_waitpid() 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.
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.
Le paramètre pid peut prendre l'une des valeurs
suivantes :
Tableau 1. Valeurs possibles de 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 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).
pcntl_waitpid() enregistrera des informations sur
le statut courant du processus dans le paramètre
status, auquel on peut accéder grace aux
fonctions suivantes :
pcntl_wifexited(),
pcntl_wifstopped(),
pcntl_wifsignaled(),
pcntl_wexitstatus(),
pcntl_wtermsig() et
pcntl_wstopsig().
Le paramètre options peut prendre la valeur
zéro, ou plusieurs des constantes globales suivantes
(combinez les avec l'opérateur OR) :
Tableau 2. 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.
|
Voir aussi
pcntl_fork(),
pcntl_signal(),
pcntl_wifexited(),
pcntl_wifstopped(),
pcntl_wifsignaled(),
pcntl_wexitstatus(),
pcntl_wtermsig() et
pcntl_wstopsig().
