cvs: phpdoc-it /reference/sockets/functions socket-create-listen.xml

darvina Sun Jun 2 08:44:04 2002 EDT Modified files: /phpdoc-it/reference/sockets/functions socket-create-listen.xml Log: Update to En 1.3 Index: phpdoc-it/reference/sockets/functions/socket-create-listen.xml diff -u phpdoc-it/reference/sockets/functions/socket-create-listen.xml:1.2 phpdoc-it/reference/sockets/functions/socket-create-listen.xml:1.3 --- phpdoc-it/reference/sockets/functions/socket-create-listen.xml:1.2 Wed Apr 17 03:08:37 2002 +++ phpdoc-it/reference/sockets/functions/socket-create-listen.xml Sun Jun 2 08:44:04 2002 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sockets.xml, last change in rev 1.4 --> <!-- last change to 'socket-create-listen' in en/ tree in rev 1.27 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.34/EN.1.27 --> <refentry id="function.socket-create-listen"> <refnamediv> @@ -12,12 +12,47 @@ <title>Descrizione</title> <methodsynopsis> <type>resource</type><methodname>socket_create_listen</methodname> - <methodparam><type>int</type><parameter>port</parameter></methodparam> + <methodparam><type>int</type><parameter>porta</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>backlog</parameter></methodparam> </methodsynopsis> &warn.experimental.func; <para> - &warn.undocumented.func; + Questa funzione è stata concepita per rendere semplice il compito di creare un nuovo socket + che sia in attesa di nuove connessioni. + </para> + <para> + La funzione <function>socket_create_listen</function> crea una nuova risorsa socket + di tipo <constant>AF_INET</constant> in attesa su una data porta + in <emphasis>tutte</emphasis> le interfacce locali di una nuova connessione. + </para> + <para> + Il parametro <parameter>backlog</parameter> indica la lunghezza massima + della coda delle connessioni pendenti. + Come valore per <parameter>backlog</parameter>, può essere + passata la costante <constant>SOMAXCONN</constant>, vedere + <function>socket_listen</function> per maggiori dettagli. + </para> + <para> + <function>socket_create_listen</function> restituisce una nuova risorsa di tipo socket + se ha successo, oppure &false; su errore. Il codice dell'errore può essere recuperato con + la funzione <function>socket_last_error</function>. Questo codice può essere passato alla funzione + <function>socket_strerror</function> per ottenere una descrizione + dell'errore. + </para> + <note> + <para> + Se si desidera creare un socket che sia in attesa solo su certe + interfacce, occorre utilizzare <function>socket_create</function>, + <function>socket_bind</function> e <function>socket_listen</function>. + </para> + </note> + <para> + Vedere anche + <function>socket_create</function>, + <function>socket_bind</function>, + <function>socket_listen</function>, + <function>socket_last_error</function> e + <function>socket_strerror</function>. </para> </refsect1> </refentry>