WebSVN - Diff - Rev 2 and 17 - /trunk/debian/mans/lsh-keygen.1


.\"                                      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 LSH-KEYGEN 1 "Aug 21 2002" lsh-keygen "lsh manuals"
.\" 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
lsh-keygen \- generate a public/private key pair
.SH SYNOPSIS
.B lsh-keygen
.RI [ options ]
.SH DESCRIPTION
This manual page documents briefly the
.B lsh-keygen
command.
This manual page was written for the Debian distribution
because the original program does not have a manual page.
Instead, it has documentation in the GNU Info format; see below.
.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.
\fBlsh-keygen\fP is a program that generates a public / private key pair in
\fBSPKI(5)\fP format and writes it to stdout. Usually you will pipe this
output to \fBlsh-writekey(1)\fP to write it to disk.
.SH OPTIONS
This program follows the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
For a complete description, see the Info files.
.TP
.B \-f, \-\-output\-format=\fIformat\fP
The output SPKI format to use. Valid values of \fIformat\fP are "transport",
"canonical", "advanced" and "international". The default format is "transport".
See also \fBSPKI(5)\fP.
.TP
.B \-l, \-\-nist\-level=\fIsecurity\-level\fP
For DSA keys, this is the NIST security level: level 0 uses 512-bit primes,
level 8 uses 1024 bit primes, and the default is 8. For RSA keys, it's the bit
length of the modulus, and the default is 2048 bits.
.TP
.B \-a, \-\-algorithm=\fIalgorithm\fP
The public / private key algorithm to use. This can be either "RSA" or "DSA".
The default is to generate DSA keys.
.TP
.B \-\-server
Use the server random seed file
.TP
.B \-\-debug
Print huge amounts of debug information.
.TP
.B \-\-log\-file=\fIfile\fP
Append messages to \fIfile\fP.
.TP
.B \-q, \-\-quiet
Suppress all warnings and diagnostic messages.
.TP
.B \-\-trace
Print a detailed program trace.
.TP
.B \-v, \-\-verbose
Print verbose diagnostic messages
.TP
.B \-?, \-\-help
Show summary of options.
.TP
.B \-\-usage
Show a short usage message.
.TP
.B \-V, \-\-version
Show version of program.
.SH EXAMPLE
A typical usage of lsh-keygen is:

lsh-keygen -l 8 | lsh-writekey

Which generates a public / private key pair and stores it using
\fBlsh-writekey(1)\fP.
.SH BUGS
lsh-writekey should use \fBrandom(4)\fP rather than a less strong source of
randomness like \fBurandom(4)\fP where available.
.SH SEE ALSO
.BR lsh-writekey (1),
.BR lsh-make-seed (1),
.BR lsh (1),
.BR lshd (8),
.BR DSA (5),
.BR SPKI (5).
.BR
The programs are documented fully by
.IR "Lsh" ,
available via the Info system.
.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).

Rev 2	Rev 17
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 lsh (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).

Subversion Repositories

(root)/trunk/debian/mans/lsh-keygen.1 - Rev 2 → 17