← Back to branch summary

~ubuntu-branches/ubuntu/quantal/gnutls26/quantal-security

« back to all changes in this revision

Viewing changes to doc/manpages/p11tool.1

  • Committer: Package Import Robot
  • Author(s): Andreas Metzler
  • Date: 2011-10-01 15:28:13 UTC
  • mfrom: (12.1.20 sid)
  • Revision ID: package-import@ubuntu.com-20111001152813-yygm1c4cxonfxhzy
Tags: 2.12.11-1
http://bugs.debian.org/640639
* New upstream version.
  + Allow CA importing of 0 certificates to succeed. Closes: #640639
* Add libp11-kit-dev to libgnutls-dev dependencies. (see #643811)
* [20_guiledocstring.diff] guile: Fix docstring extraction with CPP 4.5+.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/manpages/p11tool.1
 
1
.TH p11tool 1 "November 11th 2010"
 
2
.SH NAME
 
3
p11tool \- Manipulate PKCS #11 tokens.
 
4
.SH SYNOPSIS
 
5
p11tool [\fIoptions\fR]
 
6
.SH DESCRIPTION
 
7
Export/import data from PKCS #11 tokens. To use PKCS #11 tokens with
 
8
gnutls the configuration file /etc/gnutls/pkcs11.conf has to exist and
 
9
contain a number of lines of the form "load=/usr/lib/opensc-pkcs11.so".
 
10
.SH OPTIONS
 
11
.SS Program control options
 
12
.IP "\-d, \-\-debug LEVEL"
 
13
Specify the debug level. Default is 1.
 
14
.IP "\-h, \-\-help"
 
15
Shows this help text
 
16
 
 
17
.SS Generic options
 
18
.IP "\-\-login"
 
19
Force login to the token for the intended operation.
 
20
.IP "\-\-provider MODULE"
 
21
In addition to /etc/gnutls/pkcs11.conf, load the specified module.
 
22
.IP "\-\-outfile FILE"
 
23
Print output to FILE.
 
24
.IP "\-\-inder, \-\-inraw"
 
25
Input is DER formatted.
 
26
 
 
27
.SS Getting information on available X.509 certificates
 
28
.IP "\-\-list\-tokens"
 
29
Prints all available tokens.
 
30
.IP "\-\-initialize URL"
 
31
Initializes (formats) the specified by the URL token. Note that
 
32
several tokens do not support this fascility.
 
33
 
 
34
.SS Getting information on available X.509 certificates
 
35
.IP "\-\-list\-all\-certs"
 
36
Prints all available certificates.
 
37
.IP "\-\-list\-certs"
 
38
Prints all certificates that have a corresponding private key stored in the token.
 
39
.IP "\-\-list\-trusted"
 
40
Prints all certificates that have been marked as trusted.
 
41
 
 
42
.SS Getting information on private keys
 
43
.IP "\-\-list\-privkeys"
 
44
Prints all available private keys.
 
45
 
 
46
.SS Handling generic objects
 
47
.IP "\-\-export URL"
 
48
Exports the object (e.g. certificate) specified by the URL.
 
49
.IP "\-\-delete URL"
 
50
Deletes the object specified by the URL. Note that several tokens do not
 
51
support deletion.
 
52
.IP "\-\-detailed\-url"
 
53
When printing URLs print them in a detailed (to the PKCS #11 module used)
 
54
form.
 
55
.IP "\-\-no\-detailed\-url"
 
56
When printing URLs, do not print details on the module used.
 
57
 
 
58
.SS Storing objects
 
59
.IP "\-\-write URL"
 
60
Flag to set when writing an object. Requires one of \-\-load\-privkey, \-\-load\-pubkey,
 
61
\-\-load\-certificate or \-\-secret\-key options.
 
62
.IP "\-\-load\-privkey"
 
63
Load a private key for the write operations.
 
64
.IP "\-\-load\-pubkey"
 
65
Load an X.509 subjectPublicKey for the write operation.
 
66
.IP "\-\-load\-certificate"
 
67
Load an X.509 certificate for the write operation.
 
68
.IP "\-\-secret\-key"
 
69
Specify a hex encoded secret key for the write operation.
 
70
.IP "\-\-trusted"
 
71
The object stored will be marked as trusted.
 
72
.IP "\-\-label"
 
73
The label of the object stored.
 
74
 
 
75
.SS Controlling output
 
76
.IP "\-8, \-\-pkcs8"
 
77
Use PKCS #8 format for private keys.
 
78
 
 
79
.SH EXAMPLES
 
80
To store a private key and certificate, run:
 
81
 
 
82
.RS
 
83
.nf
 
84
$ p11tool \-\-login \-\-write "pkcs11:XXX"  \-\-load\-privkey key.pem \-\-label "MyKey"
 
85
$ p11tool \-\-login \-\-write "pkcs11:XXX"  \-\-load\-certificate cert.pem \-\-label "MyCert"
 
86
.fi
 
87
.RE
 
88
 
 
89
To view all objects in a token, use:
 
90
 
 
91
.RS
 
92
.nf
 
93
$ p11tool \-\-login \-\-list\-all 
 
94
.fi
 
95
.RE
 
96
 
 
97
.SH AUTHOR
 
98
.PP
 
99
Nikos Mavrogiannopoulos <nmav@gnutls.org> and others; see
 
100
/usr/share/doc/gnutls\-bin/AUTHORS for a complete list.