1rtquery(1M)             System Administration Commands             rtquery(1M)
2
3
4

NAME

6       rtquery - query routing daemons for their routing tables
7

SYNOPSIS

9       rtquery [-np1] [-w timeout] [-r addr] [-a secret] host...
10
11
12       rtquery [-t operation] host...
13
14

DESCRIPTION

16       The  rtquery  command  is  used  to query a RIP network routing daemon,
17       in.routed(1M) or GateD, for its routing table by sending a  request  or
18       poll  command.  The routing information in any routing response packets
19       returned is displayed numerically and symbolically.
20
21
22       By default, rtquery uses the request command. When  the  -p  option  is
23       specified,  rtquery uses the poll command, an undocumented extension to
24       the RIP protocol supported by GateD. When querying GateD, the poll com‐
25       mand  is preferred over the request command because the response is not
26       subject to Split Horizon and/or Poisoned Reverse, and because some ver‐
27       sions  of  GateD  do not answer the request command. in.routed does not
28       answer the poll command, but recognizes requests  coming  from  rtquery
29       and so answers completely.
30
31
32       The  rtquery  command  is  also  used  to  turn  tracing  on  or off in
33       in.routed.
34

OPTIONS

36       The following options are supported:
37
38       -a passwd=XXX              Causes the query to be sent with  the  indi‐
39       -a md5_passwd=XXX|KeyID    cated cleartext or MD5 password.
40
41
42       -n                         Displays  only  the numeric network and host
43                                  addresses instead of both numeric  and  sym‐
44                                  bolic names.
45
46
47       -p                         Uses  the poll command to request full rout‐
48                                  ing  information  from  GateD.  This  is  an
49                                  undocumented  extension  RIP  protocol  sup‐
50                                  ported only by GateD.
51
52
53       -r addr                    Asks about the route to destination addr.
54
55
56       -t operation               Changes tracing, where operation is  one  of
57                                  the actions listed below. Requests from pro‐
58                                  cesses not running with UID 0 or on  distant
59                                  networks are generally ignored by the daemon
60                                  except for a  message  in  the  system  log.
61                                  GateD  is  likely  to ignore these debugging
62                                  requests.
63
64                                  on=tracefile    Turns tracing on,  directing
65                                                  tracing  into  the specified
66                                                  file. That  file  must  have
67                                                  been specified when the dae‐
68                                                  mon was started or have  the
69                                                  name,
70                                                  /var/log/in.routed.trace.
71
72
73                                  more            Increases   the    debugging
74                                                  level.
75
76
77                                  off             Turns off tracing.
78
79
80                                  dump            Dumps  the  daemon's routing
81                                                  table to the  current  trace
82                                                  file.
83
84
85
86       -w timeout                 Changes  the  delay  for an answer from each
87                                  host. By default, each host is given 15 sec‐
88                                  onds to respond.
89
90
91       -1                         Queries  using  RIP version 1 instead of RIP
92                                  version 2.
93
94

EXIT STATUS

96       The following exit values are returned:
97
98       0     Successful completion.
99
100
101       >0    An error occurred.
102
103

ATTRIBUTES

105       See attributes(5) for descriptions of the following attributes:
106
107
108
109
110       ┌─────────────────────────────┬─────────────────────────────┐
111       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
112       ├─────────────────────────────┼─────────────────────────────┤
113       │Availability                 │SUNWroute                    │
114       └─────────────────────────────┴─────────────────────────────┘
115

SEE ALSO

117       in.routed(1M),   route(1M),   gateways(4),   attributes(5),   icmp(7P),
118       inet(7P), udp(7P)
119
120
121       Routing Information Protocol, RIPv1, RFC 1058
122
123
124       Routing Information Protocol, RIPv2, RFC 2453, STD 0056
125
126
127
128SunOS 5.11                        24 Apr 2002                      rtquery(1M)
Impressum