From owner-freebsd-doc@FreeBSD.ORG Sun Apr 29 17:00:26 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id DBA8D106566B for ; Sun, 29 Apr 2012 17:00:26 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A9BCA8FC0C for ; Sun, 29 Apr 2012 17:00:26 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q3TH0Q1T014690 for ; Sun, 29 Apr 2012 17:00:26 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q3TH0QO0014680; Sun, 29 Apr 2012 17:00:26 GMT (envelope-from gnats) Resent-Date: Sun, 29 Apr 2012 17:00:26 GMT Resent-Message-Id: <201204291700.q3TH0QO0014680@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Robert Simmons Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A192C1065679 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/167429: geli(8) needs to mention unencrypted /etc/fstab requirement for encrypted root X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Apr 2012 17:00:27 -0000 >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: >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: >Unformatted: