docs/187321: Clarification needed on using geli rc.d script

[Jack-Benny Persson]

>Number:         187321
>Category:       docs
>Synopsis:       Clarification needed on using geli rc.d script
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 06 17:30:01 UTC 2014
>Closed-Date:
>Last-Modified:
>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:
>Unformatted: