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