eschmid Wed Sep 5 21:21:47 2001 EDT
Modified files:
/phpdoc/de/functions exec.xml
Log:
Only whitespace and to confuse my revision ...
Index: phpdoc/de/functions/exec.xml
diff -u phpdoc/de/functions/exec.xml:1.7 phpdoc/de/functions/exec.xml:1.8
--- phpdoc/de/functions/exec.xml:1.7 Wed Sep 5 06:31:12 2001
+++ phpdoc/de/functions/exec.xml Wed Sep 5 21:21:41 2001
@@ -1,23 +1,26 @@
<?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<reference id="ref.exec">
<title>Funktionen zur Programmausf�hrung</title>
<titleabbrev>Programmausf�hrung</titleabbrev>
<partintro>
<simpara>
- Diese Funktionen stellen Mittel und Wege zur Verf�gung, Befehle und externe
- Programme auf dem System selbst auszuf�hren und diese Ausf�hrung sicher
- durchzuf�hren. Diese Funktionen stehen in enger Beziehung zum
- <link linkend="language.operators.execution">Backtick-Operator</link>.
+ Diese Funktionen stellen Mittel und Wege zur Verf�gung, Befehle
+ und externe Programme auf dem System selbst auszuf�hren und diese
+ Ausf�hrung sicher durchzuf�hren. Diese Funktionen stehen in enger
+ Beziehung zum <link
+ linkend="language.operators.execution">Backtick-Operator</link>.
</simpara>
</partintro>
<refentry id="function.escapeshellarg">
<refnamediv>
<refname>escapeshellarg</refname>
- <refpurpose>maskiert eine Zeichenkette (String), um sie als Shell-Argument
- benutzen zu k�nnen</refpurpose>
+ <refpurpose>
+ Maskiert eine Zeichenkette (String), um sie als Shell-Argument
+ benutzen zu k�nnen
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -28,16 +31,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>escapeshellarg</function> f�gt einfache Anf�hrungszeichen um
- eine Zeichenkette herum ein und maskiert alle existierenden einfachen
- Anf�hrungszeichen innerhalb der Zeichenkette. Dieses erlaubt es Ihnen,
- eine Zeichenkette direkt an eine Shell-Funktion zu �bergeben, so dass
- diese als eine einzige, sichere Anweisung ausgef�hrt werden kann.
- Die Funktion sollte verwendet werden, um Parameter, die aus Benutzereingaben
- resultieren, an Shell-Funktionen zu �bergeben. Die Shell-Funktionen
- umfassen <function>exec</function>, <function>system</function> und den
- <link linkend="language.operators.execution">backtick operator</link>.
- Beispiel:</para>
+ <function>escapeshellarg</function> f�gt einfache
+ Anf�hrungszeichen um eine Zeichenkette herum ein und maskiert
+ alle existierenden einfachen Anf�hrungszeichen innerhalb der
+ Zeichenkette. Dieses erlaubt es Ihnen, eine Zeichenkette direkt
+ an eine Shell-Funktion zu �bergeben, so dass diese als eine
+ einzige, sichere Anweisung ausgef�hrt werden kann. Die Funktion
+ sollte verwendet werden, um Parameter, die aus Benutzereingaben
+ resultieren, an Shell-Funktionen zu �bergeben. Die
+ Shell-Funktionen umfassen <function>exec</function>,
+ <function>system</function> und den <link
+ linkend="language.operators.execution">backtick operator</link>.
+ Beispiel:
+ </para>
<para>
<informalexample>
<programlisting role="php">
@@ -47,17 +53,16 @@
</para>
<para>
Siehe auch:<function>exec</function>, <function>popen</function>,
- <function>system</function>, und den <link
+ <function>system</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
-
</refsect1>
</refentry>
<refentry id="function.escapeshellcmd">
<refnamediv>
<refname>escapeshellcmd</refname>
- <refpurpose>maskiert Shell-Metazeichen</refpurpose>
+ <refpurpose>Maskiert Shell-Metazeichen</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -68,14 +73,15 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>escapeshellcmd</function> maskiert alle m�glichen Zeichen in
- einer Zeichenkette, die dazu benutzt werden k�nnten, um einen Shellbefehl
- zur Durchf�hrung von willk�rlichen Befehlen zu veranlassen. Diese
- Funktion sollte verwendet werden um sicherzustellen, dass alle Daten
- aus einer Benutzereingabe maskiert werden bevor dieses Daten zu einer
- der Funktionen <function>exec</function>, <function>system</function>
- oder dem <link linkend="language.operators.execution">Backtick Operator
- </link> �bergeben werden. Beispiel:</para>
+ <function>escapeshellcmd</function> maskiert alle m�glichen
+ Zeichen in einer Zeichenkette, die dazu benutzt werden k�nnten,
+ um einen Shellbefehl zur Durchf�hrung von willk�rlichen Befehlen
+ zu veranlassen. Diese Funktion sollte verwendet werden um
+ sicherzustellen, dass alle Daten aus einer Benutzereingabe
+ maskiert werden bevor dieses Daten zu einer der Funktionen
+ <function>exec</function>, <function>system</function> oder dem
+ <link linkend="language.operators.execution">Backtick Operator
+ </link> �bergeben werden. Beispiel:</para>
<para>
<informalexample>
<programlisting role="php">
@@ -87,18 +93,18 @@
</informalexample>
</para>
<para>
- Siehe auch: <function>escapeshellarg</function>, <function>exec</function>,
- <function>popen</function>, <function>system</function>, und den <link
+ Siehe auch: <function>escapeshellarg</function>,
+ <function>exec</function>, <function>popen</function>,
+ <function>system</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
-
</refsect1>
</refentry>
<refentry id="function.exec">
<refnamediv>
<refname>exec</refname>
- <refpurpose>f�hrt ein externes Programm aus</refpurpose>
+ <refpurpose>F�hrt ein externes Programm aus</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -116,42 +122,44 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>exec</function> f�hrt ein gegebenen <parameter>Befehl</parameter>
- aus, ohne eine Ausgabe zu erzeugen. Die Funktion gibt lediglich die
- letzte Zeile aus dem Befehlsergebnis zur�ck. Wenn Sie auf die direkte
- R�ckgabe/ Ausgabe eines Befehls angewiesen sind, dann benutzen Sie
- stattdessen die Funktion <function>passthru</function>.
- </para>
- <para>
- Ist der Parameter <parameter>array</parameter> angegeben, wird dieses
- mit jeder Zeile des Befehlsausgabe gef�llt. Beachten Sie, dass wenn
- das Array schon Elemente enth�lt, die Funktion <function>exec</function>
- die Ausgabe an das Array anh�ngt.
- Wenn Sie dieses nicht w�nschen, rufen Sie die Funktion <function>unset
- </function> f�r das Array auf, bevor Sie es als Parameter der Funktion
- <function>exec</function> �bergeben.
- </para>
- <para>
- Ist der Parameter <parameter>return_var</parameter> angegeben, so wird
- der R�ckgabestatus des ausgef�hrten Befehls in diese Variable geschrieben.
- </para>
- <para>
- Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
- �bergeben, diese mit <function>escapeshellcmd</function> behandelt, um
- sicherzustellen, dass niemand mit willk�rlichen Befehlen Ihrem System
- Schaden zuf�gen kann.
+ <function>exec</function> f�hrt ein gegebenen
+ <parameter>Befehl</parameter> aus, ohne eine Ausgabe zu
+ erzeugen. Die Funktion gibt lediglich die letzte Zeile aus dem
+ Befehlsergebnis zur�ck. Wenn Sie auf die direkte R�ckgabe/
+ Ausgabe eines Befehls angewiesen sind, dann benutzen Sie
+ stattdessen die Funktion <function>passthru</function>.
+ </para>
+ <para>
+ Ist der Parameter <parameter>array</parameter> angegeben, wird
+ dieses mit jeder Zeile des Befehlsausgabe gef�llt. Beachten Sie,
+ dass wenn das Array schon Elemente enth�lt, die Funktion
+ <function>exec</function> die Ausgabe an das Array anh�ngt. Wenn
+ Sie dieses nicht w�nschen, rufen Sie die Funktion <function>unset
+ </function> f�r das Array auf, bevor Sie es als Parameter der
+ Funktion <function>exec</function> �bergeben.
+ </para>
+ <para>
+ Ist der Parameter <parameter>return_var</parameter> angegeben, so
+ wird der R�ckgabestatus des ausgef�hrten Befehls in diese
+ Variable geschrieben.
+ </para>
+ <para>
+ Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
+ �bergeben, diese mit <function>escapeshellcmd</function>
+ behandelt, um sicherzustellen, dass niemand mit willk�rlichen
+ Befehlen Ihrem System Schaden zuf�gen kann.
</para>
<para>
Beachten Sie auch, dass wenn Sie ein Programm mit dieser Funktion
- starten und Sie es im Hintergrund laufen lassen m�chten, Sie
- sicherstellen m�ssen, dass die Ausgabe des Programms in eine Datei
- oder anderenen Ausgabestream umgeleitet wird. Andernfalls wird PHP
- solange laufen, bis das Programm beendet ist.
+ starten und Sie es im Hintergrund laufen lassen m�chten, Sie
+ sicherstellen m�ssen, dass die Ausgabe des Programms in eine
+ Datei oder anderenen Ausgabestream umgeleitet wird. Andernfalls
+ wird PHP solange laufen, bis das Programm beendet ist.
</para>
<para>
Siehe auch: <function>system</function>,
<function>passthru</function>, <function>popen</function>,
- <function>escapeshellcmd</function>, und den <link
+ <function>escapeshellcmd</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
</refsect1>
@@ -161,7 +169,7 @@
<refnamediv>
<refname>passthru</refname>
<refpurpose>
- f�hrt ein externes Programm aus und zeigt dessen Ausgabe an
+ F�hrt ein externes Programm aus und zeigt dessen Ausgabe an
</refpurpose>
</refnamediv>
<refsect1>
@@ -176,32 +184,33 @@
</funcprototype>
</funcsynopsis>
<para>
- Die Funktion <function>passthru</function> �hnelt der Funktion
- <function>exec</function>, da sie ebenfalls einen <parameter>Befehl
- </parameter> ausf�hrt.
- Ist der Parameter <parameter>return_var</parameter> angegeben, wird
- der R�ckgabestatus des UNIX-Befehls hier abgelegt. Sie sollten diese
- Funktion jedoch an Stelle von <function>exec</function> bzw.
- <function>system</function> benutzen, wenn es sich bei der Ausgabe
- des Unix-Befehls um bin�re Daten handelt, welche direkt zum Browser
- zur�ckgeschickt werden m�ssen.
- Ein praktisches Beispiel hierf�r ist die Ausf�hrung des pbmplus Utility,
- welches direkt einen Bildstream ausgibt. Wenn Sie den Content-Type auf
- <emphasis>image/gif</emphasis> setzen, und dann das pbmplus Program
- aufrufen um ein GIF zu erzeugen, k�nnen Sie auf diesem Weg mittels PHP
- direkt ein Bild erzeugen und es ausgeben.</para>
+ Die Funktion <function>passthru</function> �hnelt der Funktion
+ <function>exec</function>, da sie ebenfalls einen
+ <parameter>Befehl </parameter> ausf�hrt. Ist der Parameter
+ <parameter>return_var</parameter> angegeben, wird der
+ R�ckgabestatus des UNIX-Befehls hier abgelegt. Sie sollten diese
+ Funktion jedoch an Stelle von <function>exec</function> bzw.
+ <function>system</function> benutzen, wenn es sich bei der
+ Ausgabe des Unix-Befehls um bin�re Daten handelt, welche direkt
+ zum Browser zur�ckgeschickt werden m�ssen. Ein praktisches
+ Beispiel hierf�r ist die Ausf�hrung des pbmplus Utility, welches
+ direkt einen Bildstream ausgibt. Wenn Sie den Content-Type auf
+ <emphasis>image/gif</emphasis> setzen, und dann das pbmplus
+ Program aufrufen um ein GIF zu erzeugen, k�nnen Sie auf diesem
+ Weg mittels PHP direkt ein Bild erzeugen und es ausgeben.
+ </para>
<para>
Beachten Sie, dass wenn Sie ein Programm mit dieser Funktion
- starten und Sie es im Hintergrund laufen lassen m�chten, Sie
- sicherstellen m�ssen, dass die Ausgabe des Programms in eine Datei
- oder anderenen Ausgabestream umgeleitet wird. Andernfalls wird PHP
- solange laufen, bis das Programm beendet ist.
+ starten und Sie es im Hintergrund laufen lassen m�chten, Sie
+ sicherstellen m�ssen, dass die Ausgabe des Programms in eine
+ Datei oder anderenen Ausgabestream umgeleitet wird. Andernfalls
+ wird PHP solange laufen, bis das Programm beendet ist.
</para>
<para>
- Siehe auch: <function>exec</function>, <function>system</function>,
- <function>popen</function>, <function>escapeshellcmd</function>,
- und den <link linkend="language.operators.execution">Backtick
- Operator</link>.
+ Siehe auch: <function>exec</function>,
+ <function>system</function>, <function>popen</function>,
+ <function>escapeshellcmd</function> und den <link
+ linkend="language.operators.execution">Backtick Operator</link>.
</para>
</refsect1>
</refentry>
@@ -210,8 +219,8 @@
<refnamediv>
<refname>system</refname>
<refpurpose>
- f�hrt ein externes Programm aus und zeigt dessen Ausgabe an.
- </refpurpose>
+ F�hrt ein externes Programm aus und zeigt dessen Ausgabe an.
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -225,42 +234,44 @@
</funcprototype>
</funcsynopsis>
<para>
- Die Funktion <function>system</function> �hnelt der C Version der Funktion
- sehr, indem es einen �bergebenen <parameter>Befehl</parameter> ausf�hrt
- und dessen Ausgabe anzeigt. Wir als zweiter Parameter der Funktion eine
- Variable �bergeben, so wird der R�ckgabestatus des Befehls in diese
- geschrieben.
+ Die Funktion <function>system</function> �hnelt der C Version der
+ Funktion sehr, indem es einen �bergebenen
+ <parameter>Befehl</parameter> ausf�hrt und dessen Ausgabe
+ anzeigt. Wir als zweiter Parameter der Funktion eine Variable
+ �bergeben, so wird der R�ckgabestatus des Befehls in diese
+ geschrieben.
</para>
<para>
- Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
- �bergeben, diese mit <function>escapeshellcmd</function> behandelt, um
- sicherzustellen, dass niemand mit willk�rlichen Befehlen Ihrem System
- Schaden zuf�gen kann.
+ Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
+ �bergeben, diese mit <function>escapeshellcmd</function>
+ behandelt, um sicherzustellen, dass niemand mit willk�rlichen
+ Befehlen Ihrem System Schaden zuf�gen kann.
</para>
<para>
Beachten Sie auch, dass wenn Sie ein Programm mit dieser Funktion
- starten und Sie es im Hintergrund laufen lassen m�chten, Sie
- sicherstellen m�ssen, dass die Ausgabe des Programms in eine Datei
- oder anderenen Ausgabestream umgeleitet wird. Andernfalls wird PHP
- solange laufen, bis das Programm beendet ist.
+ starten und Sie es im Hintergrund laufen lassen m�chten, Sie
+ sicherstellen m�ssen, dass die Ausgabe des Programms in eine
+ Datei oder anderenen Ausgabestream umgeleitet wird. Andernfalls
+ wird PHP solange laufen, bis das Programm beendet ist.
</para>
<para>
- Die <function>system</function> Funktionsaufrufe versuchen �brigens
- automatisch nach jeder Ausgabezeile den Ausgabebuffer des Webservers
- zu flushen, wenn PHP als Servermodul l�uft.
+ Die <function>system</function> Funktionsaufrufe versuchen
+ �brigens automatisch nach jeder Ausgabezeile den Ausgabebuffer
+ des Webservers zu flushen, wenn PHP als Servermodul l�uft.
</para>
<para>
- Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls &false;
- zur�ck.
+ Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls
+ &false; zur�ck.
</para>
<para>
- Wenn Sie auf die direkte R�ckgabe/ Ausgabe eines Befehls angewiesen sind,
- dann benutzen Sie stattdessen die Funktion <function>passthru</function>.
+ Wenn Sie auf die direkte R�ckgabe/ Ausgabe eines Befehls
+ angewiesen sind, dann benutzen Sie stattdessen die Funktion
+ <function>passthru</function>.
</para>
<para>
Siehe auch: <function>exec</function>,
<function>passthru</function>, <function>popen</function>,
- <function>escapeshellcmd</function>, und den <link
+ <function>escapeshellcmd</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
</refsect1>
