From nobody Mon Dec 5 16:47:39 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 4NQqGh2qFHz4k7y6; Mon, 5 Dec 2022 16:47:40 +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 4NQqGg6BG8z41XF; Mon, 5 Dec 2022 16:47:39 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670258859; 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=oC3XNCjJYTRIsLMHnCMFTfFe0/tOPo1qjThwEciQ0rU=; b=JA83TqrGuaoRz9WZAUMoyTITSzuk/NKiTjolvWw6htLKiDAV3/sc8Oh70b8N5Te9oS83Yv Ni5vnvP1voPdJWEQT039yb/x/G0Jth9JfIWNXg0oVzT4LjoQgcNFGKKKSsKBenNm+Q3szj BaRB742UmnWgWOR5pcjj5t+BnO9OmTzo3i3iNUZLuJRVfTImq4kto2szKJmTH/uzmfDqcs nM/c6Y4c5KQgyebYvSgYmRBo+G/GAqEhP5jwYvoEUCeaE06+MgBseCyAMDQCLsPmJn+P7U iAMUZY4Xa/QQPUdAqF+dR0KrgB2qCZtGH27TI1NtejgmCUzuLW46Z65S3a4D1Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670258859; 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=oC3XNCjJYTRIsLMHnCMFTfFe0/tOPo1qjThwEciQ0rU=; b=C26U2hNJxiR/7+9/AT9CsaErli7NwUwk1EnFmLQFKe+v3nDycq7h4jjMOt4PBS3HjJmIkj IGBdGzPITH+EiQzhTRClERu0G+Ak5LSaTu/WOiCBHJBAXS5nQ1AP/c25J5gLYT3rqkGbYA rcO1HXnHE+cyxQbwbVCc4M6BYB3sQihr+UWT+wLoc55SBpzOFHA/C3fhyoNx7FvjVNLxwx Kid7dFTSDqLPnmyeJFSPXAEa0FPgv6POTTV/XlfjOTq9SBdP+Dw6p79drQNBLeMEHc76G6 tflrFjOqq8q/IzftPTF9zFOEe3ArLzgXlO+36p124ueGNn7SbB2FtXfQ2h8tLw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1670258859; a=rsa-sha256; cv=none; b=b+83U9bv/uWGCU19enHhdFK+frlm8Y4OJoZN3lwcRsLrciDvjSf6HMDp/Cs0Lm+2sn5yjq tElsZrp9vmClL3q1sMHx4XqkHABWAIpdA0ArqLUNa9ynx8FDXfdeq3RVGZooRITTDo0LHx SfE/I/cPON9QRsYEf6GKxkDVOx2uThLsYNKNQwvRjc7F+4DStjjjWLj66+/dqztuZ5GXga xFHSXEAdCcMMqPl5ea5KOckjzO8qmxc5koN7PnjzVWYfRP8sarAV63srB0Nc9CqWD2Qzb3 XPrfGI2cxNChofDgD9/k8p+NlS0yhbLq2cwJtzPGn9L/2CfDzZMYiiVjZ5C4+A== 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 4NQqGg5Fmtz14TV; Mon, 5 Dec 2022 16:47:39 +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 2B5GldES053969; Mon, 5 Dec 2022 16:47:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2B5GldGM053968; Mon, 5 Dec 2022 16:47:39 GMT (envelope-from git) Date: Mon, 5 Dec 2022 16:47:39 GMT Message-Id: <202212051647.2B5GldGM053968@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mitchell Horne Subject: git: af1d86cfac25 - stable/13 - 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/stable/13 X-Git-Reftype: branch X-Git-Commit: af1d86cfac259f9befd38ec0a51b977a8a4469c7 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=af1d86cfac259f9befd38ec0a51b977a8a4469c7 commit af1d86cfac259f9befd38ec0a51b977a8a4469c7 Author: Mitchell Horne AuthorDate: 2022-11-11 18:22:29 +0000 Commit: Mitchell Horne 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