Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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> >>.