openssl/test
Matt Caswell 4f0c475719 Add empty record tests
The previous commit changed how we handle out-of-context empty records.
This commit adds some tests for the various scenarios. There are three
tests:
1: Check that if we inject an out-of-context empty record then we fail
2: Check that if we inject an in-context empty record then we succeed
3: Check that if we inject too many in-context empty records then we fail.

Reviewed-by: Andy Polyakov <appro@openssl.org>
2016-06-07 22:07:36 +01:00
..
certs Update client authentication tests 2016-06-03 11:59:46 +02:00
ct Verify SCT signatures 2016-03-01 11:59:28 -05:00
d2i-tests Add ASN.1 INTEGER tests. 2016-05-03 13:06:15 +01:00
ocsp-tests Fix OCSP checking. 2012-12-07 18:47:47 +00:00
recipes Add empty record tests 2016-06-07 22:07:36 +01:00
smime-certs Add final(?) set of copyrights. 2016-06-01 11:27:25 -04:00
ssl-tests Update client authentication tests 2016-06-03 11:59:46 +02:00
testlib/OpenSSL tests: fix the shutting up of the shell 2016-06-06 15:51:35 +02:00
aborttest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
afalgtest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
asynciotest.c Add an async io test 2016-05-20 14:39:45 +01:00
asynctest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
bftest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
bioprinttest.c Silence some "may be uninitialized when used" warning 2016-05-27 14:59:47 +01:00
bntest.c Add a BN_mod_word test() 2016-06-07 21:55:31 +01:00
build.info Add an SSL get/set test 2016-06-07 17:05:52 +01:00
CAss.cnf GH645: Fix typo: ctificates -> certificates 2016-02-09 11:05:22 -05:00
CAssdh.cnf Import of old SSLeay release: SSLeay 0.9.0b 1998-12-21 10:56:39 +00:00
CAssdsa.cnf Import of old SSLeay release: SSLeay 0.9.0b 1998-12-21 10:56:39 +00:00
CAssrsa.cnf Import of old SSLeay release: SSLeay 0.9.0b 1998-12-21 10:56:39 +00:00
casttest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
CAtsa.cnf Use better defaults for TSA. 2015-11-20 13:40:53 +00:00
cipherlist_test.c Replace cipherlist test 2016-05-11 18:59:46 +02:00
clienthellotest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
cms-examples.pl Copyright consolidation: perl files 2016-04-20 09:45:40 -04:00
constant_time_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ct_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
d2i_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
danetest.c Add checks on CRYPTO_set_ex_data return value 2016-05-23 13:43:31 +01:00
danetest.in Add final(?) set of copyrights. 2016-06-01 11:27:25 -04:00
danetest.pem DANE support for X509_verify_cert() 2016-01-07 13:48:59 -05:00
destest.c RT4337: Crash in DES 2016-06-01 09:28:53 -04:00
dhtest.c Deprecate the flags that switch off constant time 2016-06-06 11:09:06 +01:00
dsatest.c Deprecate the flags that switch off constant time 2016-06-06 11:09:06 +01:00
dtlsv1listentest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ecdhtest_cavs.h Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ecdhtest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ecdsatest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ectest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
enginetest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
evp_extra_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
evp_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
evptests.txt Add final(?) set of copyrights. 2016-06-01 11:27:25 -04:00
exdatatest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
exptest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
generate_buildtest.pl Generate simple build test files 2016-06-04 01:22:08 +02:00
generate_ssl_tests.pl Add OpenSSL copyright to .pl files 2016-05-21 08:23:39 -04:00
getsettest.c Add an SSL get/set test 2016-06-07 17:05:52 +01:00
gmdifftest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
handshake_helper.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
handshake_helper.h Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
heartbeat_test.c Simplify SSL BIO buffering logic 2016-05-20 14:11:11 +01:00
hmactest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ideatest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
igetest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
md2test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
md4test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
md5test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
mdc2test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
memleaktest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
methtest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
nptest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
p5_crpt2_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
P1ss.cnf Use 2K RSA and SHA256 in tests 2015-04-20 07:23:04 -04:00
P2ss.cnf Use 2K RSA and SHA256 in tests 2015-04-20 07:23:04 -04:00
packettest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
pbelutest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
pkcs7-1.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
pkcs7.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
pkits-test.pl Copyright consolidation: perl files 2016-04-20 09:45:40 -04:00
r160test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
randtest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
rc2test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
rc4test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
rc5test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
README Add documentation for the new testing framework 2015-09-07 16:10:58 +02:00
README.ssltest.md Remove proxy tests. Add verify callback tests. 2016-05-12 19:02:42 +02:00
rmdtest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
rsa_test.c Deprecate the flags that switch off constant time 2016-06-06 11:09:06 +01:00
run_tests.pl perl: use the 'if' module to conditionally load File::Glob 2016-05-30 11:55:46 +02:00
secmemtest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
serverinfo.pem Require ServerInfo PEMs to be named "BEGIN SERVERINFO FOR"... 2013-09-13 19:32:55 -07:00
sha1test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
sha256t.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
sha512t.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
smcont.txt Add extensive PCKS7 and CMS consistency test script. 2008-03-18 14:37:59 +00:00
srptest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ssl_test_ctx_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ssl_test_ctx_test.conf Remove proxy tests. Add verify callback tests. 2016-05-12 19:02:42 +02:00
ssl_test_ctx.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ssl_test_ctx.h Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ssl_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
ssl_test.tmpl New SSL test framework 2016-04-05 13:44:46 +02:00
ssltest_old.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
Sssdsa.cnf Import of old SSLeay release: SSLeay 0.9.0b 1998-12-21 10:56:39 +00:00
Sssrsa.cnf Import of old SSLeay release: SSLeay 0.9.0b 1998-12-21 10:56:39 +00:00
test.cnf Use 2K RSA and SHA256 in tests 2015-04-20 07:23:04 -04:00
testcrl.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
testdsa.pem Add private/public key conversion tests 2015-03-29 03:26:12 +01:00
testdsapub.pem Add private/public key conversion tests 2015-03-29 03:26:12 +01:00
testec-p256.pem Add private/public key conversion tests 2015-03-29 03:26:12 +01:00
testecpub-p256.pem Add private/public key conversion tests 2015-03-29 03:26:12 +01:00
testp7.pem Change PKCS#7 test data to take account of removal of 2000-08-25 01:29:41 +00:00
testreq2.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
testrsa.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
testrsapub.pem Add private/public key conversion tests 2015-03-29 03:26:12 +01:00
testsid.pem Remove SSLv2 support 2014-12-04 11:55:03 +01:00
testutil.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
testutil.h Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
testx509.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
threadstest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
Uss.cnf Create DSA and ECDSA certificates. 2015-09-02 21:22:44 +01:00
v3-cert1.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
v3-cert2.pem Import of old SSLeay release: SSLeay 0.8.1b 1998-12-21 10:52:47 +00:00
v3nametest.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
verify_extra_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
wp_test.c Copyright consolidation 02/10 2016-05-17 14:20:27 -04:00
x509aux.c Fix i2d_X509_AUX, update docs and add tests 2016-05-11 01:46:06 -04:00

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)