← Back to branch summary

~ubuntu-branches/ubuntu/lucid/nss/lucid-security

« back to all changes in this revision

Viewing changes to mozilla/security/nss/tests/libpkix/sample_apps/README

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2013-11-15 08:08:08 UTC
  • mfrom: (1.2.7)
  • Revision ID: package-import@ubuntu.com-20131115080808-dba1asgnjl9tc66s
Tags: 3.15.3-0ubuntu0.10.04.1
* SECURITY UPDATE: New upstream release to fix multiple security issues
  and add TLSv1.2 support.
  - CVE-2013-1739
  - CVE-2013-1741
  - CVE-2013-5605
  - CVE-2013-5606
* Adjusted packaging for 3.15.3:
  - debian/patches/*: refreshed.
  - debian/patches/01_dont_build_nspr.patch: removed, changed build
    options in debian/rules instead.
  - debian/libnss3-1d.symbols: added new symbols.
  - debian/rules: updated for new source layout.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mozilla/security/nss/tests/libpkix/sample_apps/README
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