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