Kernel Functions for Drivers                      netrouteto(9F)



NAME
     netrouteto - indicate which network interface  packets  are
     sent

SYNOPSIS
     #include 

     phyift netrouteto(const netdatat *net, struct sockaddr *address,
          struct sockaddr *nexthop);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

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


     address    network address to find a path out of the machine
                for.


     nexthop    pointer to the sockaddr  structure  in  which  to
                store the address of the next hop. If this infor-
                mation is not required, the  value  NUL  may  be
                passed instead.


DESCRIPTION
     The netrouteto() function indicates which network interface
     packets  destined for a particular address would be sent out
     of, according to the systems network routing tables. If next
     is  supplied  as  a  non-NUL pointer, the IP address of the
     nexthop router to be used is returned in it.

RETURN VALUES
     The netrouteto() function returns:

     -1    The network protocol does not support this function.


     0     This function cannot find  a  route  for  the  address
           given.


     >0    Indicates which network interface can be used to reach
           the given address.


CONTEXT




SunOS 5.11           Last change: 1 May 2008                    1






Kernel Functions for Drivers                      netrouteto(9F)



     The netrouteto() function may be called from user,  kernel,
     or interrupt context.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          Committed                   
    


SEE ALSO
     netphygetnext(9F),                       netphylookup(9F),
     netprotocollookup(9F), attributes(5)


































SunOS 5.11           Last change: 1 May 2008                    2