From nobody@FreeBSD.org  Thu Mar  6 17:21:38 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id DBE3488A
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  6 Mar 2014 17:21:38 +0000 (UTC)
Received: from cgiserv.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id C91C0FB0
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  6 Mar 2014 17:21:38 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by cgiserv.freebsd.org (8.14.8/8.14.8) with ESMTP id s26HLcsP053124
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 6 Mar 2014 17:21:38 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.8/8.14.8/Submit) id s26HLcG5053121;
	Thu, 6 Mar 2014 17:21:38 GMT
	(envelope-from nobody)
Message-Id: <201403061721.s26HLcG5053121@cgiserv.freebsd.org>
Date: Thu, 6 Mar 2014 17:21:38 GMT
From: Jack-Benny Persson <jack-benny@cyberinfo.se>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Clarification needed on using geli rc.d script
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         187321
>Category:       docs
>Synopsis:       [handbook] [patch] Clarification needed on using geli rc.d script
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wblock
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 06 17:30:01 UTC 2014
>Closed-Date:    Fri Apr 11 16:11:56 UTC 2014
>Last-Modified:  Fri Apr 11 16:11:56 UTC 2014
>Originator:     Jack-Benny Persson
>Release:        FreeBSD 10.0
>Organization:
>Environment:
>Description:
When automatically attaching a provider during boot, the provider will detach itself again if it's not mounted with an entry in /etc/fstab during boot. This could need some clarification in chapter 18.14.2.1.
>How-To-Repeat:

>Fix:
See attached patch.

Patch attached with submission follows:

Index: en_US.ISO8859-1/books/handbook/disks/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/disks/chapter.xml	(revision 44144)
+++ en_US.ISO8859-1/books/handbook/disks/chapter.xml	(arbetskopia)
@@ -3164,6 +3164,20 @@
 	  the <command>geli</command> provider from the kernel before
 	  the system shuts down.</para>
 
+	<note><para>
+	  During boot the system will prompt for the passphrase to
+	  attach the provider. If the correct password is given the
+	  system will attach the provider. But, if the provider is not
+	  mounted by an entry in <filename>/etc/fstab</filename> the 
+	  provider will be detached again.
+	  So, in order to keep the provider attached an entry in
+	  <filename>/etc/fstab</filename> is necessary. See
+	  &man.fstab.5; for more information. 
+	</para></note>
+ 
+
+	  
+
 	<para>More information about configuring
 	  <filename>rc.d</filename> is provided in the
 	  <link linkend="configtuning-rcd">rc.d</link> section of the


>Release-Note:
>Audit-Trail:

From: Allan Jude <freebsd@allanjude.com>
To: bug-followup@FreeBSD.org, jack-benny@cyberinfo.se
Cc:  
Subject: Re: docs/187321: [handbook] [patch] Clarification needed on using
 geli rc.d script
Date: Wed, 19 Mar 2014 17:24:22 -0400

 This is a multi-part message in MIME format.
 --------------050203020502020103060605
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 Minor edits to the patch
 
 - added double spaces after periods
 - removed whitespace at ends of lines
 - reflowed paragraphs for 70 columns
 - removed the duplicated reference to /etc/fstab
 - added a warning about the fact that the password prompt can be hidden
 by device attachments
 - Other minor grammar edits
 
 -- 
 Allan Jude
 
 --------------050203020502020103060605
 Content-Type: text/plain; charset=windows-1252;
  name="docs.disks_geli_fix.patch"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="docs.disks_geli_fix.patch"
 
 Index: en_US.ISO8859-1/books/handbook/disks/chapter.xml
 ===================================================================
 --- en_US.ISO8859-1/books/handbook/disks/chapter.xml	(revision 44271)
 +++ en_US.ISO8859-1/books/handbook/disks/chapter.xml	(working copy)
 @@ -3164,6 +3164,18 @@
  	  the <command>geli</command> provider from the kernel before
  	  the system shuts down.</para>
  
 +	<note><para>During the boot process, the system will prompt
 +	  for the passphrase in order to attach the
 +	  <acornym>GELI</acornym> provider.  The password prompt may
 +	  become hidden by other kernel messages, look carefully
 +	  when the boot process seems to stall.  If the correct
 +	  password is given, the system will attach the provider.
 +	  However, if the provider is not subsequently used by a file
 +	  system the provider will timeout and automatically be
 +	  detached.  In order to keep the provider attached, it must
 +	  be mounted by an entry in <filename>/etc/fstab</filename>.
 +	  See &man.fstab.5; for more information.</para></note>
 +
  	<para>More information about configuring
  	  <filename>rc.d</filename> is provided in the
  	  <link linkend="configtuning-rcd">rc.d</link> section of the
 
 --------------050203020502020103060605--

From: Allan Jude <freebsd@allanjude.com>
To: bug-followup@FreeBSD.org, jack-benny@cyberinfo.se
Cc:  
Subject: Re: docs/187321: [handbook] [patch] Clarification needed on using
 geli rc.d script
Date: Wed, 19 Mar 2014 18:00:53 -0400

 This is a multi-part message in MIME format.
 --------------020407010902050606020603
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 Fix a typo that caused a build error
 
 
 -- 
 Allan Jude
 
 --------------020407010902050606020603
 Content-Type: text/plain; charset=windows-1252;
  name="docs.disks_geli_fix_v2.patch"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="docs.disks_geli_fix_v2.patch"
 
 Index: en_US.ISO8859-1/books/handbook/disks/chapter.xml
 ===================================================================
 --- en_US.ISO8859-1/books/handbook/disks/chapter.xml	(revision 44271)
 +++ en_US.ISO8859-1/books/handbook/disks/chapter.xml	(working copy)
 @@ -3164,6 +3164,18 @@
  	  the <command>geli</command> provider from the kernel before
  	  the system shuts down.</para>
  
 +	<note><para>During the boot process, the system will prompt
 +	  for the passphrase in order to attach the
 +	  <acronym>GELI</acronym> provider.  The password prompt may
 +	  become hidden by other kernel messages, look carefully
 +	  when the boot process seems to stall.  If the correct
 +	  password is given, the system will attach the provider.
 +	  However, if the provider is not subsequently used by a file
 +	  system the provider will timeout and automatically be
 +	  detached.  In order to keep the provider attached, it must
 +	  be mounted by an entry in <filename>/etc/fstab</filename>.
 +	  See &man.fstab.5; for more information.</para></note>
 +
  	<para>More information about configuring
  	  <filename>rc.d</filename> is provided in the
  	  <link linkend="configtuning-rcd">rc.d</link> section of the
 
 --------------020407010902050606020603--

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/187321: commit references a PR
Date: Fri, 11 Apr 2014 16:07:37 +0000 (UTC)

 Author: wblock
 Date: Fri Apr 11 16:07:32 2014
 New Revision: 44533
 URL: http://svnweb.freebsd.org/changeset/doc/44533
 
 Log:
   Clarify usage of GELI rc.d script.
   
   PR:		docs/187321
   Reviewed by:	Allan Jude and mat@ on IRC
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/disks/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml	Fri Apr 11 15:50:19 2014	(r44532)
 +++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml	Fri Apr 11 16:07:32 2014	(r44533)
 @@ -3126,8 +3126,8 @@ Filesystem     Size   Used  Avail Capaci
  geli_da2_flags="-p -k /root/da2.key"</programlisting>
  
  	<para>This configures <filename>/dev/da2</filename> as a
 -	  <command>geli</command> provider of which the master key
 -	  file is located in <filename>/root/da2.key</filename>.
 +	  <command>geli</command> provider with a master key
 +	  file of <filename>/root/da2.key</filename>.
  	  <command>geli</command> will not use a passphrase when
  	  attaching to the provider if
  	  <option>-P</option> was given during the
 @@ -3135,6 +3135,26 @@ geli_da2_flags="-p -k /root/da2.key"</pr
  	  the <command>geli</command> provider from the kernel before
  	  the system shuts down.</para>
  
 +	<note>
 +	  <para>During the startup process, scripts prompt for the
 +	    passphrase before attaching the <acronym>GELI</acronym>
 +	    provider.  Other kernel messages might be shown before and
 +	    after the password prompt.  If the boot process seems to
 +	    stall, look carefully for the password prompt among the
 +	    other messages.</para>
 +
 +	  <para>When the correct password is given, the provider is
 +	    attached.  A consumer, like a file system, is then mounted
 +	    on the provider, typically by an entry in
 +	    <filename>/etc/fstab</filename> (see
 +	    &man.fstab.5;).</para>
 +
 +	  <para>Later in the startup process, &os; configures
 +	    <acronym>GELI</acronym> providers to automatically detach.
 +	    <acronym>GELI</acronym> providers without any consumers
 +	    will detach at that time.</para>
 +	</note>
 +
  	<para>More information about configuring
  	  <filename>rc.d</filename> is provided in the
  	  <link linkend="configtuning-rcd">rc.d</link> section of the
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: wblock 
State-Changed-When: Fri Apr 11 16:11:12 UTC 2014 
State-Changed-Why:  
Take. 


Responsible-Changed-From-To: freebsd-doc->wblock 
Responsible-Changed-By: wblock 
Responsible-Changed-When: Fri Apr 11 16:11:12 UTC 2014 
Responsible-Changed-Why:  
Reorganized version of patch committed.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=187321 
>Unformatted:
