route(1M)                   TCP/IP 5.4 Rel. 2.01                   route(1M)


NAME
       route - manipulate the routing tables

SYNOPSIS
       route [-f] command [net|host] dest gateway [ metric ]

DESCRIPTION
       Use the route program to manipulate the network routing tables.  Use
       netstat -r to display the routing tables.  The route program accepts
       the following two commands:

         add: Add a route
         delete: Delete a route

       The destination named dest is a host or network for which the route
       is "to."  A network address should be specified as a complete 4 part
       Internet address.  For example, if the network address is 128.220.3
       the network argument should be provided as 128.220.3.0.  gateway is
       the gateway to which packets should be addressed.  All symbolic names
       specified for a dest or gateway are looked up first in the hostname
       database, hosts(4).  If this lookup fails, the name is looked up in
       the network name database, networks(4).

       metric is an option indicating the number of hops to dest.  If you do
       not specify a metric, route assumes a value of zero (0).  If route is
       to a destination connected via a gateway, the metric should be
       greater than zero (0).

       Distinguish routes to a particular host from those to a network by
       the optional net or host parameter on the command line.  If this
       parameter is absent, routes are distinguished by interpreting the
       Internet address associated with dest.  If the destination named dest
       has a local address part of INADDR_ANY, then route is assumed to be
       to a network; otherwise, it is presumed to be a route to a host.

       It is impossible to identify the local address part of an address on
       a subnetted network, so the net or host parameter must be supplied if
       you use subnets.

       Route uses a raw socket and the SIOCADDRT and SIOCDELRT ioctl's to do
       its work.  Only the superuser may modify the routing tables.

       If you specify the -f option, route will "flush" the routing tables
       of all gateway entries.  If you use this with one of the commands
       described above, the tables are flushed prior to the command's
       application.

DIAGNOSTICS
       add destination: gateway gatehost, flags flagvalues

       Here, the specified route is being added to the tables.  The values
       printed are from the routing table entry supplied in the ioctl call.





Licensed material--property of copyright holder(s)                         1

route(1M)                   TCP/IP 5.4 Rel. 2.01                   route(1M)


       delete destination: gateway gatehost, flags flagvalues

       Here, the same action (as in the first example) takes place, but when
       deleting an entry.


       destination gatehost done

       When you specify the -f flag, each routing table entry deleted is
       indicated with a message of this form.


       not in table

       Here, a delete operation was attempted for an entry which wasn't
       present in the tables.


       routing table overflow

       Here, an add operation was attempted, but the system was low on
       resources and was unable to allocate memory to create the new entry.
       Clean out the routes that you do not need and try again.  The
       meanings of flag values are provided in the routing(6) man page.

SEE ALSO
       netstat(1M), inet(3N), intro(6), routing(6).






























Licensed material--property of copyright holder(s)                         2