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