-*- text -*- INSANE: An Internet Simulated ATM Networking Environment Version 1.0a11 Bruce A. Mah http://http.cs.berkeley.edu/~bmah/Software/Insane/ $Id: README,v 1.15 1996-10-29 12:21:13-08 bmah Exp $ ========================================================= INSANE is a network simulator designed to test various IP-over-ATM algorithms with realistic traffic loads. It can be used, however, for a variety of studies of application or network behavior in IP internetworks. This document is an attempt to provide some limited documentation on the simulator and its installation. Requirements ------------ INSANE lives fairly high up on the "software food chain" (this phrase stolen shamelessly from Brent Welch). It requires the following packages in order to compile: GNU g++ (2.7.2 used during development, will probably work with 2.6.3 or later) GNU libg++ (any version consistent with the compiler) GNU make (various versions circa 3.72 used during development, pretty much any recent version should work) Tcl (7.4 used during development, will probably work with 7.3 or later) The following software packages are optional: GNU readline library CSRI malloc (version 1.18 used during development) The InsaneMon simulation monitor requires the above packages, plus: Tk (4.0 used during development) This software is known to compile and work on quite a few UNIX platforms...more accurately, it has been known to compile and work on those platforms at various points in its development cycle. The following chart lists systems on which INSANE has been run successfully. Latest Platform g++ Tcl INSANE Notes -------- --- --- ------ ----- alpha-dec-osf3.2 2.7.2 7.4 1.0a11 1 hppa1.1-hp-hpux9.01 2.7.2 7.4 1.0a6 i386-unknown-bsdi2.0 2.6.3 7.4 1.0a2 2 i386-unknown-freebsd2.10 2.6.3 7.4 1.0a3 i386-unknown-freebsd2.10 2.7.2 7.4 1.0a11 1 i386-unknown-netbsd1.0A 2.7.2 7.4 1.0a2 mips-dec-ultrix4.2 2.7.2 7.4 1.0a6 mips-sgi-irix5.3 2.6.3 7.4 1.0a5 rs6000-ibm-aix3.2.5 2.6.3 7.4 1.0a5 sparc-sun-solaris2.3 2.6.3 7.4 1.0a5 sparc-sun-solaris2.4 2.7.2 7.4 1.0a9 1 sparc-sun-solaris2.5 2.7.2 7.4 1.0a9 1 (1) Primary development platform. (2) This one was hard to set up. libg++ that ships with BSD/OS 2.0 is defective; it requires a copy of librx.a (the GNU regular expression library) to be built and linked in (presumably, a g++/libg++ set built from source would not have this problem). Also, the version of tcl-7.3 that ships with BSD/OS 2.0 is defective (TCL_VOLATILE return values from C programs cause crashes inside the Tcl library); I replaced it with tcl-7.4 compiled from source. Experience with FreeBSD and NetBSD leads me to believe that a fresh copy of the development tools, compiled from source, would easily run INSANE. Important Files --------------- README This file CHANGES Release notes doc/ Documentation (PostScript files) lib/ Machine-independent libraries cdf/ Cumulative distribution functions for applications tcl/ Tcl script library src/ Source code configure Shell script to generate a Makefile appropriate to your hardware and OS. Compilation and Installation ---------------------------- Now controlled by a GNU autoconf script. 1. "cd src" 2. "./configure" The configure script will attempt to guess enough details of the hardware and operating system to be able to compile INSANE on your machine. More details can be found in the INSTALL file. This will result in a Makefile in the src directory. The configure script tends to prefer using "c++" as a compiler over "g++". In the case of INSANE, this is a Bad Thing (TM), even if c++ is installed as an alternate front end to g++. If this happens to you, set the CXX environment variable to g++ before running configure, e.g.: setenv CXX g++ # csh set CXX=g++ # sh 3. "make depend" This builds dependency information in the src directory. 4. "make" Compiles the insane executable. 5. "make install" Places the executable, plus the required Tcl libraries, in an appropriate directory. You need to have write permission on this directory (by default, /usr/local). Legal Stuff ----------- Copyright (C) 1995, 1996 Regents of the University of California. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the University of California, Berkeley. 4. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission. The software program and documentation are supplied "as is", without any accompanying services from The Regents. The Regents does not warrant that the operation of the program will be uninterrupted or error-free. The end-user understands that the program was developed for research purposes and is advised not to rely exclusively on the program for any reason. IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, BUT NOT LIMITED TO, THE IMPLIED WARANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. This package contains files which are covered by the GNU Public License. Copyright and redistribution terms for those files are listed within each file. This package contains data derived from files which are copyright 1991 University of Southern California.