INET

Index

NOM
SYNOPSIS
DESCRIPTION
NOTE
NOTES GLIBC
CONFORMITÉ À
VOIR AUSSI
TRADUCTION

NOM

inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof - Routines de manipulation d'adresses Internet

SYNOPSIS

#include <sys/socket.h>
#include <netinet/in.h>
#include <arpa/inet.h>

int inet_aton(const char *cp, struct in_addr *inp);

in_addr_t inet_addr(const char *cp);

in_addr_t inet_network(const char *cp);

char *inet_ntoa(struct in_addr in);

struct in_addr inet_makeaddr(int net, int host);

in_addr_t inet_lnaof(struct in_addr in);

in_addr_t inet_netof(struct in_addr in);

DESCRIPTION

inet_aton() convertit l'adresse Internet de l'hôte cp depuis la notation standard avec nombres et points en une donnée binaire, et la stocke dans la structure pointée par inp. inet_aton() renvoie une valeur non nulle si l'adresse est valide, et zéro sinon.
La fonction inet_addr() convertit l'adresse Internet de l'hôte cp depuis la notation standard avec nombres et points en une donnée binaire dans l'ordre des octets du réseau. Si l'adresse est invalide, INADDR_NONE (généralement -1) est renvoyé. Ceci est une interface obsolète pour la fonction inet_aton(), décrite ci-dessus, car -1 est une adresse valide (255.255.255.255), et inet_aton() utilise un renvoi d'erreur plus propre.
La fonction inet_network() extrait la partie réseau de l'adresse cp fournie dans la notation avec nombres et points, et renvoie cette valeur dans l'ordre des octets de l'hôte. Si l'adresse est invalide, -1 est renvoyé.
La fonction inet_ntoa() convertit l'adresse Internet de l'hôte in donne dans l'ordre des octets du réseau en une chaîne de caractères dans la notation avec nombres et points. La chaîne est renvoyée dans un tampon alloué statiquement, qui est donc écrasé à chaque appel.
La fonction inet_makeaddr() crée une adresse d'hôte Internet dans l'ordre des octets du réseau, en combinant le numéro du réseau net et l'adresse locale host du réseau net, chacun d'eux étant donné dans l'ordre des octets de l'hôte.
La fonction inet_lnaof() renvoie la partie de l'adresse locale extraite d'une adresse Internet in. L'adresse locale est renvoyée dans l'ordre des octets de l'hôte.
La fonction inet_netof() renvoie la partie du numéro de réseau extraite d'une adresse Internet in. Le numéro de réseau est renvoyé dans l'ordre des octets de l'hôte.
La structure in_addr utilisée dans inet_ntoa(), inet_makeaddr(), inet_lnoaf() et inet_netof() est définie ainsi dans netinet/in.h :


   struct in_addr {
        unsigned long int s_addr;
    }

Notez que l'ordre des octets des machines i80x86 est « LSB » (poids faible en premier, « little endian »), alors que l'ordre des octets sur internet est « MSB » (poids fort en premier ou « big endian »).

NOTE

Lors de l'utilisation de nombres et de points pour la notation des adresses, sachez que chaque nombre est interprété sous forme octale s'il commence par un « 0 » et sous forme hexadécimale s'il commence par « 0x ». Par exemple, inet_aton("226.000.000.037", &t) interprète l'adresse comme 226.0.0.31 et non 226.0.0.37.

NOTES GLIBC

Afin d'avoir la déclaration de inet_aton(), l'une des macros de test _BSD_SOURCE, _SVID_SOURCE ou _GNU_SOURCE doit être définie.

CONFORMITÉ À

BSD 4.3. inet_addr(), inet_aton(), et inet_ntoa() sont spécifiées dans POSIX.1-2001.

VOIR AUSSI

gethostbyname(3), getnetent(3), inet_ntop(3), inet_pton(3), hosts(5), networks(5)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007