Documentation of worker client testing program wtest

Randal E. Bryant
Sept. 30, 2011

The wtest program is designed to automatically test the LSP-based
password cracking worker client.

INVOKING

The program is typically located in the "official" subdirectory and is
designed to be executed from the same directory as the request code.
It is therefore invoked as follows:

   ../official/wtest <commandline options>

OPERATION

The wtest program starts up one worker and then provides it with a
random sequence of cracking requests.  For each request, it makes sure
that the worker provides the correct response.

When all tests have been completed, wtest prints "PASS" if all runs
were successful, and "FAIL" otherwise

COMMAND LINE OPTIONS

	-h         Print help message
	-v N       Set verbosity level (0-2).  The default is 1
	-V N       Set verbosity level (0-6) of the LSP clients
	-l logfile Redirect stderr for the client to the designated file.
	   	   This will capture all output generated by a logger, including
		   the provided lsp.Vlogf function.
        -n N       Specify the number of requests to test.  Default 20
	-p N	   Specify the maximum password length.  Default 6