NOM¶

getipnodebyname, getipnodebyaddr, freehostent - Obtenir les adresses réseau et noms d'hôte

SYNOPSIS¶

#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>

struct hostent *getipnodebyname(const char *name, int af,
                                int flags, int *error_num);

struct hostent *getipnodebyaddr(const void *addr, size_t len,
                                int af, int *error_num);

void freehostent(struct hostent *ip);

DESCRIPTION¶

Ces fonctions sont déconseillées (et ne sont pas disponibles dans la glibc). Utilisez getaddrinfo(3) et getnameinfo(3) à la place.

Les fonctions getipnodebyname() et getipnodebyaddr() renvoient le nom et l'adresse réseau d'un hôte. Ces fonctions renvoient un pointeur sur une structure définie comme suit :

struct  hostent {


    char  *h_name;


    char **h_aliases;


    int    h_addrtype;


    int    h_length;


    char **h_addr_list;
};

Ces fonctions remplacent les fonctions gethostbyname(3) et gethostbyaddr(3) qui ne pouvaient qu'accéder aux adresses réseau de la famille IPv4. Les fonctions getipnodebyname() et getipnodebyaddr() peuvent fonctionner avec diverses familles d'adresses réseau.

Contrairement aux fonctions du type gethostby, ces routines renvoient des pointeurs sur des zones de mémoires allouées dynamiquement. La fonction freehostent() sert à libérer la zone de mémoire allouée dynamiquement une fois que l'on n'a plus besoin des informations se trouvant dans la structure hostent.

VALEUR RENVOYÉE¶

En cas d'erreur, un pointeur NULL est renvoyé, et error_num contiendra un code d'erreur parmi les suivants :

HOST_NOT_FOUND

Le nom d'hôte ou l'adresse réseau n'ont pas été trouvés.

NO_ADDRESS

Le serveur de noms reconnaît l'adresse réseau ou le nom, mais n'a pas fourni de réponse. Ceci peut se produire si l'hôte n'a que des adresse IPv4, et qu'on a demandé uniquement des informations IPv6, ou l'inverse.

NO_RECOVERY

Le serveur de noms a renvoyé une erreur définitive.

TRY_AGAIN

Le serveur de noms a renvoyé une erreur temporaire. Réessayez plus tard.

Une recherche couronnée de succès renvoie un pointeur sur une structure hostent contenant les champs suivants :

h_name

Nom officiel de l'hôte.

h_aliases

Table de pointeurs vers des alias non officiels du même hôte. La table est terminée par un pointeur NULL.

h_addrtype

Il s'agit d'une copie du paramètre af de getipnodebyname() ou getipnodebyaddr(). h_addrtype sera toujours AF_INET si le paramètre af était AF_INET. h_addrtype sera toujours AF_INET6 si le paramètre af était AF_INET6.

h_length

Ce champ sera défini à sizeof(struct in_addr) si h_addrtype est AF_INET, et sizeof(struct in6_addr) si h_addrtype vaut AF_INET6.

h_addr_list

Il s'agit d'une table de pointeurs vers les structures d'adresse de l'hôte. La table est terminée par un pointeur NULL.

CONFORMITɶ

RFC 2553

NOTES¶

Ces fonctions étaient présentes dans la glibc 2.1.91-95, mais en ont été retirées. Plusieurs systèmes de type Unix les supportent, mais tous les considèrent comme déconseillées.

VOIR AUSSI¶

getaddrinfo(3), getnameinfo(3), inet_ntop(3), inet_pton(3)

COLOPHON¶

Cette page fait partie de la publication 3.23 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION¶

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <URL:http://alioth.debian.org/projects/perkamon/>.

Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-l10n-fr@lists.alioth.debian.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».