1.\" $NetBSD: rtquery.8,v 1.20 2009/09/11 11:44:38 wiz Exp $ 2.\" 3.Dd September 11, 2009 4.Dt RTQUERY 8 5.Os 6.Sh NAME 7.Nm rtquery 8.Nd query routing daemons for their routing tables 9.Sh SYNOPSIS 10.Nm 11.Op Fl 1np 12.Op Fl a Ar secret 13.Op Fl r Ar addr 14.Op Fl w Ar timeout 15.Ar host ... 16.Nm 17.Op Fl t Ar op 18.Ar host ... 19.Sh DESCRIPTION 20.Nm 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. 30The routing information in any routing 31.Em response 32packets returned is displayed numerically and symbolically. 33.Pp 34.Nm 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 gated do not answer the 55.Em request 56command. 57.Xr routed 8 58does not answer the 59.Em poll 60command, but recognizes 61.Em requests 62coming from 63.Nm 64and so answers completely. 65.Pp 66.Nm 67is also used to turn tracing on or off in 68.Xr routed 8 . 69.Pp 70The following options are available: 71.Bl -tag -width indent 72.It Fl n 73displays only the numeric network and host numbers instead of both 74numeric and symbolic. 75.It Fl p 76uses the 77.Em poll 78command to request full routing information from 79.Xr gated 8 . 80This is an undocumented extension RIP protocol supported only by 81.Xr gated 8 . 82.It Fl 1 83queries using RIP version 1 instead of RIP version 2. 84.It Fl w Ar timeout 85changes the delay for an answer from each host. 86By default, each host is given 15 seconds to respond. 87.It Fl r Ar addr 88asks about the route to destination 89.Em addr . 90.It Fl a Ar passwd=XXX 91.It Fl a Ar md5_passwd=XXX|KeyID 92causes the query to be sent with the indicated cleartext or MD5 password. 93.It Fl t Ar op 94changes tracing, where 95.Em op 96is one of the following. 97Requests from processes not running with UID 0 or on distant networks 98are generally ignored by the daemon except for a message in the system log. 99.Xr gated 8 100is likely to ignore these debugging requests. 101.El 102.Bl -tag -width Ds -offset indent-two 103.It Em on=tracefile 104turns tracing on into the specified file. 105That file must usually have been specified when the daemon was 106started or be the same as a fixed name, often 107.Pa /etc/routed.trace . 108.It Em more 109increases the debugging level. 110.It Em off 111turns off tracing. 112.It Em dump 113dumps the daemon's routing table to the current tracefile. 114.El 115.Sh SEE ALSO 116.Xr gated 8 , 117.Xr routed 8 , 118.Pa pkgsrc/net/gated 119.Rs 120.%R RFC 1058 121.%T Routing Information Protocol, RIPv1 122.%D 1988 123.Re 124.Rs 125.%R RFC 1723 126.%T Routing Information Protocol, RIPv2 127.%D 1994 128.Re 129