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>
This commit is contained in:
Nik Clayton
parent
f1149f86ae
commit
92cd1613b3
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=6190
2 changed files with 18 additions and 54 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Reference in a new issue