Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] resolver, res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand - Routines de résolution de noms. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <netinet/in.h>[/b] [b]#include <arpa/nameser.h>[/b] [b]#include <resolv.h>[/b] [b]extern struct state _res;[/b] [b]int res_init (void);[/b] [b][i]int res_query (const char * dname , int classe , int type ,[/i][/b][table][row][col]    [/col][col] [b][i]unsigned char * answer , int anslen );[/i][/b][/col][/row][/table] [b][i]int res_search (const char * dname , int classe , int type ,[/i][/b][table][row][col]    [/col][col] [b][i]unsigned char * answer , int anslen );[/i][/b][/col][/row][/table] [b][i]int res_querydomain (const char * name , const char * domain ,[/i][/b][table][row][col]    [/col][col] [b][i]int classe , int type , unsigned char * answer , int anslen );[/i][/b][/col][/row][/table] [b][i]int res_mkquery (int op , const char * dname , int classe , int type ,[/i][/b][table][row][col]    [/col][col] [b][i]char * data , int datalen , struct rrec * newrr , char * buf , [/i][/b] [b][i]int buflen );[/i][/b][/col][/row][/table] [b][i]int res_send (const char * msg , int msglen , char * answer , [/i][/b][table][row][col]    [/col][col] [b][i]int anslen );[/i][/b][/col][/row][/table] [b][i]int dn_comp (unsigned char * exp_dn , unsigned char * comp_dn ,[/i][/b][table][row][col]    [/col][col] [b][i]int length , unsigned char ** dnptrs , unsigned char * exp_dn ,[/i][/b] [b][i]unsigned char ** lastdnptr );[/i][/b][/col][/row][/table] [b][i]int dn_expand (unsigned char * msg , unsigned char * eomorig ,[/i][/b][table][row][col]    [/col][col] [b][i]unsigned char * comp_dn , unsigned char * exp_dn , int length );[/i][/b][/col][/row][/table] .fi [size=18] [b]Description[/b] [/size] Ces fonctions interrogent, et interprètent les réponses de serveurs de noms Internet. La fonction [b]res_init()[/b] lit les fichiers de configuration (voir resolv+(8)) 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. [b]res_init()[/b] est normalement exécutée lors du premier appel à l'une des autres fonctions. La fonction [b]res_query()[/b] interroge le serveur de noms pour le nom de domaine pleinement qualifié [i]name[/i] du [i]type[/i] spécifié, et de la [i]classe[/i] donnée. La réponse est placée dans le buffer [i]answer[/i] de longueur [i]anslen[/i] qui doit être fourni par l'appelant. La fonction [b]res_search()[/b] interroge un serveur, et attend la réponse, comme [b]res_query()[/b], 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 [i]_res[/i] plus bas). La fonction [b]res_querydomain()[/b] interroge le serveur en appelant [b]res_query()[/b] avec la concaténation de [i]name[/i] et [i]domain[/i]. Les fonctions suivantes sont des routines bas-niveau utilisées par [b]res_query()[/b]. La fonction [b]res_mkquery()[/b] construit une requête dans [i]buf[/i] de longueur [i]buflen[/i] concernant le nom de domaine [i]dname[/i]. Le type [i]op[/i] de requête est généralement QUERY, mais on peut également utiliser l'un des types définis dans [i]<arpa/nameser.h>[/i]. [i]newrr[/i] ne sert à rien actuellemennt. La fonction [b]res_send()[/b] envoie une requête préformatée, située dans [i]msg[/i] de longueur [i]msglen[/i] et renvoie la réponse dans [i]answer[/i] qui est de longueur [i]anslen[/i]. Elle appellera [b]res_init()[/b], si ça n'a pas encore été fait. La fonction [b]dn_comp()[/b] compresse le nom de domaine [i]exp_dn[/i] et le stocke dans le buffer [i]comp_dn[/i] de longueur [i]length[/i]. La compression utilise une table de pointeurs [i]dnptrs[/i] 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 [i]lastdnptr[/i]. Si [i]dnptr[/i] est NULL, les noms de domaines ne sont pas compressés. Si [i]lastdnptr[/i] est NULL, la liste d'étiquettes n'est pas mise à jour. La fonction dn_expand() développe le nom de domaine compressé [i]comp_dn[/i] en un nom de domaine complet, qui est ensuite placé dans le buffer [i]exp_dn[/i] de taille [i]length[/i]. Le nom compressé est contenu dans une requête, ou dans un message de réponse, et [i]msg[/i] 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 [i]_res[/i], définie dans [i]<resolv.h>[/i]. Le seul champ habituellement manipulé par l'utilisateur est [i]_res.options[/i]. Il contient un [i]OU[/i] binaire entre les options suivantes : [b]RES_INIT[/b] [table][row][col]    [/col][col]Vrai si [b]res_init()[/b] a été appelé.[/col][/row][/table] [b]RES_DEBUG[/b] [table][row][col]    [/col][col]Afficher les messages de débugging.[/col][/row][/table] [b]RES_AAONLY[/b] [table][row][col]    [/col][col]N'accepter que les réponses des serveurs autoritatifs ([NDT] "autoritatif" est un barbarisme, voir "L'administration réseau sous Linux" chapitre 2.6.4 pour une justification de son emploi) [b]res_send()[/b] continue jusqu'à trouver un serveur autoritatif, ou renvoie une erreur. Pas encore implémenté.[/col][/row][/table] [b]RES_USEVC[/b] [table][row][col]    [/col][col]Utiliser des connexions TCP pour les interrogations plutôt que des datagrammes UDP.[/col][/row][/table] [b]RES_PRIMARY[/b] [table][row][col]    [/col][col]N'interroger que le serveur de domaines primaire.[/col][/row][/table] [b]RES_IGNTC[/b] [table][row][col]    [/col][col]Ignorer les erreurs de troncature. Ne pas ré-essayer avec TCP. Pas encore implémenté.[/col][/row][/table] [b]RES_RECURSE[/b] [table][row][col]    [/col][col]Fixer dans les requêtes le bit de récursion. La récursion est prise en charge par le serveur de nom du domaine, et pas par [b]res_send()[/b]. [Active par défaut].[/col][/row][/table] [b]RES_DEFNAMES[/b] [table][row][col]    [/col][col][b]res_search()[/b] ajoutera le nom de domaine par défaut aux noms simples, par exemple ceux ne contenant pas de point. [Active par defaut].[/col][/row][/table] [b]RES_STAYOPEN[/b] [table][row][col]    [/col][col]Utilisée avec RES_USEVC pour garder ouverte une connexion TCP entre les interrogations successives.[/col][/row][/table] [b]RES_DNSRCH[/b] [table][row][col]    [/col][col][b]res_search()[/b] recherchera les noms d'hôtes dans le domaine courant, et dans les domaines parents. Cette option est utilisée par [b]gethostbyname (3).[/b] [Active par défaut].[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]res_init()[/b] renvoie 0 si elle réussit, ou -1 si une erreur se produit. Les fonctions [b]res_query()[/b], [b]res_search()[/b], [b]res_querydomain()[/b], [b]res_mkquery()[/b] et [b]res_send()[/b] renvoient la longueur de la réponse, ou -1 si une erreur se produit. Les fonctions [b]dn_comp()[/b] et [b]dn_expand()[/b] renvoient la longueur du nom compressé, ou -1 si une erreur se produit. [size=18] [b]Fichiers[/b] [/size] .nf /etc/resolv.conf Configuration de la résolution de noms. /etc/host.conf Configuration de la résolution de noms. .fi [size=18] [b]Conformité[/b] [/size] BSD 4.3 [size=18] [b]Voir aussi[/b] [/size] [b]gethostbyname (3),[/b] [b]hostname (7),[/b] [b]named (8),[/b] [b]resolv+ (8)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier