#
# This file and its contents are supplied under the terms of the
# Common Development and Distribution License ("CDDL"), version 1.0.
# You may only use this file in accordance with the terms of version
# 1.0 of the CDDL.
#
# A full copy of the text of the CDDL should have accompanied this
# source.  A copy of the CDDL is also available via the Internet at
# http://www.illumos.org/license/CDDL.
#

#
# Copyright (c) 2012 by Delphix. All rights reserved.
# Copyright 2015 Nexenta Systems, Inc.  All rights reserved.
#

KCF/PKCS Unit Test Suite README

1. Building and installing the KCF/PKCS Unit Test Suite
2. Running the KCF/PKCS Unit Test Suite
3. Test results

--------------------------------------------------------------------------------

1. Building and installing the KCF/PKCS Unit Test Suite

The KCF/PKCS Unit Test Suite runs under the testrunner framework (which can be
installed as pkg:/system/test/testrunner). To build both the KCF/PKCS Unit Test Suite
and the testrunner without running a full nightly:

	build_machine$ bldenv [-d] <your_env_file>
	build_machine$ cd $SRC/test
	build_machine$ dmake install
	build_machine$ cd $SRC/pkg
	build_machine$ dmake install

Then set the publisher on the test machine to point to your repository and
install the KCF/PKCS Unit Test Suite.

	test_machine# pkg install pkg:/system/test/cryptotest

Note, the framework will be installed automatically, as the KCF/PKCS Unit Test Suite
depends on it.

2. Running the KCF/PKCS Unit Test Suite

The pre-requisites for running the KCF/PKCS Unit Test Suite are:
	- A non-root user with the ability to sudo(8) to root without a
	  password or the root user must run the test.

Once the pre-requisites are satisfied, simply run the cryptotest script:

	test_machine$ /opt/crypto-tests/bin/cryptotest

3. Test results

While the KCF/PKCS Unit Test Suite is running, one informational line is printed at
the end of each test, and a results summary is printed at the end of the run.
The results summary includes the location of the complete logs, which is of the
form /var/tmp/test_results/<ISO 8601 date>.