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 [-np1] [-w timeout] [-r addr] [-a secret] 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, the poll com-
     mand 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 an-
     swer 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).

     Options supported by rtquery:

     -n      Normally network and host numbers are displayed both symbolically
             and numerically.  The -n option displays only the numeric network
             and host numbers.

     -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      query 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
             ask about the route to destination addr.

     -a passwd=XXX

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

     -t op   change 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
                       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
                       /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

     routed(8),  gated(8)
     RFC 1058 - Routing Information Protocol, RIPv1
     RFC 1723 - Routing Information Protocol, RIPv2

4.4BSD                           June 1, 1996                                2