doc-fr/reference/stream/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aab33d644359aba597e810e2fc0c0caa0d347c9c Maintainer: jpauli Status: ready -->
<!-- Reviewed: no -->

<appendix xml:id="stream.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants;
 &extension.constants;
 <para>
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Constante</entry>
      <entry>Description</entry>
     </row>
    </thead>
    <tbody>
     <row xml:id="constant.stream-filter-read">
      <entry><constant>STREAM_FILTER_READ</constant></entry>
      <entry>
       Utilisée avec <function>stream_filter_append</function> et
       <function>stream_filter_prepend</function> pour indiquer
       que le filtre spécifié ne doit être appliqué qu'après la
       <emphasis>lecture</emphasis>.
      </entry>
     </row>
     <row xml:id="constant.stream-filter-write">
      <entry><constant>STREAM_FILTER_WRITE</constant></entry>
      <entry>
       Utilisée avec <function>stream_filter_append</function> et
       <function>stream_filter_prepend</function> pour indiquer
       que le filtre spécifié ne doit être appliqué qu'après l'
       <emphasis>écriture</emphasis>.
      </entry>
     </row>
     <row xml:id="constant.stream-filter-all">
      <entry><constant>STREAM_FILTER_ALL</constant></entry>
      <entry>
       Cette constante est équivalente à
       <code>STREAM_FILTER_READ |
        STREAM_FILTER_WRITE</code>
      </entry>
     </row>
     <row xml:id="constant.psfs-pass-on">
      <entry><constant>PSFS_PASS_ON</constant></entry>
      <entry>Le <literal>code retourné</literal> indique que le
       filtre utilisateur retourne
       des données dans <parameter>$out</parameter>.
      </entry>
     </row>
     <row xml:id="constant.psfs-feed-me">
      <entry><constant>PSFS_FEED_ME</constant></entry>
      <entry>Le <literal>code retourné</literal> indique que le
       filtre utilisateur ne retourne
       pas de données dans <parameter>$out</parameter>
       (i.e. aucune donnée disponible).
      </entry>
     </row>
     <row xml:id="constant.psfs-err-fatal">
      <entry><constant>PSFS_ERR_FATAL</constant></entry>
      <entry>Le <literal>code retourné</literal> indique que le
       filtre utilisateur a produit une erreur fatale.
       (i.e. données invalides reçues).
      </entry>
     </row>
     <row xml:id="constant.psfs-flag-normal">
      <entry><constant>PSFS_FLAG_NORMAL</constant></entry>
      <entry>Opérations normales de lecture et écriture.</entry>
     </row>
     <row xml:id="constant.psfs-flag-flush-inc">
      <entry><constant>PSFS_FLAG_FLUSH_INC</constant></entry>
      <entry>Écriture incrémentale.</entry>
     </row>
     <row xml:id="constant.psfs-flag-flush-close">
      <entry><constant>PSFS_FLAG_FLUSH_CLOSE</constant></entry>
      <entry>Écriture en bloc, à la fermeture.</entry>
     </row>
     <row xml:id="constant.stream-use-path">
      <entry><constant>STREAM_USE_PATH</constant></entry>
      <entry>
       Option indiquant si <literal>stream</literal>
       a utilisé l'<option>include_path</option>.
      </entry>
     </row>
     <row xml:id="constant.stream-report-errors">
      <entry><constant>STREAM_REPORT_ERRORS</constant></entry>
      <entry>
       Option indiquant si le gestionnaire est responsable
       pour la levée des erreurs avec <function>trigger_error</function>
       durant l'ouverture du flux. Si cette constante n'existe pas,
       vous ne devez pas émettre d'erreurs.
      </entry>
     </row>
     <row xml:id="constant.stream-client-async-connect">
      <entry><constant>STREAM_CLIENT_ASYNC_CONNECT</constant></entry>
      <entry>
       Ouvre un socket client en mode asynchrone. Cette option doit être utilisée
       avec l'option <constant>STREAM_CLIENT_CONNECT</constant>.
       À utiliser avec la fonction <function>stream_socket_client</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-client-connect">
      <entry><constant>STREAM_CLIENT_CONNECT</constant></entry>
      <entry>
       Ouvre un socket client. Les sockets clients doivent toujours inclure ce flag.
       À utiliser avec la fonction <function>stream_socket_client</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-client-persistent">
      <entry><constant>STREAM_CLIENT_PERSISTENT</constant></entry>
      <entry>Le socket client ouvert avec <function>stream_socket_client</function>
       doit rester persistant entre chaque page chargée.
      </entry>
     </row>
     <row xml:id="constant.stream-server-bind">
      <entry><constant>STREAM_SERVER_BIND</constant></entry>
      <entry>Appel un flux créé avec la fonction <function>stream_socket_server</function>
       pour s'identifier sur la cible définie. Les sockets serveur doivent toujours utiliser
       cette constante.
      </entry>
     </row>
     <row xml:id="constant.stream-server-listen">
      <entry><constant>STREAM_SERVER_LISTEN</constant></entry>
      <entry>Appel un flux créé avec <function>stream_socket_server</function>
       et utilise la constante <constant>STREAM_SERVER_BIND</constant> pour commencer
       à écouter le socket. Les connexions orientées transports (comme TCP) doivent utiliser
       cet option sinon le socket serveur ne sera pas activée.
       Utiliser cette option pour les connexions basses de transports, comme UDP,
       est une erreur.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-resolve">
      <entry><constant>STREAM_NOTIFY_RESOLVE</constant></entry>
      <entry>
       Une adresse distante requise pour ce flux a été résolue, ou bien la résolution a échoué.
       Voir le paramètre <parameter>severity</parameter> pour avoir une indication
       sur l'événement survenu.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-connect">
      <entry><constant>STREAM_NOTIFY_CONNECT</constant></entry>
      <entry>
       Une connexion avec une ressource externe a été établie.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-auth-required">
      <entry><constant>STREAM_NOTIFY_AUTH_REQUIRED</constant></entry>
      <entry>
       Une autorisation supplémentaire est demandée pour accéder à la ressource spécifiée.
       Typiquement utilisé avec le niveau d'alerte <parameter>severity</parameter> de la constante
       <constant>STREAM_NOTIFY_SEVERITY_ERR</constant>.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-mime-type-is">
      <entry><constant>STREAM_NOTIFY_MIME_TYPE_IS</constant></entry>
      <entry>
       Le <literal>type mime</literal> de la ressource a été identifié : voir
       le paramètre <parameter>message</parameter> pour une description
       du type découvert.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-file-size-is">
      <entry><constant>STREAM_NOTIFY_FILE_SIZE_IS</constant></entry>
      <entry>
       La <literal>taille</literal> de la ressource a été découverte.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-redirected">
      <entry><constant>STREAM_NOTIFY_REDIRECTED</constant></entry>
      <entry>
       La ressource externe a redirigé le flux vers un endroit différent.
       Voir le paramètre <parameter>message</parameter>.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-progress">
      <entry><constant>STREAM_NOTIFY_PROGRESS</constant></entry>
      <entry>
       Indique l'actuelle progression du transfert du flux dans
       <parameter>bytes_transferred</parameter> et peut-être
       <parameter>bytes_max</parameter> également.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-completed">
      <entry><constant>STREAM_NOTIFY_COMPLETED</constant></entry>
      <entry>
       Il n'y a plus de données disponibles sur le flux.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-failure">
      <entry><constant>STREAM_NOTIFY_FAILURE</constant></entry>
      <entry>
       Une erreur générique est intervenue sur le flux, consultez les paramètres
       <parameter>message</parameter> et <parameter>message_code</parameter>
       pour plus de détails.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-auth-result">
      <entry><constant>STREAM_NOTIFY_AUTH_RESULT</constant></entry>
      <entry>
       L'autorisation est terminée (avec succès ou pas).
      </entry>
     </row>
     <row xml:id="constant.stream-notify-severity-info">
      <entry><constant>STREAM_NOTIFY_SEVERITY_INFO</constant></entry>
      <entry>
       Notification normale, aucune erreur signalée.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-severity-warn">
      <entry><constant>STREAM_NOTIFY_SEVERITY_WARN</constant></entry>
      <entry>
       Erreur non critique. Le traitement continue.
      </entry>
     </row>
     <row xml:id="constant.stream-notify-severity-err">
      <entry><constant>STREAM_NOTIFY_SEVERITY_ERR</constant></entry>
      <entry>
       Une erreur critique est survenu. Le traitement ne peut continuer.
      </entry>
     </row>
     <row xml:id="constant.stream-ipproto-icmp">
      <entry><constant>STREAM_IPPROTO_ICMP</constant> +</entry>
      <entry>
       Fournit un socket ICMP.
      </entry>
     </row>
     <row xml:id="constant.stream-ipproto-ip">
      <entry><constant>STREAM_IPPROTO_IP</constant> +</entry>
      <entry>
       Fournit un socket IP.
      </entry>
     </row>
     <row xml:id="constant.stream-ipproto-raw">
      <entry><constant>STREAM_IPPROTO_RAW</constant> +</entry>
      <entry>
       Fournit un socket RAW.
      </entry>
     </row>
     <row xml:id="constant.stream-ipproto-tcp">
      <entry><constant>STREAM_IPPROTO_TCP</constant> +</entry>
      <entry>
       Fournit un socket TCP.
      </entry>
     </row>
     <row xml:id="constant.stream-ipproto-udp">
      <entry><constant>STREAM_IPPROTO_UDP</constant> +</entry>
      <entry>
       Fournit un socket UDP.
      </entry>
     </row>
     <row xml:id="constant.stream-pf-inet">
      <entry><constant>STREAM_PF_INET</constant> +</entry>
      <entry>
       Protocole Internet version 4 (IPv4).
      </entry>
     </row>
     <row xml:id="constant.stream-pf-inet6">
      <entry><constant>STREAM_PF_INET6</constant> +</entry>
      <entry>
       Protocole internet version 6(IPv6).
      </entry>
     </row>
     <row xml:id="constant.stream-pf-unix">
      <entry><constant>STREAM_PF_UNIX</constant> +</entry>
      <entry>
       Protocoles internes des systèmes Unix.
      </entry>
     </row>
     <row xml:id="constant.stream-sock-dgram">
      <entry><constant>STREAM_SOCK_DGRAM</constant> +</entry>
      <entry>
       Fournit des datagrammes, qui sont des messages sans connectivité (UDP, par
       exemple).
      </entry>
     </row>
     <row xml:id="constant.stream-sock-raw">
      <entry><constant>STREAM_SOCK_RAW</constant> +</entry>
      <entry>
       Fournit un socket brut, qui fournit un accès aux protocoles et interfaces internes
       du réseau. Habituellement, ce type de socket n'est disponible qu'à l'utilisateur root.
      </entry>
     </row>
     <row xml:id="constant.stream-sock-rdm">
      <entry><constant>STREAM_SOCK_RDM</constant> +</entry>
      <entry>
       Fournit un socket RDM (Reliably-delivered messages).
      </entry>
     </row>
     <row xml:id="constant.stream-sock-seqpacket">
      <entry><constant>STREAM_SOCK_SEQPACKET</constant> +</entry>
      <entry>
       Fournit un socket de flux de paquets en séquence.
      </entry>
     </row>
     <row xml:id="constant.stream-sock-stream">
      <entry><constant>STREAM_SOCK_STREAM</constant> +</entry>
      <entry>
       Fournit un flux en séquence bi-directionnel avec un mécanisme de transmission
       pour les données "out-of-band" (TCP par exemple).
      </entry>
     </row>
     <row xml:id="constant.stream-shut-rd">
      <entry><constant>STREAM_SHUT_RD</constant></entry>
      <entry>
       Utilisé avec <function>stream_socket_shutdown</function> pour désactiver
       les réceptions futures.
      </entry>
     </row>
     <row xml:id="constant.stream-shut-wr">
      <entry><constant>STREAM_SHUT_WR</constant></entry>
      <entry>
       Utilisé avec <function>stream_socket_shutdown</function> pour désactiver
       les transmissions futures.
      </entry>
     </row>
     <row xml:id="constant.stream-shut-rdwr">
      <entry><constant>STREAM_SHUT_RDWR</constant></entry>
      <entry>
       Utilisé avec <function>stream_socket_shutdown</function> pour désactiver
       les réceptions et transmissions futures.
      </entry>
     </row>
     <row xml:id="constant.stream-cast-for-select">
      <entry><constant>STREAM_CAST_FOR_SELECT</constant></entry>
      <entry>
       Transtypage de flux, lorsque <function>stream_select</function> appelle
       <function>stream_cast</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-cast-as-stream">
      <entry><constant>STREAM_CAST_AS_STREAM</constant></entry>
      <entry>
       Transtypage de flux, lorsque <function>stream_cast</function> est appelé
       autrement (voir ci-dessus).
      </entry>
     </row>
     <row xml:id="constant.stream-meta-touch">
      <entry><constant>STREAM_META_TOUCH</constant></entry>
      <entry>
       Utilisé avec <function>stream_metadata</function>, pour spécifier un appel <function>touch</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-meta-owner">
      <entry><constant>STREAM_META_OWNER</constant></entry>
      <entry>
       Utilisé avec <function>stream_metadata</function>, pour spécifier un appel <function>chown</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-meta-owner-name">
      <entry><constant>STREAM_META_OWNER_NAME</constant></entry>
      <entry>
       Utilisé avec <function>stream_metadata</function>, pour spécifier un appel <function>chown</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-meta-group">
      <entry><constant>STREAM_META_GROUP</constant></entry>
      <entry>
       Utilisé avec <function>stream_metadata</function>, pour spécifier un appel <function>chgrp</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-meta-group-name">
      <entry><constant>STREAM_META_GROUP_NAME</constant></entry>
      <entry>
       Utilisé avec <function>stream_metadata</function>, pour spécifier un appel <function>chgrp</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-meta-access">
      <entry><constant>STREAM_META_ACCESS</constant></entry>
      <entry>
       Utilisé avec <function>stream_metadata</function>, pour spécifier un appel <function>chmod</function>.
      </entry>
     </row>
     <row xml:id="constant.stream-buffer-none">
      <entry><constant>STREAM_BUFFER_NONE</constant></entry>
      <entry>
       Pas de tampon utilisé.
      </entry>
     </row>
     <row xml:id="constant.stream-buffer-line">
      <entry><constant>STREAM_BUFFER_LINE</constant></entry>
      <entry>
       Tampon par ligne.
      </entry>
     </row>
     <row xml:id="constant.stream-buffer-full">
      <entry><constant>STREAM_BUFFER_FULL</constant></entry>
      <entry>
       Tampon complet.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </para>
 <note>
  <simpara>
   Les constantes marquées avec un <literal>+</literal> sont faites pour être
   utilisées avec la fonction <function>stream_socket_pair</function>.
   Notez que quelques-unes de ces
   constantes peuvent ne pas être disponibles sur votre système.
  </simpara>
 </note>
 <note>
  <simpara>
   Les constantes <constant>STREAM_META_*</constant> sont faites pour être
   utilisées avec la fonction <function>stream_metadata</function>.
  </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:"~/.phpdoc/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
-->