xref: /illumos-gate/usr/src/test/crypto-tests/doc/README (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1cd964fceSMatt Barden#
2cd964fceSMatt Barden# This file and its contents are supplied under the terms of the
3cd964fceSMatt Barden# Common Development and Distribution License ("CDDL"), version 1.0.
4cd964fceSMatt Barden# You may only use this file in accordance with the terms of version
5cd964fceSMatt Barden# 1.0 of the CDDL.
6cd964fceSMatt Barden#
7cd964fceSMatt Barden# A full copy of the text of the CDDL should have accompanied this
8cd964fceSMatt Barden# source.  A copy of the CDDL is also available via the Internet at
9cd964fceSMatt Barden# http://www.illumos.org/license/CDDL.
10cd964fceSMatt Barden#
11cd964fceSMatt Barden
12cd964fceSMatt Barden#
13cd964fceSMatt Barden# Copyright (c) 2012 by Delphix. All rights reserved.
14cd964fceSMatt Barden# Copyright 2015 Nexenta Systems, Inc.  All rights reserved.
15cd964fceSMatt Barden#
16cd964fceSMatt Barden
17cd964fceSMatt BardenKCF/PKCS Unit Test Suite README
18cd964fceSMatt Barden
19cd964fceSMatt Barden1. Building and installing the KCF/PKCS Unit Test Suite
20cd964fceSMatt Barden2. Running the KCF/PKCS Unit Test Suite
21cd964fceSMatt Barden3. Test results
22cd964fceSMatt Barden
23cd964fceSMatt Barden--------------------------------------------------------------------------------
24cd964fceSMatt Barden
25cd964fceSMatt Barden1. Building and installing the KCF/PKCS Unit Test Suite
26cd964fceSMatt Barden
27cd964fceSMatt BardenThe KCF/PKCS Unit Test Suite runs under the testrunner framework (which can be
28cd964fceSMatt Bardeninstalled as pkg:/system/test/testrunner). To build both the KCF/PKCS Unit Test Suite
29cd964fceSMatt Bardenand the testrunner without running a full nightly:
30cd964fceSMatt Barden
31cd964fceSMatt Barden	build_machine$ bldenv [-d] <your_env_file>
32cd964fceSMatt Barden	build_machine$ cd $SRC/test
33cd964fceSMatt Barden	build_machine$ dmake install
34cd964fceSMatt Barden	build_machine$ cd $SRC/pkg
35cd964fceSMatt Barden	build_machine$ dmake install
36cd964fceSMatt Barden
37cd964fceSMatt BardenThen set the publisher on the test machine to point to your repository and
38cd964fceSMatt Bardeninstall the KCF/PKCS Unit Test Suite.
39cd964fceSMatt Barden
40cd964fceSMatt Barden	test_machine# pkg install pkg:/system/test/cryptotest
41cd964fceSMatt Barden
42cd964fceSMatt BardenNote, the framework will be installed automatically, as the KCF/PKCS Unit Test Suite
43cd964fceSMatt Bardendepends on it.
44cd964fceSMatt Barden
45cd964fceSMatt Barden2. Running the KCF/PKCS Unit Test Suite
46cd964fceSMatt Barden
47cd964fceSMatt BardenThe pre-requisites for running the KCF/PKCS Unit Test Suite are:
48*bbf21555SRichard Lowe	- A non-root user with the ability to sudo(8) to root without a
49cd964fceSMatt Barden	  password or the root user must run the test.
50cd964fceSMatt Barden
51cd964fceSMatt BardenOnce the pre-requisites are satisfied, simply run the cryptotest script:
52cd964fceSMatt Barden
53cd964fceSMatt Barden	test_machine$ /opt/crypto-tests/bin/cryptotest
54cd964fceSMatt Barden
55cd964fceSMatt Barden3. Test results
56cd964fceSMatt Barden
57cd964fceSMatt BardenWhile the KCF/PKCS Unit Test Suite is running, one informational line is printed at
58cd964fceSMatt Bardenthe end of each test, and a results summary is printed at the end of the run.
59cd964fceSMatt BardenThe results summary includes the location of the complete logs, which is of the
60cd964fceSMatt Bardenform /var/tmp/test_results/<ISO 8601 date>.
61