Rev 2 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 2 | Rev 5 | ||
---|---|---|---|
1 | .\" Hey, EMACS: -*- nroff -*- |
1 | .\" Hey, EMACS: -*- nroff -*- |
2 | .\" First parameter, NAME, should be all caps |
2 | .\" First parameter, NAME, should be all caps |
3 | .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
3 | .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
4 | .\" other parameters are allowed: see man(7), man(1) |
4 | .\" other parameters are allowed: see man(7), man(1) |
5 | .TH LSH-KEYGEN 1 "Aug 21 2002" lsh-keygen "lsh manuals" |
5 | .TH LSH-KEYGEN 1 "Aug 21 2002" lsh-keygen "lsh manuals" |
6 | .\" Please adjust this date whenever revising the manpage. |
6 | .\" Please adjust this date whenever revising the manpage. |
7 | .\" |
7 | .\" |
8 | .\" Some roff macros, for reference: |
8 | .\" Some roff macros, for reference: |
9 | .\" .nh disable hyphenation |
9 | .\" .nh disable hyphenation |
10 | .\" .hy enable hyphenation |
10 | .\" .hy enable hyphenation |
11 | .\" .ad l left justify |
11 | .\" .ad l left justify |
12 | .\" .ad b justify to both left and right margins |
12 | .\" .ad b justify to both left and right margins |
13 | .\" .nf disable filling |
13 | .\" .nf disable filling |
14 | .\" .fi enable filling |
14 | .\" .fi enable filling |
15 | .\" .br insert line break |
15 | .\" .br insert line break |
16 | .\" .sp <n> insert n+1 empty lines |
16 | .\" .sp <n> insert n+1 empty lines |
17 | .\" for manpage-specific macros, see man(7) |
17 | .\" for manpage-specific macros, see man(7) |
18 | .SH NAME |
18 | .SH NAME |
19 | lsh-keygen \- generate a public/private key pair |
19 | lsh-keygen \- generate a public/private key pair |
20 | .SH SYNOPSIS |
20 | .SH SYNOPSIS |
21 | .B lsh-keygen |
21 | .B lsh-keygen |
22 | .RI [ options ] |
22 | .RI [ options ] |
23 | .SH DESCRIPTION |
23 | .SH DESCRIPTION |
24 | This manual page documents briefly the |
24 | This manual page documents briefly the |
25 | .B lsh-keygen |
25 | .B lsh-keygen |
26 | command. |
26 | command. |
27 | This manual page was written for the Debian distribution |
27 | This manual page was written for the Debian distribution |
28 | because the original program does not have a manual page. |
28 | because the original program does not have a manual page. |
29 | Instead, it has documentation in the GNU Info format; see below. |
29 | Instead, it has documentation in the GNU Info format; see below. |
30 | .PP |
30 | .PP |
31 | .\" TeX users may be more comfortable with the \fB<whatever>\fP and |
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, |
32 | .\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
33 | .\" respectively. |
33 | .\" respectively. |
34 | \fBlsh-keygen\fP is a program that generates a public / private key pair in |
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 |
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. |
36 | output to \fBlsh-writekey(1)\fP to write it to disk. |
37 | .SH OPTIONS |
37 | .SH OPTIONS |
38 | This program follows the usual GNU command line syntax, with long |
38 | This program follows the usual GNU command line syntax, with long |
39 | options starting with two dashes (`-'). |
39 | options starting with two dashes (`-'). |
40 | A summary of options is included below. |
40 | A summary of options is included below. |
41 | For a complete description, see the Info files. |
41 | For a complete description, see the Info files. |
42 | .TP |
42 | .TP |
43 | .B \-f, \-\-output\-format=\fIformat\fP |
43 | .B \-f, \-\-output\-format=\fIformat\fP |
44 | The output SPKI format to use. Valid values of \fIformat\fP are "transport", |
44 | The output SPKI format to use. Valid values of \fIformat\fP are "transport", |
45 | "canonical", "advanced" and "international". The default format is "transport". |
45 | "canonical", "advanced" and "international". The default format is "transport". |
46 | See also \fBSPKI(5)\fP. |
46 | See also \fBSPKI(5)\fP. |
47 | .TP |
47 | .TP |
48 | .B \-l, \-\-nist\-level=\fIsecurity\-level\fP |
48 | .B \-l, \-\-nist\-level=\fIsecurity\-level\fP |
49 | For DSA keys, this is the NIST security level: level 0 uses 512-bit primes, |
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 |
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. |
51 | length of the modulus, and the default is 2048 bits. |
52 | .TP |
52 | .TP |
53 | .B \-a, \-\-algorithm=\fIalgorithm\fP |
53 | .B \-a, \-\-algorithm=\fIalgorithm\fP |
54 | The public / private key algorithm to use. This can be either "RSA" or "DSA". |
54 | The public / private key algorithm to use. This can be either "RSA" or "DSA". |
55 | The default is to generate DSA keys. |
55 | The default is to generate DSA keys. |
56 | .TP |
56 | .TP |
57 | .B \-\-server |
57 | .B \-\-server |
58 | Use the server random seed file |
58 | Use the server random seed file |
59 | .TP |
59 | .TP |
60 | .B \-\-debug |
60 | .B \-\-debug |
61 | Print huge amounts of debug information. |
61 | Print huge amounts of debug information. |
62 | .TP |
62 | .TP |
63 | .B \-\-log\-file=\fIfile\fP |
63 | .B \-\-log\-file=\fIfile\fP |
64 | Append messages to \fIfile\fP. |
64 | Append messages to \fIfile\fP. |
65 | .TP |
65 | .TP |
66 | .B \-q, \-\-quiet |
66 | .B \-q, \-\-quiet |
67 | Suppress all warnings and diagnostic messages. |
67 | Suppress all warnings and diagnostic messages. |
68 | .TP |
68 | .TP |
69 | .B \-\-trace |
69 | .B \-\-trace |
70 | Print a detailed program trace. |
70 | Print a detailed program trace. |
71 | .TP |
71 | .TP |
72 | .B \-v, \-\-verbose |
72 | .B \-v, \-\-verbose |
73 | Print verbose diagnostic messages |
73 | Print verbose diagnostic messages |
74 | .TP |
74 | .TP |
75 | .B \-?, \-\-help |
75 | .B \-?, \-\-help |
76 | Show summary of options. |
76 | Show summary of options. |
77 | .TP |
77 | .TP |
78 | .B \-\-usage |
78 | .B \-\-usage |
79 | Show a short usage message. |
79 | Show a short usage message. |
80 | .TP |
80 | .TP |
81 | .B \-V, \-\-version |
81 | .B \-V, \-\-version |
82 | Show version of program. |
82 | Show version of program. |
83 | .SH EXAMPLE |
83 | .SH EXAMPLE |
84 | A typical usage of lsh-keygen is: |
84 | A typical usage of lsh-keygen is: |
85 | 85 | ||
86 | lsh-keygen -l 8 | lsh-writekey |
86 | lsh-keygen -l 8 | lsh-writekey |
87 | 87 | ||
88 | Which generates a public / private key pair and stores it using |
88 | Which generates a public / private key pair and stores it using |
89 | \fBlsh-writekey(1)\fP. |
89 | \fBlsh-writekey(1)\fP. |
90 | .SH BUGS |
90 | .SH BUGS |
91 | lsh-writekey should use \fBrandom(4)\fP rather than a less strong source of |
91 | lsh-writekey should use \fBrandom(4)\fP rather than a less strong source of |
92 | randomness like \fBurandom(4)\fP where available. |
92 | randomness like \fBurandom(4)\fP where available. |
93 | .SH SEE ALSO |
93 | .SH SEE ALSO |
94 | .BR lsh-writekey (1), |
94 | .BR lsh-writekey (1), |
95 | .BR lsh-make-seed (1), |
95 | .BR lsh-make-seed (1), |
96 | .BR lshc (1), |
96 | .BR lshc (1), |
97 | .BR lshd (8), |
97 | .BR lshd (8), |
98 | .BR DSA (5), |
98 | .BR DSA (5), |
99 | .BR SPKI (5). |
99 | .BR SPKI (5). |
100 | .BR |
100 | .BR |
101 | The programs are documented fully by |
101 | The programs are documented fully by |
102 | .IR "Lsh" , |
102 | .IR "Lsh" , |
103 | available via the Info system. |
103 | available via the Info system. |
104 | .SH AUTHOR |
104 | .SH AUTHOR |
105 | This manual page was written by Timshel Knoll <timshel@debian.org>, |
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). |
106 | for the Debian GNU/Linux system (but may be used by others). |