blob: f4c97cef9d47bb200411e0734f979b76fd8370ab [file] [log] [blame]
Ben Lindstrombe80af72001-02-10 23:06:02 +00001.\" $OpenBSD: ssh-add.1,v 1.21 2001/02/08 19:22:38 itojun Exp $
Ben Lindstrom36579d32001-01-29 07:39:26 +00002.\"
Damien Miller32aa1441999-10-29 09:15:49 +10003.\" -*- nroff -*-
4.\"
Damien Miller32aa1441999-10-29 09:15:49 +10005.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
Damien Miller32aa1441999-10-29 09:15:49 +10006.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
7.\" All rights reserved
8.\"
Damien Millere4340be2000-09-16 13:29:08 +11009.\" As far as I am concerned, the code I have written for this software
10.\" can be used freely for any purpose. Any derived versions of this
11.\" software must be clearly marked as such, and if the derived work is
12.\" incompatible with the protocol description in the RFC file, it must be
13.\" called by a name other than "ssh" or "Secure Shell".
Damien Miller32aa1441999-10-29 09:15:49 +100014.\"
Damien Millere4340be2000-09-16 13:29:08 +110015.\"
16.\" Copyright (c) 1999,2000 Markus Friedl. All rights reserved.
17.\" Copyright (c) 1999 Aaron Campbell. All rights reserved.
18.\" Copyright (c) 1999 Theo de Raadt. All rights reserved.
19.\"
20.\" Redistribution and use in source and binary forms, with or without
21.\" modification, are permitted provided that the following conditions
22.\" are met:
23.\" 1. Redistributions of source code must retain the above copyright
24.\" notice, this list of conditions and the following disclaimer.
25.\" 2. Redistributions in binary form must reproduce the above copyright
26.\" notice, this list of conditions and the following disclaimer in the
27.\" documentation and/or other materials provided with the distribution.
28.\"
29.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
30.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
31.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
32.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
33.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
34.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
38.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Damien Miller32aa1441999-10-29 09:15:49 +100039.\"
40.Dd September 25, 1999
41.Dt SSH-ADD 1
42.Os
43.Sh NAME
44.Nm ssh-add
Damien Millerad833b32000-08-23 10:46:23 +100045.Nd adds RSA or DSA identities for the authentication agent
Damien Miller32aa1441999-10-29 09:15:49 +100046.Sh SYNOPSIS
47.Nm ssh-add
Damien Miller10f6f6b1999-11-17 17:29:08 +110048.Op Fl lLdD
Damien Miller32aa1441999-10-29 09:15:49 +100049.Op Ar
Damien Miller22c77262000-04-13 12:26:34 +100050.Sh DESCRIPTION
Damien Miller32aa1441999-10-29 09:15:49 +100051.Nm
Damien Millerad833b32000-08-23 10:46:23 +100052adds RSA or DSA identities to the authentication agent,
Damien Miller32aa1441999-10-29 09:15:49 +100053.Xr ssh-agent 1 .
54When run without arguments, it adds the file
55.Pa $HOME/.ssh/identity .
Damien Miller450a7a12000-03-26 13:04:51 +100056Alternative file names can be given on the command line.
57If any file requires a passphrase,
Damien Miller32aa1441999-10-29 09:15:49 +100058.Nm
Damien Miller22c77262000-04-13 12:26:34 +100059asks for the passphrase from the user.
Damien Miller450a7a12000-03-26 13:04:51 +100060The Passphrase it is read from the user's tty.
Damien Miller32aa1441999-10-29 09:15:49 +100061.Pp
62The authentication agent must be running and must be an ancestor of
63the current process for
64.Nm
65to work.
66.Pp
67The options are as follows:
68.Bl -tag -width Ds
69.It Fl l
Damien Miller10f6f6b1999-11-17 17:29:08 +110070Lists fingerprints of all identities currently represented by the agent.
71.It Fl L
72Lists public key parameters of all identities currently represented by the agent.
Damien Miller32aa1441999-10-29 09:15:49 +100073.It Fl d
74Instead of adding the identity, removes the identity from the agent.
75.It Fl D
76Deletes all identities from the agent.
77.El
78.Sh FILES
79.Bl -tag -width Ds
Damien Milleraae6c611999-12-06 11:47:28 +110080.It Pa $HOME/.ssh/identity
Damien Miller450a7a12000-03-26 13:04:51 +100081Contains the RSA authentication identity of the user.
82This file should not be readable by anyone but the user.
Damien Miller32aa1441999-10-29 09:15:49 +100083Note that
84.Nm
85ignores this file if it is accessible by others.
86It is possible to
87specify a passphrase when generating the key; that passphrase will be
Damien Miller450a7a12000-03-26 13:04:51 +100088used to encrypt the private part of this file.
89This is the default file added by
Damien Miller32aa1441999-10-29 09:15:49 +100090.Nm
91when no other files have been specified.
Damien Millerad833b32000-08-23 10:46:23 +100092.It Pa $HOME/.ssh/id_dsa
93Contains the DSA authentication identity of the user.
Damien Miller7b28dc52000-09-05 13:34:53 +110094.El
Damien Milleraae6c611999-12-06 11:47:28 +110095.Sh ENVIRONMENT
96.Bl -tag -width Ds
97.It Ev "DISPLAY" and "SSH_ASKPASS"
Damien Miller32aa1441999-10-29 09:15:49 +100098If
99.Nm
100needs a passphrase, it will read the passphrase from the current
Damien Miller450a7a12000-03-26 13:04:51 +1000101terminal if it was run from a terminal.
102If
Damien Miller32aa1441999-10-29 09:15:49 +1000103.Nm
104does not have a terminal associated with it but
105.Ev DISPLAY
Damien Miller5428f641999-11-25 11:54:57 +1100106and
107.Ev SSH_ASKPASS
108are set, it will execute the program specified by
109.Ev SSH_ASKPASS
Damien Miller450a7a12000-03-26 13:04:51 +1000110and open an X11 window to read the passphrase.
111This is particularly useful when calling
Damien Miller32aa1441999-10-29 09:15:49 +1000112.Nm
113from a
114.Pa .Xsession
Damien Miller450a7a12000-03-26 13:04:51 +1000115or related script.
116(Note that on some machines it
Damien Miller32aa1441999-10-29 09:15:49 +1000117may be necessary to redirect the input from
118.Pa /dev/null
119to make this work.)
Damien Miller7b28dc52000-09-05 13:34:53 +1100120.El
Damien Miller0bc1bd82000-11-13 22:57:25 +1100121.Sh AUTHORS
Ben Lindstrom035782e2001-01-29 08:34:16 +0000122OpenSSH is a derivative of the original and free
123ssh 1.2.12 release by Tatu Ylonen.
124Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos,
125Theo de Raadt and Dug Song
126removed many bugs, re-added newer features and
127created OpenSSH.
128Markus Friedl contributed the support for SSH
129protocol versions 1.5 and 2.0.
Damien Miller32aa1441999-10-29 09:15:49 +1000130.Sh SEE ALSO
131.Xr ssh 1 ,
132.Xr ssh-agent 1 ,
133.Xr ssh-keygen 1 ,
Ben Lindstrome5b3fb32001-02-10 23:56:35 +0000134.Xr sshd 8