rtquery.8 revision 1.1 1 .Dd June 1, 1996
2 .Dt RTQUERY 8
3 .Os BSD 4.4
4 .Sh NAME
5 .Nm rtquery
6 .Nd query routing daemons for their routing tables
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl np1
10 .Op Fl w Ar timeout
11 .Op Fl r Ar addr
12 .Ar host ...
13 .Sh DESCRIPTION
14 .Nm Rtquery
15 is used to query a network routing daemon,
16 .Xr routed 8
17 or
18 .Xr gated 8 ,
19 for its routing table by sending a
20 .Em request
21 or
22 .Em poll
23 command. The routing information in any routing
24 .Em response
25 packets returned is displayed numerically and symbolically.
26 .Pp
27 .Em Rtquery
28 by default uses the
29 .Em request
30 command.
31 When the
32 .Ar -p
33 option is specified,
34 .Nm rtquery
35 uses the
36 .Em poll
37 command, an
38 undocumented extension to the RIP protocol supported by
39 .Xr gated 8 .
40 When querying gated, the
41 .Em poll
42 command is preferred over the
43 .I Request
44 command because the response is not subject to Split Horizon and/or
45 Poisoned Reverse, and because some versions of gated do not answer
46 the Request command. Routed does not answer the Poll command, but
47 recognizes Requests coming from rtquery and so answers completely.
48 .Pp
49 .Em Rtquery
50 is also used to turn tracing on or off in
51 .Em routed .
52 .Pp
53 Options supported by
54 .Nm rtquery :
55 .Bl -tag -width Ds
56 .It Fl n
57 Normally network and host numbers are displayed both symbolically
58 and numerically.
59 The
60 .Fl n
61 option displays only the numeric network and host numbers.
62 .It Fl p
63 Uses the
64 .Em Poll
65 command to request full routing information from
66 .Xr gated 8 ,
67 This is an undocumented extension RIP protocol supported only by
68 .Xr gated 8 .
69 .It Fl 1
70 query using RIP version 1 instead of RIP version 2.
71 .It Fl w Ar timeout
72 changes the delay for an answer from each host.
73 By default, each host is given 15 seconds to respond.
74 .It Fl r Ar addr
75 ask about the route to destination
76 .Em addr .
77 .It Fl t Ar op
78 change tracing, where
79 .Em op
80 is one of the following.
81 Requests from processes not running with UID 0 or on distant networks
82 are generally ignored.
83 .El
84 .Bl -tag -width Ds -offset indent-two
85 .It Em on=filename
86 turn tracing on into the specified file. That file must usually
87 have been specified when the daemon was started or be the same
88 as a fixed name, often
89 .Pa /tmp/routed.log .
90 .It Em more
91 increases the debugging level.
92 .It Em off
93 turns off tracing.
94 .El
95 .Sh SEE ALSO
96 .Xr routed 8 ,
97 .Xr gated 8 .
98 .br
99 RFC\ 1058 - Routing Information Protocol, RIPv1
100 .br
101 RFC\ 1723 - Routing Information Protocol, RIPv2
102