|
|
@@ -1,8 +1,7 @@
|
|
|
-.\" Automatically generated by Pod::Man version 1.15
|
|
|
-.\" Tue May 7 19:43:46 2002
|
|
|
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.13
|
|
|
.\"
|
|
|
.\" Standard preamble:
|
|
|
-.\" ======================================================================
|
|
|
+.\" ========================================================================
|
|
|
.de Sh \" Subsection heading
|
|
|
.br
|
|
|
.if t .Sp
|
|
|
@@ -15,12 +14,6 @@
|
|
|
.if t .sp .5v
|
|
|
.if n .sp
|
|
|
..
|
|
|
-.de Ip \" List item
|
|
|
-.br
|
|
|
-.ie \\n(.$>=3 .ne \\$3
|
|
|
-.el .ne 3
|
|
|
-.IP "\\$1" \\$2
|
|
|
-..
|
|
|
.de Vb \" Begin verbatim text
|
|
|
.ft CW
|
|
|
.nf
|
|
|
@@ -28,15 +21,14 @@
|
|
|
..
|
|
|
.de Ve \" End verbatim text
|
|
|
.ft R
|
|
|
-
|
|
|
.fi
|
|
|
..
|
|
|
.\" Set up some character translations and predefined strings. \*(-- will
|
|
|
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
|
|
.\" double quote, and \*(R" will give a right double quote. | will give a
|
|
|
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
|
|
-.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
|
|
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
|
|
+.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
|
|
|
+.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
|
|
|
+.\" expand to `' in nroff, nothing in troff, for use with C<>.
|
|
|
.tr \(*W-|\(bv\*(Tr
|
|
|
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
|
|
.ie n \{\
|
|
|
@@ -56,10 +48,10 @@
|
|
|
. ds R" ''
|
|
|
'br\}
|
|
|
.\"
|
|
|
-.\" If the F register is turned on, we'll generate index entries on stderr
|
|
|
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
|
|
-.\" index entries marked with X<> in POD. Of course, you'll have to process
|
|
|
-.\" the output yourself in some meaningful fashion.
|
|
|
+.\" If the F register is turned on, we'll generate index entries on stderr for
|
|
|
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
|
|
|
+.\" entries marked with X<> in POD. Of course, you'll have to process the
|
|
|
+.\" output yourself in some meaningful fashion.
|
|
|
.if \nF \{\
|
|
|
. de IX
|
|
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
|
|
@@ -68,14 +60,13 @@
|
|
|
. rr F
|
|
|
.\}
|
|
|
.\"
|
|
|
-.\" For nroff, turn off justification. Always turn off hyphenation; it
|
|
|
-.\" makes way too many mistakes in technical documents.
|
|
|
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
|
|
+.\" way too many mistakes in technical documents.
|
|
|
.hy 0
|
|
|
.if n .na
|
|
|
.\"
|
|
|
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
|
|
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
|
|
-.bd B 3
|
|
|
. \" fudge factors for nroff and troff
|
|
|
.if n \{\
|
|
|
. ds #H 0
|
|
|
@@ -135,13 +126,12 @@
|
|
|
. ds Ae AE
|
|
|
.\}
|
|
|
.rm #[ #] #H #V #F C
|
|
|
-.\" ======================================================================
|
|
|
+.\" ========================================================================
|
|
|
.\"
|
|
|
.IX Title "SSH-KEYMAN 1"
|
|
|
-.TH SSH-KEYMAN 1 "perl v5.6.1" "2002-05-07" "User Contributed Perl Documentation"
|
|
|
-.UC
|
|
|
+.TH SSH-KEYMAN 1 "2004-01-01" "perl v5.8.2" "User Contributed Perl Documentation"
|
|
|
.SH "NAME"
|
|
|
-\&\fBssh-keyman\fR \- authentication key agent management
|
|
|
+\&\fBssh\-keyman\fR \- authentication key agent management
|
|
|
.SH "SYNOPSIS"
|
|
|
.IX Header "SYNOPSIS"
|
|
|
\&\fBssh-keyman\fR
|
|
|
@@ -153,6 +143,7 @@
|
|
|
[\fB\-d\fR]
|
|
|
[\fB\-a\fR]
|
|
|
[\fB\-l\fR]
|
|
|
+[\fB\-i\fR]
|
|
|
[\fIkeyfile\fR ...]
|
|
|
.PP
|
|
|
\&\fBssh-keyman\fR
|
|
|
@@ -169,61 +160,63 @@ often than really necessary from a security point of view.
|
|
|
.PP
|
|
|
The command line options can be combined and are executed internally in
|
|
|
the given order below.
|
|
|
-.Ip "\fB\-q\fR, \fB\*(--quiet\fR" 4
|
|
|
-.IX Item "-q, quiet"
|
|
|
+.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
|
|
|
+.IX Item "-q, --quiet"
|
|
|
Quiet operation. Do not print verbose messages.
|
|
|
-.Ip "\fB\-c\fR, \fB\*(--cluster\fR" 4
|
|
|
-.IX Item "-c, cluster"
|
|
|
+.IP "\fB\-c\fR, \fB\-\-cluster\fR" 4
|
|
|
+.IX Item "-c, --cluster"
|
|
|
Cluster indicator. This forces the use of
|
|
|
-\&\fB$HOME/.ssh/agent-\fR\fIhostname\fR as the agent attachment informations
|
|
|
+\&\fB$HOME/.ssh/agent\-\fR\fIhostname\fR as the agent attachment informations
|
|
|
file instead of the default \fB$HOME/.ssh/agent\fR. Use this if your home
|
|
|
directory is NFS-mounted on a cluster of desktops.
|
|
|
-.Ip "\fB\-k\fR, \fB\*(--kill\fR" 4
|
|
|
-.IX Item "-k, kill"
|
|
|
+.IP "\fB\-k\fR, \fB\-\-kill\fR" 4
|
|
|
+.IX Item "-k, --kill"
|
|
|
Kill agent. This makes sure the \fBssh-agent\fR process
|
|
|
is no longer running.
|
|
|
-.Ip "\fB\-s\fR, \fB\*(--start\fR" 4
|
|
|
-.IX Item "-s, start"
|
|
|
+.IP "\fB\-s\fR, \fB\-\-start\fR" 4
|
|
|
+.IX Item "-s, --start"
|
|
|
Start agent. This makes sure the \fBssh-agent\fR process is
|
|
|
running. If not, it automatically spawns a new one.
|
|
|
-.Ip "\fB\-e\fR, \fB\*(--env\fR" 4
|
|
|
-.IX Item "-e, env"
|
|
|
+.IP "\fB\-e\fR, \fB\-\-env\fR" 4
|
|
|
+.IX Item "-e, --env"
|
|
|
Environment setup. This outputs to \fIstdout\fR the Bourne-Shell commands
|
|
|
necessary to attach the current shell session to the \fBssh-agent\fR
|
|
|
process. The intended usage is "\f(CW\*(C`eval `\f(CBssh-keyman\f(CW \-q \-e \-s`\*(C'\fR" from
|
|
|
within \fB$HOME/.xsession\fR or \fB$HOME/.bash_login\fR scripts.
|
|
|
-.Ip "\fB\-d\fR, \fB\*(--delete\fR" 4
|
|
|
-.IX Item "-d, delete"
|
|
|
+.IP "\fB\-d\fR, \fB\-\-delete\fR" 4
|
|
|
+.IX Item "-d, --delete"
|
|
|
Delete key. This deletes one or more (or all if not \fIkeyfile\fR arguments
|
|
|
are specified at all) from the \fBssh-agent\fR process.
|
|
|
-.Ip "\fB\-a\fR, \fB\*(--add\fR" 4
|
|
|
-.IX Item "-a, add"
|
|
|
+.IP "\fB\-a\fR, \fB\-\-add\fR" 4
|
|
|
+.IX Item "-a, --add"
|
|
|
Add key. This adds one or more keys (in \fIkeyfile\fR) to the \fBssh-agent\fR
|
|
|
process. If a key is already loaded, it is skipped and not reloaded.
|
|
|
Additionally, all specified keys are loaded with a single \fBssh-add\fR
|
|
|
call. This way the pass-phrase dialog is reduced to its possible
|
|
|
minimum.
|
|
|
-.Ip "\fB\-l\fR, \fB\*(--list\fR" 4
|
|
|
-.IX Item "-l, list"
|
|
|
+.IP "\fB\-l\fR, \fB\-\-list\fR" 4
|
|
|
+.IX Item "-l, --list"
|
|
|
List keys. This lists the currently available keys in the \fBssh-agent\fR
|
|
|
process.
|
|
|
-.Ip "\fB\-h\fR, \fB\*(--help\fR" 4
|
|
|
-.IX Item "-h, help"
|
|
|
+.IP "\fB\-i\fR, \fB\-\-install\fR" 4
|
|
|
+.IX Item "-i, --install"
|
|
|
+Install public keys into remote account. This extracts the currently available public keys in the \fBssh-agent\fR
|
|
|
+process and installs them into "\f(CW\*(C`~/.ssh/authorized_keys\*(C'\fR" on a specified remote account.
|
|
|
+.IP "\fB\-h\fR, \fB\-\-help\fR" 4
|
|
|
+.IX Item "-h, --help"
|
|
|
Help information. Display a usage summary on \fIstdout\fR.
|
|
|
-.Ip "\fB\-v\fR, \fB\*(--version\fR" 4
|
|
|
-.IX Item "-v, version"
|
|
|
+.IP "\fB\-v\fR, \fB\-\-version\fR" 4
|
|
|
+.IX Item "-v, --version"
|
|
|
Version information. Display a version summary on \fIstdout\fR.
|
|
|
.SH "EXAMPLE"
|
|
|
.IX Header "EXAMPLE"
|
|
|
\&\fI.xsession\fR:
|
|
|
.PP
|
|
|
-.Vb 5
|
|
|
+.Vb 2
|
|
|
\& eval `ssh-keyman -q -s -e`
|
|
|
-\& ssh-keyman -q -a </dev/null \e
|
|
|
-\& ~/.ssh/id_rsa_1 \e
|
|
|
-\& ~/.ssh/id_rsa_2 \e
|
|
|
-\& ~/.ssh/id_rsa_3
|
|
|
+\& ssh-keyman -q -a </dev/null ~/.ssh/id_rsa ~/.ssh/id_dsa
|
|
|
.Ve
|
|
|
+.PP
|
|
|
\&\fI.bash_login\fR:
|
|
|
.PP
|
|
|
.Vb 1
|
|
|
@@ -231,17 +224,17 @@ Version information. Display a version summary on \fIstdout\fR.
|
|
|
.Ve
|
|
|
.SH "FILES"
|
|
|
.IX Header "FILES"
|
|
|
-.Ip "\fB$HOME/.ssh/agent\fR" 4
|
|
|
+.IP "\fB$HOME/.ssh/agent\fR" 4
|
|
|
.IX Item "$HOME/.ssh/agent"
|
|
|
The generated shell script for attaching the current shell
|
|
|
-session (and all of its sub-processes) to the \fBssh-agent\fR process.
|
|
|
+session (and all of its sub\-processes) to the \fBssh-agent\fR process.
|
|
|
At any time this can be directly sourced from within the shell session
|
|
|
or indirectly through the \fBssh-keyman\fR \fB\-e\fR option.
|
|
|
This file is used if the cluster option \fB\-c\fR is not used.
|
|
|
-.Ip "\fB$HOME/.ssh/agent-\fR\fIhostname\fR" 4
|
|
|
+.IP "\fB$HOME/.ssh/agent\-\fR\fIhostname\fR" 4
|
|
|
.IX Item "$HOME/.ssh/agent-hostname"
|
|
|
The generated shell script for attaching the current shell
|
|
|
-session (and all of its sub-processes) to the \fBssh-agent\fR process.
|
|
|
+session (and all of its sub\-processes) to the \fBssh-agent\fR process.
|
|
|
At any time this can be directly sourced from within the shell session
|
|
|
or indirectly through the \fBssh-keyman\fR \fB\-e\fR option.
|
|
|
This file is used if the cluster option \fB\-c\fR is used.
|
