From nobody@FreeBSD.org  Sun Apr 29 16:56:15 2012
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 A192C1065679
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Apr 2012 16:56:15 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 8CF978FC1E
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Apr 2012 16:56:15 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q3TGuFYH096681
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Apr 2012 16:56:15 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q3TGuFHr096680;
	Sun, 29 Apr 2012 16:56:15 GMT
	(envelope-from nobody)
Message-Id: <201204291656.q3TGuFHr096680@red.freebsd.org>
Date: Sun, 29 Apr 2012 16:56:15 GMT
From: Robert Simmons <rsimmons0@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: geli(8) needs to mention unencrypted /etc/fstab requirement for encrypted root
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         167429
>Category:       docs
>Synopsis:       geli(8) needs to mention unencrypted /etc/fstab requirement for encrypted root
>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:   Sun Apr 29 17:00:26 UTC 2012
>Closed-Date:    
>Last-Modified:  Sun Sep 02 03:09:18 UTC 2012
>Originator:     Robert Simmons
>Release:        9.0-RELEASE
>Organization:
>Environment:
FreeBSD test 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Jan  3 07:46:30 UTC 2012  root@farrell.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  amd64
>Description:
If you want to boot from an encrypted root partition that is encrypted using geli, you must boot from an unencrypted partition that includes a /boot/ directory and /etc/fstab.

The geli(8) man page mentions the /boot/ directory requirement, but omits the /etc/fstab
>How-To-Repeat:
Install FreeBSD onto a geli encrypted provider that was created with "geli init -b"

Then copy only the /boot/ directory to the unencrypted area that you will use to boot.

Boot the machine, and see the errors where it can't find the / partition to decrypt.
>Fix:
I have attached a patch that mentions the /etc/fstab requirement in the geli(8) man page.

Patch attached with submission follows:

--- src/sbin/geom/class/eli/geli.8	2012-04-28 16:23:13.000000000 -0400
+++ src.new/sbin/geom/class/eli/geli.8	2012-04-29 12:32:31.000000000 -0400
@@ -268,7 +268,9 @@
 This makes it possible to use an encrypted root partition.
 One will still need bootable unencrypted storage with a
 .Pa /boot/
-directory, which can be a CD-ROM disc or USB pen-drive, that can be removed
+directory and
+.Pa /etc/fstab .
+This can be a CD-ROM disc or USB pen-drive which can be removed
 after boot.
 .It Fl B Ar backupfile
 File name to use for metadata backup instead of the default


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Sun Apr 29 17:47:54 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=167429 
Responsible-Changed-From-To: eadler->freebsd-doc 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Sun Sep 2 03:09:17 UTC 2012 
Responsible-Changed-Why:  
I won't be looking at this PR for a while and I need to clear some out 
of my queue 

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