cvs: phpdoc-fr /reference/inotify book.xml constants.xml reference.xml setup.xml /reference/inotify/functions inotify-add-watch.xml inotify-init.xml
inotify-queue-len.xml inotify-read.xml inotify-rm-watch.xml
| From: | Damien Seguy | Date: | Tue, 06 Jan 2009 06:22:41 +0000 |
| Subject: | cvs: phpdoc-fr /reference/inotify book.xml constants.xml reference.xml setup.xml /reference/inotify/functions inotify-add-watch.xml inotify-init.xml inotify-queue-len.xml inotify-read.xml inotify-rm-watch.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6282@lists.php.net to get a copy of this message | ||
dams Tue Jan 6 06:22:41 2009 UTC
Added files:
/phpdoc-fr/reference/inotify book.xml constants.xml reference.xml
setup.xml
/phpdoc-fr/reference/inotify/functions inotify-add-watch.xml
inotify-init.xml
inotify-queue-len.xml
inotify-read.xml
inotify-rm-watch.xml
Log:
commit initial
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/book.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/book.xml +++ phpdoc-fr/reference/inotify/book.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- Purpose: basic.php --> <!-- Membership: pecl --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <book xml:id="book.inotify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Inotify</title> <!-- {{{ preface --> <preface xml:id="intro.inotify"> &reftitle.intro; <para> L'extension inotify fait l'interface avec les fonctions <function>inotify_init</function>, <function>inotify_add_watch</function> et <function>inotify_rm_watch</function>. </para> <para> Comme la fonction C <function>inotify_init</function> retourne un pointeur de fichier, la fonction PHP <function>inotify_init</function> retourne un flux, à utiliser avec les fonctions standard de flux, telle que <function>stream_select</function>, <function>stream_set_blocking</function> et <function>fclose</function>. <function>inotify_read</function> remplace l'approche en langage C de lecture des événements. </para> </preface> <!-- }}} --> &reference.inotify.setup; &reference.inotify.constants; &reference.inotify.reference; </book> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/constants.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/constants.xml +++ phpdoc-fr/reference/inotify/constants.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <appendix xml:id="inotify.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist xml:id="inotify.constants.events"> <title>Les constantes Inotify sont utilisables avec les fonctions <function>inotify_add_watch</function> et/ou retournées par la fonction <function>inotify_read</function></title> <varlistentry> <term> <constant>IN_ACCESS</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier a été accédé (lu) (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MODIFY</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier a été modifié (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ATTRIB</constant> (<type>integer</type>) </term> <listitem> <simpara> Les métadonnées ont changé (e.g. les permissions, la date de modification, etc.) (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CLOSE_WRITE</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier ouvert en écriture a été refermé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CLOSE_NOWRITE</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier non-ouvert en écriture a été refermé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_OPEN</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier a été ouvert (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVED_TO</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier déplacé dans un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVED_FROM</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier déplacé dans d'un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CREATE</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier ou dossier créé dans un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_DELETE</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier ou dossier supprimé dans un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_DELETE_SELF</constant> (<type>integer</type>) </term> <listitem> <simpara> Les fichiers ou dossiers surveillés ont été supprimés </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVE_SELF</constant> (<type>integer</type>) </term> <listitem> <simpara> Les fichiers ou dossiers surveillés ont été déplacés </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CLOSE</constant> (<type>integer</type>) </term> <listitem> <simpara> Égal à IN_CLOSE_WRITE | IN_CLOSE_NOWRITE </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVE</constant> (<type>integer</type>) </term> <listitem> <simpara> Égal à IN_MOVED_FROM | IN_MOVED_TO </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ALL_EVENTS</constant> (<type>integer</type>) </term> <listitem> <simpara> Composition de toutes les constantes précédentes </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_UNMOUNT</constant> (<type>integer</type>) </term> <listitem> <simpara> Le système de fichiers contenant les objets surveillés a été démonté </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_Q_OVERFLOW</constant> (<type>integer</type>) </term> <listitem> <simpara> Queue d'événements en dépassement de capacité (wd vaut -1 pour cet événement) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_IGNORED</constant> (<type>integer</type>) </term> <listitem> <simpara> La surveillance a été retirée (explicitement par <function>inotify_rm_watch</function> ou par ce que le fichier a été supprimé, ou que le système de fichiers a été démonté) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ISDIR</constant> (<type>integer</type>) </term> <listitem> <simpara> Le sujet de cet événement est un dossier </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ONLYDIR</constant> (<type>integer</type>) </term> <listitem> <simpara> Ne surveille que le chemin, si c'est un dossier (Depuis Linux 2.6.15) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_DONT_FOLLOW</constant> (<type>integer</type>) </term> <listitem> <simpara> Ne déréférence pas le chemin si c'est un lien symbolique (Depuis Linux 2.6.15) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MASK_ADD</constant> (<type>integer</type>) </term> <listitem> <simpara> Ajoute les événements au masque de surveillance pour ce chemin, s'il existe déjà (au lieu de remplacer). </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ONESHOT</constant> (<type>integer</type>) </term> <listitem> <simpara> Surveille le chemin de cet événement, puis le supprime de la liste de surveillance. </simpara> </listitem> </varlistentry> </variablelist> <note> <simpara> Les événements marqués par un astérisque (*) ci-dessus peuvent survenir pour des fichiers dans des dossiers sous surveillance. </simpara> </note> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/reference.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/reference.xml +++ phpdoc-fr/reference/inotify/reference.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <reference xml:id="ref.inotify" xmlns="http://docbook.org/ns/docbook"> <title>&Functions; Inotify</title> &reference.inotify.entities.functions; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/setup.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/setup.xml +++ phpdoc-fr/reference/inotify/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <chapter xml:id="inotify.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="inotify.requirements"> &reftitle.required; <para> Cette extension requiert Linux 2.6.13 ou plus récent, et une version récente de libC. </para> </section> <!-- }}} --> <!-- {{{ Installation --> <section xml:id="inotify.install"> &reftitle.setup; <para> &pecl.moved; </para> <para> &pecl.info; <link xlink:href="&url.pecl.package;inotify">&url.pecl.package;inotify</link>. </para> </section> <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="inotify.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="inotify.resources"> &reftitle.resources; <para> Cette extension définit un flux de données, retourné par <function>inotify_init</function>. </para> </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-add-watch.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-add-watch.xml +++ phpdoc-fr/reference/inotify/functions/inotify-add-watch.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-add-watch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_add_watch</refname> <refpurpose>Ajoute un point de surveillance à une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>int</type><methodname>inotify_add_watch</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> <methodparam><type>string</type><parameter>pathname</parameter></methodparam> <methodparam><type>int</type><parameter>mask</parameter></methodparam> </methodsynopsis> <para> <function>inotify_add_watch</function> ajoute un point de surveillance à une instance inotify ou modifie un point de surveillnace en cours vers un nouveau fichier ou dossier spécifié par le chemin <parameter>pathname</parameter>. </para> <para> Utiliser <function>inotify_add_watch</function> sur un objet déjà en surveillance modifie la configuration. Utiliser la constante <constant>IN_MASK_ADD</constant> ajoute les événements (OR logique). </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> <varlistentry> <term><parameter>pathname</parameter></term> <listitem> <para> Fichier ou dossier à surveiller. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>mask</parameter></term> <listitem> <para> Ãvénements à surveiller. Voyez <link linkend="inotify.constants">&ReservedConstants;</link>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> La valeur retournée est un pointeur inotify unique (inotify instance wide). </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-init.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-init.xml +++ phpdoc-fr/reference/inotify/functions/inotify-init.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-init" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_init</refname> <refpurpose>Initialise une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>inotify_init</methodname> <void /> </methodsynopsis> <para> Initialise une instance inotify pour utiliser avec la fonction <function>inotify_add_watch</function> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> Un flux ou &false; en cas d'erreur. </para> </refsect1><!-- }}} --> <refsect1 role="examples"><!-- {{{ --> &reftitle.examples; <para> <example xml:id="inotify-init.example.basic"><!-- {{{ --> <programlisting role="php"> <![CDATA[ <?php // Crée une instance inotify $fd = inotify_init(); // Surveille les modifications des métadonées du fichier __FILE__ (e.g. mtime) $watch_descriptor = inotify_add_watch($fd, __FILE__, IN_ATTRIB); // Génère un événement touch(__FILE__); // Lit les événements $events = inotify_read($fd); print_r($events); // Les méthodes suivantes permettent d'utiliser les fonctions inotify sans bloquer sur inotify_read(): // - Utiliser stream_select() sur $fd: $read = array($fd); $write = null; $except = null; stream_select($read,$write,$except,0); // - Utiliser stream_set_blocking() sur $fd stream_set_blocking($fd, 0); inotify_read($fd); // Does no block, and return false if no events are pending // - Utiliser inotify_queue_len() pour vérifier la taille de la file d'attente $queue_len = inotify_queue_len($fd); // If > 0, inotify_read() will not block // Arrêt de la surveillance de __FILE__ inotify_rm_watch($fd, $watch_descriptor); // Destruction de l'instance inotify // Cela aurait arrêté toutes les surveillance si ce n'était pas déjà fait fclose($fd); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ array( array( 'wd' => 1, // Egale le $watch_descriptor 'mask' => 4, // Le bit IN_ATTRIB est activé 'cookie' => 0, // identifiant uique pour relier des événements (e.g. // IN_MOVE_FROM et IN_MOVE_TO) 'name' => '', // Le nom du fichier (e.g. si un dossier était sous surveillance) ), ); ]]> </screen> </example><!-- }}} --> </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_add_watch</function></member> <member><function>inotify_rm_watch</function></member> <member><function>inotify_queue_len</function></member> <member><function>inotify_read</function></member> <member><function>fclose</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-queue-len.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-queue-len.xml +++ phpdoc-fr/reference/inotify/functions/inotify-queue-len.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-queue-len" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_queue_len</refname> <refpurpose>Retourne le nombre d'événements qui sont survenus</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>int</type><methodname>inotify_queue_len</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> </methodsynopsis> <para> Cette fonction permet de savoir si <function>inotify_read</function> va bloquer ou non. Si un nombre supérieur à 0 est retourné, il y a des événements en attente, et <function>inotify_read</function> ne va pas bloquer. </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> Retourne le nombre d'événements qui sont survenus. </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> <member><function>stream_select</function></member> <member><function>stream_set_blocking</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-read.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-read.xml +++ phpdoc-fr/reference/inotify/functions/inotify-read.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_read</refname> <refpurpose>Lit les événements dans une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>array</type><methodname>inotify_read</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> </methodsynopsis> <para> Lit les événements dans une instance inotify. </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> Un tableau d'événements inotify ou &false; si aucun événement n'était dans la liste, et que <parameter>inotify_instance</parameter> était non-bloquant. Chaque événement dans le tableau dispose des index suivants : <simplelist> <member>wd, le pointeur retourné par la fonction <function>inotify_add_watch</function></member> <member>mask est un champ de bits de constantes <link linkend="inotify.constants">inotify</link></member> <member>cookie iest un identifiant unique pour relier des événements communs (e.g. <constant>IN_MOVE_FROM</constant> and <constant>IN_MOVE_TO</constant>)</member> <member>name est le nom du fichier (e.g. si un fichier a été modifié dans le dossier de surveillance)</member> </simplelist> </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> <member><function>stream_select</function></member> <member><function>stream_set_blocking</function></member> <member><function>inotify_queue_len</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-rm-watch.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-rm-watch.xml +++ phpdoc-fr/reference/inotify/functions/inotify-rm-watch.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-rm-watch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_rm_watch</refname> <refpurpose>Supprime un point de surveillance d'une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>inotify_rm_watch</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> <methodparam><type>int</type><parameter>watch_descriptor</parameter></methodparam> </methodsynopsis> <para> <function>inotify_rm_watch</function> retire le point de surveillance <parameter>watch_descriptor</parameter> de l'instance inotify <parameter>inotify_instance</parameter>. </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> <varlistentry> <term><parameter>watch_descriptor</parameter></term> <listitem> <para> Point de surveillance à retirer </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> &return.success; </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/book.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/book.xml +++ phpdoc-fr/reference/inotify/book.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- Purpose: basic.php --> <!-- Membership: pecl --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <book xml:id="book.inotify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Inotify</title> <!-- {{{ preface --> <preface xml:id="intro.inotify"> &reftitle.intro; <para> L'extension inotify fait l'interface avec les fonctions <function>inotify_init</function>, <function>inotify_add_watch</function> et <function>inotify_rm_watch</function>. </para> <para> Comme la fonction C <function>inotify_init</function> retourne un pointeur de fichier, la fonction PHP <function>inotify_init</function> retourne un flux, à utiliser avec les fonctions standard de flux, telle que <function>stream_select</function>, <function>stream_set_blocking</function> et <function>fclose</function>. <function>inotify_read</function> remplace l'approche en langage C de lecture des événements. </para> </preface> <!-- }}} --> &reference.inotify.setup; &reference.inotify.constants; &reference.inotify.reference; </book> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/constants.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/constants.xml +++ phpdoc-fr/reference/inotify/constants.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <appendix xml:id="inotify.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist xml:id="inotify.constants.events"> <title>Les constantes Inotify sont utilisables avec les fonctions <function>inotify_add_watch</function> et/ou retournées par la fonction <function>inotify_read</function></title> <varlistentry> <term> <constant>IN_ACCESS</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier a été accédé (lu) (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MODIFY</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier a été modifié (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ATTRIB</constant> (<type>integer</type>) </term> <listitem> <simpara> Les métadonnées ont changé (e.g. les permissions, la date de modification, etc.) (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CLOSE_WRITE</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier ouvert en écriture a été refermé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CLOSE_NOWRITE</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier non-ouvert en écriture a été refermé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_OPEN</constant> (<type>integer</type>) </term> <listitem> <simpara> Le fichier a été ouvert (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVED_TO</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier déplacé dans un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVED_FROM</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier déplacé dans d'un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CREATE</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier ou dossier créé dans un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_DELETE</constant> (<type>integer</type>) </term> <listitem> <simpara> Fichier ou dossier supprimé dans un dossier surveillé (*) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_DELETE_SELF</constant> (<type>integer</type>) </term> <listitem> <simpara> Les fichiers ou dossiers surveillés ont été supprimés </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVE_SELF</constant> (<type>integer</type>) </term> <listitem> <simpara> Les fichiers ou dossiers surveillés ont été déplacés </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_CLOSE</constant> (<type>integer</type>) </term> <listitem> <simpara> Égal à IN_CLOSE_WRITE | IN_CLOSE_NOWRITE </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MOVE</constant> (<type>integer</type>) </term> <listitem> <simpara> Égal à IN_MOVED_FROM | IN_MOVED_TO </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ALL_EVENTS</constant> (<type>integer</type>) </term> <listitem> <simpara> Composition de toutes les constantes précédentes </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_UNMOUNT</constant> (<type>integer</type>) </term> <listitem> <simpara> Le système de fichiers contenant les objets surveillés a été démonté </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_Q_OVERFLOW</constant> (<type>integer</type>) </term> <listitem> <simpara> Queue d'événements en dépassement de capacité (wd vaut -1 pour cet événement) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_IGNORED</constant> (<type>integer</type>) </term> <listitem> <simpara> La surveillance a été retirée (explicitement par <function>inotify_rm_watch</function> ou par ce que le fichier a été supprimé, ou que le système de fichiers a été démonté) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ISDIR</constant> (<type>integer</type>) </term> <listitem> <simpara> Le sujet de cet événement est un dossier </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ONLYDIR</constant> (<type>integer</type>) </term> <listitem> <simpara> Ne surveille que le chemin, si c'est un dossier (Depuis Linux 2.6.15) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_DONT_FOLLOW</constant> (<type>integer</type>) </term> <listitem> <simpara> Ne déréférence pas le chemin si c'est un lien symbolique (Depuis Linux 2.6.15) </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_MASK_ADD</constant> (<type>integer</type>) </term> <listitem> <simpara> Ajoute les événements au masque de surveillance pour ce chemin, s'il existe déjà (au lieu de remplacer). </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>IN_ONESHOT</constant> (<type>integer</type>) </term> <listitem> <simpara> Surveille le chemin de cet événement, puis le supprime de la liste de surveillance. </simpara> </listitem> </varlistentry> </variablelist> <note> <simpara> Les événements marqués par un astérisque (*) ci-dessus peuvent survenir pour des fichiers dans des dossiers sous surveillance. </simpara> </note> </appendix> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/reference.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/reference.xml +++ phpdoc-fr/reference/inotify/reference.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <reference xml:id="ref.inotify" xmlns="http://docbook.org/ns/docbook"> <title>&Functions; Inotify</title> &reference.inotify.entities.functions; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/setup.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/setup.xml +++ phpdoc-fr/reference/inotify/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <chapter xml:id="inotify.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="inotify.requirements"> &reftitle.required; <para> Cette extension requiert Linux 2.6.13 ou plus récent, et une version récente de libC. </para> </section> <!-- }}} --> <!-- {{{ Installation --> <section xml:id="inotify.install"> &reftitle.setup; <para> &pecl.moved; </para> <para> &pecl.info; <link xlink:href="&url.pecl.package;inotify">&url.pecl.package;inotify</link>. </para> </section> <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="inotify.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="inotify.resources"> &reftitle.resources; <para> Cette extension définit un flux de données, retourné par <function>inotify_init</function>. </para> </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-add-watch.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-add-watch.xml +++ phpdoc-fr/reference/inotify/functions/inotify-add-watch.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-add-watch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_add_watch</refname> <refpurpose>Ajoute un point de surveillance à une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>int</type><methodname>inotify_add_watch</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> <methodparam><type>string</type><parameter>pathname</parameter></methodparam> <methodparam><type>int</type><parameter>mask</parameter></methodparam> </methodsynopsis> <para> <function>inotify_add_watch</function> ajoute un point de surveillance à une instance inotify ou modifie un point de surveillnace en cours vers un nouveau fichier ou dossier spécifié par le chemin <parameter>pathname</parameter>. </para> <para> Utiliser <function>inotify_add_watch</function> sur un objet déjà en surveillance modifie la configuration. Utiliser la constante <constant>IN_MASK_ADD</constant> ajoute les événements (OR logique). </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> <varlistentry> <term><parameter>pathname</parameter></term> <listitem> <para> Fichier ou dossier à surveiller. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>mask</parameter></term> <listitem> <para> Ãvénements à surveiller. Voyez <link linkend="inotify.constants">&ReservedConstants;</link>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> La valeur retournée est un pointeur inotify unique (inotify instance wide). </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-init.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-init.xml +++ phpdoc-fr/reference/inotify/functions/inotify-init.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-init" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_init</refname> <refpurpose>Initialise une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>inotify_init</methodname> <void /> </methodsynopsis> <para> Initialise une instance inotify pour utiliser avec la fonction <function>inotify_add_watch</function> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> Un flux ou &false; en cas d'erreur. </para> </refsect1><!-- }}} --> <refsect1 role="examples"><!-- {{{ --> &reftitle.examples; <para> <example xml:id="inotify-init.example.basic"><!-- {{{ --> <programlisting role="php"> <![CDATA[ <?php // Crée une instance inotify $fd = inotify_init(); // Surveille les modifications des métadonées du fichier __FILE__ (e.g. mtime) $watch_descriptor = inotify_add_watch($fd, __FILE__, IN_ATTRIB); // Génère un événement touch(__FILE__); // Lit les événements $events = inotify_read($fd); print_r($events); // Les méthodes suivantes permettent d'utiliser les fonctions inotify sans bloquer sur inotify_read(): // - Utiliser stream_select() sur $fd: $read = array($fd); $write = null; $except = null; stream_select($read,$write,$except,0); // - Utiliser stream_set_blocking() sur $fd stream_set_blocking($fd, 0); inotify_read($fd); // Does no block, and return false if no events are pending // - Utiliser inotify_queue_len() pour vérifier la taille de la file d'attente $queue_len = inotify_queue_len($fd); // If > 0, inotify_read() will not block // Arrêt de la surveillance de __FILE__ inotify_rm_watch($fd, $watch_descriptor); // Destruction de l'instance inotify // Cela aurait arrêté toutes les surveillance si ce n'était pas déjà fait fclose($fd); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ array( array( 'wd' => 1, // Egale le $watch_descriptor 'mask' => 4, // Le bit IN_ATTRIB est activé 'cookie' => 0, // identifiant uique pour relier des événements (e.g. // IN_MOVE_FROM et IN_MOVE_TO) 'name' => '', // Le nom du fichier (e.g. si un dossier était sous surveillance) ), ); ]]> </screen> </example><!-- }}} --> </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_add_watch</function></member> <member><function>inotify_rm_watch</function></member> <member><function>inotify_queue_len</function></member> <member><function>inotify_read</function></member> <member><function>fclose</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-queue-len.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-queue-len.xml +++ phpdoc-fr/reference/inotify/functions/inotify-queue-len.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-queue-len" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_queue_len</refname> <refpurpose>Retourne le nombre d'événements qui sont survenus</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>int</type><methodname>inotify_queue_len</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> </methodsynopsis> <para> Cette fonction permet de savoir si <function>inotify_read</function> va bloquer ou non. Si un nombre supérieur à 0 est retourné, il y a des événements en attente, et <function>inotify_read</function> ne va pas bloquer. </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> Retourne le nombre d'événements qui sont survenus. </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> <member><function>stream_select</function></member> <member><function>stream_set_blocking</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-read.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-read.xml +++ phpdoc-fr/reference/inotify/functions/inotify-read.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_read</refname> <refpurpose>Lit les événements dans une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>array</type><methodname>inotify_read</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> </methodsynopsis> <para> Lit les événements dans une instance inotify. </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> Un tableau d'événements inotify ou &false; si aucun événement n'était dans la liste, et que <parameter>inotify_instance</parameter> était non-bloquant. Chaque événement dans le tableau dispose des index suivants : <simplelist> <member>wd, le pointeur retourné par la fonction <function>inotify_add_watch</function></member> <member>mask est un champ de bits de constantes <link linkend="inotify.constants">inotify</link></member> <member>cookie iest un identifiant unique pour relier des événements communs (e.g. <constant>IN_MOVE_FROM</constant> and <constant>IN_MOVE_TO</constant>)</member> <member>name est le nom du fichier (e.g. si un fichier a été modifié dans le dossier de surveillance)</member> </simplelist> </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> <member><function>stream_select</function></member> <member><function>stream_set_blocking</function></member> <member><function>inotify_queue_len</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/inotify/functions/inotify-rm-watch.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/inotify/functions/inotify-rm-watch.xml +++ phpdoc-fr/reference/inotify/functions/inotify-rm-watch.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.inotify-rm-watch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>inotify_rm_watch</refname> <refpurpose>Supprime un point de surveillance d'une instance inotify</refpurpose> </refnamediv> <refsect1 role="description"><!-- {{{ --> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>inotify_rm_watch</methodname> <methodparam><type>resource</type><parameter>inotify_instance</parameter></methodparam> <methodparam><type>int</type><parameter>watch_descriptor</parameter></methodparam> </methodsynopsis> <para> <function>inotify_rm_watch</function> retire le point de surveillance <parameter>watch_descriptor</parameter> de l'instance inotify <parameter>inotify_instance</parameter>. </para> </refsect1><!-- }}} --> <refsect1 role="parameters"><!-- {{{ --> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>inotify_instance</parameter></term> <listitem> <para> &inotify.instance.description; </para> </listitem> </varlistentry> <varlistentry> <term><parameter>watch_descriptor</parameter></term> <listitem> <para> Point de surveillance à retirer </para> </listitem> </varlistentry> </variablelist> </para> </refsect1><!-- }}} --> <refsect1 role="returnvalues"><!-- {{{ --> &reftitle.returnvalues; <para> &return.success; </para> </refsect1><!-- }}} --> <refsect1 role="seealso"><!-- {{{ --> &reftitle.seealso; <para> <simplelist> <member><function>inotify_init</function></member> </simplelist> </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->