aboutsummaryrefslogtreecommitdiff
path: root/external/unbound/doc/README.tests
diff options
context:
space:
mode:
Diffstat (limited to 'external/unbound/doc/README.tests')
-rw-r--r--external/unbound/doc/README.tests24
1 files changed, 24 insertions, 0 deletions
diff --git a/external/unbound/doc/README.tests b/external/unbound/doc/README.tests
new file mode 100644
index 000000000..5385e2b22
--- /dev/null
+++ b/external/unbound/doc/README.tests
@@ -0,0 +1,24 @@
+README unbound tests
+
+For a quick test that runs unit tests and state machine tests, use
+ make test
+
+There is a long test setup for unbound that needs tools installed. Use
+ make longtest
+To make and run the long tests. The results are summarized at the end.
+
+You need to have the following programs installed and in your PATH.
+* dig - from the bind-tools package. Used to send DNS queries.
+* splint (optional) - for lint test
+* doxygen (optional) - for doc completeness test
+* ldns-testns - from ldns examples. Used as DNS auth server.
+* xxd and nc (optional) - for (malformed) packet transmission.
+The optional programs are detected and can be omitted.
+
+testdata/ contains the data for tests.
+testcode/ contains scripts and c code for the tests.
+
+do-tests.sh : runs all the tests in the testdata directory.
+testbed.sh : compiles on a set of (user specific) hosts and runs do-tests.
+
+Tests are run using testcode/mini_tpkg.sh.