RTQUERY(8)              OpenBSD System Manager's Manual             RTQUERY(8)

NAME
     rtquery - query routing daemons for their routing tables



SYNOPSIS
     rtquery [-np1] [-w timeout] [-r addr] host ...

DESCRIPTION
     Rtquery is used to query a 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 displayed numeri-
     cally 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 does not answer
     the Poll command, but recognizes Requests coming from rtquery and so an-
     swers completely.

     Rtquery is also used to turn tracing on or off in routed.

     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.

     -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.

               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