Subversion Repositories

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

Rev 5 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 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 LSH-KEYGEN 1 "Aug 21 2002" lsh-keygen "lsh manuals"
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
lsh-keygen \- generate a public/private key pair
20
.SH SYNOPSIS
21
.B lsh-keygen
22
.RI [ options ]
23
.SH DESCRIPTION
24
This manual page documents briefly the
25
.B lsh-keygen
26
command.
27
This manual page was written for the Debian distribution
28
because the original program does not have a manual page.
29
Instead, it has documentation in the GNU Info format; see below.
30
.PP
31
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
32
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
33
.\" respectively.
34
\fBlsh-keygen\fP is a program that generates a public / private key pair in
35
\fBSPKI(5)\fP format and writes it to stdout. Usually you will pipe this
36
output to \fBlsh-writekey(1)\fP to write it to disk.
37
.SH OPTIONS
38
This program follows the usual GNU command line syntax, with long
39
options starting with two dashes (`-').
40
A summary of options is included below.
41
For a complete description, see the Info files.
42
.TP
43
.B \-f, \-\-output\-format=\fIformat\fP
44
The output SPKI format to use. Valid values of \fIformat\fP are "transport",
45
"canonical", "advanced" and "international". The default format is "transport".
46
See also \fBSPKI(5)\fP.
47
.TP
48
.B \-l, \-\-nist\-level=\fIsecurity\-level\fP
49
For DSA keys, this is the NIST security level: level 0 uses 512-bit primes,
50
level 8 uses 1024 bit primes, and the default is 8. For RSA keys, it's the bit
51
length of the modulus, and the default is 2048 bits.
52
.TP
53
.B \-a, \-\-algorithm=\fIalgorithm\fP
54
The public / private key algorithm to use. This can be either "RSA" or "DSA".
55
The default is to generate DSA keys.
56
.TP
57
.B \-\-server
58
Use the server random seed file
59
.TP
60
.B \-\-debug
61
Print huge amounts of debug information.
62
.TP
63
.B \-\-log\-file=\fIfile\fP
64
Append messages to \fIfile\fP.
65
.TP
66
.B \-q, \-\-quiet
67
Suppress all warnings and diagnostic messages.
68
.TP
69
.B \-\-trace
70
Print a detailed program trace.
71
.TP
72
.B \-v, \-\-verbose
73
Print verbose diagnostic messages
74
.TP
75
.B \-?, \-\-help
76
Show summary of options.
77
.TP
78
.B \-\-usage
79
Show a short usage message.
80
.TP
81
.B \-V, \-\-version
82
Show version of program.
83
.SH EXAMPLE
84
A typical usage of lsh-keygen is:
85
 
86
lsh-keygen -l 8 | lsh-writekey
87
 
88
Which generates a public / private key pair and stores it using
89
\fBlsh-writekey(1)\fP.
90
.SH BUGS
91
lsh-writekey should use \fBrandom(4)\fP rather than a less strong source of
92
randomness like \fBurandom(4)\fP where available.
93
.SH SEE ALSO
94
.BR lsh-writekey (1),
95
.BR lsh-make-seed (1),
29 magnus 96
.BR lsh (1),
2 magnus 97
.BR lshd (8),
98
.BR DSA (5),
99
.BR SPKI (5).
100
.BR
101
The programs are documented fully by
102
.IR "Lsh" ,
103
available via the Info system.
104
.SH AUTHOR
105
This manual page was written by Timshel Knoll <timshel@debian.org>,
106
for the Debian GNU/Linux system (but may be used by others).