git: af1d86cfac25 - stable/13 - ddb(4): document some missing commands

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Mon, 05 Dec 2022 16:47:39 UTC
The branch stable/13 has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=af1d86cfac259f9befd38ec0a51b977a8a4469c7

commit af1d86cfac259f9befd38ec0a51b977a8a4469c7
Author:     Mitchell Horne <mhorne@FreeBSD.org>
AuthorDate: 2022-11-11 18:22:29 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2022-12-05 16:44:05 +0000

    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
    
    (cherry picked from commit 831979ae0fb91a2ff674b7b1ab7d2c252a17e27d)
---
 share/man/man4/ddb.4 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/share/man/man4/ddb.4 b/share/man/man4/ddb.4
index 378978053cb4..db5b59f4e8f0 100644
--- a/share/man/man4/ddb.4
+++ b/share/man/man4/ddb.4
@@ -538,6 +538,14 @@ Switch the debugger to the thread with ID
 if the argument is a decimal number, or address
 .Ar addr ,
 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
 .Ss SPECIALIZED HELPER COMMANDS
 .Bl -tag -width indent -compact
@@ -549,6 +557,10 @@ Prints the address of the thread whose kernel-mode stack contains
 .Ar addr ,
 if any.
 .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 ps Ns Op Li / Ns Cm a
 Display all process information.
@@ -602,6 +614,15 @@ addresses, and Resource IDs.
 Dump data about APIC IDT vector mappings.
 .\"
 .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
 Show breakpoints set with the "break" command.
 .\"
@@ -723,6 +744,13 @@ present at
 .Ar addr .
 .\"
 .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
 Show brief information about each inodedep structure.
 If
@@ -750,6 +778,22 @@ Dump the interrupt statistics.
 Show interrupt lines and their respective kernel threads.
 .\"
 .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
 Show information from the local APIC registers for this CPU.
 .\"
@@ -1172,6 +1216,10 @@ subsystem.
 .Pp
 .Ss OFFLINE DEBUGGING COMMANDS
 .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
 Switches to remote GDB mode.
 In remote GDB mode, another machine is required that runs