inet(3N-xs)                   (X/OPEN SOCKETS)                  inet(3N-xs)

NAME
     inet: inetaddr, inetnetwork, inetmakeaddr, inetlnaof, inetnetof,
     inetntoa - Internet address manipulation

SYNOPSIS
     cc [flag ...] file ... -lxnet [library ...]

     #include <arpa/inet.h>

     inaddrt inetaddr(const char *cp);

     inaddrt inetlnaof(struct inaddr in);

     struct inaddr inetmakeaddr(inaddrt net, inaddrt lna);

     inaddrt inetnetof(struct inaddr in);

     inaddrt inetnetwork(const char *cp);

     char *inetntoa(struct inaddr in);

DESCRIPTION
     The inetaddr function converts the string pointed to by cp, in the
     Internet standard dot notation, to an integer value suitable for use
     as an Internet address.

     The inetlnaof function takes an Internet host address specified by in
     and extracts the local network address part, in host byte order.

     The inetmakeaddr function takes the Internet network number specified
     by net and the local network address specified by lna, both in host
     byte order, and constructs an Internet address from them.

     The inetnetof function takes an Internet host address specified by in
     and extracts the network number part, in host byte order.

     The inetnetwork function converts the string pointed to by cp, in the
     Internet standard dot notation, to an integer value suitable for use
     as an Internet network number.

     The inetntoa function converts the Internet host address specified by
     in to a string in the Internet standard dot notation.

     All Internet addresses are returned in network order (bytes ordered
     from left to right).










Page 1                       Reliant UNIX 5.44                Printed 11/98

inet(3N-xs)                   (X/OPEN SOCKETS)                  inet(3N-xs)

     Values specified using dot notation take one of the following forms:

     a.b.c.d     When four parts are specified, each is interpreted as a
                 byte of data and assigned, from left to right, to the four
                 bytes of an Internet address.

     a.b.c       When a three-part address is specified, the last part is
                 interpreted as a 16-bit quantity and placed in the right-
                 most two bytes of the network address. This makes the
                 three-part address format convenient for specifying Class
                 B network addresses as 128.net.host.

     a.b         When a two-part address is supplied, the last part is
                 interpreted as a 24-bit quantity and placed in the right-
                 most three bytes of the network address. This makes the
                 two-part address format convenient for specifying Class A
                 network addresses as net.host.

     a           When only one part is given, the value is stored directly
                 in the network address without any byte rearrangement.

     All numbers supplied as parts in dot notation may be decimal, octal,
     or hexadecimal (that is, a leading 0x or 0X implies hexadecimal; oth-
     erwise, a leading 0 implies octal; otherwise, the number is inter-
     preted as decimal).

RETURN VALUE
     Upon successful completion, inetaddr returns the Internet address.
     Otherwise, it returns (inaddrt)-1.

     Upon successful completion, inetnetwork returns the converted Inter-
     net network number. Otherwise, it returns (inaddrt)-1.

     The inetmakeaddr function returns the constructed Internet address.

     The inetlnaof function returns the local network address part.

     The inetnetof function returns the network number.

     The inetntoa function returns a pointer to the network address in
     Internet-standard dot notation.

ERRORS
     No errors are defined.

APPLICATION USAGE
     The return value of inetntoa may point to static data that may be
     overwritten by subsequent calls to inetntoa.

SEE ALSO
     gethostent(3N-xs), getnetent(3N-xs), in(5).



Page 2                       Reliant UNIX 5.44                Printed 11/98