summaryrefslogtreecommitdiffstats
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.885
1 files changed, 38 insertions, 47 deletions
diff --git a/sbin/routed/rtquery/rtquery.8 b/sbin/routed/rtquery/rtquery.8
index 4c51c8f..1f16d59 100644
--- a/sbin/routed/rtquery/rtquery.8
+++ b/sbin/routed/rtquery/rtquery.8
@@ -1,4 +1,6 @@
-.\" $Id: rtquery.8,v 1.7 1997/06/13 20:58:09 max Exp $
+.\" $Revision: 2.17 $
+.\" $Id$
+.\"
.Dd June 1, 1996
.Dt RTQUERY 8
.Os BSD 4.4
@@ -6,17 +8,16 @@
.Nm rtquery
.Nd query routing daemons for their routing tables
.Sh SYNOPSIS
-.Nm rtquery
+.Nm
.Op Fl np1
.Op Fl w Ar timeout
.Op Fl r Ar addr
.Op Fl a Ar secret
-.Ar host
-.Ar
-.Nm rtquery
+.Ar host ...
+.br
+.Nm
.Op Fl t Ar op
-.Ar host
-.Ar
+.Ar host ...
.Sh DESCRIPTION
.Nm Rtquery
is used to query a RIP network routing daemon,
@@ -27,7 +28,8 @@ 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
@@ -51,82 +53,71 @@ the
command is preferred over the
.Em request
command because the response is not subject to Split Horizon and/or
-Poisoned Reverse, and because some versions of
-.Xr gated 8
-do not answer
-the
+Poisoned Reverse, and because some versions of gated do not answer the
.Em request
command.
-.Nm Routed
+.Xr Routed 8
does not answer the
.Em poll
-command, but
-recognizes
-.Em request
-commands coming from
+command, but recognizes
+.Em requests
+coming from
.Nm
and so answers completely.
.Pp
.Nm Rtquery
is also used to turn tracing on or off in
-.Nm routed .
+.Xr routed 8 .
.Pp
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
-Use the
-.Em Poll
+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.
+queries using RIP version 1 instead of RIP version 2.
.It Fl w Ar timeout
-Change the delay for an answer from each host.
+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
-Increase the debugging level.
+increases the debugging level.
.It Em off
-Turn off tracing.
+turns off tracing.
.It Em dump
-Dump the daemon's routing table to the current tracefile.
+dumps the daemon's routing table to the current tracefile.
.El
.Sh SEE ALSO
-.Xr gated 8 ,
-.Xr routed 8
-.Rs
-.%T Routing Information Protocol, RIPV1
-.%O RFC1058
-.Re
-.Rs
-.%T Routing Information Protocol, RIPv2
-.%O RFC1723
-.Re
+.Xr routed 8 ,
+.Xr gated 8
+.br
+RFC\ 1058 - Routing Information Protocol, RIPv1
+.br
+RFC\ 1723 - Routing Information Protocol, RIPv2
OpenPOWER on IntegriCloud