Fonctions du
système (section 2) listen
Nom
listen - Attendre des connexions sur une socket.Synopsis
#include <sys/socket.h>int listen(int s, int backlog);
Description
listen est généralement utilisé avec des processus serveurs orientés-connexion.
Pour accepter des connexions, une socket est d'abord créé 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 arrrive alors que la file est pleine, le client reçoit une erreur indiquant ECONNREFUSED, ou, si le protocole sous-jacent supporte les retranmissions, la requête peut être ignorée afin qu'un nouvel essai réussisse.
Valeur Renvoyée
listen renvoie 0 si il réussit, ou -1 en cas d'échec, auquel cas errno contient le code d'erreur.Erreurs
- EBADF
- s n'est pas un descripteur valide
- ENOTSOCK
- L'argument s n'est pas une socket.
- EOPNOTSUPP
- Le type de socket ne supporte pas l'appel système listen.
Conformité
SVr4, BSD (l'appel système listen est apparu dans BSD 4.2).Bogues
Si la socket est de type AF_INET (internet), et si l'argument backlog est supérieur à 128, il est silencieusement ramené à SO_MAXCONN. Pour la portabilité des applications, ne vous fiez pas à cette valeur puisque BSD (et d'autres dérivés) limitent l'argument backlog à 5.Voir Aussi
accept(2) , connect(2) , socket(2)
Traduction
Christophe Blaess, 1997.