Rename boot_i386.8 to boot_pc32.8 by repo-copy in order to enable the
[dragonfly.git] / sbin / routed / rtquery / rtquery.8
CommitLineData
984263bc
MD
1.\" $Revision: 1.10 $
2.\" $FreeBSD: src/sbin/routed/rtquery/rtquery.8,v 1.11.2.4 2003/05/10 23:22:48 murray Exp $
1de703da 3.\" $DragonFly: src/sbin/routed/rtquery/rtquery.8,v 1.2 2003/06/17 04:27:34 dillon Exp $
984263bc
MD
4.\"
5.Dd June 1, 1996
6.Dt RTQUERY 8
7.Os
8.Sh NAME
9.Nm rtquery
10.Nd query routing daemons for their routing tables
11.Sh SYNOPSIS
12.Nm
13.Op Fl np1
14.Op Fl w Ar timeout
15.Op Fl r Ar addr
16.Op Fl a Ar secret
17.Ar host ...
18.Nm
19.Op Fl t Ar op
20.Ar host ...
21.Sh DESCRIPTION
22The
23.Nm
24utility is used to query a RIP network routing daemon, such as
25.Xr routed 8 ,
26for its routing table by sending a
27.Em request
28or
29.Em poll
30command.
31The routing information in any routing
32.Em response
33packets returned is displayed numerically and symbolically.
34.Pp
35The
36.Nm
37utility by default uses the
38.Em request
39command.
40When the
41.Fl p
42option is specified,
43.Nm
44uses the
45.Em poll
46command, an
47undocumented extension to the RIP protocol supported by
48the commercial
49.Li gated
50routing product.
51When querying
52.Li gated ,
53the
54.Em poll
55command is preferred over the
56.Em request
57command because the response is not subject to Split Horizon and/or
58Poisoned Reverse, and because some versions of
59.Li gated
60do not answer the
61.Em request
62command.
63.Xr Routed 8
64does not answer the
65.Em poll
66command, but recognizes
67.Em requests
68coming from
69.Nm
70and so answers completely.
71.Pp
72The
73.Nm
74utility is also used to turn tracing on or off in
75.Xr routed 8 .
76.Pp
77The following options are available:
78.Bl -tag -width indent
79.It Fl n
80displays only the numeric network and host numbers instead of both
81numeric and symbolic.
82.It Fl p
83uses the
84.Em poll
85command to request full routing information from
86.Li gated .
87This is an undocumented extension RIP protocol supported only by
88.Li gated .
89.It Fl 1
90queries using RIP version 1 instead of RIP version 2.
91.It Fl w Ar timeout
92changes the delay for an answer from each host.
93By default, each host is given 15 seconds to respond.
94.It Fl r Ar addr
95asks about the route to destination
96.Em addr .
97.It Fl a Ar passwd=XXX
98.It Fl a Ar md5_passwd=XXX|KeyID
99causes the query to be sent with the indicated cleartext or MD5 password.
100.It Fl t Ar op
101changes tracing, where
102.Em op
103is one of the following.
104Requests from processes not running with UID 0 or on distant networks
105are generally ignored by the daemon except for a message in the system log.
106.Li gated
107is likely to ignore these debugging requests.
108.El
109.Bl -tag -width Ds -offset indent-two
110.It Em on=tracefile
111turns tracing on into the specified file.
112That file must usually have been specified when the daemon was
113started or be the same as a fixed name, often
114.Pa /etc/routed.trace .
115.It Em more
116increases the debugging level.
117.It Em off
118turns off tracing.
119.It Em dump
120dumps the daemon's routing table to the current tracefile.
121.El
122.Sh SEE ALSO
123.Xr routed 8
124.Rs
125.%T Routing Information Protocol, RIPv1
126.%O RFC1058
127.Re
128.Rs
129.%T Routing Information Protocol, RIPv2
130.%O RFC1723
131.Re