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

From: Date: Mon, 24 Feb 2003 20:45:01 +0000
Subject: cvs: phpdoc-it /reference/sockets/functions socket-create.xml
Groups: php.doc.it 
Request: Send a blank email to doc-it+get-260@lists.php.net to get a copy of this message
darvina Mon Feb 24 15:45:01 2003 EDT Modified files: /phpdoc-it/reference/sockets/functions socket-create.xml Log: Update to En 1.4

Index: phpdoc-it/reference/sockets/functions/socket-create.xml diff -u phpdoc-it/reference/sockets/functions/socket-create.xml:1.3 phpdoc-it/reference/sockets/functions/socket-create.xml:1.4 --- phpdoc-it/reference/sockets/functions/socket-create.xml:1.3 Sun Jun 2 08:44:51 2002 +++ phpdoc-it/reference/sockets/functions/socket-create.xml Mon Feb 24 15:45:01 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sockets.xml, last change in rev 1.1 --> <!-- last change to 'socket-create' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.34/EN.1.4 --> <refentry id="function.socket-create"> <refnamediv> @@ -16,47 +16,156 @@ <methodparam><type>int</type><parameter>tipo</parameter></methodparam> <methodparam><type>int</type><parameter>protocollo</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> La funzione crea un punto terminale di una comunicazione (un socket) - e restituisce una risorsa di tipo socket. + e restituisce una risorsa di tipo socket. In una tipica connessione di rete + si hanno 2 sockets, uno con il ruolo di client + e l'altro con il ruolo di server. </para> <para> Il parametro <parameter>dominio</parameter> indica il dominio (famiglia di - protocolli da usarsi per la comunicazione). Attualmente i valori ammessi sono - <constant>AF_INET</constant> - e <constant>AF_UNIX</constant>. Normalmente <constant>AF_INET</constant> viene utilizzato - per le comunicazione basate su internet. Mentre <constant>AF_UNIX</constant> utilizza dei - percorsi per identificare i socket e quindi può essere usato solo per connessioni - locali (che d'altra parte è più veloce). + protocolli da usarsi per la comunicazione tra i sockets). </para> + <table> + <title>Famiglie di indirizzi/protocolli disponibili</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Dominio</entry> + <entry>Descrizione</entry> + </row> + </thead> + <tbody> + <row> + <entry>AF_INET</entry> + <entry> + Protocollo Internet basato su IPv4. TCP e UDP sono i protocolli + più comuni di questa famiglia. + </entry> + </row> + <row> + <entry>AF_UNIX</entry> + <entry> + Famiglia di protocolli per le comunicazioni locali. L'alta efficenza + ed il basso overhead ne fanno una buona forma di IPC (comunicazione inter-processo). + </entry> + </row> + </tbody> + </tgroup> + </table> <para> - Il parametro <parameter>tipo</parameter> indica il tipo di socket. - I tipi ammessi sono <constant>SOCK_STREAM</constant>, - <constant>SOCK_DGRAM</constant>, - <constant>SOCK_SEQPACKET</constant>, - <constant>SOCK_RAW</constant>, <constant>SOCK_RDM</constant> oppure - <constant>SOCK_PACKET</constant>. I due tipi più comuni sono - <constant>SOCK_DGRAM</constant> per comunicazioni - <literal>UDP</literal> e - <constant>SOCK_STREAM</constant> per comunicazioni - <literal>TCP</literal>. + Il parametro <parameter>tipo</parameter> indica il tipo di comunicazione + da usare con il socket. </para> - <para> - Il parametro <parameter>protocollo</parameter> indica il protocollo e può essere - <constant>SOL_UDP</constant> oppure <constant>SOL_TCP</constant>. + <table> + <title>Tipi di socket disponibili</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Tipo</entry> + <entry>Descrizione</entry> + </row> + </thead> + <tbody> + <row> + <entry>SOCK_STREAM</entry> + <entry> + Fornisce una connessione sequenziale, affidabile e full-duplex. Può + essere supportato un meccanismo di trasmissione fuori-banda. + Il protocollo TCP è basato su questo tipo di socket. + </entry> + </row> + <row> + <entry>SOCK_DGRAM</entry> + <entry> + Supporta i datagrammi (privo di connessione, messaggi inaffidabili di una lunghezza massima prefissata). + Il protocollo UDP è basato su questo tipo di socket. + </entry> + </row> + <row> + <entry>SOCK_SEQPACKET</entry> + <entry> + Fornisce una trasmissione di dati sequenziale, affidabile, bi-direzionale per i + datagrammi di lunghezza massima prefissata; all'utilizzatore è richiesto di + leggere l'intero pacchetto in ogni esecuzione della funzione di lettura dal socket. + </entry> + </row> + <row> + <entry>SOCK_RAW</entry> + <entry> + Fornisce un'accesso raw al protocollo di rete. Questo tipo di socket può essere + utilizzato per costruire manualmente qualsiasi tipo di protocollo. Un comune utilizzo + di questa tipologia di socket è la realizzazione di richieste ICMP (tipo + il ping o traceroute). + </entry> + </row> + <row> + <entry>SOCK_RDM</entry> + <entry> + Fornisce un'interfaccia affidabile per i datagrammi ma non ne garantisce l'ordine. + Probabilmente questo non è implementato nel vostro sistema operativo. + </entry> + </row> + </tbody> + </tgroup> + </table> + <para> + Il parametro <parameter>protocollo</parameter> indica + lo specifico protocollo nel <parameter>dominio</parameter> indicato da usarsi + con il socket restituito. Il valore opportuno può essere recuperato + utilizzando <function>getprotobyname</function>. Se il protocollo + desiderato è il TCP o l'UDP, si possono utilizzare le corrispondenti costanti + <constant>SOL_UDP</constant> e <constant>SOL_TCP</constant>. </para> + <table> + <title>Protocolli comuni</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Nome</entry> + <entry>Descrizione</entry> + </row> + </thead> + <tbody> + <row> + <entry>icmp</entry> + <entry> + L'Internet Control Message Protocol viene utilizzato principalmente dai gateway + e dagli host per riportare errori nelle comunicazioni con datagrammi. Il + comando "ping" (presente in quasi tutti i moderni sistemi operativi) è un esempio + dell'applicazione di ICMP. + </entry> + </row> + <row> + <entry>udp</entry> + <entry> + Lo User Datagram Protocol è un protocollo privo di connessione, + inaffidabile con record di lunghezza fissa. Per questo l'UDP + richiede poco overhead di protocollo. + </entry> + </row> + <row> + <entry>tcp</entry> + <entry> + Il Transmission Control Protocol è un procotollo affidabile, basato sulla connessione, + orientato al flusso, full duplex. Il TCP garantisce che tutti i pacchetti + siano ricevuti nel medesimo ordine in cui siano stati inviati. Se un pacchetto + viene perso durante la trasmissione, il TCP provvederà automaticamente alla ritrasmissione + fino a quando l'host remoto non conferma la ricezione dello stesso. Per ragioni + di affidabilità e di prestazioni, è il TCP stesso a decidere l'appropriata dimensione + dei pacchetti del sottostante livello di datagrammi. Pertanto le applicazioni TCP devono + permettere la parziale ritrasmissione di un record. + </entry> + </row> + </tbody> + </tgroup> + </table> <para> La funzione restituisce una risorsa di tipo socket se ha successo, oppure &false; in caso di errore. In quest'ultimo caso si può ottenere il codice di errore tramite <function>socket_last_error</function>. Tale codice può essere passato alla funzione <function>socket_strerror</function> per ottenere una descrizione dell'errore. - </para> - <para> - Per maggiori dettagli sull'utilizzo di <function>socket_create</function>, - e sul significato dei vari parametri si può consultare il - man di Unix alle pagine socket (2). </para> <note> <para>
« previous php.doc.it (#260) next »