michael@0: # ***** BEGIN LICENSE BLOCK ***** michael@0: # Version: MPL 1.1/GPL 2.0/LGPL 2.1 michael@0: # michael@0: # The contents of this file are subject to the Mozilla Public License Version michael@0: # 1.1 (the "License"); you may not use this file except in compliance with michael@0: # the License. You may obtain a copy of the License at michael@0: # http://www.mozilla.org/MPL/ michael@0: # michael@0: # Software distributed under the License is distributed on an "AS IS" basis, michael@0: # WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License michael@0: # for the specific language governing rights and limitations under the michael@0: # License. michael@0: # michael@0: # The Original Code is the PKIX-C library. michael@0: # michael@0: # The Initial Developer of the Original Code is michael@0: # Sun Microsystems, Inc. michael@0: # Portions created by the Initial Developer are michael@0: # Copyright 2004-2007 Sun Microsystems, Inc. All Rights Reserved. michael@0: # michael@0: # Contributor(s): michael@0: # Sun Microsystems, Inc. michael@0: # michael@0: # Alternatively, the contents of this file may be used under the terms of michael@0: # either the GNU General Public License Version 2 or later (the "GPL"), or michael@0: # the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), michael@0: # in which case the provisions of the GPL or the LGPL are applicable instead michael@0: # of those above. If you wish to allow use of your version of this file only michael@0: # under the terms of either the GPL or the LGPL, and not to allow others to michael@0: # use your version of this file under the terms of the MPL, indicate your michael@0: # decision by deleting the provisions above and replace them with the notice michael@0: # and other provisions required by the GPL or the LGPL. If you do not delete michael@0: # the provisions above, a recipient may use your version of this file under michael@0: # the terms of any one of the MPL, the GPL or the LGPL. michael@0: # michael@0: # ***** END LICENSE BLOCK ***** michael@0: michael@0: This directory contains both sample applications and performance evaluation michael@0: applications. michael@0: michael@0: SAMPLE APPLICATIONS michael@0: michael@0: Currently, there are two performance applications: libpkix_buildThreads and michael@0: nss_threads. And three sample applications: dumpcert, dumpcrl and michael@0: validateChain.. michael@0: michael@0: ============================================================================ michael@0: michael@0: USAGE: dumpcert michael@0: Parses a certificate located at and displays it. michael@0: michael@0: Source: /tests/sample_apps/dumpcert.c michael@0: Binary: /bin/sample_apps/dumpcert michael@0: michael@0: ============================================================================ michael@0: michael@0: USAGE: dumpcrl michael@0: Parses a CRL located at and displays it. michael@0: michael@0: Source: /tests/sample_apps/dumpcrl.c michael@0: Binary: /bin/sample_apps/dumpcrl michael@0: michael@0: ============================================================================ michael@0: michael@0: USAGE: validateChain ... michael@0: Validates a chain of n certificates using the given trust anchor. michael@0: michael@0: Source: /tests/sample_apps/validateChain.c michael@0: Binary: /bin/sample_apps/validateChain michael@0: michael@0: ============================================================================ michael@0: michael@0: PERFORMANCE EVALUATION APPLICATIONS michael@0: michael@0: ============================================================================ michael@0: michael@0: USAGE: libpkix_buildthreads michael@0: michael@0: Sets up and runs a PKIX_BuildChain call for the number of seconds michael@0: specified by using the number of threads specified by michael@0: . This application assumes that the NSS certutil application michael@0: has already been run to create the NSS databases and that the michael@0: various nicknames on the command line have been associated with michael@0: certificates in the NSS databases. The NSS databases MUST reside michael@0: in the directory where this file is located and MUST be named michael@0: "cert8.db", "key3.db", and "secmod.db". There must exist a nickname michael@0: in the databases which has been marked as trusted. michael@0: michael@0: Source: /perf/libpkix_buildthreads/libpkix_buildthreads.c michael@0: Binary: /perf/libpkix_buildthreads/*.OBJ/libpkix_buildthreads michael@0: michael@0: ============================================================================ michael@0: michael@0: USAGE: nssThreads michael@0: michael@0: Sets up and runs a CERT_VerifyCertificate call for the number of michael@0: seconds specified by using the number of threads specified michael@0: by . This application assumes that the NSS certutil michael@0: application has already been run to create the NSS databases and that michael@0: the various nicknames on the command line have been associated with michael@0: certificates in the NSS databases. The NSS databases MUST reside michael@0: in the directory where this file is located and MUST be named michael@0: "cert8.db", "key3.db", and "secmod.db". There must exist a nickname in michael@0: the databases which has been marked as trusted. michael@0: michael@0: Source: /perf/nss_threads/nss_threads.c michael@0: Binary: /perf/nss_threads/*.OBJ/nss_threads michael@0: michael@0: ============================================================================ michael@0: