cvs: phpdoc-ca /chapters streams.socket.xml

jabro		Sat Aug  6 18:17:06 2005 EDT

  Added files:                 
    /phpdoc-ca/chapters	streams.socket.xml 
  Log:
  initial translation
  

http://cvs.php.net/co.php/phpdoc-ca/chapters/streams.socket.xml?r=1.1&p=1
Index: phpdoc-ca/chapters/streams.socket.xml
+++ phpdoc-ca/chapters/streams.socket.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.3 Maintainer: jabro Status: ready -->
<!-- Author: Wez Furlong <[email protected]>
  Please contact me before making any major amendments to the
  content of this section.  Splitting/Merging are fine if they are
  required for php-doc restructuring purposes - just drop me a line
  if you make a change (so I can update my local copy).
-->

 <reference id="streams.socket-api">
  <title>Referència de l'API de corrents de sòcol</title>

  <refentry id="streams.php-stream-sock-open-from-socket">
   <refnamediv>
    <refname>php_stream_sock_open_from_socket</refname>
    <refpurpose>Converteix un descriptor de sòcol en un corrent</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripció</title>
     <methodsynopsis>
      <type>php_stream *</type><methodname>php_stream_sock_open_from_socket</methodname>
      <methodparam><type>int</type><parameter>socket</parameter></methodparam>
      <methodparam><type>int</type><parameter>persistent</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>php_stream_sock_open_from_socket</function> retorna un corrent basat en el
     <parameter>socket</parameter>. <parameter>persistent</parameter> és un marcador que controla
     si el corrent s'obre com un corrent de dades permanent. Parlant generalment, aquest paràmetre
     serà normalment 0.
     </para>
   </refsect1>
  </refentry>

  <refentry id="streams.php-stream-sock-open-host">
   <refnamediv>
    <refname>php_stream_sock_open_host</refname>
    <refpurpose>Obre una connexió a un servidor i retorna un corrent</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripció</title>
     <methodsynopsis>
      <type>php_stream *</type><methodname>php_stream_sock_open_host</methodname>
      <methodparam><type>const char *</type><parameter>host</parameter></methodparam>
      <methodparam><type>unsigned short</type><parameter>port</parameter></methodparam>
      <methodparam><type>int</type><parameter>socktype</parameter></methodparam>
      <methodparam><type>struct timeval *</type><parameter>timeout</parameter></methodparam>
      <methodparam><type>int</type><parameter>persistent</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>php_stream_sock_open_host</function> estableix una connexió al
     <parameter>host</parameter> i <parameter>port</parameter> especificats. <parameter>socktype</parameter>
     especifica la semàntica de connexió que s'hauria d'aplicar a aquesta.
     Els valors de <parameter>socktype</parameter> depenen del sistema, però normalment inclouran
     (com a mínim) <constant>SOCK_STREAM</constant> per a corrents seqüenciats, confiables i basats 
     en dos tipus de connexió (TCP), o bé <constant>SOCK_DGRAM</constant> per a missatges desconnectats 
     i sense seguretat d'una mida màxima (UDP).
    </para>
    <para>
     <parameter>persistent</parameter> és un marcador que controla si el corrent
     s'obre com un corrent de dades persistent. Parlant generalment, aquest paràmetre normalment serà 0.
    </para>
    <para>
     Si no és NULL, <parameter>timeout</parameter> especifica el temps màxim que es disposa per a fer la connexió.
     Si l'intent de connexió dura més que el valor de temporització, l'intent de connexió s'avorta i es retorna
     NULL per indicar que el corrent de dades no s'ha pogut obrir.
    </para>
    <note>
     <simpara>
      El valor de temporització no inclou el temps que pren realitzar una cerca DNS. La raó d'això és 
      que no hi ha una manera portable d'implementar una cerca DNS no bloquejant.
     </simpara>
     <simpara>
      La temporització només s'aplica a la fase de connexió; si necessiteu definir temporitzadors per a 
      lectures subsegüents hauríeu d'utilitzar <function>php_stream_sock_set_timeout</function> per a configurar
      la duració del temporitzador del vostre corrent un cop aquest s'ha obert.
     </simpara>
    </note>
    <para>
     L'API de corrents no posa restriccions als valors
     que podeu usar per <parameter>socktype</parameter>, però us encoratja a considerar la portabilitat
     de valors que trieu abans d'alliberar l'extensió.
    </para>
   </refsect1>
  </refentry>

  <refentry id="streams.php-stream-sock-open-unix">
   <refnamediv>
    <refname>php_stream_sock_open_unix</refname>
    <refpurpose>Obre un sòcol de domini Unix i el converteix en un corrent</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripció</title>
     <methodsynopsis>
      <type>php_stream *</type><methodname>php_stream_sock_open_unix</methodname>
      <methodparam><type>const char *</type><parameter>path</parameter></methodparam>
      <methodparam><type>int</type><parameter>pathlen</parameter></methodparam>
      <methodparam><type>int</type><parameter>persistent</parameter></methodparam>
      <methodparam><type>struct timeval *</type><parameter>timeout</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>php_stream_sock_open_unix</function> intenta obrir un sòcol de domini Unix
      especificat per <parameter>path</parameter>.  <parameter>pathlen</parameter> especifica
      la grandària de <parameter>path</parameter>.
      Si <parameter>timeout</parameter> no és NULL, especifica un periode de temporització
      per a l'intent de connexió.
      <parameter>persistent</parameter> indica si el corrent s'hauria d'obrir com a un corrent de dades
      persistent. Parlant generalment, aquest paràmetre normalment serà 0.
     </para>
     <note>
      <simpara>
       Aquesta funció no funcionarà sota Windows, el qual no implementa sòcols
       de dominis Unix. Una excepció possible a aquesta regla és si el vostre binari PHP s'ha muntat
       utilitzant Cygwin. Us encoratgem a considerar aquest aspecte de portabilitat de la vostra extensió
       abans del seu llançament.
      </simpara>
    </note>
    <note>
      <simpara>
       Aquesta funció tracta <parameter>path</parameter> de manera segura binàriament, cosa que és
       adequada per utilitzar en sistemes amb un espai de noms abstracte (com ara Linux), on el primer caràcter
       és un caràcter NUL.
      </simpara>
    </note>
   </refsect1>
  </refentry>



 </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
-->