ethers(3n)                 DG/UX 4.30                  ethers(3n)



     NAME
          ethers, ether_ntoa, ether_aton, ether_ntohost,
          ether_hostton, ether_line - Ethernet address mapping
          operations

     SYNOPSIS
          #include <sys/types.h>
          #include <sys/socket.h>
          #include <net/if.h>
          #include <netinet/in.h>
          #include <netinet/ifether.h>

          char *
          etherntoa(e)
               struct etheraddr *e;

          struct etheraddr *
          etheraton(s)
               char *s;

          etherntohost(hostname, e)
               char *hostname;
               struct etheraddr *e;

          etherhostton(hostname, e)
               char *hostname;
               struct etheraddr *e;

          etherline(l, e, hostname)
               char *l;
               struct etheraddr *e;
               char *hostname;

     DESCRIPTION
          These routines are useful for mapping 48 bit Ethernet
          numbers to their ASCII representations or their
          corresponding host names, and vice versa.

          The function etherntoa converts a 48 bit Ethernet number
          pointed to by e to its standard ACSII representation; it
          returns a pointer to the ASCII string.  The representation
          is of the form:  x:x:x:x:x:x where x is a hexadecimal number
          between 0 and ff.  The function etheraton converts an ASCII
          string in the standard representation back to a 48 bit
          Ethernet number;  the function returns NULL if the string
          cannot be scanned successfully.

          The function etherntohost maps an Ethernet number (pointed
          to by e) to its associated hostname.  The string pointed to
          by hostname must be long enough to hold the hostname and a
          NULL character.  The function returns zero upon success and
          non-zero upon failure.  Inversely, the function



     Licensed material--property of copyright holder(s)         Page 1

     ethers(3n)                 DG/UX 4.30                  ethers(3n)



          etherhostton maps a hostname string to its corresponding
          Ethernet number; the function modifies the Ethernet number
          pointed to by e.  The function also returns zero upon
          success and non-zero upon failure.

          The function etherline scans a line (pointed to by l) and
          sets the hostname and the Ethernet number (pointed to by e).
          The string pointed to by hostname must be long enough to
          hold the hostname and a NULL character.  The function
          returns zero upon success and non-zero upon failure.  The
          format of the scanned line is described by ethers(4).

     FILES
          /etc/ethers         (or the Yellow Pages maps ethers.byaddr
                              and ethers.byname)

     SEE ALSO
          ethers(4)





































     Licensed material--property of copyright holder(s)         Page 2