unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

ETHERS(3N)                                                          ETHERS(3N)



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

SYNOPSIS
       #include <&lt;sys/types.h>&gt;
       #include <&lt;sys/socket.h>&gt;
       #include <&lt;net/if.h>&gt;
       #include <&lt;netinet/in.h>&gt;
       #include <&lt;netinet/if_ether.h>&gt;

       char *
       ether_ntoa(e)
       struct ether_addr *e;

       struct ether_addr *ether_aton(s)
       char *s;

       ether_ntohost(hostname, e)
       char *hostname;
       struct ether_addr *e;

       ether_hostton(hostname, e)
       char *hostname;
       struct ether_addr *e;

       ether_line(l, e, hostname)
       char *l;
       struct ether_addr *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 ether_ntoa() 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 ether_aton()
       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 ether_ntohost() 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 ether_hostton() 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  ether_line() 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(5).

FILES
       /etc/ethers         (or  the  Network  Information  Service  (NIS) maps
                           ethers.byaddr and ethers.byname)

SEE ALSO
       ethers(5)

NOTES
       The Network Information Service (NIS) was formerly known as Sun  Yellow
       Pages  (YP).   The  functionality of the two remains the same; only the
       name has changed.



                               16 February 1988                     ETHERS(3N)