route(1M) route(1M)
NAME
route - manipulates the routing tables
SYNOPSIS
route [-f] [-n] command [net | host] destination gateway
[metric]
ARGUMENTS
command
Specifies the command to be passed to route. Replace
command with either: add to add a route, or delete to
delete a route.
destination
Specifies the destination host or network.
-f Flushes 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.
gateway
Specifies the next-hop gateway to which packets should
be addressed.
metric
Specifies a count indicating the number of hops to the
destination. The metric is required for add commands;
it must be zero if the destination is on a directly-
attached network, and non-zero if the route utilizes
one or more gateways. If adding a route with metric 0,
the gateway given is the address of this host on the
common network, indicating the interface to be used for
transmission. Routes to a particular host are
distinguished from those to a network by interpreting
the Internet address associated with destination.
-n Prevents attempts to print host and network names
symbolically when reporting actions.
net | host
Forces the destination to be interpreted as a network
or a host, respectively. Otherwise, if the destination
has a ``local address part'' of INADDR_ANY, or if the
destination is the symbolic name of a network, 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.
January 1992 1
route(1M) route(1M)
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(1M), should tend to
this task.
The route command accepts two commands: add, to add a
route, and delete, to delete a route.
All symbolic names specified for a destination or gateway
are looked up first as a host name using gethostbyname(3N).
If this lookup fails, getnetbyname is then used to interpret
the name as that of a network.
The route command uses a raw socket and the SIOCADDRT and
SIOCDELRT ioctls to do its work. As such, only the
superuser may modify the routing tables.
STATUS MESSAGES AND VALUES
add [ host | network ] %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 system call. If the gateway
address used was not the primary address of the gateway
(the first one returned by gethostbyname), the gateway
address is printed numerically as well as symbolically.
delete [ host | network ]
As above, but when deleting an entry.
%s %s done
When the -f option 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. The
next-hop gateway must be given.
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.
SEE ALSO
routed(1M)
2 January 1992
intro(5) in A/UX Programmer's Reference
January 1992 3