georg Sun Jan 6 16:12:21 2002 EDT
Added files:
/phpdoc/de/functions dio.xml
Log:
finished german translation for dio functions
Index: phpdoc/de/functions/dio.xml
+++ phpdoc/de/functions/dio.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $EN-Revision: 1.60 maintainer: georg status: ready$ -->
<reference id="ref.dio">
<title>Direkte Ein-/Ausgabe Funktionen</title>
<titleabbrev>Direkte Ein-/Ausgabe Funktionen</titleabbrev>
<partintro>
<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,...).
</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.
</para>
</section>
</partintro>
<refentry id="function.dio-open">
<refnamediv>
<refname>dio_open</refname>
<refpurpose>�ffnet eine Datei mit den angegebenen Rechten</repurpose>
</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>
</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.
<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.
<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>
<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>
</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>
</funcprototype>
</funcsynopsis>
<para>
Die Funktion <function>dio_read</function> liest
<parameter>n</parameter> Bytes aus der Datei
<parameter>fd</parameter> und gibt diese zur�ck. Wird der
optionale Parameter <parameter>n</parameter> nicht angegeben,
wird standardm�ssig ein 1K Block gelesen und zur�ckgegeben.
</para>
</refsect1>
</refentry>
<refentry id="function.dio-write">
<refnamediv>
<refname>dio_write</refname>
<refpurpose>Schreibt Daten in eine Datei</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung
<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>
</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.
<function>dio_write</function> liefert die Anzahl der Bytes
zur�ck, die in die Datei geschrieben wurden.
</para>
</refsect1>
</refentry>
<refentry id="function.dio-truncate">
<refnamediv>
<refname>dio_truncate</refname>
<refpurpose>Schneidet eine Datei ab</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>dio_truncate</function></funcdef>
<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.
</para>
</refsect1>
</refentry>
<refentry id="function.dio-stat">
<refnamediv>
<refname>dio_stat</refname>
<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>
</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.
</para>
</refsect1>
</refentry>
<refentry id="function.dio-seek">
<refnamediv>
<refname>dio_seek</refname>
<refpurpose>Setzt den Dateizeiger</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<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>
</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
<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>
</itemizedlist>
</para>
</refsect1>
</refentry>
<refentry id="function.dio-fcntl">
<refnamediv>
<refname>dio_fcntl</refname>
<refpurpose>�ndert den Dateideskriptor</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<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>
</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
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) oderr 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>
</para>
</refsect1>
</refentry>
<refentry id="function.dio-close">
<refnamediv>
<refname>dio_close</refname>
<refpurpose>Schliesst die Datei</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>dio_close</function></funcdef>
<paramdef>resource <parameter>fd</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Die Funktion <function>dio_close</function> schliesst die
Datei <parameter>fd</parameter>.
</para>
</refsect1>
</refentry>
</reference>
<!-- 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:
-->
