1.\" $NetBSD: rtquery.8,v 1.6 1997/02/03 22:03:18 christos Exp $ 2.\" 3.Dd June 1, 1996 4.Dt RTQUERY 8 5.Os BSD 4.4 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 17.Nm 18.Op Fl t Ar op 19.Ar host ... 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.Em Rtquery 35by default uses the 36.Em request 37command. 38When the 39.Ar -p 40option is specified, 41.Nm rtquery 42uses the 43.Em poll 44command, an 45undocumented extension to the RIP protocol supported by 46.Xr gated 8 . 47When querying gated, the 48.Em poll 49command is preferred over the 50.Em Request 51command because the response is not subject to Split Horizon and/or 52Poisoned Reverse, and because some versions of gated do not answer 53the Request command. Routed does not answer the Poll command, but 54recognizes Requests coming from rtquery and so answers completely. 55.Pp 56.Em Rtquery 57is also used to turn tracing on or off in 58.Em routed . 59.Pp 60Options supported by 61.Nm rtquery : 62.Bl -tag -width Ds 63.It Fl n 64Normally network and host numbers are displayed both symbolically 65and numerically. 66The 67.Fl n 68option displays only the numeric network and host numbers. 69.It Fl p 70Uses the 71.Em Poll 72command to request full routing information from 73.Xr gated 8 . 74This is an undocumented extension RIP protocol supported only by 75.Xr gated 8 . 76.It Fl 1 77query using RIP version 1 instead of RIP version 2. 78.It Fl w Ar timeout 79changes the delay for an answer from each host. 80By default, each host is given 15 seconds to respond. 81.It Fl r Ar addr 82ask about the route to destination 83.Em addr . 84.It Fl a Ar passwd=XXX 85.It Fl a Ar md5_passwd=XXX|KeyID 86cause the query to be sent with the indicated cleartext or MD5 password. 87.It Fl t Ar op 88change tracing, where 89.Em op 90is one of the following. 91Requests from processes not running with UID 0 or on distant networks 92are generally ignored by the daemon except for a message in the system log. 93.Xr gated 8 94is likely to ignore these debugging requests. 95.El 96.Bl -tag -width Ds -offset indent-two 97.It Em on=tracefile 98turn tracing on into the specified file. That file must usually 99have been specified when the daemon was started or be the same 100as a fixed name, often 101.Pa /etc/routed.trace . 102.It Em more 103increases the debugging level. 104.It Em off 105turns off tracing. 106.It Em dump 107dumps the daemon's routing table to the current tracefile. 108.El 109.Sh SEE ALSO 110.Xr routed 8 , 111.Xr gated 8 . 112.br 113RFC\ 1058 - Routing Information Protocol, RIPv1 114.br 115RFC\ 1723 - Routing Information Protocol, RIPv2 116