Subversion Repositories

.\"                                      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-WRITEKEY 1 "Aug 21 2002" lsh-writekey "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-writekey \- store a public / private key pair.
.SH SYNOPSIS
.B lsh-writekey
.RI [ options ]
.SH DESCRIPTION
This manual page documents briefly the
.B lsh-writekey
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-writekey\fP is a program that reads a public / private key pair in
\fBSPKI(5)\fP format on stdin, separates the public and private sections of
the key and writes them to separate files.
.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 \-c, \-\-crypto=\fIalgorithm\fP
Encryption algorithm to use on the private key file.
.TP
.B \-i, \-\-iteration\-count=\fIPKCS#5\fP
Iteration count, the default is 1500.
.TP
.B \-l, \-\-label=\fItext\fP
Sets the unencrypted label for the key.
.TP
.B \-o, \-\-output\-file=\fIfilename\fP
The file to write the private key to. The public key file has a ".pub"
appended to the end of it. The default output file is "~/.lsh/identity".
.TP
.B \-f, \-\-output\-format=\fIformat\fP
Specifies the variant of the S-expression syntax to generate. Valid formats are
"transport", "canonical", "advanced" and "international".
.TP
.B \-p, \-\-passphrase=\fIpassword\fP
Specifies a passphrase for the private key.
.TP
.B \-\-server
Use the server seed file, and change the default output file to
/etc/lsh_host_key.
.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 ENVIRONMENT
.TP
HOME
The user's home directory.
.SH FILES
.TP
~/.lsh/identity
Default location where the private key is stored.
~/.lsh/identity.pub
Default location where the public key is stored.
/etc/lsh_host_key, /etc/lsh_host_key.pub
The server's private and public host keys.
.SH EXAMPLE
A typical usage of lsh-writekey is:

lsh-keygen -l 8 | lsh-writekey

which generates a public / private key pair using \fBlsh-keygen(1)\fP and
stores it to the default ~/.lsh/identity.
.SH SEE ALSO
.BR lsh-keygen (1),
.BR lsh-make-seed (1),
.BR lshc (1),
.BR lshd (8),
.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).