1.\" $Revision: 1.10 $ 2.\" $FreeBSD: src/sbin/routed/rtquery/rtquery.8,v 1.11.2.4 2003/05/10 23:22:48 murray Exp $ 3.\" $DragonFly: src/sbin/routed/rtquery/rtquery.8,v 1.3 2007/11/23 23:16:36 swildner Exp $ 4.\" 5.Dd June 1, 1996 6.Dt RTQUERY 8 7.Os 8.Sh NAME 9.Nm rtquery 10.Nd query routing daemons for their routing tables 11.Sh SYNOPSIS 12.Nm 13.Op Fl np1 14.Op Fl w Ar timeout 15.Op Fl r Ar addr 16.Op Fl a Ar secret 17.Ar host ... 18.Nm 19.Op Fl t Ar op 20.Ar host ... 21.Sh DESCRIPTION 22The 23.Nm 24utility is used to query a RIP network routing daemon, such as 25.Xr routed 8 , 26for its routing table by sending a 27.Em request 28or 29.Em poll 30command. 31The routing information in any routing 32.Em response 33packets returned is displayed numerically and symbolically. 34.Pp 35The 36.Nm 37utility by 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 48the commercial 49.Li gated 50routing product. 51When querying 52.Li gated , 53the 54.Em poll 55command is preferred over the 56.Em request 57command because the response is not subject to Split Horizon and/or 58Poisoned Reverse, and because some versions of 59.Li gated 60do not answer the 61.Em request 62command. 63.Xr Routed 8 64does not answer the 65.Em poll 66command, but recognizes 67.Em requests 68coming from 69.Nm 70and so answers completely. 71.Pp 72The 73.Nm 74utility is also used to turn tracing on or off in 75.Xr routed 8 . 76.Pp 77The following options are available: 78.Bl -tag -width indent 79.It Fl n 80displays only the numeric network and host numbers instead of both 81numeric and symbolic. 82.It Fl p 83uses the 84.Em poll 85command to request full routing information from 86.Li gated . 87This is an undocumented extension RIP protocol supported only by 88.Li gated . 89.It Fl 1 90queries using RIP version 1 instead of RIP version 2. 91.It Fl w Ar timeout 92changes the delay for an answer from each host. 93By default, each host is given 15 seconds to respond. 94.It Fl r Ar addr 95asks about the route to destination 96.Em addr . 97.It Fl a Ar passwd=XXX 98.It Fl a Ar md5_passwd=XXX|KeyID 99causes the query to be sent with the indicated cleartext or MD5 password. 100.It Fl t Ar op 101changes 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.Li gated 107is likely to ignore these debugging requests. 108.El 109.Bl -tag -width Ds -offset indent-two 110.It Em on=tracefile 111turns tracing on into the specified file. 112That file must usually have been specified when the daemon was 113started or be the same as a fixed name, often 114.Pa /etc/routed.trace . 115.It Em more 116increases the debugging level. 117.It Em off 118turns off tracing. 119.It Em dump 120dumps the daemon's routing table to the current tracefile. 121.El 122.Sh SEE ALSO 123.Xr routed 8 124.Rs 125.%T Routing Information Protocol, RIPv1 126.%O RFC 1058 127.Re 128.Rs 129.%T Routing Information Protocol, RIPv2 130.%O RFC 1723 131.Re 132