sbin/routed/rtquery/rtquery.8

   1 .\" $Revision: 1.10 $
   2 .\" $FreeBSD: src/sbin/routed/rtquery/rtquery.8,v 1.11.2.4 2003/05/10 23:22:48 murray Exp $
   3 .\"
   4 .Dd June 1, 1996
   5 .Dt RTQUERY 8
   6 .Os
   7 .Sh NAME
   8 .Nm rtquery
   9 .Nd query routing daemons for their routing tables
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Fl np1
  13 .Op Fl w Ar timeout
  14 .Op Fl r Ar addr
  15 .Op Fl a Ar secret
  16 .Ar host ...
  17 .Nm
  18 .Op Fl t Ar op
  19 .Ar host ...
  20 .Sh DESCRIPTION
  21 The
  22 .Nm
  23 utility is used to query a RIP network routing daemon, such as
  24 .Xr routed 8 ,
  25 for its routing table by sending a
  26 .Em request
  27 or
  28 .Em poll
  29 command.
  30 The routing information in any routing
  31 .Em response
  32 packets returned is displayed numerically and symbolically.
  33 .Pp
  34 The
  35 .Nm
  36 utility by default uses the
  37 .Em request
  38 command.
  39 When the
  40 .Fl p
  41 option is specified,
  42 .Nm
  43 uses the
  44 .Em poll
  45 command, an
  46 undocumented extension to the RIP protocol supported by
  47 the commercial
  48 .Li gated
  49 routing product.
  50 When querying
  51 .Li gated ,
  52 the
  53 .Em poll
  54 command is preferred over the
  55 .Em request
  56 command because the response is not subject to Split Horizon and/or
  57 Poisoned Reverse, and because some versions of
  58 .Li gated
  59 do not answer the
  60 .Em request
  61 command.
  62 .Xr Routed 8
  63 does not answer the
  64 .Em poll
  65 command, but recognizes
  66 .Em requests
  67 coming from
  68 .Nm
  69 and so answers completely.
  70 .Pp
  71 The
  72 .Nm
  73 utility is also used to turn tracing on or off in
  74 .Xr routed 8 .
  75 .Pp
  76 The following options are available:
  77 .Bl -tag -width indent
  78 .It Fl n
  79 displays only the numeric network and host numbers instead of both
  80 numeric and symbolic.
  81 .It Fl p
  82 uses the
  83 .Em poll
  84 command to request full routing information from
  85 .Li gated .
  86 This is an undocumented extension RIP protocol supported only by
  87 .Li gated .
  88 .It Fl 1
  89 queries using RIP version 1 instead of RIP version 2.
  90 .It Fl w Ar timeout
  91 changes the delay for an answer from each host.
  92 By default, each host is given 15 seconds to respond.
  93 .It Fl r Ar addr
  94 asks about the route to destination
  95 .Em addr .
  96 .It Fl a Ar passwd=XXX
  97 .It Fl a Ar md5_passwd=XXX|KeyID
  98 causes the query to be sent with the indicated cleartext or MD5 password.
  99 .It Fl t Ar op
 100 changes tracing, where
 101 .Em op
 102 is one of the following.
 103 Requests from processes not running with UID 0 or on distant networks
 104 are generally ignored by the daemon except for a message in the system log.
 105 .Li gated
 106 is likely to ignore these debugging requests.
 107 .El
 108 .Bl -tag -width Ds -offset indent-two
 109 .It Em on=tracefile
 110 turns tracing on into the specified file.
 111 That file must usually have been specified when the daemon was
 112 started or be the same as a fixed name, often
 113 .Pa /etc/routed.trace .
 114 .It Em more
 115 increases the debugging level.
 116 .It Em off
 117 turns off tracing.
 118 .It Em dump
 119 dumps the daemon's routing table to the current tracefile.
 120 .El
 121 .Sh SEE ALSO
 122 .Xr routed 8
 123 .Rs
 124 .%T Routing Information Protocol, RIPv1
 125 .%O RFC1058
 126 .Re
 127 .Rs
 128 .%T Routing Information Protocol, RIPv2
 129 .%O RFC1723
 130 .Re