Subversion Repositories

?revision_form?Rev ?revision_input??revision_submit??revision_endform?

Rev 34 | Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
18 magnus 1
.\"                                      Hey, EMACS: -*- nroff -*-
2
.\" First parameter, NAME, should be all caps
3
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4
.\" other parameters are allowed: see man(7), man(1)
5
.TH PKCS1\-CONV 1 "June 2007" "nettle 1.15" "Nettle tools"
6
.\" Please adjust this date whenever revising the manpage.
7
.\"
8
.\" Some roff macros, for reference:
9
.\" .nh        disable hyphenation
10
.\" .hy        enable hyphenation
11
.\" .ad l      left justify
12
.\" .ad b      justify to both left and right margins
13
.\" .nf        disable filling
14
.\" .fi        enable filling
15
.\" .br        insert line break
16
.\" .sp <n>    insert n+1 empty lines
17
.\" for manpage-specific macros, see man(7)
18
.SH NAME
19
pkcs1\-conv \- convert keys from PKCS#1 format to s-expression format
20
.SH SYNOPSIS
21
.B pkcs1-conv
22
.RB [{ \-\-private-rsa-key | \-\-public-rsa-key | \-\-public-key-info }
23
.RB [ \-\-base-64 ]]
24
.RI <\  FILE
25
.SH DESCRIPTION
26
This manual page documents briefly the
27
.B pkcs1\-conv
28
command.
29
This manual page was written for the Debian GNU/Linux distribution
30
because the original program does not have a manual page.
31
.PP
32
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
33
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
34
.\" respectively.
35
\fBpkcs1\-conv\fP converts private and public RSA keys from PKCS #1
36
format to sexp format.
37
.SH OPTIONS
38
This program follows the usual GNU command line syntax, with long
39
options starting with two dashes (`\-').
40
.PP
41
By default pkcs1-conv expects a PEM-encapsulated RSA key on standard input,
42
and will determine its type from the Pre-Encapsulation Boundary.
43
To convert a DER-encoded (non PEM-encoded) key, one of the first three
44
options below must be used:
45
.TP
46
.B \-\-private-rsa-key
47
Specify that a DER-encoded RSAPrivateKey, as defined by PKCS #1 (RFC 3447),
48
and described in section A.1.2 of its appendix A, is to be expected as input.
49
.TP
50
.B \-\-public-rsa-key
51
Specify that a DER-encoded RSAPublicKey, as defined by PKCS #1 (RFC 3447),
52
and described in section A.1.1 of its appendix A, is to be expected as input.
53
.TP
54
.B \-\-public-key-info
55
Specify that a DER-encoded SubjectPublicKeyInfo, as defined by PKCS #6,
56
and described in section A.1 of its appendix A, encapsulating an RSAPublicKey,
57
is to be expected as input.
58
.TP
59
.B \-\-base-64
60
Together with \-\-private-rsa-key, \-\-public-rsa-key, or \-\-public-key-info,
61
specify that base64 encoding is applied on top of the DER encoding.
62
.TP
63
.B \-?, \-\-help
64
Show summary of options (not implemented).
65
.TP
66
.B \-V, \-\-version
67
Show version of program.
68
.SH DIAGNOSTICS
69
pkcs1\-conv will complain and exit with a status of 1
70
if the input doesn't match expectations. In PEM mode
71
(when no option is used), if no PEM block is found, pkcs1\-conv
72
will output nothing but exit with a zero status.
73
.SH EXAMPLES
74
.nf
75
$ openssl genrsa \-out privkey.pem
76
$ pkcs1\-conv < privkey.pem > privkey.sexp
77
$ openssl rsa \-in privkey.pem \-outform DER \-out privkey.der
78
$ openssl rsa \-in privkey.pem \-outform DER \-pubout \-out pubkey.der
79
$ pkcs1-conv \-\-rsa-private-key < privkey.der > privkey.sexp
80
$ pkcs1-conv \-\-public-key-info < pubkey.der > pubkey.sexp
81
.fi
82
.SH SEE ALSO
83
.BR ssh\-conv (1),
84
.BR sexp\-conv (1),
85
.BR rsa (1SSL),
86
.BR genrsa (1SSL),
87
RFC 3447.
88
.SH AUTHOR
89
This manual page was written by Magnus Holmgren <magnus@kibibyte.se>,
90
for the Debian GNU/Linux system (but may be used by others).