Shane Lontis 991a6bb581 Add option to fipsinstall to disable fips security checks at run time. 4 years ago
..
certs cccf532fef Disallow certs with explicit curve in verification chain 4 years ago
ct 433deaffce Use .cnf for config files, not .conf 4 years ago
d2i-tests a378a46985 add test for CVE-2016-7053 8 years ago
ocsp-tests 121738d1cb Fix OCSP_basic_verify() cert chain construction in case bs->certs is NULL 7 years ago
ossl_shim 823a113574 Fix API rename issue in shim layer that calls EVP_MAC_CTX_set_params 4 years ago
recipes 991a6bb581 Add option to fipsinstall to disable fips security checks at run time. 4 years ago
smime-certs 0f84cbc3e2 Update copyright year 4 years ago
ssl-tests 341c3e7f28 Add fips checks for ecdh key agreement 4 years ago
testutil 1bb6f70da3 testutil: Add provider.c with test_get_libctx(), to use at least for SSL and CMP 4 years ago
CAtsa.cnf 23f3993127 Remove RANDFILE settings from configuration files 5 years ago
README-dev.md 036cbb6bbf Rename NOTES*, README*, VERSION, HACKING, LICENSE to .md or .txt 4 years ago
README-external.md 1dc1ea182b Fix many MarkDown issues in {NOTES*,README*,HACKING,LICENSE}.md files 4 years ago
README.md cb9bb7350d 99-test_fuzz.t: Clean up and re-organize such that sub-tests could be split easily 4 years ago
README.ssltest.md 257e9d03b0 Fix issues reported by markdownlint 4 years ago
aborttest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
acvp_test.c 0ab18e7924 Add EVP signature with libctx methods. 4 years ago
acvp_test.inc 4f2271d58a Add ACVP fips module tests 4 years ago
aesgcmtest.c 37322687b0 Retire EVP_CTRL_GET_IV 4 years ago
afalgtest.c e39e295e20 Update copyright year 4 years ago
asn1_decode_test.c 936c2b9e93 Update source files for deprecation at 3.0 5 years ago
asn1_dsa_internal_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
asn1_encode_test.c 936c2b9e93 Update source files for deprecation at 3.0 5 years ago
asn1_internal_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
asn1_string_table_test.c 275a7b9e5e typo ANS1 -> ASN1 6 years ago
asn1_time_test.c 33388b44b6 Update copyright year 4 years ago
asynciotest.c 33388b44b6 Update copyright year 4 years ago
asynctest.c e39e295e20 Update copyright year 4 years ago
bad_dtls_test.c 865adf97c9 Revert "The EVP_MAC functions have been renamed for consistency. The EVP_MAC_CTX_*" 4 years ago
bftest.c 33388b44b6 Update copyright year 4 years ago
bio_callback_test.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
bio_enc_test.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
bio_memleak_test.c 454afd9866 Update copyright year 4 years ago
bio_prefix_text.c 51a7c4b5f2 TEST: Add test recipe and help program to test BIO_f_prefix() 4 years ago
bioprinttest.c c4683009ad TEST: Adjust test/bioprinttest.c to behave like the testutil routines 4 years ago
bn_internal_test.c 454afd9866 Update copyright year 4 years ago
bn_rand_range.h 5d2f3e4a6c Test of uniformity of BN_rand_range output. 5 years ago
bntest.c 08073700cc NonStop port updates for 3.0.0. 4 years ago
bntests.pl 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
build.info f0c62c5328 TEST: Add a test of EC key generation with encoding spec 4 years ago
ca-and-certs.cnf 4e6e57cfcd Cleanup cert config files for tests 4 years ago
casttest.c 33388b44b6 Update copyright year 4 years ago
chacha_internal_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
cipher_overhead_test.c 706457b7bd Reorganize local header files 5 years ago
cipherbytes_test.c 6ac1cd10ba Fix safestack issues in ssl.h 4 years ago
cipherlist_test.c 6ac1cd10ba Fix safestack issues in ssl.h 4 years ago
ciphername_test.c 6ac1cd10ba Fix safestack issues in ssl.h 4 years ago
clienthellotest.c 33388b44b6 Update copyright year 4 years ago
cmactest.c a370ff8daa Add a CMAC test 4 years ago
cmp_asn_test.c 3dbc5156b0 chunk 6 of CMP contribution to OpenSSL 4 years ago
cmp_client_test.c 798f932980 Fix safestack issues in cmp.h 4 years ago
cmp_ctx_test.c 798f932980 Fix safestack issues in cmp.h 4 years ago
cmp_hdr_test.c 798f932980 Fix safestack issues in cmp.h 4 years ago
cmp_msg_test.c 798f932980 Fix safestack issues in cmp.h 4 years ago
cmp_protect_test.c e6623cfbff Fix safestack issues in x509.h 4 years ago
cmp_server_test.c ab28b59064 Add libctx/provider support to cmp_server_test 4 years ago
cmp_status_test.c b4780134df Fix safestack issues in asn1.h 4 years ago
cmp_testlib.c e6623cfbff Fix safestack issues in x509.h 4 years ago
cmp_testlib.h 9afa0748cf TEST: Fix CMP tests so they load keys in the current library context 4 years ago
cmp_vfy_test.c 98c35dc48d Fix safestack issues in crmf.h 4 years ago
cms-examples.pl 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
cmsapitest.c e6623cfbff Fix safestack issues in x509.h 4 years ago
conf_include_test.c 23f3993127 Remove RANDFILE settings from configuration files 5 years ago
confdump.c e74e562f1c Fix safestack issues in conf.h 4 years ago
constant_time_test.c 706457b7bd Reorganize local header files 5 years ago
context_internal_test.c 1aedc35fd6 Instead of global data store it in an OPENSSL_CTX 5 years ago
crltest.c e6623cfbff Fix safestack issues in x509.h 4 years ago
ct_test.c 9d01ac71a0 Fix safestack issues in ct.h 4 years ago
ctype_internal_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
curve448_internal_test.c 33388b44b6 Update copyright year 4 years ago
d2i_test.c 33388b44b6 Update copyright year 4 years ago
danetest.c e6623cfbff Fix safestack issues in x509.h 4 years ago
danetest.in 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
danetest.pem 170b735820 DANE support for X509_verify_cert() 8 years ago
data.txt 036cbb6bbf Rename NOTES*, README*, VERSION, HACKING, LICENSE to .md or .txt 4 years ago
data2.txt 036cbb6bbf Rename NOTES*, README*, VERSION, HACKING, LICENSE to .md or .txt 4 years ago
default-and-fips.cnf 1cd2c1f857 Update some nits around the FIPS module 4 years ago
default-and-legacy.cnf e2f72313cc test/recipes/30-test_evp.t: Modify to test with different providers 5 years ago
default.cnf e2f72313cc test/recipes/30-test_evp.t: Modify to test with different providers 5 years ago
defltfips_test.c bfa6aaab45 Test that EVP_default_properties_is_fips_enabled() works early 4 years ago
destest.c 33388b44b6 Update copyright year 4 years ago
dhtest.c 33388b44b6 Update copyright year 4 years ago
drbg_cavs_data.h ae4186b004 Fix header file include guard names 5 years ago
drbg_extra_test.h a6ed19dc9a Amend references to "OpenSSL license" 4 years ago
drbgtest.c 4f14a378f8 prov/drbg: cleanup some RAND_DRBG leftovers 4 years ago
drbgtest.h 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
dsa_no_digest_size_test.c 33388b44b6 Update copyright year 4 years ago
dsatest.c 023b188ca5 Make EVP_PKEY_CTX_[get|set]_group_name work for DH too 4 years ago
dtls_mtu_test.c 6ac1cd10ba Fix safestack issues in ssl.h 4 years ago
dtlstest.c 33388b44b6 Update copyright year 4 years ago
dtlsv1listentest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
ec_internal_test.c fe2f8aecfe EC_KEY: add EC_KEY_decoded_from_explicit_params() 4 years ago
ecdsatest.c 4bb73d5409 Add a NULL check to EVP_PKEY_assign 4 years ago
ecdsatest.h ae4186b004 Fix header file include guard names 5 years ago
ecstresstest.c dd6b270618 Remove tab characters from C source files. 5 years ago
ectest.c c0f39ded68 Add Explicit EC parameter support to providers. 4 years ago
endecode_test.c 1251cddf8d TEST: modify test/endecode_test.c to not use legacy keys 4 years ago
enginetest.c 41bbba5375 EVP: deprecate the EVP_X_meth_ functions. 4 years ago
errtest.c 17b7f89684 TEST: fix test/errtest.c 4 years ago
evp_extra_test.c f0c62c5328 TEST: Add a test of EC key generation with encoding spec 4 years ago
evp_extra_test2.c e31eda006f TEST: Add test to exercise OPENSSL_CTX_set0_default() 4 years ago
evp_fetch_prov_test.c 41bbba5375 EVP: deprecate the EVP_X_meth_ functions. 4 years ago
evp_kdf_test.c 1cae59d14b Make KDFs fail if requesting a zero-length key. 4 years ago
evp_libctx_test.c 24c4ea958e Fix stacks of OPENSSL_STRING, OPENSSL_CSTRING and OPENSSL_BLOCK 4 years ago
evp_pkey_dparams_test.c 10c25644e3 EC only uses approved curves in FIPS mode. 5 years ago
evp_pkey_provided_test.c ece9304c96 Rename OSSL_SERIALIZER / OSSL_DESERIALIZER to OSSL_ENCODE / OSSL_DECODE 4 years ago
evp_test.c 991a6bb581 Add option to fipsinstall to disable fips security checks at run time. 4 years ago
evp_test.h 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
exdatatest.c 00c405b365 Update copyright year 4 years ago
exptest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
fatalerrtest.c 33388b44b6 Update copyright year 4 years ago
ffc_internal_test.c 63794b048c Add multiple fixes for ffc key generation using invalid p,q,g parameters. 4 years ago
filterprov.c 363b1e5dae Make the naming scheme for dispatched functions more consistent 4 years ago
fips-and-base.cnf 39d9be390a Add CLI tests in FIPS configuration 4 years ago
fips.cnf bfa6aaab45 Test that EVP_default_properties_is_fips_enabled() works early 4 years ago
generate_buildtest.pl 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
generate_ssl_tests.pl 33388b44b6 Update copyright year 4 years ago
gmdifftest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
gosttest.c 5e30f2fd58 Use a non-default libctx in sslapitest 4 years ago
handshake_helper.c e6623cfbff Fix safestack issues in x509.h 4 years ago
handshake_helper.h ae4186b004 Fix header file include guard names 5 years ago
hexstr_test.c f32af93c92 Fix ERR_print_errors so that it matches the documented format in doc/man3/ERR_error_string.pod 4 years ago
hmactest.c 33388b44b6 Update copyright year 4 years ago
http_test.c e74e562f1c Fix safestack issues in conf.h 4 years ago
ideatest.c 33388b44b6 Update copyright year 4 years ago
igetest.c 7573fe1af5 Deprecate the AES_ige_*() functions 5 years ago
insta.priv.pem 8d9a4d833f Chunk 11 of CMP contribution to OpenSSL: CMP command-line interface 4 years ago
insta_ca.cert.pem 8d9a4d833f Chunk 11 of CMP contribution to OpenSSL: CMP command-line interface 4 years ago
keymgmt_internal_test.c 33388b44b6 Update copyright year 4 years ago
legacy.cnf e2f72313cc test/recipes/30-test_evp.t: Modify to test with different providers 5 years ago
lhash_test.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
mdc2_internal_test.c 33388b44b6 Update copyright year 4 years ago
mdc2test.c 33388b44b6 Update copyright year 4 years ago
memleaktest.c ea7a952c8a test/memleaktest.c: Modify for use with address/leak sanitizer 4 years ago
modes_internal_test.c 33388b44b6 Update copyright year 4 years ago
namemap_internal_test.c c720fc35f4 namemap: change ossl_namemap_empty() to do what the documentation says. 4 years ago
ocspapitest.c e6623cfbff Fix safestack issues in x509.h 4 years ago
ossl_store_test.c 97f7a6d42e Fix coverity issue: CID 1466482 - Resource leak in OSSL_STORE_SEARCH_by_key_fingerprint() 4 years ago
p_test.c 363b1e5dae Make the naming scheme for dispatched functions more consistent 4 years ago
packettest.c 0d345f0e10 Make the PACKET/WPACKET code available to both libcrypto and libssl 5 years ago
param_build_test.c 5fdaa38feb params: add OSSL_PARAM helpers for time_t. 4 years ago
params_api_test.c e23d850ff3 Add and use internal header that implements endianness check 4 years ago
params_conversion_test.c 33388b44b6 Update copyright year 4 years ago
params_test.c 33388b44b6 Update copyright year 4 years ago
pbelutest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
pemtest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
pkcs12_format_test.c c5ec6dcf0b Add new APIs to get PKCS12 secretBag OID and value 4 years ago
pkcs12_helper.c add3392727 Fix safestack issues in pkcs12.h 4 years ago
pkcs12_helper.h c5ec6dcf0b Add new APIs to get PKCS12 secretBag OID and value 4 years ago
pkcs7-1.pem d02b48c63a Import of old SSLeay release: SSLeay 0.8.1b 26 years ago
pkcs7.pem d02b48c63a Import of old SSLeay release: SSLeay 0.8.1b 26 years ago
pkey_meth_kdf_test.c 194de849cc Extend the EVP_PKEY KDF to KDF provider bridge to also support Scrypt 4 years ago
pkey_meth_test.c 0f84cbc3e2 Update copyright year 4 years ago
pkits-test.pl 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
poly1305_internal_test.c 3d5a7578e0 Add ChaCha related ciphers to default provider 5 years ago
property_test.c 454afd9866 Update copyright year 4 years ago
provider_fallback_test.c f995e5bdcd TEST: Add provider_fallback_test, to test aspects of fallback providers 4 years ago
provider_internal_test.c 29dc6e00f2 Load the config file by default 5 years ago
provider_internal_test.cnf.in 433deaffce Use .cnf for config files, not .conf 4 years ago
provider_status_test.c 04cb5ec0b7 Add 'on demand self test' and status test to providers 4 years ago
provider_test.c 4e7991b497 Change OSSL_PARAM return size to not be a pointer. 5 years ago
proxy.cnf 4e6e57cfcd Cleanup cert config files for tests 4 years ago
rand_status_test.c 4516bf7422 rand: instantiate the DRBGs upon first use. 4 years ago
rc2test.c 33388b44b6 Update copyright year 4 years ago
rc4test.c 33388b44b6 Update copyright year 4 years ago
rc5test.c 33388b44b6 Update copyright year 4 years ago
rdrand_sanitytest.c 24fd8541d4 Remove extern declarations of OPENSSL_ia32cap_P 5 years ago
recordlentest.c 33388b44b6 Update copyright year 4 years ago
rsa_complex.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
rsa_mp_test.c 33388b44b6 Update copyright year 4 years ago
rsa_sp800_56b_test.c 4f2271d58a Add ACVP fips module tests 4 years ago
rsa_test.c 33388b44b6 Update copyright year 4 years ago
run_tests.pl ef0f01c0af Avoid uninitialised variable warning for jobs 4 years ago
sanitytest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
secmemtest.c 33388b44b6 Update copyright year 4 years ago
serverinfo.pem c655f40ed2 Require ServerInfo PEMs to be named "BEGIN SERVERINFO FOR"... 11 years ago
serverinfo2.pem b878afae4b Add a SERVERINFOV2 format test file 7 years ago
servername_test.c 33388b44b6 Update copyright year 4 years ago
session.pem 6cf2dbd9fa Don't store the ticket nonce in the session 6 years ago
shibboleth.pfx 70bf33d182 Add PKCS#12 UTF-8 interoperability test. 8 years ago
shlibloadtest.c 50cd4768c6 Reorganize public header files (part 1) 5 years ago
siphash_internal_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
sm2_internal_test.c 33388b44b6 Update copyright year 4 years ago
sm4_internal_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
smcont.txt 382bb0b294 test/smcont.txt: trigger assertion in bio_enc.c. 8 years ago
sparse_array_test.c 25f2138b0a Reorganize private crypto header files 5 years ago
srptest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
ssl_cert_table_internal_test.c 706457b7bd Reorganize local header files 5 years ago
ssl_ctx_test.c 454afd9866 Update copyright year 4 years ago
ssl_test.c e6623cfbff Fix safestack issues in x509.h 4 years ago
ssl_test.tmpl f4941736a9 test/ssl_test.tmpl: make it work with elderly perl. 8 years ago
ssl_test_ctx.c e74e562f1c Fix safestack issues in conf.h 4 years ago
ssl_test_ctx.h 6725682d77 Add X509 related libctx changes. 4 years ago
ssl_test_ctx_test.c 06cee80a84 testutil: Make SETUP_TEST_FIXTURE return 0 on fixture == NULL 4 years ago
ssl_test_ctx_test.cnf 433deaffce Use .cnf for config files, not .conf 4 years ago
sslapitest.c 22fbfe6a7d Fix safestack issues in srp.h 4 years ago
sslbuffertest.c 33388b44b6 Update copyright year 4 years ago
sslcorrupttest.c 6ac1cd10ba Fix safestack issues in ssl.h 4 years ago
ssltest_old.c 24c4ea958e Fix stacks of OPENSSL_STRING, OPENSSL_CSTRING and OPENSSL_BLOCK 4 years ago
ssltestlib.c 0d52ede716 Fix error path in int create_ssl_ctx_pair() 4 years ago
ssltestlib.h 33388b44b6 Update copyright year 4 years ago
stack_test.c 225c9660a5 Ignore unused return values from some sk_*() macros 4 years ago
sysdefault.cnf 8a5ed9dce8 Apply system_default configuration on SSL_CTX_new(). 6 years ago
sysdefaulttest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
test.cnf d462b5ff21 Add -section option to 'req' command 4 years ago
test_test.c e0249827b3 Fix --strict-warnings build 5 years ago
testcrl.pem d02b48c63a Import of old SSLeay release: SSLeay 0.8.1b 26 years ago
testdsa.pem 79a578b902 Add private/public key conversion tests 9 years ago
testdsapub.pem 79a578b902 Add private/public key conversion tests 9 years ago
testec-p256.pem 79a578b902 Add private/public key conversion tests 9 years ago
testecpub-p256.pem 79a578b902 Add private/public key conversion tests 9 years ago
tested25519.pem 81722fdf2e More testing for CLI usage of Ed25519 and Ed448 keys 4 years ago
tested25519pub.pem 81722fdf2e More testing for CLI usage of Ed25519 and Ed448 keys 4 years ago
tested448.pem 81722fdf2e More testing for CLI usage of Ed25519 and Ed448 keys 4 years ago
tested448pub.pem 81722fdf2e More testing for CLI usage of Ed25519 and Ed448 keys 4 years ago
testp7.pem dcb1ef5c22 Change PKCS#7 test data to take account of removal of 24 years ago
testreq2.pem d02b48c63a Import of old SSLeay release: SSLeay 0.8.1b 26 years ago
testrsa.pem 10203a3472 Support writing RSA keys using the traditional format again 4 years ago
testrsa2048.pem 8d17cca5b8 Add fips checks for rsa encryption 4 years ago
testrsapub.pem 79a578b902 Add private/public key conversion tests 9 years ago
testsid.pem 45f55f6a5b Remove SSLv2 support 10 years ago
testutil.h 1bb6f70da3 testutil: Add provider.c with test_get_libctx(), to use at least for SSL and CMP 4 years ago
testx509.pem 1e41dadfa7 Extend X509 cert checks and error reporting in v3_{purp,crld}.c and x509_{set,vfy}.c 4 years ago
threadstest.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
time_offset_test.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
tls-provider.c bfa6aaab45 Test that EVP_default_properties_is_fips_enabled() works early 4 years ago
tls13ccstest.c 33388b44b6 Update copyright year 4 years ago
tls13encryptiontest.c ec27e619e8 Move MAC removal responsibility to the various protocol "enc" functions 4 years ago
tls13secretstest.c 33388b44b6 Update copyright year 4 years ago
uitest.c f84de16f39 apps_ui.c: Improve error handling and return value of setup_ui_method() 4 years ago
v3-cert1.pem d02b48c63a Import of old SSLeay release: SSLeay 0.8.1b 26 years ago
v3-cert2.pem d02b48c63a Import of old SSLeay release: SSLeay 0.8.1b 26 years ago
v3_ca_exts.cnf 4acd484d55 Make x509 -force_pubkey test case with self-issued cert more realistic 4 years ago
v3ext.c 33388b44b6 Update copyright year 4 years ago
v3nametest.c e144fd36ce Fix safestack issues in x509v3.h 4 years ago
verify_extra_test.c e6623cfbff Fix safestack issues in x509.h 4 years ago
versions.c 909f1a2e51 Following the license change, modify the boilerplates in test/ 6 years ago
wpackettest.c 12cbb8e049 WPACKET: don't write DER length when we don't want to 4 years ago
x509_check_cert_pkey_test.c 33388b44b6 Update copyright year 4 years ago
x509_dup_cert_test.c 33388b44b6 Update copyright year 4 years ago
x509_internal_test.c 878dc8dd95 Join the x509 and x509v3 directories 5 years ago
x509_time_test.c 33388b44b6 Update copyright year 4 years ago
x509aux.c 33388b44b6 Update copyright year 4 years ago

README-dev.md

Guidelines for test developers

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/build.info. Please refer to the section "Changes to test/build.info" below.

Naming conventions

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:

00-04  sanity, internal and essential API tests
05-09  individual symmetric cipher algorithms
10-14  math (bignum)
15-19  individual asymmetric cipher algorithms
20-24  openssl commands (some otherwise not tested)
25-29  certificate forms, generation and verification
30-35  engine and evp
60-79  APIs:
   60  X509 subsystem
   61  BIO subsystem
   65  CMP subsystem
   70  PACKET layer
80-89  "larger" protocols (CA, CMS, OCSP, SSL, TSA)
90-98  misc
99     most time consuming tests [such as test_fuzz]

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 util/perl/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 util/perl/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/build.info

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):

  • add {name} to the list of programs under PROGRAMS_NO_INST

  • create a three line description of how to build the test, you will have to modify the include paths and source files if you don't want to use the basic test framework:

    SOURCE[{name}]={name}.c INCLUDE[{name}]=.. ../include ../apps/include DEPEND[{name}]=../libcrypto libtestutil.a

Generic form of C test executables

#include "testutil.h"

static int my_test(void)
{
    int testresult = 0;                 /* Assume the test will fail    */
    int observed;

    observed = function();              /* Call the code under test     */
    if (!TEST_int_eq(observed, 2))      /* Check the result is correct  */
        goto end;                       /* Exit on failure - optional   */

    testresult = 1;                     /* Mark the test case a success */
end:
    cleanup();                          /* Any cleanup you require      */
    return testresult;
}

int setup_tests(void)
{
    ADD_TEST(my_test);                  /* Add each test separately     */
    return 1;                           /* Indicate success             */
}

You should use the TEST_xxx macros provided by testutil.h to test all failure conditions. These macros produce an error message in a standard format if the condition is not met (and nothing if the condition is met). Additional information can be presented with the TEST_info macro that takes a printf format string and arguments. TEST_error is useful for complicated conditions, it also takes a printf format string and argument. In all cases the TEST_xxx macros are guaranteed to evaluate their arguments exactly once. This means that expressions with side effects are allowed as parameters. Thus,

if (!TEST_ptr(ptr = OPENSSL_malloc(..)))

works fine and can be used in place of:

ptr = OPENSSL_malloc(..);
if (!TEST_ptr(ptr))

The former produces a more meaningful message on failure than the latter.

Note that the test infrastructure automatically sets up all required environment variables (such as OPENSSL_MODULES, OPENSSL_CONF, etc.) for the tests. Individual tests may choose to override the default settings as required.