cvs: phpdoc-fr /reference/pcntl/functions pcntl-wait.xml

From:	Damien Seguy	Date:	Mon, 29 Mar 2004 21:43:53 +0000
Subject:	cvs: phpdoc-fr /reference/pcntl/functions pcntl-wait.xml
Groups:	php.doc.fr
Request:	Send a blank email to doc-fr+get-2083@lists.php.net to get a copy of this message

dams Mon Mar 29 16:43:53 2004 EDT Added files: /phpdoc-fr/reference/pcntl/functions pcntl-wait.xml Log: initial translation http://cvs.php.net/co.php/phpdoc-fr/reference/pcntl/functions/pcntl-wait.xml?r=1.1&p=1 Index: phpdoc-fr/reference/pcntl/functions/pcntl-wait.xml +++ phpdoc-fr/reference/pcntl/functions/pcntl-wait.xml <?xml version="1.0" encoding="iso-8859-1"?>  <refentry id='function.pcntl-wait'> <refnamediv> <refname>pcntl_wait</refname> <refpurpose> Attend ou retourne le statut d'un processus fils </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>pcntl_wait</methodname> <methodparam><type>int</type><parameter>&status</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> <function>pcntl_wait</function> 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 votre système. </para> <para> <function>pcntl_wait</function> retourne l'identifiant de processus qui s'est terminé, -1 en cas d'erreur ou zéro si WNOHANG a été fourni comme optoin (disponible sur les systèmes wait3), et qu'aucun processus fils n'était disponible. </para> <para> 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 <parameter>options</parameter>. Si ce paramètre n'est pas fourni, wait() sera utilisé pour l'appel système. Si wait3 n'est pas disponible, le paramètre <parameter>options</parameter> n'aura pas d'effet. La valeur de <parameter>options</parameter> est la combinaison de zéro ou plusieurs des constantes suivantes : <table> <title>Valeus possibles pour <parameter>options</parameter> si wait3 est disponible</title> <tgroup cols="2"> <tbody> <row> <entry><literal>WNOHANG</literal></entry> <entry> Termine immédiatement si aucun processus ne s'est terminé. </entry> </row> <row> <entry><literal>WUNTRACED</literal></entry> <entry> Termine pour les processus qui sont stoppés, et pour ceux dont le résultat n'a pas été rapporté. </entry> </row> </tbody> </tgroup> </table> </para> <para> <function>pcntl_wait</function> va stocker les informations de statut dans le paramètre <parameter>status</parameter> qui peut être lu avec les fonctions suivantes : <function>pcntl_wifexited</function>, <function>pcntl_wifstopped</function>, <function>pcntl_wifsignaled</function>, <function>pcntl_wexitstatus</function>, <function>pcntl_wtermsig</function> et <function>pcntl_wstopsig</function>. </para> <note> <para> Cette fonction est l'équivalent de l'appel de <function>pcntl_waitpid</function> avec la valeur <literal>-1</literal> <parameter>pid</parameter> et sans paramètre <parameter>options</parameter>. </para> </note> <para> Voir aussi <function>pcntl_fork</function>, <function>pcntl_signal</function>, <function>pcntl_wifexited</function>, <function>pcntl_wifstopped</function>, <function>pcntl_wifsignaled</function>, <function>pcntl_wexitstatus</function>, <function>pcntl_wtermsig</function>, <function>pcntl_wstopsig</function> et <function>pcntl_waitpid</function>. </para> </refsect1> </refentry>