From root@molasses.desk.hq.powerset.com  Thu Jun 14 22:41:31 2007
Return-Path: <root@molasses.desk.hq.powerset.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 047D916A46B
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 14 Jun 2007 22:41:31 +0000 (UTC)
	(envelope-from root@molasses.desk.hq.powerset.com)
Received: from mail00.sv.powerset.com (mx1-in.sv.powerset.com [208.76.46.10])
	by mx1.freebsd.org (Postfix) with ESMTP id E686513C480
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 14 Jun 2007 22:41:30 +0000 (UTC)
	(envelope-from root@molasses.desk.hq.powerset.com)
Received: from molasses.desk.hq.powerset.com (molasses.desk.hq.powerset.com [208.76.47.93])
	by mail00.sv.powerset.com (Postfix) with ESMTP id 9B5031A9B14
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 14 Jun 2007 22:18:45 +0000 (UTC)
Received: from molasses.desk.hq.powerset.com (localhost [127.0.0.1])
	by molasses (8.14.1/8.14.1) with ESMTP id l5EFGIq4001790
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 14 Jun 2007 15:16:18 GMT
	(envelope-from root@molasses.desk.hq.powerset.com)
Received: (from root@localhost)
	by molasses.desk.hq.powerset.com (8.14.1/8.14.1/Submit) id l5EFGI89001789;
	Thu, 14 Jun 2007 15:16:18 GMT
	(envelope-from root)
Message-Id: <200706141516.l5EFGI89001789@molasses.desk.hq.powerset.com>
Date: Thu, 14 Jun 2007 15:16:18 GMT
From: bill fumerola <billf@freebsd.org>
Reply-To: billf@mu.org
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: handbook suggests different lockfile than gbde(8) manpage
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         113695
>Category:       docs
>Synopsis:       [handbook] [patch] handbook suggests different lockfile than gbde(8) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 14 22:50:04 GMT 2007
>Closed-Date:    Mon Jan 21 21:09:26 UTC 2008
>Last-Modified:  Mon Jan 21 21:10:01 UTC 2008
>Originator:     bill fumerola
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
powerset, inc.
>Environment:
System: FreeBSD molasses 7.0-CURRENT FreeBSD 7.0-CURRENT #1: Mon Jun 11 16:45:47 UTC 2007 root@molasses:/usr/obj/usr/src/sys/BUFU i386


>Description:

the 'disks-encrypting' section suggests creating a gbde partition
lock as /etc/gbde/ad4s1c, the gbde manpage suggests /etc/gbde/ad4s1c.lock,
and /etc/rc.d/gbde looks for /etc/gbde/PARTITION.lock

following the handbook's advice, one will not be able to use the
rc.conf/rc.d system to mount a gbde file system.

additionally, the handbook suggests the 'c' partition (the magic whole disk),
while the manpage suggests using a 'real' partition. the author of this
PR found that using the 'c' partition didn't work


>How-To-Repeat:

follow the GBDE instructions in the handbook, section 18.16

>Fix:

(*) change the handbook to use the 'a' partition in its example (as it will
exist after following the instructions on adding a new drive (section 18.3)

(*) change the handbook to instruct users to create the lockfile with the
.lock suffix

>Release-Note:
>Audit-Trail:

From: Marc Silver <marcs@draenor.org>
To: bug-followup@FreeBSD.org, billf@mu.org
Cc:  
Subject: Re: docs/113695: handbook suggests different lockfile than gbde(8) manpage
Date: Thu, 10 Jan 2008 14:22:19 +0200

 --V88s5gaDVPzZ0KCq
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hi there,
 
 I double checked this and /etc/rc.d/gbde does indeed look for a file
 that ends in ".lock".  Furthermore, the rc.d script explicitly looks in
 /etc for a lockfile unless gbde_lockdir is explicitly set in
 /etc/rc.conf.
 
 Included is a patch that corrects the article as well as adding notes
 regarding the fact that GBDE lock files must end in .lock and adding
 mention of the gbde_lockdir override.  
 
 With regards to the 'c' partition vs. the 'real' partition, I was able
 to set this up with the 'c' partition without any error, but since the
 guide states that the disk output should be used as a guideline I don't
 think this is too much of a trainsmash.
 
 Cheers,
 Marc
 
 --V88s5gaDVPzZ0KCq
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="gbde.patch"
 
 --- chapter.sgml.orig	2008-01-10 13:59:53.000000000 +0200
 +++ chapter.sgml	2008-01-10 14:06:04.000000000 +0200
 @@ -3566,7 +3566,7 @@
  	    initialized before it can be used. This initialization needs to
  	    be performed only once:</para>
  
 -	  <screen>&prompt.root; <userinput>gbde init /dev/ad4s1c -i -L /etc/gbde/ad4s1c</userinput></screen>
 +	  <screen>&prompt.root; <userinput>gbde init /dev/ad4s1c -i -L /etc/gbde/ad4s1c.lock</userinput></screen>
  
  	  <para>&man.gbde.8; will open your editor, permitting you to set
  	    various configuration options in a template. For use with UFS1
 @@ -3598,7 +3598,14 @@
  	  <para>The <command>gbde init</command> command creates a lock
  	    file for your <application>gbde</application> partition that in
  	    this example is stored as
 -	    <filename>/etc/gbde/ad4s1c</filename>.</para>
 +	    <filename>/etc/gbde/ad4s1c.lock</filename>.</para>
 +
 +	  <note>
 +	    <para><application>gbde</application> lock files must end in
 +	    <emphasis>.lock</emphasis> in order to be correctly detected
 +	    by the <application>gbde</application> <filename>rc.d</filename> 
 +	    script.</para>
 +	  </note>
  
  	  <caution>
  	    <para><application>gbde</application> lock files
 @@ -3616,7 +3623,7 @@
  	<step>
  	  <title>Attach the Encrypted Partition to the Kernel</title>
  
 -	  <screen>&prompt.root; <userinput>gbde attach /dev/ad4s1c -l /etc/gbde/ad4s1c</userinput></screen>
 +	  <screen>&prompt.root; <userinput>gbde attach /dev/ad4s1c -l /etc/gbde/ad4s1c.lock</userinput></screen>
  
  	  <para> You will be asked to provide the passphrase that you
  	    selected during the initialization of the encrypted partition.
 @@ -3693,7 +3700,7 @@
  	<step>
  	  <title>Attach the gbde Partition to the Kernel</title>
  
 -	  <screen>&prompt.root; <userinput>gbde attach /dev/ad4s1c -l /etc/gbde/ad4s1c</userinput></screen>
 +	  <screen>&prompt.root; <userinput>gbde attach /dev/ad4s1c -l /etc/gbde/ad4s1c.lock</userinput></screen>
  
  	  <para>You will be asked to provide the passphrase that you
  	    selected during initialization of the encrypted
 @@ -3734,7 +3741,8 @@
  	  &man.rc.conf.5;, for example:</para>
  
  	<programlisting>gbde_autoattach_all="YES"
 -gbde_devices="ad4s1c"</programlisting>
 +gbde_devices="ad4s1c"
 +gbde_lockdir="/etc/gbde"</programlisting>
  
  	<para>This will require that the <application>gbde</application>
  	  passphrase be entered at boot time.  After typing the correct
 
 --V88s5gaDVPzZ0KCq--
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Jan 21 21:08:23 UTC 2008 
State-Changed-Why:  
Slightly different patch applied as the submitted one seemed broken.  Thanks 
for the submission! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Jan 21 21:08:23 UTC 2008 
Responsible-Changed-Why:  
Over to me in case of follow up. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/113695: commit references a PR
Date: Mon, 21 Jan 2008 21:08:13 +0000 (UTC)

 trhodes     2008-01-21 21:08:05 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/disks chapter.sgml 
   Log:
   Discuss the gbde lockfile
   
   PR:             113695
   Submitted by:   Marc Silver <marcs@draenor.org>
   
   Revision  Changes    Path
   1.280     +10 -5     doc/en_US.ISO8859-1/books/handbook/disks/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:
