NET_ROUTETO(9F) Kernel Functions for Drivers NET_ROUTETO(9F)
net_routeto - indicate which network interface packets are sent
#include <sys/neti.h>
phy_if_t net_routeto(const net_data_t *net, struct sockaddr *address,
struct sockaddr *nexthop);
illumos DDI specific (illumos DDI).
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.
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.
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.
The net_routeto() function may be called from user, kernel, or
interrupt context.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
attributes(7), net_phygetnext(9F), net_phylookup(9F),
net_protocol_lookup(9F)
May 1, 2008 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)