Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       listen - Attendre des connexions sur une socket

SYNOPSIS

       #include <sys/types.h>          /* Consultez NOTES */
       #include <sys/socket.h>

       int listen(int sockfd, int backlog);

DESCRIPTION

       listen()  marque  la  socket  referencee  par  sockfd  comme une socket
       passive, c'est-a-dire comme une socket qui sera utilisee pour  accepter
       les demandes de connexions entrantes en utilisant accept(2).

       Le  parametre sockfd est un descripteur de fichier qui fait reference a
       une socket de type SOCK_STREAM ou SOCK_SEQPACKET.

       Le parametre backlog definit une longueur maximale  pour  la  file  des
       connexions  en  attente  pour  sockfd. Si une nouvelle connexion arrive
       alors que la file est pleine, le client  recoit  une  erreur  indiquant
       ECONNREFUSED,   ou,   si   le   protocole   sous-jacent   supporte  les
       retransmissions, la requete peut etre ignoree afin qu'un  nouvel  essai
       reussisse.

VALEUR RENVOY'EE

       S'il  reussit,  cet appel systeme renvoie 0. S'il echoue, il renvoie -1
       et remplit errno en consequence.

ERREURS

       EADDRINUSE
              Une autre socket est deja a l'ecoute sur le meme port.

       EBADF  sockfd n'est pas un descripteur valable.

       ENOTSOCK
              Le parametre sockfd n'est pas une socket.

       EOPNOTSUPP
              Le type de socket ne supporte pas l'appel systeme listen().

CONFORMIT'E

       BSD 4.4, POSIX.1-2001. La fonction listen() est apparue dans BSD 4.2.

NOTES

       Pour accepter des connexions, les etapes suivantes sont effectuees :

           1.  Une socket est creee avec socket(2).

           2.  La socket est limitee a une adresse locale avec bind(2),  ainsi
               d'autres sockets peuvent y etre connect(2)ees.

           3.  La volonte d'accepter des connexions entrantes et une limite de
               file  pour  les  connexions  entrantes  sont  specifiees   avec
               listen().

           4.  Les connexions sont acceptees avec accept(2).

       POSIX.1-2001  ne  requiert pas l'inclusion de <sys/types.h>, et cet en-
       tete n'est pas necessaire sous Linux. Cependant, il  doit  etre  inclus
       sous  certaines  implementations historiques (BSD), et les applications
       portables devraient probablement l'utiliser.

       Le comportement de backlog a ete modifie sur les sockets TCP dans Linux
       2.2.  Il  s'agit a present de la longueur de la file d'attente pour les
       socket totalement etablies en attente  d'acceptation,  plutot  que  les
       requetes  de  connexion  incompletes.  La  longueur maximale de la file
       d'attente  des  connexions  incompletes  peut  etre   configuree   avec
       /proc/sys/net/ipv4/tcp_max_syn_backlog.  Lorsque  les  syncookies  sont
       actives, il n'y a pas de longueur  maximale  et  la  configuration  est
       ignoree. Consultez tcp(7) pour plus de details.

       Si  l'argument  backlog  est  plus grand que la valeur indiquee dans le
       fichier /proc/sys/net/core/somaxconn, il est tronque a  cette  valeur ;
       la valeur par defaut dans ce fichier est 128. Dans les noyaux precedant
       2.4.25, cette limite etait  une  valeur  fixe,  SOMAXCONN,  qui  valait
       egalement 128.

EXEMPLE

       Consultez bind(2).

VOIR AUSSI

       accept(2), bind(2), connect(2), socket(2), socket(7)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue a l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone       au       sein        du        projet        perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).    Julien
       Cristau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez   signaler   toute   erreur   de   traduction  en  ecrivant  a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.