From owner-freebsd-doc  Mon Dec  3 16:50: 8 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 74E3F37B417
	for <freebsd-doc@freebsd.org>; Mon,  3 Dec 2001 16:50:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id fB40o1P87356;
	Mon, 3 Dec 2001 16:50:01 -0800 (PST)
	(envelope-from gnats)
Received: from mailman.packetdesign.com (dns.packetdesign.com [65.192.41.10])
	by hub.freebsd.org (Postfix) with ESMTP id 2549237B416
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  3 Dec 2001 16:40:10 -0800 (PST)
Received: from bubba.packetdesign.com (bubba.packetdesign.com [192.168.0.223])
	by mailman.packetdesign.com (8.11.0/8.11.0) with ESMTP id fB40e9525698
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 3 Dec 2001 16:40:09 -0800 (PST)
	(envelope-from archie@packetdesign.com)
Received: (from archie@localhost)
	by bubba.packetdesign.com (8.11.6/8.11.6) id fB40e9R31087;
	Mon, 3 Dec 2001 16:40:09 -0800 (PST)
	(envelope-from archie)
Message-Id: <200112040040.fB40e9R31087@bubba.packetdesign.com>
Date: Mon, 3 Dec 2001 16:40:09 -0800 (PST)
From: Archie Cobbs <archie@packetdesign.com>
Reply-To: Archie Cobbs <archie@packetdesign.com>
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: docs/32483: developers handbook should mention debug.enter_debugger
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         32483
>Category:       docs
>Synopsis:       developers handbook should mention debug.enter_debugger
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 03 16:50:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Archie Cobbs
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
Packet Design
>Environment:
System: FreeBSD bubba.packetdesign.com 4.4-STABLE FreeBSD 4.4-STABLE #1: Mon Oct 22 15:26:21 PDT 2001 root@:/usr/obj/usr/src/sys/BUBBA i386

>Description:

	The FreeBSD developer's handbook, in the chapter on kernel
	debugging, in the sections "On-line Kernel Debugging..."
	it doesn't seem to mention that there is a very easy way
	to make the kernel drop into DDB or GDB from the command line.

	You simply say one of these commands:

		$ sysctl -w debug.enter_debugger=ddb

	or

		$ sysctl -w debug.enter_debugger=gdb

	and the kernel immediately drops into the debugger.

	Often it's more convenient to let a system boot fully
	and then do the above gdb command that trying to rig up
	gdb from the boot prompt.

>How-To-Repeat:

>Fix:


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

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