cvs: phpdoc-it /reference/dio/functions dio-close.xml 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: | Fri, 15 Nov 2002 20:54:10 +0000 |
| Subject: | cvs: phpdoc-it /reference/dio/functions dio-close.xml 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-149@lists.php.net to get a copy of this message | ||
darvina Fri Nov 15 15:54:10 2002 EDT
Added files:
/phpdoc-it/reference/dio/functions dio-close.xml 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:
Initial translation
Index: phpdoc-it/reference/dio/functions/dio-close.xml +++ phpdoc-it/reference/dio/functions/dio-close.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-close"> <refnamediv> <refname>dio_close</refname> <refpurpose>Chiude il descrittore di file passato</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>void</type><methodname>dio_close</methodname> <methodparam><type>resource</type><parameter>fd</parameter></methodparam> </methodsynopsis> <para> La funzione <function>dio_close</function> chiude il descrittore di file <parameter>fd</parameter>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-fcntl.xml +++ phpdoc-it/reference/dio/functions/dio-fcntl.xml <?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-fcntl"> <refnamediv> <refname>dio_fcntl</refname> <refpurpose>Esegue la funzione C fcntl su un descrittore di file</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>mixed</type><methodname>dio_fcntl</methodname> <methodparam><type>resource</type><parameter>fd</parameter></methodparam> <methodparam><type>int</type><parameter>cmd</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter></methodparam> </methodsynopsis> <para> La funzione <function>dio_fcntl</function> esegue le operazioni specificate dal parametro <parameter>cmd</parameter> sul descrittore di file <parameter>fd</parameter>. Qualora i comandi richiedano informazioni addizionali occorre valorizzare <parameter>args</parameter> con tali informazioni. </para> <para> Il parametro <parameter>arg</parameter> è un array associativo, nei casi in cui <parameter>cmd</parameter> è impostato a F_SETLK oppure a F_SETLLW, contiene le seguenti chiavi: <itemizedlist> <listitem> <para> "start" - offset da cui comincia il lock </para> </listitem> <listitem> <para> "length" - dimensione dell'area bloccata, zero significa fine file </para> </listitem> <listitem> <para> "wenth" - a cosa l_start è relativo: può valere SEEK_SET, SEEK_END o SEEK_CUR </para> </listitem> <listitem> <para> "type" - tipo di lock: può essere F_RDLCK (lock in lettura), F_WRLCK (lock in scrittura) oppure F_UNLCK (rimozione del lock) </para> </listitem> </itemizedlist> </para> <para> <parameter>cmd</parameter> può indicare una delle seguenti operazioni: <itemizedlist> <listitem> <para> F_SETLK - Imposta o azzera un lock. Se il lock è impostato da un'altro processo la funzione <function>dio_fcntl</function> restituisce -1. </para> </listitem> <listitem> <para> F_SETLKW - come F_SETLK, ma nel caso in cui il lock sia impostato da un'altro processo la funzione <function>dio_fcntl</function> attende sino a quando il blocco non viene rimosso. </para> </listitem> <listitem> <para> F_GETLK - la <function>dio_fcntl</function> restituisce un array associativo (come descritto precedentemente) se qualche altro processo impedisce il lock. Se non vi sono problemi la chiave "type" sarà impostata a F_UNLCK. </para> </listitem> <listitem> <para> F_DUPFD - trova il più piccolo numero di descrittore di file disponibile che sia maggiore o uguale rispetto ad <parameter>arg</parameter> e lo restituisce. </para> </listitem> <listitem> <para> F_SETFL - Imposta i flag del descrittore di file al valore specificato da <parameter>arg</parameter>, Tale valore può essere O_APPEND, O_NONBLOCK oppure O_ASYNC . Per utilizzare O_ASYNC occorre utilizzare l'estensione pcntl. </para> </listitem> </itemizedlist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-open.xml +++ phpdoc-it/reference/dio/functions/dio-open.xml <?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-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> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-read.xml +++ phpdoc-it/reference/dio/functions/dio-read.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-seek.xml +++ phpdoc-it/reference/dio/functions/dio-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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><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 - 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> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-stat.xml +++ phpdoc-it/reference/dio/functions/dio-stat.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-tcsetattr.xml +++ phpdoc-it/reference/dio/functions/dio-tcsetattr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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></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"> <![CDATA[ <?php $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); dio_fcntl($fd,F_SETFL, O_SYNC ); dio_tcsetattr($fd, array( 'baud' => 9600, 'bits' => 8, 'stop' =>1, 'parity' => 0 )); while (1) { $data = dio_read($fd,256); if ($data) { echo $data; } } ?> ]]> </programlisting> </example> </para> <note> <para> Questa funzione è stata inserita nella versione 4.3.0 di PHP. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-truncate.xml +++ phpdoc-it/reference/dio/functions/dio-truncate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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. La funzione restituisce 0 se ha successo, altrimenti -1. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-write.xml +++ phpdoc-it/reference/dio/functions/dio-write.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-it/reference/dio/functions/dio-close.xml +++ phpdoc-it/reference/dio/functions/dio-close.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> <!-- splitted from ./en/functions/dio.xml, last change in rev 1.1 --> <refentry id="function.dio-close"> <refnamediv> <refname>dio_close</refname> <refpurpose>Chiude il descrittore di file passato</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>void</type><methodname>dio_close</methodname> <methodparam><type>resource</type><parameter>fd</parameter></methodparam> </methodsynopsis> <para> La funzione <function>dio_close</function> chiude il descrittore di file <parameter>fd</parameter>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-fcntl.xml +++ phpdoc-it/reference/dio/functions/dio-fcntl.xml <?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-fcntl"> <refnamediv> <refname>dio_fcntl</refname> <refpurpose>Esegue la funzione C fcntl su un descrittore di file</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>mixed</type><methodname>dio_fcntl</methodname> <methodparam><type>resource</type><parameter>fd</parameter></methodparam> <methodparam><type>int</type><parameter>cmd</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter></methodparam> </methodsynopsis> <para> La funzione <function>dio_fcntl</function> esegue le operazioni specificate dal parametro <parameter>cmd</parameter> sul descrittore di file <parameter>fd</parameter>. Qualora i comandi richiedano informazioni addizionali occorre valorizzare <parameter>args</parameter> con tali informazioni. </para> <para> Il parametro <parameter>arg</parameter> è un array associativo, nei casi in cui <parameter>cmd</parameter> è impostato a F_SETLK oppure a F_SETLLW, contiene le seguenti chiavi: <itemizedlist> <listitem> <para> "start" - offset da cui comincia il lock </para> </listitem> <listitem> <para> "length" - dimensione dell'area bloccata, zero significa fine file </para> </listitem> <listitem> <para> "wenth" - a cosa l_start è relativo: può valere SEEK_SET, SEEK_END o SEEK_CUR </para> </listitem> <listitem> <para> "type" - tipo di lock: può essere F_RDLCK (lock in lettura), F_WRLCK (lock in scrittura) oppure F_UNLCK (rimozione del lock) </para> </listitem> </itemizedlist> </para> <para> <parameter>cmd</parameter> può indicare una delle seguenti operazioni: <itemizedlist> <listitem> <para> F_SETLK - Imposta o azzera un lock. Se il lock è impostato da un'altro processo la funzione <function>dio_fcntl</function> restituisce -1. </para> </listitem> <listitem> <para> F_SETLKW - come F_SETLK, ma nel caso in cui il lock sia impostato da un'altro processo la funzione <function>dio_fcntl</function> attende sino a quando il blocco non viene rimosso. </para> </listitem> <listitem> <para> F_GETLK - la <function>dio_fcntl</function> restituisce un array associativo (come descritto precedentemente) se qualche altro processo impedisce il lock. Se non vi sono problemi la chiave "type" sarà impostata a F_UNLCK. </para> </listitem> <listitem> <para> F_DUPFD - trova il più piccolo numero di descrittore di file disponibile che sia maggiore o uguale rispetto ad <parameter>arg</parameter> e lo restituisce. </para> </listitem> <listitem> <para> F_SETFL - Imposta i flag del descrittore di file al valore specificato da <parameter>arg</parameter>, Tale valore può essere O_APPEND, O_NONBLOCK oppure O_ASYNC . Per utilizzare O_ASYNC occorre utilizzare l'estensione pcntl. </para> </listitem> </itemizedlist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-open.xml +++ phpdoc-it/reference/dio/functions/dio-open.xml <?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-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> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-read.xml +++ phpdoc-it/reference/dio/functions/dio-read.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-seek.xml +++ phpdoc-it/reference/dio/functions/dio-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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><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 - 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> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-stat.xml +++ phpdoc-it/reference/dio/functions/dio-stat.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-tcsetattr.xml +++ phpdoc-it/reference/dio/functions/dio-tcsetattr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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></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"> <![CDATA[ <?php $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK); dio_fcntl($fd,F_SETFL, O_SYNC ); dio_tcsetattr($fd, array( 'baud' => 9600, 'bits' => 8, 'stop' =>1, 'parity' => 0 )); while (1) { $data = dio_read($fd,256); if ($data) { echo $data; } } ?> ]]> </programlisting> </example> </para> <note> <para> Questa funzione è stata inserita nella versione 4.3.0 di PHP. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-truncate.xml +++ phpdoc-it/reference/dio/functions/dio-truncate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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. La funzione restituisce 0 se ha successo, altrimenti -1. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-it/reference/dio/functions/dio-write.xml +++ phpdoc-it/reference/dio/functions/dio-write.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.2 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> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->