Bug 86733

Summary: [patch] handbook: add using kldload as an alternative to compiling in gbde in your kernel
Product: Documentation Reporter: Josh Paetzel <josh> <josh>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Josh Paetzel <josh@tcbug.org> 2005-09-29 23:20:14 UTC

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/disks-encrypting.html explains how to recompile your kernel with options GEOM_BDE but doesn't mention that there is a kernel module (geom_bde) available.

Fix: 

<para>Reboot into the new kernel.</para>
        </step>
+
+    <step>
+        <title>Load gbde(4) support using
+        <application>kldload</application>
+        </title>
+
+        <para>An alternative to recompiling your kernel is to use
+            <application>kldload</application> to load the gbde(4)
+            kernel module dynamically.
+            <screen>&prompt.root;
+                <userinput>kldload geom_bde
+                </userinput>
+            </screen>
+        </para>
+
+        <para>At this time there is no option in
+            <filename>/boot/loader.conf</filename>
+            to load the kernel module at boot time
+        </para>
       </procedure>
     </sect2>--AGhUvWdKRjcxVTLuaKWUDqbb8M0mZlOCFwGn7nPAXOQJjmK4
Content-Type: text/plain; name="file.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="file.diff"

--- chapter.sgml.old    Thu Sep 29 16:44:10 2005
+++ chapter.sgml        Thu Sep 29 17:02:02 2005
@@ -3543,6 +3543,25 @@
How-To-Repeat: 

Browse http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/disks-encrypting.html
Comment 1 David Adam 2005-09-30 02:22:47 UTC
Josh,

> +        <para>At this time there is no option in
> +            <filename>/boot/loader.conf</filename>
> +            to load the kernel module at boot time
> +        </para>

Don't forget the full stop (period) on the end of the sentence!

Otherwise, looks good. Is there really no loader.conf option? That kinda
sucks, although I can't volunteer to fix that!

David Adam
zanchey@ucc.gu.uwa.edu.au
Comment 2 Marc Fonvieille freebsd_committer freebsd_triage 2005-09-30 07:58:50 UTC
On Thu, Sep 29, 2005 at 05:16:01PM -0500, Josh Paetzel wrote:
> 
> 
> --- chapter.sgml.old    Thu Sep 29 16:44:10 2005
> +++ chapter.sgml        Thu Sep 29 17:02:02 2005
> @@ -3543,6 +3543,25 @@
> 
>           <para>Reboot into the new kernel.</para>
>         </step>
> +
> +    <step>
> +        <title>Load gbde(4) support using
> +        <application>kldload</application>
> +        </title>
> +
> +        <para>An alternative to recompiling your kernel is to use
> +            <application>kldload</application> to load the gbde(4)
> +            kernel module dynamically.
> +            <screen>&prompt.root;
> +                <userinput>kldload geom_bde
> +                </userinput>
> +            </screen>
> +        </para>
> +
> +        <para>At this time there is no option in
> +            <filename>/boot/loader.conf</filename>
> +            to load the kernel module at boot time
> +        </para>
>        </procedure>
>      </sect2>
>

Hello,

Since you submit PRs from time to time, you should have a look to the
FDP primer; it's impossible for us to use your patch like this (missing
tags, missing punctuation, mix of inline and block elements, wrong
"wrap-lines", indentation issues, misuse of SGML tags).

Marc
Comment 3 Simon L. B. Nielsen freebsd_committer freebsd_triage 2005-09-30 08:54:05 UTC
On 2005.09.29 17:16:01 -0500, Josh Paetzel wrote:
> 
> +        <para>At this time there is no option in
> +            <filename>/boot/loader.conf</filename>
> +            to load the kernel module at boot time
> +        </para>


Sure about that?  It's been a while since I played with gbde (now it's
just running) but I'm rather sure 'geom_bde_load="YES"' in loader.conf
works just fine.

I only have a 7.0 handy that I can reboot, but there it works just
fine loading gbde from loader.conf.

-- 
Simon L. Nielsen
Comment 4 Josh Paetzel <josh@tcbug.org> 2005-09-30 15:35:40 UTC
On Friday 30 September 2005 02:54, Simon L. Nielsen wrote:
> On 2005.09.29 17:16:01 -0500, Josh Paetzel wrote:
> > +        <para>At this time there is no option in
> > +            <filename>/boot/loader.conf</filename>
> > +            to load the kernel module at boot time
> > +        </para>
>
> Sure about that?  It's been a while since I played with gbde (now
> it's just running) but I'm rather sure 'geom_bde_load="YES"' in
> loader.conf works just fine.
>
> I only have a 7.0 handy that I can reboot, but there it works just
> fine loading gbde from loader.conf.

I see geom_bde.ko in /boot/kernel but it's not 
in /boot/default/loader.conf
This is on a 5.4 system.

-- 
Thanks,

Josh Paetzel
Comment 5 dfilter service freebsd_committer freebsd_triage 2006-11-04 11:03:02 UTC
trhodes     2006-11-04 11:02:41 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/disks chapter.sgml 
  Log:
  Add a note (step) showing that you can load gdbe using kldload(8);
  at this time there is no loader.conf variable in defaults/loader.conf in 6,
  note that.
  Remove some old cruft and reword near sentence to keep flow going smoothly.
  Two spaces between the end of a sentence and the beginning of a new sentence.
  
  PR:             86733
  Submitted by:   Josh Paetzel (patch rewritten by me)
  
  Revision  Changes    Path
  1.266     +16 -5     doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 6 Tom Rhodes freebsd_committer freebsd_triage 2006-11-04 11:03:03 UTC
State Changed
From-To: open->closed

Your patch was modified to fit document style and make it 
buildable.  You're right, there is no defaults/loader.conf 
option, so I left that information.  Thanks for the submission. 
In the future, to help your patches get committed, I recommend 
reading over the FDP. 


Comment 7 Tom Rhodes freebsd_committer freebsd_triage 2006-11-04 11:03:03 UTC
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me.