From 92cd1613b317ad10603f5e08ed652e1f98077a04 Mon Sep 17 00:00:00 2001 From: Nik Clayton <nik@FreeBSD.org> Date: Thu, 16 Dec 1999 01:58:47 +0000 Subject: [PATCH] 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> --- en_US.ISO8859-1/books/faq/book.sgml | 36 +++++++--------------------- en_US.ISO_8859-1/books/faq/book.sgml | 36 +++++++--------------------- 2 files changed, 18 insertions(+), 54 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 diff --git a/en_US.ISO_8859-1/books/faq/book.sgml b/en_US.ISO_8859-1/books/faq/book.sgml index ab1956d1e2..1da4beb455 100644 --- a/en_US.ISO_8859-1/books/faq/book.sgml +++ b/en_US.ISO_8859-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