From: bert hubert <bert.hubert@netherlabs.nl>
Date: Thu, 13 Jun 2013 11:38:19 +0000 (+0200)
Subject: document regression-test depencies, move 'right way' to run the tests to start of... 
X-Git-Tag: auth-3.3-rc2~40
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0b4cff332b824af656ebf1f67d054dd8e0dae00c;p=thirdparty%2Fpdns.git

document regression-test depencies, move 'right way' to run the tests to start of document
---

diff --git a/regression-tests/README b/regression-tests/README
index 56b1aec9a6..8126fbfe41 100644
--- a/regression-tests/README
+++ b/regression-tests/README
@@ -1,6 +1,44 @@
 These tests can be used to verify standards compliance of PowerDNS and to
 spot regressions.
 
+Dependencies
+------------
+We need very recent versions of:
+
+	validns (http://www.validns.net/)
+	ldns-verify-zone (part of ldns)
+	jdnssec-verifyzone (http://www.verisignlabs.com/dnssec-tools/)
+	named-checkzone (part of BIND9)
+	unbound-host (part of unbound)
+	drill (part of ldns)
+
+Nice to have:
+	godns q
+
+If you omit the tools above, some tests fail, but you can still run the
+tests. 
+
+Automated tests
+---------------
+
+For a more hands-off approach, make sure PowerDNS is built with suitable
+modules, and use:
+
+$ ./start-test-stop 5300 gmysql
+
+To start PowerDNS in gmysql mode (including DNSSEC), run all tests, and
+write reports, using udp port 5300 in the process. Use:
+
+$ ./start-test-stop help
+
+to see all available suites.
+
+In addition to diff-files in all test dirs, start-test-stop generates a jUnit-
+compatible XML report.
+
+Manual testing
+--------------
+
 Start PowerDNS with --no-shuffle for best results - the 'too-big-udp' test
 fails otherwise, for cosmetical reasons.
 
@@ -80,23 +118,6 @@ $ nameserver=127.0.0.1 port=5300 ./runtests
 The BIND backend can't do MBOXFW. The 'any-query' test is known to fail
 with bind,gsqlite3.
 
-Automated tests
----------------
-
-For a more hands-off approach, make sure PowerDNS is built with suitable
-modules, and use:
-
-$ ./start-test-stop 5300 gmysql
-
-To start PowerDNS in gmysql mode (including DNSSEC), run all tests, and
-write reports, using udp port 5300 in the process. Use:
-
-$ ./start-test-stop help
-
-to see all available suites.
-
-In addition to diff-files in all test dirs, start-test-stop generates a jUnit-
-compatible XML report.
 
 Analysing results
 -----------------