table of contents
| IPX(3) | Library Functions Manual | IPX(3) |
NAME¶
ipx_addr, ipx_ntoa —
LIBRARY¶
library “libipx”SYNOPSIS¶
#include <sys/types.h>
#include <netipx/ipx.h>
struct ipx_addr
ipx_addr(const
char *cp);
char *
ipx_ntoa(struct
ipx_addr ipx);
DESCRIPTION¶
The routineipx_addr() interprets character strings
representing IPX addresses, returning binary information suitable for use in
system calls. The routine ipx_ntoa() takes IPX
addresses and returns ASCII strings representing the address in a notation in
common use:
Trailing zero fields are suppressed, and each number is printed in
hexadecimal, in a format suitable for input to
ipx_addr(). Any fields lacking super-decimal digits
will have a trailing ‘H’ appended.
An effort has been made to ensure that
ipx_addr() be compatible with most formats in common
use. It will first separate an address into 1 to 3 fields using a single
delimiter chosen from period ‘.’,
colon ‘:’ or pound-sign
‘#’. Each field is then examined for
byte separators (colon or period). If there are byte separators, each
subfield separated is taken to be a small hexadecimal number, and the
entirety is taken as a network-byte-ordered quantity to be zero extended in
the high-network-order bytes. Next, the field is inspected for hyphens, in
which case the field is assumed to be a number in decimal notation with
hyphens separating the millennia. Next, the field is assumed to be a number:
It is interpreted as hexadecimal if there is a leading
‘0x’ (as in C), a trailing
‘H’ (as in Mesa), or there are any
super-decimal digits present. It is interpreted as octal if there is a
leading ‘0’ and there are no
super-octal digits. Otherwise, it is converted as a decimal number.
RETURN VALUES¶
None. (See BUGS.)SEE ALSO¶
hosts(5), networks(5)HISTORY¶
The precursorns_addr() and
ns_toa() functions appeared in
4.3BSD.
BUGS¶
The string returned byipx_ntoa() resides in a static
memory area. The function ipx_addr() should diagnose
improperly formed input, and there should be an unambiguous way to recognize
this.
| June 4, 1993 | Linux 4.9.0-9-amd64 |