archived-doc-pt-br/reference/stream/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 561e36d646b8e48dc53a910234ee9f30cba147d0 Maintainer: leonardolara Status: ready -->
<appendix xml:id="stream.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;

 <variablelist>
  <title>
   Opções do parâmetro <parameter>flags</parameter> para a função
   <function>stream_socket_client</function>
  </title>

  <varlistentry xml:id="constant.stream-client-async-connect">
   <term>
    <constant>STREAM_CLIENT_ASYNC_CONNECT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Abre o socket do cliente de forma assíncrona.
     Esta opção deve ser usada junto com a opção
     <constant>STREAM_CLIENT_CONNECT</constant>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-client-connect">
   <term>
    <constant>STREAM_CLIENT_CONNECT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Abre a conexão socket do cliente.
     Sockets do cliente devem sempre incluir esta opção.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-client-persistent">
   <term>
    <constant>STREAM_CLIENT_PERSISTENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Socket do cliente deve permanecer persistente entre carregamentos de páginas.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Opções do parâmetro <parameter>flags</parameter> para a função
   <function>stream_socket_server</function>
  </title>

  <varlistentry xml:id="constant.stream-server-bind">
   <term>
    <constant>STREAM_SERVER_BIND</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Indica que um fluxo deve se ligar ao alvo especificado.
     Sockets de servidor devem sempre incluir esta opção.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-server-listen">
   <term>
    <constant>STREAM_SERVER_LISTEN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Indica que um fluxo ligado usando a opção
     <constant>STREAM_SERVER_BIND</constant>
     deve iniciar a escuta ao socket.
     Transportes orientados a conexão (como o TCP) devem usar esta opção,
     caso contrário o socket do servidor não será habilitado.
     Usar esta opção em transportes sem conexão (como o UDP) é um erro.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Valores para o parâmetro <parameter>mode</parameter> da função
   <function>stream_socket_shutdown</function>
  </title>

  <varlistentry xml:id="constant.stream-shut-rd">
   <term>
    <constant>STREAM_SHUT_RD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Desabilita recepções adicionais.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-shut-wr">
   <term>
    <constant>STREAM_SHUT_WR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Desabilita transmissões adicionais.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-shut-rdwr">
   <term>
    <constant>STREAM_SHUT_RDWR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Desabilita recepções e transmissões adicionais.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>Opções de Transferências de Sockets de Fluxo</title>
  <simpara>
   Essas constantes são usadas para o parâmetro <parameter>flags</parameter>
   das funções
   <function>stream_socket_recvfrom</function> e
   <function>stream_socket_sendto</function>.
  </simpara>

  <varlistentry xml:id="constant.stream-oob">
   <term>
    <constant>STREAM_OOB</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Processa dados fora-de-banda OOB (<literal>out-of-band</literal>).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-peek">
   <term>
    <constant>STREAM_PEEK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Busca dados do soquete, mas não consome o buffer.
    </simpara>
    <simpara>
     Chamadas subsequentes a <function>fread</function> ou
     <function>stream_socket_recvfrom</function> receberão os mesmos dados.
    </simpara>
    <note>
     <simpara>
      Não é uma opção válida para <function>stream_socket_sendto</function>.
     </simpara>
    </note>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>Constantes de Filtro de Fluxo</title>
  <simpara>
   Essas constantes são usadas pelas funções
   <function>stream_filter_append</function> e
   <function>stream_filter_prepend</function>.
  </simpara>

  <varlistentry xml:id="constant.stream-filter-read">
   <term>
    <constant>STREAM_FILTER_READ</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Indica que o filtro especificado deve somente ser aplicado durante
     <emphasis>leitura</emphasis>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-filter-write">
   <term>
    <constant>STREAM_FILTER_WRITE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Indica que o filtro especificado deve somente ser aplicado durante
     <emphasis>escrita</emphasis>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-filter-all">
   <term>
    <constant>STREAM_FILTER_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Equivalente a <code>STREAM_FILTER_READ | STREAM_FILTER_WRITE</code>.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Métodos de Criptografia de Fluxo
  </title>
  <!-- TODO: <simpara> describing when these constants are used? -->

  <varlistentry xml:id="constant.stream-crypto-method-any-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_ANY_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Qualquer versão TLS ou SSL em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-sslv2-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_SSLv2_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     SSL 2 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-sslv3-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_SSLv3_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     SSL 3 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-sslv23-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_SSLv23_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.0, 1.1 ou 1.2 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tls-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLS_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Qualquer versão TLS em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-0-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.0 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-1-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.1 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-2-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.2 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-3-client">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.3 em um fluxo de cliente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-any-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_ANY_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Qualquer versão de TLS ou SSL em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-sslv2-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_SSLv2_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     SSL 2 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-sslv3-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_SSLv3_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     SSL 3 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-sslv23-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_SSLv23_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.0, 1.1 ou 1.2 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tls-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLS_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Qualquer versão de TLS em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-0-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_0_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.0 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-1-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_1_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.1 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-2-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_2_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.2 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-method-tlsv1-3-server">
   <term>
    <constant>STREAM_CRYPTO_METHOD_TLSv1_3_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     TLS 1.3 em um fluxo de servidor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-proto-sslv3">
   <term>
    <constant>STREAM_CRYPTO_PROTO_SSLv3</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     &Alias; <constant>STREAM_CRYPTO_METHOD_SSLv3_SERVER</constant>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-proto-tlsv1-0">
   <term>
    <constant>STREAM_CRYPTO_PROTO_TLSv1_0</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     &Alias; <constant>STREAM_CRYPTO_METHOD_TLSv1_0_SERVER</constant>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-proto-tlsv1-1">
   <term>
    <constant>STREAM_CRYPTO_PROTO_TLSv1_1</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     &Alias; <constant>STREAM_CRYPTO_METHOD_TLSv1_1_SERVER</constant>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-proto-tlsv1-2">
   <term>
    <constant>STREAM_CRYPTO_PROTO_TLSv1_2</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     &Alias; <constant>STREAM_CRYPTO_METHOD_TLSv1_2_SERVER</constant>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-crypto-proto-tlsv1-3">
   <term>
    <constant>STREAM_CRYPTO_PROTO_TLSv1_3</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     &Alias; <constant>STREAM_CRYPTO_METHOD_TLSv1_3_SERVER</constant>.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Constantes internas não utilizadas
  </title>

  <varlistentry xml:id="constant.stream-must-seek">
   <term>
    <constant>STREAM_MUST_SEEK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Certifica que o fluxo é pesquisável.
     Isto pode resultar na criação de uma cópia do fluxo.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.stream-ignore-url">
   <term>
    <constant>STREAM_IGNORE_URL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Não usa empacotadores de plugin.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <!-- TODO: Need to prevent chunking -->
 <simplesect>
  <title>
   Constantes usadas com a função <function>stream_socket_pair</function>
  </title>
  <note>
   <simpara>
    Nem todas as constantes estarão disponíveis em um sistema específico.
   </simpara>
  </note>
  <variablelist>
   <title>
    Constantes para o parâmetro <parameter>domain</parameter>
   </title>
   <varlistentry xml:id="constant.stream-pf-inet">
    <term>
     <constant>STREAM_PF_INET</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Versão 4 de Protocolo de Internet (IPv4).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-pf-inet6">
    <term>
     <constant>STREAM_PF_INET6</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Versão 6 de Protocolo de Internet (IPv6).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-pf-unix">
    <term>
     <constant>STREAM_PF_UNIX</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Protocolos internos do sistema Unix.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Constantes para o parâmetro <parameter>type</parameter>
   </title>
   <varlistentry xml:id="constant.stream-sock-dgram">
    <term>
     <constant>STREAM_SOCK_DGRAM</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece datagramas, que são mensagens sem conexão.
      Por exemplo: UDP.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-sock-raw">
    <term>
     <constant>STREAM_SOCK_RAW</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket bruro, que dá acessoa a protocolos e interfaces internos
      da rede.
      Normalmente este tipo de socket está disponível somente ao usuário raiz (administrador).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-sock-rdm">
    <term>
     <constant>STREAM_SOCK_RDM</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket RDM (mensagem entrege com confiabilidade).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-sock-seqpacket">
    <term>
     <constant>STREAM_SOCK_SEQPACKET</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket de fluxo de pacotes sequenciados.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-sock-stream">
    <term>
     <constant>STREAM_SOCK_STREAM</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece fluxos de bytes de mão dupla, sequenciados com um mecanismo de transmissão
      para dados fora-de-banda.
      Por exemplo: TCP.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Constantes para o parâmetro <parameter>protocol</parameter>
   </title>
   <varlistentry xml:id="constant.stream-ipproto-icmp">
    <term>
     <constant>STREAM_IPPROTO_ICMP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket ICMP.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-ipproto-ip">
    <term>
     <constant>STREAM_IPPROTO_IP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket IP.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-ipproto-raw">
    <term>
     <constant>STREAM_IPPROTO_RAW</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket RAW.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-ipproto-tcp">
    <term>
     <constant>STREAM_IPPROTO_TCP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket TCP.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-ipproto-udp">
    <term>
     <constant>STREAM_IPPROTO_UDP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Fornece um socket UDP.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </simplesect>

 <simplesect>
  <title>
   Constantes usadas com a função <function>stream_notification_callback</function>
  </title>
  <variablelist>
   <title>
    Valores para o parâmetro <parameter>notification_code</parameter>
   </title>

   <varlistentry xml:id="constant.stream-notify-resolve">
    <term>
     <constant>STREAM_NOTIFY_RESOLVE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Um endereço remoto requerido para este fluxo foi resolvidoo,
      ou a resolução falhou.
     </simpara>
     <simpara>
      Consulte o parâmetro <parameter>severity</parameter> para uma indicação do ocorrido.
     </simpara>
     <warning>
      <simpara>
       O suporte para este código de implementação ainda não foi implementado.
      </simpara>
     </warning>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-connect">
    <term>
     <constant>STREAM_NOTIFY_CONNECT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Uma conexão com um recurso externo foi estabalecida.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-auth-required">
    <term>
     <constant>STREAM_NOTIFY_AUTH_REQUIRED</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Autorização adicional é requerida para acessar o recurso especificado.
     </simpara>
     <simpara>
      Tipicamente emitido com o nível de severidade (<parameter>severity</parameter>) de
      <constant>STREAM_NOTIFY_SEVERITY_ERR</constant>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-mime-type-is">
    <term>
     <constant>STREAM_NOTIFY_MIME_TYPE_IS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      O <literal>tipo de mídia</literal> do recurso foi identificado.
     </simpara>
     <simpara>
      Refira-se ao parâmetro <parameter>message</parameter> para uma descrição do
      tipo descoberto.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-file-size-is">
    <term>
     <constant>STREAM_NOTIFY_FILE_SIZE_IS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      O <literal>tamanho</literal> do recurso foi identificado.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-redirected">
    <term>
     <constant>STREAM_NOTIFY_REDIRECTED</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
       O recurso externo redirecionou o fluxo para uma localização alternativa.
     </simpara>
     <simpara>
      Refira-se ao parâmetro <parameter>message</parameter>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-progress">
    <term>
     <constant>STREAM_NOTIFY_PROGRESS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica o progresso atual da transferência do fluxo em
      <parameter>bytes_transferred</parameter> e possivelmente em
      <parameter>bytes_max</parameter> também.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-completed">
    <term>
     <constant>STREAM_NOTIFY_COMPLETED</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Não há mais dados disponíveis no fluxo.
      (Primeira implementação a partir do PHP 8.3.0.)
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-failure">
    <term>
     <constant>STREAM_NOTIFY_FAILURE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Um erro genérico ocorreu no fluxo.
     </simpara>
     <simpara>
      Consulte os parâmetros <parameter>message</parameter> e
      <parameter>message_code</parameter> para detalhes.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-auth-result">
    <term>
     <constant>STREAM_NOTIFY_AUTH_RESULT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      A autorização foi concluída (com ou sem sucesso).
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Valores para o parâmetro <parameter>severity</parameter>
   </title>

   <varlistentry xml:id="constant.stream-notify-severity-info">
    <term>
     <constant>STREAM_NOTIFY_SEVERITY_INFO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Notificação normal, não relacionada a erro.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-severity-warn">
    <term>
     <constant>STREAM_NOTIFY_SEVERITY_WARN</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Condição de erro não crítica.
      O processamento pode continuar.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-notify-severity-err">
    <term>
     <constant>STREAM_NOTIFY_SEVERITY_ERR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Um erro crítico ocorreu.
      O processamento não pode continuar.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </simplesect>

 <simplesect>
  <title>Constantes relacionadas a <classname>streamWrapper</classname></title>

  <variablelist>
   <title>
    Opções válidas para a função <function>stream_wrapper_register</function>
   </title>

   <varlistentry xml:id="constant.stream-is-url">
    <term>
     <constant>STREAM_IS_URL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica que o protocolo empacotador de fluxo é um protocolo
      <acronym>URL</acronym>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Valores para o parâmetro <parameter>cast_as</parameter> do método
    <methodname>streamWrapper::stream_cast</methodname>
   </title>

   <varlistentry xml:id="constant.stream-cast-for-select">
    <term>
     <constant>STREAM_CAST_FOR_SELECT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica que <methodname>streamWrapper::stream_cast</methodname>
      foi chamado por <methodname>streamWrapper::stream_select</methodname>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-cast-as-stream">
    <term>
     <constant>STREAM_CAST_AS_STREAM</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica que <methodname>streamWrapper::stream_cast</methodname>
      foi chamado por qualquer outro método exceto
      <methodname>streamWrapper::stream_select</methodname>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Valores para o parâmetro <parameter>option</parameter> do método
    <methodname>streamWrapper::stream_metadata</methodname>
   </title>

   <varlistentry xml:id="constant.stream-meta-touch">
    <term>
     <constant>STREAM_META_TOUCH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica uma chamada a <function>touch</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-meta-owner">
    <term>
     <constant>STREAM_META_OWNER</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica uma chamada a <function>chown</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-meta-owner-name">
    <term>
     <constant>STREAM_META_OWNER_NAME</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica uma chamada a <function>chown</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-meta-group">
    <term>
     <constant>STREAM_META_GROUP</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica uma chamada a <function>chgrp</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-meta-group-name">
    <term>
     <constant>STREAM_META_GROUP_NAME</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica uma chamada a <function>chgrp</function>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-meta-access">
    <term>
     <constant>STREAM_META_ACCESS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Indica uma chamada a <function>chmod</function>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Opções válidas para os métodos
    <methodname>streamWrapper::mkdir</methodname>
    <!-- TODO: Check that rmdir() can actually pass this flag -->
    e
    <methodname>streamWrapper::rmdir</methodname>
   </title>

   <varlistentry xml:id="constant.stream-mkdir-recursive">
    <term>
     <constant>STREAM_MKDIR_RECURSIVE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Sinalizador recursivo para os parâmetros de opções de
      <function>mkdir</function> e <function>rmdir</function>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Valores para o parâmetro <parameter>options</parameter> do método
    <methodname>streamWrapper::stream_open</methodname>
   </title>

   <varlistentry xml:id="constant.stream-use-path">
    <term>
     <constant>STREAM_USE_PATH</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Opção que indica que caminhos relativos devem usar o caminho de inclusão
      para localizar o recurso.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-report-errors">
    <term>
     <constant>STREAM_REPORT_ERRORS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Opção que indica que o empacotador de fluxo deve reportar erros.
      Se esta opção não for definida, nenhum erro deve ser reportado.
     </simpara>
     <simpara>
      Erros são normalmente reportados através da função
      <function>trigger_error</function>.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Valores para o parâmetro <parameter>option</parameter> do método
    <methodname>streamWrapper::stream_set_option</methodname>
   </title>

   <varlistentry xml:id="constant.stream-option-blocking">
    <term>
     <constant>STREAM_OPTION_BLOCKING</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Define o modo bloqueante/não-bloqueante em um fluxo.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-option-read-buffer">
    <term>
     <constant>STREAM_OPTION_READ_BUFFER</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Define armazenamento em buffer de leitura de arquivo em um fluxo.
     </simpara>
     <variablelist>
      <title>
       Valores de opção válidos
      </title>
      <varlistentry xml:id="constant.stream-buffer-none">
       <term>
        <constant>STREAM_BUFFER_NONE</constant>
        (<type>int</type>)
       </term>
       <listitem>
        <simpara>
         Sem buffer.
        </simpara>
       </listitem>
      </varlistentry>
      <varlistentry xml:id="constant.stream-buffer-line">
       <term>
        <constant>STREAM_BUFFER_LINE</constant>
        (<type>int</type>)
       </term>
       <listitem>
        <simpara>
         Buffer de linha.
        </simpara>
       </listitem>
      </varlistentry>
      <varlistentry xml:id="constant.stream-buffer-full">
       <term>
        <constant>STREAM_BUFFER_FULL</constant>
        (<type>int</type>)
       </term>
       <listitem>
        <simpara>
         Buffer completo.
        </simpara>
       </listitem>
      </varlistentry>
     </variablelist>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-option-read-timeout">
    <term>
     <constant>STREAM_OPTION_READ_TIMEOUT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Define limite de tempo de leitura em um fluxo.
      <!-- TODO: Fix description -->
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-option-write-buffer">
    <term>
     <constant>STREAM_OPTION_WRITE_BUFFER</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Define armazenamento em buffer de gravação em arquivo em um fluxo.
     </simpara>
     <simpara>
      Consulte <constant>STREAM_OPTION_READ_BUFFER</constant>
      para opções válidas de buffer.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Valores para o parâmetro <parameter>flags</parameter> do método
    <methodname>streamWrapper::url_stat</methodname>
   </title>

   <varlistentry xml:id="constant.stream-url-stat-link">
    <term>
     <constant>STREAM_URL_STAT_LINK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Apenas informação sore a conexão em si deve ser retornada,
      e não o recurso apontado pela conexão.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.stream-url-stat-quiet">
    <term>
     <constant>STREAM_URL_STAT_QUIET</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      O empacotador não deve emitir erros.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </simplesect>

 <simplesect>
  <title>Constantes relacionadas a <classname>php_user_filter</classname></title>

  <variablelist>
   <title>
    Valores de retorno válidos para
    <methodname>php_user_filter::filter</methodname>
   </title>

   <varlistentry xml:id="constant.psfs-pass-on">
    <term>
     <constant>PSFS_PASS_ON</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Valor de retorno indicando que o filtro no espaço do
      usuário retornou buckets em <parameter>$out</parameter>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.psfs-feed-me">
    <term>
     <constant>PSFS_FEED_ME</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Valor de retorno indicando que o filtro no espaço do
      usuário não retornou buckets em <parameter>$out</parameter>
      (ou seja, nenhum dado disponível).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.psfs-err-fatal">
    <term>
     <constant>PSFS_ERR_FATAL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Valor de retorno indicando que o filtro no espaço do
      usuário encontrou um erro irrecuperável
      (ou seja, dados inválidos recebidos).
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

  <variablelist>
   <title>
    Constantes internas não utilizadas
   </title>

   <varlistentry xml:id="constant.psfs-flag-normal">
    <term>
     <constant>PSFS_FLAG_NORMAL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Leitura/escrita comuns.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.psfs-flag-flush-inc">
    <term>
     <constant>PSFS_FLAG_FLUSH_INC</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Uma descarga incremental.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.psfs-flag-flush-close">
    <term>
     <constant>PSFS_FLAG_FLUSH_CLOSE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Descarga final antes do fechamento.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </simplesect>
</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
-->