d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document the debug.debugger_on_panic tunable, for those poor souls

Browse Source 
who didn't realize that DDB_UNATTENDED just sets its starting
value.

This change is over 5 years late, and documents the original
semantics of debug.debugger_on_panic, which may have been changed
by the (again undocumented) change in rev 1.44 of kern_shutdown.c.
This commit is contained in:
sheldonh 2001-07-30 22:03:58 +00:00
parent d67a26493a
commit 94454e4a22
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
share/man/man4/ddb.4
View File

@ -66,6 +66,10 @@
.Nd interactive kernel debugger
.Sh SYNOPSIS
.Cd options DDB
.Pp
To prevent activation of the debugger on kernel
.Xr panic 9 :
.Cd options DDB_UNATTENDED
.Sh DESCRIPTION
The
.Nm
@ -73,6 +77,22 @@ kernel debugger has most of the features of the old kdb,
but with a more rational syntax
inspired by
.Xr gdb 1 .
If linked into the running kernel,
it can be invoked locally with the
.Ql debug
.Xr keymap 5
action.
The debugger is also invoked on kernel
.Xr panic 9
if the
.\" XXX sysctl markup?
.Li debug.debugger_on_panic
.Xr sysctl 8
MIB variable is set non-zero,
which is the default
unless the
.Dv DDB_UNATTENDED
option is specified.
.Pp
The current location is called `dot'. The `dot' is displayed with
a hexadecimal format at a prompt.