From d984a3c6658e950881edcfb2aae464add93f68d4 Mon Sep 17 00:00:00 2001 From: Colin Watson Date: Mon, 1 Sep 2003 00:45:47 +0000 Subject: Import OpenSSH 3.4p1. --- ssh-add.0 | 96 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 ssh-add.0 (limited to 'ssh-add.0') diff --git a/ssh-add.0 b/ssh-add.0 new file mode 100644 index 000000000..d5b49d35d --- /dev/null +++ b/ssh-add.0 @@ -0,0 +1,96 @@ +SSH-ADD(1) System General Commands Manual SSH-ADD(1) + +NAME + ssh-add - adds RSA or DSA identities to the authentication agent + +SYNOPSIS + ssh-add [-lLdDxX] [-t life] [file ...] + ssh-add -s reader + ssh-add -e reader + +DESCRIPTION + ssh-add adds RSA or DSA identities to the authentication agent, + ssh-agent(1). When run without arguments, it adds the files + $HOME/.ssh/id_rsa, $HOME/.ssh/id_dsa and $HOME/.ssh/identity. AlternaM-- + tive file names can be given on the command line. If any file requires a + passphrase, ssh-add asks for the passphrase from the user. The + passphrase is read from the user's tty. ssh-add retries the last + passphrase if multiple identity files are given. + + The authentication agent must be running and must be an ancestor of the + current process for ssh-add to 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 repreM-- + sented 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 format speciM-- + fied in sshd(8). + + -s reader + Add key in smartcard reader. + + -e reader + Remove key in smartcard reader. + +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 that + ssh-add ignores identity files if they are accessible by others. + +ENVIRONMENT + DISPLAY and SSH_ASKPASS + If ssh-add needs a passphrase, it will read the passphrase from + the current terminal if it was run from a terminal. If ssh-add + does not have a terminal associated with it but DISPLAY and + SSH_ASKPASS are set, it will execute the program specified by + SSH_ASKPASS and open an X11 window to read the passphrase. This + is particularly useful when calling ssh-add from a .Xsession or + related script. (Note that on some machines it may be necessary + to redirect the input from /dev/null to make this work.) + + SSH_AUTH_SOCK + Identifies the path of a unix-domain socket used to communicate + with the agent. + +DIAGNOSTICS + Exit status is 0 on success, 1 if the specified command fails, and 2 if + ssh-add is unable to contact the authentication agent. + +AUTHORS + OpenSSH is a derivative of the original and free ssh 1.2.12 release by + Tatu Ylonen. Aaron Campbell, Bob Beck, Markus Friedl, Niels Provos, Theo + de Raadt and Dug Song removed many bugs, re-added newer features and creM-- + ated OpenSSH. Markus Friedl contributed the support for SSH protocol + versions 1.5 and 2.0. + +SEE ALSO + ssh(1), ssh-agent(1), ssh-keygen(1), sshd(8) + +BSD September 25, 1999 BSD -- cgit v1.2.3