99 lines
2.7 KiB
Groff
99 lines
2.7 KiB
Groff
'\"macro stdmacro
|
|
.TH RTQUERY 1
|
|
.SH NAME
|
|
rtquery \- query routing daemons for their routing tables
|
|
.SH SYNOPSIS
|
|
\f3rtquery\f1 [\f3\-np1\f1] [\f3\-w \f2timeout\f1] [\f3\-r \f2addr\f1]
|
|
[\f3\-a \f2secret\f1]
|
|
\f2host\f1 \&.\|.\|.
|
|
|
|
\f3rtquery\f1 \f3\-t\f1 \f2op\f1 \f2host\f1 \&.\|.\|.
|
|
.SH DESCRIPTION
|
|
.I Rtquery
|
|
is used to query a RIP network routing daemon,
|
|
.IR routed (1M)
|
|
or
|
|
.IR gated (1M),
|
|
for its routing table by sending a
|
|
.I request
|
|
or
|
|
.I poll
|
|
command. The routing information in any routing
|
|
.I response
|
|
packets returned is displayed numerically and symbolically.
|
|
.PP
|
|
.I Rtquery
|
|
by default uses the
|
|
.I request
|
|
command.
|
|
When the
|
|
.B \-p
|
|
option is specified,
|
|
.I rtquery
|
|
uses the
|
|
.I poll
|
|
command, an
|
|
undocumented extension to the RIP specification supported by
|
|
.IR gated (1M).
|
|
When querying
|
|
.IR gated (1M),
|
|
the
|
|
.I poll
|
|
command is preferred over the
|
|
.I 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. Routed does not answer the Poll command, but
|
|
recognizes Requests coming from rtquery and so answers completely.
|
|
.PP
|
|
.I Rtquery
|
|
is also used to turn tracing on or off in
|
|
.IR routed .
|
|
.SH OPTIONS
|
|
.IP \f3\-n\fP
|
|
Normally network and host numbers are displayed both symbolically
|
|
and numerically. The \f3\-n\f option displays only the numeric
|
|
network and host numbers.
|
|
.IP \f3\-p\fP
|
|
Uses the
|
|
.I Poll
|
|
command to request full routing information from
|
|
.IR gated (1M).
|
|
This is an undocumented extension of the RIP protocol supported only by
|
|
.IR gated (1M).
|
|
.IP \f3\-1\fP
|
|
query using RIP version 1 instead of RIP version 2.
|
|
.IP \f3\-w\ \f2timeout\fP
|
|
changes the delay for an answer from each host.
|
|
By default, each host is given 15 seconds to respond.
|
|
.IP \f3\-r\ \f2addr\fP
|
|
ask about the route to destination \f2addr\fP.
|
|
.IP \f3\-a\ \f2passwd=XXX\f1
|
|
.br
|
|
.IP \f3\-a\ \f2md5_passwd=XXX|KeyID\f1
|
|
cause the query to be sent with the indicated cleartext or MD5 password.
|
|
.IP \f3\-t\ \f2op\fP
|
|
change tracing, where \f2op\fP is one of the following.
|
|
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.
|
|
.IR gated (1M).
|
|
is likely to ignore these debugging requests.
|
|
.RS 5
|
|
.IP \f3on=tracefile\fP
|
|
turn tracing on into the specified file. That file must usually
|
|
have been specified when the daemon was started or be the same
|
|
as a fixed name, often \f2/etc/routed.trace\fP.
|
|
.IP \f3more\fP
|
|
increases the debugging level.
|
|
.IP \f3off\fP
|
|
turns off tracing.
|
|
.IP \f3dump\fP
|
|
dumps the daemon's routing table to the current tracefile.
|
|
.RE
|
|
.SH SEE ALSO
|
|
routed (1M), gated(1M)
|
|
.br
|
|
RFC\ 1058 - Routing Information Protocol, RIPv1
|
|
.br
|
|
RFC\ 1723 - Routing Information Protocol, RIPv2
|