ether_aton(3) Library Functions Manual ether_aton(3)
NOM
ether_aton, ether_ntoa, ether_ntohost, ether_hosttonn, ether_line,
ether_ntoa_r, ether_aton_r - Routines de manipulation d'adresses Ether-
net
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
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 don-
né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 tam-
pon 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éen-
trantes et multithread sûres de ether_ntoa() et ether_aton() respecti-
vement, 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
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌───────────────────────────────────┬──────────────────────┬───────────┐
│Interface │ Attribut │ Valeur │
├───────────────────────────────────┼──────────────────────┼───────────┤
│ether_aton(), ether_ntoa() │ Sécurité des threads │ MT-Unsafe │
├───────────────────────────────────┼──────────────────────┼───────────┤
│ether_ntohost(), ether_hostton(), │ Sécurité des threads │ MT-Safe │
│ether_line(), ether_ntoa_r(), │ │ │
│ether_aton_r() │ │ │
└───────────────────────────────────┴──────────────────────┴───────────┘
STANDARDS
4.3BSD, SunOS.
BOGUES
Dans la glibc 2.2.5 et antérieures , l'implémentation de ether_line()
est erronée.
VOIR AUSSI
ethers(5)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org> et David Prévot <david@tilapin.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 5 février 2023 ether_aton(3)
Generated by dwww version 1.15 on Sat Jun 29 00:26:23 CEST 2024.