xref: /illumos-gate/usr/src/cmd/smbsrv/test-crypt/README (revision 34bbc83afbf22a6f8e504cb99d76c97c017cb5f4)
1
2#
3# This file and its contents are supplied under the terms of the
4# Common Development and Distribution License ("CDDL"), version 1.0.
5# You may only use this file in accordance with the terms of version
6# 1.0 of the CDDL.
7#
8# A full copy of the text of the CDDL should have accompanied this
9# source.  A copy of the CDDL is also available via the Internet at
10# http://www.illumos.org/license/CDDL.
11#
12
13#
14# Copyright 2021 Tintri by DDN, Inc. All rights reserved.
15#
16
17This directory contains a simple test of the encrypt/decrypt interfaces
18described by smbsrv/smb_kcrypt.h
19
20To build the tests:
21	make install
22
23To run the tests: (on the build system)
24	./Run.sh
25
26For debugging, start by uncommenting the dtrace lines in the
27Run.sh script, and/or run with gdb (see .gdbrc)
28
29If you need to debug in the crypto provider libraries (or even just
30look with gdb) it's easiest to run with a customized pkcs11.conf
31See how the Run.sh file sets the environment for that.
32Your custom pkcs11.conf file should look like this:
33(Substitute your own WS root in there.)
34
35# Start SUNWcsr
36metaslot:metaslot_status=enabled;metaslot_auto_key_migrate=enabled;metaslot_token=Sun Software PKCS#11 softtoken;metaslot_slot=Sun Crypto Softtoken
37/tank/ws2/il-fc-smb/proto/root_i386/usr/lib/security/$ISA/pkcs11_kernel.so
38/tank/ws2/il-fc-smb/proto/root_i386/usr/lib/security/$ISA/pkcs11_softtoken.so
39/tank/ws2/il-fc-smb/proto/root_i386/usr/lib/security/$ISA/pkcs11_tpm.so
40# End SUNWcsr
41