Update the bit about stripping the kernel:

* stripping is done automatically now
* ELF kernels don't need to have the full debug symbol table loaded.

PR:		19648
Submitted by:	Jeff Blaine <jblaine@mitre.org>
Reviewed by:	grog, nik

1 files changed, 23 insertions, 8 deletions

diff --git a/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml b/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
index 12ce626731..3f531f70c7 100644
--- a/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/kerneldebug/chapter.sgml,v 1.23 2000/06/08 01:56:10 jim Exp $
+     $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/kerneldebug/chapter.sgml,v 1.24 2000/06/14 00:47:36 jim Exp $
 -->
 
 <chapter id="kerneldebug">
@@ -48,13 +48,28 @@
 	releases.</para>
     </note>
     
-    <para>When the kernel has been built make a copy of it, say
-      <filename>kernel.debug</filename>, and then run <command>strip
-	-g</command> on the original.  Install the original as normal.  You
-      may also install the unstripped kernel, but symbol table lookup time for
-      some programs will drastically increase, and since the whole kernel is
-      loaded entirely at boot time and cannot be swapped out later, several
-      megabytes of physical memory will be wasted.</para>
+    <tip>
+      <para>If you are using FreeBSD 3 or earlier, you should make a stripped
+        copy of the debug kernel, rather than installing the large debug
+        kernel itself:</para>
+
+      <screen>&prompt.root; <userinput>cp kernel kernel.debug</userinput>
+&prompt.root; <userinput>strip -g kernel</userinput></screen>
+
+      <para>This stage isn't necessary, but it is recommended.  (In
+        FreeBSD 4 and later releases this step is performed automatically
+        at the end of the kernel <command>make</command> process.)
+        When the kernel has been stripped, either automatically or by
+        using the commands above, you may install it as usual by typing
+        <command>make install</command>.</para>
+
+      <para>Note that older releases of FreeBSD (up to but not including
+        3.1) used a.out kernels by default, which must have their symbol
+        tables permanently resident in physical memory.  With the larger
+        symbol table in an unstripped debug kernel, this is wasteful.
+        Recent FreeBSD releases use ELF kernels where this is no longer a
+        problem.</para>
+    </tip>
 
     <para>If you are testing a new kernel, for example by typing the new
       kernel's name at the boot prompt, but need to boot a different one in