summaryrefslogtreecommitdiff
path: root/ssh-keygen.1
diff options
context:
space:
mode:
Diffstat (limited to 'ssh-keygen.1')
-rw-r--r--ssh-keygen.148
1 files changed, 19 insertions, 29 deletions
diff --git a/ssh-keygen.1 b/ssh-keygen.1
index 0845b4066..d0c00ebb0 100644
--- a/ssh-keygen.1
+++ b/ssh-keygen.1
@@ -1,6 +1,4 @@
1.\" $OpenBSD: ssh-keygen.1,v 1.98 2010/08/04 06:07:11 djm Exp $ 1.\" $OpenBSD: ssh-keygen.1,v 1.101 2010/10/28 18:33:28 jmc Exp $
2.\"
3.\" -*- nroff -*-
4.\" 2.\"
5.\" Author: Tatu Ylonen <ylo@cs.hut.fi> 3.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
6.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland 4.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
@@ -37,7 +35,7 @@
37.\" (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
38.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 36.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39.\" 37.\"
40.Dd $Mdocdate: August 4 2010 $ 38.Dd $Mdocdate: October 28 2010 $
41.Dt SSH-KEYGEN 1 39.Dt SSH-KEYGEN 1
42.Os 40.Os
43.Sh NAME 41.Sh NAME
@@ -125,7 +123,7 @@
125generates, manages and converts authentication keys for 123generates, manages and converts authentication keys for
126.Xr ssh 1 . 124.Xr ssh 1 .
127.Nm 125.Nm
128can create RSA keys for use by SSH protocol version 1 and RSA or DSA 126can create RSA keys for use by SSH protocol version 1 and DSA, ECDSA or RSA
129keys for use by SSH protocol version 2. 127keys for use by SSH protocol version 2.
130The type of key to be generated is specified with the 128The type of key to be generated is specified with the
131.Fl t 129.Fl t
@@ -142,9 +140,10 @@ See the
142section for details. 140section for details.
143.Pp 141.Pp
144Normally each user wishing to use SSH 142Normally each user wishing to use SSH
145with RSA or DSA authentication runs this once to create the authentication 143with public key authentication runs this once to create the authentication
146key in 144key in
147.Pa ~/.ssh/identity , 145.Pa ~/.ssh/identity ,
146.Pa ~/.ssh/id_ecdsa ,
148.Pa ~/.ssh/id_dsa 147.Pa ~/.ssh/id_dsa
149or 148or
150.Pa ~/.ssh/id_rsa . 149.Pa ~/.ssh/id_rsa .
@@ -422,9 +421,10 @@ Specifies the type of key to create.
422The possible values are 421The possible values are
423.Dq rsa1 422.Dq rsa1
424for protocol version 1 and 423for protocol version 1 and
425.Dq rsa 424.Dq dsa ,
425.Dq ecdsa
426or 426or
427.Dq dsa 427.Dq rsa
428for protocol version 2. 428for protocol version 2.
429.It Fl V Ar validity_interval 429.It Fl V Ar validity_interval
430Specify a validity interval when signing a certificate. 430Specify a validity interval when signing a certificate.
@@ -601,18 +601,19 @@ or
601.Xr ssh 1 . 601.Xr ssh 1 .
602Please refer to those manual pages for details. 602Please refer to those manual pages for details.
603.Sh FILES 603.Sh FILES
604.Bl -tag -width Ds 604.Bl -tag -width Ds -compact
605.It Pa ~/.ssh/identity 605.It Pa ~/.ssh/identity
606Contains the protocol version 1 RSA authentication identity of the user. 606Contains the protocol version 1 RSA authentication identity of the user.
607This file should not be readable by anyone but the user. 607This file should not be readable by anyone but the user.
608It is possible to 608It is possible to
609specify a passphrase when generating the key; that passphrase will be 609specify a passphrase when generating the key; that passphrase will be
610used to encrypt the private part of this file using 128-bit AES. 610used to encrypt the private part of this file using 3DES.
611This file is not automatically accessed by 611This file is not automatically accessed by
612.Nm 612.Nm
613but it is offered as the default file for the private key. 613but it is offered as the default file for the private key.
614.Xr ssh 1 614.Xr ssh 1
615will read this file when a login attempt is made. 615will read this file when a login attempt is made.
616.Pp
616.It Pa ~/.ssh/identity.pub 617.It Pa ~/.ssh/identity.pub
617Contains the protocol version 1 RSA public key for authentication. 618Contains the protocol version 1 RSA public key for authentication.
618The contents of this file should be added to 619The contents of this file should be added to
@@ -620,26 +621,11 @@ The contents of this file should be added to
620on all machines 621on all machines
621where the user wishes to log in using RSA authentication. 622where the user wishes to log in using RSA authentication.
622There is no need to keep the contents of this file secret. 623There is no need to keep the contents of this file secret.
624.Pp
623.It Pa ~/.ssh/id_dsa 625.It Pa ~/.ssh/id_dsa
624Contains the protocol version 2 DSA authentication identity of the user. 626.It Pa ~/.ssh/id_ecdsa
625This file should not be readable by anyone but the user.
626It is possible to
627specify a passphrase when generating the key; that passphrase will be
628used to encrypt the private part of this file using 128-bit AES.
629This file is not automatically accessed by
630.Nm
631but it is offered as the default file for the private key.
632.Xr ssh 1
633will read this file when a login attempt is made.
634.It Pa ~/.ssh/id_dsa.pub
635Contains the protocol version 2 DSA public key for authentication.
636The contents of this file should be added to
637.Pa ~/.ssh/authorized_keys
638on all machines
639where the user wishes to log in using public key authentication.
640There is no need to keep the contents of this file secret.
641.It Pa ~/.ssh/id_rsa 627.It Pa ~/.ssh/id_rsa
642Contains the protocol version 2 RSA authentication identity of the user. 628Contains the protocol version 2 DSA, ECDSA or RSA authentication identity of the user.
643This file should not be readable by anyone but the user. 629This file should not be readable by anyone but the user.
644It is possible to 630It is possible to
645specify a passphrase when generating the key; that passphrase will be 631specify a passphrase when generating the key; that passphrase will be
@@ -649,13 +635,17 @@ This file is not automatically accessed by
649but it is offered as the default file for the private key. 635but it is offered as the default file for the private key.
650.Xr ssh 1 636.Xr ssh 1
651will read this file when a login attempt is made. 637will read this file when a login attempt is made.
638.Pp
639.It Pa ~/.ssh/id_dsa.pub
640.It Pa ~/.ssh/id_ecdsa.pub
652.It Pa ~/.ssh/id_rsa.pub 641.It Pa ~/.ssh/id_rsa.pub
653Contains the protocol version 2 RSA public key for authentication. 642Contains the protocol version 2 DSA, ECDSA or RSA public key for authentication.
654The contents of this file should be added to 643The contents of this file should be added to
655.Pa ~/.ssh/authorized_keys 644.Pa ~/.ssh/authorized_keys
656on all machines 645on all machines
657where the user wishes to log in using public key authentication. 646where the user wishes to log in using public key authentication.
658There is no need to keep the contents of this file secret. 647There is no need to keep the contents of this file secret.
648.Pp
659.It Pa /etc/moduli 649.It Pa /etc/moduli
660Contains Diffie-Hellman groups used for DH-GEX. 650Contains Diffie-Hellman groups used for DH-GEX.
661The file format is described in 651The file format is described in