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>