The Tor Browser / file comparison
comparison: security/nss/tests/libpkix/sample_apps/README
security/nss/tests/libpkix/sample_apps/README
- branch
- TOR_BUG_9701
- changeset 15
- b8a032363ba2
equal
deleted
inserted
replaced
| -1:000000000000 | 0:d4adff8ce69a |
|---|---|
| 1 # ***** BEGIN LICENSE BLOCK ***** | |
| 2 # Version: MPL 1.1/GPL 2.0/LGPL 2.1 | |
| 3 # | |
| 4 # The contents of this file are subject to the Mozilla Public License Version | |
| 5 # 1.1 (the "License"); you may not use this file except in compliance with | |
| 6 # the License. You may obtain a copy of the License at | |
| 7 # http://www.mozilla.org/MPL/ | |
| 8 # | |
| 9 # Software distributed under the License is distributed on an "AS IS" basis, | |
| 10 # WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License | |
| 11 # for the specific language governing rights and limitations under the | |
| 12 # License. | |
| 13 # | |
| 14 # The Original Code is the PKIX-C library. | |
| 15 # | |
| 16 # The Initial Developer of the Original Code is | |
| 17 # Sun Microsystems, Inc. | |
| 18 # Portions created by the Initial Developer are | |
| 19 # Copyright 2004-2007 Sun Microsystems, Inc. All Rights Reserved. | |
| 20 # | |
| 21 # Contributor(s): | |
| 22 # Sun Microsystems, Inc. | |
| 23 # | |
| 24 # Alternatively, the contents of this file may be used under the terms of | |
| 25 # either the GNU General Public License Version 2 or later (the "GPL"), or | |
| 26 # the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), | |
| 27 # in which case the provisions of the GPL or the LGPL are applicable instead | |
| 28 # of those above. If you wish to allow use of your version of this file only | |
| 29 # under the terms of either the GPL or the LGPL, and not to allow others to | |
| 30 # use your version of this file under the terms of the MPL, indicate your | |
| 31 # decision by deleting the provisions above and replace them with the notice | |
| 32 # and other provisions required by the GPL or the LGPL. If you do not delete | |
| 33 # the provisions above, a recipient may use your version of this file under | |
| 34 # the terms of any one of the MPL, the GPL or the LGPL. | |
| 35 # | |
| 36 # ***** END LICENSE BLOCK ***** | |
| 37 | |
| 38 This directory contains both sample applications and performance evaluation | |
| 39 applications. | |
| 40 | |
| 41 SAMPLE APPLICATIONS | |
| 42 | |
| 43 Currently, there are two performance applications: libpkix_buildThreads and | |
| 44 nss_threads. And three sample applications: dumpcert, dumpcrl and | |
| 45 validateChain.. | |
| 46 | |
| 47 ============================================================================ | |
| 48 | |
| 49 USAGE: dumpcert <certFile> | |
| 50 Parses a certificate located at <certFile> and displays it. | |
| 51 | |
| 52 Source: <root>/tests/sample_apps/dumpcert.c | |
| 53 Binary: <root>/bin/sample_apps/dumpcert | |
| 54 | |
| 55 ============================================================================ | |
| 56 | |
| 57 USAGE: dumpcrl <crlFile> | |
| 58 Parses a CRL located at <crlFile> and displays it. | |
| 59 | |
| 60 Source: <root>/tests/sample_apps/dumpcrl.c | |
| 61 Binary: <root>/bin/sample_apps/dumpcrl | |
| 62 | |
| 63 ============================================================================ | |
| 64 | |
| 65 USAGE: validateChain <trustedCert> <cert_1> <cert_2> ... <cert_n> | |
| 66 Validates a chain of n certificates using the given trust anchor. | |
| 67 | |
| 68 Source: <root>/tests/sample_apps/validateChain.c | |
| 69 Binary: <root>/bin/sample_apps/validateChain | |
| 70 | |
| 71 ============================================================================ | |
| 72 | |
| 73 PERFORMANCE EVALUATION APPLICATIONS | |
| 74 | |
| 75 ============================================================================ | |
| 76 | |
| 77 USAGE: libpkix_buildthreads <duration> <threads> <eecertNickname> | |
| 78 | |
| 79 Sets up and runs a PKIX_BuildChain call for the number of seconds | |
| 80 specified by <duration> using the number of threads specified by | |
| 81 <threads>. This application assumes that the NSS certutil application | |
| 82 has already been run to create the NSS databases and that the | |
| 83 various nicknames on the command line have been associated with | |
| 84 certificates in the NSS databases. The NSS databases MUST reside | |
| 85 in the directory where this file is located and MUST be named | |
| 86 "cert8.db", "key3.db", and "secmod.db". There must exist a nickname | |
| 87 in the databases which has been marked as trusted. | |
| 88 | |
| 89 Source: <root>/perf/libpkix_buildthreads/libpkix_buildthreads.c | |
| 90 Binary: <root>/perf/libpkix_buildthreads/*.OBJ/libpkix_buildthreads | |
| 91 | |
| 92 ============================================================================ | |
| 93 | |
| 94 USAGE: nssThreads <duration> <threads> <eecertNickname> | |
| 95 | |
| 96 Sets up and runs a CERT_VerifyCertificate call for the number of | |
| 97 seconds specified by <duration> using the number of threads specified | |
| 98 by <threads>. This application assumes that the NSS certutil | |
| 99 application has already been run to create the NSS databases and that | |
| 100 the various nicknames on the command line have been associated with | |
| 101 certificates in the NSS databases. The NSS databases MUST reside | |
| 102 in the directory where this file is located and MUST be named | |
| 103 "cert8.db", "key3.db", and "secmod.db". There must exist a nickname in | |
| 104 the databases which has been marked as trusted. | |
| 105 | |
| 106 Source: <root>/perf/nss_threads/nss_threads.c | |
| 107 Binary: <root>/perf/nss_threads/*.OBJ/nss_threads | |
| 108 | |
| 109 ============================================================================ | |
| 110 |
