Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] listen - Attendre des connexions sur une socket. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/socket.h>[/b] [b][i]int listen(int s , int backlog );[/i][/b] [size=18] [b]Description[/b] [/size] Pour accepter des connexions, une socket est d'abord créée avec [b]socket (2),[/b] puis le désir d'accepter des connexions entrantes, et la limite de la file d'entrée sont indiqués avec [b]listen ,[/b] ensuite les connexions seront acceptées avec [b]accept (2).[/b] L'appel système [b]listen[/b] s'applique seulement aux sockets de type [b]SOCK_STREAM[/b] ou [b]SOCK_SEQPACKET.[/b] Le paramètre [i]backlog[/i] 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 [b]ECONNREFUSED ,[/b] 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 [i]backlog[/i] 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 [i]totalement[/i] é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 [b]tcp_max_syn_backlog .[/b] Lorsque les syncookies sont activés, il n'y a pas de longueur maximale et la configuration sysctl est ignorée. Voir [b]tcp (7)[/b] pour plus de détail. [size=18] [b]Valeur renvoyée[/b] [/size] [b]listen[/b] renvoie 0 si il réussit, ou -1 en cas d'échec, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EADDRINUSE[/b] [table][row][col]    [/col][col]Une autre socket est déjà à l'écoute sur le même port.[/col][/row][/table] [b]EBADF[/b] [i]s[/i] [table][row][col]    [/col][col]n'est pas un descripteur valide[/col][/row][/table] [b]ENOTSOCK[/b] [table][row][col]    [/col][col]L'argument [i]s[/i] n'est pas une socket.[/col][/row][/table] [b]EOPNOTSUPP[/b] [table][row][col]    [/col][col]Le type de socket ne supporte pas l'appel système [b]listen.[/b][/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVr4, BSD (l'appel système [b]listen[/b] est apparu dans BSD 4.2). [size=18] [b]Bugs[/b] [/size] Si la socket est de type [b]AF_INET[/b] (internet), et si l'argument [i]backlog[/i] est supérieur à la constante [b]SOMAXCONN [/b] (128 dans Linux 2.0 et 2.2), il est silencieusement ramené à [b]SO_MAXCONN .[/b] Pour la portabilité des applications, ne vous fiez pas à cette valeur puisque BSD (et d'autres dérivés) limitent l'argument [i]backlog [/i] à 5. [size=18] [b]Voir aussi[/b] [/size] [b]accept (2),[/b] [b]connect (2),[/b] [b]socket (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier