summaryrefslogtreecommitdiff
path: root/ssh-keygen.1
diff options
context:
space:
mode:
Diffstat (limited to 'ssh-keygen.1')
-rw-r--r--ssh-keygen.143
1 files changed, 17 insertions, 26 deletions
diff --git a/ssh-keygen.1 b/ssh-keygen.1
index 4b95a4e1c..b9700230b 100644
--- a/ssh-keygen.1
+++ b/ssh-keygen.1
@@ -1,4 +1,4 @@
1.\" $OpenBSD: ssh-keygen.1,v 1.99 2010/08/31 11:54:45 djm Exp $ 1.\" $OpenBSD: ssh-keygen.1,v 1.100 2010/09/10 15:19:29 naddy Exp $
2.\" 2.\"
3.\" -*- nroff -*- 3.\" -*- nroff -*-
4.\" 4.\"
@@ -37,7 +37,7 @@
37.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 37.\" (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. 38.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39.\" 39.\"
40.Dd $Mdocdate: August 31 2010 $ 40.Dd $Mdocdate: September 10 2010 $
41.Dt SSH-KEYGEN 1 41.Dt SSH-KEYGEN 1
42.Os 42.Os
43.Sh NAME 43.Sh NAME
@@ -125,7 +125,7 @@
125generates, manages and converts authentication keys for 125generates, manages and converts authentication keys for
126.Xr ssh 1 . 126.Xr ssh 1 .
127.Nm 127.Nm
128can create RSA keys for use by SSH protocol version 1 and RSA, DSA or ECDSA 128can create RSA keys for use by SSH protocol version 1 and DSA, ECDSA or RSA
129keys for use by SSH protocol version 2. 129keys for use by SSH protocol version 2.
130The type of key to be generated is specified with the 130The type of key to be generated is specified with the
131.Fl t 131.Fl t
@@ -427,9 +427,10 @@ Specifies the type of key to create.
427The possible values are 427The possible values are
428.Dq rsa1 428.Dq rsa1
429for protocol version 1 and 429for protocol version 1 and
430.Dq rsa 430.Dq dsa ,
431.Dq ecdsa
431or 432or
432.Dq dsa 433.Dq rsa
433for protocol version 2. 434for protocol version 2.
434.It Fl V Ar validity_interval 435.It Fl V Ar validity_interval
435Specify a validity interval when signing a certificate. 436Specify a validity interval when signing a certificate.
@@ -606,18 +607,19 @@ or
606.Xr ssh 1 . 607.Xr ssh 1 .
607Please refer to those manual pages for details. 608Please refer to those manual pages for details.
608.Sh FILES 609.Sh FILES
609.Bl -tag -width Ds 610.Bl -tag -width Ds -compact
610.It Pa ~/.ssh/identity 611.It Pa ~/.ssh/identity
611Contains the protocol version 1 RSA authentication identity of the user. 612Contains the protocol version 1 RSA authentication identity of the user.
612This file should not be readable by anyone but the user. 613This file should not be readable by anyone but the user.
613It is possible to 614It is possible to
614specify a passphrase when generating the key; that passphrase will be 615specify a passphrase when generating the key; that passphrase will be
615used to encrypt the private part of this file using 128-bit AES. 616used to encrypt the private part of this file using 3DES.
616This file is not automatically accessed by 617This file is not automatically accessed by
617.Nm 618.Nm
618but it is offered as the default file for the private key. 619but it is offered as the default file for the private key.
619.Xr ssh 1 620.Xr ssh 1
620will read this file when a login attempt is made. 621will read this file when a login attempt is made.
622.Pp
621.It Pa ~/.ssh/identity.pub 623.It Pa ~/.ssh/identity.pub
622Contains the protocol version 1 RSA public key for authentication. 624Contains the protocol version 1 RSA public key for authentication.
623The contents of this file should be added to 625The contents of this file should be added to
@@ -625,26 +627,11 @@ The contents of this file should be added to
625on all machines 627on all machines
626where the user wishes to log in using RSA authentication. 628where the user wishes to log in using RSA authentication.
627There is no need to keep the contents of this file secret. 629There is no need to keep the contents of this file secret.
630.Pp
628.It Pa ~/.ssh/id_dsa 631.It Pa ~/.ssh/id_dsa
629Contains the protocol version 2 DSA authentication identity of the user. 632.It Pa ~/.ssh/id_ecdsa
630This file should not be readable by anyone but the user.
631It is possible to
632specify a passphrase when generating the key; that passphrase will be
633used to encrypt the private part of this file using 128-bit AES.
634This file is not automatically accessed by
635.Nm
636but it is offered as the default file for the private key.
637.Xr ssh 1
638will read this file when a login attempt is made.
639.It Pa ~/.ssh/id_dsa.pub
640Contains the protocol version 2 DSA public key for authentication.
641The contents of this file should be added to
642.Pa ~/.ssh/authorized_keys
643on all machines
644where the user wishes to log in using public key authentication.
645There is no need to keep the contents of this file secret.
646.It Pa ~/.ssh/id_rsa 633.It Pa ~/.ssh/id_rsa
647Contains the protocol version 2 RSA authentication identity of the user. 634Contains the protocol version 2 DSA, ECDSA or RSA authentication identity of the user.
648This file should not be readable by anyone but the user. 635This file should not be readable by anyone but the user.
649It is possible to 636It is possible to
650specify a passphrase when generating the key; that passphrase will be 637specify a passphrase when generating the key; that passphrase will be
@@ -654,13 +641,17 @@ This file is not automatically accessed by
654but it is offered as the default file for the private key. 641but it is offered as the default file for the private key.
655.Xr ssh 1 642.Xr ssh 1
656will read this file when a login attempt is made. 643will read this file when a login attempt is made.
644.Pp
645.It Pa ~/.ssh/id_dsa.pub
646.It Pa ~/.ssh/id_ecdsa.pub
657.It Pa ~/.ssh/id_rsa.pub 647.It Pa ~/.ssh/id_rsa.pub
658Contains the protocol version 2 RSA public key for authentication. 648Contains the protocol version 2 DSA, ECDSA or RSA public key for authentication.
659The contents of this file should be added to 649The contents of this file should be added to
660.Pa ~/.ssh/authorized_keys 650.Pa ~/.ssh/authorized_keys
661on all machines 651on all machines
662where the user wishes to log in using public key authentication. 652where the user wishes to log in using public key authentication.
663There is no need to keep the contents of this file secret. 653There is no need to keep the contents of this file secret.
654.Pp
664.It Pa /etc/moduli 655.It Pa /etc/moduli
665Contains Diffie-Hellman groups used for DH-GEX. 656Contains Diffie-Hellman groups used for DH-GEX.
666The file format is described in 657The file format is described in