From 92cd1613b317ad10603f5e08ed652e1f98077a04 Mon Sep 17 00:00:00 2001 From: Nik Clayton 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 --- 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 @@ -$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.25 1999/11/25 09:08:54 obrien Exp $ +$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.26 1999/12/14 17:01:19 nik Exp $ 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.) -cp kernel kernel.debug - - - -strip -d kernel - - - -mv kernel /kernel.orig/ - - - -cp kernel / +make install @@ -8096,19 +8084,13 @@ some kind.) - - [Note: Now that FreeBSD 3.x kernels are Elf by default, -you should use strip -g instead of strip -d. If for some -reason your kernel is still a.out, use strip -aout -d.] - - Note that YOU DO NOT WANT TO ACTUALLY BOOT THE KERNEL -WITH ALL THE DEBUG SYMBOLS IN IT. A kernel compiled with -can easily be close to 10MB in size. You don't have to actually -boot this massive image: you only need it later for gdb(1) -(gdb(1) 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 strip -d. It is this -second stripped image that you want to boot. + + The &man.make.1; process will have built two kernels. + kernel and + kernel.debug. kernel + was installed as /kernel, while + kernel.debug can be used as the source of + debugging symbols for gdb(1). To make sure you capture a crash dump, you need edit /etc/rc.conf and set dumpdev 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 @@ -$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.25 1999/11/25 09:08:54 obrien Exp $ +$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.26 1999/12/14 17:01:19 nik Exp $ 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.) -cp kernel kernel.debug - - - -strip -d kernel - - - -mv kernel /kernel.orig/ - - - -cp kernel / +make install @@ -8096,19 +8084,13 @@ some kind.) - - [Note: Now that FreeBSD 3.x kernels are Elf by default, -you should use strip -g instead of strip -d. If for some -reason your kernel is still a.out, use strip -aout -d.] - - Note that YOU DO NOT WANT TO ACTUALLY BOOT THE KERNEL -WITH ALL THE DEBUG SYMBOLS IN IT. A kernel compiled with -can easily be close to 10MB in size. You don't have to actually -boot this massive image: you only need it later for gdb(1) -(gdb(1) 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 strip -d. It is this -second stripped image that you want to boot. + + The &man.make.1; process will have built two kernels. + kernel and + kernel.debug. kernel + was installed as /kernel, while + kernel.debug can be used as the source of + debugging symbols for gdb(1). To make sure you capture a crash dump, you need edit /etc/rc.conf and set dumpdev to point to your swap