NAME

route − manually manipulate the routing tables

SYNOPSIS

/usr/bin/route [ command args ]

DESCRIPTION

route is a program used to manually manipulate the network routing tables. 

route accepts three options:  add, to add a route; delete, to delete a route; and show, to show an existing route.  All options have the following syntax:

/etc/route option destination gateway

where destination is a host or network to which the route is, and gateway is the gateway to which packets should be addressed.  Routes to a particular host are distinguished from those to a network by interpreting the Internet address associated with destination.  If destination has a “local address part” of INADDR_ANY, the route is assumed to be to a network; otherwise, it is presumed to be a route to a host.  All symbolic names specified for a destination or gateway are first looked up in the host name database, hosts(4). 

show can be used to display an individual route or all the routes currently configured. An individual route is displayed by specifying the destination only.  All the routes are displayed by not specifying a specific destination. 

add can be used to add a default route.  If no route is available to get to a destination, this will be used as the default route.  The default route is indicated by using 0 as the destination address.  Typically, the default route will  be the address of a gateway. 

route uses the board device and BRDADDRT, BRDDELRT, BRDDISPRT, and BRDSHOWRT ioctls to do its work.  As such, only the super user can modify the routing tables. 

DIAGNOSTICS

add %s: gateway %s flags %x
The specified route is being added to the tables.  The values printed are from the routing table entry supplied in the ioctl call. 

delete %s: gateway %s flags %x
As above, but when deleting an entry. A delete operation was attempted for an entry that wasn’t present in the tables.

routing table overflow
An add operation was attempted, but the EXOS FEP was low on resources and was unable to allocate memory to create the new entry.

Version 2.4  —  May 08, 1986