ROUTE(8N)               COMMAND REFERENCE               ROUTE(8N)



NAME
     route - manually manipulate the routing tables

SYNOPSIS
     /etc/route [ -f ] [ command args ]

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(8n), should tend to
     this task.

     Route accepts three commands: 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 for 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 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 0.  All symbolic names
     specified for a destination or gateway are looked up first
     in the host name database, hosts(5n).  If this lookup fails,
     the name is then looked for in the network name database,
     networks(5n).

     Route uses a raw socket and the SIOCADDRT and SIOCDELRT
     ioctl's to do its work.  As such, only the super-user may
     modify the routing tables.

OPTIONS
     -f         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.

     command args
                See above for description.

DIAGNOSTICS
     add %s: gateway %s flags %x



Printed 4/6/89                                                  1

ROUTE(8N)               COMMAND REFERENCE               ROUTE(8N)



                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.

     %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
                A delete operation was attempted for an entry
                which wasn't present in the tables.

     routing 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.

RETURN VALUE
     [0]              No errors occurred.

     [1]              Errors occurred.

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

SEE ALSO
     intro(4n) and routed(8n).
























Printed 4/6/89                                                  2

%%index%%
na:288,98;
sy:386,272;
de:658,2252;
op:2910,510;
di:3420,197;3977,916;
rv:4893,206;
ca:5099,185;
se:5284,161;
%%index%%000000000143