Kernel Functions for Drivers                   netgetlifaddr(9F)



NAME
     netgetlifaddr - determine a network  address  for  a  given
     interface

SYNOPSIS
     #include 

     int netgetlifaddr(const netdatat net, const phyift ifp,
          const netift lif, int const type,
          struct sockaddr* storage);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

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


     ifp        value  returned  from  a   successful   call   to
                netphylookup(9F) or netphygetnext(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 netgetlifaddr() function retrieves the address informa-
     tion    for   each   logical   interface.   Each   call   to
     netgetlifaddr() 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 netlifgetnext(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                   netgetlifaddr(9F)



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


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


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


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


RETURN VALUES
     The netgetlifaddr() function returns:

     -1    The network protocol does not support this function.


     0     Successful completion.


     1     Unsuccessful.


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

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
















SunOS 5.11          Last change: 13 Oct 2008                    2






Kernel Functions for Drivers                   netgetlifaddr(9F)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          Committed                   
    


SEE ALSO
     netlifgetnext(9F),                       netphylookup(9F),
     netphygetnext(9F)netprotocollookup(9F)











































SunOS 5.11          Last change: 13 Oct 2008                    3