Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] bind - Fournir un nom à 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 bind(int sockfd , struct sockaddr * my_addr , socklen_t addrlen );[/i][/b] [size=18] [b]Description[/b] [/size] [b]bind[/b] fournit à la socket [b]sockfd ,[/b] l'adresse locale [b]my_addr .[/b] [i]my_addr[/i] est longue de [i]addrlen[/i] octets. Traditionnellement cette opération est appelée "affectation d'un nom à une socket" (Quand une socket est créée, par l'appel-système [b]socket (2),[/b] elle existe dans l'espace des noms mais n'a pas de nom assigné). Il est normalement nécessaire d'affecter une adresse locale avec [b]bind[/b] avant qu'une socket [b]SOCK_STREAM[/b] puisse recevoir des connexions (voir [b]accept (2)).[/b] Les règles d'affectation de nom varient suivant le domaine de communication. Consultez le manuel Linux section 7 pour de plus amples informations. Pour [b]AF_INET[/b] voir [b]ip (7),[/b] pour [b]AF_UNIX[/b] voir [b]unix (7),[/b] pour [b]AF_APPLETALK[/b] voir [b]ddp (7),[/b] pour [b]AF_PACKET[/b] voir [b]packet (7),[/b] pour [b]AF_X25[/b] voir [b]x25 (7)[/b] et pour [b]AF_NETLINK[/b] voir [b]netlink (7).[/b] [size=18] [b]Valeur renvoyée[/b] [/size] L'appel 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] [b]EBADF[/b] [i]sockfd[/i] [table][row][col]    [/col][col]n'est pas un descripteur valide.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]La socket possède déjà une adresse. Ceci peut changer dans l'avenir : voir [i]linux/unix/sock.c[/i] pour les détails.[/col][/row][/table] [b]EACCES[/b] [table][row][col]    [/col][col]L'adresse est protégée et l'utilisateur n'est pas le Super-User.[/col][/row][/table] [b]ENOTSOCK[/b] [table][row][col]    [/col][col]L'argument est un descripteur de fichier, pas une socket.[/col][/row][/table] Les erreurs suivantes sont spécifiques aux sockets du domaine UNIX [b]( AF_UNIX ) :[/b] [b]EINVAL[/b] [table][row][col]    [/col][col]La longueur [i]addr_len[/i] est fausse, ou la socket n'est pas de la famille [b]AF_UNIX.[/b][/col][/row][/table] [b]EROFS[/b] [table][row][col]    [/col][col]L'i-noeud se trouverait dans un système de fichiers en lecture seule.[/col][/row][/table] [b]EFAULT[/b] [i]my_addr[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adresse accessible.[/col][/row][/table] [b]ENAMETOOLONG[/b] [i]my_addr[/i] [table][row][col]    [/col][col]est trop long[/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Le fichier n'existe pas.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]pas assez de mémoire pour le noyau.[/col][/row][/table] [b]ENOTDIR[/b] [table][row][col]    [/col][col]Un composant du chemin d'accès n'est pas un répertoire.[/col][/row][/table] [b]EACCES[/b] [table][row][col]    [/col][col]L'accès à un composant du chemin d'accès n'est pas autorisé.[/col][/row][/table] [b]ELOOP[/b] [i]my_addr[/i] [table][row][col]    [/col][col]contient des références circulaires (à travers un lien symbolique).[/col][/row][/table] [size=18] [b]Bugs[/b] [/size] Les options de proxy transparent ne sont pas décrites. [size=18] [b]Conformité[/b] [/size] SVr4, BSD 4.4 (l'appel système [b]bind[/b] est apparu dans BSD 4.2). SVr4 indique des erreurs générales supplémentaires [b]EADDRNOTAVAIL ,[/b] [b]EADDRINUSE ,[/b] et ENOSR, ainsi que les conditions d'erreurs spécifiques au domaine Unix [b]EIO [/b] et [b]EISDIR .[/b] [size=18] [b]Note[/b] [/size] Le troisième argument de [b]bind[/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. Voir [b]accept (2).[/b] [size=18] [b]Voir aussi[/b] [/size] [b]accept (2),[/b] [b]connect (2),[/b] [b]listen (2),[/b] [b]socket (2),[/b] [b]getsockname (2),[/b] [b]ip (7),[/b] [b]socket (7).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier