RTQUERY(8) Maintenance Commands and Procedures RTQUERY(8)

NAME

rtquery - query routing daemons for their routing tables

SYNOPSIS

rtquery [-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(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.

OPTIONS

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.


-n
Displays only the numeric network and host
addresses instead of both numeric and
symbolic names.


-p
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.

on=tracefile
Turns tracing on,
directing tracing into the
specified file. That file
must have been specified
when the daemon 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
seconds 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.

SEE ALSO

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


Routing Information Protocol, RIPv1, RFC 1058


Routing Information Protocol, RIPv2, RFC 2453, STD 0056

April 24, 2002 RTQUERY(8)