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.

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.57 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> ».