cvs: phpdoc-it /reference/dio/functions dio-fcntl.xml dio-open.xml dio-read.xml dio-seek.xml dio-stat.xml dio-tcsetattr.xml dio-truncate.xml
dio-write.xml
| From: | Andrioli Darvin | Date: | Tue, 10 May 2005 12:38:27 +0000 |
| Subject: | cvs: phpdoc-it /reference/dio/functions dio-fcntl.xml dio-open.xml dio-read.xml dio-seek.xml dio-stat.xml dio-tcsetattr.xml dio-truncate.xml dio-write.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-712@lists.php.net to get a copy of this message | ||
darvina Tue May 10 08:38:27 2005 EDT
Modified files:
/phpdoc-it/reference/dio/functions dio-fcntl.xml dio-open.xml
dio-read.xml dio-seek.xml
dio-stat.xml dio-tcsetattr.xml
dio-truncate.xml dio-write.xml
Log:
Sync to En tree
http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-fcntl.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dio/functions/dio-fcntl.xml diff -u phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.5 phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.6 --- phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.5 Thu Apr 21 08:33:25 2005 +++ phpdoc-it/reference/dio/functions/dio-fcntl.xml Tue May 10 08:38:26 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: darvina Status: ready --> <refentry id="function.dio-fcntl"> <refnamediv> <refname>dio_fcntl</refname> @@ -37,11 +37,11 @@ <term><parameter>cmd</parameter></term> <listitem> <para> - può indicare una delle seguenti operazioni: + Può indicare una delle seguenti operazioni: <itemizedlist> <listitem> <para> - <constant>F_SETLK</constant> -mposta o azzera un lock. Se il lock è impostato + <constant>F_SETLK</constant> - imposta o azzera un lock. Se il lock è impostato da un'altro processo la funzione <function>dio_fcntl</function> restituisce -1. </para> @@ -101,7 +101,8 @@ </listitem> <listitem> <para> - "wenth" - a cosa l_start è relativo: può valere <constant>SEEK_SET</constant>, + "wenth" - a cosa l_start è relativo: + può valere <constant>SEEK_SET</constant>, <constant>SEEK_END</constant> o <constant>SEEK_CUR</constant> </para> </listitem> @@ -135,6 +136,7 @@ <?php $fd = dio_open('/dev/ttyS0', O_RDWR); + if (dio_fcntl($fd, F_SETLK, Array("type"=>F_WRLCK)) == -1) { // the file descriptor appears locked echo "The lock can not be cleared. It is held by someone else."; http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-open.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dio/functions/dio-open.xml diff -u phpdoc-it/reference/dio/functions/dio-open.xml:1.4 phpdoc-it/reference/dio/functions/dio-open.xml:1.5 --- phpdoc-it/reference/dio/functions/dio-open.xml:1.4 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-open.xml Tue May 10 08:38:26 2005 @@ -1,95 +1,141 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-open"> - <refnamediv> - <refname>dio_open</refname> - <refpurpose> - Apre un nuovo file nella modalità specificata da flags e - i permessi indicati in mode - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>resource</type><methodname>dio_open</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_open</function> apre un file e restituisce un nuovo descrittore di file - per questo, oppure &false; se si verificano problemi. Se - <parameter>flags</parameter> viene impostato a O_CREAT, nel terzo parametro, opzionale, - <parameter>mode</parameter> verranno impostati i permessi del file - (permessi di creazione). Il parametro <parameter>flags</parameter> - può avere i seguenti valori: - <itemizedlist> - <listitem> - <para>O_RDONLY - apre il file per accessi in lettura.</para> - </listitem> - <listitem> - <para>O_WRONLY - apre il file in scrittura.</para> - </listitem> - <listitem> - <para> - O_RDWR - apre il file sia in lettura sia - in scrittura. - </para> - </listitem> - </itemizedlist> - Il parametro <parameter>flags</parameter> può includere qualsiasi combinazione - dei seguenti valori: - <itemizedlist> - <listitem> - <para> - O_CREAT - crea un file, se questo non esiste già. - </para> - </listitem> - <listitem> - <para> - O_EXCL - se sono impostati sia O_CREAT e sia O_EXCL, - la funzione <function>dio_open</function> fallisce se il file esiste. - </para> - </listitem> - <listitem> - <para> - O_TRUNC - se il file esiste, ed è aperto in scrittura, - il file verrà portato a lunghezza zero. - </para> - </listitem> - <listitem> - <para> - O_APPEND - nelle operazioni di scrittura, scrive i dati - alla fine del file. - </para> - </listitem> - <listitem> - <para>O_NONBLOCK - imposta la modalità non blocking. - </para> - </listitem> - </itemizedlist> - </para> - <para> - Vedere anche: <function>dio_close</function>. - </para> - <example> - <title> - Impostare la velocità di una porta seriale - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> +<refentry id="function.dio-open"> + <refnamediv> + <refname>dio_open</refname> + <refpurpose> + Apre un nuovo file nella modalità specificata da flags e + i permessi indicati in mode + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>dio_open</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_open</function> apre un file e restituisce un nuovo descrittore di file + per questo. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Il file aperto. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + Il parametro <parameter>flags</parameter> può contenere qualsiasi combinazione + dei seguenti valori: + <itemizedlist> + <listitem> + <para> + <constant>O_CREAT</constant> - crea un file, se questo + non esiste già. + </para> + </listitem> + <listitem> + <para> + <constant>O_EXCL</constant> - se sono impostati sia <constant>O_CREAT</constant> + e sia <constant>O_EXCL</constant>, + la funzione <function>dio_open</function> fallisce se il file esiste. + </para> + </listitem> + <listitem> + <para> + <constant>O_TRUNC</constant> - se il file esiste, ed è aperto in scrittura, + il file verrà portato a lunghezza zero. + </para> + </listitem> + <listitem> + <para> + <constant>O_APPEND</constant> - nelle operazioni di scrittura, scrive i dati + alla fine del file. + </para> + </listitem> + <listitem> + <para> + <constant>O_NONBLOCK</constant> - imposta la modalità non blocking. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + Se <parameter>flags</parameter> vale <constant>O_CREAT</constant>, + allora il parametro <parameter>mode</parameter> imposta la modalità del file + (permessi di creazione). + <itemizedlist> + <listitem> + <para> + <constant>O_RDONLY</constant> - apre il file per accessi in lettura. + </para> + </listitem> + <listitem> + <para> + <constant>O_WRONLY</constant> - apre il file in scrittura. + </para> + </listitem> + <listitem> + <para> + <constant>O_RDWR</constant> - apre il file sia in lettura sia + in scrittura. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Restituisce un descrittore di file, oppure &false; in caso di errore. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Impostare la velocità di una porta seriale</title> + <programlisting role="php"> <![CDATA[ <?php - + $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); - + dio_close($fd); ?> ]]> - </programlisting> - </example> - </refsect1> - </refentry> + </programlisting> + </example> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-read.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dio/functions/dio-read.xml diff -u phpdoc-it/reference/dio/functions/dio-read.xml:1.3 phpdoc-it/reference/dio/functions/dio-read.xml:1.4 --- phpdoc-it/reference/dio/functions/dio-read.xml:1.3 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/dio/functions/dio-read.xml Tue May 10 08:38:26 2005 @@ -1,33 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-read"> - <refnamediv> - <refname>dio_read</refname> - <refpurpose> - Legge n bytes da un descrittore fd e li restituisce, se n non è - specificato, legge un blocco da 1k - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>string</type><methodname>dio_read</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>n</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_read</function> legge e restituisce - <parameter>n</parameter> bytes dal file indicato dal descrittore - <parameter>fd</parameter>. Se <parameter>n</parameter> viene omesso, - la funzione <function>dio_read</function> leggerà e restituirà - un blocco da 1k. - </para> - <para> - Vedere anche: <function>dio_write</function>. - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> +<refentry id="function.dio-read"> + <refnamediv> + <refname>dio_read</refname> + <refpurpose>Legge n bytes da un descrittore di file</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dio_read</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>len</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_read</function> legge e restituisce + <parameter>len</parameter> bytes dal file indicato dal descrittore + <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>len</parameter></term> + <listitem> + <para> + Numero di byte da leggere. Se non indicato + <function>dio_read</function> legge blocchi da un 1k. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + I byte letti da <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_write</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-seek.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dio/functions/dio-seek.xml diff -u phpdoc-it/reference/dio/functions/dio-seek.xml:1.4 phpdoc-it/reference/dio/functions/dio-seek.xml:1.5 --- phpdoc-it/reference/dio/functions/dio-seek.xml:1.4 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-seek.xml Tue May 10 08:38:26 2005 @@ -1,83 +1,120 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-seek"> - <refnamediv> - <refname>dio_seek</refname> - <refpurpose>Si posiziona al byte pos del file indicato da fd</refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>int</type><methodname>dio_seek</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>int</type><parameter>pos</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_seek</function> viene utilizzata per modificare la - posizione nel file con descrittore - <parameter>fd</parameter>. Il parametro - <parameter>whence</parameter> specifica come debba essere interpretata la - posizione indicata da <parameter>pos</parameter>: - <itemizedlist> - <listitem> - <para> - SEEK_SET (default) - Indica che <parameter>pos</parameter> è - determinato dall'inizio del file. - </para> - </listitem> - <listitem> - <para> - SEEK_CUR - Indica che <parameter>pos</parameter> è il numero - di caratteri dalla posizione attuale. Questo valore può essere - positivo o negativo. - </para> - </listitem> - <listitem> - <para> - SEEK_END - Indica che <parameter>pos</parameter> è il numero - di caratteri dalla fine del file. Un valore negativo - specifica una posizione all'interno dell'estensione del file; - un valore positivo specifica una posizione oltre la fine corrente del file. - Se si specifica una posizione oltre la fine del file, e vi si scrive - dei dati, il file sarà allungato e riempito di zero fino a quella - posizione. - </para> - </listitem> - </itemizedlist> - <example> - <title> - Impostare la velocità di una porta seriale - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> +<refentry id="function.dio-seek"> + <refnamediv> + <refname>dio_seek</refname> + <refpurpose>Si posiziona al byte pos del file indicato da fd</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dio_seek</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>int</type><parameter>pos</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_seek</function> viene utilizzata per modificare la + posizione nel file indicato dal descrittore <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pos</parameter></term> + <listitem> + <para> + La nuova posizione. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>whence</parameter></term> + <listitem> + <para> + specifica come debba essere interpretata la + posizione indicata da <parameter>pos</parameter>: + <itemizedlist> + <listitem> + <para> + <constant>SEEK_SET</constant> (default) - Indica + che <parameter>pos</parameter> è + determinato dall'inizio del file. + </para> + </listitem> + <listitem> + <para> + <constant>SEEK_CUR</constant> - Indica che <parameter>pos</parameter> è il numero + di caratteri dalla posizione attuale. Questo valore può essere + positivo o negativo. + </para> + </listitem> + <listitem> + <para> + <constant>SEEK_END</constant> - Indica che <parameter>pos</parameter> è il numero + di caratteri dalla fine del file. Un valore negativo + specifica una posizione all'interno dell'estensione del file; + un valore positivo specifica una posizione oltre la fine corrente del file. + Se si specifica una posizione oltre la fine del file, e vi si scrive + dei dati, il file sarà allungato e riempito di zero fino a quella + posizione. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Impostare la velocità di una porta seriale</title> + <programlisting role="php"> <![CDATA[ <?php - + $fd = dio_open('/dev/ttyS0', O_RDWR); - + dio_seek($fd, SEEK_SET, 10); // Si posiziona a 10 caratteri dall'inizio del file - + dio_seek($fd, SEEK_CUR, -2); // Si posiziona a 8 caratteri dall'inizio del file - + dio_seek($fd, SEEK_END, 5); // Si posiziona a 5 caratteri dalla fine del file - + dio_seek($fd, SEEK_END, -10); // Si posiziona a 10 caratteri dopo la fine del file // i 10 caratteri tra la fine del file e la posizione corrente // sono riempiti con zero. - + dio_close($fd); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-stat.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/dio/functions/dio-stat.xml diff -u phpdoc-it/reference/dio/functions/dio-stat.xml:1.2 phpdoc-it/reference/dio/functions/dio-stat.xml:1.3 --- phpdoc-it/reference/dio/functions/dio-stat.xml:1.2 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/dio/functions/dio-stat.xml Tue May 10 08:38:26 2005 @@ -1,48 +1,113 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-stat"> - <refnamediv> - <refname>dio_stat</refname> - <refpurpose> - Restituisce le informazioni relative al file indicato da fd - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>array</type><methodname>dio_stat</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_stat</function> restituisce le informazioni - sul file con descrittore - <parameter>fd</parameter>. <function>dio_stat</function> restituisce - un array associativo contenente le seguenti chiavi: - <itemizedlist> - <listitem><para>"device" - device</para></listitem> - <listitem><para>"inode" - inode</para></listitem> - <listitem><para>"mode" - mode</para></listitem> - <listitem><para>"nlink" - numero di link</para></listitem> - <listitem><para>"uid" - user id</para></listitem> - <listitem><para>"gid" - group id</para></listitem> - <listitem> - <para> - "device_type" - device type (se inode device) - </para> - </listitem> - <listitem><para>"size" - dimensione totale in byte</para></listitem> - <listitem><para>"blocksize" - blocksize</para></listitem> - <listitem><para>"blocks" - numero di blocchi allocati</para></listitem> - <listitem><para>"atime" - data dell'ultimo accesso</para></listitem> - <listitem><para>"mtime" - data dell'ultima modifica</para></listitem> - <listitem><para>"ctime" - data dell'ultimo cambiamento</para></listitem> - </itemizedlist> - Se si verifica un errore la funzione <function>dio_stat</function> restituisce - &null;. - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<refentry id="function.dio-stat"> + <refnamediv> + <refname>dio_stat</refname> + <refpurpose> + Restituisce le informazioni relative al file indicato da fd + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dio_stat</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_stat</function> restituisce le informazioni + sul dato descrittore di file. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Restituisce un array associativo contenente le seguenti chiavi: + <itemizedlist> + <listitem> + <para> + "device" - device + </para> + </listitem> + <listitem> + <para> + "inode" - inode + </para> + </listitem> + <listitem> + <para> + "mode" - mode + </para> + </listitem> + <listitem> + <para> + "nlink" - numero di link + </para> + </listitem> + <listitem> + <para> + "uid" - user id + </para> + </listitem> + <listitem> + <para> + "gid" - group id + </para> + </listitem> + <listitem> + <para> + "device_type" - device type (se inode device) + </para> + </listitem> + <listitem> + <para> + "size" - total size in bytes + </para> + </listitem> + <listitem> + <para> + "blocksize" - blocksize + </para> + </listitem> + <listitem> + <para> + "blocks" - dimensione totale in byte + </para> + </listitem> + <listitem> + <para> + "atime" - data dell'ultimo accesso + </para> + </listitem> + <listitem> + <para> + "mtime" - data dell'ultima modifica + </para> + </listitem> + <listitem> + <para> + "ctime" - data dell'ultimo cambiamento + </para> + </listitem> + </itemizedlist> + Se si verifica un errore la funzione <function>dio_stat</function> restituisce &null;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-tcsetattr.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dio/functions/dio-tcsetattr.xml diff -u phpdoc-it/reference/dio/functions/dio-tcsetattr.xml:1.5 phpdoc-it/reference/dio/functions/dio-tcsetattr.xml:1.6 --- phpdoc-it/reference/dio/functions/dio-tcsetattr.xml:1.5 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-tcsetattr.xml Tue May 10 08:38:26 2005 @@ -1,61 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-tcsetattr"> - <refnamediv> - <refname>dio_tcsetattr</refname> - <refpurpose> - Imposta gli attributi terminale e la velocità per una porta seriale - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>void</type><methodname>dio_tcsetattr</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>array</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_tcsetattr</function> imposta - gli attributi di terminale e la velocità della porta aperta - <parameter>fd</parameter>. Attualmente le opzioni disponibili sono: - <itemizedlist> - <listitem> - <para> - 'baud' - velocità della porta - può essere 38400,19200,9600,4800,2400,1800,1200,600,300,200,150,134,110,75 oppure 50, - il valore di default è 9600 - </para> - </listitem> - <listitem> - <para> - 'bits' - bit di dati - può essere 8,7,6 oppure 5 - il valore di default è 8 - </para> - </listitem> - <listitem> - <para> - 'stop' - bit di stop - può essere 1 o 2 - il valore di default è 1 - </para> - </listitem> - <listitem> - <para> - 'parity' - può essere 0,1 o 2 - il valore di default è 0 - </para> - </listitem> - </itemizedlist> - <example> - <title> - Esempio di impostazione della velocità di una porta seriale - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.10 Maintainer: darvina Status: ready --> +<refentry id="function.dio-tcsetattr"> + <refnamediv> + <refname>dio_tcsetattr</refname> + <refpurpose> + Imposta gli attributi terminale e la velocità per una porta seriale + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <void/><methodname>dio_tcsetattr</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>array</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_tcsetattr</function> imposta + gli attributi di terminale e la velocità della porta aperta <parameter>fd</parameter>. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Attualmente le opzioni disponibili sono: + <itemizedlist> + <listitem> + <para> + 'baud' - velocità della porta - può essere 38400,19200,9600,4800,2400,1800,1200,600,300,200,150,134,110,75 oppure 50, + il valore di default è 9600 + </para> + </listitem> + <listitem> + <para> + 'bits' - bit di dati - può essere 8,7,6 oppure 5 il valore di default è 8. + </para> + </listitem> + <listitem> + <para> + 'stop' - bit di stop - può essere 1 o 2 il valore di default è 1. + </para> + </listitem> + <listitem> + <para> + 'parity' - può essere 0,1 o 2 il valore di default è 0. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio di impostazione della velocità di una porta seriale</title> + <programlisting role="php"> <![CDATA[ <?php $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); -dio_fcntl($fd, F_SETFL, O_SYNC ); +dio_fcntl($fd, F_SETFL, O_SYNC); dio_tcsetattr($fd, array( 'baud' => 9600, @@ -75,12 +103,11 @@ ?> ]]> - </programlisting> - </example> - </para> - ¬e.no-windows; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-truncate.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dio/functions/dio-truncate.xml diff -u phpdoc-it/reference/dio/functions/dio-truncate.xml:1.3 phpdoc-it/reference/dio/functions/dio-truncate.xml:1.4 --- phpdoc-it/reference/dio/functions/dio-truncate.xml:1.3 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-truncate.xml Tue May 10 08:38:26 2005 @@ -1,33 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-truncate"> - <refnamediv> - <refname>dio_truncate</refname> - <refpurpose> - Tronca il file indicato da fd ad un numero di byte specificato - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>bool</type><methodname>dio_truncate</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_truncate</function> tronca il - file indicato da <parameter>fd</parameter> ad una lunghezza - massima di <parameter>offset</parameter> bytes. Se in precedenza il file - ha una dimensione maggiore, i dati in eccesso sono persi. - Al contrario se il file è più corto, non è specificato se si - debba lasciarlo inalterato o debba essere allungato. Nell'ultimo caso - la parte aggiunta viene riempita di zero. - &return.success;. - </para> - ¬e.no-windows; - </refsect1> - </refentry> +<refentry id="function.dio-truncate"> + <refnamediv> + <refname>dio_truncate</refname> + <refpurpose> + Tronca il file indicato da fd ad un numero di byte specificato + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dio_truncate</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_truncate</function> tronca il file indicato da <parameter>fd</parameter> ad una lunghezza + massima di <parameter>offset</parameter> bytes. + </para> + <para> + Se in precedenza il file + ha una dimensione maggiore, i dati in eccesso sono persi. + Al contrario se il file è più corto, non è specificato se si + debba lasciarlo inalterato o debba essere allungato. Nell'ultimo caso la parte aggiunta viene riempita a zero. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Posizione in byte. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-write.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/dio/functions/dio-write.xml diff -u phpdoc-it/reference/dio/functions/dio-write.xml:1.2 phpdoc-it/reference/dio/functions/dio-write.xml:1.3 --- phpdoc-it/reference/dio/functions/dio-write.xml:1.2 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/dio/functions/dio-write.xml Tue May 10 08:38:26 2005 @@ -1,35 +1,72 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-write"> - <refnamediv> - <refname>dio_write</refname> - <refpurpose> - Scrive dati sul file indicato da fd con la possibilità di troncarne la lunghezza - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>int</type><methodname>dio_write</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>len</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_write</function> scrive fino a - <parameter>len</parameter> bytes da <parameter>data</parameter> - nel file <parameter>fd</parameter>. Se il parametro <parameter>len</parameter> - viene omesso, <function>dio_write</function> scrive tutto il contenuto di - <parameter>data</parameter> nel file indicato. - La funzione <function>dio_write</function> restituisce il numero di byte - scritti in <parameter>fd</parameter>. - </para> - <para> - Vedere anche <function>dio_read</function>. - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<refentry id="function.dio-write"> + <refnamediv> + <refname>dio_write</refname> + <refpurpose> + Scrive dati sul file indicato da fd con la possibilità di troncarne la lunghezza + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dio_write</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>len</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_write</function> scrive fino a <parameter>len</parameter> + bytes da <parameter>data</parameter> nel file <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + I dati scritti. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>len</parameter></term> + <listitem> + <para> + Lunghezza dei dati da scrivere in byte. Se non indicato, la + funzione scrive tutti i dati nel file indicato. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + La funzione restituisce il numero di byte scritti in <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_read</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-fcntl.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dio/functions/dio-fcntl.xml diff -u phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.5 phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.6 --- phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.5 Thu Apr 21 08:33:25 2005 +++ phpdoc-it/reference/dio/functions/dio-fcntl.xml Tue May 10 08:38:26 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: darvina Status: ready --> <refentry id="function.dio-fcntl"> <refnamediv> <refname>dio_fcntl</refname> @@ -37,11 +37,11 @@ <term><parameter>cmd</parameter></term> <listitem> <para> - può indicare una delle seguenti operazioni: + Può indicare una delle seguenti operazioni: <itemizedlist> <listitem> <para> - <constant>F_SETLK</constant> -mposta o azzera un lock. Se il lock è impostato + <constant>F_SETLK</constant> - imposta o azzera un lock. Se il lock è impostato da un'altro processo la funzione <function>dio_fcntl</function> restituisce -1. </para> @@ -101,7 +101,8 @@ </listitem> <listitem> <para> - "wenth" - a cosa l_start è relativo: può valere <constant>SEEK_SET</constant>, + "wenth" - a cosa l_start è relativo: + può valere <constant>SEEK_SET</constant>, <constant>SEEK_END</constant> o <constant>SEEK_CUR</constant> </para> </listitem> @@ -135,6 +136,7 @@ <?php $fd = dio_open('/dev/ttyS0', O_RDWR); + if (dio_fcntl($fd, F_SETLK, Array("type"=>F_WRLCK)) == -1) { // the file descriptor appears locked echo "The lock can not be cleared. It is held by someone else."; http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-open.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dio/functions/dio-open.xml diff -u phpdoc-it/reference/dio/functions/dio-open.xml:1.4 phpdoc-it/reference/dio/functions/dio-open.xml:1.5 --- phpdoc-it/reference/dio/functions/dio-open.xml:1.4 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-open.xml Tue May 10 08:38:26 2005 @@ -1,95 +1,141 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-open"> - <refnamediv> - <refname>dio_open</refname> - <refpurpose> - Apre un nuovo file nella modalità specificata da flags e - i permessi indicati in mode - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>resource</type><methodname>dio_open</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_open</function> apre un file e restituisce un nuovo descrittore di file - per questo, oppure &false; se si verificano problemi. Se - <parameter>flags</parameter> viene impostato a O_CREAT, nel terzo parametro, opzionale, - <parameter>mode</parameter> verranno impostati i permessi del file - (permessi di creazione). Il parametro <parameter>flags</parameter> - può avere i seguenti valori: - <itemizedlist> - <listitem> - <para>O_RDONLY - apre il file per accessi in lettura.</para> - </listitem> - <listitem> - <para>O_WRONLY - apre il file in scrittura.</para> - </listitem> - <listitem> - <para> - O_RDWR - apre il file sia in lettura sia - in scrittura. - </para> - </listitem> - </itemizedlist> - Il parametro <parameter>flags</parameter> può includere qualsiasi combinazione - dei seguenti valori: - <itemizedlist> - <listitem> - <para> - O_CREAT - crea un file, se questo non esiste già. - </para> - </listitem> - <listitem> - <para> - O_EXCL - se sono impostati sia O_CREAT e sia O_EXCL, - la funzione <function>dio_open</function> fallisce se il file esiste. - </para> - </listitem> - <listitem> - <para> - O_TRUNC - se il file esiste, ed è aperto in scrittura, - il file verrà portato a lunghezza zero. - </para> - </listitem> - <listitem> - <para> - O_APPEND - nelle operazioni di scrittura, scrive i dati - alla fine del file. - </para> - </listitem> - <listitem> - <para>O_NONBLOCK - imposta la modalità non blocking. - </para> - </listitem> - </itemizedlist> - </para> - <para> - Vedere anche: <function>dio_close</function>. - </para> - <example> - <title> - Impostare la velocità di una porta seriale - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> +<refentry id="function.dio-open"> + <refnamediv> + <refname>dio_open</refname> + <refpurpose> + Apre un nuovo file nella modalità specificata da flags e + i permessi indicati in mode + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>dio_open</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_open</function> apre un file e restituisce un nuovo descrittore di file + per questo. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Il file aperto. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + Il parametro <parameter>flags</parameter> può contenere qualsiasi combinazione + dei seguenti valori: + <itemizedlist> + <listitem> + <para> + <constant>O_CREAT</constant> - crea un file, se questo + non esiste già. + </para> + </listitem> + <listitem> + <para> + <constant>O_EXCL</constant> - se sono impostati sia <constant>O_CREAT</constant> + e sia <constant>O_EXCL</constant>, + la funzione <function>dio_open</function> fallisce se il file esiste. + </para> + </listitem> + <listitem> + <para> + <constant>O_TRUNC</constant> - se il file esiste, ed è aperto in scrittura, + il file verrà portato a lunghezza zero. + </para> + </listitem> + <listitem> + <para> + <constant>O_APPEND</constant> - nelle operazioni di scrittura, scrive i dati + alla fine del file. + </para> + </listitem> + <listitem> + <para> + <constant>O_NONBLOCK</constant> - imposta la modalità non blocking. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + Se <parameter>flags</parameter> vale <constant>O_CREAT</constant>, + allora il parametro <parameter>mode</parameter> imposta la modalità del file + (permessi di creazione). + <itemizedlist> + <listitem> + <para> + <constant>O_RDONLY</constant> - apre il file per accessi in lettura. + </para> + </listitem> + <listitem> + <para> + <constant>O_WRONLY</constant> - apre il file in scrittura. + </para> + </listitem> + <listitem> + <para> + <constant>O_RDWR</constant> - apre il file sia in lettura sia + in scrittura. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Restituisce un descrittore di file, oppure &false; in caso di errore. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Impostare la velocità di una porta seriale</title> + <programlisting role="php"> <![CDATA[ <?php - + $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); - + dio_close($fd); ?> ]]> - </programlisting> - </example> - </refsect1> - </refentry> + </programlisting> + </example> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-read.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dio/functions/dio-read.xml diff -u phpdoc-it/reference/dio/functions/dio-read.xml:1.3 phpdoc-it/reference/dio/functions/dio-read.xml:1.4 --- phpdoc-it/reference/dio/functions/dio-read.xml:1.3 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/dio/functions/dio-read.xml Tue May 10 08:38:26 2005 @@ -1,33 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-read"> - <refnamediv> - <refname>dio_read</refname> - <refpurpose> - Legge n bytes da un descrittore fd e li restituisce, se n non è - specificato, legge un blocco da 1k - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>string</type><methodname>dio_read</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>n</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_read</function> legge e restituisce - <parameter>n</parameter> bytes dal file indicato dal descrittore - <parameter>fd</parameter>. Se <parameter>n</parameter> viene omesso, - la funzione <function>dio_read</function> leggerà e restituirà - un blocco da 1k. - </para> - <para> - Vedere anche: <function>dio_write</function>. - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> +<refentry id="function.dio-read"> + <refnamediv> + <refname>dio_read</refname> + <refpurpose>Legge n bytes da un descrittore di file</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dio_read</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>len</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_read</function> legge e restituisce + <parameter>len</parameter> bytes dal file indicato dal descrittore + <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>len</parameter></term> + <listitem> + <para> + Numero di byte da leggere. Se non indicato + <function>dio_read</function> legge blocchi da un 1k. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + I byte letti da <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_write</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-seek.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dio/functions/dio-seek.xml diff -u phpdoc-it/reference/dio/functions/dio-seek.xml:1.4 phpdoc-it/reference/dio/functions/dio-seek.xml:1.5 --- phpdoc-it/reference/dio/functions/dio-seek.xml:1.4 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-seek.xml Tue May 10 08:38:26 2005 @@ -1,83 +1,120 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-seek"> - <refnamediv> - <refname>dio_seek</refname> - <refpurpose>Si posiziona al byte pos del file indicato da fd</refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>int</type><methodname>dio_seek</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>int</type><parameter>pos</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_seek</function> viene utilizzata per modificare la - posizione nel file con descrittore - <parameter>fd</parameter>. Il parametro - <parameter>whence</parameter> specifica come debba essere interpretata la - posizione indicata da <parameter>pos</parameter>: - <itemizedlist> - <listitem> - <para> - SEEK_SET (default) - Indica che <parameter>pos</parameter> è - determinato dall'inizio del file. - </para> - </listitem> - <listitem> - <para> - SEEK_CUR - Indica che <parameter>pos</parameter> è il numero - di caratteri dalla posizione attuale. Questo valore può essere - positivo o negativo. - </para> - </listitem> - <listitem> - <para> - SEEK_END - Indica che <parameter>pos</parameter> è il numero - di caratteri dalla fine del file. Un valore negativo - specifica una posizione all'interno dell'estensione del file; - un valore positivo specifica una posizione oltre la fine corrente del file. - Se si specifica una posizione oltre la fine del file, e vi si scrive - dei dati, il file sarà allungato e riempito di zero fino a quella - posizione. - </para> - </listitem> - </itemizedlist> - <example> - <title> - Impostare la velocità di una porta seriale - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> +<refentry id="function.dio-seek"> + <refnamediv> + <refname>dio_seek</refname> + <refpurpose>Si posiziona al byte pos del file indicato da fd</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dio_seek</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>int</type><parameter>pos</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_seek</function> viene utilizzata per modificare la + posizione nel file indicato dal descrittore <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pos</parameter></term> + <listitem> + <para> + La nuova posizione. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>whence</parameter></term> + <listitem> + <para> + specifica come debba essere interpretata la + posizione indicata da <parameter>pos</parameter>: + <itemizedlist> + <listitem> + <para> + <constant>SEEK_SET</constant> (default) - Indica + che <parameter>pos</parameter> è + determinato dall'inizio del file. + </para> + </listitem> + <listitem> + <para> + <constant>SEEK_CUR</constant> - Indica che <parameter>pos</parameter> è il numero + di caratteri dalla posizione attuale. Questo valore può essere + positivo o negativo. + </para> + </listitem> + <listitem> + <para> + <constant>SEEK_END</constant> - Indica che <parameter>pos</parameter> è il numero + di caratteri dalla fine del file. Un valore negativo + specifica una posizione all'interno dell'estensione del file; + un valore positivo specifica una posizione oltre la fine corrente del file. + Se si specifica una posizione oltre la fine del file, e vi si scrive + dei dati, il file sarà allungato e riempito di zero fino a quella + posizione. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Impostare la velocità di una porta seriale</title> + <programlisting role="php"> <![CDATA[ <?php - + $fd = dio_open('/dev/ttyS0', O_RDWR); - + dio_seek($fd, SEEK_SET, 10); // Si posiziona a 10 caratteri dall'inizio del file - + dio_seek($fd, SEEK_CUR, -2); // Si posiziona a 8 caratteri dall'inizio del file - + dio_seek($fd, SEEK_END, 5); // Si posiziona a 5 caratteri dalla fine del file - + dio_seek($fd, SEEK_END, -10); // Si posiziona a 10 caratteri dopo la fine del file // i 10 caratteri tra la fine del file e la posizione corrente // sono riempiti con zero. - + dio_close($fd); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-stat.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/dio/functions/dio-stat.xml diff -u phpdoc-it/reference/dio/functions/dio-stat.xml:1.2 phpdoc-it/reference/dio/functions/dio-stat.xml:1.3 --- phpdoc-it/reference/dio/functions/dio-stat.xml:1.2 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/dio/functions/dio-stat.xml Tue May 10 08:38:26 2005 @@ -1,48 +1,113 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-stat"> - <refnamediv> - <refname>dio_stat</refname> - <refpurpose> - Restituisce le informazioni relative al file indicato da fd - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>array</type><methodname>dio_stat</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_stat</function> restituisce le informazioni - sul file con descrittore - <parameter>fd</parameter>. <function>dio_stat</function> restituisce - un array associativo contenente le seguenti chiavi: - <itemizedlist> - <listitem><para>"device" - device</para></listitem> - <listitem><para>"inode" - inode</para></listitem> - <listitem><para>"mode" - mode</para></listitem> - <listitem><para>"nlink" - numero di link</para></listitem> - <listitem><para>"uid" - user id</para></listitem> - <listitem><para>"gid" - group id</para></listitem> - <listitem> - <para> - "device_type" - device type (se inode device) - </para> - </listitem> - <listitem><para>"size" - dimensione totale in byte</para></listitem> - <listitem><para>"blocksize" - blocksize</para></listitem> - <listitem><para>"blocks" - numero di blocchi allocati</para></listitem> - <listitem><para>"atime" - data dell'ultimo accesso</para></listitem> - <listitem><para>"mtime" - data dell'ultima modifica</para></listitem> - <listitem><para>"ctime" - data dell'ultimo cambiamento</para></listitem> - </itemizedlist> - Se si verifica un errore la funzione <function>dio_stat</function> restituisce - &null;. - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<refentry id="function.dio-stat"> + <refnamediv> + <refname>dio_stat</refname> + <refpurpose> + Restituisce le informazioni relative al file indicato da fd + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dio_stat</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_stat</function> restituisce le informazioni + sul dato descrittore di file. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Restituisce un array associativo contenente le seguenti chiavi: + <itemizedlist> + <listitem> + <para> + "device" - device + </para> + </listitem> + <listitem> + <para> + "inode" - inode + </para> + </listitem> + <listitem> + <para> + "mode" - mode + </para> + </listitem> + <listitem> + <para> + "nlink" - numero di link + </para> + </listitem> + <listitem> + <para> + "uid" - user id + </para> + </listitem> + <listitem> + <para> + "gid" - group id + </para> + </listitem> + <listitem> + <para> + "device_type" - device type (se inode device) + </para> + </listitem> + <listitem> + <para> + "size" - total size in bytes + </para> + </listitem> + <listitem> + <para> + "blocksize" - blocksize + </para> + </listitem> + <listitem> + <para> + "blocks" - dimensione totale in byte + </para> + </listitem> + <listitem> + <para> + "atime" - data dell'ultimo accesso + </para> + </listitem> + <listitem> + <para> + "mtime" - data dell'ultima modifica + </para> + </listitem> + <listitem> + <para> + "ctime" - data dell'ultimo cambiamento + </para> + </listitem> + </itemizedlist> + Se si verifica un errore la funzione <function>dio_stat</function> restituisce &null;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-tcsetattr.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dio/functions/dio-tcsetattr.xml diff -u phpdoc-it/reference/dio/functions/dio-tcsetattr.xml:1.5 phpdoc-it/reference/dio/functions/dio-tcsetattr.xml:1.6 --- phpdoc-it/reference/dio/functions/dio-tcsetattr.xml:1.5 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-tcsetattr.xml Tue May 10 08:38:26 2005 @@ -1,61 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-tcsetattr"> - <refnamediv> - <refname>dio_tcsetattr</refname> - <refpurpose> - Imposta gli attributi terminale e la velocità per una porta seriale - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>void</type><methodname>dio_tcsetattr</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>array</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_tcsetattr</function> imposta - gli attributi di terminale e la velocità della porta aperta - <parameter>fd</parameter>. Attualmente le opzioni disponibili sono: - <itemizedlist> - <listitem> - <para> - 'baud' - velocità della porta - può essere 38400,19200,9600,4800,2400,1800,1200,600,300,200,150,134,110,75 oppure 50, - il valore di default è 9600 - </para> - </listitem> - <listitem> - <para> - 'bits' - bit di dati - può essere 8,7,6 oppure 5 - il valore di default è 8 - </para> - </listitem> - <listitem> - <para> - 'stop' - bit di stop - può essere 1 o 2 - il valore di default è 1 - </para> - </listitem> - <listitem> - <para> - 'parity' - può essere 0,1 o 2 - il valore di default è 0 - </para> - </listitem> - </itemizedlist> - <example> - <title> - Esempio di impostazione della velocità di una porta seriale - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.10 Maintainer: darvina Status: ready --> +<refentry id="function.dio-tcsetattr"> + <refnamediv> + <refname>dio_tcsetattr</refname> + <refpurpose> + Imposta gli attributi terminale e la velocità per una porta seriale + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <void/><methodname>dio_tcsetattr</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>array</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_tcsetattr</function> imposta + gli attributi di terminale e la velocità della porta aperta <parameter>fd</parameter>. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Attualmente le opzioni disponibili sono: + <itemizedlist> + <listitem> + <para> + 'baud' - velocità della porta - può essere 38400,19200,9600,4800,2400,1800,1200,600,300,200,150,134,110,75 oppure 50, + il valore di default è 9600 + </para> + </listitem> + <listitem> + <para> + 'bits' - bit di dati - può essere 8,7,6 oppure 5 il valore di default è 8. + </para> + </listitem> + <listitem> + <para> + 'stop' - bit di stop - può essere 1 o 2 il valore di default è 1. + </para> + </listitem> + <listitem> + <para> + 'parity' - può essere 0,1 o 2 il valore di default è 0. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Esempio di impostazione della velocità di una porta seriale</title> + <programlisting role="php"> <![CDATA[ <?php $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); -dio_fcntl($fd, F_SETFL, O_SYNC ); +dio_fcntl($fd, F_SETFL, O_SYNC); dio_tcsetattr($fd, array( 'baud' => 9600, @@ -75,12 +103,11 @@ ?> ]]> - </programlisting> - </example> - </para> - ¬e.no-windows; - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-truncate.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dio/functions/dio-truncate.xml diff -u phpdoc-it/reference/dio/functions/dio-truncate.xml:1.3 phpdoc-it/reference/dio/functions/dio-truncate.xml:1.4 --- phpdoc-it/reference/dio/functions/dio-truncate.xml:1.3 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-truncate.xml Tue May 10 08:38:26 2005 @@ -1,33 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-truncate"> - <refnamediv> - <refname>dio_truncate</refname> - <refpurpose> - Tronca il file indicato da fd ad un numero di byte specificato - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>bool</type><methodname>dio_truncate</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_truncate</function> tronca il - file indicato da <parameter>fd</parameter> ad una lunghezza - massima di <parameter>offset</parameter> bytes. Se in precedenza il file - ha una dimensione maggiore, i dati in eccesso sono persi. - Al contrario se il file è più corto, non è specificato se si - debba lasciarlo inalterato o debba essere allungato. Nell'ultimo caso - la parte aggiunta viene riempita di zero. - &return.success;. - </para> - ¬e.no-windows; - </refsect1> - </refentry> +<refentry id="function.dio-truncate"> + <refnamediv> + <refname>dio_truncate</refname> + <refpurpose> + Tronca il file indicato da fd ad un numero di byte specificato + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dio_truncate</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_truncate</function> tronca il file indicato da <parameter>fd</parameter> ad una lunghezza + massima di <parameter>offset</parameter> bytes. + </para> + <para> + Se in precedenza il file + ha una dimensione maggiore, i dati in eccesso sono persi. + Al contrario se il file è più corto, non è specificato se si + debba lasciarlo inalterato o debba essere allungato. Nell'ultimo caso la parte aggiunta viene riempita a zero. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Posizione in byte. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-write.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/dio/functions/dio-write.xml diff -u phpdoc-it/reference/dio/functions/dio-write.xml:1.2 phpdoc-it/reference/dio/functions/dio-write.xml:1.3 --- phpdoc-it/reference/dio/functions/dio-write.xml:1.2 Sun Apr 4 15:44:36 2004 +++ phpdoc-it/reference/dio/functions/dio-write.xml Tue May 10 08:38:26 2005 @@ -1,35 +1,72 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> -<!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> - <refentry id="function.dio-write"> - <refnamediv> - <refname>dio_write</refname> - <refpurpose> - Scrive dati sul file indicato da fd con la possibilità di troncarne la lunghezza - </refpurpose> - </refnamediv> - <refsect1> - <title>Descrizione</title> - <methodsynopsis> - <type>int</type><methodname>dio_write</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>len</parameter></methodparam> - </methodsynopsis> - <para> - La funzione <function>dio_write</function> scrive fino a - <parameter>len</parameter> bytes da <parameter>data</parameter> - nel file <parameter>fd</parameter>. Se il parametro <parameter>len</parameter> - viene omesso, <function>dio_write</function> scrive tutto il contenuto di - <parameter>data</parameter> nel file indicato. - La funzione <function>dio_write</function> restituisce il numero di byte - scritti in <parameter>fd</parameter>. - </para> - <para> - Vedere anche <function>dio_read</function>. - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> +<refentry id="function.dio-write"> + <refnamediv> + <refname>dio_write</refname> + <refpurpose> + Scrive dati sul file indicato da fd con la possibilità di troncarne la lunghezza + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dio_write</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>len</parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>dio_write</function> scrive fino a <parameter>len</parameter> + bytes da <parameter>data</parameter> nel file <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + I dati scritti. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>len</parameter></term> + <listitem> + <para> + Lunghezza dei dati da scrivere in byte. Se non indicato, la + funzione scrive tutti i dati nel file indicato. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + La funzione restituisce il numero di byte scritti in <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_read</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: