.\" -*- coding: UTF-8 -*- .\" Copyright 2000 Sam Varshavchik .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References: RFC 2553 .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getipnodebyname 3 "30 mars 2023" "Pages du manuel de Linux 6.05.01" .SH NOM getipnodebyname, getipnodebyaddr, freehostent \- Obtenir les adresses réseau et noms d'hôte .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP \fB#include \fP \fB#include \fP .PP \fB[[obsolète]] struct hostent *getipnodebyname(const char *\fP\fIname\fP\fB, int \fP\fIaf\fP\fB,\fP \fB int \fP\fIflags\fP\fB, int *\fP\fIerror_num\fP\fB);\fP \fB[[obsolète]] struct hostent *getipnodebyaddr(const void \fP\fIaddr\fP\fB[.\fP\fIlen\fP\fB],\fP \fB size_t \fP\fIlen\fP\fB, int \fP\fIaf\fP\fB,\fP \fB int *\fP\fIerror_num\fP\fB);\fP \fB[[obsolète]] void freehostent(struct hostent *\fP\fIip\fP\fB);\fP .fi .SH DESCRIPTION Ces fonctions sont déconseillées (et ne sont pas disponibles dans la glibc). Utilisez \fBgetaddrinfo\fP(3) et \fBgetnameinfo\fP(3) à la place. .PP Les fonctions \fBgetipnodebyname\fP() et \fBgetipnodebyaddr\fP() renvoient le nom et l'adresse réseau d'un hôte. Ces fonctions renvoient un pointeur sur une structure définie comme suit\ : .PP .in +4n .EX struct hostent { char *h_name; char **h_aliases; int h_addrtype; int h_length; char **h_addr_list; }; .EE .in .PP Ces fonctions remplacent les fonctions \fBgethostbyname\fP(3) et \fBgethostbyaddr\fP(3) qui ne pouvaient qu'accéder aux adresses réseau de la famille IPv4. Les fonctions \fBgetipnodebyname\fP() et \fBgetipnodebyaddr\fP() peuvent fonctionner avec diverses familles d'adresses réseau. .PP Contrairement aux fonctions du type \fBgethostby\fP, ces routines renvoient des pointeurs sur des zones de mémoires allouées dynamiquement. La fonction \fBfreehostent\fP() sert à libérer la zone de mémoire allouée dynamiquement une fois que les informations se trouvant dans la structure \fIhostent\fP ne sont plus nécessaires. .SS "Paramètres de getipnodebyname()" La fonction \fBgetipnodebyname\fP() recherche l'adresse réseau de l'hôte indiqué dans son argument \fIname\fP. Le paramètre \fIaf\fP prend l'une des valeurs suivantes\ : .TP \fBAF_INET\fP Le paramètre \fIname\fP représente une adresse décimale pointée IPv4, ou le nom d'un hôte sur un réseau IPv4. .TP \fBAF_INET6\fP Le paramètre \fIname\fP représente une adresse hexadécimale IPv6, ou le nom d'un hôte sur un réseau IPv6. .PP Le paramètre \fIflags\fP indique des options supplémentaires. Plusieurs options peuvent être indiquées en les groupant avec un OU binaire. \fIflags\fP doit être mis à 0 si aucune option n'est souhaitée. .TP \fBAI_V4MAPPED\fP Cet attribut est utilisé avec \fBAF_INET6\fP pour demander de rechercher une adresse IPv4 plutôt qu'une IPv6. L'adresse IPv4 devra toutefois être projetée dans l'espace IPv6. .TP \fBAI_ALL\fP Cet attribut est utilisé avec \fBAI_V4MAPPED\fP pour demander une recherche simultanée d'adresses IPv4 et IPv6. Toute adresse IPv4 trouvée sera projetée dans l'espace IPv6. .TP \fBAI_ADDRCONFIG\fP Cet attribut est utilisé avec \fBAF_INET6\fP pour indiquer que les requêtes ultérieures d'adresses IPv6 n'auront pas lieu à moins que le système n'ait au moins une adresse IPv6 affectée à une interface réseau. Symétriquement, les requêtes d'adresses IPv4 n'auront lieu que si le système dispose au moins d'une adresse IPv4 affectée à une interface réseau. Cet attribut peut être utilisé seul ou avec \fBAI_V4MAPPED\fP. .TP \fBAI_DEFAULT\fP Cet attribut est équivalent à \fB(AI_ADDRCONFIG | AI_V4MAPPED)\fP. .SS "Paramètres de getipnodebyaddr()" La fonction \fBgetipnodebyaddr\fP() recherche le nom d'un hôte dont l'adresse réseau est indiquée par l'argument \fIaddr\fP. Le paramètre \fIaf\fP prend l'une des valeurs suivantes\ : .TP \fBAF_INET\fP Le paramètre \fIaddr\fP pointe vers une structure \fIstruct in_addr\fP et \fIlen\fP doit valoir \fIsizeof(struct in_addr)\fP. .TP \fBAF_INET6\fP Le paramètre \fIaddr\fP pointe vers une structure \fIstruct in6_addr\fP et \fIlen\fP doit valoir \fIsizeof(struct in6_addr)\fP. .SH "VALEUR RENVOYÉE" En cas d'erreur, un pointeur NULL est renvoyé, et \fIerror_num\fP contiendra un code d'erreur parmi les suivants\ : .TP \fBHOST_NOT_FOUND\fP Le nom d'hôte ou l'adresse réseau n'ont pas été trouvés. .TP \fBNO_ADDRESS\fP Le serveur de noms reconnaît l'adresse réseau ou le nom, mais n'a pas fourni de réponse. Cela peut se produire si l'hôte n'a que des adresses IPv4, et que seules des informations IPv6 ont été demandées, ou l'inverse. .TP \fBNO_RECOVERY\fP Le serveur de noms a renvoyé une erreur définitive. .TP \fBTRY_AGAIN\fP Le serveur de noms a renvoyé une erreur temporaire. Réessayez plus tard. .PP Une recherche couronnée de succès renvoie un pointeur sur une structure \fIhostent\fP contenant les champs suivants\ : .TP \fIh_name\fP Nom officiel de l'hôte. .TP \fIh_aliases\fP Table de pointeurs vers des alias non officiels du même hôte. La table est terminée par un pointeur NULL. .TP \fIh_addrtype\fP Il s'agit d'une copie du paramètre \fIaf\fP de \fBgetipnodebyname\fP() ou \fBgetipnodebyaddr\fP(). \fIh_addrtype\fP sera toujours \fBAF_INET\fP si le paramètre \fIaf\fP était \fBAF_INET\fP. \fIh_addrtype\fP sera toujours \fBAF_INET6\fP si le paramètre \fIaf\fP était \fBAF_INET6\fP. .TP \fIh_length\fP Ce champ sera défini à \fIsizeof(struct in_addr)\fP si \fIh_addrtype\fP est \fBAF_INET\fP, et \fIsizeof(struct in6_addr)\fP si \fIh_addrtype\fP vaut \fBAF_INET6\fP. .TP \fIh_addr_list\fP 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. .SH STANDARDS Aucune. .SH HISTORIQUE .\" Not in POSIX.1-2001. RFC\ 2553. .PP Présentes dans la glibc 2.1.91\-95, mais elle en ont été retirées. Plusieurs systèmes de type UNIX les prennent en charge, mais tous les considèrent comme déconseillées. .SH "VOIR AUSSI" \fBgetaddrinfo\fP(3), \fBgetnameinfo\fP(3), \fBinet_ntop\fP(3), \fBinet_pton\fP(3) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .