Bug 144893

Summary: [handbook] handbook section 18.16.1 Disk Encryption with gbde. is outdated.
Product: Documentation Reporter: aiza <aiza21>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description aiza 2010-03-20 07:40:02 UTC 
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.
Comment 1 Brad Davis freebsd_committer freebsd_triage 2010-09-06 02:54:44 UTC 
State Changed
From-To: open->closed

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.