cvs: phpdoc-de /reference/sockets/functions socket-last-error.xml socket-listen.xml

conni Sat Aug 17 19:49:16 2002 EDT Added files: /phpdoc-de/reference/sockets/functions socket-last-error.xml socket-listen.xml Log: added new files Index: phpdoc-de/reference/sockets/functions/socket-last-error.xml +++ phpdoc-de/reference/sockets/functions/socket-last-error.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision 1.4: Maintainer: conni Status: ready --> <refentry id="function.socket-last-error"> <refnamediv> <refname>socket_last_error</refname> <refpurpose>Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist. </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>socket_last_error</methodname> <methodparam choice="opt"><type>resource</type><parameter>socket</parameter></methodparam> </methodsynopsis> &warn.experimental.func; <para> Diese Funktion gibt einen Fehlercode für einen Socket zurück. </para> <para> Falls ein Socket-Deskriptor an diese Funktion übergeben wird, wird der letzte Fehler, der an diesem bestimmten Socket aufgetreten ist, zurückgegeben. Falls kein Socket-Deskriptor übergeben wird, wird der Fehlercode der letzten fehlgeschlagenen Funktion zurückgegeben. Letzteres ist besonders hilfreich für Funktionen wie <function>socket_create</function>, die bei einem Fehler keinen Socket zurückgibt, und <function>socket_select</function>, die aus anderen Gründen, die nichts mit einem bestimmten Socket zu tun haben, fehlschlagen kann. Der Fehlercode kann an die Funktion <function>socket_strerror</function> übergeben werden, die eine textuelle Beschreibung dieses Fehlercodes zurückgibt. <programlisting role="php"> <![CDATA[ if (false == ($socket = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP))) { die("Konnte keinen socket erzeugen, der Fehlercode ist: " . socket_last_error() . ",error message is: " . socket_strerror(socket_last_error())); } ]]> </programlisting> </para> <note> <para> <function>socket_last_error</function> löscht den Fehlercode nicht. Dafür müssen sie die Funktion <function>socket_clear_error</function> aufrufen. </para> </note> </refsect1> </refentry> <!-- 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: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-de/reference/sockets/functions/socket-listen.xml +++ phpdoc-de/reference/sockets/functions/socket-listen.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision 1.3: Maintainer: conni Status: ready --> <refentry id="function.socket-listen"> <refnamediv> <refname>socket_listen</refname> <refpurpose>Hört einen Socket nach Verbindungsanforderungen ab </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>socket_listen</methodname> <methodparam><type>resource</type><parameter>socket</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>backlog</parameter></methodparam> </methodsynopsis> &warn.experimental.func; <para> Nachdem der Socket <parameter>socket</parameter> mit <function>socket_create</function> erzeugt und mit <function>socket_bind</function> mit einem Namen verknüpft wurde, wird er angewiesen, nach hereinkommenden Verbindungsanforderungen an dem Socket <parameter>socket</parameter> zu horchen. </para> <para> Maximal werden <parameter>backlog</parameter> hereinkommende Verbindungsanforderungen zur späteren Verarbeitung in die Warteschlange gestellt. Falls eine Verbindungsanforderung ankommt, wenn die Warteschlange voll ist, bekommt der Client eine Fehlermeldung mit dem Hinweis <literal>ECONNREFUSED</literal>. Oder, falls das zugrundeliegende Protokoll eine Rückübertragung unterstützt, wird die Anforderung ignoriert, so dass weitere Verbindungsversuche möglicherweise erfolgreich sind. </para> <note> <para> Die maximale Anzahl, der im Parameter <parameter>backlog</parameter> angegebenen Einträge der Warteschlange, hängt entscheidend vom darunterliegenden Betriebssystem ab. Auf Linux-Systemen wird die Zahl stillschweigend auf <constant>SOMAXCONN</constant> begrenzt. Wenn auf Win32-Systemen <constant>SOMAXCONN</constant> gesetzt ist, ist der Dienstanbieter verantwortlich für den Socket und muss die Warteschlange auf einen <emphasis>vernünftigen</emphasis> Maximalwert begrenzen. Es gibt für diese Systeme keine standardmässige Möglichkeit, den aktuellen Wert herauszufinden. </para> </note> <para> <function>socket_listen</function> kann nur mit Sockets vom Typ <constant>SOCK_STREAM</constant> oder <constant>SOCK_SEQPACKET</constant> benutzt werden. </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> Siehe auch <function>socket_accept</function>, <function>socket_bind</function>, <function>socket_connect</function>, <function>socket_create</function> und <function>socket_strerror</function>. </para> </refsect1> </refentry> <!-- 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: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->