View source for Les primitives de conversion entre noms et adresses

From Livre IPv6

← Les primitives de conversion entre noms et adresses
You do not have permission to edit this page, for the following reason:
The action you have requested is limited to users in one of the groups: Users, Administrators.
You can view and copy the source of this page:
{{suivi| L'interface socket | L'interface socket | La commande haah (host-address-address-host) | La commande haah (host-address-address-host) }}
Les primitives <tt>gethostbyname</tt>, <tt>gethostbyaddr</tt>, <tt>getservbyname</tt> et <tt>getservbyport</tt> ont été remplacées par les deux primitives indépendantes de la famille d'adresses et normalisées par la RFC 3493 <tt>getaddrinfo</tt> et <tt>getnameinfo</tt> :

 #include <sys/socket.h>
 #include <netdb.h>
  
 int
 getaddrinfo(const char *nodename, const char *servname,
 const struct addrinfo *hints, struct addrinfo **res);
  
 void freeaddrinfo(struct addrinfo *res);
  
 const char *gai_strerror(int errcode);

Le type <tt>struct addrinfo</tt> est défini comme suit :

 struct addrinfo {
    int ai_flags;             /* AI_PASSIVE, AI_CANONNAME, ... */
    int ai_family;            /* PF_xxx */
    int ai_socktype;          /* SOCK_xxx */
    int ai_protocol;          /* 0 ou IPPROTO_xxx pour IPv4 et IPv6 */
    size_t ai_addrlen;        /* la taille de l'adresse binaire ai_addr */
    char *ai_canonname;       /* le nom complétement qualifié */
    struct sockaddr *ai_addr; /* l'adresse binaire */
    struct addrinfo *ai_next; /* la structure suivante dans la liste chaînée */
 };

<tt>getaddrinfo</tt> prend en entrée le nom d'une machine (<tt>nodename</tt>) et le nom d'un service (<tt>servname</tt>). S'il n'y a pas d'erreur, <tt>getaddrinfo</tt> rend 0 et res pointe sur une liste dynamiquement allouée de <tt>struct addrinfo</tt>. Chaque élément de cette liste contient la description et l'adresse d'une <tt>struct sockaddr</tt> initialisée pour fournir l'accès au service servname sur nodename. Les champs <tt>ai_family</tt>, <tt>ai_socktype</tt> et <tt>ai_protocol</tt> ont la valeur utilisable dans l'appel système socket.

Lorsque la liste de résultat n'est plus nécessaire, la mémoire allouée peut être libérée par la primitive <tt>freeaddrinfo</tt>. En cas d'erreur, <tt>getaddrinfo</tt> rend un code d'erreur non nul qui peut être imprimé par la fonction <tt>gai_strerror</tt>.

<tt>getaddrinfo</tt> peut donner des réponses de la famille d'adresses IPv4 ou IPv6, et des réponses pour les protocoles connectés ou non (<tt>ai_socktype</tt> peut valoir <tt>SOCK_DGRAM</tt> ou <tt>SOCK_STREAM</tt>). L'argument <tt>hints</tt> permet de choisir les réponses souhaitées. Un argument égal à <tt>NULL</tt> signifie que la liste des réponses doit contenir toutes les adresses et tous les protocoles. Sinon <tt>hints</tt> doit pointer sur une structure dont les champs <tt>ai_family</tt>, <tt>ai_socktype</tt> et <tt>ai_protocol</tt> définissent les types de résultat attendus. Une valeur de <tt>PF_UNSPEC</tt> du champ <tt>ai_family</tt> signifie que toutes les familles d'adresse (IPv4 et IPv6) sont admises, un <tt>0</tt> dans les champs <tt>ai_socktype</tt> (resp. <tt>ai_protocol</tt>) signifie que tous les types de socket (resp. protocole) sont admis. Le champ <tt>ai_flags</tt> permet de préciser des options supplémentaires.

L'argument <tt>servname</tt> peut être le nom d'un service ou un nombre décimal. De même, l'argument <tt>nodename</tt> peut être un nom (au format DNS habituel) ou une adresse sous forme numérique IPv4 ou IPv6 (si <tt>ai_flags</tt> contient le bit <tt>AI_NUMERICHOST</tt>, <tt>nodename</tt> doit être sous forme numérique et aucun appel au serveur de nom n'est fait). De plus l'un ou l'autre des arguments <tt>servname</tt> et <tt>nodename</tt> peut être un pointeur <tt>NULL</tt>, mais pas tous les deux. Si <tt>servname</tt> est <tt>NULL</tt>, le champ <tt>port</tt> des réponses ne sera pas initialisé (il restera égal à <tt>0</tt>). Si <tt>nodename</tt> est <tt>NULL</tt>, l'adresse réseau dans les réponses est mis à "non initialisé" (<tt>INADDR_ANY</tt> en IPv4, <tt>IN6ADDR_ANY_INIT</tt> en IPv6) si <tt>ai_flags</tt> contient le bit <tt>AI_PASSIVE</tt>, et à l'adresse de "loopback" (<tt>INADDR_LOOPBACK</tt> ou <tt>IN6ADDR_LOOPBACK_INIT</tt>) sinon. Le cas <tt>AI_PASSIVE</tt> sert donc à obtenir des réponses utilisables par un programme serveur dans un ''bind'' pour recevoir des requêtes. Enfin si le bit <tt>AI_CANONNAME</tt> est positionné, le champ <tt>ai_canonname</tt> de la réponse contient le nom canonique de <tt>nodename</tt>.

La primitive <tt>getnameinfo</tt> remplace les primitives <tt>gethostbyaddr</tt> et <tt>getservbyport</tt>. Elle effectue la traduction d'une adresse vers un nom :

 #include <sys/socket.h>
 #include <netdb.h>
  
 int getnameinfo(const struct sockaddr *sa, socklen_t salen,
 char *host, size_t hostlen,
 char *serv, size_t servlen, int flags);

En entrée l'argument sa pointe vers une structure d'adresse générique (de type <tt>sockaddr_in</tt> ou <tt>sockaddr_in6</tt>) et salen contient sa longueur. Le champ <tt>host</tt> (resp. <tt>serv</tt>) doit pointer sur une zone de longueur <tt>hostlen</tt> (resp. <tt>servlen</tt>) caractères. <tt>getnameinfo</tt> retourne la valeur <tt>0</tt> si tout est correct et un code d'erreur non nul si une erreur est détectée. S'il n'y a pas d'erreur, le champ <tt>host</tt> (resp. <tt>serv</tt>) reçoit en sortie le nom de la machine (resp. du service) correspondant. Les arguments <tt>host</tt> et <tt>serv</tt> peuvent être <tt>NULL</tt> si la réponse est inutile. Deux constantes sont définies pour permettre de réserver des zones de réponses de longueur raisonnable :

 # define NI_MAXHOST 1025
 # define NI_MAXSERV 32

Le champ <tt>flags</tt> permet de modifier la réponse : si flags contient le bit <tt>NI_NUMERICHOST</tt> (resp. <tt>NI_NUMERICSERV</tt>) la réponse sera l'adresse et non le nom de la machine (resp. le numéro et non le nom du service) ; si on ne sait pas trouver dans le serveur de nom le nom de la machine, <tt>getnameinfo</tt> rendra une erreur si le bit <tt>NI_NAMEREQD</tt> est positionné et l'adresse numérique sinon ; le bit <tt>NI_DGRAM</tt> indique si le service est sur UDP et non sur TCP.

==<div id="conv">Les fonctions de conversion numériques d'adresses</div>==

Elles sont l'analogue des fonctions <tt>inet_addr</tt> et <tt>inet_ntoa</tt> d'IPv4, la seule véritable différence étant qu'elles ont un argument précisant la famille d'adresse et peuvent donc aussi bien convertir les adresses IPv4 que les adresses IPv6. Comme la plupart des programmes manipulent des <tt>struct sockaddr*</tt>, il est souvent préferable d'utiliser les fonctions <tt>getaddrinfo</tt> et <tt>getnameinfo</tt>, au besoin avec le flag <tt>AI_NUMERICHOST</tt>.

 #include <sys/socket.h>
 #include <arpa/inet.h>
  
 int
 inet_pton(af, src, dst)
 int af;              /* AF_INET ou AF_INET6 */
 const char *src;     /* l'adresse (chaine de caract.) à traiter */
 void *dst;           /* le tampon où est rangé le résultat */
  
 char *
 inet_ntop(af, src, dst, size)
 int af;              /* AF_INET ou AF_INET6 */
 const void *src;     /* l'adresse binaire à traiter */
 char *dst;           /* le tampon où est rangé le résultat */
 size_t size;         /* la taille de ce tampon */

La primitive <tt>inet_pton</tt> convertit une adresse textuelle en sa forme binaire. Elle retourne <tt>1</tt> lorsque la conversion a été réussie, <tt>0</tt> si la chaine de caractères qui lui a été fournie n'est pas une adresse valide et <tt>-1</tt> en cas d'erreur, c'est-à-dire lorsque la famille d'adresses (premier argument) n'est pas supportée. Actuellement, les deux seules familles d'adresses supportées sont <tt>AF_INET</tt> et <tt>AF_INET6</tt>.

La primitive duale <tt>inet_ntop</tt> convertit une adresse sous forme binaire en sa forme textuelle. Le troisième argument est un tampon destiné à recevoir le résultat de la conversion. Il doit être d'une taille suffisante, à savoir 16 octets pour les adresses IPv4 et 46 octets pour les adresses IPv6. Ces deux tailles sont définies dans le fichier <tt>netinet/in.h</tt> :

 #define INET_ADDRSTRLEN 16
 #define INET6_ADDRSTRLEN 46

Si la conversion est réussie, <tt>inet_ntop</tt> retourne un pointeur vers le tampon où est rangé le résultat de la conversion. Dans le cas contraire, <tt>inet_ntop</tt> retourne le pointeur nul, ce qui se produit soit lorsque la famille d'adresses n'est pas reconnue, soit lorsque la taille du tampon est insuffisante.
{{suivi| L'interface socket | L'interface socket | La commande haah (host-address-address-host) | La commande haah (host-address-address-host) }}
Template used on this page:
Template:Suivi (view source)
Return to Les primitives de conversion entre noms et adresses.
Retrieved from "http://livre.g6.asso.fr/index.php/Les_primitives_de_conversion_entre_noms_et_adresses"
Association G6

View source for Les primitives de conversion entre noms et adresses

From Livre IPv6

Views

Personal tools

Navigation

Search

Tools
