NOM
ether_aton, ether_ntoa, ether_ntohost, ether_hosttonn, ether_line,
ether_ntoa_r, ether_aton_r - Routines de manipulation d’adresses
Ethernet
SYNOPSIS
#include <netinet/ether.h>
char *ether_ntoa(const struct ether_addr *addr);
struct ether_addr *ether_aton(const char *asc);
int ether_ntohost(char *hostname, const struct ether_addr *addr);
int ether_hostton(const char *hostname, struct ether_addr *addr);
int ether_line(const char *line, struct ether_addr *addr,
char *hostname);
/* Extensions GNU */
char *ether_ntoa_r(const struct ether_addr *addr, char *buf);
struct ether_addr *ether_aton_r(const char *asc,
struct ether_addr *addr);
ether_aton() convertit une adresse d’hôte Ethernet sur 48-bits asc de
la notation « standard hexadécimal et séparateurs deux-points » en
données binaire dans l’ordre des octets du réseau et renvoie un
pointeur dans un tampon alloué de manière statique, que les appels
ultérieurs écraseront. ether_aton() renvoie NULL si l’adresse est
invalide.
La fonction ether_ntoa() convertit l’adresse d’hôte Ethernet addr dans
l’ordre des octets du réseau en une chaîne dans la notation standard
«hexadécimal et deux-points », en omettant les zéros en tête. La chaîne
est renvoyée dans un tampon alloué statiquement, que les appels
ultérieurs écraseront.
La fonction ether_ntohost() met en correspondance une adresse Ethernet
avec un nom d’hôte trouvé dans /etc/ethers et renvoie une valeur non
nulle si elle ne trouve rien.
La fonction ether_hostton() met en correspondance un nom d’hôte et une
adresse Ethernet de /etc/ethers et renvoie une valeur non nulle si elle
ne trouve aucune correspondance.
La fonction ether_line() examine une ligne dans le format de
/etc/ethers (adresse Ethernet suivi de blancs et d’un nom d’hôte ; « #»
introduit un commentaire) et renvoie une paire adresse et nom d’hôte,
ou une valeur non nulle si le fichier ne peut être lu. Le tampon pointé
par hostname doit être assez grand, par exemple avoir la même longueur
que la ligne line.
Les fonctions ether_ntoa_r() et ether_aton_r() sont les versions
ré-entrantes et multi-threads sûres de ether_ntoa() et ether_aton()
respectivement, et n’utilisent pas de tampons statiques.
La structure ether_addr est définie dans <net/ethernet.h> ainsi :
struct ether_addr {
uint8_t ether_addr_octet[6];
}
CONFORMITÉ
4.3BSD, SunOS.
BOGUES
L’implémentation de ether_line() dans la glibc 2.2.5 est erronée.
VOIR AUSSI
ethers(5)
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
http://www.kernel.org/doc/man-pages/.
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, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou 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> ».