Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ inet(3n) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                 inet(3n)



        _________________________________________________________________
        inetaddr, inetnetwork, inetntoa,       Network Library Routine
        inetmakeaddr, inetlnaof, inetnetof
        Internet address manipulation routines
        _________________________________________________________________


        SYNTAX

        #include <sys/socket.h>
        #include <netinet/in.h>
        #include <inet.h>

        struct inaddr inetaddr(cp)
        char *cp;

        int inetnetwork(cp)
        char *cp;

        char *inetntoa(in)
        struct inetaddr in;

        struct inaddr inetmakeaddr(net, lna)
        int net, lna;

        int inetlnaof(in)
        struct inaddr in;

        int inetnetof(in)
        struct inaddr in;


        DESCRIPTION

        inetaddr, inetnetwork
                  Interpret character strings representing numbers
                  expressed in the Internet standard dot notation,
                  returning numbers suitable for use as Internet
                  addresses and Internet network numbers, respectively.

        inetntoa Takes an Internet address and returns an ASCII string
                  representing the address in dot notation.

        inetmakeaddr
                  Takes an Internet network number and a local network
                  address, and constructs an Internet address from it.

        inetnetof, inetlnaof
                  Break apart Internet host addresses, returning the
                  network number and local network address part,
                  respectively.



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                 inet(3n)



        All Internet addresses are returned in network order (bytes
        ordered from left to right).  All network numbers and local
        address parts are returned as machine-format integer values.



















































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)





                                                                 inet(3n)



        INTERNET ADDRESSES

        Values specified using the dot notation take one of the following
        forms:
             a.b.c.d
             a.b.c
             a.b
             a

        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.

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

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

        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 a dot notation may be decimal,
        octal, or hexadecimal, as specified in the C language (i.e., a
        leading 0x or 0X implies hexadecimal; otherwise, a leading 0
        implies octal; otherwise, the number is interpreted as decimal).


        SEE ALSO

        gethostent(3N), getnetent(3N), hosts(4), networks(4)


        DIAGNOSTICS

        Inetaddr and inetnetwork return the value -1 for malformed
        requests.


        BUGS

        The problem of host byte ordering versus network byte ordering is
        confusing.  There is no simple way to specify Class C network
        addresses, as there is for Classes A and B.  The string returned
        by inetntoa resides in a static memory area.




        DG/UX 4.00                                                 Page 3
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026