2013-03-22 11:19:48 +00:00
|
|
|
.\" $OpenBSD: ssh-add.1,v 1.58 2012/12/03 08:33:02 jmc Exp $
|
2000-02-24 14:29:47 +00:00
|
|
|
.\"
|
|
|
|
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
|
|
|
|
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
|
|
|
|
.\" All rights reserved
|
|
|
|
.\"
|
2000-09-10 08:31:17 +00:00
|
|
|
.\" As far as I am concerned, the code I have written for this software
|
|
|
|
.\" can be used freely for any purpose. Any derived versions of this
|
|
|
|
.\" software must be clearly marked as such, and if the derived work is
|
|
|
|
.\" incompatible with the protocol description in the RFC file, it must be
|
|
|
|
.\" called by a name other than "ssh" or "Secure Shell".
|
|
|
|
.\"
|
|
|
|
.\"
|
2001-05-04 03:57:05 +00:00
|
|
|
.\" Copyright (c) 1999,2000 Markus Friedl. All rights reserved.
|
|
|
|
.\" Copyright (c) 1999 Aaron Campbell. All rights reserved.
|
|
|
|
.\" Copyright (c) 1999 Theo de Raadt. All rights reserved.
|
2000-09-10 08:31:17 +00:00
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
2000-02-24 14:29:47 +00:00
|
|
|
.\"
|
2000-09-10 08:31:17 +00:00
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
2000-02-24 14:29:47 +00:00
|
|
|
.\"
|
2013-03-22 11:19:48 +00:00
|
|
|
.Dd $Mdocdate: December 3 2012 $
|
2000-02-24 14:29:47 +00:00
|
|
|
.Dt SSH-ADD 1
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm ssh-add
|
2011-02-17 11:47:40 +00:00
|
|
|
.Nd adds private key identities to the authentication agent
|
2000-02-24 14:29:47 +00:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm ssh-add
|
2012-08-29 15:46:01 +00:00
|
|
|
.Op Fl cDdkLlXx
|
2002-06-23 14:01:54 +00:00
|
|
|
.Op Fl t Ar life
|
2000-02-24 14:29:47 +00:00
|
|
|
.Op Ar
|
2002-03-18 09:55:03 +00:00
|
|
|
.Nm ssh-add
|
2010-03-08 11:19:52 +00:00
|
|
|
.Fl s Ar pkcs11
|
2002-03-18 09:55:03 +00:00
|
|
|
.Nm ssh-add
|
2010-03-08 11:19:52 +00:00
|
|
|
.Fl e Ar pkcs11
|
2000-05-15 04:37:24 +00:00
|
|
|
.Sh DESCRIPTION
|
2000-02-24 14:29:47 +00:00
|
|
|
.Nm
|
2011-02-17 11:47:40 +00:00
|
|
|
adds private key identities to the authentication agent,
|
2000-02-24 14:29:47 +00:00
|
|
|
.Xr ssh-agent 1 .
|
2002-03-18 09:55:03 +00:00
|
|
|
When run without arguments, it adds the files
|
2005-09-03 06:59:33 +00:00
|
|
|
.Pa ~/.ssh/id_rsa ,
|
2011-02-17 11:47:40 +00:00
|
|
|
.Pa ~/.ssh/id_dsa ,
|
|
|
|
.Pa ~/.ssh/id_ecdsa
|
2002-03-18 09:55:03 +00:00
|
|
|
and
|
2005-09-03 06:59:33 +00:00
|
|
|
.Pa ~/.ssh/identity .
|
2010-03-08 11:19:52 +00:00
|
|
|
After loading a private key,
|
|
|
|
.Nm
|
|
|
|
will try to load corresponding certificate information from the
|
|
|
|
filename obtained by appending
|
|
|
|
.Pa -cert.pub
|
|
|
|
to the name of the private key file.
|
2000-03-26 07:07:24 +00:00
|
|
|
Alternative file names can be given on the command line.
|
2010-03-08 11:19:52 +00:00
|
|
|
.Pp
|
2000-03-26 07:07:24 +00:00
|
|
|
If any file requires a passphrase,
|
2000-02-24 14:29:47 +00:00
|
|
|
.Nm
|
2000-05-15 04:37:24 +00:00
|
|
|
asks for the passphrase from the user.
|
2002-03-18 09:55:03 +00:00
|
|
|
The passphrase is read from the user's tty.
|
2001-05-04 03:57:05 +00:00
|
|
|
.Nm
|
|
|
|
retries the last passphrase if multiple identity files are given.
|
2000-02-24 14:29:47 +00:00
|
|
|
.Pp
|
2004-02-26 10:38:49 +00:00
|
|
|
The authentication agent must be running and the
|
|
|
|
.Ev SSH_AUTH_SOCK
|
|
|
|
environment variable must contain the name of its socket for
|
2000-02-24 14:29:47 +00:00
|
|
|
.Nm
|
|
|
|
to work.
|
|
|
|
.Pp
|
|
|
|
The options are as follows:
|
|
|
|
.Bl -tag -width Ds
|
2003-04-23 16:53:02 +00:00
|
|
|
.It Fl c
|
|
|
|
Indicates that added identities should be subject to confirmation before
|
|
|
|
being used for authentication.
|
|
|
|
Confirmation is performed by the
|
|
|
|
.Ev SSH_ASKPASS
|
|
|
|
program mentioned below.
|
|
|
|
Successful confirmation is signaled by a zero exit status from the
|
|
|
|
.Ev SSH_ASKPASS
|
|
|
|
program, rather than text entered into the requester.
|
2005-06-05 15:40:50 +00:00
|
|
|
.It Fl D
|
|
|
|
Deletes all identities from the agent.
|
|
|
|
.It Fl d
|
2008-07-23 09:23:42 +00:00
|
|
|
Instead of adding identities, removes identities from the agent.
|
|
|
|
If
|
|
|
|
.Nm
|
2013-03-22 11:19:48 +00:00
|
|
|
has been run without arguments, the keys for the default identities and
|
|
|
|
their corresponding certificates will be removed.
|
2008-07-23 09:23:42 +00:00
|
|
|
Otherwise, the argument list will be interpreted as a list of paths to
|
2013-03-22 11:19:48 +00:00
|
|
|
public key files to specify keys and certificates to be removed from the agent.
|
2008-07-23 09:23:42 +00:00
|
|
|
If no public key is found at a given path,
|
|
|
|
.Nm
|
|
|
|
will append
|
|
|
|
.Pa .pub
|
|
|
|
and retry.
|
2010-03-08 11:19:52 +00:00
|
|
|
.It Fl e Ar pkcs11
|
|
|
|
Remove keys provided by the PKCS#11 shared library
|
|
|
|
.Ar pkcs11 .
|
2012-08-29 15:46:01 +00:00
|
|
|
.It Fl k
|
2013-03-22 11:19:48 +00:00
|
|
|
When loading keys into or deleting keys from the agent, process plain private
|
|
|
|
keys only and skip certificates.
|
2005-06-05 15:40:50 +00:00
|
|
|
.It Fl L
|
|
|
|
Lists public key parameters of all identities currently represented
|
|
|
|
by the agent.
|
|
|
|
.It Fl l
|
|
|
|
Lists fingerprints of all identities currently represented by the agent.
|
2010-03-08 11:19:52 +00:00
|
|
|
.It Fl s Ar pkcs11
|
|
|
|
Add keys provided by the PKCS#11 shared library
|
|
|
|
.Ar pkcs11 .
|
2005-06-05 15:40:50 +00:00
|
|
|
.It Fl t Ar life
|
|
|
|
Set a maximum lifetime when adding identities to an agent.
|
|
|
|
The lifetime may be specified in seconds or in a time format
|
|
|
|
specified in
|
|
|
|
.Xr sshd_config 5 .
|
|
|
|
.It Fl X
|
|
|
|
Unlock the agent.
|
|
|
|
.It Fl x
|
|
|
|
Lock the agent with a password.
|
2000-02-24 14:29:47 +00:00
|
|
|
.El
|
|
|
|
.Sh ENVIRONMENT
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
.It Ev "DISPLAY" and "SSH_ASKPASS"
|
|
|
|
If
|
|
|
|
.Nm
|
|
|
|
needs a passphrase, it will read the passphrase from the current
|
2000-03-26 07:07:24 +00:00
|
|
|
terminal if it was run from a terminal.
|
|
|
|
If
|
2000-02-24 14:29:47 +00:00
|
|
|
.Nm
|
|
|
|
does not have a terminal associated with it but
|
|
|
|
.Ev DISPLAY
|
|
|
|
and
|
|
|
|
.Ev SSH_ASKPASS
|
|
|
|
are set, it will execute the program specified by
|
|
|
|
.Ev SSH_ASKPASS
|
2000-03-26 07:07:24 +00:00
|
|
|
and open an X11 window to read the passphrase.
|
|
|
|
This is particularly useful when calling
|
2000-02-24 14:29:47 +00:00
|
|
|
.Nm
|
|
|
|
from a
|
2005-06-05 15:40:50 +00:00
|
|
|
.Pa .xsession
|
2000-03-26 07:07:24 +00:00
|
|
|
or related script.
|
|
|
|
(Note that on some machines it
|
2000-02-24 14:29:47 +00:00
|
|
|
may be necessary to redirect the input from
|
|
|
|
.Pa /dev/null
|
|
|
|
to make this work.)
|
2002-06-23 14:01:54 +00:00
|
|
|
.It Ev SSH_AUTH_SOCK
|
2010-03-08 11:19:52 +00:00
|
|
|
Identifies the path of a
|
|
|
|
.Ux Ns -domain
|
|
|
|
socket used to communicate with the agent.
|
2000-09-10 08:31:17 +00:00
|
|
|
.El
|
2004-01-07 11:10:17 +00:00
|
|
|
.Sh FILES
|
|
|
|
.Bl -tag -width Ds
|
2005-09-03 06:59:33 +00:00
|
|
|
.It Pa ~/.ssh/identity
|
2004-01-07 11:10:17 +00:00
|
|
|
Contains the protocol version 1 RSA authentication identity of the user.
|
2005-09-03 06:59:33 +00:00
|
|
|
.It Pa ~/.ssh/id_dsa
|
2004-01-07 11:10:17 +00:00
|
|
|
Contains the protocol version 2 DSA authentication identity of the user.
|
2011-02-17 11:47:40 +00:00
|
|
|
.It Pa ~/.ssh/id_ecdsa
|
|
|
|
Contains the protocol version 2 ECDSA authentication identity of the user.
|
2005-09-03 06:59:33 +00:00
|
|
|
.It Pa ~/.ssh/id_rsa
|
2004-01-07 11:10:17 +00:00
|
|
|
Contains the protocol version 2 RSA authentication identity of the user.
|
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
Identity files should not be readable by anyone but the user.
|
|
|
|
Note that
|
|
|
|
.Nm
|
|
|
|
ignores identity files if they are accessible by others.
|
2011-02-17 11:47:40 +00:00
|
|
|
.Sh EXIT STATUS
|
2002-03-18 09:55:03 +00:00
|
|
|
Exit status is 0 on success, 1 if the specified command fails,
|
|
|
|
and 2 if
|
|
|
|
.Nm
|
|
|
|
is unable to contact the authentication agent.
|
2004-01-07 11:10:17 +00:00
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr ssh 1 ,
|
|
|
|
.Xr ssh-agent 1 ,
|
|
|
|
.Xr ssh-keygen 1 ,
|
|
|
|
.Xr sshd 8
|
2001-05-04 03:57:05 +00:00
|
|
|
.Sh AUTHORS
|
|
|
|
OpenSSH is a derivative of the original and free
|
|
|
|
ssh 1.2.12 release by Tatu Ylonen.
|
|
|
|
Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos,
|
|
|
|
Theo de Raadt and Dug Song
|
|
|
|
removed many bugs, re-added newer features and
|
|
|
|
created OpenSSH.
|
|
|
|
Markus Friedl contributed the support for SSH
|
|
|
|
protocol versions 1.5 and 2.0.
|