Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] connect - Débuter une connexion sur une socket. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/types.h>[/b] [b][/b] [b]#include <sys/socket.h>[/b] [b][i]int connect(int sockfd , struct sockaddr * serv_addr ,[/i][/b] [b][i]socklen_t addrlen );[/i][/b] [size=18] [b]Description[/b] [/size] Le paramètre [i]sockfd[/i] est une socket. Si la socket est du type [b]SOCK_DGRAM ,[/b] alors [i]serv_adr[/i] est l'adresse à laquelle les datagrammes seront envoyés par défaut, et la seule adresse depuis laquelle ils seront reçus. Si la socket est du type [b]SOCK_STREAM[/b] ou [b]SOCK_SEQPACKET ,[/b] cette fonction tente de se connecter à une autre socket. L'adresse de l'autre socket est indiquée par [b]serv_addr,[/b] qui doit être une adresse (de longueur [b]addrlen )[/b] dans le même domaine que la socket. Chaque domaine de communication interprète le paramètre [b]serv_addr,[/b] à sa manière. En général, les sockets des protocoles orientés connexion ne réussissent un appel [b]connect[/b] qu'une seule fois, alors qu'une socket d'un protocole sans connexion peut appeler [b]connect[/b] plusieurs fois pour changer son affectation. Une socket sans connexion peut interrompre son affectation en se connectant sur une adresse avec le membre [i]sa_family[/i] de la structure [b]sockaddr[/b] à la valeur [b]AF_UNSPEC .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] [b]connect[/b] renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] Voici une liste d'erreurs générales concernant les sockets, il peut en exister d'autres spécifiques au domaine employé. [b]EBADF[/b] [table][row][col]    [/col][col]Mauvais descripteur.[/col][/row][/table] [b]EFAULT[/b] [table][row][col]    [/col][col]La structure d'adresse pointe en dehors de l'espace d'adressage.[/col][/row][/table] [b]ENOTSOCK[/b] [table][row][col]    [/col][col]Le descripteur ne correspond pas à une socket.[/col][/row][/table] [b]EISCONN[/b] [table][row][col]    [/col][col]La socket est déjà connectée.[/col][/row][/table] [b]ECONNREFUSED[/b] [table][row][col]    [/col][col]La connexion est refusée par le serveur.[/col][/row][/table] [b]ETIMEDOUT[/b] [table][row][col]    [/col][col]Dépassement du délai maximum pendant la connexion. Le serveur peut être trop chargé pour accepter une nouvelle connexion. Remarquez que pour les sockets IP, le délai peut être très long si les syncookies sont activés sur le serveur.[/col][/row][/table] [b]ENETUNREACH[/b] [table][row][col]    [/col][col]Le réseau est inaccessible.[/col][/row][/table] [b]EADDRINUSE[/b] [table][row][col]    [/col][col]L'adresse est déjà utilisée.[/col][/row][/table] [b]EINPROGRESS[/b] [table][row][col]    [/col][col]La socket est non-bloquante, et la connexion ne peut pas être établie immédiatement. Il est alors possible d'utiliser [b]select (2)[/b] ou [b]poll (2)[/b] pour attendre que la socket soit disponible en écriture. Une fois que [b]select[/b] confirme la possibilité d'écrire, utilisez [b]getsockopt (2)[/b] pour lire l'option [b]SO_ERROR[/b] du niveau [b]SOL_SOCKET[/b] et déterminer si [b]connect[/b] s'est terminé avec succès [b]( SO_ERROR[/b] vaut zéro) ou en échec [b]( SO_ERROR[/b] contient l'un des codes d'erreurs listés ici, indiquant le problème).[/col][/row][/table] [b]EALREADY[/b] [table][row][col]    [/col][col]La socket est non-bloquante et une tentative de connexion précédente ne s'est pas encore terminée.[/col][/row][/table] [b]EAGAIN[/b] [table][row][col]    [/col][col]Pas de port local disponible, ou pas assez de place dans les tables de routage. Pour [b]PF_INET[/b] voir l'appel sysctl [b]net.ipv4.ip_local_port_range[/b] dans [b]ip (7)[/b] pour savoir comment augmenter le nombre de ports locaux.[/col][/row][/table] [b]EAFNOSUPPORT[/b] [table][row][col]    [/col][col]L'adresse transmise n'appartient pas à la famille indiquée dans son champ [b]sa_family .[/b][/col][/row][/table] [b]EACCES, EPERM[/b] [table][row][col]    [/col][col]L'utilisateur a tenté de connecter une adresse broadcast sans avoir activé l'attribut broadcast, ou la demande de connexion a échoué à cause des règles d'un firewall local.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVr4, 4.4BSD (La fonction [b]connect[/b] est apparue en premier dans BSD 4.2). SVr4 décrit des erreurs générales [b]EADDRNOTAVAIL ,[/b] [b]EINVAL ,[/b] [b]EAFNOSUPPORT , [/b] [b]EALREADY ,[/b] [b]EINTR ,[/b] [b]EPROTOTYPE ,[/b] et [b]ENOSR .[/b] Il décrit également plusieurs causes d'erreurs non présentées ici. [size=18] [b]Note[/b] [/size] Le troisième argument de [b]connect[/b] est en fait un int (et c'est ce qu'utilisent BSD 4.*, libc4 et libc5). Une certaine confusion POSIX résulte du "socklen_t" actuel. Les propositions de standard n'ont pas encore été adoptées, mais glibc2 les suit déjà et utilise socklen_t. Pour plus de détails voir [b]accept (2).[/b] [size=18] [b]Bugs[/b] [/size] La déconnexion d'une socket en appelant [b]connect[/b] avec un adresse de type [b]AF_UNSPEC[/b] n'est pas encore implémentée. [size=18] [b]Voir aussi[/b] [/size] [b]accept (2), [/b] [b]bind (2),[/b] [b]listen (2), [/b] [b]socket (2), [/b] [b]getsockname (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier