
This directory contains release 2.0 of the DiskSim storage subsystem
simulator.  The corresponding reference manual at
doc/disksim-doc.ps describes the simulator and how to use it.

To quickly verify that you've got everything and that it works:

  1. compile the simulator and helper programs, by typing "make" in the
     ./src directory.

  2. "cd" to the subdirectory called "valid".

  3. type "runvalid".  This will execute the simulator a number of times, using
     sample configurations and workloads.  Among them are example validation
     experiments for five different SCSI disk drives.  To verify that things
     are working correctly, compare the result values from each execution
     to the expected value (provided on the preceding line), which is rounded.

If you plan to use disksim as a stand-alone simulator, these examples and
the user manual should get you started.

If you plan to incorporate disksim into a larger-scale simulator (e.g., a
full system simulator), disksim_interface.c should be very helpful in
getting it to happen quickly and relatively painlessly.  It is not compiled
into disksim for standalone operation.  [ Thanks to Eran Gabber at Lucent,
there is now a simple example of a system-level simulator incorporating
disksim as a slave -- check out syssim* (before and after compilation). ]


Please send bug reports, experiences, and problems to greg.ganger@cmu.edu.
(Do not expect responsive customer support...)
If you find disksim useful, please let us know about it!

