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