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