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