This software is provided without support and without any obligation on the
part of Silicon Graphics, Inc. to assist in its use, correction, modification 
or enhancement.  There is no guarantee that this software will be included 
in future software releases.

THIS SOFTWARE IS PROVIDED "AS IS" WITH NO WARRANTIES OF ANY KIND INCLUDING THE
WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
----------------------------------------------------------------------

Last updated: 8 April 1994


This README is for IRIX 4.0 users.

This directory contains necessary bug fixes for multicast routing on 
IRIX 4.0.x. The mrouted binary is version 2.2 from Van Jacobson et al.
It uses encapsulating IP multicast tunnels and has his 8 April 1994 
routing update fixes.  These changes are important if you're connected 
to the MBONE.


If you have any problems with these fixes, please let me know via email.
 - Andrew Cherenson (arc@sgi.com)


1) Multicast routing bug fixes and changes for IRIX 4.0.x

    There are 3 bugs in IRIX 4.0.x mcast routing that only affect IRISes
    running mrouted:
       - programs running on the mrouted machine could not receive mcasts.
       - tunnels just didn't work.
       - mrouted unicast responses may get sent with a ttl of 1, which
	 can cause a tunnel to collapse.
    They are fixed in IRIX 5.1.

    NOTE: You must install both the kernel and mrouted changes together.

    WARNING: these changes have received minimal testing. Be sure to
    save a backup kernel and mrouted.

a) Kernel changes for IRIX 4.0.x

    Note: if you've installed ip_input.o from this directory before, you 
    only need to reinstall ip_mroute.o.

    The kernel ip_input.o file is from the 4.0.5H release. The ip_mroute.o
    file is compiled on 4.0.5. In theory, these files should work with the 
    any 4.0.x kernel but there's no guarantees that it will work.

    The following instructions assume you have already installed the
    eoe2.sw.ipgate subsystem from the IRIX CD-ROM.

    As root,
	   <fetch the ip*.Z files using binary mode>
	   uncompress *.Z
	   mv /usr/sysgen/boot/ip_mroute.o /usr/sysgen/boot/SAVE.ip_mroute.o
	   mv ip_mroute.o /usr/sysgen/boot
	   cp /usr/sysgen/boot/bsd.a /usr/sysgen/boot/SAVE.bsd.a
	   ar rv /usr/sysgen/boot/bsd.a ip_input.o
	   mv /unix /unix.save
	   autoconfig -f
	   reboot

    This ip_mroute.o supports 32 vifs (the standard IRIX 4.0.x version 
    only supports 8).

    If you have IDO 4.1 (or later) installed, the autoconfig may fail with
    the message:
	Archive: bsd.a has no table of contents, add one with 'ar ts'
    Do the following as root:
	    cd /usr/sysgen/root/usr/bin
	    mv ld ld.orig
	    cp /usr/bin/ld .
	    autoconfig -f
	    reboot


b)  mrouted(1M) changes for IRIX 4.0.x

    Here are binaries and sources for Van Jacobson and Pavel Curtis's version
    of mrouted(1M) with their extensions to obtain mrouted's neighbor list
    and Van's changes to make router updates more robust.
    Some of the source files contain the small changes needed to run on IRIX. 
    The original sources were obtained via anonymous ftp from 
    ftp.ee.lbl.gov:/mrouted-2.2/mrouted.tar.Z on 8 April 1994.

    Binaries:
	<fetch mrouted.Z in binary mode>
	uncompress mrouted.Z

    Sources: (optional)
	<fetch ../IRIX5/5.2/mrouted-2.2-src.tar.Z in binary mode>
	zcat mrouted-src.tar.Z | tar xf -
	cd mrouted
	make

    This mrouted binary looks for mrouted.conf in /etc, the standard BSD 
    location.  As of IRIX 5.1, /usr/etc/mrouted.conf moves to /etc.

    *** Note ***
	"The new mrouted should be run only on an upgraded kernel,
	and the old mrouted should be run only on a non-upgraded
	kernel.  With the new mrouted, tunnels use encapsulation
	by default; to configure a source-routed tunnel, you must
	add the keyword "srcrt" to the line for that tunnel in
	/etc/mrouted.conf, for example:"

	tunnel 1.2.3.4  5.6.7.8  srcrt  metric 1 threshold 64


    To install, as root:
	mv /usr/etc/mrouted /usr/etc/SAVE.mrouted
	mv mrouted /usr/etc
	mv /usr/etc/mrouted.conf /etc
	ln -s /etc/mrouted.conf /usr/etc  # in case you use SAVE.mrouted
	killall mrouted
	mrouted


2) Useful tools for IRIX 4.0.x:

    See ../README.tools for information on the various MBONE conferencing tools.

    Van's mrinfo program is used to query a mrouted for its neighbor list.
    Pavel's map-mbone is used to query all reachable mrouteds for their lists.

    Note: this is an unofficial, unsupported release. The binaries should 
    work on any IRIX 4.0.x release but there's no guarantees...

    Binaries:
	<fetch map-mbone.Z and mrinfo.Z in binary mode>
	uncompress map-mbone.Z mrinfo.Z

    Sources: (optional)
	<fetch ../mrouted-2.2-src.tar.Z in binary mode>
	zcat mrouted-src.tar.Z | tar xf -
	cd mrouted
	make

    To install, as root:
	mv mrinfo map-mbone /usr/etc