$Id: README,v 1.7 1997/02/01 01:19:19 masaki Exp $

***************************************************************
MRT-1.3.4A Source Code Snapshot 1.3.4A (Jan/31/97)
***************************************************************

We have compiled and tested MRT on the following systems/environments
  Solaris 5.5  (native Pthreads support, and IPv6 support)
  SunOS 4.1.3 (no thread support)
  SunOS 4.1.3 (with MIT Pthreads)
  FreeBSD 2.1 and 2.1.5 (no threads support, and INRIA IPv6 support)
  BSDI 2.1    (no thread support)
  Linux 2.1.14 and 2.1.24 (no threads support, and IPv6 support)

Other people have reported that MRT runs on
  IRIX (version?)

Have not finished testing, but MRT should also run on
  FreeBSD2.1 (with MIT Pthreads)
  NetBSD     (no thread support)

A 4-processor Sparc20 running Solaris 5.5 and Intel 486DX boxes
runnig FreeBSD 2.1.5 and Linux 2.1.24 are the current development platforms.

Although MRT will work on uni-processor systems lacking thread and shared
memory support, the software's preformance will be significantly degraded.

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]

  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.
