opensolaris man page for net_routeto

net_routeto(9F) 					   Kernel Functions for Drivers 					   net_routeto(9F)

NAME
       net_routeto - indicate which network interface packets are sent

SYNOPSIS
       #include <sys/neti.h>

       phy_if_t net_routeto(const net_data_t *net, struct sockaddr *address,
	    struct sockaddr *nexthop);

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

PARAMETERS
       net	  value returned from a successful call to net_protocol_lookup(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 information is not required, the value
		  NULL may be passed instead.

DESCRIPTION
       The net_routeto() 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-NULL pointer, the IP address of the nexthop router to be used is returned
       in it.

RETURN VALUES
       The net_routeto() 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
       The net_routeto() function may be called from user,  kernel, or interrupt context.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+

SEE ALSO
       net_phygetnext(9F), net_phylookup(9F), net_protocol_lookup(9F), attributes(5)

SunOS 5.11							    1 May 2008							   net_routeto(9F)