Provided by: manpages-de-dev_0.5-4.1ubuntu1_all bug

BEZEICHNUNG

       listen - Horche auf einem Socket auf Verbindungen

ÜBERSICHT

       #include <sys/socket.h>

       int listen(int s, int backlog);

BESCHREIBUNG

       Um  eine  Verbindung  anzunehmen,  muss ein Socket zuerst mit socket(2)
       erzeugt werden.  Der Wunsch, eingehende Verbindungen  anzunehmen  sowie
       ein   Limit   an   nicht   bearbeiteten   Verbindungen,  die  in  einer
       Warteschleife   gehalten   werden,   wird   mit   listen()   angezeigt.
       Anschließend  werden Verbindungen mit accept(2) angenommen.  Der Aufruf
       von listen ist für  Sockets  vom  Typ  SOCK_STREAM  und  SOCK_SEQPACKET
       gültig.

       Das Argument backlog spezifiziert die maximale Länge der Warteschlange,
       die  noch  nicht  angenommene   Verbindungen   aufnimmt.    Wenn   eine
       Verbindungsanfrage ankommt und die Warteschlange ist bereits voll, dann
       erhält der Client einen Fehler mit der  Angabe  ECONNREFUSED  oder  die
       Anfrage   wird   ignoriert,   wenn   das   zugrundeliegende   Protokoll
       "Retransmission" unterstützt, damit weitere Versuche erfolgreich  sind.

RÜCKGABEWERT

       Bei  Erfolg wird null zurückgegeben, bei einem Fehler -1 und errno wird
       entsprechend gesetzt.

FEHLER

       EBADF  Das Argument s ist kein gültiger Deskriptor.

       ENOTSOCK
              Das Argument s ist kein Socket.

       EOPNOTSUPP
              Der Socket ist nicht von einem Typ,  der  die  Operation  listen
              unterstützt.

GESCHICHTE

       Die Funktion listen tauchte in BSD 4.2 auf.

BUGS

       Wenn der Socket vom Typ af_inet ist und das Argument backlog größer als
       128  ist,  wird  es  stillschweigend  auf  128  gekürzt.   Um  portable
       Anwendungen  zu  schreiben,  sollte  nicht  auf  solche  Werte vertraut
       werden,  denn  BSD  (und  wenigstens   einige   BSD-basierte   Systeme)
       limitieren backlog auf 5 Verbindungen.

SIEHE AUCH

       accept(2), connect(2), socket(2).