[PATCH v2] Documentation: kunit: document --summary and --failed options
From: Eugenio Zuccarelli
Date: Sun Oct 25 2026 - 21:30:25 EST
Commit 062a9dd9bad7 ("kunit: tool: Only print the summary") and commit
3c67a2c09b3c ("kunit: tool: print failed tests only") added the --summary
and --failed options to kunit.py, but the matching entries in the
run_wrapper documentation were never added.
Add descriptions for both options next to the other output options, so
the documentation lists the arguments the tool actually accepts.
An LLM-based coding assistant helped draft these entries; I checked them
against kunit.py and kunit_parser.py.
Signed-off-by: Eugenio Zuccarelli <eugenio.zuccarelli@xxxxxxxxx>
---
Changes in v2:
- Moved the tool disclosure into the changelog text; the Assisted-by
trailer is no longer described in Documentation/process.
Documentation/dev-tools/kunit/run_wrapper.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/Documentation/dev-tools/kunit/run_wrapper.rst b/Documentation/dev-tools/kunit/run_wrapper.rst
index cecc110a..641ab50a 100644
--- a/Documentation/dev-tools/kunit/run_wrapper.rst
+++ b/Documentation/dev-tools/kunit/run_wrapper.rst
@@ -327,6 +327,14 @@ command line arguments:
- ``--junit``: If set, stores the test results in JUnit XML format and prints to `stdout` or
saves to a file if a filename is specified.
+- ``--summary``: If set, prints only the summary line for parsed test
+ results, rather than the result of every individual test. Does nothing
+ if ``--raw_output`` is set.
+
+- ``--failed``: If set, prints only the tests that failed or crashed, along
+ with the summary line, once all tests have run. Does nothing if
+ ``--raw_output`` is set.
+
- ``--filter``: Specifies filters on test attributes, for example, ``speed!=slow``.
Multiple filters can be used by wrapping input in quotes and separating filters
by commas. Example: ``--filter "speed>slow, module=example"``.
base-commit: c03c1a14507dfaf8b856c2608f9ac216021fc222
--
2.34.1