Manual Pages for UNIX Operating System command usage for man rtquery

System Administration Commands                        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              Causes the query to be sent  with
     -a md5_passwd=XXX|KeyID    the  indicated  cleartext  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  information  from
                                GateD. This  is  an  undocumented
                                extension  RIP protocol supported
                                only by GateD.





SunOS 5.11          Last change: 24 Apr 2002                    1






System Administration Commands                        rtquery(1M)



     -r addr                    Asks about the route to  destina-
                                tion addr.


     -t operation               Changes tracing, where  operation
                                is  one  of  the  actions  listed
                                below.  Requests  from  processes
                                not running with UID 0 or on dis-
                                tant   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  speci-
                                                fied  file.  That
                                                file  must   have
                                                been    specified
                                                when  the  daemon
                                                was   started  or
                                                have  the   name,
                                                /var/log/in.routed.trace.


                                more            Increases     the
                                                debugging level.


                                off             Turns  off  trac-
                                                ing.


                                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.





SunOS 5.11          Last change: 24 Apr 2002                    2






System Administration Commands                        rtquery(1M)



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                | system/network/routing      |
    |_____________________________|_____________________________|


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
























SunOS 5.11          Last change: 24 Apr 2002                    3