#include <netinet/in.h> #include <arpa/nameser.h> #include <resolv.h> extern struct state _res; int res_init(void); int res_query(const char *dname, int classe, int type,
Utilisez -lresolv à l'édition de liens.
La fonction res_init() lit les fichiers de configuration (voir resolv.conf(5)) pour obtenir le nom de domaine par défaut, l'ordre de recherche et l'adresse du (des) serveur(s) de noms. Si aucun serveur n'est donné, on essaye de contacter l'hôte local. Si aucun domaine n'est donné, on utilise celui associé à l'hôte local. Ceci peut être surchargé par la variable d'environnement LOCALDOMAIN. res_init() est normalement exécutée lors du premier appel à l'une des autres fonctions.
La fonction res_query() interroge le serveur de noms pour le nom de domaine pleinement qualifié name du type spécifié, et de la classe donnée. La réponse est placée dans le tampon answer de longueur anslen qui doit être fourni par l'appelant.
La fonction res_search() interroge un serveur, et attend la réponse, comme res_query(), mais implémente de plus les règles de recherche et de valeurs par défaut contrôlées par RES_DEFNAMES et RES_DNSRCH (Voir les options de _res plus bas).
La fonction res_querydomain() interroge le serveur en appelant res_query() avec la concaténation de name et domain.
Les fonctions suivantes sont des routines bas-niveau utilisées par res_query().
La fonction res_mkquery() construit une requête dans buf de longueur buflen concernant le nom de domaine dname . Le type op de requête est généralement QUERY, mais on peut également utiliser l'un des types définis dans <arpa/nameser.h>. newrr ne sert à rien actuellement.
La fonction res_send() envoie une requête préformatée, située dans msg de longueur msglen et renvoie la réponse dans answer qui est de longueur anslen. Elle appellera res_init(), si ça n'a pas encore été fait.
La fonction dn_comp() compresse le nom de domaine exp_dn et le stocke dans le tampon comp_dn de longueur length. La compression utilise une table de pointeurs dnptrs vers les noms précédemment compressés du message en cours. Le premier pointeur vise le début du message, et la table se termine par NULL. La limite de la table est indiquée par lastdnptr. Si dnptr est NULL, les noms de domaines ne sont pas compressés. Si lastdnptr est NULL, la liste d'étiquettes n'est pas mise à jour.
La fonction dn_expand() développe le nom de domaine compressé comp_dn en un nom de domaine complet, qui est ensuite placé dans le tampon exp_dn de taille length. Le nom compressé est contenu dans une requête, ou dans un message de réponse, et msg pointe sur le début du message.
Les routines de résolution de noms utilisent une configuration globale et des informations d'état contenues dans la structure _res, définie dans <resolv.h>. Le seul champ habituellement manipulé par l'utilisateur est _res.options. Il contient un OU binaire entre les options suivantes :
Les fonctions res_query(), res_search(), res_querydomain(), res_mkquery() et res_send() renvoient la longueur de la réponse, ou -1 si une erreur se produit.
Les fonctions dn_comp() et dn_expand() renvoient la longueur du nom compressé, ou -1 si une erreur se produit.
/etc/resolv.conf Configuration de la résolution de noms. /etc/host.conf Configuration de la résolution de noms.
Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 6 novembre 1996 et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 resolver ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Dernière mise à jour : 17 juillet 2008