darvina Sun Jun 2 08:44:51 2002 EDT
Modified files:
/phpdoc-it/reference/sockets/functions socket-create.xml
Log:
Update to En 1.3
Index: phpdoc-it/reference/sockets/functions/socket-create.xml
diff -u phpdoc-it/reference/sockets/functions/socket-create.xml:1.2
phpdoc-it/reference/sockets/functions/socket-create.xml:1.3
--- phpdoc-it/reference/sockets/functions/socket-create.xml:1.2 Wed Apr 17 03:08:38
2002
+++ phpdoc-it/reference/sockets/functions/socket-create.xml Sun Jun 2 08:44:51
+2002
@@ -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.2 Maintainer: darvina Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- OLD-Revision: 1.34/EN.1.4 -->
<refentry id="function.socket-create">
<refnamediv>
@@ -12,34 +12,44 @@
<title>Descrizione</title>
<methodsynopsis>
<type>resource</type><methodname>socket_create</methodname>
- <methodparam><type>int</type><parameter>domain</parameter></methodparam>
- <methodparam><type>int</type><parameter>type</parameter></methodparam>
- <methodparam><type>int</type><parameter>protocol</parameter></methodparam>
+ <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>
&warn.experimental.func;
<para>
La funzione crea un punto terminale di una comunicazione (un socket)
- e restituisce un descrittore del socket.
+ e restituisce una risorsa di tipo socket.
</para>
<para>
- Il parametro <parameter>domain</parameter> indica il
- dominio. Attualmente i valori ammessi sono <constant>AF_INET</constant>
- e <constant>AF_UNIX</constant>.
+ 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).
</para>
<para>
- Il parametro <parameter>type</parameter> indica il tipo di socket.
+ 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>.
+ <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>.
</para>
<para>
- Il parametro <parameter>protocol</parameter> indica il protocollo.
+ Il parametro <parameter>protocollo</parameter> indica il protocollo e pu� essere
+ <constant>SOL_UDP</constant> oppure <constant>SOL_TCP</constant>.
</para>
<para>
- La funzione restituisce un descrittore di socket se ha successo, oppure un
- codice di errore negativo in caso di errore. Questo codice pu� essere
+ 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>
@@ -48,14 +58,23 @@
e sul significato dei vari parametri si pu� consultare il
man di Unix alle pagine socket (2).
</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_strerror</function> e
- <function>socket_get_status</function>.
+ <function>socket_last_error</function> e
+ <function>socket_strerror</function>.
</para>
</refsect1>
</refentry>
