OSDN Git Service

(split) LDP: Update original to LDP v3.52.
[linuxjm/LDP_man-pages.git] / original / man3 / ether_aton.3
index eb65777..63ab359 100644 (file)
@@ -26,9 +26,9 @@
 .\"     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  2013-07-04 "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,6 +124,22 @@ struct ether_addr {
 }
 .fi
 .in
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR ether_aton ()
+and
+.BR ether_ntoa ()
+functions are not thread-safe.
+.LP
+The
+.BR ether_ntohost (),
+.BR ether_hostton (),
+.BR ether_line (),
+.BR ether_ntoa_r ()
+and
+.BR ether_aton_r ()
+functions are thread-safe.
 .SH CONFORMING TO
 4.3BSD, SunOS.
 .SH BUGS