SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Trustix openssh-clients-3.6.1p2-5tr.i586.rpm

SSH-ADD

Section: User Commands (1)
Index
BSD mandoc
 

NAME

ssh-add - adds RSA or DSA identities to the authentication agent 

SYNOPSIS

ssh-add[-lLdDx][-t life][file ...]
ssh-add-s reader
ssh-add-e reader 

DESCRIPTION

ssh-addadds RSA or DSA identities to the authentication agent,ssh-agent1.When run without arguments, it adds the files$HOME/.ssh/id_rsa $HOME/.ssh/id_dsaand$HOME/.ssh/identity Alternative file names can be given on the command line.If any file requires a passphrase,ssh-addasks for the passphrase from the user.The passphrase is read from the user's tty.ssh-addretries the last passphrase if multiple identity files are given.

The authentication agent must be running and must be an ancestor ofthe current process forssh-addto work.

The options are as follows:

-l
Lists fingerprints of all identities currently represented by the agent.
-L
Lists public key parameters of all identities currently represented by the agent.
-d
Instead of adding the identity, removes the identity from the agent.
-D
Deletes all identities from the agent.
-x
Lock the agent with a password.
-X
Unlock the agent.
-t life
Set a maximum lifetime when adding identities to an agent.The lifetime may be specified in seconds or in a time formatspecified insshd_config5.
-c
Indicates that added identities should be subject to confirmation beforebeing used for authentication.Confirmation is performed by theSSH_ASKPASSprogram mentioned below.Successful confirmation is signaled by a zero exit status from theSSH_ASKPASSprogram, rather than text entered into the requester.
-s reader
Add key in smartcardreader
-e reader
Remove key in smartcardreader

 

FILES

$HOME/.ssh/identity
Contains the protocol version 1 RSA authentication identity of the user.
$HOME/.ssh/id_dsa
Contains the protocol version 2 DSA authentication identity of the user.
$HOME/.ssh/id_rsa
Contains the protocol version 2 RSA authentication identity of the user.

Identity files should not be readable by anyone but the user.Note thatssh-addignores identity files if they are accessible by others. 

ENVIRONMENT

DISPLAY and SSH_ASKPASS
Ifssh-addneeds a passphrase, it will read the passphrase from the currentterminal if it was run from a terminal.Ifssh-adddoes not have a terminal associated with it butDISPLAYandSSH_ASKPASSare set, it will execute the program specified bySSH_ASKPASSand open an X11 window to read the passphrase.This is particularly useful when callingssh-addfrom a.Xsessionor related script.(Note that on some machines itmay be necessary to redirect the input from/dev/nullto make this work.)
SSH_AUTH_SOCK
Identifies the path of a unix-domain socket used to communicate with theagent.

 

DIAGNOSTICS

Exit status is 0 on success, 1 if the specified command fails,and 2 ifssh-addis unable to contact the authentication agent. 

AUTHORS

OpenSSH is a derivative of the original and freessh 1.2.12 release by Tatu Ylonen.Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos,Theo de Raadt and Dug Songremoved many bugs, re-added newer features andcreated OpenSSH.Markus Friedl contributed the support for SSHprotocol versions 1.5 and 2.0. 

SEE ALSO

ssh(1),ssh-agent1,ssh-keygen1,sshd(8)


 

Index

NAME
SYNOPSIS
DESCRIPTION
FILES
ENVIRONMENT
DIAGNOSTICS
AUTHORS
SEE ALSO

This document was created byman2html,using the manual pages.