|
8.98.15 pcntl_wait()
Attend ou retourne le statut d'un processus fils
[ Exemples avec pcntl_wait ] PHP 5
int
pcntl_wait (
int
status
,
int
options
)
pcntl_wait
suspend l'exécution du processus
courant jusqu'à ce qu'un des processus fils soit terminé, ou qu'un
signal soit envoyé pour terminer le processus courant ou
pour appeler un gestionnaire. Si le processus est deja terminé au moment
de l'appel de la fonction, c'est-à-dire si le processus est un
zombie, alors la fonction se termine immédiatement. Toutes les
ressources système utilisées par le processus fils sont libérées.
Lisez le manuel de votre système à wait(2) pour avoir des
détails spécifiques sur le fonctionnement de wait() sur celui-ci.
pcntl_wait
retourne l'identifiant de processus
qui s'est terminé, -1 en cas d'erreur ou zéro si WNOHANG a été
fourni comme option (disponible sur les systèmes wait3),
et qu'aucun processus fils n'était disponible.
Si wait3 est disponible sur votre système (c'est le cas de la plupart
des systèmes BSD-), vous pouvez ajouter le paramètre optionnel
options
. S'il n'est pas fourni,
wait() sera utilisé pour l'appel système. Si wait3 n'est pas disponible,
le paramètre
options
n'aura pas d'effet. La valeur
de
options
est la combinaison de zéro ou plusieurs
des constantes suivantes :
|
WNOHANG
|
Termine immédiatement si aucun processus ne s'est terminé.
|
|
WUNTRACED
|
Termine pour les processus qui sont stoppés, et pour ceux
dont le résultat n'a pas été rapporté.
|
pcntl_wait
va stocker les informations
de statut dans le paramètre
status
qui peut être lu avec les fonctions suivantes :
pcntl_wifexited
,
pcntl_wifstopped
,
pcntl_wifsignaled
,
pcntl_wexitstatus
,
pcntl_wtermsig
et
pcntl_wstopsig
.
| Note | |
Cette fonction est l'équivalent de l'appel de
pcntl_waitpid
avec la valeur
-1
pid
et sans
paramètre
options
.
|
Voir aussi
pcntl_fork
,
pcntl_signal
,
pcntl_wifexited
,
pcntl_wifstopped
,
pcntl_wifsignaled
,
pcntl_wexitstatus
,
pcntl_wtermsig
,
pcntl_wstopsig
et
pcntl_waitpid
.
|
