admroute(1M) DG/UX 5.4.2 admroute(1M)
NAME
admroute - manage routing databases
SYNOPSIS
admroute -o add [ -p ] [ -t net | host ] -g gateway [ -m metric ]
destination
admroute -o modify [ -p ] [ -t net | host ] [ -d new-destination ] [
-G new-gateway ] [ -m metric ] -g gateway destination
admroute -o delete [ -p ] [ -t net | host ] -g gateway destination
admroute -o list [ -qv ] [ all | destination ... ]
admroute -o search -g gateway destination
DESCRIPTION
admroute manages the current and permanent routing databases. The
current routes are the routes in the network routing table that are
used by the kernel to make routing decisions. The permanent routes
are routes that are stored in a file and installed as current routes
when the network is started. When the network is started, admroute
manages the current routes, and optionally the permanent routes.
When the network is stopped, admroute manages only the permanent
routes.
Each route consists of: type, destination, gateway, and metric.
Operations
add Add a new route to the current and/or permanent routing
database.
modify Change a route from the current and/or permanent routing
database. The destination type, destination, gateway, and
metric may all be changed.
delete Remove a route from the current and/or permanent routing
database.
list List one or more routes in the current or permanent routing
database. Information is listed about all routes to the
destinations; if no destinations are given or if
destination is all, information about all routes is listed.
search Search for the destination/gateway combination in the
current or permanent routing database. If the route is
found, it is echoed to stdout with a single space delimiter
between each field. Otherwise, exit with an error code.
Options
-p Make the requested operation permanent so that the
permanent routes are updated in addtion to the current
routes. The routing entry is updated in the permanent
Licensed material--property of copyright holder(s) 1
admroute(1M) DG/UX 5.4.2 admroute(1M)
routing database located in the tcpip.params(4M) file.
-t net | host
net | host is the type of destination for the route. When
the network is subnetted, this parameter is required to
distinguish a network address from a host address. If the
address is not on a subnetted network, then it can be
determined from the address whether it represents a host or
a network, and the parameter is not required.
-g gateway
gateway is the symbolic name or Internet address to route
packets through in order to reach the destination. If a
symbolic name is specified, then an entry will be added to
local hosts(4) database.
-m metric metric is the number of network hops to reach the gateway.
Currently, the only valid values are 0 and 1. A value of 0
indicates that the route goes through a local interface to
the directly-connected network. A value of 1 indicates
that the route goes through a gateway. The default is 1.
-d new-destination
new-destination is the symbolic name or Internet address
that will replace destination in the modify command. If a
symbolic name is specified, then an entry will added to the
local hosts or networks(4) database.
-G new-gateway
new-gateway is the new name or Internet address that
replaces gateway. If a symbolic name is specified, then an
entry will added to the local hosts database. Without this
option the gateway is not changed.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
fields delimited by a single space).
-v "Verbose." Produce a formatted listing with headers and
aligned columns. This option is enabled by default.
admroute expects all Internet addresses to be of the form
a.b.c.d,
where a is a decimal number between 0 and 224, and b, c, and d are
decimal numbers between 0 and 255.
FILES
/etc/tcpip.params
TCP/IP parameters file contains the permanent routes
database.
OUTPUT
The list and search operations write their output to stdout.
Licensed material--property of copyright holder(s) 2
admroute(1M) DG/UX 5.4.2 admroute(1M)
The verbose form of the list operation outputs information in aligned
columns with column headers.
If -q option is specified with the list operation, headers are
suppressed and each entry is printed on a separate line. The fields
within the entry are delimited by a single space, and are in the
following order:
type destination gateway metric
This format is also used by the search operation.
DIAGNOSTICS
Warnings
- The delete operation is requested, and destination/gateway does
not exist.
Errors
- The add operation is requested, and the destination/gateway
already exists.
- The modify operation is requested, and the new-destination/new-
gateway already exists.
- The modify or search operation is requested, and
destination/gateway does not exist.
- The destination, new-destination, gateway, or new-gateway
parameter is specified as an invalid Internet address.
- The destination, new-destination, gateway, or new-gateway is
specified as a symbolic name that cannot be resolved to a
Internet address by the hosts or networks database.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
4 A symbolic name could not be resolved, or an Invalid Internet
address was entered.
SEE ALSO
netstat(1M), route(1M), hosts(4), networks(4), tcpip.params(4M).
NOTES
Only the system administrator may modify the routing databases.
Licensed material--property of copyright holder(s) 3