nuttx/Documentation/applications/nsh
Jorge Guzman b7305d8780 Documentation: nsh: document the top command
The top command was added to nshlib in 2024 but was never documented.
Add a section to the NSH commands page covering syntax, options,
example output and configuration dependencies, including the
Linux-like summary header.

Also enable the command in the linum-stm32h753bi:nsh config: procfs,
CPU load measurement, stack coloration and task names, so that top
and ps are fully functional out of the box. This requires a dedicated
interrupt stack and larger IDLE/init task stacks: with SCHED_CPULOAD
the per-tick accounting runs in interrupt context, and with
ARCH_INTERRUPTSTACK=0 it lands on the stack of the interrupted task,
overflowing the 1 KiB IDLE stack and corrupting the adjacent heap.

Also add the VT100 escape sequences used by the top command screen
refresh as string literals in include/nuttx/vt100.h (VT100_STR_*),
next to the existing VT100_FMT_* definitions.

Tested on hardware.

Signed-off-by: Jorge Guzman <jorge.gzm@gmail.com>
2026-07-11 09:15:15 -03:00
..
builtin.rst Documentation: Add documentation for NSH_BUILTIN_AS_COMMAND 2025-11-15 10:49:58 -05:00
commands.rst Documentation: nsh: document the top command 2026-07-11 09:15:15 -03:00
config.rst !boards: Remove NSH_ARCHINIT and board_app_initialize 2026-05-02 18:36:46 +08:00
customizing.rst !boards: Remove NSH_ARCHINIT and board_app_initialize 2026-05-02 18:36:46 +08:00
index.rst
installation.rst !boards: Remove NSH_ARCHINIT and board_app_initialize 2026-05-02 18:36:46 +08:00
login.rst docs/nsh: document id, su, whoami, and privilege prompt markers 2026-06-18 09:01:01 -03:00
nsh.rst Documentation/nsh: Add stderr and stdin redirection documentation 2026-02-02 14:01:53 +01:00
running_apps.rst Documentation: Add documentation for NSH_BUILTIN_AS_COMMAND 2025-11-15 10:49:58 -05:00