diff options
Diffstat (limited to 'ssh-add.0')
-rw-r--r-- | ssh-add.0 | 38 |
1 files changed, 20 insertions, 18 deletions
@@ -11,31 +11,33 @@ SYNOPSIS | |||
11 | DESCRIPTION | 11 | DESCRIPTION |
12 | ssh-add adds RSA or DSA identities to the authentication agent, | 12 | ssh-add adds RSA or DSA identities to the authentication agent, |
13 | ssh-agent(1). When run without arguments, it adds the files | 13 | ssh-agent(1). When run without arguments, it adds the files |
14 | ~/.ssh/id_rsa, ~/.ssh/id_dsa and ~/.ssh/identity. After loading a pri- | 14 | ~/.ssh/id_rsa, ~/.ssh/id_dsa and ~/.ssh/identity. After loading a |
15 | vate key, ssh-add will try to load corresponding certificate information | 15 | private key, ssh-add will try to load corresponding certificate |
16 | from the filename obtained by appending -cert.pub to the name of the pri- | 16 | information from the filename obtained by appending -cert.pub to the name |
17 | vate key file. Alternative file names can be given on the command line. | 17 | of the private key file. Alternative file names can be given on the |
18 | command line. | ||
18 | 19 | ||
19 | If any file requires a passphrase, ssh-add asks for the passphrase from | 20 | If any file requires a passphrase, ssh-add asks for the passphrase from |
20 | the user. The passphrase is read from the user's tty. ssh-add retries | 21 | the user. The passphrase is read from the user's tty. ssh-add retries |
21 | the last passphrase if multiple identity files are given. | 22 | the last passphrase if multiple identity files are given. |
22 | 23 | ||
23 | The authentication agent must be running and the SSH_AUTH_SOCK environ- | 24 | The authentication agent must be running and the SSH_AUTH_SOCK |
24 | ment variable must contain the name of its socket for ssh-add to work. | 25 | environment variable must contain the name of its socket for ssh-add to |
26 | work. | ||
25 | 27 | ||
26 | The options are as follows: | 28 | The options are as follows: |
27 | 29 | ||
28 | -c Indicates that added identities should be subject to confirmation | 30 | -c Indicates that added identities should be subject to confirmation |
29 | before being used for authentication. Confirmation is performed | 31 | before being used for authentication. Confirmation is performed |
30 | by the SSH_ASKPASS program mentioned below. Successful confirma- | 32 | by the SSH_ASKPASS program mentioned below. Successful |
31 | tion is signaled by a zero exit status from the SSH_ASKPASS pro- | 33 | confirmation is signaled by a zero exit status from the |
32 | gram, rather than text entered into the requester. | 34 | SSH_ASKPASS program, rather than text entered into the requester. |
33 | 35 | ||
34 | -D Deletes all identities from the agent. | 36 | -D Deletes all identities from the agent. |
35 | 37 | ||
36 | -d Instead of adding identities, removes identities from the agent. | 38 | -d Instead of adding identities, removes identities from the agent. |
37 | If ssh-add has been run without arguments, the keys for the de- | 39 | If ssh-add has been run without arguments, the keys for the |
38 | fault identities will be removed. Otherwise, the argument list | 40 | default identities will be removed. Otherwise, the argument list |
39 | will be interpreted as a list of paths to public key files and | 41 | will be interpreted as a list of paths to public key files and |
40 | matching keys will be removed from the agent. If no public key | 42 | matching keys will be removed from the agent. If no public key |
41 | is found at a given path, ssh-add will append .pub and retry. | 43 | is found at a given path, ssh-add will append .pub and retry. |
@@ -43,8 +45,8 @@ DESCRIPTION | |||
43 | -e pkcs11 | 45 | -e pkcs11 |
44 | Remove keys provided by the PKCS#11 shared library pkcs11. | 46 | Remove keys provided by the PKCS#11 shared library pkcs11. |
45 | 47 | ||
46 | -L Lists public key parameters of all identities currently repre- | 48 | -L Lists public key parameters of all identities currently |
47 | sented by the agent. | 49 | represented by the agent. |
48 | 50 | ||
49 | -l Lists fingerprints of all identities currently represented by the | 51 | -l Lists fingerprints of all identities currently represented by the |
50 | agent. | 52 | agent. |
@@ -54,8 +56,8 @@ DESCRIPTION | |||
54 | 56 | ||
55 | -t life | 57 | -t life |
56 | Set a maximum lifetime when adding identities to an agent. The | 58 | Set a maximum lifetime when adding identities to an agent. The |
57 | lifetime may be specified in seconds or in a time format speci- | 59 | lifetime may be specified in seconds or in a time format |
58 | fied in sshd_config(5). | 60 | specified in sshd_config(5). |
59 | 61 | ||
60 | -X Unlock the agent. | 62 | -X Unlock the agent. |
61 | 63 | ||
@@ -102,8 +104,8 @@ SEE ALSO | |||
102 | AUTHORS | 104 | AUTHORS |
103 | OpenSSH is a derivative of the original and free ssh 1.2.12 release by | 105 | OpenSSH is a derivative of the original and free ssh 1.2.12 release by |
104 | Tatu Ylonen. Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos, Theo | 106 | Tatu Ylonen. Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos, Theo |
105 | de Raadt and Dug Song removed many bugs, re-added newer features and cre- | 107 | de Raadt and Dug Song removed many bugs, re-added newer features and |
106 | ated OpenSSH. Markus Friedl contributed the support for SSH protocol | 108 | created OpenSSH. Markus Friedl contributed the support for SSH protocol |
107 | versions 1.5 and 2.0. | 109 | versions 1.5 and 2.0. |
108 | 110 | ||
109 | OpenBSD 4.7 March 5, 2010 2 | 111 | OpenBSD 4.8 March 5, 2010 OpenBSD 4.8 |