7.5 RIPQUERY



NAME

ripquery - query RIP gateways

SYNOPSIS

ripquery[ -1 ] [ -2 ] [ -[a5] authkey ] [ -n ] [ -N dest[/mask][ -p ] [ -r ] [ -v ] [ -w time ] gateway ...

7.5.1 Description

Ripquery is used to request all routes known by a RIP gateway by sending a RIP request or POLL command. The routing information in any routing packets returned is displayed numerically and symbolically. Ripquery is intended to be used as a tool for debugging gateways, and not for network management. SNMP is the preferred protocol for network management.

Ripquery by default uses the RIP POLL command, which is an undocumented extension to the RIP specification supported by routed on SunOS 3.x and later and by gated 1.4 and later. The RIP POLL command is preferred over the RIP REQUEST command because it is not subject to Split Horizon and/or Poisoned Reverse. See the RIP RFC for more information.

7.5.2 Options

-1 Send the query as a version 1 packet.
-2 Send the query as a version 2 packet (default).
-[a5] authkey
Specifies the authentication password to use for queries. If -a specified, an authentication type of SIMPLE will be used, if -5 is specified, an authentication type of MD5 will be used, otherwise the default is an authentication type of NONE. Authentication fields in incoming packets will be displayed, but not validated.
-n Prevents the address of the responding host from being looked up to determine the symbolic name.
-N dest[/mask]
Specifies that the query should be for the specified dest/mask instead of complete routing table. The specification of the optional mask implies a version 2 query. Up to 23 requests about specific destinations may be include in one packet.
-p Uses the RIP POLL command to request information from the routing table. This is the default, but is an undocumented extension supported only by some versions of SunOS 3.x and later versions of GateD. If there is no response to the RIP POLL command, the RIP REQUEST command is tried. Gated responds to a POLL command with all the routes learned via RIP.
-r Used the RIP REQUEST command to request information from the gateway's routing table. Unlike the RIP POLL command, all gateways should support the RIP REQUEST. If there is no response to the RIP REQUEST command, the RIP POLL command is tried. GateD responds to a REQUEST command with all the routes he announces out the specified interface. Due to limitations in the UDP interface, on systems based on BSD 4.3 Reno or earlier, REQUESTs respond about the interface used to route packets back to the sender. This can be avoided by running ripquery on the host being queried.
-v Version information about ripquery is displayed before querying the gateways.
-w time
The default value is 5 seconds.


AUTHORS

Jeffrey C Honig <jch@gated.cornell.edu>

SEE ALSO

gated (8), gdc (8), ospf_monitor (8), routed (8),
GateD Documentation
GateD Configuration Guide

BUGS

Some versions of Unix do not allow for looking up the symbolic name of a subnet.

COPYRIGHT INFORMATION

This package and associated documentation is Copyright (c) 1990,1991,1992,1993,1994,1995 Cornell University., all rights reserved. This software contains code that is Copyright (c) 1988 Regents of the University of California., all rights reserved.; <!-- ------------------------------------------------------------------------ GateD, Release 4.0 Copyright (c) 1996 The Regents of the University of Michigan All Rights Reserved License to use, copy, modify, and distribute this software and its documentation can be obtained from Merit at the University of Michigan. Merit GateDaemon Project 4251 Plymouth Road, Suite C Ann Arbor, MI 48105 THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE REGENTS OF THE UNIVERSITY OF MICHIGAN AND MERIT DO NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET LICENSEE'S REQUIREMENTS OR THAT OPERATION WILL BE UNINTERRUPTED OR ERROR FREE. The Regents of the University of Michigan and Merit shall not be liable for any special, indirect, incidental or consequential damages with respect to any claim by Licensee or any third party arising from use of the software. GateDaemon was originated and developed through release 3.0 by Cornell University and its collaborators. Please forward bug fixes, enhancements and questions to the gated mailing list: gated-people@gated.merit.edu. ------------------------------------------------------------------------ Portions of this software may fall under the following copyrights: Copyright (c) 1988 Regents of the University of California. All rights reserved. Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by the University of California, Berkeley. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. >




Last updated April 27, 1997

gated@gated.merit.edu