[PHP-DOC] cvs: phpdoc-it /reference/sockets/functions socket-create-listen.xml From: Andrioli Darvin (darvin.andrioli <email protected>)
Date: 06/02/02

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>