ddb(4): document some missing commands

This is not exhaustive, just what I collected while working on
mac_ddb(4).

Reviewed by:	pauamma, markj, jhb
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation (in part)
Differential Revision:	https://reviews.freebsd.org/D37333
This commit is contained in:
Mitchell Horne 2022-11-11 14:22:29 -04:00
parent 94f6ee56e3
commit 831979ae0f

View File

@ -538,6 +538,14 @@ Switch the debugger to the thread with ID
if the argument is a decimal number, or address if the argument is a decimal number, or address
.Ar addr , .Ar addr ,
otherwise. otherwise.
.Pp
.It Ic watchdog Op Ar exp
Program the
.Xr watchdog 4
timer to fire in
.Pf 2^ Ar exp
seconds.
If no argument is provided, the watchdog timer is disabled.
.El .El
.Ss SPECIALIZED HELPER COMMANDS .Ss SPECIALIZED HELPER COMMANDS
.Bl -tag -width indent -compact .Bl -tag -width indent -compact
@ -549,6 +557,10 @@ Prints the address of the thread whose kernel-mode stack contains
.Ar addr , .Ar addr ,
if any. if any.
.Pp .Pp
.It Ic show Cm active trace
.It acttrace
Show a stack trace for every thread running on a CPU.
.Pp
.It Ic show Cm all procs Ns Op Li / Ns Cm a .It Ic show Cm all procs Ns Op Li / Ns Cm a
.It Ic ps Ns Op Li / Ns Cm a .It Ic ps Ns Op Li / Ns Cm a
Display all process information. Display all process information.
@ -602,6 +614,15 @@ addresses, and Resource IDs.
Dump data about APIC IDT vector mappings. Dump data about APIC IDT vector mappings.
.\" .\"
.Pp .Pp
.It Ic show Cm badstacks
Walk the
.Xr witness 4
graph and print any lock-order violations.
This command is only available if
.Xr witness 4
is included in the kernel.
.\"
.Pp
.It Ic show Cm breaks .It Ic show Cm breaks
Show breakpoints set with the "break" command. Show breakpoints set with the "break" command.
.\" .\"
@ -723,6 +744,13 @@ present at
.Ar addr . .Ar addr .
.\" .\"
.Pp .Pp
.It Ic show Cm iosched Ar addr
Show information about the I/O scheduler
.Vt struct cam_iosched_softc
located at
.Ar addr .
.\"
.Pp
.It Ic show Cm inodedeps Op Ar addr .It Ic show Cm inodedeps Op Ar addr
Show brief information about each inodedep structure. Show brief information about each inodedep structure.
If If
@ -750,6 +778,22 @@ Dump the interrupt statistics.
Show interrupt lines and their respective kernel threads. Show interrupt lines and their respective kernel threads.
.\" .\"
.Pp .Pp
.It Ic show Cm ktr Ns Op Li / Ns Cm a Ns Cm v Ns Cm V
Print the contents of the
.Xr ktr 4
trace buffer.
The
.Cm v
modifier will request fully verbose output, causing the file, line number, and
timestamp to be printed for each trace entry.
The
.Cm V
modifier will request only the timestamps to be printed.
The
.Cm a
modifier will request that the output be unpaginated.
.\"
.Pp
.It Ic show Cm lapic .It Ic show Cm lapic
Show information from the local APIC registers for this CPU. Show information from the local APIC registers for this CPU.
.\" .\"
@ -1170,6 +1214,10 @@ subsystem.
.El .El
.Ss OFFLINE DEBUGGING COMMANDS .Ss OFFLINE DEBUGGING COMMANDS
.Bl -tag -width indent -compact .Bl -tag -width indent -compact
.It Ic dump
Initiate a kernel core dump to the device(s) configured by
.Xr dumpon 8 .
.Pp
.It Ic gdb .It Ic gdb
Switches to remote GDB mode. Switches to remote GDB mode.
In remote GDB mode, another machine is required that runs In remote GDB mode, another machine is required that runs