Changeset View
Changeset View
Standalone View
Standalone View
share/man/man4/ddb.4
Show All 20 Lines | |||||
.\" Carnegie Mellon University | .\" Carnegie Mellon University | ||||
.\" Pittsburgh PA 15213-3890 | .\" Pittsburgh PA 15213-3890 | ||||
.\" | .\" | ||||
.\" any improvements or extensions that they make and grant Carnegie Mellon | .\" any improvements or extensions that they make and grant Carnegie Mellon | ||||
.\" the rights to redistribute these changes. | .\" the rights to redistribute these changes. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd January 26, 2021 | .Dd March 14, 2021 | ||||
.Dt DDB 4 | .Dt DDB 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ddb | .Nm ddb | ||||
.Nd interactive kernel debugger | .Nd interactive kernel debugger | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
In order to enable kernel debugging facilities include: | In order to enable kernel debugging facilities include: | ||||
.Bd -ragged -offset indent | .Bd -ragged -offset indent | ||||
▲ Show 20 Lines • Show All 1,528 Lines • ▼ Show 20 Lines | |||||
at run-time by setting the | at run-time by setting the | ||||
.Xr sysctl 8 | .Xr sysctl 8 | ||||
.Va debug.kdb.alt_break_to_debugger | .Va debug.kdb.alt_break_to_debugger | ||||
to 1. | to 1. | ||||
The debugger may be entered by setting the | The debugger may be entered by setting the | ||||
.Xr sysctl 8 | .Xr sysctl 8 | ||||
.Va debug.kdb.enter | .Va debug.kdb.enter | ||||
to 1. | to 1. | ||||
.Pp | |||||
Output may be interrupted, paused, and resumed with the control | |||||
characters CTRL-C, CTRL-S, and CTRL-Q. | |||||
markj: New sentences should start on new lines, ditto below. | |||||
Because these control characters are received as in-band data from the | |||||
console, there is an input buffer, and once that buffer fills | |||||
.Nm | |||||
must either stop responding to control characters or drop additional | |||||
input while continuing to search for control characters. | |||||
This behavior is controlled by the tunable | |||||
.Xr sysctl 8 | |||||
.Va debug.ddb.prioritize_control_input , | |||||
which defaults to 1. | |||||
The input buffer size is 512 bytes. | |||||
.Sh FILES | .Sh FILES | ||||
Header files mentioned in this manual page can be found below | Header files mentioned in this manual page can be found below | ||||
.Pa /usr/include | .Pa /usr/include | ||||
directory. | directory. | ||||
.Pp | .Pp | ||||
.Bl -dash -compact | .Bl -dash -compact | ||||
.It | .It | ||||
.Pa sys/buf.h | .Pa sys/buf.h | ||||
Show All 38 Lines |
New sentences should start on new lines, ditto below.