             The STARFISH Parallel file-system simulator
       (Simulation Tool for Advanced Research in File Systems)

                              David Kotz
                          Dartmouth College
                             Version 3.0
                             October 1996

Documentation:
 README
 STRUCTURE
 FILES
 PAPERS.bib

Files used by config and stats:
 Configfile
 Graphfile
 ParamHelp

Makefile    (which is linked to test/UserMake)
maketestdir makes a subdirectory for building STARFISH
domake*	    runs make in subdirectory

TAGS	    emacs tags file

setup	    csh 'source' script that I use
environset  csh 'source' script that I use
unpack      csh script that I use

testsuite   a basic test script that uses the scripts below
testsuite1  another basic test script that uses the scripts below
testsuite2  another basic test script that uses the scripts below

alltrace*   csh script to analyze trace output from iopfs-general
blocktrace* csh script to analyze trace output from iopfs-general
memtrace*   csh script to analyze trace output from iopfs-general
memcheck1*  csh script to analyze trace output from iopfs-general
memcheck2*  csh script to analyze trace output from iopfs-general

verify-run* run some basic tests and verify that things work right

run/	    place where I run experiments, collect and analyze data
test/	    place where I compile and test the simulator

proteus/    my version of the proteus engine

*.ca	    cycle-counted C code
*.c	    non-cycle-counted C code
*.h	    include file
*.param	    parameter file (written by config, controlled by Configfile)

setparam    my version of the proteus script

testsuite   a testing suite that runs some interesting patterns so I
	    can make sure everything is working
