Les primitives de conversion entre noms et adresses - Revision history

Eduble: /* Les fonctions de conversion numériques d'adresses */

2009-06-30T12:36:52Z

‎Les fonctions de conversion numériques d'adresses

Bruno Deniaud at 10:52, 27 February 2006

2006-02-27T10:52:02Z

Bruno Deniaud at 10:44, 27 February 2006

2006-02-27T10:44:56Z

Laurent Toutain: /* Les fonctions de conversion numériques d'adresses */

2005-12-14T06:24:02Z

‎Les fonctions de conversion numériques d'adresses

Laurent Toutain at 06:23, 14 December 2005

2005-12-14T06:23:20Z

New page

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 [[Bibliographie#RFC2401bis|[RFC2401bis]]] <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.

==Les fonctions de conversion numériques d'adresses==

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.

@@ Line 1: / Line 1: @@
 {{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 [[Bibliographie#RFC2401bis|[RFC2401bis]]] <tt>getaddrinfo</tt> et <tt>getnameinfo</tt> :
+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>

← Older revision		Revision as of 10:44, 27 February 2006
Line 1:		Line 1:
		+	{{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 [[Bibliographie#RFC2401bis\|[RFC2401bis]]] <tt>getaddrinfo</tt> et <tt>getnameinfo</tt> :		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 [[Bibliographie#RFC2401bis\|[RFC2401bis]]] <tt>getaddrinfo</tt> et <tt>getnameinfo</tt> :

Line 77:		Line 78:

	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.		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) }}

@@ Line 50: / Line 50: @@
 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>==
+==Les fonctions de conversion numériques d'adresses==
 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>.