Subversion Repositories nettle

Compare Revisions

Ignore whitespace Rev 18 → Rev 19

/branches/experimental/debian/sexp-conv.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 "June 6, 2007" sexp-conv "Nettle 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
Conversion:
.br
.B sexp-conv
.RI [ options ]
.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,9 → 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. It is primarily
\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
store on disk in that format, but may be of other use as well.
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 (`-').
41,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 lsh (1),
.BR lshd (8).
.BR lshd (8),
http://theworld.com/~cme/spki.txt.
.br
The programs are documented fully by the
.IR "sexp"
90,7 → 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>,
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>.
/branches/experimental/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).
/branches/experimental/debian/changelog
11,6 → 11,14
 
-- Magnus Holmgren <magnus@kibibyte.se> Wed, 06 Jun 2007 15:28:29 +0200
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.
/branches/experimental/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).