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

                              David Kotz
                          Dartmouth College
                             Version 3.0
                             October 1996
                         dfk@cs.dartmouth.edu

This directory contains the source code for my parallel file-system
simulator, and associated stuff.  See ../README for more information,
and rules about using and copying this code.

This code can be found 
via ftp at cs.dartmouth.edu in pub/pario/STARFISH 
via the WWW at http://www.cs.dartmouth.edu/research/starfish/

WARNING: 
--------
 I AM PROVIDING THE CODE AS-IS, WITH LITTLE CLEANUP OR ADDED
DOCUMENTATION.  SOME OF THE CODE IS OUT-OF-DATE AND HAS BUGS.  OTHER
PARTS ARE INCOMPLETE.  MANY OF THE ANALYSIS SCRIPTS ARE FRAGILE.  THE
CODE IS CONSTANTLY EVOLVING, AND NEW PUBLIC RELEASES MAY BE RARE.

 IN PARTICULAR, please note that some of the comments in the code are
out of date, especially paragraph comments.  Sorry about that. 

 ALSO, PLEASE NOTE that the code included here has evolved A LOT since
the OSDI paper.  The latest version is kotz:jdiskdir (see the
bibliography available at the ftp or www site above), which was
produced using the files included here.

Description of the files: see ./FILES
-------------------------

Structure of the code:  see ./STRUCTURE
----------------------

Compiling the code:
-------------------
You cannot execute 'make' directly.  See ./Makefile for more
instructions.  Expect several warning messages, mostly having to do
with variables that don't get used.  They do; it depends on the
#defines.

Configuring the parameters:
---------------------------

Run config (a proteus program) while your current directory is ./test.
(I'm assuming that you chose to use ./test as the place where you
build STARFISH, as suggested in ./Makefile.)

dmcache:  You may note references to 'dmcache' in several places.
-------   That's the old name for this simulator. 
