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