 |
 |
 |
 |
|
|
Date: 08/15/00
- Next message: Kristian Köhntopp: "[PHP-DOC] cvs: phpdoc /en/functions filesystem.xml"
- Previous message: Thomas Schuermann: "[PHP-DOC] cvs: phpdoc /de/functions dir.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
tschuer Tue Aug 15 12:15:57 2000 EDT
Modified files:
/phpdoc/de/functions network.xml
Log:
changed fsockopen, added ip2long and long2ip, some cosmetics
Index: phpdoc/de/functions/network.xml
diff -u phpdoc/de/functions/network.xml:1.8 phpdoc/de/functions/network.xml:1.9
--- phpdoc/de/functions/network.xml:1.8 Fri Aug 11 03:47:18 2000
+++ phpdoc/de/functions/network.xml Tue Aug 15 12:15:57 2000
@@ -11,7 +11,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>checkdnsrr</function></funcdef>
@@ -24,9 +24,9 @@
<simpara>
Durchsucht den DNS (Domain-Name-Service) auf Daten des Typs
<parameter>type</parameter> auf Übereinstimmung mit
- <parameter>host</parameter>. Gibt true/wahr zurück, wenn ein
+ <parameter>host</parameter>. Gibt true / wahr zurück, wenn ein
Datensatz gefunden wurde. Ansonsten - oder wenn ein Fehler
- vorliegt - wird false/falsch zurück gegeben.
+ vorliegt - wird false / falsch zurück gegeben.
</simpara>
<simpara>
Der Parameter <parameter>type</parameter> kann sein: A, MX, NS,
@@ -53,7 +53,7 @@
<refpurpose>Schließt die Verbindung zum System-Logger</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>closelog</function></funcdef>
@@ -62,7 +62,7 @@
</funcsynopsis>
<para>
<function>Closelog</function> schließt den Descriptor, der
- benötigt wird um in den System-Logger zu schreiben. Der Gebrauch
+ benötigt wird um in den System-Logger zu schreiben. Der Gebrauch
von <function>closelog</function> ist optional.
</para>
</refsect1>
@@ -74,7 +74,7 @@
<refpurpose>Schaltet den internen PHP-Debugger aus</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>debugger_off</function></funcdef>
@@ -94,7 +94,7 @@
<refpurpose>Schaltet den internen PHP-Debugger ein</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>debugger_on</function></funcdef>
@@ -103,7 +103,7 @@
</funcsynopsis>
<para>
Schaltet den internen PHP-Debugger, zeigend auf
- <parameter>address</parameter>, ein. Der Debugger befindet sich
+ <parameter>address</parameter>, ein. Der Debugger befindet sich
noch in der Entwicklung.
</para>
</refsect1>
@@ -117,11 +117,13 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>fsockopen</function></funcdef>
- <paramdef>string <parameter>hostname</parameter></paramdef>
+ <paramdef>
+ string <parameter><optional>udp://</optional>hostname</parameter>
+ </paramdef>
<paramdef>int <parameter>port</parameter></paramdef>
<paramdef>int
<parameter><optional>errno</optional></parameter>
@@ -135,16 +137,18 @@
</funcprototype>
</funcsynopsis>
<para>
- Öffnet eine Socket-Verbindung zum Internet (AF_INET) oder unter
- Unix (AF_UNIX). Für eine Internet-Verbindung wird eine
- TCP-Socket-Verbindung zu <parameter>hostname</parameter> über den
- Port <parameter>port</parameter> hergestellt. Bei einer
- UNIX-Verbindung wird <parameter>hostname</parameter> als
- Socket-Pfad interpretiert, <parameter>port</parameter> muss in
- diesem Fall 0 sein. Der optionale Parameter
- <parameter>timeout</parameter> kann benutzt werden, um eine
- Fehlerwartezeit (timeout) für den Verbindungsaufbau (in Sekunden)
- zu setzen.
+ Öffnet eine Socket-Verbindung zum Internet (AF_INET, unter
+ Verwendung von TCP oder UDP) oder unter Unix (AF_UNIX). Für eine
+ Internet-Verbindung wird eine TCP-Socket-Verbindung zu
+ <parameter>hostname</parameter> über den Port
+ <parameter>port</parameter> hergestellt. Für eine UDP-Verbindung
+ müssen sie das Protokoll <parameter>udp://hostname</parameter>
+ explizit angeben. Bei einer UNIX-Verbindung wird
+ <parameter>hostname</parameter> als Socket-Pfad interpretiert,
+ <parameter>port</parameter> muss in diesem Fall 0 sein. Der
+ optionale Parameter <parameter>timeout</parameter> kann benutzt
+ werden, um eine Fehlerwartezeit (Timeout-Wert) für den
+ Verbindungsaufbau (in Sekunden) zu setzen.
</para>
<para>
Die Funktion <function>fsockopen</function> gibt einen Zeiger auf
@@ -160,7 +164,7 @@
<parameter>errstr</parameter> Argumente vorhanden sind, enthalten
sie den aktuellen System-Fehler, der beim Aufruf der
System-Funktion <literal>connect()</literal> (Verbindungsaufbau)
- erscheint bzw. passiert ist. Wenn die erhaltene errno 0 ist und
+ erscheint bzw. passiert ist. Wenn die erhaltene errno 0 ist und
die Funktion false/falsch zurück gibt, ist dies ein Hinweis, dass
der Fehler vor dem <literal>>connect()</literal>-Aufruf
geschah. Das ist ein Problem, dass häufig mit der Initialisierung
@@ -175,11 +179,11 @@
nicht zur Verfügung stehen.
</para>
<para>
- Voreingestellt ist der Verbindungsaufbau im Block-Modus. Sie
+ Voreingestellt ist der Verbindungsaufbau im Block-Modus. Sie
können dies auf Nicht-Block-Modus ändern, indem sie
<function>socket_set_blocking</function> benutzen.
<example>
- <title><function>Fsockopen</function> Beispiel</title>
+ <title><function>Fsockopen</function>-Beispiel:</title>
<programlisting role="php">
$fp = fsockopen ("www.php.net", 80, &$errno, &$errstr, 30);
if (!$fp) {
@@ -192,8 +196,26 @@
fclose($fp);
}
</programlisting>
+ </example>
+ Das folgende Beispiel zeigt, wie das Datum und die Zeit des
+ UDP-Service "daytime" (Port 13) von ihrer eigenen Maschine
+ empfangen werden kann:
+ <example>
+ <title>Gebrauch einer UDP-Verbindung:</title>
+ <programlisting role="php">
+<?php
+$fp = fsockopen("udp://127.0.0.1",13, &$errno; &$errstr);
+if (!fp) {
+ echo "Fehler: $errno - $errstr<br>\n";
+} else {
+ fwrite($fp,"\n");
+ echo fread($fp, 26);
+ fclose($fp);
+}
+?>
+ </programlisting>
</example>
- Siehe auch: <function>pfsockopen</function>
+ Siehe auch: <function>pfsockopen</function>.
</para>
</refsect1>
</refentry>
@@ -207,7 +229,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>gethostbyaddr</function></funcdef>
@@ -234,7 +256,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>gethostbyname</function></funcdef>
@@ -260,7 +282,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>gethostbynamel</function></funcdef>
@@ -285,11 +307,11 @@
<refname>getmxrr</refname>
<refpurpose>
Ermittelt die (DNS) MX-Datensätze passend zu einem angegebenen
- Internet-Host-Namen.
+ Internet-Host-Namen
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getmxrr</function></funcdef>
@@ -304,8 +326,7 @@
Sucht im DNS nach MX-Datensätzen die zu
<parameter>hostname</parameter> passen. Gibt true/wahr zurück,
wenn irgendwelche Daten gefunden wurden, ansonsten - oder wenn
- ein Fehler auftrat - wird false/falsch zurück
- gegeben.
+ ein Fehler auftrat - wird false / falsch zurück gegeben.
</simpara>
<simpara>
Eine Liste der gefundenen MX-Einträge wird im Array
@@ -331,7 +352,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getprotobyname</function></funcdef>
@@ -358,7 +379,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>getprotobynumber</function></funcdef>
@@ -369,7 +390,7 @@
Die Funktion <function>getprotobynumber</function> gibt den
Protokoll-Namen passend zur angegebenen
Protokoll-<parameter>number</parameter> anhand der Datei
- <filename>/etc/protocols</filename> zurück
+ <filename>/etc/protocols</filename> zurück.
</para>
<para>
Siehe auch: <function>getprotobyname</function>.
@@ -386,7 +407,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getservbyname</function></funcdef>
@@ -399,7 +420,7 @@
Internet-Port zurück, der zu <parameter>service</parameter>
passt. Dies geschieht anhand des angegebenen Wertes für
<parameter>protocol</parameter> mittels der Datei
- <filename>/etc/services</filename>. Der Inhalt von
+ <filename>/etc/services</filename>. Der Inhalt von
<parameter>protocol</parameter> ist entweder
<literal>TCP</literal> oder <literal>UDP</literal>.
</para>
@@ -418,7 +439,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>getservbyport</function></funcdef>
@@ -430,7 +451,7 @@
Die Funktion <function>getservbyport</function> gibt den
Internet-Dienst zurück, der zu <parameter>port</parameter> für
das angegebene <parameter>protocol</parameter> passt (anhand der
- Datei <filename>/etc/services</filename>). Der Inhalt von
+ Datei <filename>/etc/services</filename>). Der Inhalt von
<parameter>protocol</parameter> ist entweder
<literal>TCP</literal> oder <literal>UDP</literal>.
</para>
@@ -448,7 +469,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>openlog</function></funcdef>
@@ -459,14 +480,14 @@
</funcsynopsis>
<para>
Die Funktion <function>openlog</function> kontaktiert die
- System-Log-Dienste eines Programms. Die Zeichenkette
- <parameter>ident</parameter> wird jeder Meldung angefügt. Werte
+ System-Log-Dienste eines Programms. Die Zeichenkette
+ <parameter>ident</parameter> wird jeder Meldung angefügt. Werte
für die Parameter <parameter>option</parameter> und
<parameter>facility</parameter> werden im nächsten Abschnitt
- gegeben. Der Gebrauch von <function>openlog</function> ist
+ gegeben. Der Gebrauch von <function>openlog</function> ist
optional. Er wird - falls erforderlich - automatisch aufgerufen
von <function>syslog</function>. Dann ist der Vorgabewert von
- <parameter>ident</parameter> falsch/false.
+ <parameter>ident</parameter> falsch / false.
</para>
<para>
Siehe auch <function>syslog</function> und
@@ -484,7 +505,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pfsockopen</function></funcdef>
@@ -519,7 +540,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>socket_set_blocking</function></funcdef>
@@ -530,8 +551,8 @@
<para>
Wenn <parameter>mode</parameter> false / falsch ist, wird die
angegebene Socket- Bezeichnung auf Nicht-Block-Modus gesetzt,
- anderenfalls auf Block-Modus. Dies beeinflusst Aufrufe von
- <function>fgets</function>, die über diesen Sockets lesen. Im
+ anderenfalls auf Block-Modus. Dies beeinflusst Aufrufe von
+ <function>fgets</function>, die über diesen Sockets lesen. Im
Nicht-Block-Modus wird ein <function>fgets</function>-Aufruf
sofort zum Script zurückkehren, während er im Block-Modus auf
eingehende Daten (auf diesem Socket) warten wird.
@@ -545,7 +566,7 @@
<refpurpose>Erzeugt eine Meldung im System-Logging</refpurpose>
</refnamediv>
<refsect1>
- <title>Beschreibung</title>
+ <title>Beschreibung:</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>syslog</function></funcdef>
@@ -556,7 +577,7 @@
<para>
Die Funktion <function>syslog</function> erzeugt eine
Status-Meldung, die an die System-Log-Funktion weitergereicht
- wird. Der Parameter <parameter>priority</parameter> ist eine
+ wird. Der Parameter <parameter>priority</parameter> ist eine
Kombination der System-Möglichkeiten und dem Level. Werte hierzu
werden im nächsten Abschnitt genannt. Es verbleibt die zu
sendende Nachricht, in der die beiden Zeichen
@@ -572,6 +593,71 @@
<para>
Unter Windows-NT wird der Syslog-Dienst emuliert, indem der
Ereignis-Protokollierdienst genutzt wird.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ip2long">
+ <refnamediv>
+ <refname>ip2long</refname>
+ <refpurpose>
+ Verwandelt eine gemäß IP-V4-Protokoll angegebene Internet-Adresse
+ vom Punkt-Format in die ausgeschriebene Adress-Angabe
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ip2long</function></funcdef>
+ <paramdef>string <parameter>ip_address</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Die Funktion <function>ip2long</function> erzeugt aus einer im
+ Punkt-Format angegebenen IP-V4-Adresse eine ausgeschriebene
+ Adress-Angabe.
+ <example>
+ <title><function>Ip2long</function>-Beispiel:</title>
+ <programlisting role="php">
+<?
+$ip = gethostbyname("www.php.net");
+$out = "Die folgenden URLs sind gleich:<br>\n";
+$out .= "http://www.php.net/, http://".$ip."/, and http://".ip2long($ip)."/<br>\n";
+echo $out;
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Siehe auch: <function>long2ip</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.long2ip">
+ <refnamediv>
+ <refname>long2ip</refname>
+ <refpurpose>
+ Konvertiert eine IP-V4-Internet-Netzwerk-Adresse in einen String,
+ der das Punkt-Format enthält ("Dotted-Format")
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>long2ip</function></funcdef>
+ <paramdef>int <parameter>proper_address</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Die Funktion <function>long2ip</function> erzeugt eine Internet
+ Adresse im Punkt-Format (also: www.xxx.yyy.zzz) anhand einer
+ richtigen - ausgeschriebenen - Adress-Angabe.
+ </para>
+ <para>
+ Siehe auch: <function>ip2long</function>.
</para>
</refsect1>
</refentry>
- Next message: Kristian Köhntopp: "[PHP-DOC] cvs: phpdoc /en/functions filesystem.xml"
- Previous message: Thomas Schuermann: "[PHP-DOC] cvs: phpdoc /de/functions dir.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]