net_aton(3C)net_aton(3C)NAMEnet_aton(), net_ntoa() - network station address string conversion rou‐
tines
SYNOPSISDESCRIPTION
and translate station addresses between hexadecimal, octal or decimal,
and binary formats:
converts a hexadecimal, octal, or decimal address to a binary
address.
converts a binary address to an
ASCII hexadecimal address.
Both routines are provided in the standard C library and are loaded
automatically during compilation.
net_aton Parameters
The following parameters are used by
dstr Pointer to the binary address returned by the func‐
tion.
sstr Pointer to a null-terminated ASCII form of a station
address (Ethernet or IEEE 802.3). This address can be
an octal, decimal, or hexadecimal number as used in
the C language (in other words, a leading 0x or 0X
implies hexadecimal; a leading 0 implies octal; other‐
wise, the number is interpreted as decimal).
size Length of the binary address to be returned in dstr.
The length is 6 for Ethernet/IEEE 802.3 addresses.
net_ntoa Parameters
converts a 48-bit binary station address to its ASCII hexadecimal
equivalent. The following parameters are used by
dstr Pointer to the ASCII hexadecimal address returned by
the function. dstr is null-terminated and padded with
leading zeroes if necessary. dstr must be at least (2
× size + 3) bytes long to accommodate the size of the
converted address.
sstr Pointer to a station address in its binary form.
size Length of sstr.
RETURN VALUE
and return NULL if any error occurs.
EXAMPLES
#include <netio.h>
#define destination_addr "0x00DD0002AD00"
...
struct fis arg;
char str[16];
...
(void) net_aton(arg.value.s, destination_addr, 6);
/* arg.value.s = "<48-bit binary value>" */
(void) net_ntoa(str, arg.value.s, 6);
/* str = "0x00DD0002AD00" */
AUTHOR
was developed by HP.
SEE ALSOthread_safety(5), lan(7).
net_aton(3C)