2
0
mirror of https://github.com/openssl/openssl.git synced 2024-12-15 06:01:37 +08:00
openssl/test
Tomas Mraz 7e8d6bafd0 Make the 00-prep_*.t recipe truly mandatory
Reviewed-by: Paul Dale <pauli@openssl.org>
Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15550)
2021-06-01 15:07:51 +02:00
..
certs TEST: Prefer using precomputed RSA and DH keys for more efficient tests 2021-05-27 11:06:01 +02:00
ct
d2i-tests
helpers Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
ocsp-tests
recipes Enhance the encoder/decoder tests to allow testing with a non-default library context and configurable providers 2021-06-01 12:16:27 +02:00
smime-certs
ssl-tests
testutil Enhance the encoder/decoder tests to allow testing with a non-default library context and configurable providers 2021-06-01 12:16:27 +02:00
aborttest.c
acvp_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
acvp_test.inc
aesgcmtest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
afalgtest.c
algorithmid_test.c
asn1_decode_test.c
asn1_dsa_internal_test.c
asn1_encode_test.c
asn1_internal_test.c
asn1_string_table_test.c
asn1_time_test.c
asynciotest.c
asynctest.c
bad_dtls_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
bftest.c
bio_callback_test.c Deprecate old style BIO callback calls 2021-05-26 17:18:34 +02:00
bio_core_test.c
bio_enc_test.c
bio_memleak_test.c
bio_prefix_text.c
bio_readbuffer_test.c
bioprinttest.c
bn_internal_test.c
bn_rand_range.h
bntest.c
bntests.pl
build.info Fix PKCS7_verify to not have an error stack if it succeeds. 2021-05-31 08:45:58 +10:00
ca-and-certs.cnf TEST: Prefer using precomputed RSA and DH keys for more efficient tests 2021-05-27 11:06:01 +02:00
casttest.c
CAtsa.cnf TEST: Prefer using precomputed RSA and DH keys for more efficient tests 2021-05-27 11:06:01 +02:00
chacha_internal_test.c
cipher_overhead_test.c
cipherbytes_test.c
cipherlist_test.c
ciphername_test.c
clienthellotest.c
cmactest.c
cmp_asn_test.c
cmp_client_test.c test: add zero strenght arguments to BN and RAND RNG calls 2021-05-29 17:17:12 +10:00
cmp_ctx_test.c
cmp_hdr_test.c
cmp_msg_test.c test: add zero strenght arguments to BN and RAND RNG calls 2021-05-29 17:17:12 +10:00
cmp_protect_test.c
cmp_server_test.c
cmp_status_test.c
cmp_vfy_test.c
cms-examples.pl
cmsapitest.c
conf_include_test.c
confdump.c
constant_time_test.c
context_internal_test.c
crltest.c
ct_test.c
ctype_internal_test.c
curve448_internal_test.c
d2i_test.c
danetest.c danetest.c: Improve code formatting 2021-05-19 20:15:26 +02:00
danetest.in
danetest.pem
data2.bin
data.bin
default-and-fips.cnf
default-and-legacy.cnf
default.cnf
defltfips_test.c Rename also the OSSL_PROVIDER_name() function 2021-06-01 12:43:57 +02:00
destest.c
dhtest.c
drbgtest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
dsa_no_digest_size_test.c
dsatest.c
dtls_mtu_test.c
dtlstest.c
dtlsv1listentest.c
ec_internal_test.c
ecdsatest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
ecdsatest.h
ecstresstest.c
ectest.c Use <> for #include openssl/xxx 2021-05-27 09:56:41 +10:00
endecode_test.c Enhance the encoder/decoder tests to allow testing with a non-default library context and configurable providers 2021-06-01 12:16:27 +02:00
endecoder_legacy_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
enginetest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
errtest.c
evp_extra_test2.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
evp_extra_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
evp_fetch_prov_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
evp_kdf_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
evp_libctx_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
evp_pkey_dparams_test.c
evp_pkey_provided_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
evp_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
exdatatest.c
exptest.c
fatalerrtest.c
ffc_internal_test.c
filterprov.c
filterprov.h
fips-and-base.cnf
fips.cnf
generate_buildtest.pl
generate_ssl_tests.pl
gmdifftest.c
gosttest.c
hexstr_test.c
hmactest.c Update copyright year 2021-05-20 14:22:33 +01:00
http_test.c Add OSSL_ prefix to HTTP_DEFAULT_MAX_{LINE_LENGTH,RESP_LEN} 2021-05-14 19:24:42 +02:00
ideatest.c
igetest.c
insta_ca.cert.pem
insta.priv.pem
keymgmt_internal_test.c
legacy.cnf
lhash_test.c
mdc2_internal_test.c
mdc2test.c
memleaktest.c
modes_internal_test.c
moduleloadtest.c
namemap_internal_test.c
ocspapitest.c
ossl_store_test.c
p_test.c Ensure mirroring of properties works for subsequent updates 2021-05-20 09:35:41 +01:00
packettest.c
param_build_test.c Use <> for #include openssl/xxx 2021-05-27 09:56:41 +10:00
params_api_test.c
params_conversion_test.c test/params_conversion_test.c: fix the use of strtoumax and strtoimax on VMS 2021-05-22 07:23:47 +02:00
params_test.c Include "internal/numbers.h" in test programs using SIZE_MAX 2021-05-22 07:23:47 +02:00
pbelutest.c
pbetest.c Fix building of test/pbetest.c 2021-05-26 10:20:24 +10:00
pem_read_depr_test.c
pemtest.c
pkcs7_test.c Fix PKCS7_verify to not have an error stack if it succeeds. 2021-05-31 08:45:58 +10:00
pkcs7-1.pem
pkcs7.pem
pkcs12_format_test.c Fix PKCS12_create() so that a fetch error is not added to the error stack. 2021-05-28 13:54:19 +02:00
pkey_meth_kdf_test.c
pkey_meth_test.c
pkits-test.pl
poly1305_internal_test.c
property_test.c property: convert integers to strings properly. 2021-05-22 15:30:26 +10:00
provider_fallback_test.c Rename also the OSSL_PROVIDER_name() function 2021-06-01 12:43:57 +02:00
provider_internal_test.c Rename also the OSSL_PROVIDER_name() function 2021-06-01 12:43:57 +02:00
provider_internal_test.cnf.in
provider_status_test.c
provider_test.c Ensure mirroring of properties works for subsequent updates 2021-05-20 09:35:41 +01:00
proxy.cnf TEST: Prefer using precomputed RSA and DH keys for more efficient tests 2021-05-27 11:06:01 +02:00
rand_status_test.c
rc2test.c
rc4test.c
rc5test.c
rdrand_sanitytest.c
README-dev.md
README-external.md
README.md
README.ssltest.md
recordlentest.c
rsa_complex.c
rsa_mp_test.c
rsa_sp800_56b_test.c
rsa_test.c test: update RSA test with current bit strengths 2021-05-26 20:39:38 +10:00
run_tests.pl Make the 00-prep_*.t recipe truly mandatory 2021-06-01 15:07:51 +02:00
sanitytest.c
secmemtest.c
serverinfo2.pem
serverinfo.pem
servername_test.c
session.pem
shibboleth.pfx
shlibloadtest.c
simpledynamic.c
simpledynamic.h
siphash_internal_test.c
sm2_internal_test.c
sm4_internal_test.c
smcont_zero.txt
smcont.bin apps/cms.c: Correct -sign output and -verify input with -binary 2021-05-22 14:28:51 +02:00
smcont.txt
sparse_array_test.c Use "" for include internal/xxx 2021-05-27 09:56:41 +10:00
srptest.c
ssl_cert_table_internal_test.c
ssl_ctx_test.c
ssl_old_test.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
ssl_test_ctx_test.c
ssl_test_ctx_test.cnf
ssl_test.c Add SSL_OP_ALLOW_CLIENT_RENEGOTIATION 2021-05-17 10:53:30 +02:00
ssl_test.tmpl
sslapitest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
sslbuffertest.c
sslcorrupttest.c
stack_test.c
sysdefault.cnf
sysdefaulttest.c
test_test.c
test.cnf TEST: Prefer using precomputed RSA and DH keys for more efficient tests 2021-05-27 11:06:01 +02:00
testcrl.pem
testdsa.pem
testdsapub.pem
testec-p256.pem
testecpub-p256.pem
tested448.pem
tested448pub.pem
tested25519.pem
tested25519pub.pem
testp7.pem
testreq2.pem
testrsa2048.pem
testrsa_withattrs.der
testrsa_withattrs.pem
testrsa.pem
testrsapss.pem
testrsapssmandatory.pem
testrsapub.pem
testsid.pem Regenerate testsid.pem 2021-05-15 15:09:07 -07:00
testutil.h Enhance the encoder/decoder tests to allow testing with a non-default library context and configurable providers 2021-06-01 12:16:27 +02:00
testx509.pem
threadstest_fips.c test: add test case to reliably reproduce RAND leak during POST 2021-05-24 09:39:15 +10:00
threadstest.c test: fix typo in comment in threadstest.c 2021-05-24 09:39:15 +10:00
threadstest.h test: add test case to reliably reproduce RAND leak during POST 2021-05-24 09:39:15 +10:00
time_offset_test.c
tls13ccstest.c
tls13encryptiontest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
tls13secretstest.c Rename all getters to use get/get0 in name 2021-06-01 12:40:00 +02:00
tls-provider.c test: add zero strenght arguments to BN and RAND RNG calls 2021-05-29 17:17:12 +10:00
uitest.c
user_property_test.c
v3_ca_exts.cnf
v3-cert1.pem
v3-cert2.pem
v3ext.c
v3nametest.c
verify_extra_test.c
versions.c
wpackettest.c
x509_check_cert_pkey_test.c
x509_dup_cert_test.c
x509_internal_test.c
x509_time_test.c
x509aux.c

Using OpenSSL Tests

After a successful build, and before installing, the libraries should be tested. Run:

$ make test                                      # Unix
$ mms test                                       ! OpenVMS
$ nmake test                                     # Windows

Warning: you MUST run the tests from an unprivileged account (or disable your privileges temporarily if your platform allows it).

If some tests fail, take a look at the section Test Failures below.

Test Failures

If some tests fail, look at the output. There may be reasons for the failure that isn't a problem in OpenSSL itself (like an OS malfunction or a Perl issue). You may want increased verbosity, that can be accomplished like this:

Full verbosity, showing full output of all successful and failed test cases (make macro VERBOSE or V):

$ make V=1 test                                  # Unix
$ mms /macro=(V=1) test                          ! OpenVMS
$ nmake V=1 test                                 # Windows

Verbosity on failed (sub-)tests only (VERBOSE_FAILURE or VF or REPORT_FAILURES):

$ make test VF=1

Verbosity on failed (sub-)tests, in addition progress on succeeded (sub-)tests (VERBOSE_FAILURE_PROGRESS or VFP or REPORT_FAILURES_PROGRESS):

$ make test VFP=1

If you want to run just one or a few specific tests, you can use the make variable TESTS to specify them, like this:

$ make TESTS='test_rsa test_dsa' test            # Unix
$ mms/macro="TESTS=test_rsa test_dsa" test       ! OpenVMS
$ nmake TESTS='test_rsa test_dsa' test           # Windows

And of course, you can combine (Unix examples shown):

$ make test TESTS='test_rsa test_dsa' VF=1
$ make test TESTS="test_cmp_*" VFP=1

You can find the list of available tests like this:

$ make list-tests                                # Unix
$ mms list-tests                                 ! OpenVMS
$ nmake list-tests                               # Windows

Have a look at the manual for the perl module Test::Harness to see what other HARNESS_* variables there are.

To report a bug please open an issue on GitHub, at https://github.com/openssl/openssl/issues.

For more details on how the make variables TESTS can be used, see section Running Selected Tests below.

Running Selected Tests

The make variable TESTS supports a versatile set of space separated tokens with which you can specify a set of tests to be performed. With a "current set of tests" in mind, initially being empty, here are the possible tokens:

 alltests      The current set of tests becomes the whole set of available
               tests (as listed when you do 'make list-tests' or similar).

 xxx           Adds the test 'xxx' to the current set of tests.

-xxx           Removes 'xxx' from the current set of tests.  If this is the
               first token in the list, the current set of tests is first
               assigned the whole set of available tests, effectively making
               this token equivalent to TESTS="alltests -xxx".

 nn            Adds the test group 'nn' (which is a number) to the current
               set of tests.

-nn            Removes the test group 'nn' from the current set of tests.
               If this is the first token in the list, the current set of
               tests is first assigned the whole set of available tests,
               effectively making this token equivalent to
               TESTS="alltests -xxx".

Also, all tokens except for "alltests" may have wildcards, such as *. (on Unix and Windows, BSD style wildcards are supported, while on VMS, it's VMS style wildcards)

Examples

Run all tests except for the fuzz tests:

$ make TESTS='-test_fuzz*' test

or, if you want to be explicit:

$ make TESTS='alltests -test_fuzz*' test

Run all tests that have a name starting with "test_ssl" but not those starting with "test_ssl_":

$ make TESTS='test_ssl* -test_ssl_*' test

Run only test group 10:

$ make TESTS='10' test

Run all tests except the slow group (group 99):

$ make TESTS='-99' test

Run all tests in test groups 80 to 99 except for tests in group 90:

$ make TESTS='[89]? -90' test

To run specific fuzz tests you can use for instance:

$ make test TESTS='test_fuzz_cmp test_fuzz_cms'

To stochastically verify that the algorithm that produces uniformly distributed random numbers is operating correctly (with a false positive rate of 0.01%):

$ ./util/wrap.sh test/bntest -stochastic

Running Tests in Parallel

By default the test harness will execute the selected tests sequentially. Depending on the platform characteristics, running more than one test job in parallel may speed up test execution. This can be requested by setting the HARNESS_JOBS environment variable to a positive integer value. This specifies the maximum number of test jobs to run in parallel.

Depending on the Perl version different strategies could be adopted to select which test recipes can be run in parallel. In recent versions of Perl, unless specified otherwise, any task can be run in parallel. Consult the documentation for TAP::Harness to know more.

To run up to four tests in parallel at any given time:

$ make HARNESS_JOBS=4 test

Randomisation of Test Ordering

By default, the test harness will execute tests in the order they were added. By setting the OPENSSL_TEST_RAND_ORDER environment variable to zero, the test ordering will be randomised. If a randomly ordered test fails, the seed value used will be reported. Setting the OPENSSL_TEST_RAND_ORDER environment variable to this value will rerun the tests in the same order. This assures repeatability of randomly ordered test runs. This repeatability is independent of the operating system, processor or platform used.

To randomise the test ordering:

$ make OPENSSL_TEST_RAND_ORDER=0 test

To run the tests using the order defined by the random seed 42:

$ make OPENSSL_TEST_RAND_ORDER=42 test