summaryrefslogtreecommitdiff
path: root/sbin/routed/rtquery/rtquery.8
diff options
context:
space:
mode:
Diffstat (limited to 'sbin/routed/rtquery/rtquery.8')
-rw-r--r--sbin/routed/rtquery/rtquery.874
1 files changed, 42 insertions, 32 deletions
diff --git a/sbin/routed/rtquery/rtquery.8 b/sbin/routed/rtquery/rtquery.8
index 7227bc41157f..2cf931eecc60 100644
--- a/sbin/routed/rtquery/rtquery.8
+++ b/sbin/routed/rtquery/rtquery.8
@@ -1,3 +1,6 @@
+.\" $Revision: 2.17 $
+.\" $NetBSD: rtquery.8,v 1.14 1999/02/23 10:47:41 christos Exp $
+.\"
.Dd June 1, 1996
.Dt RTQUERY 8
.Os BSD 4.4
@@ -11,7 +14,7 @@
.Op Fl r Ar addr
.Op Fl a Ar secret
.Ar host ...
-
+.br
.Nm
.Op Fl t Ar op
.Ar host ...
@@ -25,77 +28,84 @@ for its routing table by sending a
.Em request
or
.Em poll
-command. The routing information in any routing
+command.
+The routing information in any routing
.Em response
packets returned is displayed numerically and symbolically.
.Pp
-.Em Rtquery
+.Nm Rtquery
by default uses the
.Em request
command.
When the
-.Ar -p
+.Fl p
option is specified,
-.Nm rtquery
+.Nm
uses the
.Em poll
command, an
undocumented extension to the RIP protocol supported by
.Xr gated 8 .
-When querying gated, the
+When querying
+.Xr gated 8 ,
+the
.Em poll
command is preferred over the
-.I Request
+.Em 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.
+Poisoned Reverse, and because some versions of gated do not answer the
+.Em request
+command.
+.Xr Routed 8
+does not answer the
+.Em poll
+command, but recognizes
+.Em requests
+coming from
+.Nm
+and so answers completely.
.Pp
-.Em Rtquery
+.Nm Rtquery
is also used to turn tracing on or off in
-.Em routed .
+.Xr routed 8 .
.Pp
-Options supported by
-.Nm rtquery :
-.Bl -tag -width Ds
+The following options are available:
+.Bl -tag -width indent
.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.
+displays only the numeric network and host numbers instead of both
+numeric and symbolic.
.It Fl p
-Uses the
-.Em Poll
+uses the
+.Em poll
command to request full routing information from
-.Xr gated 8 ,
+.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.
+queries 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
+asks 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.
+causes the query to be sent with the indicated cleartext or MD5 password.
.It Fl t Ar op
-change tracing, where
+changes 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
+.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
+turns 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.
@@ -106,7 +116,7 @@ dumps the daemon's routing table to the current tracefile.
.El
.Sh SEE ALSO
.Xr routed 8 ,
-.Xr gated 8 .
+.Xr gated 8
.br
RFC\ 1058 - Routing Information Protocol, RIPv1
.br