version 1.40, 2003/11/25 23:10:08 |
version 1.40.2.1, 2005/03/10 17:15:04 |
|
|
.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 |
|
|
.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 |
|
|
This is particularly useful when calling |
This is particularly useful when calling |
.Nm |
.Nm |
from a |
from a |
.Pa .Xsession |
.Pa .xsession |
or related script. |
or related script. |
(Note that on some machines it |
(Note that on some machines it |
may be necessary to redirect the input from |
may be necessary to redirect the input from |