						 18 July 1996

TOOPS (Version 1.21)
Tool for Object-Oriented Protocol Simulation
--------------------------------------------


What is TOOPS?
--------------

TOOPS is a C++ class library for process-oriented simulation 
primarily of communication protocols. 

TOOPS contains classes for processors, processes, channels, sockets
and messages.

TOOPS currently runs under HP UX 9.0x and 10.10 (HP C++ 3.40 and 
gcc 2.5.8 or 2.7.2), IRIX 5.3 (SGI CC 4.0), LINUX (gcc), DOS and 
Windows 3.1 (Borland C++ 3.1 and MS Visual C++ 1.51). We still have 
problems under Borland 4.x and SUN OS 4.1.3.

The code is only based on the ANSI language definitions and should
therefore be portable to other plattforms. 
  
--------------------------------------------------------------------
 We appreciate any comment about your experience with TOOPS. We are
 interested in your experience working with TOOPS, reports about   
 bugs that you might discover, any attempt to port TOOPS to other  
 platforms and suggestions on how to improve TOOPS.

         Please contact: toops@ldv.e-technik.tu-muenchen.de
--------------------------------------------------------------------


Copyright, Warranty and Support
-------------------------------

Please notice the enclosed copyright notice in file cpyright.txt.


Installation
------------

1. UNIX:
   tar xvf <TOOPS-Distribution>
   cd into the TOOPS-directory
   edit makefile and makefile.incl for your platform
   make all

2a. DOS/Windows:
   
   pkunzip -d <TOOPS-Distribution>   

   Compile the TOOPS library, using the project files 
   "toops.prj" (BC 3.1) or "toops.mak" (VC 1.5) in toops/source. 

   The project files for BC and VC may not be completely
   up-to-date. Be sure to include all source files in
   the appropriate directory before compiling.

   The directories in the project files *.prj may have to be 
   modified for your local BC 3.1 installation.

   The paths in toops.mak may have to be modified for your
   local installation. 

2b. Compile the TOOPS utility library in toops/utility/source.
   These utilities are only necessary for tutorials 4 - 8.

2c. Compile and run the tutorials in toops/tutorial/tut1,
   toops/tutorial/tut2, ... 

If want to port TOOPS to any other platform, please let us
know.

Note: The included project-files *.proj may be used with the
      development environment SNiFF+ (http://www.takefive.co.at/).


Documentation
-------------

The class library is documented in the enclosed file: 
   doc/toopsusr.txt

This document is also available in Postscript format:
   doc/toopsusr.ps

The enclosed tutorials and sample programs are documented
in the file:
   doc/tutorials.ps

Additional information (especially introductory papers of the basic 
concepts of TOOPS) is available upon request. Sorry, these papers
are in German language. 
 

Downloading TOOPS
-----------------

The latest version of TOOPS is available by anonymous ftp from:

     ftp.ldv.e-technik.tu-muenchen.de
     pathname: /dist/TOOPS

You may also use your WWW browser:

     ftp://ftp.ldv.e-technik.tu-muenchen.de/dist/INDEX.html


Envisaged enhancements of TOOPS
-------------------------------

* development of a platform-independent, interactive GUI
* improve documentation
* mechanisms for shared-memory access (to simulate distributed DMA)
* additional libraries (e.g., random classes, etc.)


Please direct all questions or comments to:
-------------------------------------------

E-Mail: toops@ldv.e-technik.tu-muenchen.de

FAX:    +49 89 289 23600

Phone:  +49 89 289 23622

Mail:   Technical University of Munich  
        Chair for Data Processing (Lehrstuhl fuer Datenverarbeitung)  
        D-80290 Muenchen                  
        Germany                           
        




