NAME

route − manually manipulate the routing tables

SYNOPSIS

/usr/etc/route [ −fhn ] add|delete destination [ gateway [ metric ] ]

AVAILABILITY

This program is available with the Networking Tools and Programs software installation option.  Refer to Installing the SunOS for information on how to install optional software. 

DESCRIPTION

route manually manipulate the network routing tables normally maintained by the system routing daemon, routed(8C).  route allows the super-user to operate directly on the routing table for the specific host or network indicated by destination. The gateway argument, if present, indicates the network gateway to which packets should be addressed.  The metric argument indicates the number of “hops” to the destination. The default value for metric is 0. 

The add command instructs route to add a route to destination. delete deletes a route. 

Routes to a particular host are distinguished from those to a network by interpreting the Internet address associated with the destination parameter.  If the destination 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 by a gateway, the metric parameter should be greater than 0.  All symbolic names specified for a destination or gateway are looked up in the hosts database, /etc/hosts.  If this lookup fails, then the name is looked up in the networks database, /etc/networks. 

OPTIONS

−f Flush the routing tables of all gateway entries.  If this is used in conjunction with one of the subcommands described below, route flushes the gateways before preforming the subcommand. 

−h Treat the destination as a host. 

−n Treat the destination as a network. 

FILES

/etc/hosts

/etc/networks

SEE ALSO

ioctl(2), routing(4N), routed(8C)

BUGS

The change operation is not implemented, one should add the new route, then delete the old one. 

DIAGNOSTICS

add destination address:gateway addresss flags value
The specified route is being added to the tables.  The values printed are from the routing table entry supplied in the ioctl(2) call. 

delete destination address:gateway addresss flags value
The specified route is being deleted.

destination address done
When the −f flag is specified, each routing table entry deleted is indicated with a message of this form. 

Network is unreachable
An attempt to add a route failed because the gateway listed was not on a directly-connected network.  Give the next-hop gateway instead.

not in table
A delete operation was attempted for an entry that is  not in the table.

routing table overflow
An add operation was attempted, but the system was unable to allocate memory to create the new entry.

Sun Release 4.0  —  Last change: 17 December 1987