Debian Codegraph @

testcases/README

raw
1 openCryptoki Test Programs
2
3 This directory contains programs designed to test the functionality of
4 openCryptoki and PKCS#11. The rely on STDLL's installed to the standard system
5 location. Many of the programs have command line options for passing the slot
6 number to use (default is slot 0) as well as other options. All programs expect
7 that the a slot has been intialized using pkcsconf. The expected user pin is
8 "01234567" and this can also be set using pkcsconf. The expected PINs can also
9 be changed by modifying DEFAULT_USER_PIN and DEFAULT_SO_PIN in
10 include/regress.h.
11
12 For correct testcase execution, the token should be initialized before and
13 after running the testcases.
14
15 crypto
16 ------
17 This directory contains testcases to test various crypto algorithms.
18
19 login
20 -----
21 This directory contains testcases to test login functionality in pkcs11
22 and opencryptoki.
23
24 pkcs11
25 ------
26 This directory contains tests that tests various api/functionality in
27 pkcs11 specification.
28
29 misc_tests
30 ----------
31 This directory contains tests to test various functionality and operations
32 in opencryptoki.
33
34 build
35 -----
36 This directory contains build tests: a failed test is indicated by a build
37 break.
38
39 policy
40 ------
41 This directory contains policy related tests. Test results are dependent on the
42 current policy and strength settings.
43
44 unit
45 ----
46 This directory contains unit tests that are run via 'make check'.
47
48 ock_test.sh
49 -----------
50 This driver runs the various testcases on all tokens currently configured,
51 unless the '-s SLOT' option is specified. It initializes the tokens and sets
52 SO and USER pins, if the tokens are not already initialized. Set environment
53 variables PKCS11_SO_PIN and PKCS11_USER_PIN to the pins to use.
54
55 ciconfig.sh
56 -----------
57 This script sets up the openCryptoki tokens for a run in the CI. It creates
58 an opencryptoki.conf config file together with several token specific config
59 files. The CI run is started via 'make ci-installcheck'. Do NOT run this outside
60 of the CI, it may destroy your openCryptoki setup, tokens, and objects!
61
62 For help, open an issue at https://github.com/opencryptoki/opencryptoki/issues