115 lines
2.7 KiB
Groff
115 lines
2.7 KiB
Groff
.\" $Id$
|
|
.Dd June 1, 1996
|
|
.Dt RTQUERY 8
|
|
.Os BSD 4.4
|
|
.Sh NAME
|
|
.Nm rtquery
|
|
.Nd query routing daemons for their routing tables
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl np1
|
|
.Op Fl w Ar timeout
|
|
.Op Fl r Ar addr
|
|
.Op Fl a Ar secret
|
|
.Ar host ...
|
|
|
|
.Nm
|
|
.Op Fl t Ar op
|
|
.Ar host ...
|
|
.Sh DESCRIPTION
|
|
.Nm Rtquery
|
|
is used to query a RIP network routing daemon,
|
|
.Xr routed 8
|
|
or
|
|
.Xr gated 8 ,
|
|
for its routing table by sending a
|
|
.Em request
|
|
or
|
|
.Em poll
|
|
command. The routing information in any routing
|
|
.Em response
|
|
packets returned is displayed numerically and symbolically.
|
|
.Pp
|
|
.Em Rtquery
|
|
by default uses the
|
|
.Em request
|
|
command.
|
|
When the
|
|
.Ar -p
|
|
option is specified,
|
|
.Nm rtquery
|
|
uses the
|
|
.Em poll
|
|
command, an
|
|
undocumented extension to the RIP protocol supported by
|
|
.Xr gated 8 .
|
|
When querying gated, the
|
|
.Em 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
|
|
.Em Rtquery
|
|
is also used to turn tracing on or off in
|
|
.Em routed .
|
|
.Pp
|
|
Options supported by
|
|
.Nm rtquery :
|
|
.Bl -tag -width Ds
|
|
.It Fl n
|
|
Normally network and host numbers are displayed both symbolically
|
|
and numerically.
|
|
The
|
|
.Fl n
|
|
option displays only the numeric network and host numbers.
|
|
.It Fl p
|
|
Uses the
|
|
.Em Poll
|
|
command to request full routing information from
|
|
.Xr gated 8 ,
|
|
This is an undocumented extension RIP protocol supported only by
|
|
.Xr gated 8 .
|
|
.It Fl 1
|
|
query using RIP version 1 instead of RIP version 2.
|
|
.It Fl w Ar timeout
|
|
changes the delay for an answer from each host.
|
|
By default, each host is given 15 seconds to respond.
|
|
.It Fl r Ar addr
|
|
ask about the route to destination
|
|
.Em addr .
|
|
.It Fl a Ar passwd=XXX
|
|
.It Fl a Ar md5_passwd=XXX|KeyID
|
|
cause the query to be sent with the indicated cleartext or MD5 password.
|
|
.It Fl t Ar op
|
|
change tracing, where
|
|
.Em op
|
|
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.
|
|
.Xr gated 8
|
|
is likely to ignore these debugging requests.
|
|
.El
|
|
.Bl -tag -width Ds -offset indent-two
|
|
.It Em on=tracefile
|
|
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
|
|
.Pa /etc/routed.trace .
|
|
.It Em more
|
|
increases the debugging level.
|
|
.It Em off
|
|
turns off tracing.
|
|
.It Em dump
|
|
dumps the daemon's routing table to the current tracefile.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr gated 8 ,
|
|
.Xr routed 8
|
|
.br
|
|
RFC\ 1058 - Routing Information Protocol, RIPv1
|
|
.br
|
|
RFC\ 1723 - Routing Information Protocol, RIPv2
|