1*86d7f5d3SJohn Marino.\" $Revision: 1.10 $ 2*86d7f5d3SJohn Marino.\" $FreeBSD: src/sbin/routed/rtquery/rtquery.8,v 1.11.2.4 2003/05/10 23:22:48 murray Exp $ 3*86d7f5d3SJohn Marino.\" $DragonFly: src/sbin/routed/rtquery/rtquery.8,v 1.3 2007/11/23 23:16:36 swildner Exp $ 4*86d7f5d3SJohn Marino.\" 5*86d7f5d3SJohn Marino.Dd June 1, 1996 6*86d7f5d3SJohn Marino.Dt RTQUERY 8 7*86d7f5d3SJohn Marino.Os 8*86d7f5d3SJohn Marino.Sh NAME 9*86d7f5d3SJohn Marino.Nm rtquery 10*86d7f5d3SJohn Marino.Nd query routing daemons for their routing tables 11*86d7f5d3SJohn Marino.Sh SYNOPSIS 12*86d7f5d3SJohn Marino.Nm 13*86d7f5d3SJohn Marino.Op Fl np1 14*86d7f5d3SJohn Marino.Op Fl w Ar timeout 15*86d7f5d3SJohn Marino.Op Fl r Ar addr 16*86d7f5d3SJohn Marino.Op Fl a Ar secret 17*86d7f5d3SJohn Marino.Ar host ... 18*86d7f5d3SJohn Marino.Nm 19*86d7f5d3SJohn Marino.Op Fl t Ar op 20*86d7f5d3SJohn Marino.Ar host ... 21*86d7f5d3SJohn Marino.Sh DESCRIPTION 22*86d7f5d3SJohn MarinoThe 23*86d7f5d3SJohn Marino.Nm 24*86d7f5d3SJohn Marinoutility is used to query a RIP network routing daemon, such as 25*86d7f5d3SJohn Marino.Xr routed 8 , 26*86d7f5d3SJohn Marinofor its routing table by sending a 27*86d7f5d3SJohn Marino.Em request 28*86d7f5d3SJohn Marinoor 29*86d7f5d3SJohn Marino.Em poll 30*86d7f5d3SJohn Marinocommand. 31*86d7f5d3SJohn MarinoThe routing information in any routing 32*86d7f5d3SJohn Marino.Em response 33*86d7f5d3SJohn Marinopackets returned is displayed numerically and symbolically. 34*86d7f5d3SJohn Marino.Pp 35*86d7f5d3SJohn MarinoThe 36*86d7f5d3SJohn Marino.Nm 37*86d7f5d3SJohn Marinoutility by default uses the 38*86d7f5d3SJohn Marino.Em request 39*86d7f5d3SJohn Marinocommand. 40*86d7f5d3SJohn MarinoWhen the 41*86d7f5d3SJohn Marino.Fl p 42*86d7f5d3SJohn Marinooption is specified, 43*86d7f5d3SJohn Marino.Nm 44*86d7f5d3SJohn Marinouses the 45*86d7f5d3SJohn Marino.Em poll 46*86d7f5d3SJohn Marinocommand, an 47*86d7f5d3SJohn Marinoundocumented extension to the RIP protocol supported by 48*86d7f5d3SJohn Marinothe commercial 49*86d7f5d3SJohn Marino.Li gated 50*86d7f5d3SJohn Marinorouting product. 51*86d7f5d3SJohn MarinoWhen querying 52*86d7f5d3SJohn Marino.Li gated , 53*86d7f5d3SJohn Marinothe 54*86d7f5d3SJohn Marino.Em poll 55*86d7f5d3SJohn Marinocommand is preferred over the 56*86d7f5d3SJohn Marino.Em request 57*86d7f5d3SJohn Marinocommand because the response is not subject to Split Horizon and/or 58*86d7f5d3SJohn MarinoPoisoned Reverse, and because some versions of 59*86d7f5d3SJohn Marino.Li gated 60*86d7f5d3SJohn Marinodo not answer the 61*86d7f5d3SJohn Marino.Em request 62*86d7f5d3SJohn Marinocommand. 63*86d7f5d3SJohn Marino.Xr Routed 8 64*86d7f5d3SJohn Marinodoes not answer the 65*86d7f5d3SJohn Marino.Em poll 66*86d7f5d3SJohn Marinocommand, but recognizes 67*86d7f5d3SJohn Marino.Em requests 68*86d7f5d3SJohn Marinocoming from 69*86d7f5d3SJohn Marino.Nm 70*86d7f5d3SJohn Marinoand so answers completely. 71*86d7f5d3SJohn Marino.Pp 72*86d7f5d3SJohn MarinoThe 73*86d7f5d3SJohn Marino.Nm 74*86d7f5d3SJohn Marinoutility is also used to turn tracing on or off in 75*86d7f5d3SJohn Marino.Xr routed 8 . 76*86d7f5d3SJohn Marino.Pp 77*86d7f5d3SJohn MarinoThe following options are available: 78*86d7f5d3SJohn Marino.Bl -tag -width indent 79*86d7f5d3SJohn Marino.It Fl n 80*86d7f5d3SJohn Marinodisplays only the numeric network and host numbers instead of both 81*86d7f5d3SJohn Marinonumeric and symbolic. 82*86d7f5d3SJohn Marino.It Fl p 83*86d7f5d3SJohn Marinouses the 84*86d7f5d3SJohn Marino.Em poll 85*86d7f5d3SJohn Marinocommand to request full routing information from 86*86d7f5d3SJohn Marino.Li gated . 87*86d7f5d3SJohn MarinoThis is an undocumented extension RIP protocol supported only by 88*86d7f5d3SJohn Marino.Li gated . 89*86d7f5d3SJohn Marino.It Fl 1 90*86d7f5d3SJohn Marinoqueries using RIP version 1 instead of RIP version 2. 91*86d7f5d3SJohn Marino.It Fl w Ar timeout 92*86d7f5d3SJohn Marinochanges the delay for an answer from each host. 93*86d7f5d3SJohn MarinoBy default, each host is given 15 seconds to respond. 94*86d7f5d3SJohn Marino.It Fl r Ar addr 95*86d7f5d3SJohn Marinoasks about the route to destination 96*86d7f5d3SJohn Marino.Em addr . 97*86d7f5d3SJohn Marino.It Fl a Ar passwd=XXX 98*86d7f5d3SJohn Marino.It Fl a Ar md5_passwd=XXX|KeyID 99*86d7f5d3SJohn Marinocauses the query to be sent with the indicated cleartext or MD5 password. 100*86d7f5d3SJohn Marino.It Fl t Ar op 101*86d7f5d3SJohn Marinochanges tracing, where 102*86d7f5d3SJohn Marino.Em op 103*86d7f5d3SJohn Marinois one of the following. 104*86d7f5d3SJohn MarinoRequests from processes not running with UID 0 or on distant networks 105*86d7f5d3SJohn Marinoare generally ignored by the daemon except for a message in the system log. 106*86d7f5d3SJohn Marino.Li gated 107*86d7f5d3SJohn Marinois likely to ignore these debugging requests. 108*86d7f5d3SJohn Marino.El 109*86d7f5d3SJohn Marino.Bl -tag -width Ds -offset indent-two 110*86d7f5d3SJohn Marino.It Em on=tracefile 111*86d7f5d3SJohn Marinoturns tracing on into the specified file. 112*86d7f5d3SJohn MarinoThat file must usually have been specified when the daemon was 113*86d7f5d3SJohn Marinostarted or be the same as a fixed name, often 114*86d7f5d3SJohn Marino.Pa /etc/routed.trace . 115*86d7f5d3SJohn Marino.It Em more 116*86d7f5d3SJohn Marinoincreases the debugging level. 117*86d7f5d3SJohn Marino.It Em off 118*86d7f5d3SJohn Marinoturns off tracing. 119*86d7f5d3SJohn Marino.It Em dump 120*86d7f5d3SJohn Marinodumps the daemon's routing table to the current tracefile. 121*86d7f5d3SJohn Marino.El 122*86d7f5d3SJohn Marino.Sh SEE ALSO 123*86d7f5d3SJohn Marino.Xr routed 8 124*86d7f5d3SJohn Marino.Rs 125*86d7f5d3SJohn Marino.%T Routing Information Protocol, RIPv1 126*86d7f5d3SJohn Marino.%O RFC 1058 127*86d7f5d3SJohn Marino.Re 128*86d7f5d3SJohn Marino.Rs 129*86d7f5d3SJohn Marino.%T Routing Information Protocol, RIPv2 130*86d7f5d3SJohn Marino.%O RFC 1723 131*86d7f5d3SJohn Marino.Re 132