Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] gethostbyname, gethostbyaddr, sethostent, endhostent, herror, hstrerror - Obtenir des informations concernant le réseau. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <netdb.h>[/b] [b]extern int h_errno;[/b] [b][i]struct hostent gethostbyname(const char name );[/i][/b] [b]#include <sys/socket.h> /* pour avoir AF_INET /[/b] [b][i]struct hostent gethostbyaddr(const char * addr ,[/i][/b] [b][i] int len , int type );[/i][/b] [b][i]void sethostent(int stayopen );[/i][/b] [b]void endhostent(void);[/b] [b][i]void herror(const char * s );[/i][/b] [b][i]const char * hstrerror(int err );[/i][/b] 2 /* extensions GNU / [b][/b] [b][i]struct hostent gethostbyname2(const char * name , int af );[/i][/b] [b][i]int gethostbyname_r (const char * name ,[/i][/b] [b][i] struct hostent * ret , char * buf , size_t buflen ,[/i][/b] [b][i] struct hostent ** result , int * h_errnop );[/i][/b] [b][i]int gethostbyname2_r (const char * name , int af,[/i][/b] [b][i] struct hostent * ret , char * buf , size_t buflen ,[/i][/b] [b][i] struct hostent ** result , int * h_errnop );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]gethostbyname()[/b] renvoie une structure de type [i]hostent[/i] pour l'hôte [i]name[/i]. La chaîne [i]name[/i] est soit un nom d'hôte, soit une adresse IPv4 en notation pointée standard, soit une adresse IPv6 avec la notation points-virgules et points (Cf RFC 1884 pour la description des adresses IPv6). Si [i]name[/i] est une adresse IPv4 ou IPv6, aucune recherche supplémentaire n'a lieu et [b]gethostbyname ()[/b] copie simplement la chaine [i]name[/i] dans le champ [i]h_name[/i] et le champs équivalent [i]struct in_addr[/i] dans le champs [i]h_addr_list[0][/i] de la structure [i]hostent[/i] renvoyée. Si [i]name[/i] ne se termine pas par un point, et si la variable d'environnement [b]HOSTALIASES[/b] est configurée, le fichier d'alias indiqué par [b]HOSTALIASES[/b] sera d'abord parcouru à la recherche de [i]name[/i] (voir [b]hostname (7)[/b] pour le format du fichier). Le domaine courant et ses parents sont parcourus si [i]name[/i] ne se termine pas par un point. La fonction [b]gethostbyaddr()[/b] renvoie une structure du type [i]hostent[/i] pour l'hôte d'adresse [i]addr[/i]. Cette adresse est de longueur [i]len[/i] et du [i]type[/i] donné. Le seul type d'adresse valide est actuellement [b]AF_INET .[/b] La fonction [b]sethostent()[/b] indique, si [i]stayopen[/i] est vrai (vaut 1), qu'une socket TCP connectée doit être utilisée pour interroger le serveur de noms et que la connexion doit rester ouverte durant les demandes successives. Sinon l'interrogation utilisera des datagrammes UDP. La fonction [b]endhostent()[/b] ferme la socket TCP connectée utilisée pour interroger le serveur de noms du domaine. La fonction (obsolète) [b]herror()[/b] affiche le message d'erreur associé avec la valeur courante de [i]h_errno[/i] sur la sortie standard stderr. La fonction (obsolète) [b]herror()[/b] reçoit un numéro d'erreur en argument (typiquement [i]h_errno[/i]) et renvoit la chaîne de message d'erreur. Les interrogations du serveur de noms effectuées par [b]gethostbyname()[/b] et [b]gethostbyaddr()[/b] utilisent les éléments suivants : le serveur de noms [b]named[/b](8), les lignes de [i]/etc/hosts[/i], et l'annuaire Network Information Service (NIS ou YP), suivant le contenu de la ligne [i]order[/i] du fichier [i]/etc/host.conf[/i]. (Voir [b]resolv+ (8)).[/b] L'action par défaut consiste à interroger [b]named[/b](8), puis [i]/etc/hosts[/i]. La structure [i]hostent[/i] est définie ainsi dans [i]<netdb.h>[/i] : [table][row][col]    [/col][col] .nf .ne 7 .ta 8n 16n 32n struct hostent { char h_name; / Nom officiel de l'hôte. / char h_aliases; / Liste d'alias. / int h_addrtype; / Type d'adresse de l'hôte. / int h_length; / Longueur de l'adresse. / char h_addr_list; / Liste d'adresses. / } #define h_addr h_addr_list[0] / pour compatibilité. / .ta .fi[/col][/row][/table] Les membres de la structure [i]hostent[/i] sont : [i]h_name[/i] [table][row][col]    [/col][col]Nom officiel de l'hôte.[/col][/row][/table] [i]h_aliases[/i] [table][row][col]    [/col][col]Une table, terminée par zéro, d'alternatives au nom officiel de l'hôte.[/col][/row][/table] [i]h_addrtype[/i] [table][row][col]    [/col][col]Le type d'adresse (actuellement, toujours [b]AF_INET ).[/b] [/col][/row][/table] [i]h_length[/i] [table][row][col]    [/col][col]La longueur, en octets, de l'adresse.[/col][/row][/table] [i]h_addr_list[/i] [table][row][col]    [/col][col]Une table, terminée par zéro, d'adresses réseau pour l'hôte, avec l'ordre des octets du réseau.[/col][/row][/table] [i]h_addr[/i] [table][row][col]    [/col][col]La première adresse dans [i]h_addr_list[/i] pour respecter la compatibilite ascendante.[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] Les fonctions [b]gethostbyname()[/b] et [b]gethostbyaddr()[/b] renvoient un pointeur sur la structure [i]hostent[/i], ou bien un pointeur NULL si une erreur se produit, auquel cas [i]h_errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] La variable [i]h_errno[/i] peut prendre les valeurs suivantes : [b]HOST_NOT_FOUND[/b] [table][row][col]    [/col][col]L'hôte indiqué est inconnu.[/col][/row][/table] [b]NO_ADDRESS ou NO_DATA [/b] [table][row][col]    [/col][col]Le nom est valide mais ne possède pas d'adresse IP.[/col][/row][/table] [b]NO_RECOVERY[/b] [table][row][col]    [/col][col]Une erreur fatale du serveur de noms est apparue.[/col][/row][/table] [b]TRY_AGAIN[/b] [table][row][col]    [/col][col]Une erreur temporaire du serveur de noms est apparue, essayez un peu plus tard.[/col][/row][/table] [size=18] [b]Fichiers[/b] [/size] [i]/etc/host.conf[/i] [table][row][col]    [/col][col]Fichier de configuration de la résolution de noms.[/col][/row][/table] [i]/etc/hosts[/i] [table][row][col]    [/col][col]Base de données des hôtes.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] BSD 4.3 [size=18] [b]Notes[/b] [/size] Les spécifications SUS-v2 déclarent - à tort - le paramètre [i]len[/i] de [b]gethostbyaddr()[/b] de type [b]size_t .[/b] (Ceci est erroné car il doit obligatoirement être un [b]int ,[/b] ce que [i]size_t[/i] n'est pas toujours. POSIX 1003.1-2001 le déclare [b]socklen_t ,[/b] ce qui est correct).     Les fonctions [b]gethostbyname () [/b] et [b]gethostbyaddr () [/b] peuvent renvoyer des pointeurs sur des données statiques susceptibles d'être écrasées d'un appel à l'autre. Copier la structure [i]struct hostent[/i] ne suffit pas car elle contient elle-même des pointeurs. Une copie en profondeur est indispensable.     La GlibC 2 propose aussi une fonction [b]gethostbyname2()[/b] qui agit comme [b]gethostbyname() ,[/b] qui permet de préciser la famille à laquelle l'adresse doit appartenir.     La GlibC 2 propose aussi les versions réentrantes [b]gethostbyname_r()[/b] et [b]gethostbyname2_r() .[/b] Elles renvoient zéro si elles réussissent et une valeur non-nulle en cas d'erreur. Le résultat de l'appel est stocké dans la structure d'adresse [b]ret .[/b] Après l'appel, [i] result[/i] vaudra NULL en cas d'erreur, ou pointera sur le résultat. Des données auxiliaires seront stockées dans le buffer [i]buf[/i] de longueur [b]buflen .[/b] (Si le buffer est trop petit, ces fonctions renverront [b]ERANGE ).[/b] La variable [i]h_errno[/i] n'est pas modifiée, mais l'adresse d'une variable où stocker le code d'erreur est transmis dans [b]h_errnop .[/b] POSIX 1003.1-2001 indique [b]gethostbyaddr()[/b] et [b]gethostbyname()[/b] comme légaux, et introduit .nf [b][i]struct hostent * getipnodebyaddr (const void * restrict addr ,[/i][/b] [b][i] socklen_t len , int type , int * restrict error_num );[/i][/b] [b][i]struct hostent getipnodebyname (const char name ,[/i][/b] [b][i] int type , int flags , int * error_num );[/i][/b] [size=18] [b]Voir aussi[/b] [/size] [b]resolver (3),[/b] [b]hosts (5), [/b] [b]hostname (7),[/b] [b]resolv+ (8),[/b] [b]named (8).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier