
 The Amavis-Perl Test Suite
 ==========================

 'make check' in the top level directory will run the test suite
 which consists of four short scripts in this directory. It does
 not work with qmail yet, due to the very non-standard way it
 communicates with amavis.

 The amavis-test script here is identical with the generated amavis
 script, except for:

 o "$TESTING" is set to "yes" - no mail is sent, the message is printed
   to stdout (required for X-Virus-Scanned: header test)
 o "$LOGDIR" is set to the current directory, "$log_level" is set to 5;
   a file amavis.log with full amavis debug information is written
 o "$TEMPBASE" is set to /tmp
 o $X_HEADER is set to yes

 Setting "$LOGDIR" to the current directory and "$TEMPBASE" to /tmp
 allows for running the tests under any user id, as no extra permissions
 for logging and temporary directories are required, and at the same
 time create useful debugging output (the filename is "amavis.log") in
 the current directory.

 The first test, config, checks whether amavis was configured correctly, ie.
 whether the necessary substitutions were made.

 The second test, novirus-msg, runs a short, plain text email message
 through amavis-test, and should pass with no problem.

 The third test, virus-msg, creates an email message with a multiply
 decoded file which contains the EICAR.COM virus checker test pattern.
 It tests amavis for MIME decoding, plus a bunch of archive formats
 (which is bad: there should be separate tests for separate features).

 The last test, xheader, checks whether the "X-Virus-Scanned:" header
 is really added to the processed mail message. It seemed necessary
 to test this after I broke it in amavis-perl-7 ...

 For your convenience, "make EICAR.COM" in this directory creates a
 file EICAR.COM with the virus checker test pattern.

 More tests will be added if necessary.

