openssl/test
Matt Caswell 2af22b7dd5 Fix the no-tls option
The no-tls option was failing in the tests. This fixes it.

Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-04-11 14:29:02 +01:00
..
certs Move peer chain security checks into x509_vfy.c 2016-04-03 11:35:35 -04:00
ct Verify SCT signatures 2016-03-01 11:59:28 -05:00
d2i-tests Fix memory leaks in ASN.1 2016-04-04 13:26:06 +02:00
ocsp-tests
recipes Fix the no-tls option 2016-04-11 14:29:02 +01:00
smime-certs
ssl-tests VMS doesn't have directory separators in the same sense as Unix 2016-04-09 21:44:35 +02:00
testlib/OpenSSL OpenSSL::Test: when moving directory, affect env as well 2016-04-07 14:52:01 +02:00
aborttest.c Add a test to see that signals are caught as failures 2016-03-18 15:25:23 +01:00
afalgtest.c Disable afalg when engine is disabled. 2016-03-14 17:03:53 +01:00
asynctest.c Some platforms provide getcontext() but it does not work 2016-03-16 18:12:56 +01:00
bftest.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
bntest.c Add missing mem leak test activation and checks 2016-04-06 06:17:21 -04:00
build.info Rename ssltest -> ssltest_old 2016-04-05 17:07:09 +02:00
CAss.cnf GH645: Fix typo: ctificates -> certificates 2016-02-09 11:05:22 -05:00
CAssdh.cnf
CAssdsa.cnf
CAssrsa.cnf
casttest.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
CAtsa.cnf
clienthellotest.c Use version flexible method instead of fixed version 2016-03-09 19:39:54 +01:00
cms-examples.pl
constant_time_test.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
ct_test.c Fix warnings exposed by clang-3.8 2016-04-10 01:50:32 +02:00
d2i_test.c testutil: return 1 on success 2016-04-05 17:05:40 +02:00
danetest.c test/[dane|evp_]test.c: BIO-fy file I/O. 2016-04-07 21:09:22 +02:00
danetest.in Suppress DANE TLSA reflection when verification fails 2016-02-08 14:46:09 -05:00
danetest.pem
destest.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
dhtest.c Make DH opaque 2016-04-09 10:10:55 +01:00
dsatest.c Make DSA_METHOD opaque 2016-04-03 00:23:56 +01:00
dtlsv1listentest.c Fix no-sock 2016-03-21 16:33:59 +00:00
dummytest.c
ecdhtest_cavs.h documentation and duplicate goto statements 2016-03-07 12:20:42 -05:00
ecdhtest.c documentation and duplicate goto statements 2016-03-07 12:20:42 -05:00
ecdsatest.c skip inappropriate X25519 tests 2016-02-28 22:54:54 +00:00
ectest.c skip inappropriate X25519 tests 2016-02-28 22:54:54 +00:00
enginetest.c Clean up the tests for auto-init/de-init 2016-02-09 15:11:38 +00:00
evp_extra_test.c Clean up the tests for auto-init/de-init 2016-02-09 15:11:38 +00:00
evp_test.c test/[dane|evp_]test.c: BIO-fy file I/O. 2016-04-07 21:09:22 +02:00
evptests.txt crypto/blake2: make lowest-level function handle multiple blocks.. 2016-03-31 21:34:00 +02:00
exdatatest.c
exptest.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
generate_ssl_tests.pl New SSL test framework 2016-04-05 13:44:46 +02:00
gmdifftest.c
handshake_helper.c New SSL test framework 2016-04-05 13:44:46 +02:00
handshake_helper.h New SSL test framework 2016-04-05 13:44:46 +02:00
heartbeat_test.c Use version flexible method instead of fixed version 2016-03-09 19:39:54 +01:00
hmactest.c RT3095: allow NULL key for single-shot HMAC 2016-02-04 13:01:32 +01:00
ideatest.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
igetest.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
Makefile.in Rename ssltest -> ssltest_old 2016-04-05 17:07:09 +02:00
md2test.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
md4test.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
md5test.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
mdc2test.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
memleaktest.c
methtest.c Clean up the tests for auto-init/de-init 2016-02-09 15:11:38 +00:00
nptest.c
p5_crpt2_test.c Rename INIT funtions, deprecate old ones. 2016-02-10 09:37:03 -05:00
P1ss.cnf
P2ss.cnf
packettest.c Refactor ClientHello extension parsing 2016-03-03 13:53:26 +01:00
pbelutest.c
pkcs7-1.pem
pkcs7.pem
pkits-test.pl
r160test.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
randtest.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
rc2test.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
rc4test.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
rc5test.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
README
README.ssltest.md New SSL test framework 2016-04-05 13:44:46 +02:00
rmdtest.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
rsa_test.c Make the RSA structure opaque 2016-04-06 16:19:17 +02:00
run_tests.pl unified build scheme: adjust test framework for out of source build tree 2016-02-09 11:43:20 +01:00
secmemtest.c Fixup secmemtest for the change of CRYPTO_free() and friends 2016-02-17 12:27:53 +01:00
serverinfo.pem
sha1test.c Remove Netware and OS/2 2016-03-17 17:06:57 -04:00
sha256t.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
sha512t.c Remove /* foo.c */ comments 2016-01-26 16:40:43 -05:00
smcont.txt
srptest.c Clean up the tests for auto-init/de-init 2016-02-09 15:11:38 +00:00
ssl_test_ctx_test.c testutil: return 1 on success 2016-04-05 17:05:40 +02:00
ssl_test_ctx_test.conf New SSL test framework 2016-04-05 13:44:46 +02:00
ssl_test_ctx.c New SSL test framework 2016-04-05 13:44:46 +02:00
ssl_test_ctx.h New SSL test framework 2016-04-05 13:44:46 +02:00
ssl_test.c Better use BIO_snprintf() than snprintf(), in case the later isn't available 2016-04-07 13:35:24 +02:00
ssl_test.tmpl New SSL test framework 2016-04-05 13:44:46 +02:00
ssltest_old.c Fix the no-nextprotoneg option 2016-04-11 14:22:43 +01:00
Sssdsa.cnf
Sssrsa.cnf
test_aesni
test_padlock
test_t4
test.cnf
testcrl.pem
testdsa.pem
testdsapub.pem
testec-p256.pem
testecpub-p256.pem
testp7.pem
testreq2.pem
testrsa.pem
testrsapub.pem
testsid.pem
testutil.c testutil: return 1 on success 2016-04-05 17:05:40 +02:00
testutil.h testutil: return 1 on success 2016-04-05 17:05:40 +02:00
testx509.pem
threadstest.c Implement new multi-threading API 2016-02-26 10:00:36 +00:00
times
Uss.cnf
v3-cert1.pem
v3-cert2.pem
v3nametest.c
verify_extra_test.c Clean up the tests for auto-init/de-init 2016-02-09 15:11:38 +00:00
wp_test.c

How to add recipes
==================

For any test that you want to perform, you write a script located in
test/recipes/, named {nn}-test_{name}.t, where {nn} is a two digit number and
{name} is a unique name of your choice.

Please note that if a test involves a new testing executable, you will need to
do some additions in test/Makefile.  More on this later.


Naming convetions
=================

A test executable is named test/{name}test.c

A test recipe is named test/recipes/{nn}-test_{name}.t, where {nn} is a two
digit number and {name} is a unique name of your choice.

The number {nn} is (somewhat loosely) grouped as follows:

05  individual symmetric cipher algorithms
10  math (bignum)
15  individual asymmetric cipher algorithms
20  openssl enc
25  certificate forms, generation and verification
30  engine and evp
70  PACKET layer
80  "larger" protocols (CA, CMS, OCSP, SSL, TSA)
90  misc


A recipe that just runs a test executable
=========================================

A script that just runs a program looks like this:

    #! /usr/bin/perl
    
    use OpenSSL::Test::Simple;
    
    simple_test("test_{name}", "{name}test", "{name}");

{name} is the unique name you have chosen for your test.

The second argument to `simple_test' is the test executable, and `simple_test'
expects it to be located in test/

For documentation on OpenSSL::Test::Simple, do
`perldoc test/testlib/OpenSSL/Test/Simple.pm'.


A recipe that runs a more complex test
======================================

For more complex tests, you will need to read up on Test::More and
OpenSSL::Test.  Test::More is normally preinstalled, do `man Test::More' for
documentation.  For OpenSSL::Test, do `perldoc test/testlib/OpenSSL/Test.pm'.

A script to start from could be this:

    #! /usr/bin/perl
    
    use strict;
    use warnings;
    use OpenSSL::Test;
    
    setup("test_{name}");
    
    plan tests => 2;                # The number of tests being performed
    
    ok(test1, "test1");
    ok(test2, "test1");
    
    sub test1
    {
        # test feature 1
    }
    
    sub test2
    {
        # test feature 2
    }
    

Changes to test/Makefile
========================

Whenever a new test involves a new test executable you need to do the
following (at all times, replace {NAME} and {name} with the name of your
test):

* among the variables for test executables at the beginning, add a line like
  this:

    {NAME}TEST= {name}test

* add `$({NAME}TEST)$(EXE_EXT)' to the assignment of EXE:

* add `$({NAME}TEST).o' to the assignment of OBJ:

* add `$({NAME}TEST).c' to the assignment of SRC:

* add the following lines for building the executable:

    $({NAME}TEST)$(EXE_EXT): $({NAME}TEST).o $(DLIBCRYPTO)
           @target=$({NAME}TEST); $(BUILD_CMD)