.TH ITEST 1.SH NAMEitest, itreplay \- run tests and replay results.SH SYNOPSIS.B itest[.I -eo][.I -c cflag][.I -r count][.I -v vlevel][.I -C configfile][.I -R recordroot][.I testdir ...].PP.B itreplay[.I -eo][.I -v verbosity][.I recorddir ...].SH DESCRIPTION.I Itestruns a sequence of tests, optionally recording all the results ina directory tree. The.IR itreplaycommand replays the results of one or more recorded tests.Some options are common to both commands:.TP.B -eDisplay the standard error produced by the tests..TP.B -oDisplay the standard output produced by the tests..TP.BI -v " vlevel"Set the verbosity level to.I vlevel(0-9). The higher the value, the more detail is displayed; the default level is 3..PPThe tests run by.IR itestare specified as one or more directories either on the command line or in a configuration file. Options:.TP.BI -c " cflag"Set the value in /dev/jit (usually 0 or 1; 0 for interpreted mode, 1 for compiled mode) to.I cflag.TP.BI -r " count"Run the set of tests .I counttimes; a value of 0 means repeat indefinitely..TP.BI -v " vlevel"Set the verbosity level to.I vlevel(0-9). The higher the value, the more detail is displayed; the default level is 3..TP.BI -C " cfile"Use the configuration file.I cfile.The file should contain a list of test directories, one per line..TP.BI -R " recroot"Store the test results in a tree rooted at .I recroot.Record directories are named as integers starting at 1. Each test run creates a newdirectory numbered one greater than the highest existing directory..PPThe test results to be replayed by.IR itreplayare specified on the command line as one or more record directories..SS TEST FORMATA test directory must contain either a t.dis file or a t.sh file, dependingon whether the test is written as a Limbo program or as a.IR sh (1)script. Limbo programs should use .IR itslib (2);sh scripts should use.IR sh-test (2).A test directory should also contain a README file (which is displayed by.I itestif the verbosity level is greater than 8), and any other files requiredfor the test..PPTests are run with their working directory set to their own test directory..SS RECORD DIRECTORY FORMATEach record directory contains a number of files:.TP.BI msgsAll the messages generated by the test..TP.BI stderrStandard error from the test..TP.BI stdoutStandard output from the test..TP.BI summarya one-line file containing the start time in seconds, elapsed time in ms, cflagand the name of the test directory..SH SOURCE.B /appl/cmd/itest.b.br.B /appl/cmd/itreplay.b.SH SEE ALSO.IR itslib (2),.IR sh-test (2)