aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books
diff options
context:
space:
mode:
authorNik Clayton <nik@FreeBSD.org>1999-12-16 01:58:47 +0000
committerNik Clayton <nik@FreeBSD.org>1999-12-16 01:58:47 +0000
commit92cd1613b317ad10603f5e08ed652e1f98077a04 (patch)
treee385d174fc77d08e92cb6e953038e43198691b84 /en_US.ISO8859-1/books
parentf1149f86ae5f07dafe7baaff223c6af53ffa51b4 (diff)
downloaddoc-92cd1613b317ad10603f5e08ed652e1f98077a04.tar.gz
doc-92cd1613b317ad10603f5e08ed652e1f98077a04.zip
Update the information about building a debugging kernel. Remove the
individual steps, and replace with "make install". Update the following note to explain that kernel is installed, while kernel.debug remains as a source of debugging symbols for gdb(1). PR: docs/14426 Submitted by: Bruce Mah <bmah@acm.org>
Notes
Notes: svn path=/head/; revision=6190
Diffstat (limited to 'en_US.ISO8859-1/books')
-rw-r--r--en_US.ISO8859-1/books/faq/book.sgml36
1 files changed, 9 insertions, 27 deletions
diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index ab1956d1e2..1da4beb455 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -10,7 +10,7 @@
</author>
</authorgroup>
-<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.25 1999/11/25 09:08:54 obrien Exp $</pubdate>
+<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.26 1999/12/14 17:01:19 nik Exp $</pubdate>
<abstract><para> This is the FAQ for FreeBSD versions 2.X and 3.X. All entries are
assumed to be relevant to FreeBSD 2.0.5 and later, unless otherwise noted.
@@ -8075,19 +8075,7 @@ some kind.)</para>
</listitem>
<listitem>
-<para><emphasis remap=tt>cp kernel kernel.debug</emphasis></para>
-</listitem>
-
-<listitem>
-<para><command>strip -d kernel</command></para>
-</listitem>
-
-<listitem>
-<para><emphasis remap=tt>mv </emphasis>kernel /kernel.orig/</para>
-</listitem>
-
-<listitem>
-<para><command>cp kernel /</command></para>
+<para><command>make install</command></para>
</listitem>
<listitem>
@@ -8096,19 +8084,13 @@ some kind.)</para>
</itemizedlist>
</para>
-
-<para> <emphasis>[Note: Now that FreeBSD 3.x kernels are Elf by default,
-you should use <command>strip -g</command> instead of <command>strip -d</command>. If for some
-reason your kernel is still a.out, use <command>strip -aout -d</command>.]</emphasis></para>
-
-<para> Note that YOU DO <acronym>NOT</acronym> WANT TO ACTUALLY BOOT THE KERNEL
-WITH ALL THE DEBUG SYMBOLS IN IT. A kernel compiled with <option>-g</option>
-can easily be close to 10MB in size. You don't have to actually
-boot this massive image: you only need it later for <command>gdb(1)</command>
-(<command>gdb(1)</command> wants the symbol table). Instead, you want to keep
-a copy of the full image and create a second image with the
-debug symbols stripped out using <command>strip -d</command>. It is this
-second stripped image that you want to boot.</para>
+
+ <para>The &man.make.1; process will have built two kernels.
+ <filename>kernel</filename> and
+ <filename>kernel.debug</filename>. <filename>kernel</filename>
+ was installed as <filename>/kernel</filename>, while
+ <filename>kernel.debug</filename> can be used as the source of
+ debugging symbols for gdb(1).</para>
<para> To make sure you capture a crash dump, you need edit
<filename>/etc/rc.conf</filename> and set <emphasis remap=tt>dumpdev</emphasis> to point to your swap