From nobody@FreeBSD.org  Sat Mar 20 07:32:01 2010
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 07FCD106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Mar 2010 07:32:01 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id EC5C68FC08
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Mar 2010 07:32:00 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o2K7W0aJ067867
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Mar 2010 07:32:00 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o2K7W0M7067866;
	Sat, 20 Mar 2010 07:32:00 GMT
	(envelope-from nobody)
Message-Id: <201003200732.o2K7W0M7067866@www.freebsd.org>
Date: Sat, 20 Mar 2010 07:32:00 GMT
From: Aiza <aiza21@comclark.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: handbook section 18.16.1 Disk Encryption with gbde. is outdated.
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         144893
>Category:       docs
>Synopsis:       [handbook] handbook section 18.16.1 Disk Encryption with gbde. is outdated.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       handbook
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 20 07:40:02 UTC 2010
>Closed-Date:    Mon Sep 06 02:02:35 UTC 2010
>Last-Modified:  Mon Sep 06 02:02:35 UTC 2010
>Originator:     Aiza
>Release:        8.0 release
>Organization:
none
>Environment:
>Description:
Handbook section 18.16.1 Disk Encryption with gbde. Starts off with these two itens.

2. Add gbde(4) Support to the Kernel Configuration File

Add the following line to the kernel configuration file:

options GEOM_BDE

Rebuild the kernel as described in Chapter 8.

Reboot into the new kernel.

3. An alternative to recompiling the kernel is to use kldload to load gbde(4):

# kldload geom_bde

***Items 2 & 3 can be deleted as gbde is now part of the base release ****

The newfs -U -O2 /dev/ad4s1c.bde command is incorrect in item number 
5. Create a File System on the Encrypted Device. It should be replaced with this
newfs -U -O2 -o space /dev/ad4s1c.bde command where -O2 is a uppercase O and -o space is an lower case o. Point out the uppercase lowercase usage because its impossible to tell from command as shown in handbook.

Also the content of man gbde needs updating to remove all reference to experimental code.

Section 18.16.2 Disk Encryption with geli item (1. Adding geli Support to the Kernel) can be removed because geli is now part of the base release.


>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: brd 
State-Changed-When: Mon Sep 6 01:54:44 UTC 2010 
State-Changed-Why:  
Even as part of the base release, GBDE & GELI still need to be loaded as either a kernel module or compiled directily into the kernel. The newfs command has changed and is not present in the form you mention anymore. Thanks for your submission. 

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