<?xml version="1.0" encoding="UTF-8"?>

<!-- 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: n/a Maintainer: darvina Status: ready -->

<!-- OLD-Revision: 1.34/EN.1.4 -->

<refentry xml:id="function.socket-create" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>socket_create</refname>

<refpurpose>Crea un socket (punto terminale di una comunicazione).</refpurpose>

</refnamediv>

<refsect1>

<title>Descrizione</title>

<methodsynopsis>

<type>resource</type><methodname>socket_create</methodname>

<methodparam><type>int</type><parameter>dominio</parameter></methodparam>

<methodparam><type>int</type><parameter>tipo</parameter></methodparam>

<methodparam><type>int</type><parameter>protocollo</parameter></methodparam>

</methodsynopsis>

<para>

La funzione crea un punto terminale di una comunicazione (un 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 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_INET6</entry>

<entry>

Protocolli basati su IPv6. TCP ed UDP sono i protocolli più comuni

di questa famiglia. Il supporto a questa famiglia è stato aggiunto in PHP 5.0.0.

</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 comunicazione

da usare con il socket.

</para>

<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>

<note>

<para>

Se si forniscono valori non validi per

<parameter>dominio</parameter> o <parameter>tipo</parameter>,

la funzione <function>socket_create</function> imposta i parametri

rispettivamente a <constant>AF_INET</constant> e <constant>SOCK_STREAM</constant>

ed emette un messaggio di tipo <constant>E_WARNING</constant>.

</para>

</note>

<para>

Vedere anche

<function>socket_accept</function>,

<function>socket_bind</function>,

<function>socket_connect</function>,

<function>socket_listen</function>,

<function>socket_last_error</function> e

<function>socket_strerror</function>.

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->