cvs: phpdoc-it /reference/dio/functions dio-close.xml dio-fcntl.xml

From: Date: Thu, 21 Apr 2005 12:33:25 +0000
Subject: cvs: phpdoc-it /reference/dio/functions dio-close.xml dio-fcntl.xml
Groups: php.doc.it 
Request: Send a blank email to doc-it+get-696@lists.php.net to get a copy of this message
darvina Thu Apr 21 08:33:25 2005 EDT Modified files: /phpdoc-it/reference/dio/functions dio-close.xml dio-fcntl.xml Log: Sync to En tree

http://cvs.php.net/diff.php/phpdoc-it/reference/dio/functions/dio-close.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dio/functions/dio-close.xml diff -u phpdoc-it/reference/dio/functions/dio-close.xml:1.4 phpdoc-it/reference/dio/functions/dio-close.xml:1.5 --- phpdoc-it/reference/dio/functions/dio-close.xml:1.4 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-close.xml Thu Apr 21 08:33:25 2005 @@ -1,30 +1,48 @@ <?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-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> - <para> - Vedere anche <function>dio_open</function>. - </para> - <para> - <example> - <title> - Chiusura di un descrittore di file aperto. - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> +<refentry id="function.dio-close"> + <refnamediv> + <refname>dio_close</refname> + <refpurpose>Chiude il descrittore di file passato</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <void/><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> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Il descrittore di file restituito da <function>dio_open</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Chiudere un descrittore di file</title> + <programlisting role="php"> <![CDATA[ <?php $fd = dio_open('/dev/ttyS0', O_RDWR); @@ -36,7 +54,15 @@ </example> </para> </refsect1> - </refentry> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dio_open</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.4&r2=1.5&ty=u Index: phpdoc-it/reference/dio/functions/dio-fcntl.xml diff -u phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.4 phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.5 --- phpdoc-it/reference/dio/functions/dio-fcntl.xml:1.4 Thu Sep 16 08:20:29 2004 +++ phpdoc-it/reference/dio/functions/dio-fcntl.xml Thu Apr 21 08:33:25 2005 @@ -1,106 +1,141 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.7 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>args</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>args</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>args</parameter> - e lo restituisce. - </para> - </listitem> - <listitem> - <para> - F_SETFL - Imposta i flag del descrittore di file al valore specificato da - <parameter>args</parameter>. Tale valore può essere O_APPEND, O_NONBLOCK oppure - O_ASYNC . Per utilizzare O_ASYNC occorre utilizzare l'estensione <link linkend="ref.pcntl">PCNTL</link>. - </para> - </listitem> - </itemizedlist> - <example> - <title> - Impostare e cancellare un lock - </title> - <programlisting role="php"> +<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> +<refentry id="function.dio-fcntl"> + <refnamediv> + <refname>dio_fcntl</refname> + <refpurpose>Esegue la funzione C fcntl su un descrittore di file</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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>args</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> + &note.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>cmd</parameter></term> + <listitem> + <para> + può indicare una delle seguenti operazioni: + <itemizedlist> + <listitem> + <para> + <constant>F_SETLK</constant> -mposta o azzera un lock. Se il lock è impostato + da un'altro processo la funzione <function>dio_fcntl</function> restituisce + -1. + </para> + </listitem> + <listitem> + <para> + <constant>F_SETLKW</constant> - come <constant>F_SETLK</constant>, 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> + <constant>F_GETLK</constant> - 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 <constant>F_UNLCK</constant>. + </para> + </listitem> + <listitem> + <para> + <constant>F_DUPFD</constant> - trova il più piccolo numero di descrittore di file disponibile + che sia maggiore o uguale rispetto ad <parameter>args</parameter> + e lo restituisce. + </para> + </listitem> + <listitem> + <para> + <constant>F_SETF</constant>L - Imposta i flag del descrittore di file al valore specificato da + <parameter>args</parameter>. Tale valore può essere <constant>O_APPEND</constant>, + <constant>O_NONBLOCK</constant> oppure <constant>O_ASYNC</constant>. Per utilizzare + <constant>O_ASYNC</constant> occorre utilizzare l'estensione + <link linkend="ref.pcntl">PCNTL</link>. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + Il parametro <parameter>args</parameter> è un array associativo, nei casi in cui + <parameter>cmd</parameter> è impostato a <constant>F_SETLK</constant> oppure a <constant>F_SETLLW</constant>, 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 <constant>SEEK_SET</constant>, + <constant>SEEK_END</constant> o <constant>SEEK_CUR</constant> + </para> + </listitem> + <listitem> + <para> + "type" - tipo di lock: può essere <constant>F_RDLCK</constant> (lock in lettura), + <constant>F_WRLCK</constant> (lock in scrittura) oppure + <constant>F_UNLCK</constant> (rimozione del lock) + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Restituisce il valore della chiamata C. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Impostare e cancellare un lock</title> + <programlisting role="php"> <![CDATA[ <?php $fd = dio_open('/dev/ttyS0', O_RDWR); - -if (dio_fcntl($fd, F_SETLK) == -1) { +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."; } else { @@ -110,11 +145,11 @@ dio_close($fd); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc.it (#696) next »