From 05e0ef266cca7b7d72dfb60d8e12c5ff4cf2125a Mon Sep 17 00:00:00 2001 From: Todd Lyons Date: Sun, 20 May 2012 08:08:59 -0700 Subject: [PATCH] FAQ of running test suite --- test/README | 27 +++++++++++++++++++++++++++ test/runtest | 5 +++++ 2 files changed, 32 insertions(+) diff --git a/test/README b/test/README index 4fd16eb9d..7a7e904a6 100644 --- a/test/README +++ b/test/README @@ -419,6 +419,33 @@ OTHER ISSUES . Test 0142 tests open file descriptors; on some hosts the output may vary. +. Some tests may fail, for example 0022, because it says it uses cached data + when the expected output thinks it should not be in cache. Item #5 in the + Requirements section has: + "Exim must be built with its user and group specified at build time" + This means that you cannot use the "ref:username" in your Local/Makefile + when building the exim binary, in any of the following fields: + EXIM_USER EXIM_GROUP CONFIGURE_OWNER CONFIGURE_GROUP + +. If the runtest script warns that the hostname is not a Fully Qualified + Domain Name (FQDN), expect that some tests will fail, for example 0036, + with an extra log line saying the hostname doesn't resolve. You must use a + FQDN for the hostname for proper test functionality. + +. If your hostname has an uppercase characters in it, expect that some tests + will fail, for example, 0036, because some log lines will have the hostname + in all lowercase. The regex which extracts the hostname from the log lines + will not match the lowercased version. + +. Some tests may fail, for example 0015, with a cryptic error message: + Server return code 99 + Due to security concerns, some specific files MUST have the group write bit + off. For the purposes of the test suite, some test/aux-fixed/* files MUST + have the group write bit off, so it's easier to just remove the group write + bit for all of them. If your umask is set to 002, the group write bit will + be on by default and you'll see this problem, so make sure your umask is + 022 and re-checkout the test/ subdirectory. + OTHER SCRIPTS AND PROGRAMS -------------------------- diff --git a/test/runtest b/test/runtest index 84bdc04dc..5ac52ae56 100755 --- a/test/runtest +++ b/test/runtest @@ -2714,6 +2714,11 @@ if ($parm_hostname !~ /\./) print "\n*** Host name is not fully qualified: this may cause problems ***\n\n"; } +if ($parm_hostname =~ /[[:upper:]]/) + { + print "\n*** Host name has upper case characters: this may cause problems ***\n\n"; + } + # Find the user's shell $parm_shell = $ENV{'SHELL'}; -- 2.30.2