]> git.ipfire.org Git - thirdparty/linux.git/commitdiff
Documentation: kunit: add description of kunit.enable parameter
authorYuya Ishikawa <ishikawa.yuy-00@jp.fujitsu.com>
Tue, 21 Oct 2025 03:06:00 +0000 (12:06 +0900)
committerShuah Khan <skhan@linuxfoundation.org>
Mon, 27 Oct 2025 17:16:09 +0000 (11:16 -0600)
The current KUnit documentation does not mention the kunit.enable
kernel parameter, making it unclear how to troubleshoot cases where
KUnit tests do not run as expected.
Add a note explaining kunit.enable parmaeter. Disabling this parameter
prevents all KUnit tests from running even if CONFIG_KUNIT is enabled.

Link: https://lore.kernel.org/r/20251021030605.41610-1-ishikawa.yuy-00@jp.fujitsu.com
Signed-off-by: Yuya Ishikawa <ishikawa.yuy-00@jp.fujitsu.com>
Reviewed-by: David Gow <davidgow@google.com>
Signed-off-by: Shuah Khan <skhan@linuxfoundation.org>
Documentation/dev-tools/kunit/run_manual.rst

index 699d92885075082a06c9de0e06a1a33dcdfbb440..98e8d5b2880855a17cd8cdcdcdb9f47e28422c00 100644 (file)
@@ -35,6 +35,12 @@ or be built into the kernel.
        a good way of quickly testing everything applicable to the current
        config.
 
+       KUnit can be enabled or disabled at boot time, and this behavior is
+       controlled by the kunit.enable kernel parameter.
+       By default, kunit.enable is set to 1 because KUNIT_DEFAULT_ENABLED is
+       enabled by default. To ensure that tests are executed as expected,
+       verify that kunit.enable=1 at boot time.
+
 Once we have built our kernel (and/or modules), it is simple to run
 the tests. If the tests are built-in, they will run automatically on the
 kernel boot. The results will be written to the kernel log (``dmesg``)