cvs: phpdoc-de /reference/sockets/functions socket-accept.xml socket-bind.xml socket-clear-error.xml socket-close.xml socket-connect.xml
| From: | Cornelia Boenigk | Date: | Thu, 27 Dec 2007 02:12:40 +0000 |
| Subject: | cvs: phpdoc-de /reference/sockets/functions socket-accept.xml socket-bind.xml socket-clear-error.xml socket-close.xml socket-connect.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2339@lists.php.net to get a copy of this message | ||
conni Thu Dec 27 02:12:40 2007 UTC
Modified files:
/phpdoc-de/reference/sockets/functions socket-accept.xml
socket-bind.xml
socket-clear-error.xml
socket-close.xml
socket-connect.xml
Log:
sync to en
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-accept.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-accept.xml diff -u phpdoc-de/reference/sockets/functions/socket-accept.xml:1.3 phpdoc-de/reference/sockets/functions/socket-accept.xml:1.4 --- phpdoc-de/reference/sockets/functions/socket-accept.xml:1.3 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-accept.xml Thu Dec 27 02:12:40 2007 @@ -1,61 +1,85 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.4 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-accept" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_accept</refname> - <refpurpose>Akzeptiert eine Verbindung an einem Socket</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>resource</type><methodname>socket_accept</methodname> - <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para> - Nachdem der Socket <parameter>socket</parameter> mit - <function>socket_create</function> erzeugt wurde, mit - <function>socket_bind</function> mit einem Namen verknuepft wurde - und mit <function>socket_listen</function> angewiesen wurde, nach - hereinkommenden Verbindungsanforderungen zu horchen, wird der - Socket mit dieser Funktion angewiesen, diese - Verbindungsanforderungen zuzulassen. Wenn ein Verbindungsaufbau - erfolgreich war, wird ein neuer Socket-Deskriptor zurückgegeben, - welcher zur Kommunikation benutzt werden kann. Wenn es mehrere - Verbindungsanforderungen an diesem Socket gibt, werden diese in - eine Warteschlange gestellt und die erste Verbindungsanforderung - wird bedient. Falls es keine wartenden Verbindungsanforderungen - gibt, blockiert die Funktion <function>socket_accept</function> - so lange, bis eine Verbindungsanforderung kommt. Falls - <parameter>socket</parameter> mit der Funktion - <function>socket_set_blocking</function> oder mit - <function>socket_set_nonblock</function> auf 'nicht blockieren' - gesetzt wurde, wird &false; zurückgegeben. - </para> - <para> - Der Socket-Deskriptor, der von <function>socket_accept</function> - zurückgegeben wird, soll nicht dazu benutzt werden, um neue - Verbindungsanforderungen zuzulassen. Der ursprüngliche wartende - Socket <parameter>socket</parameter> bleibt geöffnet und kann - wiederbenutzt werden. - </para> - <para> - Gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder &false;, +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-accept"> + <refnamediv> + <refname>socket_accept</refname> + <refpurpose>Akzeptiert eine Verbindung an einem Socket</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>socket_accept</methodname> + <methodparam><type>resource</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para> + Nachdem der Socket <parameter>socket</parameter> mit + <function>socket_create</function> erzeugt, mit + <function>socket_bind</function> mit einem Namen verknüpft und mit + <function>socket_listen</function> angewiesen wurde, nach + hereinkommenden Verbindungsanforderungen zu horchen, werden sie mit dieser + Funktion an dem Socket zugelassen. Nach einem erfogreichen Verbindungsaufbau + wird ein neuer Socket-Deskriptor zurückgegeben, welcher zur Kommunikation + benutzt werden kann. Gibt es mehrere Verbindungen an diesem Socket, werden + diese in eine Warteschlange gestellt und die erste Verbindung wird benutzt. + Falls es keine wartenden Verbindungen gibt, blockiert die Funktion + <function>socket_accept</function> so lange, bis eine Verbindung angefordert + wird. Falls der Socket <parameter>socket</parameter> mit den Funktionen + <function>socket_set_blocking</function> oder <function>socket_set_nonblock</function> + auf 'nicht blockieren' gesetzt wurde, wird &false; zurückgegeben. + </para> + <para> + Der Socket-Deskriptor, der von <function>socket_accept</function> + zurückgegeben wird, sollte nicht dazu benutzt werden, neue + Verbindungen zuzulassen. Der ursprüngliche wartende Socket + <parameter>socket</parameter> bleibt dagegen geöffnet und kann + wiederverwendet werden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + Ein gültiger Socket-Deskriptor, der von der Funktion + <function>socket_create</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder &false;, falls ein Fehler auftritt. Der aktuelle Fehlercode kann mit der Funktion <function>socket_last_error</function> ermittelt werden. - Dieser Fehlercode kann an die Funktion <function>strerror</function> + Dieser Fehlercode kann an die Funktion <function>socket_strerror</function> übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten. - </para> - <para> - Siehe auch: - <function>socket_bind</function>, - <function>socket_connect</function>, - <function>socket_listen</function>, - <function>socket_create</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_connect</function></member> + <member><function>socket_listen</function></member> + <member><function>socket_create</function></member> + <member><function>socket_bind</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-bind.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-bind.xml diff -u phpdoc-de/reference/sockets/functions/socket-bind.xml:1.4 phpdoc-de/reference/sockets/functions/socket-bind.xml:1.5 --- phpdoc-de/reference/sockets/functions/socket-bind.xml:1.4 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-bind.xml Thu Dec 27 02:12:40 2007 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.10 Maintainer: conni Status: ready --> -<refentry xml:id="function.socket-bind" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.13 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-bind"> <refnamediv> <refname>socket_bind</refname> - <refpurpose>Verknüpft einen Namen mit einem Socket</refpurpose> + <refpurpose>Verknüpft einen Socket mit einem Namen</refpurpose> </refnamediv> <refsect1 role="description"> @@ -17,10 +17,10 @@ </methodsynopsis> <para> <function>socket_bind</function> verknüpft den Namen, der in - <parameter>address</parameter> angegeben ist mit dem Socket, der - durch <parameter>socket</parameter> bestimmt ist. Dies muss ein - gültiger Socket-Deskriptor sein, der mit der Funktion - <function>socket_create</function> erzeugt wurde. + <parameter>address</parameter> angegeben ist mit dem Socket + <parameter>socket</parameter>. Dies muss ein gültiger Socket-Deskriptor + sein, der entweder mit <function>socket_create</function> oder mit + <function>socket_listen</function> erzeugt wurde. </para> </refsect1> @@ -32,8 +32,7 @@ <term><parameter>socket</parameter></term> <listitem> <para> - Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> - erzeugt wurde. + Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> erzeugt wurde. </para> </listitem> </varlistentry> @@ -48,7 +47,7 @@ <para> Falls der Socket zur <constant>AF_UNIX</constant>-Familie gehört, ist der Parameter <parameter>address</parameter> der Pfad eines - Unix-domain Sockets (z.B. <filename>/tmp/my.sock</filename>). + Unix-Domain Sockets (z.B. <filename>/tmp/my.sock</filename>). </para> </listitem> </varlistentry> @@ -82,11 +81,11 @@ &reftitle.examples; <para> <example> - <title><function>socket_bind</function> benutzen, um die Quell-Adresse zu setzen:</title> + <title>Beispiel: Quell-Adresse setzen mit <function>socket_bind</function>:</title> <programlisting role="php"> <![CDATA[ <?php -// Einen neuen socket erzeugen +// Einen neuen Socket erzeugen $sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); // Eine (Beispiel-) Liste von IP-Adressen dieses Computers http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-clear-error.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-clear-error.xml diff -u phpdoc-de/reference/sockets/functions/socket-clear-error.xml:1.4 phpdoc-de/reference/sockets/functions/socket-clear-error.xml:1.5 --- phpdoc-de/reference/sockets/functions/socket-clear-error.xml:1.4 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-clear-error.xml Thu Dec 27 02:12:40 2007 @@ -1,36 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-clear-error" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_clear_error</refname> - <refpurpose>Löscht entweder einen Fehler oder den letzten Fehlercode +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.10 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-clear-error"> + <refnamediv> + <refname>socket_clear_error</refname> + <refpurpose>Löscht entweder einen Fehler oder den letzten Fehlercode eines Sockets</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>socket_clear_error</methodname> - <methodparam choice="opt"><type>resource</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion löscht entweder einen Fehlercode für einen gegebenen - Socket oder global den letzten Socket-Fehler. - </para> - <para> - Mit dieser Funktion kann der Wert eines Fehlercodes explizit - zurückgesetzt werden, entweder für einen bestimmten Socket oder - global den Fehlercode des letzten Fehlers innerhalb dieser - Extension. Dies kann ganz nützlich sein, wenn man prüfen möchte, ob - in einem Teil einer Anwendung ein Fehler aufgetreten ist. - </para> - <para> - Siehe auch - <function>socket_last_error</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>socket_clear_error</methodname> + <methodparam choice="opt"><type>resource</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion löscht entweder einen Fehlercode für einen gegebenen Socket + oder global den letzten Socket-Fehler, wenn kein Socket angegeben wurde. + </para> + <para> + Mit dieser Funktion kann der Wert eines Fehlercodes explizit zurückgesetzt + werden, entweder ein Fehlercode für einen bestimmten Socket oder global der + Code des letzten Fehlers innerhalb dieser Extension. Dies kann ganz nützlich + sein, wenn man prüfen möchte, ob in einem Teil einer Anwendung ein Fehler + aufgetreten ist. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> + erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_last_error</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-close.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-close.xml diff -u phpdoc-de/reference/sockets/functions/socket-close.xml:1.4 phpdoc-de/reference/sockets/functions/socket-close.xml:1.5 --- phpdoc-de/reference/sockets/functions/socket-close.xml:1.4 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-close.xml Thu Dec 27 02:12:40 2007 @@ -1,38 +1,63 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_close</refname> - <refpurpose>Schliesst eine Socket-Verbindung</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>socket_close</methodname> - <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para> - <function>socket_close</function> schliesst die Socketverbindung, - die durch <parameter>socket</parameter> gegeben ist. - </para> - <note> - <para> - <function>socket_close</function> kann nicht für PHP - Dateideskriptoren benutzt werden, die mit <function>fopen</function>, - <function>popen</function>, <function>fsockopen</function> oder - <function>pfsockopen</function> erzeugt wurden; sie gilt nur für - Sockets, die mit <function>socket_create</function> oder - <function>socket_accept</function> erzeugt wurden. - </para> - </note> - <para> - Siehe auch <function>socket_bind</function>, <function>socket_listen</function>, - <function>socket_create</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-close"> + <refnamediv> + <refname>socket_close</refname> + <refpurpose>Schliesst eine Socket-Verbindung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>socket_close</methodname> + <methodparam><type>resource</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para> + <function>socket_close</function> schliesst die Socketverbindung, + die durch <parameter>socket</parameter> gegeben ist. Diese Funktion gilt + ausschließlich für Sockets und kann für keine anderen Arten von Ressourcen + verwendet werden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> + oder <function>socket_accept</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_bind</function></member> + <member><function>socket_listen</function></member> + <member><function>socket_create</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-connect.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-connect.xml diff -u phpdoc-de/reference/sockets/functions/socket-connect.xml:1.3 phpdoc-de/reference/sockets/functions/socket-connect.xml:1.4 --- phpdoc-de/reference/sockets/functions/socket-connect.xml:1.3 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-connect.xml Thu Dec 27 02:12:40 2007 @@ -1,55 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-connect" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_connect</refname> - <refpurpose>Baut eine Verbindung über einen Socket auf</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>socket_connect</methodname> - <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - <methodparam><type>string</type><parameter>address</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam> - </methodsynopsis> - <para> - Baut mit Hilfe eines gültigen Socket-Deskriptors - <parameter>socket</parameter>, der von der Funktion - <function>socket_create</function> zurückgegeben wurde, - eine Verbindung auf. - </para> - <para> - Der Parameter <parameter>address</parameter> ist entweder - eine IP-Adresse in Punktnotation (z.B. <literal>127.0.0.1</literal>), - falls der Socket zur <constant>AF_INET</constant> -Familie gehört, - oder der Pfadname eines Unix-domain socket, falls der Socket zur - <constant>AF_UNIX</constant> -Familie gehört. - </para> - <para> - Der Parameter <parameter>port</parameter> wird nur benutzt, wenn - eine Verbindung zu einem <constant>AF_INET</constant> -Socket - aufgebaut wird und gibt an, zu welchem Port des entfernten Hosts - eine Verbindung hergestellt werden soll. - </para> - <para> - &return.success; Der Fehlercode kann mit der Funktion - <function>socket_last_error</function> abgefragt werden. Dieser - Fehlercode kann an die Funktion <function>socket_strerror</function> - übergeben werden, um eine textuelle Beschreibung des Fehlers zu - erhalten. - </para> - <para> - See also - <function>socket_bind</function>, - <function>socket_listen</function>, - <function>socket_create</function>, - <function>socket_last_error</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-connect"> + <refnamediv> + <refname>socket_connect</refname> + <refpurpose>Baut eine Verbindung über einen Socket auf</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>socket_connect</methodname> + <methodparam><type>resource</type><parameter>socket</parameter></methodparam> + <methodparam><type>string</type><parameter>address</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam> + </methodsynopsis> + <para> + Baut über den gültigen Socket-Deskriptor <parameter>socket</parameter>, + der von <function>socket_create</function> zurückgegeben wurde, eine + Verbindung zu <parameter>address</parameter> auf. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>address</parameter></term> + <listitem> + <para> + Der Parameter <parameter>address</parameter> ist entweder + eine IPv4-Adresse in Punktnotation (z.B. <literal>127.0.0.1</literal>), + falls <parameter>socket</parameter> zur <constant>AF_INET</constant>-Familie gehört, + oder eine gültige IPv6-Adresse (z.B <literal>::1</literal>), falls die + IPv6-Unterstützung aktiviert ist und <parameter>socket</parameter> zur + <constant>AF_INET6</constant>-Familie gehört, oder der Pfadname eines + Unix-Domain socket, falls der Socket zur <constant>AF_UNIX</constant>-Familie gehört. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>port</parameter></term> + <listitem> + <para> + Der Parameter <parameter>port</parameter> wird nur benutzt und ist dann + zwingend erforderlich, wenn eine Verbindung zu einem + <constant>AF_INET</constant>- oder einem <constant>AF_INET6</constant>-Socket + aufgebaut wird. Er gibt an, zu welchem Port des entfernten Hosts eine + Verbindung hergestellt werden soll. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; Der Fehlercode kann mit der Funktion <function>socket_last_error</function> + ermittelt werden. Dieser Fehlercode kann an die Funktion <function>socket_strerror</function> + übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten. + </para> + <note> + <para> + Falls der Socket nicht blockiert ist, gibt diese Funktion &false; sowie die + Fehlermeldung <literal>Operation now in progress</literal> zurück. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_bind</function></member> + <member><function>socket_listen</function></member> + <member><function>socket_create</function></member> + <member><function>socket_last_error</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-accept.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-accept.xml diff -u phpdoc-de/reference/sockets/functions/socket-accept.xml:1.3 phpdoc-de/reference/sockets/functions/socket-accept.xml:1.4 --- phpdoc-de/reference/sockets/functions/socket-accept.xml:1.3 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-accept.xml Thu Dec 27 02:12:40 2007 @@ -1,61 +1,85 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.4 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-accept" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_accept</refname> - <refpurpose>Akzeptiert eine Verbindung an einem Socket</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>resource</type><methodname>socket_accept</methodname> - <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para> - Nachdem der Socket <parameter>socket</parameter> mit - <function>socket_create</function> erzeugt wurde, mit - <function>socket_bind</function> mit einem Namen verknuepft wurde - und mit <function>socket_listen</function> angewiesen wurde, nach - hereinkommenden Verbindungsanforderungen zu horchen, wird der - Socket mit dieser Funktion angewiesen, diese - Verbindungsanforderungen zuzulassen. Wenn ein Verbindungsaufbau - erfolgreich war, wird ein neuer Socket-Deskriptor zurückgegeben, - welcher zur Kommunikation benutzt werden kann. Wenn es mehrere - Verbindungsanforderungen an diesem Socket gibt, werden diese in - eine Warteschlange gestellt und die erste Verbindungsanforderung - wird bedient. Falls es keine wartenden Verbindungsanforderungen - gibt, blockiert die Funktion <function>socket_accept</function> - so lange, bis eine Verbindungsanforderung kommt. Falls - <parameter>socket</parameter> mit der Funktion - <function>socket_set_blocking</function> oder mit - <function>socket_set_nonblock</function> auf 'nicht blockieren' - gesetzt wurde, wird &false; zurückgegeben. - </para> - <para> - Der Socket-Deskriptor, der von <function>socket_accept</function> - zurückgegeben wird, soll nicht dazu benutzt werden, um neue - Verbindungsanforderungen zuzulassen. Der ursprüngliche wartende - Socket <parameter>socket</parameter> bleibt geöffnet und kann - wiederbenutzt werden. - </para> - <para> - Gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder &false;, +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-accept"> + <refnamediv> + <refname>socket_accept</refname> + <refpurpose>Akzeptiert eine Verbindung an einem Socket</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>socket_accept</methodname> + <methodparam><type>resource</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para> + Nachdem der Socket <parameter>socket</parameter> mit + <function>socket_create</function> erzeugt, mit + <function>socket_bind</function> mit einem Namen verknüpft und mit + <function>socket_listen</function> angewiesen wurde, nach + hereinkommenden Verbindungsanforderungen zu horchen, werden sie mit dieser + Funktion an dem Socket zugelassen. Nach einem erfogreichen Verbindungsaufbau + wird ein neuer Socket-Deskriptor zurückgegeben, welcher zur Kommunikation + benutzt werden kann. Gibt es mehrere Verbindungen an diesem Socket, werden + diese in eine Warteschlange gestellt und die erste Verbindung wird benutzt. + Falls es keine wartenden Verbindungen gibt, blockiert die Funktion + <function>socket_accept</function> so lange, bis eine Verbindung angefordert + wird. Falls der Socket <parameter>socket</parameter> mit den Funktionen + <function>socket_set_blocking</function> oder <function>socket_set_nonblock</function> + auf 'nicht blockieren' gesetzt wurde, wird &false; zurückgegeben. + </para> + <para> + Der Socket-Deskriptor, der von <function>socket_accept</function> + zurückgegeben wird, sollte nicht dazu benutzt werden, neue + Verbindungen zuzulassen. Der ursprüngliche wartende Socket + <parameter>socket</parameter> bleibt dagegen geöffnet und kann + wiederverwendet werden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + Ein gültiger Socket-Deskriptor, der von der Funktion + <function>socket_create</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder &false;, falls ein Fehler auftritt. Der aktuelle Fehlercode kann mit der Funktion <function>socket_last_error</function> ermittelt werden. - Dieser Fehlercode kann an die Funktion <function>strerror</function> + Dieser Fehlercode kann an die Funktion <function>socket_strerror</function> übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten. - </para> - <para> - Siehe auch: - <function>socket_bind</function>, - <function>socket_connect</function>, - <function>socket_listen</function>, - <function>socket_create</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_connect</function></member> + <member><function>socket_listen</function></member> + <member><function>socket_create</function></member> + <member><function>socket_bind</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-bind.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-bind.xml diff -u phpdoc-de/reference/sockets/functions/socket-bind.xml:1.4 phpdoc-de/reference/sockets/functions/socket-bind.xml:1.5 --- phpdoc-de/reference/sockets/functions/socket-bind.xml:1.4 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-bind.xml Thu Dec 27 02:12:40 2007 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.10 Maintainer: conni Status: ready --> -<refentry xml:id="function.socket-bind" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.13 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-bind"> <refnamediv> <refname>socket_bind</refname> - <refpurpose>Verknüpft einen Namen mit einem Socket</refpurpose> + <refpurpose>Verknüpft einen Socket mit einem Namen</refpurpose> </refnamediv> <refsect1 role="description"> @@ -17,10 +17,10 @@ </methodsynopsis> <para> <function>socket_bind</function> verknüpft den Namen, der in - <parameter>address</parameter> angegeben ist mit dem Socket, der - durch <parameter>socket</parameter> bestimmt ist. Dies muss ein - gültiger Socket-Deskriptor sein, der mit der Funktion - <function>socket_create</function> erzeugt wurde. + <parameter>address</parameter> angegeben ist mit dem Socket + <parameter>socket</parameter>. Dies muss ein gültiger Socket-Deskriptor + sein, der entweder mit <function>socket_create</function> oder mit + <function>socket_listen</function> erzeugt wurde. </para> </refsect1> @@ -32,8 +32,7 @@ <term><parameter>socket</parameter></term> <listitem> <para> - Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> - erzeugt wurde. + Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> erzeugt wurde. </para> </listitem> </varlistentry> @@ -48,7 +47,7 @@ <para> Falls der Socket zur <constant>AF_UNIX</constant>-Familie gehört, ist der Parameter <parameter>address</parameter> der Pfad eines - Unix-domain Sockets (z.B. <filename>/tmp/my.sock</filename>). + Unix-Domain Sockets (z.B. <filename>/tmp/my.sock</filename>). </para> </listitem> </varlistentry> @@ -82,11 +81,11 @@ &reftitle.examples; <para> <example> - <title><function>socket_bind</function> benutzen, um die Quell-Adresse zu setzen:</title> + <title>Beispiel: Quell-Adresse setzen mit <function>socket_bind</function>:</title> <programlisting role="php"> <![CDATA[ <?php -// Einen neuen socket erzeugen +// Einen neuen Socket erzeugen $sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); // Eine (Beispiel-) Liste von IP-Adressen dieses Computers http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-clear-error.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-clear-error.xml diff -u phpdoc-de/reference/sockets/functions/socket-clear-error.xml:1.4 phpdoc-de/reference/sockets/functions/socket-clear-error.xml:1.5 --- phpdoc-de/reference/sockets/functions/socket-clear-error.xml:1.4 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-clear-error.xml Thu Dec 27 02:12:40 2007 @@ -1,36 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-clear-error" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_clear_error</refname> - <refpurpose>Löscht entweder einen Fehler oder den letzten Fehlercode +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.10 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-clear-error"> + <refnamediv> + <refname>socket_clear_error</refname> + <refpurpose>Löscht entweder einen Fehler oder den letzten Fehlercode eines Sockets</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>socket_clear_error</methodname> - <methodparam choice="opt"><type>resource</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion löscht entweder einen Fehlercode für einen gegebenen - Socket oder global den letzten Socket-Fehler. - </para> - <para> - Mit dieser Funktion kann der Wert eines Fehlercodes explizit - zurückgesetzt werden, entweder für einen bestimmten Socket oder - global den Fehlercode des letzten Fehlers innerhalb dieser - Extension. Dies kann ganz nützlich sein, wenn man prüfen möchte, ob - in einem Teil einer Anwendung ein Fehler aufgetreten ist. - </para> - <para> - Siehe auch - <function>socket_last_error</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>socket_clear_error</methodname> + <methodparam choice="opt"><type>resource</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion löscht entweder einen Fehlercode für einen gegebenen Socket + oder global den letzten Socket-Fehler, wenn kein Socket angegeben wurde. + </para> + <para> + Mit dieser Funktion kann der Wert eines Fehlercodes explizit zurückgesetzt + werden, entweder ein Fehlercode für einen bestimmten Socket oder global der + Code des letzten Fehlers innerhalb dieser Extension. Dies kann ganz nützlich + sein, wenn man prüfen möchte, ob in einem Teil einer Anwendung ein Fehler + aufgetreten ist. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> + erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_last_error</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-close.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-close.xml diff -u phpdoc-de/reference/sockets/functions/socket-close.xml:1.4 phpdoc-de/reference/sockets/functions/socket-close.xml:1.5 --- phpdoc-de/reference/sockets/functions/socket-close.xml:1.4 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-close.xml Thu Dec 27 02:12:40 2007 @@ -1,38 +1,63 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_close</refname> - <refpurpose>Schliesst eine Socket-Verbindung</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>socket_close</methodname> - <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para> - <function>socket_close</function> schliesst die Socketverbindung, - die durch <parameter>socket</parameter> gegeben ist. - </para> - <note> - <para> - <function>socket_close</function> kann nicht für PHP - Dateideskriptoren benutzt werden, die mit <function>fopen</function>, - <function>popen</function>, <function>fsockopen</function> oder - <function>pfsockopen</function> erzeugt wurden; sie gilt nur für - Sockets, die mit <function>socket_create</function> oder - <function>socket_accept</function> erzeugt wurden. - </para> - </note> - <para> - Siehe auch <function>socket_bind</function>, <function>socket_listen</function>, - <function>socket_create</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.9 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-close"> + <refnamediv> + <refname>socket_close</refname> + <refpurpose>Schliesst eine Socket-Verbindung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>socket_close</methodname> + <methodparam><type>resource</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para> + <function>socket_close</function> schliesst die Socketverbindung, + die durch <parameter>socket</parameter> gegeben ist. Diese Funktion gilt + ausschließlich für Sockets und kann für keine anderen Arten von Ressourcen + verwendet werden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + Ein gültiger Socket-Deskriptor, der mit <function>socket_create</function> + oder <function>socket_accept</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_bind</function></member> + <member><function>socket_listen</function></member> + <member><function>socket_create</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions/socket-connect.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/sockets/functions/socket-connect.xml diff -u phpdoc-de/reference/sockets/functions/socket-connect.xml:1.3 phpdoc-de/reference/sockets/functions/socket-connect.xml:1.4 --- phpdoc-de/reference/sockets/functions/socket-connect.xml:1.3 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/functions/socket-connect.xml Thu Dec 27 02:12:40 2007 @@ -1,55 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> - <refentry xml:id="function.socket-connect" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>socket_connect</refname> - <refpurpose>Baut eine Verbindung über einen Socket auf</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>socket_connect</methodname> - <methodparam><type>resource</type><parameter>socket</parameter></methodparam> - <methodparam><type>string</type><parameter>address</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam> - </methodsynopsis> - <para> - Baut mit Hilfe eines gültigen Socket-Deskriptors - <parameter>socket</parameter>, der von der Funktion - <function>socket_create</function> zurückgegeben wurde, - eine Verbindung auf. - </para> - <para> - Der Parameter <parameter>address</parameter> ist entweder - eine IP-Adresse in Punktnotation (z.B. <literal>127.0.0.1</literal>), - falls der Socket zur <constant>AF_INET</constant> -Familie gehört, - oder der Pfadname eines Unix-domain socket, falls der Socket zur - <constant>AF_UNIX</constant> -Familie gehört. - </para> - <para> - Der Parameter <parameter>port</parameter> wird nur benutzt, wenn - eine Verbindung zu einem <constant>AF_INET</constant> -Socket - aufgebaut wird und gibt an, zu welchem Port des entfernten Hosts - eine Verbindung hergestellt werden soll. - </para> - <para> - &return.success; Der Fehlercode kann mit der Funktion - <function>socket_last_error</function> abgefragt werden. Dieser - Fehlercode kann an die Funktion <function>socket_strerror</function> - übergeben werden, um eine textuelle Beschreibung des Fehlers zu - erhalten. - </para> - <para> - See also - <function>socket_bind</function>, - <function>socket_listen</function>, - <function>socket_create</function>, - <function>socket_last_error</function> und - <function>socket_strerror</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.11 Maintainer: conni Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.socket-connect"> + <refnamediv> + <refname>socket_connect</refname> + <refpurpose>Baut eine Verbindung über einen Socket auf</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>socket_connect</methodname> + <methodparam><type>resource</type><parameter>socket</parameter></methodparam> + <methodparam><type>string</type><parameter>address</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam> + </methodsynopsis> + <para> + Baut über den gültigen Socket-Deskriptor <parameter>socket</parameter>, + der von <function>socket_create</function> zurückgegeben wurde, eine + Verbindung zu <parameter>address</parameter> auf. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>socket</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>address</parameter></term> + <listitem> + <para> + Der Parameter <parameter>address</parameter> ist entweder + eine IPv4-Adresse in Punktnotation (z.B. <literal>127.0.0.1</literal>), + falls <parameter>socket</parameter> zur <constant>AF_INET</constant>-Familie gehört, + oder eine gültige IPv6-Adresse (z.B <literal>::1</literal>), falls die + IPv6-Unterstützung aktiviert ist und <parameter>socket</parameter> zur + <constant>AF_INET6</constant>-Familie gehört, oder der Pfadname eines + Unix-Domain socket, falls der Socket zur <constant>AF_UNIX</constant>-Familie gehört. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>port</parameter></term> + <listitem> + <para> + Der Parameter <parameter>port</parameter> wird nur benutzt und ist dann + zwingend erforderlich, wenn eine Verbindung zu einem + <constant>AF_INET</constant>- oder einem <constant>AF_INET6</constant>-Socket + aufgebaut wird. Er gibt an, zu welchem Port des entfernten Hosts eine + Verbindung hergestellt werden soll. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; Der Fehlercode kann mit der Funktion <function>socket_last_error</function> + ermittelt werden. Dieser Fehlercode kann an die Funktion <function>socket_strerror</function> + übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten. + </para> + <note> + <para> + Falls der Socket nicht blockiert ist, gibt diese Funktion &false; sowie die + Fehlermeldung <literal>Operation now in progress</literal> zurück. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>socket_bind</function></member> + <member><function>socket_listen</function></member> + <member><function>socket_create</function></member> + <member><function>socket_last_error</function></member> + <member><function>socket_strerror</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: