cortesi Wed Feb 20 19:08:34 2002 EDT
Modified files:
/phpdoc/it/functions network.xml
Log:
update to EN 1.58
Index: phpdoc/it/functions/network.xml
diff -u phpdoc/it/functions/network.xml:1.13 phpdoc/it/functions/network.xml:1.14
--- phpdoc/it/functions/network.xml:1.13 Wed Feb 6 14:25:07 2002
+++ phpdoc/it/functions/network.xml Wed Feb 20 19:08:33 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.44 Maintainer: cortesi Status: ready -->
+<!-- EN-Revision: 1.56 Maintainer: cortesi Status: working -->
<!-- CREDITS: valente -->
<reference id="ref.network">
<title>Funzioni di rete</title>
@@ -140,7 +140,7 @@
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>fsockopen</methodname>
- <methodparam
choice="opt"><type>string</type><parameter>udp://hostname</parameter></methodparam>
+ <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
<methodparam><type>int</type><parameter>porta</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>errno</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>errstr</parameter></methodparam>
@@ -154,9 +154,10 @@
<parameter>port</parameter>. <parameter>hostname</parameter> pu� essere
in questo caso, sia un fully qualified domain name o un indirizzo IP.
Per le connessioni UDP, � necessario specificare esplicitamente il
- protocollo: <parameter>udp://hostname</parameter>. Per il dominio
- Unix, <parameter>hostname</parameter> viene utilizzato come percorso
- verso il socket, in questo caso, <parameter>porta</parameter> deve essere
impostato
+ protocollo, usando: '<literal>udp://</literal>' come prefisso di
+ <parameter>hostname</parameter>. Per il dominio Unix,
+ <parameter>hostname</parameter> viene utilizzato come percorso verso il
+ socket, in questo caso, <parameter>porta</parameter> deve essere impostato
a 0. Il parametro opzionale <parameter>timeout</parameter> pu� essere
usato per impostare un timeout in secondi per la chiamata di sistema connect.
</para>
@@ -172,12 +173,13 @@
<parameter>errno</parameter> e <parameter>errstr</parameter>
sono presenti, vengono impostati a indicare l'errore
a livello di sistema che � avvenuto nella chiamata alla funzione
- <literal>connect()</literal> del sistema operativo. Se il valore di errno
restituito � 0 e
+ <literal>connect()</literal> del sistema operativo. Se il valore di
+ <parameter>errno</parameter> restituito � <literal>0</literal> e
la funzione restituisce &false;, � un'indicazione che l'errore
� avvenuto prima della chiamata di <literal>connect()</literal>. Questo �
molto probabilmente legato ad un problema di inizializzazione del socket. Si
noti che
gli argomenti <parameter>errno</parameter> e
- <parameter>errstr</parameter> devono essere passati by
+ <parameter>errstr</parameter> verranno sempre passati by
reference.
</para>
<para>
@@ -461,26 +463,28 @@
<refpurpose>
Converts a string containing an (IPv4) Internet Protocol dotted address
into a proper address.
+ Converte una stringa contenente un indirizzo di rete del Protocollo Internet
+(IPv4)
+ in un indirizzo espresso come tipo di dato int.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>ip2long</methodname>
- <methodparam><type>string</type><parameter>ip_address</parameter></methodparam>
+
+<methodparam><type>string</type><parameter>indirizzo_ip</parameter></methodparam>
</methodsynopsis>
<para>
- The function <function>ip2long</function> generates an IPv4 Internet
- network address from its Internet standard format (dotted string)
- representation.
+ La funzione <function>ip2long</function> genera un indirizzo di rete Internet
+IPv4
+ a partire dalla rappresentazione in formato standard
+ (stringa separata da punti).
<example>
- <title><function>ip2long</function> Example</title>
+ <title>Esempio di <function>ip2long</function></title>
<programlisting role="php">
<![CDATA[
<?php
$ip = gethostbyname("www.php.net");
$out = "I seguenti URL sono equivalenti:<br>\n";
-$out .= "http://www.php.net/, http://".$ip."/, and
http://".sprintf("%u",ip2long($ip))."/<br>\n";
+$out .= "http://www.php.net/, http://".$ip."/, e
+http://".sprintf("%u",ip2long($ip))."/<br>\n";
echo $out;
?>
]]>
@@ -488,16 +492,16 @@
</example>
<note>
<para>
- Because PHP's integer type is signed, and many IP addresses will
- result in negative integers, you need to use the "%u" formatter of
- <function>sprintf</function> or <function>printf</function> to get
- the string representation of the unsigned IP address.
+ Poich� il tipo di dato integer in PHP � signed e molti indirizzi IP
+risulterebbero essere
+ interi negativi, � necessario usare il formattatore "%u" della funzione
+ <function>sprintf</function> e <function>printf</function> per ottenere
+ la rappresentazione in stringa dell'indirizzo IP in modo nsigned.
</para>
</note>
- This second example shows how to print a converted address with the
- <function>printf</function> function :
+ Questo secondo esempio mostra come stampare un indirizzo convertito, usando la
+ funzione <function>printf</function>:
<example>
- <title>Displaying an IP address</title>
+ <title>Visualizzazione di un indirizzo IP</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -519,8 +523,8 @@
<refnamediv>
<refname>long2ip</refname>
<refpurpose>
- Converts an (IPv4) Internet network address into a string in Internet
- standard dotted format
+ Converte un indirizzo di rete del Protocollo Internet (IPv4) in una stringa
+contenente
+ un indirizzo espresso secondo la notazione standard di Internet.
</refpurpose>
</refnamediv>
<refsect1>
@@ -530,9 +534,9 @@
<methodparam><type>int</type><parameter>proper_address</parameter></methodparam>
</methodsynopsis>
<para>
- The function <function>long2ip</function> generates an Internet address
- in dotted format (i.e.: aaa.bbb.ccc.ddd) from the proper address
- representation.
+ La funzione <function>long2ip</function> genera un indirizzo Internet
+ in formato separato da punti (es.: aaa.bbb.ccc.ddd) a partire dalla
+rappresentazione
+ propria.
</para>
<para>
Vedere anche: <function>ip2long</function>
@@ -543,7 +547,7 @@
<refentry id="function.openlog">
<refnamediv>
<refname>openlog</refname>
- <refpurpose>Open connection to system logger</refpurpose>
+ <refpurpose>Apre una connessione al logger di sistema</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -554,129 +558,129 @@
<methodparam><type>int</type><parameter>facility</parameter></methodparam>
</methodsynopsis>
<para>
- <function>openlog</function> opens a connection to the system
- logger for a program. The string <parameter>ident</parameter> is
- added to each message. Values for <parameter>option</parameter>
- and <parameter>facility</parameter> are given below.
- The <parameter>option</parameter> argument is used to indicate
- what loggin options will be used when generating a log message.
- The <parameter>facility</parameter> argument is used to specify what
- type of program is logging the message. This allows you to specify
- (in your machine's syslog configuration) how messages coming from
- different facilities will be handled.
- The use of <function>openlog</function> is optional. It
- will automatically be called by <function>syslog</function> if
- necessary, in which case <parameter>ident</parameter> will default
- to &false;.
+ <function>openlog</function> apre una connessione al logger di
+ sistema per un programma. La stringa <parameter>ident</parameter> viene
+ aggiunta a ogni messaggio. Valori per <parameter>option</parameter>
+ e <parameter>facility</parameter> sono dati di seguito.
+ L'argomento <parameter>option</parameter> viene usato per indicare
+ quali opzioni di loggin verranno usate durante la generazione di un messaggio di
+log.
+ L'argomento <parameter>facility</parameter> viene usato per specificare quale
+ tipo di programma sta loggando il messaggio. Questo permette di specificare
+ (nella comfigurazione del syslog della macchina) come trattare i messaggi
+provenienti dalle
+ diverse facility.
+ L'uso di <function>openlog</function> � opzionale. Viene
+ chiamato automaticamente da <function>syslog</function> se
+ necessario, in tal caso <parameter>ident</parameter> sar� di default
+ &false;.
</para>
<para>
<table>
- <title><function>openlog</function> Options</title>
+ <title>Opzioni di <function>openlog</function></title>
<tgroup cols="2">
<thead>
<row>
- <entry>Constant</entry>
- <entry>Description</entry>
+ <entry>Costante</entry>
+ <entry>Descrizione</entry>
</row>
</thead>
<tbody>
<row>
<entry>LOG_CONS</entry>
<entry>
- if there is an error while sending data to the system logger,
- write directly to the system console
+ se si verifica un errore durante l'invio dei dati al logger di sistema,
+ scrive direttamente sulla console di sistema
</entry>
</row>
<row>
<entry>LOG_NDELAY</entry>
<entry>
- open the connection to the logger immediately
+ apre immediatamente una connessione al logger
</entry>
</row>
<row>
<entry>LOG_ODELAY</entry>
<entry>
- (default) delay openning the connection until the first
- message is logged
+ (default) ritarda l'apertura della connessione fino a quando non viene
+loggato
+ il primo messaggio
</entry>
</row>
<row>
<entry>LOG_PERROR</entry>
- <entry>print log message also to standard error</entry>
+ <entry>stampa un messaggio di log anche su standard error</entry>
</row>
<row>
<entry>LOG_PID</entry>
- <entry>include PID with each message</entry>
+ <entry>include il PID in ciascun messaggio</entry>
</row>
</tbody>
</tgroup>
</table>
- You can use one or more of this options. When using multiple options
- you need to <literal>OR</literal> them, i.e. to open the connection
- immediately, write to the consoloe and include the PID in each message,
- you will use: <literal>LOG_CONS | LOG_NDELAY | LOG_PID</literal>
+ Si possono usare una o pi� di queste opzioni. Usando opzioni multiple
+ � necessario usare <literal>OR</literal>, ad esempio per aprire la connessione
+ immediatamente, scrivere sulla console e il PID in ciascun messaggio,
+ si dovr� usare: <literal>LOG_CONS | LOG_NDELAY | LOG_PID</literal>
</para>
<para>
<table>
- <title><function>openlog</function> Facilities</title>
+ <title>Facility di <function>openlog</function></title>
<tgroup cols="2">
<thead>
<row>
- <entry>Constant</entry>
- <entry>Description</entry>
+ <entry>Costante</entry>
+ <entry>Descrizione</entry>
</row>
</thead>
<tbody>
<row>
<entry>LOG_AUTH</entry>
<entry>
- security/authorization messages (use LOG_AUTHPRIV instead
- in systems where that constant is defined)
+ messaggi di sicurezza/autorizzazione (usa LOG_AUTHPRIV
+ nei sistemi dove � definita quella costante)
</entry>
</row>
<row>
<entry>LOG_AUTHPRIV</entry>
- <entry>security/authorization messages (private)</entry>
+ <entry>messaggi di sicurezza/autorizzazione (private)</entry>
</row>
<row>
<entry>LOG_CRON</entry>
- <entry>clock daemon (cron and at)</entry>
+ <entry>clock daemon (cron e at)</entry>
</row>
<row>
<entry>LOG_DAEMON</entry>
- <entry>other system daemons</entry>
+ <entry>altri demoni di sistema</entry>
</row>
<row>
<entry>LOG_KERN</entry>
- <entry>kernel messages</entry>
+ <entry>messaggi del kernel</entry>
</row>
<row>
<entry>LOG_LOCAL0 ... LOG_LOCAL7</entry>
- <entry>reserved for local use</entry>
+ <entry>riservato per il locale</entry>
</row>
<row>
<entry>LOG_LPR</entry>
- <entry>line printer subsystem</entry>
+ <entry>sottosistema line printer</entry>
</row>
<row>
<entry>LOG_MAIL</entry>
- <entry>mail subsystem</entry>
+ <entry>sottosistema mail</entry>
</row>
<row>
<entry>LOG_NEWS</entry>
- <entry>USENET news subsystem</entry>
+ <entry>sottosistema news di USENET</entry>
</row>
<row>
<entry>LOG_SYSLOG</entry>
- <entry>messages generated internally by syslogd</entry>
+ <entry>messaggi generati internamente da syslogd</entry>
</row>
<row>
<entry>LOG_USER</entry>
- <entry>generic user-level messages</entry>
+ <entry>messaggi generici user-level</entry>
</row>
<row>
<entry>LOG_UUCP</entry>
- <entry>UUCP subsystem</entry>
+ <entry>sottosistema UUCP</entry>
</row>
</tbody>
</tgroup>
@@ -684,7 +688,7 @@
</para>
<para>
Vedere anche <function>define_syslog_variables</function>,
- <function>syslog</function> and
+ <function>syslog</function> e
<function>closelog</function>.
</para>
</refsect1>
@@ -694,7 +698,7 @@
<refnamediv>
<refname>pfsockopen</refname>
<refpurpose>
- Open persistent Internet or Unix domain socket connection
+ Apre una connessione persistente Internet o di tipo domain socket Unix
</refpurpose>
</refnamediv>
<refsect1>
@@ -708,9 +712,9 @@
<methodparam
choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
</methodsynopsis>
<para>
- This function behaves exactly as <function>fsockopen</function>
- with the difference that the connection is not closed after the
- script finishes. It is the persistent version of
+ Questa funzione si comporta esattamente come <function>fsockopen</function>
+ con la differenza che la connessione non viene chiusa dopo che lo script
+ ha finito la sua esecuzione. È la versione persistente di
<function>fsockopen</function>.
</para>
</refsect1>
@@ -720,7 +724,7 @@
<refnamediv>
<refname>socket_get_status</refname>
<refpurpose>
- Returns information about existing socket resource
+ Restituisce informazioni su una risorsa socket esistente
</refpurpose>
</refnamediv>
<refsect1>
@@ -730,30 +734,30 @@
<methodparam><type>resource</type><parameter>socket_get_status</parameter></methodparam>
</methodsynopsis>
<para>
- Returns information about an existing socket resource. Currently
- returns four entries in the result array:
+ Restituisce informazioni su una risorsa socket esistente. Attualmente
+ restituisce quattro campi nell'array risultante:
</para>
<itemizedlist>
<listitem>
<para>
- <parameter>timed_out</parameter> (bool) - The socket timed out
- waiting for data
+ <parameter>timed_out</parameter> (bool) - Il socket � andato in time out
+ aspettando i dati
</para>
</listitem>
<listitem>
<para>
- <parameter>blocked</parameter> (bool) - The socket was blocked
+ <parameter>blocked</parameter> (bool) - Il socket � bloccato
</para>
</listitem>
<listitem>
<para>
- <parameter>eof</parameter> (bool) - Indicates EOF event
+ <parameter>eof</parameter> (bool) - Indica l'evento EOF
</para>
</listitem>
<listitem>
<para>
- <parameter>unread_bytes</parameter> (int) - Number of bytes
- left in the socket buffer
+ <parameter>unread_bytes</parameter> (int) - Numero di byte
+ rimasti nel buffer del socket
</para>
</listitem>
</itemizedlist>
@@ -762,7 +766,7 @@
<function>socket_bind</function>,
<function>socket_connect</function>,
<function>socket_listen</function>,
- <function>socket_strerror</function>, and the
+ <function>socket_strerror</function> e la
<link linkend="ref.sockets">Socket extension</link>.
</para>
</refsect1>