Manual Pages for UNIX Operating System command usage for man net_getlifaddr

Kernel Functions for Drivers                   net_getlifaddr(9F)



NAME
     net_getlifaddr - determine a network  address  for  a  given
     interface

SYNOPSIS
     #include 

     int net_getlifaddr(const net_data_t net, const phy_if_t ifp,
          const net_if_t lif, int const type,
          struct sockaddr* storage);


INTERFACE LEVEL
     Solaris DDI specific (Solaris DDI).

PARAMETERS
     net        value  returned  from  a   successful   call   to
                net_protocol_lookup(9F).


     ifp        value  returned  from  a   successful   call   to
                net_phylookup(9F) or net_phygetnext(9F), indicat-
                ing  which  network  interface  the   information
                should be returned from.


     lif        indicates the logical  interface  from  which  to
                fetch the address.


     type       indicates  what  type  of   address   should   be
                returned.  See  below  for  more  details on this
                field.


     storage    pointer to an area of memory to store the address
                data.


DESCRIPTION
     The net_getlifaddr() function retrieves the address informa-
     tion    for   each   logical   interface.   Each   call   to
     net_getlifaddr() requires that the caller pass a pointer  to
     an  array  of  address information types to retrieve, and an
     accompanying pointer to  an  array  of  pointers  to  struct
     sockaddr  structures  to  which to copy the address informa-
     tion. See net_lifgetnext(9F) for an example on  how  to  use
     this function.


     Each member of the address type array should be one  of  the
     values listed here.



SunOS 5.11          Last change: 13 Oct 2008                    1






Kernel Functions for Drivers                   net_getlifaddr(9F)



     NA_ADDRESS      Return the network address  associated  with
                     the  logical interface (lif) that belongs to
                     the network interface (ifp).


     NA_PEER         Return the address assigned  to  the  remote
                     host  for  point to point network interfaces
                     for the given network/logical interface.


     NA_BROADCAST    Return the broadcast address assigned to the
                     given  network/logical interface for network
                     interfaces that support broadcast packets.


     NA_NETMASK      Return the netmask associated with the given
                     network/logical interface for network inter-
                     faces that support broadcast packets.


RETURN VALUES
     The net_getlifaddr() function returns:

     -1    The network protocol does not support this function.


     0     Successful completion.


     1     Unsuccessful.


CONTEXT
     The net_getifaddr() function may be called from  user,  ker-
     nel, or interrupt context.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:
















SunOS 5.11          Last change: 13 Oct 2008                    2






Kernel Functions for Drivers                   net_getlifaddr(9F)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     net_lifgetnext(9F),                       net_phylookup(9F),
     net_phygetnext(9F)net_protocol_lookup(9F)











































SunOS 5.11          Last change: 13 Oct 2008                    3