$Id: README,v 1.8 1997/03/21 09:11:15 masaki Exp $

***************************************************************
MRT-1.3.6A Source Code Snapshot (Mar/20/97)
***************************************************************

We have compiled and tested MRT on the following systems/environments

  - Solaris 2.5 and 2.5.1
  - SunOS 4.1.3 and 4.1.4
  - Linux 2.0 and later
  - FreeBSD 2.1 and 2.1.5
  - NetBSD 1.1 and 1.2

MRT provides IPv6 supports for:

  - Solaris IPv6 Release 5 (Solaris 2.5 and 2.5.1)
  - Linux IPv6 (2.1.24 and later)
  - INRIA IPv6 (970208, FreeBSD 2.1 and 2.1.5)
  - WIDE IPv6 (hydrangea 970225, BSD/OS 2.1)
  - NRL IPv6 (Sep96, NetBSD 1.2)

Other people have reported that MRT runs on

  - IRIX (version?)

On Solaris, MRT runs with native POSIX threads. On other
platforms, POSIX threads libraries like one developed at MIT can
be used.  Although MRT will work on uni-processor systems lacking
thread and shared memory support, the software's preformance will
be significantly degraded.

The current MRT development platforms are a four-processor
SPARCstation 20 running Solaris IPv6 Release 5 on Solaris 2.5.1
with POSIX threads support, and Intel Pentium Pro and 486DX
systems running other IPv6 implementaions.

Comments, bugs and suggestions to mrt-support@merit.edu.

Enjoy.

- Craig & Masaki
  <labovit@merit.net>
  <masaki@merit.net>


------------------------
INSTALLATION PROCEDURES
------------------------

** Some Requirements: gcc on Solaris and others, gmake on BSD/OS

In the mrt/src directory, 
  1) type ./configure
  2) type make
  3) type make install

Note: At the moment, install does not actually install libraries
or programs. Binaries are in mrt/src/obj/<arch>/[lib/bin]

Changed: install puts mrtd and mrtd.conf into the specific
directory.

  4) Add the following lines to /etc/services. Feel free to
choose your own port numbers. 
     mrt	23/tcp   # MRT Routing Daemon 
     sim	5675/tcp # MRT Routing Simulator
     monitor	5675/tcp # MRT Routing Database/Monitor


-----------------
TOOL DESCRIPTIONS
-----------------

1) MRT -- routing daemon
   BGP4, RIP1/2, RIPNG support
   Cisco-like telnet interface
   Cisco-like configuration files
   Supports multiple views (i.e. route server)

2) BGPSim -- BGP4 simulator
   Simulate routing stability (announce/withdrawn) and 
     routing path attribute changes
   DPA, Community Support
   Cisco-like telnet interface
   Cisco-like configuration files

3) SBGP -- Simple BGP
   Trivial BGP4 Daemon
   No configuration file

4) SRIP -- Simple RIP
   Trivial Rip1/2 Daemon
   No configuration file

5) RouteBtoA -- Route binary to ASCII Converter
   Converts binary routing streams to readable text

6) RouteAtoB -- Route ASCII to Binary Converter
   Take ASCII descriptions of routing update messages and
     converts them to binary

7) CiscoCheck
   A set of perl scripts that validates output of cisco "show
   dump" against IRR

8) RouteFlap
   A set of perl scripts that calculates route flap statistics
     from binary routing streams

9) MSGServer
   A message queue directory server. Designed for support of
    distributed MRT clients

10) NAPMonitor
   A set of perl scripts used to retrieve data from the NAPS based on RSd log
     files

11) Monitor
   A route database with telnet interface


--------------------------------
BUGS (both MRT and OS related)
--------------------------------

1) Solaris 2.5 IPv6 V4 bind does not set errno properly in case
where address already bound

2) Solaris 2.5 IPv6 seems to have some severe memory leaks which
result in machine crashes.

See README.IPv6 for IPv6 related things.
