LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / ether_aton.3

diff --git a/original/man3/ether_aton.3 b/original/man3/ether_aton.3
index 9711620..2853c74 100644 (file)
--- a/original/man3/ether_aton.3
+++ b/original/man3/ether_aton.3
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" 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.
@@ -21,14 +20,15 @@
 .\"
 .\" 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, 2002-07-20
+.\" Minor additions, aeb, 2013-06-21
 .\"
-.TH ETHER_ATON 3  2002-07-20 "GNU" "Linux Programmer's Manual"
+.TH ETHER_ATON 3  2014-07-08 "GNU" "Linux Programmer's Manual"
 .SH NAME
 ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line,
 ether_ntoa_r, ether_aton_r \- Ethernet address manipulation routines
@@ -56,7 +56,8 @@ ether_ntoa_r, ether_aton_r \- Ethernet address manipulation routines
 .fi
 .SH DESCRIPTION
 .BR ether_aton ()
-converts the 48-bit Ethernet host address \fIasc\fP
+converts the 48-bit Ethernet host address
+.I asc
 from the standard hex-digits-and-colons notation into binary data in
 network byte order and returns a pointer to it in a statically
 allocated buffer, which subsequent calls will
@@ -67,7 +68,8 @@ returns NULL if the address is invalid.
 The
 .BR ether_ntoa ()
 function converts the Ethernet host address
-\fIaddr\fP given in network byte order to a string in standard
+.I addr
+given in network byte order to a string in standard
 hex-digits-and-colons notation, omitting leading zeros.
 The string is returned in a statically allocated buffer,
 which subsequent calls will overwrite.
@@ -109,7 +111,9 @@ and
 .BR ether_aton ()
 respectively, and do not use static buffers.
 .PP
-The structure \fIether_addr\fP is defined in
+The structure
+.I ether_addr
+is defined in
 .I <net/ethernet.h>
 as:
 .sp
@@ -120,11 +124,44 @@ struct ether_addr {
 }
 .fi
 .in
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.ad l
+.TS
+allbox;
+lbw33 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR ether_aton (),
+.BR ether_ntoa ()
+T}     Thread safety   MT-Unsafe
+T{
+.BR ether_ntohost (),
+.BR ether_hostton (),
+.BR ether_line (),
+.BR ether_ntoa_r (),
+.BR ether_aton_r ()
+T}     Thread safety   MT-Safe
+.TE
+.ad
+.SH CONFORMING TO
 4.3BSD, SunOS.
 .SH BUGS
-The glibc 2.2.5 implementation of
+In glibc 2.2.5 and earlier, the implementation of
 .BR ether_line ()
+.\" The fix was presumably commit c0a0f9a32c8baa6ab93d00eb42d92c02e9e146d7
+.\" which was in glibc 2.3
 is broken.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR ethers (5)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.