From owner-freebsd-doc  Sun Jul  2 11:20: 3 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 08D4A37BE22
	for <freebsd-doc@freebsd.org>; Sun,  2 Jul 2000 11:20:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id LAA34658;
	Sun, 2 Jul 2000 11:20:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id DA77337BE15; Sun,  2 Jul 2000 11:14:47 -0700 (PDT)
Message-Id: <20000702181447.DA77337BE15@hub.freebsd.org>
Date: Sun,  2 Jul 2000 11:14:47 -0700 (PDT)
From: jblaine@mitre.org
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/19648: handbook mentions stripping kernel.debug, but this is done for you
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         19648
>Category:       docs
>Synopsis:       handbook mentions stripping kernel.debug, but this is done for you
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 02 11:20:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Jeff Blaine
>Release:        4.0-RELEASE
>Organization:
The MITRE Corporation
>Environment:
FreeBSD kickflop 4.0-RELEASE FreeBSD 4.0-RELEASE #4: Sun Jul  2 12:37:52 EDT 2000     root@kickflop:/usr/src/sys/compile/BUNK  i386
>Description:
In the section of the handbook regarding debugging kernel dumps,
the directions tell you to enable 'makeoptions DEBUG=-g' in your
/usr/src/sys/BLAH kernel config file, build the new kernel, and then
strip it.  When I built my kernel with -g, the kernel was stripped
as a final part of the make process.
>How-To-Repeat:
Build a 4.0-RELEASE kernel with 'makeoptions DEBUG=-g' and examine
the final line of the build process.
>Fix:
Remove the following paragraph from the appropriate handbook section:

=======================================================================
When the kernel has been built make a copy of it, say kernel.debug, and then run strip -g 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.
=======================================================================

Additionally, change the following text to refer to 'kernel' and not
'kernel.debug':

======================================================================
Now, after a crash dump, go to /sys/compile/WHATEVER and run kgdb. From kgdb do:

    symbol-file kernel.debug
    exec-file /var/crash/kernel.0
    core-file /var/crash/vmcore.0
======================================================================

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message