aboutsummaryrefslogtreecommitdiffstats
path: root/tests/nist_tests/readme.txt
diff options
context:
space:
mode:
authorlloyd <[email protected]>2014-01-01 01:25:53 +0000
committerlloyd <[email protected]>2014-01-01 01:25:53 +0000
commitae56600cde7cc035cf6c5cbeb4fea58adfa2c7a2 (patch)
treeea91d4d3c3aaad881a5080ba3d0f7227e16dcc74 /tests/nist_tests/readme.txt
parent5d40bdeb1b95c051d0655595846acd91cff6160f (diff)
s/check/test/g
Diffstat (limited to 'tests/nist_tests/readme.txt')
-rw-r--r--tests/nist_tests/readme.txt26
1 files changed, 26 insertions, 0 deletions
diff --git a/tests/nist_tests/readme.txt b/tests/nist_tests/readme.txt
new file mode 100644
index 000000000..b992a5b30
--- /dev/null
+++ b/tests/nist_tests/readme.txt
@@ -0,0 +1,26 @@
+
+This package contains a program to exercise Botan's path validation
+algorithm, as contained in the X509_Store object. The data used is
+NIST's X.509v3 certificate path validation testing data, as found on
+NIST's web site (version 1.0.7 of the testing data is currently
+used). The PKCS #7 and PKCS #12 data files have been removed, as they
+are not used in this test.
+
+Currently, some tests fail or are not be run for various reasons (in
+particular, we don't have support policy extensions yet, so that
+excludes running a good number of the tests). Even if all of the tests
+DO pass, that does not imply that Botan's path validation and
+certificate processing code is bug free, as there are many (*very
+many*) possible options in X.509 which this testing data does not make
+use of at all. However, it is helpful for implementation testing and
+assurance (I have found a good number of bugs using these tests).
+
+Currently, we do not make use of the S/MIME or PKCS #12 testing data
+contained in these tests, because Botan does not support either of
+these standards.
+
+To use this, compile x509test.cpp, and run the resulting
+executable. The results are written to standard output. Your system
+must have a POSIX.1 dirent.h, and the code assumes Unix-style paths.
+
+Email me with any questions or comments about these tests.