.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2002 Ian Redfern (redferni@logica.com)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     FreeBSD 4.4 man pages
.\"
.\" Minor additions, aeb, 2013-06-21
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ether_aton 3 "5 février 2023" "Pages du manuel de Linux 6.03" 
.SH NOM
ether_aton, ether_ntoa, ether_ntohost, ether_hosttonn, ether_line,
ether_ntoa_r, ether_aton_r \- Routines de manipulation d'adresses Ethernet
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <netinet/ether.h>\fP
.PP
\fBchar *ether_ntoa(const struct ether_addr *\fP\fIaddr\fP\fB);\fP
\fBstruct ether_addr *ether_aton(const char *\fP\fIasc\fP\fB);\fP
.PP
\fBint ether_ntohost(char *\fP\fIhostname\fP\fB, const struct ether_addr *\fP\fIaddr\fP\fB);\fP
\fBint ether_hostton(const char *\fP\fIhostname\fP\fB, struct ether_addr *\fP\fIaddr\fP\fB);\fP
.PP
\fBint ether_line(const char *\fP\fIline\fP\fB, struct ether_addr *\fP\fIaddr\fP\fB,\fP
\fB               char *\fP\fIhostname\fP\fB);\fP
.PP
/* Extensions GNU */
\fBchar *ether_ntoa_r(const struct ether_addr *\fP\fIaddr\fP\fB, char *\fP\fIbuf\fP\fB);\fP
.PP
\fBstruct ether_addr *ether_aton_r(const char *\fP\fIasc\fP\fB,\fP
\fB                                struct ether_addr *\fP\fIaddr\fP\fB);\fP
.fi
.SH DESCRIPTION
\fBether_aton\fP() convertit une adresse d'hôte Ethernet sur 48\-bits \fIasc\fP 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. \fBether_aton\fP() renvoie NULL si l'adresse n’est pas valable.
.PP
La fonction \fBether_ntoa\fP() convertit l'adresse d'hôte Ethernet \fIaddr\fP 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.
.PP
La fonction \fBether_ntohost\fP() met en correspondance une adresse Ethernet
avec un nom d'hôte trouvé dans \fI/etc/ethers\fP et renvoie une valeur non
nulle si elle ne trouve rien.
.PP
La fonction \fBether_hostton\fP() met en correspondance un nom d'hôte et une
adresse Ethernet de \fI/etc/ethers\fP et renvoie une valeur non nulle si elle
ne trouve aucune correspondance.
.PP
La fonction \fBether_line\fP() examine une ligne dans le format de
\fI/etc/ethers\fP (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
\fIhostname\fP doit être assez grand, par exemple avoir la même longueur que la
ligne \fIline\fP.
.PP
Les fonctions \fBether_ntoa_r\fP() et \fBether_aton_r\fP() sont les versions
réentrantes et multithread sûres de \fBether_ntoa\fP() et \fBether_aton\fP()
respectivement, et n'utilisent pas de tampons statiques.
.PP
La structure \fIether_addr\fP est définie dans \fI<net/ethernet.h>\fP
ainsi\ :
.PP
.in +4n
.EX
struct ether_addr {
    uint8_t ether_addr_octet[6];
}
.EE
.in
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
\fBether_aton\fP(),
\fBether_ntoa\fP()
T}	Sécurité des threads	MT\-Unsafe
T{
\fBether_ntohost\fP(),
\fBether_hostton\fP(),
\fBether_line\fP(),
\fBether_ntoa_r\fP(),
\fBether_aton_r\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.hy
.ad
.sp 1
.SH STANDARDS
4.3BSD, SunOS.
.SH BOGUES
.\" The fix was presumably commit c0a0f9a32c8baa6ab93d00eb42d92c02e9e146d7
.\" which was in glibc 2.3
Dans la glibc 2.2.5 et antérieures , l'implémentation de \fBether_line\fP() est
erronée.
.SH "VOIR AUSSI"
\fBethers\fP(5)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.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.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>
et
David Prévot <david@tilapin.org>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .