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);
DESCRIPTION¶
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 n’est
pas valable.
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 multithread 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];
}
ATTRIBUTS¶
Multithreading (voir pthreads(7))¶
Les fonctions
ether_aton() et
ether_ntoa() ne sont pas
sûres dans un contexte multithread.
Les fonctions
ether_ntohost(),
ether_hostton(),
ether_line(),
ether_ntoa_r() et
ether_aton_r() sont
sûres dans un contexte multithread.
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.65 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¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
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 à
<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> ».