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