summaryrefslogtreecommitdiff
path: root/ssh-add.1
diff options
context:
space:
mode:
Diffstat (limited to 'ssh-add.1')
-rw-r--r--ssh-add.133
1 files changed, 23 insertions, 10 deletions
diff --git a/ssh-add.1 b/ssh-add.1
index d4e1c603b..58d42138e 100644
--- a/ssh-add.1
+++ b/ssh-add.1
@@ -1,4 +1,4 @@
1.\" $OpenBSD: ssh-add.1,v 1.69 2019/01/21 12:53:35 djm Exp $ 1.\" $OpenBSD: ssh-add.1,v 1.79 2020/02/07 03:57:31 djm Exp $
2.\" 2.\"
3.\" Author: Tatu Ylonen <ylo@cs.hut.fi> 3.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
4.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland 4.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
@@ -35,16 +35,17 @@
35.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 35.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
36.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 36.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37.\" 37.\"
38.Dd $Mdocdate: January 21 2019 $ 38.Dd $Mdocdate: February 7 2020 $
39.Dt SSH-ADD 1 39.Dt SSH-ADD 1
40.Os 40.Os
41.Sh NAME 41.Sh NAME
42.Nm ssh-add 42.Nm ssh-add
43.Nd adds private key identities to the authentication agent 43.Nd adds private key identities to the OpenSSH authentication agent
44.Sh SYNOPSIS 44.Sh SYNOPSIS
45.Nm ssh-add 45.Nm ssh-add
46.Op Fl cDdkLlqvXx 46.Op Fl cDdKkLlqvXx
47.Op Fl E Ar fingerprint_hash 47.Op Fl E Ar fingerprint_hash
48.Op Fl S Ar provider
48.Op Fl t Ar life 49.Op Fl t Ar life
49.Op Ar 50.Op Ar
50.Nm ssh-add 51.Nm ssh-add
@@ -62,8 +63,10 @@ When run without arguments, it adds the files
62.Pa ~/.ssh/id_rsa , 63.Pa ~/.ssh/id_rsa ,
63.Pa ~/.ssh/id_dsa , 64.Pa ~/.ssh/id_dsa ,
64.Pa ~/.ssh/id_ecdsa , 65.Pa ~/.ssh/id_ecdsa ,
66.Pa ~/.ssh/id_ecdsa_sk ,
67.Pa ~/.ssh/id_ed25519 ,
65and 68and
66.Pa ~/.ssh/id_ed25519 . 69.Pa ~/.ssh/id_ed25519_sk .
67After loading a private key, 70After loading a private key,
68.Nm 71.Nm
69will try to load corresponding certificate information from the 72will try to load corresponding certificate information from the
@@ -121,6 +124,8 @@ The default is
121.It Fl e Ar pkcs11 124.It Fl e Ar pkcs11
122Remove keys provided by the PKCS#11 shared library 125Remove keys provided by the PKCS#11 shared library
123.Ar pkcs11 . 126.Ar pkcs11 .
127.It Fl K
128Load resident keys from a FIDO authenticator.
124.It Fl k 129.It Fl k
125When loading keys into or deleting keys from the agent, process plain private 130When loading keys into or deleting keys from the agent, process plain private
126keys only and skip certificates. 131keys only and skip certificates.
@@ -131,6 +136,10 @@ by the agent.
131Lists fingerprints of all identities currently represented by the agent. 136Lists fingerprints of all identities currently represented by the agent.
132.It Fl q 137.It Fl q
133Be quiet after a successful operation. 138Be quiet after a successful operation.
139.It Fl S Ar provider
140Specifies a path to a library that will be used when adding
141FIDO authenticator-hosted keys, overriding the default of using the
142internal USB HID support.
134.It Fl s Ar pkcs11 143.It Fl s Ar pkcs11
135Add keys provided by the PKCS#11 shared library 144Add keys provided by the PKCS#11 shared library
136.Ar pkcs11 . 145.Ar pkcs11 .
@@ -189,17 +198,21 @@ to make this work.)
189Identifies the path of a 198Identifies the path of a
190.Ux Ns -domain 199.Ux Ns -domain
191socket used to communicate with the agent. 200socket used to communicate with the agent.
201.It Ev SSH_SK_PROVIDER
202Specifies a path to a library that will be used when loading any
203FIDO authenticator-hosted keys, overriding the default of using
204the built-in USB HID support.
192.El 205.El
193.Sh FILES 206.Sh FILES
194.Bl -tag -width Ds 207.Bl -tag -width Ds -compact
195.It Pa ~/.ssh/id_dsa 208.It Pa ~/.ssh/id_dsa
196Contains the DSA authentication identity of the user.
197.It Pa ~/.ssh/id_ecdsa 209.It Pa ~/.ssh/id_ecdsa
198Contains the ECDSA authentication identity of the user. 210.It Pa ~/.ssh/id_ecdsa_sk
199.It Pa ~/.ssh/id_ed25519 211.It Pa ~/.ssh/id_ed25519
200Contains the Ed25519 authentication identity of the user. 212.It Pa ~/.ssh/id_ed25519_sk
201.It Pa ~/.ssh/id_rsa 213.It Pa ~/.ssh/id_rsa
202Contains the RSA authentication identity of the user. 214Contains the DSA, ECDSA, authenticator-hosted ECDSA, Ed25519,
215authenticator-hosted Ed25519 or RSA authentication identity of the user.
203.El 216.El
204.Pp 217.Pp
205Identity files should not be readable by anyone but the user. 218Identity files should not be readable by anyone but the user.