diff options
Diffstat (limited to 'ssh-keygen.1')
-rw-r--r-- | ssh-keygen.1 | 51 |
1 files changed, 34 insertions, 17 deletions
diff --git a/ssh-keygen.1 b/ssh-keygen.1 index 6808ede69..55e31de9e 100644 --- a/ssh-keygen.1 +++ b/ssh-keygen.1 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: ssh-keygen.1,v 1.36 2001/04/10 09:13:21 itojun Exp $ | 1 | .\" $OpenBSD: ssh-keygen.1,v 1.37 2001/04/22 13:25:37 markus Exp $ |
2 | .\" | 2 | .\" |
3 | .\" -*- nroff -*- | 3 | .\" -*- nroff -*- |
4 | .\" | 4 | .\" |
@@ -42,7 +42,7 @@ | |||
42 | .Os | 42 | .Os |
43 | .Sh NAME | 43 | .Sh NAME |
44 | .Nm ssh-keygen | 44 | .Nm ssh-keygen |
45 | .Nd authentication key generation | 45 | .Nd authentication key generation, management and conversion |
46 | .Sh SYNOPSIS | 46 | .Sh SYNOPSIS |
47 | .Nm ssh-keygen | 47 | .Nm ssh-keygen |
48 | .Op Fl q | 48 | .Op Fl q |
@@ -57,10 +57,10 @@ | |||
57 | .Op Fl N Ar new_passphrase | 57 | .Op Fl N Ar new_passphrase |
58 | .Op Fl f Ar keyfile | 58 | .Op Fl f Ar keyfile |
59 | .Nm ssh-keygen | 59 | .Nm ssh-keygen |
60 | .Fl x | 60 | .Fl i |
61 | .Op Fl f Ar input_keyfile | 61 | .Op Fl f Ar input_keyfile |
62 | .Nm ssh-keygen | 62 | .Nm ssh-keygen |
63 | .Fl X | 63 | .Fl e |
64 | .Op Fl f Ar input_keyfile | 64 | .Op Fl f Ar input_keyfile |
65 | .Nm ssh-keygen | 65 | .Nm ssh-keygen |
66 | .Fl y | 66 | .Fl y |
@@ -78,10 +78,10 @@ | |||
78 | .Op Fl f Ar input_keyfile | 78 | .Op Fl f Ar input_keyfile |
79 | .Sh DESCRIPTION | 79 | .Sh DESCRIPTION |
80 | .Nm | 80 | .Nm |
81 | generates and manages authentication keys for | 81 | generates, manages and converts authentication keys for |
82 | .Xr ssh 1 . | 82 | .Xr ssh 1 . |
83 | .Nm | 83 | .Nm |
84 | defaults to generating an RSA key for use by protocols 1.3 and 1.5; | 84 | defaults to generating a RSA1 key for use by protocols 1.3 and 1.5; |
85 | specifying the | 85 | specifying the |
86 | .Fl t | 86 | .Fl t |
87 | option allows you to create a key for use by protocol 2.0. | 87 | option allows you to create a key for use by protocol 2.0. |
@@ -119,7 +119,8 @@ If the passphrase is | |||
119 | lost or forgotten, you will have to generate a new key and copy the | 119 | lost or forgotten, you will have to generate a new key and copy the |
120 | corresponding public key to other machines. | 120 | corresponding public key to other machines. |
121 | .Pp | 121 | .Pp |
122 | For RSA, there is also a comment field in the key file that is only for | 122 | For RSA1 keys, |
123 | there is also a comment field in the key file that is only for | ||
123 | convenience to the user to help identify the key. | 124 | convenience to the user to help identify the key. |
124 | The comment can tell what the key is for, or whatever is useful. | 125 | The comment can tell what the key is for, or whatever is useful. |
125 | The comment is initialized to | 126 | The comment is initialized to |
@@ -143,8 +144,23 @@ The default is 1024 bits. | |||
143 | Requests changing the comment in the private and public key files. | 144 | Requests changing the comment in the private and public key files. |
144 | The program will prompt for the file containing the private keys, for | 145 | The program will prompt for the file containing the private keys, for |
145 | passphrase if the key has one, and for the new comment. | 146 | passphrase if the key has one, and for the new comment. |
147 | .It Fl e | ||
148 | This option will read a private OpenSSH key file and print the key in a | ||
149 | .Sq SECSH Public Key File Format | ||
150 | to stdout. | ||
151 | This option allows exporting keys for use by several commercial | ||
152 | SSH implementations. | ||
146 | .It Fl f | 153 | .It Fl f |
147 | Specifies the filename of the key file. | 154 | Specifies the filename of the key file. |
155 | .It Fl i | ||
156 | This option will read an unencrypted private (or public) key file | ||
157 | in SSH2-compatible format and print an OpenSSH compatible private | ||
158 | (or public) key to stdout. | ||
159 | .Nm | ||
160 | does also read the | ||
161 | .Sq SECSH Public Key File Format . | ||
162 | This option allows importing keys from several commercial | ||
163 | SSH implementations. | ||
148 | .It Fl l | 164 | .It Fl l |
149 | Show fingerprint of specified private or public key file. | 165 | Show fingerprint of specified private or public key file. |
150 | .It Fl p | 166 | .It Fl p |
@@ -159,6 +175,9 @@ Silence | |||
159 | Used by | 175 | Used by |
160 | .Pa /etc/rc | 176 | .Pa /etc/rc |
161 | when creating a new key. | 177 | when creating a new key. |
178 | .It Fl y | ||
179 | This option will read a private | ||
180 | OpenSSH format file and print an OpenSSH public key to stdout. | ||
162 | .It Fl t Ar type | 181 | .It Fl t Ar type |
163 | Specifies the type of the key to create. | 182 | Specifies the type of the key to create. |
164 | The possible values are | 183 | The possible values are |
@@ -178,16 +197,6 @@ Provides the new comment. | |||
178 | Provides the new passphrase. | 197 | Provides the new passphrase. |
179 | .It Fl P Ar passphrase | 198 | .It Fl P Ar passphrase |
180 | Provides the (old) passphrase. | 199 | Provides the (old) passphrase. |
181 | .It Fl x | ||
182 | This option will read a private | ||
183 | OpenSSH DSA format file and print a SSH2-compatible public key to stdout. | ||
184 | .It Fl X | ||
185 | This option will read a unencrypted | ||
186 | SSH2-compatible private (or public) key file and | ||
187 | print an OpenSSH compatible private (or public) key to stdout. | ||
188 | .It Fl y | ||
189 | This option will read a private | ||
190 | OpenSSH format file and print an OpenSSH public key to stdout. | ||
191 | .El | 200 | .El |
192 | .Sh FILES | 201 | .Sh FILES |
193 | .Bl -tag -width Ds | 202 | .Bl -tag -width Ds |
@@ -260,3 +269,11 @@ protocol versions 1.5 and 2.0. | |||
260 | .Xr ssh-add 1 , | 269 | .Xr ssh-add 1 , |
261 | .Xr ssh-agent 1 , | 270 | .Xr ssh-agent 1 , |
262 | .Xr sshd 8 | 271 | .Xr sshd 8 |
272 | .Rs | ||
273 | .%A J. Galbraith | ||
274 | .%A R. Thayer | ||
275 | .%T "SECSH Public Key File Format" | ||
276 | .%N draft-ietf-secsh-publickeyfile-01.txt | ||
277 | .%D March 2001 | ||
278 | .%O work in progress material | ||
279 | .Re | ||