rtquery(8) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
RTQUERY(8)              NetBSD System Manager's Manual              RTQUERY(8)


NAME

     rtquery -- query routing daemons for their routing tables


SYNOPSIS

     rtquery [-1np] [-a secret] [-r addr] [-w timeout] host ...
     rtquery [-t op] host ...


DESCRIPTION

     rtquery is used to query a RIP network routing daemon, routed(8) or
     gated(8), for its routing table by sending a request or poll command.
     The routing information in any routing response packets returned is dis-
     played numerically and symbolically.

     rtquery by default uses the request command.  When the -p option is spec-
     ified, rtquery uses the poll command, an undocumented extension to the
     RIP protocol supported by gated(8).  When querying gated(8), the poll
     command is preferred over the request command because the response is not
     subject to Split Horizon and/or Poisoned Reverse, and because some ver-
     sions of gated do not answer the request command.  routed(8) does not
     answer the poll command, but recognizes requests coming from rtquery and
     so answers completely.

     rtquery is also used to turn tracing on or off in routed(8).

     The following options are available:

     -n      displays only the numeric network and host numbers instead of
             both numeric and symbolic.

     -p      uses the poll command to request full routing information from
             gated(8).  This is an undocumented extension RIP protocol sup-
             ported only by gated(8).

     -1      queries using RIP version 1 instead of RIP version 2.

     -w timeout
             changes the delay for an answer from each host.  By default, each
             host is given 15 seconds to respond.

     -r addr
             asks about the route to destination addr.

     -a passwd=XXX

     -a md5_passwd=XXX|KeyID
             causes the query to be sent with the indicated cleartext or MD5
             password.

     -t op   changes tracing, where op is one of the following.  Requests from
             processes not running with UID 0 or on distant networks are gen-
             erally ignored by the daemon except for a message in the system
             log.  gated(8) is likely to ignore these debugging requests.

               on=tracefile
                       turns 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
                       /etc/routed.trace.

               more    increases the debugging level.

               off     turns off tracing.

               dump    dumps the daemon's routing table to the current trace-
                       file.


SEE ALSO

     gated(8), routed(8), pkgsrc/net/gated

     Routing Information Protocol, RIPv1, RFC 1058, 1988.

     Routing Information Protocol, RIPv2, RFC 1723, 1994.

NetBSD 6.1.2                  September 11, 2009                  NetBSD 6.1.2