socket_accept

Beschreibung

Nachdem der Socket socket mit der socket_create() erzeugt wurde, mit socket_bind() mit einem Namen verknuepft wurde und mit socket_listen() 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 socket_accept() so lange, bis eine Verbindungsanforderung kommt. Falls socket mit der Funktion socket_set_blocking() oder mit socket_set_nonblock() auf 'nicht blockieren' gesetzt wurde, wird FALSE zurückgegeben.

Der Socket-Deskriptor, der von socket_accept() zurückgegeben wird, soll nicht dazu benutzt werden, um neue Verbindungsanforderungen zu benutzen. Der ursprüngliche wartende Socket socket bleibt geöffnet und kann wiederbenutzt werden.

Gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder FALSE, falls ein Fehler auftritt. Der aktuelle Fehlercode kann mit der Funktion socket_last_error() ermittelt werden. Dieser Fehlercode kann an die Funktion strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Siehe auch: socket_bind(), socket_connect(), socket_listen(), socket_create() und socket_strerror().