
#
# Copyright (c) Xerox Corporation 1997, 1998. All rights reserved.
#
# License is granted to copy, to use, and to make and to use derivative
# works, provided that Xerox is acknowledged in all documentation
# pertaining to any such copy or derivative work. Xerox grants no other
# licenses expressed or implied. The Xerox trade name should not be used
# in any advertising without its written permission.
#
# XEROX CORPORATION MAKES NO REPRESENTATIONS CONCERNING EITHER THE
# MERCHANTABILITY OF THIS SOFTWARE OR THE SUITABILITY OF THIS SOFTWARE
# FOR ANY PARTICULAR PURPOSE.  The software is provided "as is" without
# express or implied warranty of any kind.
#
# These notices must be retained in any copies of any part of this software.
#




This directory contains programs which monitor route updates on a local 
network:

programs which must run as setuid to root:
--------------------------------------------------
routewatch.c:  outputs mcast routing updates seen on the local network
  *** note must run as root to access the igmp socket
makefile.config: a simple makefile to build routewatch

perl scripts (may run as any user):
--------------------------------------------------
routemonitor: takes input from routewatch and constructs a mcast routing
	      table.  also collects statistics on number of route changes.
	  
dump_table: signals routemonitor to dump its current routing table and
            associated statistics to a file.

reset_table: signals routemonitor to dump its current routing table and
	     associated statistics to a file, resets the statistics for
	     each source in the routing table.

option route monitor configuration file:
--------------------------------------------------
route_monitor.conf: a configuration file for route_monitor that assigns
	            costs to adjacent routers and/or subnets.  similar
		    to an mrouted configuration file.  if no configuration
		    file is present, the cost to adjacent router is 
		    assumed to be 1.


