version 1.41, 2004/08/30 21:22:49 |
version 1.41.2.2, 2005/09/02 03:45:00 |
|
|
.Nd adds RSA or DSA identities to the authentication agent |
.Nd adds RSA or DSA identities to the authentication agent |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm ssh-add |
.Nm ssh-add |
.Op Fl lLdDxXc |
.Op Fl cDdLlXx |
.Op Fl t Ar life |
.Op Fl t Ar life |
.Op Ar |
.Op Ar |
.Nm ssh-add |
.Nm ssh-add |
|
|
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 files |
.Pa $HOME/.ssh/id_rsa , |
.Pa ~/.ssh/id_rsa , |
.Pa $HOME/.ssh/id_dsa |
.Pa ~/.ssh/id_dsa |
and |
and |
.Pa $HOME/.ssh/identity . |
.Pa ~/.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, |
.Nm |
.Nm |
|
|
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl l |
|
Lists fingerprints of all identities currently represented by the agent. |
|
.It Fl L |
|
Lists public key parameters of all identities currently represented by the agent. |
|
.It Fl d |
|
Instead of adding the identity, removes the identity from the agent. |
|
.It Fl D |
|
Deletes all identities from the agent. |
|
.It Fl x |
|
Lock the agent with a password. |
|
.It Fl X |
|
Unlock the agent. |
|
.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 c |
.It Fl c |
Indicates that added identities should be subject to confirmation before |
Indicates that added identities should be subject to confirmation before |
being used for authentication. |
being used for authentication. |
|
|
Successful confirmation is signaled by a zero exit status from the |
Successful confirmation is signaled by a zero exit status from the |
.Ev SSH_ASKPASS |
.Ev SSH_ASKPASS |
program, rather than text entered into the requester. |
program, rather than text entered into the requester. |
.It Fl s Ar reader |
.It Fl D |
Add key in smartcard |
Deletes all identities from the agent. |
.Ar reader . |
.It Fl d |
|
Instead of adding the identity, removes the identity from the agent. |
.It Fl e Ar reader |
.It Fl e Ar reader |
Remove key in smartcard |
Remove key in smartcard |
.Ar reader . |
.Ar reader . |
|
.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. |
|
.It Fl s Ar reader |
|
Add key in smartcard |
|
.Ar reader . |
|
.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. |
.El |
.El |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
|
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Pa $HOME/.ssh/identity |
.It Pa ~/.ssh/identity |
Contains the protocol version 1 RSA authentication identity of the user. |
Contains the protocol version 1 RSA authentication identity of the user. |
.It Pa $HOME/.ssh/id_dsa |
.It Pa ~/.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 ~/.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 |
.Pp |