rtquery(1M)

NAME

     rtquery - query routing daemons for their routing tables

SYNOPSIS

     rtquery [-np1] [-w timeout] [-r addr] [-a secret] host...

     rtquery [-t operation] host...

DESCRIPTION

     The rtquery command is used to query a RIP  network  routing
     daemon,  in.routed(1M)  or  GateD,  for its routing table by
     sending a request or poll command. The  routing  information
     in any routing response packets returned is displayed numer-
     ically and symbolically.

     By default, rtquery uses the request command.  When  the  -p
     option is specified, rtquery uses the poll command, an undo-
     cumented extension to the RIP protocol supported  by  GateD.
     When  querying GateD, 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 versions
     of GateD do not answer the request command.  in.routed  does
     not  answer the poll command, but recognizes requests coming
     from rtquery and so answers completely.

     The rtquery command is also used to turn tracing on  or  off
     in in.routed.

OPTIONS

     The following options are supported:

     -a passwd=XXX

     -a md5_passwd=XXX|KeyID
           Causes the query to be sent with the indicated  clear-
           text or MD5 password.

     -n    Displays only the numeric network and  host  addresses
           instead of both numeric and symbolic names.

     -p    Uses the poll command to request full routing informa-
           tion from GateD. This is an undocumented extension RIP
           protocol supported only by GateD.

     -r addr
           Asks about the route to destination addr.

     -t operation
           Changes tracing, where operation is one of the actions
           listed below. Requests from processes not running with
           UID 0 or on distant networks are generally ignored  by
           the  daemon  except  for  a message in the system log.
           GateD is likely to ignore these debugging requests.

           on=tracefile
                 Turns tracing on,  directing  tracing  into  the
                 specified  file. That file must have been speci-
                 fied when the daemon was  started  or  have  the
                 name, /var/log/in.routed.trace.

           more  Increases the debugging level.

           off   Turns off tracing.

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

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

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

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWroute                   |
    |_____________________________|_____________________________|

SEE ALSO

     in.routed(1M),   route(1M),    gateways(4),   attributes(5),
     icmp(7P), inet(7P), udp(7P)

     Routing Information Protocol, RIPv1, RFC 1058

     Routing Information Protocol, RIPv2, RFC 2453, STD 0056