version 1, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
---- |
|
|
2 |
__NAME__ |
|
|
3 |
|
|
|
4 |
|
|
|
5 |
ssh-add - adds RSA or DSA identities to the authentication |
|
|
6 |
agent |
|
|
7 |
__SYNOPSIS__ |
|
|
8 |
|
|
|
9 |
|
|
|
10 |
ssh-add [[-lLdD] [[file ...] |
|
|
11 |
|
|
|
12 |
|
|
|
13 |
ssh-add -s reader |
|
|
14 |
|
|
|
15 |
|
|
|
16 |
ssh-add -e reader |
|
|
17 |
__DESCRIPTION__ |
|
|
18 |
|
|
|
19 |
|
|
|
20 |
ssh-add adds RSA or DSA identities to the authentication |
|
|
21 |
agent, ssh-agent(1). When run without arguments, it |
|
|
22 |
adds the file $HOME/.ssh/identity. Alternative file |
|
|
23 |
names can be given on the command line. If any file requires |
|
|
24 |
a passphrase, ssh-add asks for the passphrase from the user. |
|
|
25 |
The passphrase is read from the user's tty. ssh-add retries |
|
|
26 |
the last passphrase if multiple identity files are |
|
|
27 |
given. |
|
|
28 |
|
|
|
29 |
|
|
|
30 |
The authentication agent must be running and must be an ancestor of the current process for ssh-add to work. |
|
|
31 |
|
|
|
32 |
|
|
|
33 |
The options are as follows: |
|
|
34 |
-l Lists fingerprints of all identities currently repre-sented by the agent. |
|
|
35 |
|
|
|
36 |
|
|
|
37 |
-LLists public key parameters of all identities cur-rently represented by the agent.-dInstead of adding the identity, removes the identityfrom the agent.-DDeletes all identities from the agent.-s readerAdd key in smartcard reader.-e readerRemove key in smartcard reader.__FILES__ |
|
|
38 |
$HOME/.ssh/identity |
|
|
39 |
|
|
|
40 |
|
|
|
41 |
Contains the protocol version 1 RSA authentication identity |
|
|
42 |
of the user. This file should not be read- able by anyone |
|
|
43 |
but the user. Note that ssh-add ignores this file if it is |
|
|
44 |
accessible by others. It is possible to specify a passphrase |
|
|
45 |
when generating the key; that passphrase will be used to |
|
|
46 |
encrypt the private part of this file. This is the default |
|
|
47 |
file added by ssh-add when no other files have been speci- |
|
|
48 |
fied. |
|
|
49 |
|
|
|
50 |
|
|
|
51 |
$HOME/.ssh/id_dsa |
|
|
52 |
Contains the protocol version 2 DSA authentication identity |
|
|
53 |
of the user. |
|
|
54 |
|
|
|
55 |
|
|
|
56 |
$HOME/.ssh/id_rsa |
|
|
57 |
Contains the protocol version 2 RSA authentication identity |
|
|
58 |
of the user. |
|
|
59 |
|
|
|
60 |
|
|
|
61 |
__ENVIRONMENT__ |
|
|
62 |
DISPLAY and SSH_ASKPASS |
|
|
63 |
|
|
|
64 |
|
|
|
65 |
If ssh-add needs a passphrase, it will read the passphrase |
|
|
66 |
from the current terminal if it was run from a terminal. If |
|
|
67 |
ssh-add does not have a terminal associated with it but |
|
|
68 |
DISPLAY and SSH_ASKPASS are set, it will |
|
|
69 |
execute the program specified by SSH_ASKPASS and |
|
|
70 |
open an X11 window to read the passphrase. This is |
|
|
71 |
particularly useful when calling ssh-add from a |
|
|
72 |
.Xsession or related script. (Note that on some |
|
|
73 |
machines it may be necessary to redirect the input from |
|
|
74 |
/dev/null to make this work.) |
|
|
75 |
|
|
|
76 |
|
|
|
77 |
__AUTHORS__ |
|
|
78 |
|
|
|
79 |
|
|
|
80 |
OpenSSH is a derivative of the original and free ssh 1.2.12 |
|
|
81 |
release by Tatu Ylonen. Aaron Campbell, Bob Beck, Markus |
|
|
82 |
Friedl, Niels Provos, Theo de Raadt and Dug Song removed |
|
|
83 |
many bugs, re-added newer features and created OpenSSH. |
|
|
84 |
Markus Friedl contributed the support for SSH protocol ver- |
|
|
85 |
sions 1.5 and 2.0. |
|
|
86 |
__SEE ALSO__ |
|
|
87 |
|
|
|
88 |
|
|
|
89 |
ssh(1), ssh-agent(1), |
|
|
90 |
ssh-keygen(1), sshd(8) |
|
|
91 |
|
|
|
92 |
|
|
|
93 |
BSD September 25, 1999 1 |
|
|
94 |
---- |