cvs: phpdoc-de /appendices aliases.xml history.xml ini.xml /reference/dio/functions dio-close.xml dio-fcntl.xml dio-truncate.xml
| From: | Hartmut Holzgraefe | Date: | Thu, 20 Mar 2008 11:28:57 +0000 |
| Subject: | cvs: phpdoc-de /appendices aliases.xml history.xml ini.xml /reference/dio/functions dio-close.xml dio-fcntl.xml dio-truncate.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2596@lists.php.net to get a copy of this message | ||
hholzgra Thu Mar 20 11:28:57 2008 UTC
Modified files:
/phpdoc-de/appendices aliases.xml history.xml ini.xml
/phpdoc-de/reference/dio/functions dio-close.xml dio-fcntl.xml
dio-truncate.xml
Log:
translation updates and build fixes
http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/aliases.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-de/appendices/aliases.xml diff -u phpdoc-de/appendices/aliases.xml:1.16 phpdoc-de/appendices/aliases.xml:1.17 --- phpdoc-de/appendices/aliases.xml:1.16 Thu Mar 20 09:00:26 2008 +++ phpdoc-de/appendices/aliases.xml Thu Mar 20 11:28:57 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.33 Maintainer: hholzgra Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.34 Maintainer: hholzgra Status: ready --> <appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Liste der Funktion Aliase</title> <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/history.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-de/appendices/history.xml diff -u phpdoc-de/appendices/history.xml:1.13 phpdoc-de/appendices/history.xml:1.14 --- phpdoc-de/appendices/history.xml:1.13 Thu Mar 20 08:55:56 2008 +++ phpdoc-de/appendices/history.xml Thu Mar 20 11:28:57 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <!-- EN-Revision: 1.19 Maintainer: tom Status: ready --> <appendix xml:id="history" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -195,7 +195,7 @@ </para> <para> Weitere Informationen zu PEAR finden sie im - <link xlink:href="&url.php.pear.manual">PEAR Manual</link>. + <link xlink:href="&url.php.pear.manual;">PEAR Manual</link>. </para> </sect2> http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/ini.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-de/appendices/ini.xml diff -u phpdoc-de/appendices/ini.xml:1.12 phpdoc-de/appendices/ini.xml:1.13 --- phpdoc-de/appendices/ini.xml:1.12 Thu Mar 20 08:55:56 2008 +++ phpdoc-de/appendices/ini.xml Thu Mar 20 11:28:57 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <!-- EN-Revision: 1.59 Maintainer: hholzgra Status: ready --> <!-- CREDITS: wiesemann, betz, simp --> @@ -3199,12 +3199,12 @@ <warning> <para> Sowohl im CGI als auch im FastCGI SAPI enthält - <link linkend"reserved.variables.server">$_SERVER<link> + <link linkend="reserved.variables.server">$_SERVER</link> immer auch Variablen aus dem Environment, <literal>S</literal> ist hier immer equvalent zu <literal>ES</literal> unabhängig davon ob <literal>E</literal> noch anderweitig in der Direktive benutzt wird. - </par> + </para> </warning> <note> <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dio/functions/dio-close.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/dio/functions/dio-close.xml diff -u phpdoc-de/reference/dio/functions/dio-close.xml:1.5 phpdoc-de/reference/dio/functions/dio-close.xml:1.6 --- phpdoc-de/reference/dio/functions/dio-close.xml:1.5 Sat Jun 23 13:21:32 2007 +++ phpdoc-de/reference/dio/functions/dio-close.xml Thu Mar 20 11:28:57 2008 @@ -1,26 +1,71 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/dio.xml, last change in rev 1.1 --> -<!-- last change to 'dio-close' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: georg Status: n/a --> -<!-- OLD-Revision: 1.6/EN.1.1 --> - <refentry xml:id="function.dio-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dio_close</refname> - <refpurpose>Schliesst die Datei</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>dio_close</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion <function>dio_close</function> schliesst die Datei - <parameter>fd</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: hholzgra Status: ready --> +<!-- Credits: georg --> +<refentry xml:id="function.dio-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dio_close</refname> + <refpurpose>Schliesst eine Datei</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>void</type><methodname>dio_close</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion <function>dio_close</function> schliesst die Datei + <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Eine von <function>dio_open</function> zurückgegebene + Dateideskriptorresource. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Schließen eines geöffneten Dateideskriptors</title> + <programlisting role="php"> +<![CDATA[ +<?php +$fd = dio_open('/dev/ttyS0', O_RDWR); + +dio_close($fd); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <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/viewvc.cgi/phpdoc-de/reference/dio/functions/dio-fcntl.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/dio/functions/dio-fcntl.xml diff -u phpdoc-de/reference/dio/functions/dio-fcntl.xml:1.5 phpdoc-de/reference/dio/functions/dio-fcntl.xml:1.6 --- phpdoc-de/reference/dio/functions/dio-fcntl.xml:1.5 Sat Jun 23 13:21:32 2007 +++ phpdoc-de/reference/dio/functions/dio-fcntl.xml Thu Mar 20 11:28:57 2008 @@ -1,85 +1,167 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/dio.xml, last change in rev 1.1 --> -<!-- last change to 'dio-fcntl' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: georg Status: n/a --> -<!-- OLD-Revision: 1.6/EN.1.1 --> - <refentry xml:id="function.dio-fcntl" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dio_fcntl</refname> - <refpurpose>Ändert den Dateideskriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</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> - Die Funktion <function>dio_fcntl</function> führt eine Aktion - <parameter>cmd</parameter> an der Datei <parameter>fd</parameter> - aus. Einige Aktionen <parameter>cmd</parameter> benötigen das - zusätzliche Argument <parameter>args</parameter>. - </para> - <para> - <parameter>arg</parameter> ist ein assoziatives Array, wenn - <parameter>cmd</parameter> F_SETLK oder F_SETLLW ist. Es hat - folgende Einträge: - <itemizedlist> - <listitem> - <para> - "start" - offset an dem der Lock beginnt - </para> - </listitem> - <listitem> - <para> - "length" - Länge des gelockten Bereichs - </para> - </listitem> - <listitem> - <para> - "wenth" - Relative Position von start. Kann folgende Werte - annehmen: SEEK_SET, SEEK_END and SEEK_CUR - </para> - </listitem> - <listitem> - <para> - "type" - Locktyp: F_RDLCK (read lock), F_WRLCK (write lock) - oder F_UNLCK (unlock) - </para> - </listitem> - </itemizedlist> - </para> - <para> - <parameter>cmd</parameter> ist einer der folgenden Konstanten: - <itemizedlist> - <listitem> - <para> - F_SETLK - Setzt oder löscht einen Lock. Ist der Bereich - bereits von einem anderen Prozess gelockt, so liefert die - Funktion <function>dio_fcntl</function> -1 zurück. - </para> - </listitem> - <listitem> - <para> - F_SETLKW - wie F_SETLK, jedoch im Falle, dass der Bereich von - einem anderen Prozess gelockt wird, wartet - <function>dio_fcntl</function> auf die Freigabe des Locks. - </para> - </listitem> - <listitem> - <para> - F_GETLK - <function>dio_fcntl</function> liefert ein - assioziatives Array zurück (Beschreibung siehe oben), falls - ein anderer Prozess den Bereich gelockt hat. - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.11 Maitainer: hholzgra Status: ready --> +<refentry xml:id="function.dio-fcntl" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dio_fcntl</refname> + <refpurpose>Modifiziert einen Dateideskriptor</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> + Die Funktion <function>dio_fcntl</function> führt die mit + <parameter>cmd</parameter> festgelegte Operation auf dem + Dateideskriptor <parameter>fd</parameter> aus. Für einige + dieser Operationen müssen zusätzliche Argumente im + Parameter <parameter>args</parameter> übergeben werden. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Ein von <function>dio_open</function> zurückgegebener + Dateideskriptor. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmd</parameter></term> + <listitem> + <para> + Eine der folgenden Operationen: + <itemizedlist> + <listitem> + <para> + <constant>F_SETLK</constant> - Setzt oder Löscht eine + Dateisperre. Wenn diese Sperre bereits von jemand anderem + gehalten wird gibt <function>dio_fcntl</function> -1 + zurück. + </para> + </listitem> + <listitem> + <para> + <constant>F_SETLKW</constant> - ähnlich <constant>F_SETLK</constant>, + hier wird aber in dem Fall das bereits jemand anderes die Sperre + hält gewartet bis diese wieder freigegeben wird. + </para> + </listitem> + <listitem> + <para> + <constant>F_GETLK</constant> - <function>dio_fcntl</function> + gibt ein assoziatives Array mit Informationen (wie weiter unten + beschrieben) zurüc wenn jemand anders bereits eine Sperre hält. + Existiert keine andere Sperre wird das Element "type" auf + <constant>F_UNLCK</constant> gesetzt. + </para> + </listitem> + <listitem> + <para> + <constant>F_DUPFD</constant> - + Findet den kleinsten verfügbaren Dateideskriptor >= + <parameter>args</parameter> und gibt diesen zurück. + </para> + </listitem> + <listitem> + <para> + <constant>F_SETFL</constant> - + Setzt die Flags des Dateideskriptors auf den in + <parameter>args</parameter> angegebenen Wert. Die verfügbaren Flags + sind <constant>O_APPEND</constant>, <constant>O_NONBLOCK</constant> + und <constant>O_ASYNC</constant>. Um <constant>O_ASYNC</constant> + setzen zu können benötigen sie die <link linkend="ref.pcntl">PCNTL</link> + Extension. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + Die <parameter>cmd</parameter> Operationen <constant>F_SETLK</constant> + und <constant>F_SETLLW</constant> erwarten ein Array mit den folgenden + Elementen: + <itemizedlist> + <listitem> + <para> + "start" - Offset an dem die Sperre beginnt + </para> + </listitem> + <listitem> + <para> + "length" - Länge des gesperrten Bereichs, 0 bedeutet dabei "bis zum + Dateiende" + </para> + </listitem> + <listitem> + <para> + "wenth" - Die Position auf die sich <parameter>start</parameter> + bezieht, dabei steht <constant>SEEK_SET</constant> für den + Dateianfang, <constant>SEEK_END</constant> für das Dateiende und + <constant>SEEK_CUR</constant> für die aktuelle + Schreib-/Leseposition. + </para> + </listitem> + <listitem> + <para> + "type" - Art der Sperre: <constant>F_RDLCK</constant> (Lesesperre), + <constant>F_WRLCK</constant> (Schreibsperre) oder + <constant>F_UNLCK</constant> (Sperre aufheben) + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt das Ergebnis des entsprechenden C Aufrufs zurück. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Setzen und Löschen einer Sperre</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$fd = dio_open('/dev/ttyS0', O_RDWR); + +if (dio_fcntl($fd, F_SETLK, Array("type"=>F_WRLCK)) == -1) { + // Die Datei ist anscheinend schon anderweitig gesperrt + echo "Sperrung fehlgeschlagen, die Datei wird schon von jemand anderem gesperrt."; +} else { + echo "Sperrung erfolgreich durchgeführt"; +} + +dio_close($fd); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dio/functions/dio-truncate.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/dio/functions/dio-truncate.xml diff -u phpdoc-de/reference/dio/functions/dio-truncate.xml:1.5 phpdoc-de/reference/dio/functions/dio-truncate.xml:1.6 --- phpdoc-de/reference/dio/functions/dio-truncate.xml:1.5 Sat Jun 23 13:21:32 2007 +++ phpdoc-de/reference/dio/functions/dio-truncate.xml Thu Mar 20 11:28:57 2008 @@ -1,30 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/dio.xml, last change in rev 1.1 --> -<!-- last change to 'dio-truncate' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: georg Status: n/a --> -<!-- OLD-Revision: 1.6/EN.1.1 --> - <refentry xml:id="function.dio-truncate" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dio_truncate</refname> - <refpurpose>Schneidet eine Datei ab</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</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> - Die Funktion <function>dio_truncate</function> schneidet die - Datei <parameter>fd</parameter> nach - <parameter>offset</parameter> ab. War die Datei ursprünglich - grösser, so gehen die Daten verloren. War sie kleiner so wird sie - mit Nullen aufgefüllt. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: hholzgra Status: ready --> +<!-- Credits: georg --> +<refentry xml:id="function.dio-truncate" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dio_truncate</refname> + <refpurpose>Schneidet eine Datei ab</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</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> + Die Funktion <function>dio_truncate</function> schneidet die + Datei <parameter>fd</parameter> nach + <parameter>offset</parameter> ab. War die Datei ursprünglich + grösser, so gehen die Daten verloren. War sie kleiner so wird sie + mit Nullen aufgefüllt. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Ein von <function>dio_open</function> zurückgegebener Dateideskriptor. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Der Offset in Bytes. + </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/viewvc.cgi/phpdoc-de/appendices/aliases.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-de/appendices/aliases.xml diff -u phpdoc-de/appendices/aliases.xml:1.16 phpdoc-de/appendices/aliases.xml:1.17 --- phpdoc-de/appendices/aliases.xml:1.16 Thu Mar 20 09:00:26 2008 +++ phpdoc-de/appendices/aliases.xml Thu Mar 20 11:28:57 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.33 Maintainer: hholzgra Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.34 Maintainer: hholzgra Status: ready --> <appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Liste der Funktion Aliase</title> <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/history.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-de/appendices/history.xml diff -u phpdoc-de/appendices/history.xml:1.13 phpdoc-de/appendices/history.xml:1.14 --- phpdoc-de/appendices/history.xml:1.13 Thu Mar 20 08:55:56 2008 +++ phpdoc-de/appendices/history.xml Thu Mar 20 11:28:57 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <!-- EN-Revision: 1.19 Maintainer: tom Status: ready --> <appendix xml:id="history" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -195,7 +195,7 @@ </para> <para> Weitere Informationen zu PEAR finden sie im - <link xlink:href="&url.php.pear.manual">PEAR Manual</link>. + <link xlink:href="&url.php.pear.manual;">PEAR Manual</link>. </para> </sect2> http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/ini.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-de/appendices/ini.xml diff -u phpdoc-de/appendices/ini.xml:1.12 phpdoc-de/appendices/ini.xml:1.13 --- phpdoc-de/appendices/ini.xml:1.12 Thu Mar 20 08:55:56 2008 +++ phpdoc-de/appendices/ini.xml Thu Mar 20 11:28:57 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <!-- EN-Revision: 1.59 Maintainer: hholzgra Status: ready --> <!-- CREDITS: wiesemann, betz, simp --> @@ -3199,12 +3199,12 @@ <warning> <para> Sowohl im CGI als auch im FastCGI SAPI enthält - <link linkend"reserved.variables.server">$_SERVER<link> + <link linkend="reserved.variables.server">$_SERVER</link> immer auch Variablen aus dem Environment, <literal>S</literal> ist hier immer equvalent zu <literal>ES</literal> unabhängig davon ob <literal>E</literal> noch anderweitig in der Direktive benutzt wird. - </par> + </para> </warning> <note> <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dio/functions/dio-close.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/dio/functions/dio-close.xml diff -u phpdoc-de/reference/dio/functions/dio-close.xml:1.5 phpdoc-de/reference/dio/functions/dio-close.xml:1.6 --- phpdoc-de/reference/dio/functions/dio-close.xml:1.5 Sat Jun 23 13:21:32 2007 +++ phpdoc-de/reference/dio/functions/dio-close.xml Thu Mar 20 11:28:57 2008 @@ -1,26 +1,71 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/dio.xml, last change in rev 1.1 --> -<!-- last change to 'dio-close' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: georg Status: n/a --> -<!-- OLD-Revision: 1.6/EN.1.1 --> - <refentry xml:id="function.dio-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dio_close</refname> - <refpurpose>Schliesst die Datei</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>dio_close</methodname> - <methodparam><type>resource</type><parameter>fd</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion <function>dio_close</function> schliesst die Datei - <parameter>fd</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: hholzgra Status: ready --> +<!-- Credits: georg --> +<refentry xml:id="function.dio-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dio_close</refname> + <refpurpose>Schliesst eine Datei</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>void</type><methodname>dio_close</methodname> + <methodparam><type>resource</type><parameter>fd</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion <function>dio_close</function> schliesst die Datei + <parameter>fd</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Eine von <function>dio_open</function> zurückgegebene + Dateideskriptorresource. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Schließen eines geöffneten Dateideskriptors</title> + <programlisting role="php"> +<![CDATA[ +<?php +$fd = dio_open('/dev/ttyS0', O_RDWR); + +dio_close($fd); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <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/viewvc.cgi/phpdoc-de/reference/dio/functions/dio-fcntl.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/dio/functions/dio-fcntl.xml diff -u phpdoc-de/reference/dio/functions/dio-fcntl.xml:1.5 phpdoc-de/reference/dio/functions/dio-fcntl.xml:1.6 --- phpdoc-de/reference/dio/functions/dio-fcntl.xml:1.5 Sat Jun 23 13:21:32 2007 +++ phpdoc-de/reference/dio/functions/dio-fcntl.xml Thu Mar 20 11:28:57 2008 @@ -1,85 +1,167 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/dio.xml, last change in rev 1.1 --> -<!-- last change to 'dio-fcntl' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: georg Status: n/a --> -<!-- OLD-Revision: 1.6/EN.1.1 --> - <refentry xml:id="function.dio-fcntl" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dio_fcntl</refname> - <refpurpose>Ändert den Dateideskriptor</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</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> - Die Funktion <function>dio_fcntl</function> führt eine Aktion - <parameter>cmd</parameter> an der Datei <parameter>fd</parameter> - aus. Einige Aktionen <parameter>cmd</parameter> benötigen das - zusätzliche Argument <parameter>args</parameter>. - </para> - <para> - <parameter>arg</parameter> ist ein assoziatives Array, wenn - <parameter>cmd</parameter> F_SETLK oder F_SETLLW ist. Es hat - folgende Einträge: - <itemizedlist> - <listitem> - <para> - "start" - offset an dem der Lock beginnt - </para> - </listitem> - <listitem> - <para> - "length" - Länge des gelockten Bereichs - </para> - </listitem> - <listitem> - <para> - "wenth" - Relative Position von start. Kann folgende Werte - annehmen: SEEK_SET, SEEK_END and SEEK_CUR - </para> - </listitem> - <listitem> - <para> - "type" - Locktyp: F_RDLCK (read lock), F_WRLCK (write lock) - oder F_UNLCK (unlock) - </para> - </listitem> - </itemizedlist> - </para> - <para> - <parameter>cmd</parameter> ist einer der folgenden Konstanten: - <itemizedlist> - <listitem> - <para> - F_SETLK - Setzt oder löscht einen Lock. Ist der Bereich - bereits von einem anderen Prozess gelockt, so liefert die - Funktion <function>dio_fcntl</function> -1 zurück. - </para> - </listitem> - <listitem> - <para> - F_SETLKW - wie F_SETLK, jedoch im Falle, dass der Bereich von - einem anderen Prozess gelockt wird, wartet - <function>dio_fcntl</function> auf die Freigabe des Locks. - </para> - </listitem> - <listitem> - <para> - F_GETLK - <function>dio_fcntl</function> liefert ein - assioziatives Array zurück (Beschreibung siehe oben), falls - ein anderer Prozess den Bereich gelockt hat. - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.11 Maitainer: hholzgra Status: ready --> +<refentry xml:id="function.dio-fcntl" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dio_fcntl</refname> + <refpurpose>Modifiziert einen Dateideskriptor</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> + Die Funktion <function>dio_fcntl</function> führt die mit + <parameter>cmd</parameter> festgelegte Operation auf dem + Dateideskriptor <parameter>fd</parameter> aus. Für einige + dieser Operationen müssen zusätzliche Argumente im + Parameter <parameter>args</parameter> übergeben werden. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Ein von <function>dio_open</function> zurückgegebener + Dateideskriptor. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cmd</parameter></term> + <listitem> + <para> + Eine der folgenden Operationen: + <itemizedlist> + <listitem> + <para> + <constant>F_SETLK</constant> - Setzt oder Löscht eine + Dateisperre. Wenn diese Sperre bereits von jemand anderem + gehalten wird gibt <function>dio_fcntl</function> -1 + zurück. + </para> + </listitem> + <listitem> + <para> + <constant>F_SETLKW</constant> - ähnlich <constant>F_SETLK</constant>, + hier wird aber in dem Fall das bereits jemand anderes die Sperre + hält gewartet bis diese wieder freigegeben wird. + </para> + </listitem> + <listitem> + <para> + <constant>F_GETLK</constant> - <function>dio_fcntl</function> + gibt ein assoziatives Array mit Informationen (wie weiter unten + beschrieben) zurüc wenn jemand anders bereits eine Sperre hält. + Existiert keine andere Sperre wird das Element "type" auf + <constant>F_UNLCK</constant> gesetzt. + </para> + </listitem> + <listitem> + <para> + <constant>F_DUPFD</constant> - + Findet den kleinsten verfügbaren Dateideskriptor >= + <parameter>args</parameter> und gibt diesen zurück. + </para> + </listitem> + <listitem> + <para> + <constant>F_SETFL</constant> - + Setzt die Flags des Dateideskriptors auf den in + <parameter>args</parameter> angegebenen Wert. Die verfügbaren Flags + sind <constant>O_APPEND</constant>, <constant>O_NONBLOCK</constant> + und <constant>O_ASYNC</constant>. Um <constant>O_ASYNC</constant> + setzen zu können benötigen sie die <link linkend="ref.pcntl">PCNTL</link> + Extension. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + Die <parameter>cmd</parameter> Operationen <constant>F_SETLK</constant> + und <constant>F_SETLLW</constant> erwarten ein Array mit den folgenden + Elementen: + <itemizedlist> + <listitem> + <para> + "start" - Offset an dem die Sperre beginnt + </para> + </listitem> + <listitem> + <para> + "length" - Länge des gesperrten Bereichs, 0 bedeutet dabei "bis zum + Dateiende" + </para> + </listitem> + <listitem> + <para> + "wenth" - Die Position auf die sich <parameter>start</parameter> + bezieht, dabei steht <constant>SEEK_SET</constant> für den + Dateianfang, <constant>SEEK_END</constant> für das Dateiende und + <constant>SEEK_CUR</constant> für die aktuelle + Schreib-/Leseposition. + </para> + </listitem> + <listitem> + <para> + "type" - Art der Sperre: <constant>F_RDLCK</constant> (Lesesperre), + <constant>F_WRLCK</constant> (Schreibsperre) oder + <constant>F_UNLCK</constant> (Sperre aufheben) + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt das Ergebnis des entsprechenden C Aufrufs zurück. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Setzen und Löschen einer Sperre</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$fd = dio_open('/dev/ttyS0', O_RDWR); + +if (dio_fcntl($fd, F_SETLK, Array("type"=>F_WRLCK)) == -1) { + // Die Datei ist anscheinend schon anderweitig gesperrt + echo "Sperrung fehlgeschlagen, die Datei wird schon von jemand anderem gesperrt."; +} else { + echo "Sperrung erfolgreich durchgeführt"; +} + +dio_close($fd); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/dio/functions/dio-truncate.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/dio/functions/dio-truncate.xml diff -u phpdoc-de/reference/dio/functions/dio-truncate.xml:1.5 phpdoc-de/reference/dio/functions/dio-truncate.xml:1.6 --- phpdoc-de/reference/dio/functions/dio-truncate.xml:1.5 Sat Jun 23 13:21:32 2007 +++ phpdoc-de/reference/dio/functions/dio-truncate.xml Thu Mar 20 11:28:57 2008 @@ -1,30 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/dio.xml, last change in rev 1.1 --> -<!-- last change to 'dio-truncate' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: georg Status: n/a --> -<!-- OLD-Revision: 1.6/EN.1.1 --> - <refentry xml:id="function.dio-truncate" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dio_truncate</refname> - <refpurpose>Schneidet eine Datei ab</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</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> - Die Funktion <function>dio_truncate</function> schneidet die - Datei <parameter>fd</parameter> nach - <parameter>offset</parameter> ab. War die Datei ursprünglich - grösser, so gehen die Daten verloren. War sie kleiner so wird sie - mit Nullen aufgefüllt. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: hholzgra Status: ready --> +<!-- Credits: georg --> +<refentry xml:id="function.dio-truncate" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dio_truncate</refname> + <refpurpose>Schneidet eine Datei ab</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</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> + Die Funktion <function>dio_truncate</function> schneidet die + Datei <parameter>fd</parameter> nach + <parameter>offset</parameter> ab. War die Datei ursprünglich + grösser, so gehen die Daten verloren. War sie kleiner so wird sie + mit Nullen aufgefüllt. + </para> + ¬e.no-windows; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>fd</parameter></term> + <listitem> + <para> + Ein von <function>dio_open</function> zurückgegebener Dateideskriptor. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Der Offset in Bytes. + </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: