version 1.24.2.2, 2002/03/09 00:20:45 |
version 1.25, 2001/05/05 13:42:52 |
|
|
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm ssh-add |
.Nm ssh-add |
.Nd adds RSA or DSA identities to the authentication agent |
.Nd adds RSA or DSA identities for the authentication agent |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm ssh-add |
.Nm ssh-add |
.Op Fl lLdD |
.Op Fl lLdD |
.Op Ar |
.Op Ar |
.Nm ssh-add |
|
.Fl s Ar reader |
|
.Nm ssh-add |
|
.Fl e Ar reader |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
adds RSA or DSA identities to the authentication agent, |
adds RSA or DSA identities to the authentication agent, |
.Xr ssh-agent 1 . |
.Xr ssh-agent 1 . |
When run without arguments, it adds the files |
When run without arguments, it adds the file |
.Pa $HOME/.ssh/id_rsa , |
|
.Pa $HOME/.ssh/id_dsa |
|
and |
|
.Pa $HOME/.ssh/identity . |
.Pa $HOME/.ssh/identity . |
Alternative file names can be given on the command line. |
Alternative file names can be given on the command line. |
If any file requires a passphrase, |
If any file requires a passphrase, |
|
|
Instead of adding the identity, removes the identity from the agent. |
Instead of adding the identity, removes the identity from the agent. |
.It Fl D |
.It Fl D |
Deletes all identities from the agent. |
Deletes all identities from the agent. |
.It Fl s Ar reader |
|
Add key in smartcard |
|
.Ar reader . |
|
.It Fl e Ar reader |
|
Remove key in smartcard |
|
.Ar reader . |
|
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Pa $HOME/.ssh/identity |
.It Pa $HOME/.ssh/identity |
Contains the protocol version 1 RSA authentication identity of the user. |
Contains the protocol version 1 RSA authentication identity of the user. |
|
This file should not be readable by anyone but the user. |
|
Note that |
|
.Nm |
|
ignores this file if it is accessible by others. |
|
It is possible to |
|
specify a passphrase when generating the key; that passphrase will be |
|
used to encrypt the private part of this file. |
|
This is the default file added by |
|
.Nm |
|
when no other files have been specified. |
.It Pa $HOME/.ssh/id_dsa |
.It Pa $HOME/.ssh/id_dsa |
Contains the protocol version 2 DSA authentication identity of the user. |
Contains the protocol version 2 DSA authentication identity of the user. |
.It Pa $HOME/.ssh/id_rsa |
.It Pa $HOME/.ssh/id_rsa |
Contains the protocol version 2 RSA authentication identity of the user. |
Contains the protocol version 2 RSA authentication identity of the user. |
.El |
.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. |
|
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Ev "DISPLAY" and "SSH_ASKPASS" |
.It Ev "DISPLAY" and "SSH_ASKPASS" |
|
|
.Pa /dev/null |
.Pa /dev/null |
to make this work.) |
to make this work.) |
.El |
.El |
.Sh DIAGNOSTICS |
|
Exit status is 0 on success, 1 if the specified command fails, |
|
and 2 if |
|
.Nm |
|
is unable to contact the authentication agent. |
|
.Sh AUTHORS |
.Sh AUTHORS |
OpenSSH is a derivative of the original and free |
OpenSSH is a derivative of the original and free |
ssh 1.2.12 release by Tatu Ylonen. |
ssh 1.2.12 release by Tatu Ylonen. |