1997-02-22 14:40:44 +00:00
|
|
|
.\" $Id$
|
1996-07-22 20:56:54 +00:00
|
|
|
.Dd June 1, 1996
|
1996-05-30 16:19:16 +00:00
|
|
|
.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
|
1996-07-22 20:56:54 +00:00
|
|
|
.Op Fl w Ar timeout
|
1996-05-30 16:19:16 +00:00
|
|
|
.Op Fl r Ar addr
|
1996-11-19 20:23:47 +00:00
|
|
|
.Op Fl a Ar secret
|
|
|
|
.Ar host ...
|
|
|
|
|
|
|
|
.Nm
|
|
|
|
.Op Fl t Ar op
|
1996-05-30 16:19:16 +00:00
|
|
|
.Ar host ...
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm Rtquery
|
1996-11-19 20:23:47 +00:00
|
|
|
is used to query a RIP network routing daemon,
|
1996-05-30 16:19:16 +00:00
|
|
|
.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
|
1996-07-22 20:56:54 +00:00
|
|
|
.Ar -p
|
1996-05-30 16:19:16 +00:00
|
|
|
option is specified,
|
|
|
|
.Nm rtquery
|
|
|
|
uses the
|
|
|
|
.Em poll
|
1996-07-22 20:56:54 +00:00
|
|
|
command, an
|
|
|
|
undocumented extension to the RIP protocol supported by
|
|
|
|
.Xr gated 8 .
|
|
|
|
When querying gated, the
|
|
|
|
.Em poll
|
1996-05-30 16:19:16 +00:00
|
|
|
command is preferred over the
|
1997-01-19 17:57:15 +00:00
|
|
|
.Em request
|
1996-05-30 16:19:16 +00:00
|
|
|
command because the response is not subject to Split Horizon and/or
|
1997-01-19 17:57:15 +00:00
|
|
|
Poisoned Reverse, and because some versions of
|
|
|
|
.Xr gated 8
|
|
|
|
do not answer
|
|
|
|
the
|
|
|
|
.Em request
|
|
|
|
command.
|
|
|
|
.Nm Routed
|
|
|
|
does not answer the
|
|
|
|
.Em poll
|
|
|
|
command, but
|
|
|
|
recognizes
|
|
|
|
.Em request
|
|
|
|
commands coming from
|
|
|
|
.Nm
|
|
|
|
and so answers completely.
|
1996-07-22 20:56:54 +00:00
|
|
|
.Pp
|
1997-01-19 17:57:15 +00:00
|
|
|
.Nm Rtquery
|
1996-07-22 20:56:54 +00:00
|
|
|
is also used to turn tracing on or off in
|
1997-01-19 17:57:15 +00:00
|
|
|
.Nm routed .
|
1996-05-30 16:19:16 +00:00
|
|
|
.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
|
1996-07-22 20:56:54 +00:00
|
|
|
.Em Poll
|
1996-05-30 16:19:16 +00:00
|
|
|
command to request full routing information from
|
1997-01-28 05:55:22 +00:00
|
|
|
.Xr gated 8 .
|
1996-07-22 20:56:54 +00:00
|
|
|
This is an undocumented extension RIP protocol supported only by
|
1996-05-30 16:19:16 +00:00
|
|
|
.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
|
1996-07-22 20:56:54 +00:00
|
|
|
.Em addr .
|
1996-11-19 20:23:47 +00:00
|
|
|
.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.
|
1996-07-22 20:56:54 +00:00
|
|
|
.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
|
1996-09-16 16:51:32 +00:00
|
|
|
are generally ignored by the daemon except for a message in the system log.
|
1996-11-19 20:23:47 +00:00
|
|
|
.Xr gated 8
|
|
|
|
is likely to ignore these debugging requests.
|
1996-07-22 20:56:54 +00:00
|
|
|
.El
|
|
|
|
.Bl -tag -width Ds -offset indent-two
|
1996-09-16 16:51:32 +00:00
|
|
|
.It Em on=tracefile
|
1996-07-22 20:56:54 +00:00
|
|
|
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
|
1996-09-16 16:51:32 +00:00
|
|
|
.Pa /etc/routed.trace .
|
1996-07-22 20:56:54 +00:00
|
|
|
.It Em more
|
|
|
|
increases the debugging level.
|
|
|
|
.It Em off
|
|
|
|
turns off tracing.
|
1996-09-16 16:51:32 +00:00
|
|
|
.It Em dump
|
|
|
|
dumps the daemon's routing table to the current tracefile.
|
1996-07-22 20:56:54 +00:00
|
|
|
.El
|
1996-05-30 16:19:16 +00:00
|
|
|
.Sh SEE ALSO
|
1997-01-13 00:25:51 +00:00
|
|
|
.Xr gated 8 ,
|
|
|
|
.Xr routed 8
|
1997-01-19 17:57:15 +00:00
|
|
|
.Rs
|
|
|
|
.%T Routing Information Protcol, RIPV1
|
|
|
|
.%O RFC1058
|
|
|
|
.Re
|
|
|
|
.Rs
|
|
|
|
.%T Routing Information Protocol, RIPv2
|
|
|
|
.%O RFC1723
|
|
|
|
.Re
|