The files in this directory are basically perl scripts that we have
developed to either help in debugging or profiling of our simulator. We
hope that you will also find these scripts useful. A short description of
each perl script is given below:

***************************************************************************
[a] LPDebug2inputQTest.prl
***************************************************************************

	This program creates an input file for the input Queue test
program from a simulations's debug output(generated by specifying the
LPDEBUG flag in the top level makefile). This allows the state of the
LP's input queue to be discerned. 

           usage: LPDebug2inputQTest.prl <filename>

***************************************************************************
[b] checkInputQTestOutput.prl
***************************************************************************

	This program checks the output of the input queue test program for
correctness (or some form of sanity).

           usage: checkInputQTestOutput.prl <filename>

***************************************************************************
[c] cleandepend
***************************************************************************

	This utility removes the dependencies that were written into the
top level makefile.

***************************************************************************
[d] check_queues.prl
***************************************************************************

	This utility orders the output of both the inputQ and the outputQ.

              usage: check_queues.prl <filename>

***************************************************************************
[e] getRollbackStats.prl
***************************************************************************

	Program to strip out the rollback data (states rolledback and time
rolledback) from the COMMITSTATS file (created by specifying COMMITSTATS
flag in the top level makefile).

             usage: getRollbackStats.prl <filename>

***************************************************************************
[e] getStats
***************************************************************************

	Program that reports the total number of committed events per
second and the total number of processed events per seconds along with the
total execution time. Takes the LPSTATS files as input (generated by
specifying COMMITSTATS and FINALSTATS flag in the top level makefile).

                 usage: getStats <lpstatsfile>

***************************************************************************
[f] getdata.prl
***************************************************************************

	Extracts data from the .ql file generated by "quantify"

1. Takes .ql files as input on the command line.

2. Generates output to a file if -o option is specified. Output files
   generated are <output file>.1, <output file>.2 and so on depending on
   the no. of LPs.

3. If the -o option is not specified, prints o/p to stdout.

4. Takes the function names from the file $stringFile.

5. Generates o/p according to xvgr specs. If -plot option is specified in
   the command line 

        usage: getdata.prl -o <output file>  <file1.ql> <file2.ql> ...

***************************************************************************
[g] Strings                    
***************************************************************************

	This file is needed by the getdata.prl program. It contains a list
of all the class names, that the user is currently interested in seeing
the quantify data for.




