docs/113695: handbook suggests different lockfile than gbde(8) manpage

[bill fumerola]

>Number:         113695
>Category:       docs
>Synopsis:       handbook suggests different lockfile than gbde(8) manpage
>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 Jun 14 22:50:04 GMT 2007
>Closed-Date:
>Last-Modified:
>Originator:     bill fumerola
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
powerset, inc.
>Environment:
System: FreeBSD molasses 7.0-CURRENT FreeBSD 7.0-CURRENT #1: Mon Jun 11 16:45:47 UTC 2007 root at molasses:/usr/obj/usr/src/sys/BUFU i386


>Description:

the 'disks-encrypting' section suggests creating a gbde partition
lock as /etc/gbde/ad4s1c, the gbde manpage suggests /etc/gbde/ad4s1c.lock,
and /etc/rc.d/gbde looks for /etc/gbde/PARTITION.lock

following the handbook's advice, one will not be able to use the
rc.conf/rc.d system to mount a gbde file system.

additionally, the handbook suggests the 'c' partition (the magic whole disk),
while the manpage suggests using a 'real' partition. the author of this
PR found that using the 'c' partition didn't work


>How-To-Repeat:

follow the GBDE instructions in the handbook, section 18.16

>Fix:

(*) change the handbook to use the 'a' partition in its example (as it will
exist after following the instructions on adding a new drive (section 18.3)

(*) change the handbook to instruct users to create the lockfile with the
.lock suffix

>Release-Note:
>Audit-Trail:
>Unformatted: