diff options
Diffstat (limited to 'ssh-keygen.1')
-rw-r--r-- | ssh-keygen.1 | 27 |
1 files changed, 19 insertions, 8 deletions
diff --git a/ssh-keygen.1 b/ssh-keygen.1 index 205f741b8..ede37921c 100644 --- a/ssh-keygen.1 +++ b/ssh-keygen.1 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: ssh-keygen.1,v 1.101 2010/10/28 18:33:28 jmc Exp $ | 1 | .\" $OpenBSD: ssh-keygen.1,v 1.106 2011/04/13 04:09:37 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,7 +35,7 @@ | |||
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: October 28 2010 $ | 38 | .Dd $Mdocdate: April 13 2011 $ |
39 | .Dt SSH-KEYGEN 1 | 39 | .Dt SSH-KEYGEN 1 |
40 | .Os | 40 | .Os |
41 | .Sh NAME | 41 | .Sh NAME |
@@ -117,6 +117,8 @@ | |||
117 | .Nm ssh-keygen | 117 | .Nm ssh-keygen |
118 | .Fl L | 118 | .Fl L |
119 | .Op Fl f Ar input_keyfile | 119 | .Op Fl f Ar input_keyfile |
120 | .Nm ssh-keygen | ||
121 | .Fl A | ||
120 | .Ek | 122 | .Ek |
121 | .Sh DESCRIPTION | 123 | .Sh DESCRIPTION |
122 | .Nm | 124 | .Nm |
@@ -173,9 +175,8 @@ The passphrase can be changed later by using the | |||
173 | option. | 175 | option. |
174 | .Pp | 176 | .Pp |
175 | There is no way to recover a lost passphrase. | 177 | There is no way to recover a lost passphrase. |
176 | If the passphrase is | 178 | If the passphrase is lost or forgotten, a new key must be generated |
177 | lost or forgotten, a new key must be generated and copied to the | 179 | and the corresponding public key copied to other machines. |
178 | corresponding public key to other machines. | ||
179 | .Pp | 180 | .Pp |
180 | For RSA1 keys, | 181 | For RSA1 keys, |
181 | there is also a comment field in the key file that is only for | 182 | there is also a comment field in the key file that is only for |
@@ -192,6 +193,13 @@ should be placed to be activated. | |||
192 | .Pp | 193 | .Pp |
193 | The options are as follows: | 194 | The options are as follows: |
194 | .Bl -tag -width Ds | 195 | .Bl -tag -width Ds |
196 | .It Fl A | ||
197 | For each of the key types (rsa1, rsa, dsa and ecdsa) for which host keys | ||
198 | do not exist, generate the host keys with the default key file path, | ||
199 | an empty passphrase, default bits for the key type, and default comment. | ||
200 | This is used by | ||
201 | .Pa /etc/rc | ||
202 | to generate new host keys. | ||
195 | .It Fl a Ar trials | 203 | .It Fl a Ar trials |
196 | Specifies the number of primality tests to perform when screening DH-GEX | 204 | Specifies the number of primality tests to perform when screening DH-GEX |
197 | candidates using the | 205 | candidates using the |
@@ -204,6 +212,12 @@ Specifies the number of bits in the key to create. | |||
204 | For RSA keys, the minimum size is 768 bits and the default is 2048 bits. | 212 | For RSA keys, the minimum size is 768 bits and the default is 2048 bits. |
205 | Generally, 2048 bits is considered sufficient. | 213 | Generally, 2048 bits is considered sufficient. |
206 | DSA keys must be exactly 1024 bits as specified by FIPS 186-2. | 214 | DSA keys must be exactly 1024 bits as specified by FIPS 186-2. |
215 | For ECDSA keys, the | ||
216 | .Fl b | ||
217 | flag determines they key length by selecting from one of three elliptic | ||
218 | curve sizes: 256, 384 or 521 bits. | ||
219 | Attempting to use bit lengths other than these three values for ECDSA keys | ||
220 | will fail. | ||
207 | .It Fl C Ar comment | 221 | .It Fl C Ar comment |
208 | Provides a new comment. | 222 | Provides a new comment. |
209 | .It Fl c | 223 | .It Fl c |
@@ -393,9 +407,6 @@ new passphrase. | |||
393 | .It Fl q | 407 | .It Fl q |
394 | Silence | 408 | Silence |
395 | .Nm ssh-keygen . | 409 | .Nm ssh-keygen . |
396 | Used by | ||
397 | .Pa /etc/rc | ||
398 | when creating a new key. | ||
399 | .It Fl R Ar hostname | 410 | .It Fl R Ar hostname |
400 | Removes all keys belonging to | 411 | Removes all keys belonging to |
401 | .Ar hostname | 412 | .Ar hostname |