From nobody@FreeBSD.org  Wed Oct  3 19:41:33 2007
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id AFD6E16A419
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  3 Oct 2007 19:41:33 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 9117313C447
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  3 Oct 2007 19:41:33 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l93JfXca047752
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 3 Oct 2007 19:41:33 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l93JfXdN047751;
	Wed, 3 Oct 2007 19:41:33 GMT
	(envelope-from nobody)
Message-Id: <200710031941.l93JfXdN047751@www.freebsd.org>
Date: Wed, 3 Oct 2007 19:41:33 GMT
From: Warren Block <wblock@wonkity.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] ssh-keygen not clear whether authorized_keys is file or dir
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         116879
>Category:       docs
>Synopsis:       [patch] ssh-keygen not clear whether authorized_keys is file or dir
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    danger
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Oct 03 19:50:01 GMT 2007
>Closed-Date:    Wed Oct 03 20:38:48 GMT 2007
>Last-Modified:  Wed Oct  3 20:40:02 GMT 2007
>Originator:     Warren Block
>Release:        6.2-STABLE
>Organization:
>Environment:
FreeBSD speedy.wonkity.com 6.2-STABLE FreeBSD 6.2-STABLE #0: Fri Sep 28 13:51:02 MDT 2007     root@speedy.wonkity.com:/usr/obj/usr/src/sys/SPEEDY  i386
>Description:
The Handbook OpenSSH/ssh-keygen section says

"The public key must be placed in ~/.ssh/authorized_keys of the remote machine in order for the setup to work. Similarly, RSA version 1 public keys should be placed in ~/.ssh/authorized_keys."

The usage of "in" is ambiguous, and can be read as "place the key file in a directory called authorized_keys".
>How-To-Repeat:
Read the OpenSSH/ssh-keygen section of the Handbook.
>Fix:
Apply the attached patch.

Patch attached with submission follows:

--- chapter.sgml.orig	2007-10-03 12:38:49.000000000 -0600
+++ chapter.sgml	2007-10-03 13:36:46.000000000 -0600
@@ -4221,11 +4221,11 @@
         <filename>~/.ssh/id_rsa</filename>, whereas the public key is
         stored in <filename>~/.ssh/id_dsa.pub</filename> or
         <filename>~/.ssh/id_rsa.pub</filename>, respectively for DSA and
-        RSA key types.  The public key must be placed in
-        <filename>~/.ssh/authorized_keys</filename> of the remote
-        machine in order for the setup to work.  Similarly, RSA version
-        1 public keys should be placed in
-        <filename>~/.ssh/authorized_keys</filename>.</para>
+        RSA key types.  The public key must be placed in the
+        <filename>~/.ssh/authorized_keys</filename> file of the remote
+        machine in order for the setup to work.  Both DSA and RSA version
+        1 public keys may be placed in the
+        <filename>~/.ssh/authorized_keys</filename> file.</para>
 
       <para>This will allow connection to the remote machine based upon
         SSH keys instead of passwords.</para>


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->danger 
Responsible-Changed-By: danger 
Responsible-Changed-When: Wed Oct 3 20:05:54 UTC 2007 
Responsible-Changed-Why:  
Take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=116879 
State-Changed-From-To: open->closed 
State-Changed-By: danger 
State-Changed-When: Wed Oct 3 20:35:57 UTC 2007 
State-Changed-Why:  
Fixed in rev. 1.315. (I have committed a bit modified patch than the one 
you have submitted.) 

New version should be on-line in a few hours after next scheduled 
documentation rebuild. 
Thanks for your submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=116879 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/116879: commit references a PR
Date: Wed,  3 Oct 2007 20:35:43 +0000 (UTC)

 danger      2007-10-03 20:35:35 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/security chapter.sgml 
   Log:
   - Add <acronym> tags around RSA and DSA words,
   - ensure reader that the ~/.ssh/authorized_files is pure file and not
     directory [1],
   - simplify the last part of para,
   - 8 spaces = tab, while here.
   
   PR: docs/116879 [1]
   
   Revision  Changes    Path
   1.315     +7 -6      doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
