openCryptoki Test Programs

This directory contains programs designed to test the functionality of
openCryptoki and PKCS#11.  The rely on STDLL's installed to the standard system
location.  Many of the programs have command line options for passing the slot
number to use (default is slot 0) as well as other options.  All programs expect
that the a slot has been intialized using pkcsconf.  The expected user pin is
"01234567" and this can also be set using pkcsconf.  The expected PINs can also
be changed by modifying DEFAULT_USER_PIN and DEFAULT_SO_PIN in
include/regress.h.

For correct testcase execution, the token should be initialized before and
after running the testcases.

crypto
------
This directory contains testcases to test various crypto algorithms.

login
-----
This directory contains testcases to test login functionality in pkcs11
and opencryptoki.

pkcs11
------
This directory contains tests that tests various api/functionality in 
pkcs11 specification.

misc_tests
----------
This directory contains tests to test various functionality and operations
in opencryptoki.

build
-----
This directory contains build tests: a failed test is indicated by a build
break.

policy
------
This directory contains policy related tests. Test results are dependent on the
current policy and strength settings.

unit
----
This directory contains unit tests that are run via 'make check'.

ock_test.sh
-----------
This driver runs the various testcases on all tokens currently configured, 
unless the '-s SLOT' option is specified. It initializes the tokens and sets
SO and USER pins, if the tokens are not already initialized. Set environment
variables PKCS11_SO_PIN and PKCS11_USER_PIN to the pins to use.

ciconfig.sh
-----------
This script sets up the openCryptoki tokens for a run in the CI. It creates
an opencryptoki.conf config file together with several token specific config
files. The CI run is started via 'make ci-installcheck'. Do NOT run this outside
of the CI, it may destroy your openCryptoki setup, tokens, and objects!

For help, open an issue at https://github.com/opencryptoki/opencryptoki/issues
