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