RetroZilla/security/nss/tests/libpkix/sample_apps/README
roytam1 a572ea8ca3 cherry-picked mozilla NSS upstream changes (to rev 82de44ead36f, which is on par with 3.18):
bug1095307, bug1073330(backout), bug1084986, bug1050069, bug942172, bug1054547, bug532081, bug1096348, bug1058870, bug1093940, bug1102985, bug1112461, bug1094492, bug112029, bug1119983, bug1120685, bug1120691, bug1113632, bug863076, bug1082973, bug1124539, bug1117617, bug1117621, bug1121273, bug753136, bug921684, bug1132818, bug1125375, bug647690, bug1055441, bug1134455, bug975010, bug950369, bug1128367, bug1129573, bug1136095, bug1117897, bug1113453, bug1061725, bug1073330, bug1111901, bug1083900, bug1136095, bug1138820, bug1096741, bug1134548, bug345725, bug950348, bug950344, bug1151037, bug991783, bug1153994
2018-07-14 21:22:30 +08:00

78 lines
3.1 KiB
Plaintext

# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
This directory contains both sample applications and performance evaluation
applications.
SAMPLE APPLICATIONS
Currently, there are two performance applications: libpkix_buildThreads and
nss_threads. And three sample applications: dumpcert, dumpcrl and
validateChain..
============================================================================
USAGE: dumpcert <certFile>
Parses a certificate located at <certFile> and displays it.
Source: <root>/tests/sample_apps/dumpcert.c
Binary: <root>/bin/sample_apps/dumpcert
============================================================================
USAGE: dumpcrl <crlFile>
Parses a CRL located at <crlFile> and displays it.
Source: <root>/tests/sample_apps/dumpcrl.c
Binary: <root>/bin/sample_apps/dumpcrl
============================================================================
USAGE: validateChain <trustedCert> <cert_1> <cert_2> ... <cert_n>
Validates a chain of n certificates using the given trust anchor.
Source: <root>/tests/sample_apps/validateChain.c
Binary: <root>/bin/sample_apps/validateChain
============================================================================
PERFORMANCE EVALUATION APPLICATIONS
============================================================================
USAGE: libpkix_buildthreads <duration> <threads> <eecertNickname>
Sets up and runs a PKIX_BuildChain call for the number of seconds
specified by <duration> using the number of threads specified by
<threads>. This application assumes that the NSS certutil application
has already been run to create the NSS databases and that the
various nicknames on the command line have been associated with
certificates in the NSS databases. The NSS databases MUST reside
in the directory where this file is located and MUST be named
"cert8.db", "key3.db", and "secmod.db". There must exist a nickname
in the databases which has been marked as trusted.
Source: <root>/perf/libpkix_buildthreads/libpkix_buildthreads.c
Binary: <root>/perf/libpkix_buildthreads/*.OBJ/libpkix_buildthreads
============================================================================
USAGE: nssThreads <duration> <threads> <eecertNickname>
Sets up and runs a CERT_VerifyCertificate call for the number of
seconds specified by <duration> using the number of threads specified
by <threads>. This application assumes that the NSS certutil
application has already been run to create the NSS databases and that
the various nicknames on the command line have been associated with
certificates in the NSS databases. The NSS databases MUST reside
in the directory where this file is located and MUST be named
"cert8.db", "key3.db", and "secmod.db". There must exist a nickname in
the databases which has been marked as trusted.
Source: <root>/perf/nss_threads/nss_threads.c
Binary: <root>/perf/nss_threads/*.OBJ/nss_threads
============================================================================