/trunk/debian/pkcs1-conv.1 |
---|
0,0 → 1,90 |
.\" Hey, EMACS: -*- nroff -*- |
.\" First parameter, NAME, should be all caps |
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
.\" other parameters are allowed: see man(7), man(1) |
.TH PKCS1\-CONV 1 "June 2007" "nettle 1.15" "Nettle tools" |
.\" Please adjust this date whenever revising the manpage. |
.\" |
.\" Some roff macros, for reference: |
.\" .nh disable hyphenation |
.\" .hy enable hyphenation |
.\" .ad l left justify |
.\" .ad b justify to both left and right margins |
.\" .nf disable filling |
.\" .fi enable filling |
.\" .br insert line break |
.\" .sp <n> insert n+1 empty lines |
.\" for manpage-specific macros, see man(7) |
.SH NAME |
pkcs1\-conv \- convert keys from PKCS#1 format to s-expression format |
.SH SYNOPSIS |
.B pkcs1-conv |
.RB [{ \-\-private-rsa-key | \-\-public-rsa-key | \-\-public-key-info } |
.RB [ \-\-base-64 ]] |
.RI <\ FILE |
.SH DESCRIPTION |
This manual page documents briefly the |
.B pkcs1\-conv |
command. |
This manual page was written for the Debian GNU/Linux distribution |
because the original program does not have a manual page. |
.PP |
.\" TeX users may be more comfortable with the \fB<whatever>\fP and |
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
.\" respectively. |
\fBpkcs1\-conv\fP converts private and public RSA keys from PKCS #1 |
format to sexp format. |
.SH OPTIONS |
This program follows the usual GNU command line syntax, with long |
options starting with two dashes (`\-'). |
.PP |
By default pkcs1-conv expects a PEM-encapsulated RSA key on standard input, |
and will determine its type from the Pre-Encapsulation Boundary. |
To convert a DER-encoded (non PEM-encoded) key, one of the first three |
options below must be used: |
.TP |
.B \-\-private-rsa-key |
Specify that a DER-encoded RSAPrivateKey, as defined by PKCS #1 (RFC 3447), |
and described in section A.1.2 of its appendix A, is to be expected as input. |
.TP |
.B \-\-public-rsa-key |
Specify that a DER-encoded RSAPublicKey, as defined by PKCS #1 (RFC 3447), |
and described in section A.1.1 of its appendix A, is to be expected as input. |
.TP |
.B \-\-public-key-info |
Specify that a DER-encoded SubjectPublicKeyInfo, as defined by PKCS #6, |
and described in section A.1 of its appendix A, encapsulating an RSAPublicKey, |
is to be expected as input. |
.TP |
.B \-\-base-64 |
Together with \-\-private-rsa-key, \-\-public-rsa-key, or \-\-public-key-info, |
specify that base64 encoding is applied on top of the DER encoding. |
.TP |
.B \-?, \-\-help |
Show summary of options (not implemented). |
.TP |
.B \-V, \-\-version |
Show version of program. |
.SH DIAGNOSTICS |
pkcs1\-conv will complain and exit with a status of 1 |
if the input doesn't match expectations. In PEM mode |
(when no option is used), if no PEM block is found, pkcs1\-conv |
will output nothing but exit with a zero status. |
.SH EXAMPLES |
.nf |
$ openssl genrsa \-out privkey.pem |
$ pkcs1\-conv < privkey.pem > privkey.sexp |
$ openssl rsa \-in privkey.pem \-outform DER \-out privkey.der |
$ openssl rsa \-in privkey.pem \-outform DER \-pubout \-out pubkey.der |
$ pkcs1-conv \-\-rsa-private-key < privkey.der > privkey.sexp |
$ pkcs1-conv \-\-public-key-info < pubkey.der > pubkey.sexp |
.fi |
.SH SEE ALSO |
.BR ssh\-conv (1), |
.BR sexp\-conv (1), |
.BR rsa (1SSL), |
.BR genrsa (1SSL), |
RFC 3447. |
.SH AUTHOR |
This manual page was written by Magnus Holmgren <magnus@kibibyte.se>, |
for the Debian GNU/Linux system (but may be used by others). |
/trunk/debian/changelog |
---|
1,3 → 1,11 |
nettle (1.15-4) unstable; urgency=low |
* Add manpage for nettle-lfib-stream(1) (Closes: #413293). |
* Add manpage for pkcs1-conv(1) (Closes: #413294). |
* Correct manpage for sexp-conv(1). |
-- Magnus Holmgren <magnus@kibibyte.se> Mon, 11 Jun 2007 13:37:53 +0200 |
nettle (1.15-3) unstable; urgency=low |
* Use dh_install instead of dh_movefiles. |
/trunk/debian/nettle-lfib-stream.1 |
---|
0,0 → 1,44 |
.\" Hey, EMACS: -*- nroff -*- |
.\" First parameter, NAME, should be all caps |
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
.\" other parameters are allowed: see man(7), man(1) |
.TH NETTLE\-LFIB\-STREAM 1 "June 2007" "nettle 1.15" "Nettle tools" |
.\" Please adjust this date whenever revising the manpage. |
.\" |
.\" Some roff macros, for reference: |
.\" .nh disable hyphenation |
.\" .hy enable hyphenation |
.\" .ad l left justify |
.\" .ad b justify to both left and right margins |
.\" .nf disable filling |
.\" .fi enable filling |
.\" .br insert line break |
.\" .sp <n> insert n+1 empty lines |
.\" for manpage-specific macros, see man(7) |
.SH NAME |
nettle\-lfib\-stream \- pseudorandom generator |
.SH SYNOPSIS |
.B nettle\-lfib\-stream |
.RI [ seed ] |
.SH DESCRIPTION |
This manual page documents briefly the |
.B nettle\-lfib\-stream |
command. |
This manual page was written for the Debian GNU/Linux distribution |
because the original program does not have a manual page. |
.PP |
.\" TeX users may be more comfortable with the \fB<whatever>\fP and |
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
.\" respectively. |
\fBnettle\-lfib\-stream\fP outputs a sequence |
of pseudorandom (non-cryptographic) bytes, using Knuth's lagged |
fibonacci generator, optionally using the integer \fIseed\fR as the |
seed. If no seed is given, \fBtime\fR(2) is used. |
.PP |
\fBWarning:\fP The stream is useful for testing, but should not be used |
to generate cryptographic keys or anything else that needs real randomness. |
.SH SEE ALSO |
http://en.wikipedia.org/wiki/Lagged_Fibonacci_generator |
.SH AUTHOR |
This manual page was written by Magnus Holmgren <magnus@kibibyte.se>, |
for the Debian GNU/Linux system (but may be used by others). |
/trunk/debian/sexp-conv.nettle.1 |
---|
2,7 → 2,7 |
.\" First parameter, NAME, should be all caps |
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
.\" other parameters are allowed: see man(7), man(1) |
.TH SEXP-CONV 1 "Apr 19, 2002" sexp-conv "Lsh Manuals" |
.TH SEXP\-CONV 1 "June 2007" "nettle 1.15" "Nettle tools" |
.\" Please adjust this date whenever revising the manpage. |
.\" |
.\" Some roff macros, for reference: |
16,13 → 16,22 |
.\" .sp <n> insert n+1 empty lines |
.\" for manpage-specific macros, see man(7) |
.SH NAME |
sexp_conv \- convert s-expression to a different encoding |
sexp\-conv \- convert s-expression to a different encoding |
.SH SYNOPSIS |
.B sexp_conv |
.RI [ options ] |
Conversion: |
.br |
.B sexp-conv |
.RI [ OPTION ]... |
.RI <\ INPUT-SEXP |
.PP |
Fingerprinting: |
.br |
.B sexp-conv --hash\fR[\fB=\fP\fIalgorithm\fP] |
.RI [ OPTION ]... |
.RI <\ INPUT-SEXP |
.SH DESCRIPTION |
This manual page documents briefly the |
.B sexp_conv |
.B sexp\-conv |
command. |
This manual page was written for the Debian GNU/Linux distribution |
because the original program does not have a manual page. |
31,8 → 40,10 |
.\" TeX users may be more comfortable with the \fB<whatever>\fP and |
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
.\" respectively. |
\fBsexp_conv\fP is a program that converts S-expressions (keys and |
most other objects which `lsh' needs to store on disk) |
\fBsexp\-conv\fP is a program that converts S-expressions. It automatically |
detects the s-expression syntax variant of the input. It is primarily |
used by the `lsh' packages, which stores keys and most other objects |
on disk in that format, but may be of other use as well. |
.SH OPTIONS |
This program follows the usual GNU command line syntax, with long |
options starting with two dashes (`-'). |
40,49 → 51,35 |
For a complete description, see the Info files. |
.TP |
.B \-\-hash=\fIalgorithm\fP |
Hash algorithm (default: sha1). |
Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1). |
.TP |
.B \-\-raw\-hash |
Alias for \-\-hash, for compatibility with lsh 1.x. |
.TP |
.B \-\-once |
Process at most one s-expression. |
Process exactly one s-expression. |
.TP |
.B \-\-raw\-hash |
Output the hash for the canonical representation of the object, in hexadecimal. |
.TP |
.B \-\-spki\-hash |
Output an SPKI hash for the object. |
Output an SPKI hash for the object. \fBNot yet implemented.\fP |
.TP |
.B \-\-debug |
Print huge amounts of debug information. |
.B \-s, \-\-syntax=\fIformat\fP |
Variant of S-expression to output. Valid S-expression formats are: transport, |
canonical (binary), advanced, and hex (same as advanced, but numbers in hex |
instead of base64). |
.TP |
.B \-q, \-\-quiet |
Supress all warnings and diagnostic messages. |
.B \-w, \-\-width=\fIwidth\fP |
Limit output to lines of \fIwidth\fP characters (has no effect on canonical syntax). Zero means no limit. |
.TP |
.B \-\-trace |
Detailed trace. |
.TP |
.B \-v, \-\-verbose |
Verbose diagnostic messages. |
.TP |
.B \-i, \-\-input\-format=\fIformat\fP |
Variant of S-expression to accept. Valid S-expression formats are: transport, |
canonical, advanced and international. |
.TP |
.B \-o, \-\-output\-format=\fIformat\fP |
Variant of S-expression to output. Valid S-expression formats are: transport, |
canonical, advanced and international. |
.TP |
.B \-?, \-\-help |
Show summary of options. |
.TP |
.B \-\-usage |
Give a short usage message. |
.TP |
.B \-v, \-\-version |
.B \-V, \-\-version |
Show version of program. |
.SH SEE ALSO |
.BR ssh-conv (1), |
.BR lshc (1), |
.BR lshd (8). |
.BR lsh (1), |
.BR lshd (8), |
http://theworld.com/~cme/spki.txt. |
.br |
The programs are documented fully by the |
.IR "sexp" |
89,6 → 86,9 |
section under the |
.IR "Getting Started" |
header of the lsh info page, available via the Info system. |
.SH BUGS |
This program should be documented in the nettle manual, not in the lsh manual. |
.SH AUTHOR |
This manual page was written by Timshel Knoll <timshel@debian.org>, |
for the Debian GNU/Linux system (but may be used by others). |
This manual page was originally written by Timshel Knoll <timshel@debian.org>, |
for the Debian GNU/Linux system (but may be used by others). Edited |
by Magnus Holmgren <magnus@kibibyte.se>. |