rtquery(1M) System Administration Commands rtquery(1M)NAMErtquery - query routing daemons for their routing tables
SYNOPSISrtquery [-np1] [-w timeout] [-r addr] [-a secret] host...
rtquery [-t operation] host...
DESCRIPTION
The rtquery command is used to query a RIP network routing daemon,
in.routed(1M) or GateD, for its routing table by sending a request or
poll command. The routing information in any routing response packets
returned is displayed numerically and symbolically.
By default, rtquery uses the request command. When the -p option is
specified, rtquery uses the poll command, an undocumented extension to
the RIP protocol supported by GateD. When querying GateD, the poll com‐
mand is preferred over the request command because the response is not
subject to Split Horizon and/or Poisoned Reverse, and because some ver‐
sions of GateD do not answer the request command. in.routed does not
answer the poll command, but recognizes requests coming from rtquery
and so answers completely.
The rtquery command is also used to turn tracing on or off in
in.routed.
OPTIONS
The following options are supported:
-a passwd=XXX Causes the query to be sent with the indi‐
-a md5_passwd=XXX|KeyID cated cleartext or MD5 password.
-n Displays only the numeric network and host
addresses instead of both numeric and sym‐
bolic names.
-p Uses the poll command to request full rout‐
ing information from GateD. This is an
undocumented extension RIP protocol sup‐
ported only by GateD.
-r addr Asks about the route to destination addr.
-t operation Changes tracing, where operation is one of
the actions listed below. Requests from pro‐
cesses not running with UID 0 or on distant
networks are generally ignored by the daemon
except for a message in the system log.
GateD is likely to ignore these debugging
requests.
on=tracefile Turns tracing on, directing
tracing into the specified
file. That file must have
been specified when the dae‐
mon was started or have the
name,
/var/log/in.routed.trace.
more Increases the debugging
level.
off Turns off tracing.
dump Dumps the daemon's routing
table to the current trace
file.
-w timeout Changes the delay for an answer from each
host. By default, each host is given 15 sec‐
onds to respond.
-1 Queries using RIP version 1 instead of RIP
version 2.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │system/network/routing │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOin.routed(1M), route(1M), gateways(4), attributes(5), icmp(7P),
inet(7P), udp(7P)
Routing Information Protocol, RIPv1, RFC 1058
Routing Information Protocol, RIPv2, RFC 2453, STD 0056
SunOS 5.11 24 Apr 2002 rtquery(1M)