LISTEN

Index

NOM
SYNOPSIS
DESCRIPTION
NOTES
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
BOGUES
VOIR AUSSI
TRADUCTION

NOM

listen - Attendre des connexions sur une socket

SYNOPSIS

#include <sys/socket.h>
int listen(int sockfd, int backlog);

DESCRIPTION

Pour accepter des connexions, une socket est d'abord créée 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 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.

NOTES

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étail.

VALEUR RENVOYÉE

L'appel renvoie 0 quand il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

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. La fonction listen() est apparue dans BSD 4.2.

BOGUES

Si la socket est de type AF_INET (IPv4), et si l'argument backlog est supérieur à la constante SOMAXCONN (128 dans Linux 2.0 et 2.2), il est silencieusement ramené à SOMAXCONN.

VOIR AUSSI

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

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007