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 <wez@thebrainroom.com> 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 -->