Home | History | Annotate | Line # | Download | only in rtquery
rtquery.8 revision 1.1
      1 .Dd June 1, 1996
      2 .Dt RTQUERY 8
      3 .Os BSD 4.4
      4 .Sh NAME
      5 .Nm rtquery
      6 .Nd query routing daemons for their routing tables
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl np1
     10 .Op Fl w Ar timeout
     11 .Op Fl r Ar addr
     12 .Ar host ...
     13 .Sh DESCRIPTION
     14 .Nm Rtquery
     15 is used to query a network routing daemon,
     16 .Xr routed 8
     17 or
     18 .Xr gated 8 ,
     19 for its routing table by sending a
     20 .Em request
     21 or
     22 .Em poll
     23 command.  The routing information in any routing
     24 .Em response
     25 packets returned is displayed numerically and symbolically.
     26 .Pp
     27 .Em Rtquery
     28 by default uses the
     29 .Em request
     30 command.
     31 When the
     32 .Ar -p
     33 option is specified,
     34 .Nm rtquery
     35 uses the
     36 .Em poll
     37 command, an
     38 undocumented extension to the RIP protocol supported by
     39 .Xr gated 8 .
     40 When querying gated, the
     41 .Em poll
     42 command is preferred over the
     43 .I Request
     44 command because the response is not subject to Split Horizon and/or
     45 Poisoned Reverse, and because some versions of gated do not answer
     46 the Request command.  Routed does not answer the Poll command, but
     47 recognizes Requests coming from rtquery and so answers completely.
     48 .Pp
     49 .Em Rtquery
     50 is also used to turn tracing on or off in
     51 .Em routed .
     52 .Pp
     53 Options supported by
     54 .Nm rtquery :
     55 .Bl -tag -width Ds
     56 .It Fl n
     57 Normally network and host numbers are displayed both symbolically
     58 and numerically.
     59 The
     60 .Fl n
     61 option displays only the numeric network and host numbers.
     62 .It Fl p
     63 Uses the
     64 .Em Poll
     65 command to request full routing information from
     66 .Xr gated 8 ,
     67 This is an undocumented extension RIP protocol supported only by
     68 .Xr gated 8 .
     69 .It Fl 1
     70 query using RIP version 1 instead of RIP version 2.
     71 .It Fl w Ar timeout
     72 changes the delay for an answer from each host.
     73 By default, each host is given 15 seconds to respond.
     74 .It Fl r Ar addr
     75 ask about the route to destination
     76 .Em addr .
     77 .It Fl t Ar op
     78 change tracing, where
     79 .Em op
     80 is one of the following.
     81 Requests from processes not running with UID 0 or on distant networks
     82 are generally ignored.
     83 .El
     84 .Bl -tag -width Ds -offset indent-two
     85 .It Em on=filename
     86 turn tracing on into the specified file.  That file must usually
     87 have been specified when the daemon was started or be the same
     88 as a fixed name, often
     89 .Pa /tmp/routed.log .
     90 .It Em more
     91 increases the debugging level.
     92 .It Em off
     93 turns off tracing.
     94 .El
     95 .Sh SEE ALSO
     96 .Xr routed 8 ,
     97 .Xr gated 8 .
     98 .br
     99 RFC\ 1058 - Routing Information Protocol, RIPv1
    100 .br
    101 RFC\ 1723 - Routing Information Protocol, RIPv2
    102