Import TBBT (NFS trace replay).

[bluesky.git] / TBBT / trace_init / INSTALL

diff --git a/TBBT/trace_init/INSTALL b/TBBT/trace_init/INSTALL
new file mode 100755 (executable)
index 0000000..6849497
--- /dev/null
+++ b/TBBT/trace_init/INSTALL
@@ -0,0 +1,61 @@
+# $Id: INSTALL,v 1.4 2003/07/28 14:27:16 ellard Exp $\r
+\r
+NFSSCAN INSTALLATION INSTRUCTIONS\r
+\r
+This is version 0.10a of nfsscan, dated 7/25/2003.\r
+\r
+THIS IS A PRELIMINARY RELEASE OF NEW SOFTWARE:\r
+\r
+- THE COMMANDLINE FORMATS MAY EVOLVE RAPIDLY OVER THE NEXT SEVERAL\r
+       RELEASES.\r
+\r
+- DEBUGGING MESSAGES AND WARNINGS MAY APPEAR ON STDERR.  MOST OF THESE\r
+       ARE MEANINGLESS, BUT IF YOU ENCOUNTER A PROBLEM WITH THE\r
+       PROGRAM PLEASE INCLUDE THEM IN YOUR BUG REPORT.\r
+ \r
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\r
+\r
+System Requirements:\r
+\r
+       - You must have PERL 5 (5.005 or later) installed in order to\r
+               use any of these tools.  (None of these tools have\r
+               been tested with PERL 6 or later.)\r
+\r
+       - If you plan to use ns_quickview, make sure that gnuplot is\r
+               installed on your system.\r
+               \r
+               ns_quickview has been tested with gnuplot 3.7 and\r
+               should work with later versions.  If you have problems\r
+               with ns_quickview, please include any diagnostics\r
+               messages from gnuplot and the version of gnuplot with\r
+               your bug report.\r
+\r
+               If gnuplot is not in your path, you must edit\r
+               ns_quickview to set GNUPLOT_PATH to the appropriate\r
+               path after step 2 in the installation instructions.\r
+\r
+Installation:\r
+\r
+1.  Un-tar the distribution into an empty directory.\r
+\r
+2.  Edit the first line of nfsscan and ns_* to point to wherever your\r
+       favorite version of PERL 5 is installed.  If you don't like\r
+       looking at debugging messages, remove the -w from the\r
+       invocation of PERL.\r
+\r
+3.  Make sure that nfsscan and ns_* are executable and that\r
+       all the files are publically readable:\r
+\r
+               chmod 444 *\r
+               chmod 555 nfsscan ns_*\r
+\r
+4.  Read NOTES.TXT for last-minute info or errata for this release,\r
+       and changes from previous releases.\r
+\r
+5.  Read nfsscan.txt and EXAMPLES for more information about how to\r
+       use the tools.\r
+\r
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\r
+\r
+PLEASE report bugs, problems or suggestions for improvements to\r
+ellard@eecs.harvard.edu.\r