4 For any test that you want to perform, you write a script located in
5 test/recipes/, named {nn}-test_{name}.t, where {nn} is a two digit number and
6 {name} is a unique name of your choice.
8 Please note that if a test involves a new testing executable, you will need to
9 do some additions in test/Makefile. More on this later.
15 A test executable is named test/{name}test.c
17 A test recipe is named test/recipes/{nn}-test_{name}.t, where {nn} is a two
18 digit number and {name} is a unique name of your choice.
20 The number {nn} is (somewhat loosely) grouped as follows:
22 05 individual symmetric cipher algorithms
24 15 individual asymmetric cipher algorithms
25 20 openssl commands (some otherwise not tested)
26 25 certificate forms, generation and verification
29 80 "larger" protocols (CA, CMS, OCSP, SSL, TSA)
33 A recipe that just runs a test executable
34 =========================================
36 A script that just runs a program looks like this:
40 use OpenSSL::Test::Simple;
42 simple_test("test_{name}", "{name}test", "{name}");
44 {name} is the unique name you have chosen for your test.
46 The second argument to `simple_test' is the test executable, and `simple_test'
47 expects it to be located in test/
49 For documentation on OpenSSL::Test::Simple, do
50 `perldoc test/testlib/OpenSSL/Test/Simple.pm'.
53 A recipe that runs a more complex test
54 ======================================
56 For more complex tests, you will need to read up on Test::More and
57 OpenSSL::Test. Test::More is normally preinstalled, do `man Test::More' for
58 documentation. For OpenSSL::Test, do `perldoc test/testlib/OpenSSL/Test.pm'.
60 A script to start from could be this:
70 plan tests => 2; # The number of tests being performed
86 Changes to test/Makefile
87 ========================
89 Whenever a new test involves a new test executable you need to do the
90 following (at all times, replace {NAME} and {name} with the name of your
93 * among the variables for test executables at the beginning, add a line like
96 {NAME}TEST= {name}test
98 * add `$({NAME}TEST)$(EXE_EXT)' to the assignment of EXE:
100 * add `$({NAME}TEST).o' to the assignment of OBJ:
102 * add `$({NAME}TEST).c' to the assignment of SRC:
104 * add the following lines for building the executable:
106 $({NAME}TEST)$(EXE_EXT): $({NAME}TEST).o $(DLIBCRYPTO)
107 @target=$({NAME}TEST); $(BUILD_CMD)