This is an automated email from the ASF dual-hosted git repository. linguini1 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit f3e62b837bfa5abf12c0cff3f1c58e5f804c72e0 Author: Jukka Laitinen <[email protected]> AuthorDate: Tue Jun 9 10:13:19 2026 +0300 Documentation: Add documentation of SCHED_DUMP_TASKS and SCHED_DUMP_STACK Add documentation for controlling the crash dump verbosity. Signed-off-by: Jukka Laitinen <[email protected]> --- .../debugging/disabling_stackdumpdebug.rst | 36 +++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/Documentation/debugging/disabling_stackdumpdebug.rst b/Documentation/debugging/disabling_stackdumpdebug.rst index 7921480118c..0a2e7822bb1 100644 --- a/Documentation/debugging/disabling_stackdumpdebug.rst +++ b/Documentation/debugging/disabling_stackdumpdebug.rst @@ -12,4 +12,38 @@ the board configuration: .. code-block:: c - CONFIG_ARCH_STACKDUMP=n \ No newline at end of file + CONFIG_ARCH_STACKDUMP=n + +Reducing the Crash Dump Verbosity +================================= + +In addition to ``CONFIG_ARCH_STACKDUMP``, which controls whether the +architecture-specific stack dump is produced at all, two finer-grained +options are available to tune how verbose the assertion / crash output +from ``sched/misc/assert.c`` is. Disabling them is useful to reduce +flash usage on small targets and to keep the crash log short. + +Both options default to ``y`` unless ``CONFIG_DEFAULT_SMALL`` is +selected, in which case they default to ``n``. + +CONFIG_SCHED_DUMP_TASKS +----------------------- + +Controls whether the per-task information table (task list with PID, +priority, scheduling policy, stack usage, state, etc.) is printed as +part of the crash dump. + +.. code-block:: c + + CONFIG_SCHED_DUMP_TASKS=n /* Omit the task table from the crash dump */ + +CONFIG_SCHED_DUMP_STACK +----------------------- + +Controls whether the contents of each stack (IRQ / kernel / user) are +dumped as hex words. When disabled, only the base address and size of +each stack are printed; the stack memory itself is not dumped. + +.. code-block:: c + + CONFIG_SCHED_DUMP_STACK=n /* Omit the hex stack contents from the dump */
