eschmid Tue Jan 8 18:05:37 2002 EDT
Modified files:
/phpdoc/de/functions dio.xml
Log:
Whitespace only. Please use emacs psgml-mode.
Index: phpdoc/de/functions/dio.xml
diff -u phpdoc/de/functions/dio.xml:1.2 phpdoc/de/functions/dio.xml:1.3
--- phpdoc/de/functions/dio.xml:1.2 Mon Jan 7 07:11:52 2002
+++ phpdoc/de/functions/dio.xml Tue Jan 8 18:05:36 2002
@@ -8,17 +8,18 @@
<section id="dio.intro">
<title>Direkte Ein-/Ausgabe Funktionen</title>
<para>
- PHP unterst�tzt die direkte Ein-/Ausgabe-Funktionen, beschrieben
- im Posix Standard (Kapitel 6) f�r die Ein- und Ausgabe auf einer
- niederen Ebene als die standardm�ssig verwendeten C-Funktionen
- (fopen, fread,...).
+ PHP unterst�tzt die direkte Ein-/Ausgabe-Funktionen, beschrieben
+ im Posix Standard (Kapitel 6) f�r die Ein- und Ausgabe auf einer
+ niederen Ebene als die standardm�ssig verwendeten C-Funktionen
+ (fopen, fread, ...).
</para>
</section>
<section id="dio.installation">
<title>Installation</title>
<para>
Um die DIO Funktionen benutzen zu k�nnen, muss PHP mit der Option
- <option role="configure">--enable-dio</option> konfiguriert werden.
+ <option role="configure">--enable-dio</option> konfiguriert
+ werden.
</para>
</section>
</partintro>
@@ -26,53 +27,79 @@
<refentry id="function.dio-open">
<refnamediv>
<refname>dio_open</refname>
- <refpurpose>�ffnet eine Datei mit den angegebenen Rechten</refpurpose>
+ <refpurpose>
+ �ffnet eine Datei mit den angegebenen Rechten
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>dio_open</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>int <parameter>flags</parameter></paramdef>
- <paramdef>int
- <parameter><optional>mode</optional></parameter>
- </paramdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>int <parameter>flags</parameter></paramdef>
+ <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>dio_open</function> �ffnet eine Datei und liefert
- einen Dateizeiger zur�ck. Im Fehlerfall liefert
- <function>dio_open</function> -1 zur�ck.
- Ist der Parameter <parameter>flags</parameter> O_CREAT,
- so gibt der optionale Parameter <parameter>mode</parameter> die
- Dateirechte an.
- Der Parameter <parameter>flags</parameter> kann eine der
- folgenden Zugriffsmethoden sein:
- <itemizedlist>
- <listitem><para>O_RDONLY - �ffnet die Datei f�r
- Lesezugriff</para></listitem>
- <listitem><para>O_WRONLY - �ffnet die Datei f�r
- Schreibzugriff</para></listitem>
- <listitem><para>O_RDWR - �ffnet die Datei f�r Schreib- und
- Lesezugriff</para></listitem>
- </itemizedlist>
- Diese Zugriffsmethoden k�nnen mit folgenden Attributen
- kombiniert werden:
- <itemizedlist>
- <listitem><para>O_CREAT - erzeugt die Datei, falls diese nicht
- existiert.</para></listitem>
- <listitem><para>O_EXCL - in Kombination mit O_CREAT wird ein
- Fehler (-1) zur�ckgegeben, wenn die Datei bereits
existiert.</para></listitem>
- <listitem><para>O_TRUNC - falls die Datei bereits existiert,
- und sie f�r Schreibzugriff ge�ffnet wird, wird diese auf die
- Gr�sse 0 zur�ckgesetzt.</para></listitem>
- <listitem><para>O_APPEND - setzt den Zeiger f�r
- Schreiboperationen an das Ende der Datei.
- </para></listitem>
- <listitem><para>O_NONBLOCK - Setzt den Modus auf
- "nonblocking"</para></listitem>
- </itemizedlist>
+ <function>dio_open</function> �ffnet eine Datei und liefert einen
+ Dateizeiger zur�ck. Im Fehlerfall liefert
+ <function>dio_open</function> -1 zur�ck. Ist der Parameter
+ <parameter>flags</parameter> O_CREAT, so gibt der optionale
+ Parameter <parameter>mode</parameter> die Dateirechte an. Der
+ Parameter <parameter>flags</parameter> kann eine der folgenden
+ Zugriffsmethoden sein:
+ <itemizedlist>
+ <listitem>
+ <para>
+ O_RDONLY - �ffnet die Datei f�r Lesezugriff
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ O_WRONLY - �ffnet die Datei f�r
+ Schreibzugriff
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ O_RDWR - �ffnet die Datei f�r Schreib- und Lesezugriff
+ </para>
+ </listitem>
+ </itemizedlist>
+ Diese Zugriffsmethoden k�nnen mit folgenden Attributen kombiniert
+ werden:
+ <itemizedlist>
+ <listitem>
+ <para>
+ O_CREAT - erzeugt die Datei, falls diese nicht existiert
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ O_EXCL - in Kombination mit O_CREAT wird ein Fehler (-1)
+ zur�ckgegeben, wenn die Datei bereits existiert
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ O_TRUNC - falls die Datei bereits existiert, und sie f�r
+ Schreibzugriff ge�ffnet wird, wird diese auf die Gr�sse 0
+ zur�ckgesetzt
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ O_APPEND - setzt den Zeiger f�r Schreiboperationen an das Ende
+ der Datei
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ O_NONBLOCK - Setzt den Modus auf "nonblocking"
+ </para>
+ </listitem>
+ </itemizedlist>
</para>
</refsect1>
</refentry>
@@ -80,18 +107,18 @@
<refentry id="function.dio-read">
<refnamediv>
<refname>dio_read</refname>
- <refpurpose>Liest n Bytes und gibt sie zur�ck, ist n nicht
- angegeben wird ein 1K Block gelesen.</refpurpose>
+ <refpurpose>
+ Liest n Bytes und gibt sie zur�ck, ist n nicht angegeben wird ein
+ 1K Block gelesen
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dio_read</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
- <paramdef>int
- <parameter><optional>n</optional></parameter>
- </paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>int <parameter><optional>n</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -114,21 +141,18 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>dio_write</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
- <paramdef>string <parameter>data</parameter></paramdef>
- <paramdef>int
- <parameter><optional>len</optional></parameter>
- </paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>string <parameter>data</parameter></paramdef>
+ <paramdef>int <parameter><optional>len</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Die Funktion <function>dio_write</function> schreibt bis zu
<parameter>len</parameter> Bytes an Daten
<parameter>data</parameter> in die Datei
- <parameter>fd</parameter>.
- Wird der optionale Parameter <parameter>len</parameter> nicht
- angegeben, so werden alle Daten <parameter>data</parameter> in
- die Datei geschrieben.
+ <parameter>fd</parameter>. Wird der optionale Parameter
+ <parameter>len</parameter> nicht angegeben, so werden alle Daten
+ <parameter>data</parameter> in die Datei geschrieben.
<function>dio_write</function> liefert die Anzahl der Bytes
zur�ck, die in die Datei geschrieben wurden.
</para>
@@ -145,16 +169,16 @@
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>dio_truncate</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
- <paramdef>int <parameter>offset</parameter></paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>int <parameter>offset</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<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.
+ <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>
@@ -162,37 +186,37 @@
<refentry id="function.dio-stat">
<refnamediv>
<refname>dio_stat</refname>
- <refpurpose>Liefert Statusinformationen �ber eine Datei </refpurpose>
+ <refpurpose>Liefert Statusinformationen �ber eine Datei</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>dio_stat</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Die Funktion <function>fstat</function> gibts ein assoziatives
- Array zur�ck, welches Informationen �ber die Datei
- <parameter>fd</parameter> enth�lt.
- Das Array enth�lt folgende Eintr�ge:
- <itemizedlist>
- <listitem><para>"device" - Device</para></listitem>
- <listitem><para>"inode" - Inode</para></listitem>
- <listitem><para>"mode" - Modus</para></listitem>
- <listitem><para>"nlink" - Anzahl Links</para></listitem>
- <listitem><para>"uid" - Benutzer Id</para></listitem>
- <listitem><para>"gid" - Gruppentyp</para></listitem>
- <listitem><para>"device_type" - Device Typ</para></listitem>
- <listitem><para>"size" - Gr�sse in Bytes</para></listitem>
- <listitem><para>"blocksize" - Blockgr�sse</para></listitem>
- <listitem><para>"blocks" - Anzahl allocierter Bl�cke</para></listitem>
- <listitem><para>"atime" - Letzter Zugriff</para></listitem>
- <listitem><para>"mtime" - Letze Modifikation</para></listitem>
- <listitem><para>"ctime" - Letzte �nderung</para></listitem>
- </itemizedlist>
- Im Fehlerfall liefert <function>dio_stat</function> NULL zur�ck.
+ Die Funktion <function>fstat</function> gibts ein assoziatives
+ Array zur�ck, welches Informationen �ber die Datei
+ <parameter>fd</parameter> enth�lt. Das Array enth�lt folgende
+ Eintr�ge:
+ <itemizedlist>
+ <listitem><para>"device" - Device</para></listitem>
+ <listitem><para>"inode" - Inode</para></listitem>
+ <listitem><para>"mode" - Modus</para></listitem>
+ <listitem><para>"nlink" - Anzahl Links</para></listitem>
+ <listitem><para>"uid" - Benutzer Id</para></listitem>
+ <listitem><para>"gid" - Gruppentyp</para></listitem>
+ <listitem><para>"device_type" - Device Typ</para></listitem>
+ <listitem><para>"size" - Gr�sse in Bytes</para></listitem>
+ <listitem><para>"blocksize" - Blockgr�sse</para></listitem>
+ <listitem><para>"blocks" - Anzahl allocierter Bl�cke</para></listitem>
+ <listitem><para>"atime" - Letzter Zugriff</para></listitem>
+ <listitem><para>"mtime" - Letze Modifikation</para></listitem>
+ <listitem><para>"ctime" - Letzte �nderung</para></listitem>
+ </itemizedlist>
+ Im Fehlerfall liefert <function>dio_stat</function> NULL zur�ck.
</para>
</refsect1>
</refentry>
@@ -207,28 +231,38 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>dio_seek</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
- <paramdef>int <parameter>pos</parameter></paramdef>
- <paramdef>int <parameter>whence</parameter></paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>int <parameter>pos</parameter></paramdef>
+ <paramdef>int <parameter>whence</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Die Funktion <function>dio_seek</function> setzt den Dateizeiger
- der Datei <parameter>fd</parameter>.
- Der <parameter>whence</parameter> gibt dabei an, wie die Position
+ der Datei <parameter>fd</parameter>. Der
+ <parameter>whence</parameter> gibt dabei an, wie die Position
<parameter>pos</parameter> interpretiert werden soll:
<itemizedlist>
- <listitem><para>SEEK_SET - gibt an, dass
- <parameter>pos</parameter> die Position vom Anfang der Datei
- ist</para></listitem>
- <listitem><para>SEEK_CUR - gibt an, dass
- <parameter>pos</parameter> die Position relativ von der
- momentanen Dateizeigerposition ist.</para></listitem>
- <listitem><para>SEEK_END - gibt an, dass
- <parameter>pos</parameter> die Position relativ zum Dateiende
- ist. Eine negative Zahl setzt den Dateizeiger innerhalb der
- Datei, ein positvier Wert bewirkt, dass die Datei vom Ende bis
- zur neuen Position mit Nullen aufgef�llt wird.</para></listitem>
+ <listitem>
+ <para>
+ SEEK_SET - gibt an, dass <parameter>pos</parameter> die
+ Position vom Anfang der Datei ist
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ SEEK_CUR - gibt an, dass <parameter>pos</parameter> die
+ Position relativ von der momentanen Dateizeigerposition ist.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ SEEK_END - gibt an, dass <parameter>pos</parameter> die
+ Position relativ zum Dateiende ist. Eine negative Zahl setzt
+ den Dateizeiger innerhalb der Datei, ein positvier Wert
+ bewirkt, dass die Datei vom Ende bis zur neuen Position mit
+ Nullen aufgef�llt wird.
+ </para>
+ </listitem>
</itemizedlist>
</para>
</refsect1>
@@ -244,55 +278,71 @@
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>dio_fcntl</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
- <paramdef>int <parameter>cmd</parameter></paramdef>
- <paramdef>mixed
- <parameter><optional>arg</optional></parameter>
- </paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>int <parameter>cmd</parameter></paramdef>
+ <paramdef>mixed <parameter><optional>arg</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<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
+ <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:
+ <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) oderr F_UNLCK (unlock)</para></listitem>
+ <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>
- <para>
-
+ <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>
@@ -307,12 +357,12 @@
<funcsynopsis>
<funcprototype>
<funcdef>void <function>dio_close</function></funcdef>
- <paramdef>resource <parameter>fd</parameter></paramdef>
+ <paramdef>resource <parameter>fd</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Die Funktion <function>dio_close</function> schliesst die
- Datei <parameter>fd</parameter>.
+ Die Funktion <function>dio_close</function> schliesst die Datei
+ <parameter>fd</parameter>.
</para>
</refsect1>
</refentry>
