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

From: Date: Sun, 02 Jun 2002 12:46:11 +0000
Subject: cvs: phpdoc-it /reference/sockets/functions socket-listen.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969346126@lists.php.net to get a copy of this message
darvina Sun Jun 2 08:46:11 2002 EDT Modified files: /phpdoc-it/reference/sockets/functions socket-listen.xml Log: Update to En 1.3 Index: phpdoc-it/reference/sockets/functions/socket-listen.xml diff -u phpdoc-it/reference/sockets/functions/socket-listen.xml:1.2 phpdoc-it/reference/sockets/functions/socket-listen.xml:1.3 --- phpdoc-it/reference/sockets/functions/socket-listen.xml:1.2 Wed Apr 17 03:08:40 2002 +++ phpdoc-it/reference/sockets/functions/socket-listen.xml Sun Jun 2 08:46:11 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-listen' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.34/EN.1.1 --> <refentry id="function.socket-listen"> <refnamediv> @@ -11,36 +11,45 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>socket_listen</methodname> + <type>bool</type><methodname>socket_listen</methodname> <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - <methodparam><type>int</type><parameter>backlog</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>backlog</parameter></methodparam> </methodsynopsis> &warn.experimental.func; <para> Una volta creato il socket <parameter>socket</parameter> tramite la funzione <function>socket_create</function>, ed eseguito il bind ad un nome con <function>socket_bind</function>, lo si può mettere in ascolto di - eventuali richieste di connessione. Tramite il parametro - <parameter>backlog</parameter> si indica il numero massimo di connessioni - in ingresso da tenere nella coda per l'elaborazione. + eventuali richieste di connessione su <parameter>socket</parameter>. </para> + <note> + <para> + Il numero massimo, passato con il parametro <parameter>backlog</parameter> + dipende fortemente dalla piattaforma sottostante. Su Linux questo + viene troncato, senza avvisare, a <constant>SOMAXCONN</constant>. Su Win32, + se viene passata la costante <constant>SOMAXCONN</constant>, il servizio + sottostante responsabile dei socket valorizza <parameter>backlog</parameter> al + massimo valore <emphasis>ragionevole</emphasis>. Non esiste un metodo standard per + determinare il reale valore massimo su questa piattaforma. + </para> + </note> <para> La funzione <function>socket_listen</function> è disponibile solo per i socket di tipo <literal>SOCK_STREAM</literal> o <literal>SOCK_SEQPACKET</literal>. </para> <para> - La funzione restituisce zero se ha successo, oppure un codice di errore - negativo in caso di errore. Questo codice può essere passato alla funzione <function>socket_strerror</function> - per ottenere una descrizione dell'errore. + &return.success; Il codice di errore può essere recuperato con + <function>socket_last_error</function>. Questo codice può essere passato a + <function>socket_strerror</function> per ottenere una spiegazione + dell'errore. </para> <para> Vedere anche <function>socket_accept</function>, <function>socket_bind</function>, <function>socket_connect</function>, - <function>socket_create</function>, - <function>socket_get_status</function> e + <function>socket_create</function> e <function>socket_strerror</function>. </para> </refsect1>

« previous php.doc (#969346126) next »