From nobody Fri Nov 11 18:26:27 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4N86bm1JHBz4dZ4k; Fri, 11 Nov 2022 18:26:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4N86bl6L0yz3qy4; Fri, 11 Nov 2022 18:26:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1668191187; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Y6Re9vJF0TcxHp1AD87xD9pv9mwvtRub/hbeikHPEyE=; b=x2pnmEpIW0e9/JqjKTecREmIQwoVAzkHTEf1W/iOs32rFUEKdo/Dmt5Ee7AiUy9PHF9MD0 71sag9/3Sov0rSjtwxAPk9TEbPUuDPb0erq0sBDeLa1IEnf471mqNvssP0XjvajL3lmK0J FBHXjLSbcSXuUy9KbNjZXE0JSaGqMSWOw8/3xXp5sXMbzGX9eNllnNpvgCbJob3JnXvAfJ 9nNOu5Gf9E5nrNN2mN3seoeeLG5a7wuv5yjtFaPl+RFyIRuhk0eds66IhSguqby3B2ukFb Dr/WBDK1tz0zGEAibRNQw13wzVZhYXU50RyGXacYRUzpnWLli0UEzm8FW6Zp2g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1668191187; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Y6Re9vJF0TcxHp1AD87xD9pv9mwvtRub/hbeikHPEyE=; b=e9eQKj49d5J+VrR1QPHPLBzyP/vlTyoYixuaVdq/wFoiSO86IgyTHIHGKLtd7gePm5HhKg pzm8mfXA4uJOZ7x4v9p35ka0tVmCKojGB2GezZ8fsOzFOy3GxdxCVGNAD/9cm3m+m83xXL vrFelKU3wrAJwGcJnOHiMGnIGEGyF4nyvOCIqgnOnc+t4ZUmhM8vtXP5YVPki3pa8qh2xU bmJlPs7PLldTF5PnY9QtLlzMFpE4wClburfhyOHCjGZSo9nbg98YBZohYaW9lA3//vWDMy g0vH/q2ddMoxPcORQduwq76JPMQ60wQ25p0a6FRpkRx8a+5wkMti43AH1d2T/Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1668191187; a=rsa-sha256; cv=none; b=xNYDbQBCWZ+Swfw9kgbv1b8RoBGBk/dUv3138i4712lbr4tDAe9JCO7E08bFaxxmhghVR9 7knUq1Yt4awMZV836j3hA+Zbl9dkv+p5/j4dXfybWxQOBZb0ThWZKEFJGMFcbxHIdo7o8f GPFka51DPp2ww/LXgnLG8Be8UyJmToysNmyi5LV4acH177/o4bi4uaNpmAJS4h+ROAkb/W 1+VxpYRDNEEg6jbdp1qFDkKfjqNcyaY0qEBN/R1/mO/ndi6LrPlfOn7UJ2MJyqS4bfGoEQ XKXZDQ4Vv7pI/2tBv/z3BoS6JtBqWopkvZSKY6854QWJMNMeJ1oa3f2XcQtkbQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4N86bl58wHzspR; Fri, 11 Nov 2022 18:26:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 2ABIQRWL089384; Fri, 11 Nov 2022 18:26:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2ABIQRWq089383; Fri, 11 Nov 2022 18:26:27 GMT (envelope-from git) Date: Fri, 11 Nov 2022 18:26:27 GMT Message-Id: <202211111826.2ABIQRWq089383@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mitchell Horne Subject: git: 831979ae0fb9 - main - ddb(4): document some missing commands List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mhorne X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 831979ae0fb91a2ff674b7b1ab7d2c252a17e27d Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=831979ae0fb91a2ff674b7b1ab7d2c252a17e27d commit 831979ae0fb91a2ff674b7b1ab7d2c252a17e27d Author: Mitchell Horne AuthorDate: 2022-11-11 18:22:29 +0000 Commit: Mitchell Horne CommitDate: 2022-11-11 18:25:39 +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 --- 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 cd7cecca4d61..7d5da91fc684 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. .\" @@ -1170,6 +1214,10 @@ subsystem. .El .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