.Dd June 1, 1996 .Dt RTQUERY 8 .Os BSD 4.4 .Sh NAME .Nm rtquery .Nd query routing daemons for their routing tables .Sh SYNOPSIS .Nm .Op Fl np1 .Op Fl w Ar timeout .Op Fl r Ar addr .Op Fl a Ar secret .Ar host ... .Nm .Op Fl t Ar op .Ar host ... .Sh DESCRIPTION .Nm Rtquery is used to query a RIP network routing daemon, .Xr routed 8 or .Xr gated 8 , for its routing table by sending a .Em request or .Em poll command. The routing information in any routing .Em response packets returned is displayed numerically and symbolically.
p .Em Rtquery by default uses the .Em request command. When the .Ar -p option is specified, .Nm rtquery uses the .Em poll command, an undocumented extension to the RIP protocol supported by .Xr gated 8 . When querying gated, the .Em poll command is preferred over the .Em request command because the response is not subject to Split Horizon and/or Poisoned Reverse, and because some versions of .Xr gated 8 do not answer the .Em request command. .Nm Routed does not answer the .Em poll command, but recognizes .Em request commands coming from .Nm and so answers completely.
p .Nm Rtquery is also used to turn tracing on or off in .Nm routed .
p Options supported by .Nm rtquery : l -tag -width Ds t Fl n Normally network and host numbers are displayed both symbolically and numerically. The .Fl n option displays only the numeric network and host numbers. t Fl p Uses the .Em Poll command to request full routing information from .Xr gated 8 , This is an undocumented extension RIP protocol supported only by .Xr gated 8 . t Fl 1 query using RIP version 1 instead of RIP version 2. t Fl w Ar timeout changes the delay for an answer from each host. By default, each host is given 15 seconds to respond. t Fl r Ar addr ask about the route to destination .Em addr . t Fl a Ar passwd=XXX t Fl a Ar md5_passwd=XXX|KeyID cause the query to be sent with the indicated cleartext or MD5 password. t Fl t Ar op change tracing, where .Em op is one of the following. Requests from processes not running with UID 0 or on distant networks are generally ignored by the daemon except for a message in the system log. .Xr gated 8 is likely to ignore these debugging requests. .El l -tag -width Ds -offset indent-two t Em on=tracefile turn tracing on into the specified file. That file must usually have been specified when the daemon was started or be the same as a fixed name, often
a /etc/routed.trace . t Em more increases the debugging level. t Em off turns off tracing. t Em dump dumps the daemon's routing table to the current tracefile. .El .Sh SEE ALSO .Xr gated 8 , .Xr routed 8 .Rs .%T Routing Information Protcol, RIPV1 .%O RFC1058 .Re .Rs .%T Routing Information Protocol, RIPv2 .%O RFC1723 .Re