<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.network">
  <title>Netzwerk Funktionen</title>
  <titleabbrev>Netzwerk</titleabbrev>
  <!-- Anmerkung des bersetzers:
       entspricht en/functions/network.xml Vers. 1.26 -->

  <refentry id="function.checkdnsrr">
   <refnamediv>
    <refname>checkdnsrr</refname>
    <refpurpose>
     Prft DNS-Eintrge auf bereinstimmung mit einem gegebenen
     Internet-Host-Namen oder einer IP Adresse
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>checkdnsrr</methodname>
      <methodparam><type>string</type><parameter>host</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>type</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Durchsucht den DNS (Domain-Name-Service) auf Daten des Typs
     <parameter>type</parameter> auf bereinstimmung mit
     <parameter>host</parameter>. Gibt &true; / wahr zurck, wenn ein
     Datensatz gefunden wurde. Ansonsten - oder wenn ein Fehler
     vorliegt - wird &false; / falsch zurck gegeben.
    </simpara>
    <simpara>
     Der Parameter <parameter>type</parameter> kann sein: A, MX, NS,
     SOA, PTR, CNAME, or ANY. Die Vorgabe ist MX.
    </simpara>
    <simpara>
     Der Parameter <parameter>host</parameter> kann eine durch Punkte
     getrennte IP-Adresse (z.B. 192.168.0.2) oder ein Host-Name
     (z.B. tux.meinsein.de) sein.
    </simpara>
    <simpara>
     Siehe auch <function>getmxrr</function>,
     <function>gethostbyaddr</function>,
     <function>gethostbyname</function>,
     <function>gethostbynamel</function> und das named(8)
     Manual.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.closelog">
   <refnamediv>
    <refname>closelog</refname>
    <refpurpose>Schliet die Verbindung zum System-Logger</refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>closelog</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>closelog</function> schliet den Descriptor, der
     bentigt wird um in den System-Logger zu schreiben. Der Gebrauch
     von <function>closelog</function> ist optional.
    </para>
    <para>
     Siehe auch <function>define_syslog_variables</function>,
     <function>syslog</function> und <function>openlog</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.debugger-off">
   <refnamediv>
    <refname>debugger_off</refname>
    <refpurpose>Schaltet den internen PHP-Debugger aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>debugger_off</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Schaltet den internen PHP-Debugger aus. Der Debugger befindet
     sich noch in der Entwicklung.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.debugger-on">
   <refnamediv>
    <refname>debugger_on</refname>
    <refpurpose>Schaltet den internen PHP-Debugger ein</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>debugger_on</methodname>
      <methodparam><type>string</type><parameter>address</parameter></methodparam>
     </methodsynopsis>
    <para>
     Schaltet den internen PHP-Debugger, zeigend auf
     <parameter>address</parameter>, ein. Der Debugger befindet sich
     noch in der Entwicklung.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.define-syslog-variables">
   <refnamediv>
    <refname>define_syslog_variables</refname>
    <refpurpose>
     Initialisiert alle SysLog bezogenen Konstanten
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>define_syslog_varaibles</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Initialisiert alle Konstanten, die in den SysLog-Funktionen 
     Verwendung finden.
    </para>
    <para>
     Siehe auch <function>openlog</function>,
     <function>syslog</function> und <function>closelog</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fsockopen">
   <refnamediv>
    <refname>fsockopen</refname>
    <refpurpose>
     Stellt eine Internet- oder Unix-Domain-Socket-Verbindung her
    </refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>fsockopen</methodname>
      <methodparam choice="opt"><type>string</type><parameter>udp://hostname</parameter></methodparam>
      <methodparam><type>int</type><parameter>port</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>errno</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>errstr</parameter></methodparam>
      <methodparam choice="opt"><type>double</type><parameter>timeout</parameter></methodparam>
     </methodsynopsis>
    <para>
     ffnet eine Socket-Verbindung zum Internet (AF_INET, unter
     Verwendung von TCP oder UDP) oder unter Unix (AF_UNIX). Fr eine
     Internet-Verbindung wird eine TCP-Socket-Verbindung zu 
     <parameter>hostname</parameter> ber den Port
     <parameter>port</parameter> hergestellt. Fr eine UDP-Verbindung
     mssen 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) fr den
     Verbindungsaufbau (in Sekunden) zu setzen.
    </para>
    <para>
     Die Funktion <function>fsockopen</function> gibt einen Zeiger auf
     eine Datei zurck, der in Verbindung mit anderen Datei-Funktionen
     (wie z.B.  <function>fgets</function>,
     <function>fgetss</function>, <function>fputs</function>,
     <function>fclose</function>, <function>feof</function>) gebraucht
     werden kann.
    </para>
    <para>
     Wenn der Aufruf der Funktion scheitert, gibt er &false; / falsch
     zurck und wenn die optionalen <parameter>errno</parameter> und
     <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
     die Funktion &false;/falsch zurck gibt, ist dies ein Hinweis, dass
     der Fehler vor dem <literal>>connect()</literal>-Aufruf
     geschah. Das ist ein Problem, dass hufig mit der Initialisierung
     des Sockets zusammen hngt. Beachten Sie bitte, dass das
     <parameter>errno</parameter> und
     <parameter>errstr</parameter>-Argument als Referenz zu bergeben
     sind.
    </para>
    <para>
     Abhngig von der vorhandenen Umgebung kann die Verbindung zu
     einer UNIX-Domne oder der optionale Verbindungsaufbau-Zeitfehler
     nicht zur Verfgung stehen.
    </para>
    <para>
     Voreingestellt ist der Verbindungsaufbau im Block-Modus. Sie
     knnen dies auf Nicht-Block-Modus ndern, indem Sie
     <function>socket_set_blocking</function> benutzen.
     <example>
      <title><function>fsockopen</function>-Beispiel:</title>
      <programlisting role="php">
$fp = fsockopen ("www.php.net", 80, &amp;$errno, &amp;$errstr, 30);
if (!$fp) {
    echo "$errstr ($errno)&lt;br&gt;\n";
} else {
    fputs ($fp, "GET / HTTP/1.0\r\n\r\n");
    while (!feof($fp)) {
        echo fgets($fp,128);
    }
    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">
&lt;?php
$fp = fsockopen("udp://127.0.0.1", 13, &amp;$errno; &amp;$errstr);
if (!$fp) {
    echo "Fehler: $errno - $errstr&lt;br&gt;\n";
} else {
    fwrite($fp,"\n");
    echo fread($fp, 26);
    fclose($fp);
}
?&gt;
      </programlisting>
     </example>
     Siehe auch: <function>pfsockopen</function>, 
     <function>socket_set_blocking</function>,
     <function>socket_set_timeout</function>,
     <function>fgets</function>,
     <function>fgetss</function>, <function>fputs</function>,
     <function>fclose</function> und <function>feof</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gethostbyaddr">
   <refnamediv>
    <refname>gethostbyaddr</refname>
    <refpurpose>
     Ermittelt den Internet-Host-Namen (z.B. tux.meinsein.de) passend
     zur angegebenen IP-Adresse (z.B. 192.168.0.2)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>gethostbyaddr</methodname>
      <methodparam><type>string</type><parameter>ip_address</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Internet-Host-Namen passend zu
     <parameter>ip_address</parameter> zurck. Bei einem Fehler wird
     die <parameter>ip_address</parameter> zurck gegeben.
    </para>
    <para>
     Siehe auch: <function>gethostbyname</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gethostbyname">
   <refnamediv>
    <refname>gethostbyname</refname>
    <refpurpose>
     Ermittelt die IP-Adresse (z.B. 192.168.0.2) passend zum
     angegebenen Internet-Host-Namen (z.B. tux.meinsein.de)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>gethostbyname</methodname>
      <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die IP-Adresse passend zu <parameter>hostname</parameter>
     zurck.
    </para>
    <para>
     Siehe auch: <function>gethostbyaddr</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.gethostbynamel">
   <refnamediv>
    <refname>gethostbynamel</refname>
    <refpurpose>
     Ermittelt eine Liste von IP-Adressen passend zum angegebenen
     Internet-Host-Namen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>gethostbynamel</methodname>
      <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt eine Liste von IP-Adressen zurck, zu denen der angegebene 
     Internet-Host <parameter>hostname</parameter> aufgelst wurde.
    </para>
    <para>
     Siehe auch <function>gethostbyname</function>,
     <function>gethostbyaddr</function>,
     <function>checkdnsrr</function>, <function>getmxrr</function>,
     und die <literal>named(8)</literal> Bedienungs-Anleitung.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.getmxrr">
   <refnamediv>
    <refname>getmxrr</refname>
    <refpurpose>
     Ermittelt die (DNS) MX-Datenstze passend zu einem angegebenen
     Internet-Host-Namen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>getmxrr</methodname>
      <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
      <methodparam><type>array</type><parameter>mxhosts</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>weight</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Sucht im DNS nach MX-Datenstzen die zu
     <parameter>hostname</parameter> passen. Gibt &true;/wahr zurck,
     wenn irgendwelche Daten gefunden wurden, ansonsten - oder wenn
     ein Fehler auftrat - wird &false; / falsch zurck gegeben.
    </simpara>
    <simpara>
     Eine Liste der gefundenen MX-Eintrge wird im Array
     <parameter>mxhosts</parameter> zurck gegeben. Wenn das optionale
     <parameter>weight</parameter>-Array vorhanden ist, wird es mit
     den gefundenen Prioritts-Informationen gefllt.
    </simpara>
    <simpara>
     See also <function>checkdnsrr</function>,
     <function>gethostbyname</function>,
     <function>gethostbynamel</function>,
     <function>gethostbyaddr</function>, und die
     <literal>named(8)</literal> Bedienungs-Anleitung.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.getprotobyname">
   <refnamediv>
    <refname>getprotobyname</refname>
    <refpurpose>
     Ermittelt die Protokoll-Nummer anhand des Protokoll-Namens
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>getprotobyname</methodname>
      <methodparam><type>string</type><parameter>name</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>getprotobyname</function> gibt die
     Protokoll-Nummer passend zu dem Protokoll
     <parameter>name</parameter> (z.B. TCP, IP, UDP, RAW) anhand der
     Datei <filename>/etc/protocols</filename> zurck.
    </para>
    <para>
     Siehe auch <function>getprotobynumber</function>.
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.getprotobynumber">
   <refnamediv>
    <refname>getprotobynumber</refname>
    <refpurpose>
     Ermittelt den Protokoll-Namen anhand der Protokoll-Nummer
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>getprotobynumber</methodname>
      <methodparam><type>int</type><parameter>number</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>getprotobynumber</function> gibt den
     Protokoll-Namen passend zur angegebenen
     Protokoll-<parameter>number</parameter> anhand der Datei
     <filename>/etc/protocols</filename> zurck.
    </para>
    <para>
     Siehe auch: <function>getprotobyname</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.getservbyname">
   <refnamediv>
    <refname>getservbyname</refname>
    <refpurpose>
     Ermittelt einen Port-Wert passend zu einem Internet-Dienst und
     Protokoll
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>getservbyname</methodname>
      <methodparam><type>string</type><parameter>service</parameter></methodparam>
      <methodparam><type>string</type><parameter>protocol</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>getservbyname</function> gibt den
     Internet-Port zurck, der zu <parameter>service</parameter>
     passt. Dies geschieht anhand des angegebenen Wertes fr
     <parameter>protocol</parameter> mittels der Datei
     <filename>/etc/services</filename>. Der Inhalt von
     <parameter>protocol</parameter> ist entweder
     <literal>TCP</literal> oder <literal>UDP</literal>.
    </para>
    <para>
     Siehe auch: <function>getservbyport</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.getservbyport">
   <refnamediv>
    <refname>getservbyport</refname>
    <refpurpose>
     Ermittelt einen Internet-Dienst passend zu einem Port und
     Protokoll
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>getservbyport</methodname>
      <methodparam><type>int</type><parameter>port</parameter></methodparam>
      <methodparam><type>string</type><parameter>protocol</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>getservbyport</function> gibt den
     Internet-Dienst zurck, der zu <parameter>port</parameter> fr
     das angegebene <parameter>protocol</parameter> passt (anhand der
     Datei <filename>/etc/services</filename>). Der Inhalt von
     <parameter>protocol</parameter> ist entweder
     <literal>TCP</literal> oder <literal>UDP</literal>.
    </para>
    <para>
     Siehe auch: <function>getservbyname</function>.
    </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>
     <methodsynopsis>
      <type>int</type><methodname>ip2long</methodname>
      <methodparam><type>string</type><parameter>ip_address</parameter></methodparam>
     </methodsynopsis>
    <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">
&lt;?
$ip = gethostbyname("www.php.net");
$out = "Die folgenden URLs sind gleich:&lt;br&gt;\n";
$out .= "http://www.php.net/, http://".$ip."/, and http://".ip2long($ip)."/&lt;br&gt;\n";
echo $out;
?&gt;
      </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 enthlt ("Dotted-Format")
    </refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>long2ip</methodname>
      <methodparam><type>int</type><parameter>proper_address</parameter></methodparam>
     </methodsynopsis>
    <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>

  <refentry id="function.openlog">
   <refnamediv>
    <refname>openlog</refname>
    <refpurpose>
     Stellt eine Verbindung zu einem Log-Dienst des Systems her
    </refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>openlog</methodname>
      <methodparam><type>string</type><parameter>ident</parameter></methodparam>
      <methodparam><type>int</type><parameter>option</parameter></methodparam>
      <methodparam><type>int</type><parameter>facility</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>openlog</function> kontaktiert die
     System-Log-Dienste eines Programms. Die Zeichenkette
     <parameter>ident</parameter> wird jeder Meldung angefgt. Werte
     fr die Parameter <parameter>option</parameter> und
     <parameter>facility</parameter> werden unten erlutert. Das
     Argument <parameter>option</parameter> wird verwendet, um
     festzulegen, welche Log-Optionen bei der Erzeugung von 
     Log-Nachrichten verwendet werden sollen. Das Argument 
     <parameter>facility</parameter> wird verwendet, um die Art des
     Programmes festzulegen, das die Nachricht loggt. Dies erlaubt
     ihnen (in ihrer speziellen SysLog-Konfiguartion) die Festlegung
     der Behandlungsweise von Log-Nachrichten. 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;.
    </para>
    <para>
     <table>
      <title><function>openlog</function> Options</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Konstante</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>LOG_CONS</entry>
         <entry>
          Tritt ein Fehler auf beim Senden von Daten an den
          System-Logging-Service, wird direkt an die System-Konsole
          ausgegeben.
         </entry>
        </row>
        <row>
         <entry>LOG_NDELAY</entry>
         <entry>
          ffnet sofort die Verbindung zum Log-Service.
         </entry>
        </row>
        <row>
         <entry>LOG_ODELAY</entry>
         <entry>
          (Voreinstellung); ffne die Verbindung erst, wenn die erste
          Meldung geloggt werden soll.
         </entry>
        </row>
        <row>
         <entry>LOG_PERROR</entry>
         <entry>
          Gib die Log-Meldungen auch an der Standard-Ausgabe fr Fehler
          aus.
         </entry>
        </row>
        <row>
         <entry>LOG_PID</entry>
         <entry>Schliee die PID bei jeder Meldung ein.</entry>
        </row>
       </tbody>
      </tgroup>
     </table>
     Sie knnen eine oder mehrere dieser Optionen verwenden. Benutzen
     Sie mehrere, mssen diese per <literal>OR</literal> getrennt
     werden. Um die Verbindung sofort herzu stellen, auch auf die 
     Konsole zu schreiben und die PID in jede Meldung auf zu nehmen,
     mssen Sie folgendes angeben: <literal>LOG_CONS | LOG_NDELAY | 
     LOG_PID</literal>.
    </para>
    <para>
     <table>
      <title><function>openlog</function>-Mglichkeiten</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Konstante</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>LOG_AUTH</entry>
         <entry>
          Security- / Authorization-Meldungen (benutzt statt dessen
          LOG_AUTHPRIV in Systemen, wo diese Konstante definiert ist).
         </entry>
        </row>
        <row>
         <entry>LOG_AUTHPRIV</entry>
         <entry>
          Security- / Authorization-Meldungen (private).
         </entry>
        </row>
        <row>
         <entry>LOG_CRON</entry>
         <entry>
          Uhr-abhngige Dienste (Dmonen wie cron and at).
         </entry>
        </row>
        <row>
         <entry>LOG_DAEMON</entry>
         <entry>Andere System-Dienste (Dmonen).</entry>
        </row>
        <row>
         <entry>LOG_KERN</entry>
         <entry>Kernel-Meldungen.</entry>
        </row>
        <row>
         <entry>LOG_LOCAL0 ... LOG_LOCAL7</entry>
         <entry>Reserviert fr lokale Benutzung.</entry>
        </row>
        <row>
         <entry>LOG_LPR</entry>
         <entry>Zeilen-Drucker Subsystem.</entry>
        </row>
        <row>
         <entry>LOG_MAIL</entry>
         <entry>Mailing-Subsystem.</entry>
        </row>
        <row>
         <entry>LOG_NEWS</entry>
         <entry>USENET-News-Subsystem.</entry>
        </row>
        <row>
         <entry>LOG_SYSLOG</entry>
         <entry>
          Meldungen die intern von syslogd erzeugt wurden.
         </entry>
        </row>
        <row>
         <entry>LOG_USER</entry>
         <entry>Generische User-Level-Meldungen.</entry>
        </row>
        <row>
         <entry>LOG_UUCP</entry>
         <entry>UUCP-Subsystem</entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     Siehe auch <function>define_syslog_variables</function>,
     <function>syslog</function> und <function>closelog</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pfsockopen">
   <refnamediv>
    <refname>pfsockopen</refname>
    <refpurpose>
     Stellt eine dauernde/permanente Internet oder Unix-Domain-Socket
     Verbindung her
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>pfsockopen</methodname>
      <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
      <methodparam><type>int</type><parameter>port</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>errno</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>errstr</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion beinhaltet das gleiche wie
     <function>fsockopen</function> mit dem Unterschied, dass die
     Verbindung nicht beendet wird, sobald das Script beendet wird.
     Sie ist die permanente-Version von
     <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.socket-get-status">
   <refnamediv>
    <refname>socket_get_status</refname>
    <refpurpose>
     Gibt Informationen ber eine vorhandene Socket-Ressource zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>socket_get_status</methodname>
      <methodparam><type>resource</type><parameter>socket_get_status</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt Informationen ber eine vorhandene Socket-Ressource zurck.
     Z. Zt. werden vier Eintrge in dem resultierenden Array
     vorgenommen:
    </para>
    <itemizedlist>
     <listitem>
      <para>
       <parameter>timed_out</parameter> (bool) - Der Timeout-Wert des
       Sockets fr das Warten auf Daten
      </para>
     </listitem>
     <listitem>
      <para>
       <parameter>blocked</parameter> (bool) - Der Socket wurde
       blockiert
      </para>
     </listitem>
     <listitem>
      <para>
       <parameter>eof</parameter> (bool) - Das EOF (End Of File)
       ist erreicht
      </para>
     </listitem>
     <listitem>
      <para>
       <parameter>unread_bytes</parameter> (int) - Anzahl der Bytes,
       die noch im Socket-Puffer sind
      </para>
     </listitem>
    </itemizedlist>
    <para>
     Siehe auch: 
     <function>accept_connect</function>, <function>bind</function>,
     <function>connect</function>, <function>listen</function> und
     <function>strerror</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.socket-set-blocking">
   <refnamediv>
    <refname>socket_set_blocking</refname>
    <refpurpose>
     Schaltet den Block-Modus eines Sockets an oder aus
    </refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>socket_set_blocking</methodname>
      <methodparam><type>int</type><parameter>socket descriptor</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <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
     Nicht-Block-Modus wird ein <function>fgets</function>-Aufruf
     sofort zum Script zurckkehren, whrend er im Block-Modus auf
     eingehende Daten (auf diesem Socket) warten wird.
    </para>
    <note>
     <title>Hinweis:</title> 
     <para>
     Diese Funktion hie&szlig; fr&uuml;her 
     <function>set_socket_blocking</function>,
     dieser Name sollte jedoch nicht l&auml;nger verwendet werden.
    </para></note>
   </refsect1>
  </refentry>

  <refentry id="function.socket-set-timeout">
   <refnamediv>
    <refname>socket_set_timeout</refname>
    <refpurpose>Setzt den Timeout-Wert eines Socket</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>bool</type><methodname>socket_set_timeout</methodname>
      <methodparam><type>int</type><parameter>socket descriptor</parameter></methodparam>
      <methodparam><type>int</type><parameter>seconds</parameter></methodparam>
      <methodparam><type>int</type><parameter>microseconds</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt den Timeout-Wert von
     <parameter>socket descriptor</parameter>, ausgedrckt durch die
     Summe von <parameter>seconds</parameter> und
     <parameter>microseconds</parameter>.
     <example>
      <title><function>socket_set_timeout</function>-Beispiel:</title>
      <programlisting role="php">
&lt;?php
$fp = fsockopen("www.php.net", 80);
if(!$fp) {
    echo "Keine Verbindung mglich\n";
} else {
    fputs($fp,"GET / HTTP/1.0\n\n");
    $start = time();
    socket_set_timeout($fp, 2);
    $res = fread($fp, 2000);
    var_dump(socket_get_status($fp));
    fclose($fp);
    print $res;
}
?&gt;
      </programlisting>
     </example>
    </para>
    <note>
     <title>Hinweis:</title> 
     <para>
     Diese Funktion hie&szlig; fr&uuml;her 
     <function>set_socket_timeout</function>,
     dieser Name sollte jedoch nicht l&auml;nger verwendet werden.
    </para></note>
    <para>
     Siehe auch: <function>fsockopen</function> und
     <function>fopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.syslog">
   <refnamediv>
    <refname>syslog</refname>
    <refpurpose>Erzeugt eine Meldung im System-Logging</refpurpose> 
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>syslog</methodname>
      <methodparam><type>int</type><parameter>priority</parameter></methodparam>
      <methodparam><type>string</type><parameter>message</parameter></methodparam>
     </methodsynopsis>
    <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
     Kombination der System-Mglichkeiten und dem Level. Werte hierzu
     werden im nchsten Abschnitt genannt.  Es verbleibt die zu
     sendende Nachricht, in der die beiden Zeichen
     <literal>%m</literal> durch den Fehlertext (strerror) ersetzt
     werden, der dem Wert <errortype>errno</errortype>
     entspricht.
    </para>
    <para>
     <table>
      <title>
       <function>syslog</function>-Prioritten (in absteigender
       Reihenfolge)
      </title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Konstante</entry>
         <entry>Beschreibung:</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>LOG_EMERG</entry>
         <entry>System ist unbrauchbar.</entry>
        </row>
        <row>
         <entry>LOG_ALERT</entry>
         <entry>Aktion ist sofort erforderlich.</entry>
        </row>
        <row>
         <entry>LOG_CRIT</entry>
         <entry>Kritischer Zustand.</entry>
        </row>
        <row>
         <entry>LOG_ERR</entry>
         <entry>Fehler aufgetreten.</entry>
        </row>
        <row>
         <entry>LOG_WARNING</entry>
         <entry>Warnung aufgetreten.</entry>
        </row>
        <row>
         <entry>LOG_NOTICE</entry>
         <entry>Normale, aber wichtige, Meldung.</entry>
        </row>
        <row>
         <entry>LOG_INFO</entry>
         <entry>Informative Meldung.</entry>
        </row>
        <row>
         <entry>LOG_DEBUG</entry>
         <entry>Debug-Level-Meldung.</entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
    <para>
     <example>
      <title>Die Verwendung von <function>syslog</function>:</title>
      <programlisting role="php">
&lt;?php
define_syslog_variables();
// ffne SysLog, schliee die Prozess-ID (PID) ein, sende
// die Log-Meldungen an die Standard-Fehler-Ausgabe und benutze
// einen User-definierten Log-Mechanismus.
openlog(&quot;myScripLog&quot;, LOG_PID | LOG_PERROR, LOG_LOCAL0);

// etwas Code

if (authorized_client()) {
    // mache etwas
} else {
    // unerlaubter Client!
    // logge den Zugriff
    $access = date(&quot;Y/m/d H:i:s&quot;);
    syslog(LOG_WARNING,&quot;Unauthorisierter Client: $access $REMOTE_ADDR ($HTTP_USER_AGENT)&quot;);
}

closelog();
?&gt;
      </programlisting>
     </example>
     Weiter Informationen zum Benutzer-definierten Log-Handler finden
     Sie unter <citerefentry><refentrytitle>syslog.conf</refentrytitle>
     <manvolnum>5</manvolnum></citerefentry> der Unix-Manual-Seiten.
     Zustzliche Informationen zu den SysLog-Mglichkeiten finden Sie
     in den Man-Pages zu
     <citerefentry><refentrytitle>syslog</refentrytitle>
     <manvolnum>3</manvolnum></citerefentry> (auf UNIX-Systemen).
    </para>
    <para>
     Unter Windows-NT wird der Syslog-Dienst emuliert, indem der
     Ereignis-Protokollierdienst genutzt wird.
    </para>
    <para>
     Siehe auch <function>define_syslog_variables</function>,
     <function>openlog</function> und <function>closelog</function>.
    </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:
-->