From nobody Thu May 07 18:08:40 2026 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 4gBKxj1N3Nz6cx9C for ; Thu, 07 May 2026 18:08:41 +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 "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gBKxh6XGfz3sbH for ; Thu, 07 May 2026 18:08:40 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1778177320; 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=RV0o9z6B8GoXh6wSfIJGBTbavhJUwKHRbBob0pCxDyo=; b=FYCcu2XxC7WB4drpVIncW0YvGRYQIer4swBgjhIJUR6/69SeNC3JMjdFLLXzu3WWug+Y8e xpMNaPch9EBlH8LY4KlY6FSxo2BU7qbWGwyYu7CiF6INf7XvDDkC6u/Ntj3XkUd0R8FNjX mMRv7q2MAgtGEyS5B8HZVkz5aw9S5YMqL7ONcqTA1A+IotUlknClvV7SZYF2v4304CuS1N L4ICXAyqE24sF51uThHNkcerBS9o4saPWXkB5cKh1wD9SA+Qdi0vzCGa0qVQqi0iGRMYOM 2X4TG0E0YiI+DeUPe28aX+lBSMyBFcNVLqFsAA6rycirFZwlouV52SeQrlFzQg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1778177320; a=rsa-sha256; cv=none; b=TPrParZ7//CabFgHTWU3Fg/5INZzriWNkpskCp181q1SSo4UEr+T2ZE9QOdwf2q8VC7nkO +LdAMfAS/aKtt5/jYzSYAQ/tnS7s44XjubtSxvSDZpZeHLdGQusweyurapcBDxH1pbmklV lqiIW5ReOdpRynCekesqtnu+FsX6ug9NW6rcZ47lgjAHri40nvMj9nvqR+Dk8h5WZHb/dS 9/SOS5G0YstPblQPMAZ7xpwSGnqGFG1nvp2eA45yHp70+5+S3Fjq8PfYDGFcJaWQqJPEYh WU2S7o2mB+JU+mkReVW4yfEELtJmYm8G7t4wgZjjTuFHbDl5P2wtnqpjCWWglg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1778177320; 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=RV0o9z6B8GoXh6wSfIJGBTbavhJUwKHRbBob0pCxDyo=; b=PhB2ZsWZ9YKstAjjFUBgli9q3weVAI0owBdkZvJhpDhalmSa2yDVoc9PbN83U7rZuUAcKt 6DJA4nQ8+Zm0H9gQQpuroJDZWDOO9KNlqr9yMJ8q4W8lRrWsZjlb810YJnYcBxr9/uDwvm wKycxgSdlnD56vpeu/xtxgrgQicOPfkpsGYGwRsx8SquLNoE+tENvbkDCu5Dh8Q/Xul2W/ u4UpBXCt9DH/09Zu0bGu3Vb1cWM8PdTSnANrM2Eit+vDt/P4T7dAtmrsRlyYnFX71KENPX 74yoh7e6chmMEjhoXn6yCOpZVE3BhvWc1e/yNHbC9G/Xi+cIVh3KyIemw8lWGg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gBKxh4ZP4zdTW for ; Thu, 07 May 2026 18:08:40 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3fe37 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 07 May 2026 18:08:40 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: John Hall Subject: git: e9912b7e88e7 - main - smartpqi.4: Document runtime debug_level sysctl 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: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jrhall X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e9912b7e88e7d66c0ab5fec1cfe61dcd18377166 Auto-Submitted: auto-generated Date: Thu, 07 May 2026 18:08:40 +0000 Message-Id: <69fcd528.3fe37.163a645@gitrepo.freebsd.org> The branch main has been updated by jrhall: URL: https://cgit.FreeBSD.org/src/commit/?id=e9912b7e88e7d66c0ab5fec1cfe61dcd18377166 commit e9912b7e88e7d66c0ab5fec1cfe61dcd18377166 Author: John Hall AuthorDate: 2026-05-04 22:14:28 +0000 Commit: John Hall CommitDate: 2026-05-07 18:08:27 +0000 smartpqi.4: Document runtime debug_level sysctl Update smartpqi(4) to document the dev.smartpqi..debug_level sysctl for runtime debug level changes, and note that device add/remove and controller event messages always appear in dmesg regardless of the debug_level setting. PR: 294161 Reviewed by: imp Approved by: imp MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D56832 --- share/man/man4/smartpqi.4 | 32 ++++++++++++++++++++++++++------ 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/share/man/man4/smartpqi.4 b/share/man/man4/smartpqi.4 index ef5f903fe422..ae85e184114d 100644 --- a/share/man/man4/smartpqi.4 +++ b/share/man/man4/smartpqi.4 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2019-2025, Microchip Technology Inc. and its subsidiaries +.\" Copyright (C) 2019-2026, Microchip Technology Inc. and its subsidiaries .\" Copyright (C) 2016-2018, Microsemi Corporation .\" Copyright (C) 2016, PMC-Sierra, Inc. .\" Written by John Hall @@ -24,7 +24,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd August 28, 2025 +.Dd April 14, 2026 .Dt SMARTPQI 4 amd64 .Os .Sh NAME @@ -64,11 +64,13 @@ OEM Controllers based on the Microchip Technology Inc. SmartROC and SmartIOC Chipsets .El .Sh DEBUGGING -Driver diagnostic printing is controlled in +Driver diagnostic printing is controlled at boot time in .Xr loader.conf 5 by using the global .Va hw.smartpqi.debug_level -tunable. +tunable, or at runtime via the per-controller +.Va dev.smartpqi..debug_level +sysctl. .Pp The .Va debug_level @@ -82,11 +84,27 @@ The following levels are available: .It 0x0002 Ta info Ta Basic information .It 0x0004 Ta function Ta Used to show function entry and exit .It 0x0008 Ta io Ta Logging data from controller -.It 0x0010 Ta discovery Ta Device discovery +.It 0x0010 Ta discovery Ta Device discovery state transitions .It 0x0020 Ta warning Ta Operational warnings .It 0x0040 Ta error Ta Parameter errors and programming bugs .It 0x0080 Ta note Ta More detailed information .El +.Pp +In addition to the level-gated debug output, the driver always logs +device addition, device removal, and controller events +(hotplug, hardware, physical/logical device changes, AIO state and +configuration changes) via +.Xr device_printf 9 , +which appear in +.Xr dmesg 8 +regardless of the +.Va debug_level +setting. +.Pp +For example, to enable discovery logging at runtime on the first controller: +.Bd -literal -offset indent +sysctl dev.smartpqi.0.debug_level=0x0070 +.Ed .Sh DEVICE HINTS The following tunable values can be set in .Pa /boot/device.hints @@ -162,7 +180,9 @@ https://www.microchip.com/design-centers/storage .Xr xpt 4 , .Xr loader.conf 5 , .Xr camcontrol 8 , -.Xr kldload 8 +.Xr dmesg 8 , +.Xr kldload 8 , +.Xr sysctl 8 .Sh HISTORY The .Nm