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
illumos DDI specific (illumos 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
SEE ALSO
attributes(7),
net_phygetnext(9F),
net_phylookup(9F),
net_protocol_lookup(9F) May 1, 2008 NET_ROUTETO(9F)
