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>
