b716bc8bf40e206ad070fdcfacab94e380315dda
[aaf/sshsm.git] / SoftHSMv2 / src / bin / keyconv / softhsm2-keyconv.1
1 .TH SOFTHSM2-KEYCONV 1 "20 March 2014" "SoftHSM"
2 .SH NAME
3 softhsm2-keyconv \- converting from BIND to PKCS#8 key file format
4 .SH SYNOPSIS
5 .B softhsm2-keyconv
6 .B \-\-in
7 .I path
8 .B \-\-out
9 .I path
10 .RB [ \-\-pin
11 .IR PIN ]
12 .SH DESCRIPTION
13 .B softhsm2-keyconv
14 can convert BIND .private-key files to the PKCS#8 file format.
15 This is so that you can import the PKCS#8 file into
16 libsofthsm using the command
17 .BR softhsm2\-util .
18 If you have another file format, then
19 .B openssl
20 probably can help you to convert it into the PKCS#8 file format.
21 .SH OPTIONS
22 .B \-\-help\fR, \fB\-h\fR
23 Shows the help screen.
24 .TP
25 .B \-\-in \fIpath\fR
26 The 
27 .I path
28 to the input file.
29 .TP
30 .B \-\-out \fIpath\fR
31 The
32 .I path
33 to the output file.
34 .TP
35 .B \-\-pin \fIPIN\fR
36 The
37 .I PIN
38 will be used to encrypt the PKCS#8 file.
39 If not given then the PKCS#8 file will be unencrypted.
40 .TP
41 .B \-\-version\fR, \fB\-v\fR
42 Show the version info.
43 .SH EXAMPLES
44 The following command can be used to convert a BIND .private-key file to a PKCS#8 file:
45 .LP
46 .RS
47 .nf
48 softhsm2-keyconv \-\-in Kexample.com.+007+05474.private \\
49 .ti +0.7i
50 \-\-out rsa.pem
51 .fi
52 .RE
53 .LP
54 .SH AUTHORS
55 Written by Rickard Bellgrim, Francis Dupont, RenĂ© Post, and Roland van Rijswijk.
56 .SH "SEE ALSO"
57 .IR softhsm2-migrate (1),
58 .IR softhsm2-util (1),
59 .IR softhsm2.conf (5),
60 .IR openssl (1),
61 .IR named (1),
62 .IR dnssec-keygen (1),
63 .IR dnssec-signzone (1)