listen

(PHP 4 >= 4.0.2)

listen -- Horcht auf eine Verbindungsanforderung an dem Socket

Beschreibung

int listen (int socket, int backlog)

Nachdem der Socket socket mit socket() erzeugt wurde und mit bind() mit einem Namen verknüpft wurde, wird er mit dieser Funktion angewiesen, am Socket socket auf hereinkommende Verbindungen zu horchen. backlog ist das Maximum an hereinkommenden Verbindungsanforderungen, die zur weiteren Verarbeitung in die Warteschlange gestellt werden können.

listen() kann nur mit Sockets vom Typ SOCK_STREAM oder SOCK_SEQPACKET verwendet werden.

Gibt bei Erfolg null zurück oder einen negativen Fehlercode wenn die Funktion fehlschlägt. Dieser Fehlercode kann an die Funktion strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Siehe auch: accept_connect(), bind(), connect(), socket(), socket_get_status(), und strerror().