RTQUERY(8) Maintenance Procedures RTQUERY(8)


rtquery - query routing daemons for their routing tables


rtquery [-np1] [-w timeout] [-r addr] [-a secret] host...

rtquery [-t operation] host...


The rtquery command is used to query a RIP network routing daemon,
in.routed(8) 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
command is preferred over the request command because the response is not
subject to Split Horizon and/or Poisoned Reverse, and because some
versions 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.


The following options are supported:

-a passwd=XXX
-a md5_passwd=XXX|KeyID
Causes the query to be sent with the indicated
cleartext or MD5 password.

Displays only the numeric network and host
addresses instead of both numeric and symbolic

Uses the poll command to request full routing
information from GateD. This is an
undocumented extension RIP protocol supported
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 processes
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.

Turns tracing on, directing
tracing into the specified
file. That file must have been
specified when the daemon was
started or have the name,

Increases the debugging level.

Turns off tracing.

Dumps the daemon's routing
table to the current trace

-w timeout
Changes the delay for an answer from each
host. By default, each host is given 15
seconds to respond.

Queries using RIP version 1 instead of RIP
version 2.


The following exit values are returned:

Successful completion.

An error occurred.


in.routed(8), icmp(4P), inet(4P), udp(4P), gateways(5), attributes(7),

Routing Information Protocol, RIPv1, RFC 1058

Routing Information Protocol, RIPv2, RFC 2453, STD 0056

April 24, 2002 RTQUERY(8)