LISTEN

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 28 décembre 2007
Index Menu principal

NOM

listen - Attendre des connexions sur une socket

SYNOPSIS

#include <sys/types.h>          /* Voir NOTES */


#include <sys/socket.h>

int listen(int sockfd, int backlog);

DESCRIPTION

listen() marque la socket référencée par sockfd comme une socket passive, c'est-à-dire comme une socket qui sera utilisée pour accepter les demandes de connexions entrantes en utilisant accept(2).

L'argument sockfd est un descripteur de fichier qui fait référence à une socket de type SOCK_STREAM ou SOCK_SEQPACKET.

L'argument backlog définit une longueur maximale jusqu'à laquelle la file des connexions en attente pour sockfd peut croître. Si une nouvelle connexion arrive alors que la file est pleine, le client reçoit une erreur indiquant ECONNREFUSED, ou, si le protocole sous-jacent supporte les retransmissions, la requête peut être ignorée afin qu'un nouvel essai réussisse.

VALEUR RENVOYÉE

Cet appel système renvoie 0 si il réussit, ou -1 en cas d'échec, auquel cas errno est renseignée en conséquence.

ERREURS

EADDRINUSE: Une autre socket est déjà à l'écoute sur le même port.
EBADF: sockfd n'est pas un descripteur valide
ENOTSOCK: L'argument sockfd n'est pas une socket.
EOPNOTSUPP: Le type de socket ne supporte pas l'appel système listen().

CONFORMITÉ

BSD 4.4, POSIX.1-2001. L'appel système listen() est apparu dans BSD 4.2.

NOTES

Pour accepter des connexions, les étapes suivantes sont effectuées :

1.: Une socket est créée avec socket(2).
2.: La socket est limitée à une adresse locale avec bind(2), ainsi d'autres sockets peuvent y être connect(2)ées.
3.: La volonté d'accepter des connexions entrantes et une limite de file pour les connexions entrantes sont spécifiées avec listen().
4.: Les connexions sont acceptées avec accept(2).

POSIX.1-2001 ne réclame pas l'inclusion de <sys/types.h>, et ce fichier d'entête n'est pas requis par Linux. Toutefois, certaines implémentations historiques (BSD) ont besoin de ce fichier d'entête et il serait probablement plus sage que les applications destinées à être portable l'incluent.

Le comportement de backlog a été modifié sur les sockets TCP dans Linux 2.2. Il s'agit à présent de la longueur de la file d'attente pour les socket totalement établies en attente d'acceptation, plutôt que les requêtes de connexion incomplètes. La longueur maximale de la file d'attente des connexions incomplètes peut être configurée avec l'appel sysctl tcp_max_syn_backlog. Lorsque les syncookies sont activés, il n'y a pas de longueur maximale et la configuration sysctl est ignorée. Voir tcp(7) pour plus de détails.

Si l'argument backlog est supérieur à la valeur indiquée dans le fichier /proc/sys/net/core/somaxconn, il est silencieusement ramené à cette valeur ; la valeur par défaut dans ce fichier est 128. Dans les noyaux antérieur au 2.4.25, cette limite était codée en dur, SOMAXCONN, qui valait également 128.

EXEMPLE

Voir bind(2).

VOIR AUSSI

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

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 octobre 1996 et révisée le 23 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 listen ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 23 juin 2008