docs/187321: [handbook] [patch] Clarification needed on using geli rc.d script

[Allan Jude]

The following reply was made to PR docs/187321; it has been noted by GNATS.

From: Allan Jude <freebsd at allanjude.com>
To: bug-followup at FreeBSD.org, jack-benny at 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--