.\" -*- coding: UTF-8 -*-
.\" Copyright 2002 Ian Redfern (redferni@logica.com)
.\"
.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.\" 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 "15 Septiembre 2017" GNU "Manual del Programador de Linux"
.SH NOMBRE
ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line,
ether_ntoa_r, ether_aton_r \- rutinas de manipulación de direcciones Ethernet
.SH SINOPSIS
.nf
\fB#include <netinet/ether.h>\fP
.PP
\fBchar *ether_ntoa(const struct ether_addr *\fP\fIaddr\fP\fB);\fP
.PP
\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
.PP
\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
/* extensiones de GNU */
.br
\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 DESCRIPCIÓN
\fBether_aton\fP() convierte la dirección de host Ethernet de 48 bits \fIasc\fP en
la notación estándar de dígitos\-hexadecimales\-y\-puntos a datos binarios en
el orden de bytes de la red y devuelve un puntero a éstos en un buffer
reservado estáticamente, que será sobreescrito por llamadas
posteriores. \fBether_aton\fP() devuelve NULL si la dirección no es válida.
.PP
La función \fBether_ntoa\fP() convierte la dirección de host Ethernet \fIaddr\fP
dada en el orden de bytes de la red a una cadena en la notación estándar de
dígitos\-hexadecimales\-y\-puntos, omitiendo los ceros del principio. La cadena
se devuelve en almacenamiento estático, que será sobreescrito por llamadas
posteriores.
.PP
La función \fBether_ntohost\fP() asocia una dirección Ethernet con su
correspondiente nombre de host en \fI/etc/ethers\fP y devuelve un valor
distinto de cero si no se encontró ninguna correspondencia.
.PP
La función \fBether_hostton\fP() asocia un nombre de host con su
correspondiente dirección Ethernet en \fI/etc/ethers\fP y devuelve un valor
distinto de cero si no se encontró ninguna correspondencia.
.PP
La función \fBether_line\fP() analiza una línea con el formato de
\fI/etc/ethers\fP (dirección ethernet seguida de espacios y seguida por el
nombre de host; \(aq#\(aq introduce un comentario) y devuelve un par
dirección \- nombre de host, o un valor distinto de cero si no pudo ser
analizada. El buffer apuntado por \fIhostname\fP debe ser suficientemente
grande, p.e., tener la misma longitud que \fIline\fP.
.PP
Las funciones \fBether_ntoa_r\fP() y \fBether_aton_r\fP() son versiones
reentrantes e hilo\-seguro de \fBether_ntoa\fP() y \fBether_aton\fP()
respectivamente, y no usan buffers estáticos.
.PP
La estructura \fIether_addr\fP está definida en \fI<net/ethernet.h>\fP
como:
.PP
.in +4n
.EX
struct ether_addr {
    uint8_t ether_addr_octet[6];
}
.EE
.in
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.ad l
.TS
allbox;
lbw33 lb lb
l l l.
Interfaz	Atributo	Valor
T{
\fBether_aton\fP(),
\fBether_ntoa\fP()
T}	Seguridad del hilo	MT\-Unsafe
T{
\fBether_ntohost\fP(),
\fBether_hostton\fP(),
\fBether_line\fP(),
\fBether_ntoa_r\fP(),
\fBether_aton_r\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.ad
.SH "CONFORME A"
4.3BSD, SunOS.
.SH ERRORES
.\" The fix was presumably commit c0a0f9a32c8baa6ab93d00eb42d92c02e9e146d7
.\" which was in glibc 2.3
In glibc 2.2.5 and earlier, the implementation of \fBether_line\fP()  is
broken.
.SH "VÉASE TAMBIÉN"
\fBethers\fP(5)
.SH COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux
\fIman\-pages\fP. Puede encontrar una descripción del proyecto, información
sobre cómo informar errores y la última versión de esta página en
\%https://www.kernel.org/doc/man\-pages/.

.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Miguel Pérez Ibars <mpi79470@alu.um.es>
.

Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT
debian-l10n-spanish@lists.debian.org>.
.ME .