LISTEN(2)          Manuel du programmeur Linux          LISTEN(2)


NOM
       listen - Attendre des connexions sur une socket.

SYNOPSIS
       #include <sys/socket.h>

       int listen(int s, int backlog);

DESCRIPTION
       listen   est   généralement  utilisé  avec  des  processus
       serveurs orientés-connexion.

       Pour accepter des connexions, une socket est d'abord  créé
       avec  socket(2),  puis  le désir d'accepter des connexions
       entrantes, et la limite de la file d'entrée sont  indiqués
       avec  listen, ensuite les connexions seront acceptées avec
       accept(2).  L'appel système  listen  s'applique  seulement
       aux sockets de type SOCK_STREAM ou SOCK_SEQPACKET.

       Le paramètre backlog définit une longueur maximale pour la
       file des connexions en attente.  Si une nouvelle connexion
       arrrive alors que la file est pleine, le client reçoit une
       erreur indiquant ECONNREFUSED, ou, si le  protocole  sous-
       jacent  supporte  les retranmissions, la requête peut être
       ignorée afin qu'un nouvel essai réussisse.

VALEUR RENVOYÉE
       listen renvoie 0 si il réussit,  ou  -1  en  cas  d'échec,
       auquel cas errno contient le code d'erreur.

ERREURS
       EBADF   s n'est pas un descripteur valide

       ENOTSOCK
               L'argument s n'est pas une socket.

       EOPNOTSUPP
               Le  type de socket ne supporte pas l'appel système
               listen.

CONFORMITÉ
       SVr4, BSD (l'appel système  listen  est  apparu  dans  BSD
       4.2).

BUGS
       Si la socket est de type AF_INET (internet), et si l'argu­
       ment backlog est supérieur à 128, il  est  silencieusement
       ramené  à  SO_MAXCONN.   Pour  la portabilité des applica­
       tions, ne vous fiez pas à cette  valeur  puisque  BSD  (et
       d'autres dérivés) limitent l'argument backlog à 5.

VOIR AUSSI
       accept(2), connect(2), socket(2)




BSD                     21 Septembre 1998                       1





LISTEN(2)          Manuel du programmeur Linux          LISTEN(2)


TRADUCTION
       Christophe Blaess, 1997.























































BSD                     21 Septembre 1998                       2