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