HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
n
net_aton(3C) net_aton(3C)
NAME
net_aton(), net_ntoa() - network station address string conversion routines
SYNOPSIS
#include <sys/netio.h>
char *net_aton(char *dstr, const char *sstr, int size);
char *net_ntoa(char *dstr, const char *sstr, int size);
MULTITHREAD USAGE
Thread Safe: Yes
Cancel Safe: Yes
Async-cancel Safe: Yes
Async-signal Safe: Yes
These functions can be called safely in a Multithreaded environment. They are not cancellation points.
DESCRIPTION
net_aton() and net_ntoa() translate station addresses between hexadecimal, octal or decimal, and
binary formats:
net_aton() converts a hexadecimal, octal, or decimal address to a binary address.
net_ntoa() 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 net_aton():
dstr Pointer to the binary address returned by the function.
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; otherwise,
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
net_ntoa() converts a 48-bit binary station address to its ASCII hexadecimal equivalent. The following
parameters are used by net_ntoa() :
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
net_aton() and net_ntoa() 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" */
HP-UX Release 11i: December 2000 − 1 − Section 3−−541
___
___