route(1M)                                               route(1M)



     NAME
          route - manually manipulate the routing tables

     SYNOPSIS
          /etc/route [-f] command destination gateway [metric]

     DESCRIPTION
          route manually manipulates the network routing tables.
          Normally, it is not needed, as the system routing table
          management daemon, routed(1M), performs this task.

          command is one of three commands:

                  add       add a route

                  delete    delete a route

                  change    modify an existing route

          destination
                  a host or network which the route is ``to''

          gateway the gateway to which packets should be addressed

          metric  an optional count indicating the number of hops to
                  the destination.  If you don't specify a metric, the
                  default value is 0.

          -f      ``flush'' the routing tables of all gateway entries.
                  If this is used with the add, delete, or change
                  commands, it flushes the tables before applying the
                  command.

          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 INADDRANY, the route is assumed to be to a
          network; otherwise, it is presumed to be 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 first looked up
          in the host name database, hosts(4N).  If this lookup fails,
          route looks for the name in the network name database,
          networks(4N).

          route uses a raw socket and the SIOCADDRT and SIOCDELRT
          ioctl's to do its work. Only the super-user may modify the
          routing tables.

     DIAGNOSTICS
          add %s: gateway %s flags %x
          The specified route is being added to the tables. The values



     Page 1                                        (last mod. 1/15/87)

     route(1M)                                               route(1M)



          printed are from the routing table entry supplied in the
          ioctl call.

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

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

          not in table
          Attempted to delete an entry which wasn't present in the
          tables.

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

     FILES
          /etc/route

     SEE ALSO
          intro(5N), routed(1M).

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


























     Page 2                                        (last mod. 1/15/87)