ROUTE(8C)
NAME
route − manually manipulate the routing tables
USAGE
/etc/route [−f][command args]
DESCRIPTION
The route program allows you to manipulate the Internet routing tables by hand. It normally is not needed, as the system routing table management daemon, routed(8C), should tend to this task.
You may use the following three commands with route: add, to add a route; delete, to delete a route; and change, to modify an existing route.
All commands have the following syntax:
/etc/route
command destination gateway [metric]
where destination is a host or network to which the route is “to”, gateway is the gateway to which packets should be addressed, and metric is an optional count indicating the number of hops to the destination. If no metric is specified, route assumes a value of 0.
Routes to a particular host are distinguished from those to a network by interpreting the Internet address associated with destination. If the destination has a “local address part” of INADDR_ANY, then the route is assumed to be a route to a network; otherwise, it is assumed to be a route to a host.
If the route is to a destination connected via a gateway, the metric should be greater than zero. Initially, route trys to look up all symbolic names specified for a destination or gateway in the host name database, hosts(5). If this lookup fails, route looks for the name in the network name database, networks(5).
OPTIONS
−f “Flush” the routing tables of all gateway entries. Using this option in conjunction with one of the commands described above flushes the tables prior to the command’s application.
NOTES
No change operation is implemented. To change a route, add the new route, then delete the old one.
DIAGNOSTICS
add %s: gateway %s flags %x Specified route is being added to the tables; values printed are from the routing table entry supplied in the ioctl (2) call.
delete %s: gateway %s flags %x As above, but when deleting an entry.
%s %s done When the −f flag is specified, each routing table entry deleted is indicated with a message of this form.
not in table Attempted a delete operation on an entry that wasn’t present in the tables.
routing table overflow Attempted an add operation, but the system was low on resources and was unable to allocate memory to create the new entry.