Sun Microsystems Sun Workstation 100U System Manager's Manual page 239

ROUTE(8C)
MAINTENANCE COM}JANDS
ROUTE(8C)
NAME
route - manually manipulate the routing tables
SYNOPSIS
/usr Jete/route ( -I] ( commtJnd tJrgB )
DESCRIPTION
Route is a program used to manually manipulate the network routing tables. It normally is not
needed, as the system routing table management daemon, routed(8C), should tend to this task.
Route accepts three commands: tJdd, to add a route; delete, to delete a route; and chtJnge, to
modify an existing route.
All commands have the following syntax:
/usr Jete/route eommtJnd destination lateway ( metrle )
where deBtintJtion is a host or network for which the route is "to", gtJtewtJlI is the gateway to
which packets should be addressed, and metric is an optional count indicating the number of hops
to the deBtintJtion. If no metric is specified, route assumes a value of O. Routes to a particular
host are distinguished from those to a network by interpreting the Internet address associated
with deBtintJtion. If the deBtintJtion has a "local address part" of INADDR_ANY, then the route
is assumed
to
be to a network; otherwise, it is presumed
to
be a route to a host. If the route is to
a destination connected via a gateway, the metric should be greater than O. All symbolic names
specified for a deBtintJtion or gtJtewtJlI are looked up first in the host name database, hOBtB(5). If
this lookup fails, the name is then looked for in the network name database, networkB(5).
Route uses a raw socket and the SIOCADDRT and SIOCDELRT ioetl's to do its work. As such,
only the super-user may modify the routing tables.
If
the -I option is specified, route will "flush" the routing tables of all gateway entries. If this is
used in conjunction with one of the commands described above, the tables are flushed prior to the
command's application.
DIAGNOSTICS
uadd %s, gateway %s flap %x"
The specified route is being added to the tables. The values printed are from the routing table
entry supplied in the ioetl call.
"delete %sllateway%s flals %x"
As above, but when deleting an entry.
U%s %s done"
When the -I flag is specified, each routing table entry deleted
is indicated with a message of this
form.
"not In table"
A delete operation was attempted tor an entry which wasn't present in the tables.
"routlnl table overflow"
An add operation was attempted, but the system was low on resources and was unable
to
allocate
memory to create the new entry.
SEE ALSO
routing( 4N), routed(8C)
BUGS
The change operation is not implemented, one should add the new route, then delete the old one.
84
Last change: 25 October 1983
Sun Release 1.1