Mirrors_Framework/nuttx
1
0
Fork 0
mirror of https://github.com/apache/nuttx.git synced 2026-05-27 11:26:12 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Document: add information for stack overflow check on context switching
Build Documentation / build-html (push) Has been cancelled
Details

Browse Source 
Updated documentation to explain how to enable detection during context switching.

Co-authored-by: Chengdong Wang <wangchengdong@lixiang.com>
Signed-off-by: guoshengyuan1 <guoshengyuan1@xiaomi.com>
This commit is contained in:
guoshengyuan1
2025-09-22 19:55:37 +08:00
committed by archer
parent 5d7ac216f2
commit a3e63c44dd
1 changed files with 21 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Documentation/debugging/stackcheck.rst
+21 -6
View File
@@ -6,14 +6,19 @@ Overview
-------- --------
Currently NuttX supports three types of stack overflow detection: Currently NuttX supports three types of stack overflow detection:
1. Stack Overflow Software Check 1. Stack Overflow Software Check During Function Call
2. Stack Overflow Hardware Check 2. Stack Overflow Software Check During Context Switching
3. Stack Canary Check 3. Stack Overflow Hardware Check
4. Stack Canary Check
The software stack detection includes two implementation ideas: The software stack detection during function call includes two implementation ideas:
1. Implemented by coloring the stack memory 1. Implemented by coloring the stack memory
2. Implemented by comparing the sp and sl registers 2. Implemented by comparing the sp and sl registers
The software stack detection during context switching includes two implementation ideas:
1. Implemented by coloring the stack memory
2. Implemented by checking the bottom memory of the stack and the sp register
Support Support
------- -------
@@ -21,8 +26,8 @@ Software and hardware stack overflow detection implementation,
currently only implemented on ARM Cortex-M (32-bit) series chips currently only implemented on ARM Cortex-M (32-bit) series chips
Stack Canary Check is available on all platforms Stack Canary Check is available on all platforms
Stack Overflow Software Check Stack Overflow Software Check During Function Call
----------------------------- --------------------------------------------------
1. Memory Coloring Implementation Principle 1. Memory Coloring Implementation Principle
1. Before using the stack, Thread will refresh the stack area to 0xdeadbeef 1. Before using the stack, Thread will refresh the stack area to 0xdeadbeef
@@ -44,6 +49,16 @@ Stack Overflow Software Check
Usage: Usage:
Enable CONFIG_ARMV8M_STACKCHECK or CONFIG_ARMV7M_STACKCHECK Enable CONFIG_ARMV8M_STACKCHECK or CONFIG_ARMV7M_STACKCHECK
Stack Overflow Software Check During Context Switching
------------------------------------------------------
1. Determine by detecting the number of bytes specified at the bottom of the stack.
2. Check if the sp register is out of bounds.
Usage:
Enable CONFIG_STACKCHECK_SOFTWARE
You can set the detection length by STACKCHECK_MARGIN
Stack Overflow Hardware Check Stack Overflow Hardware Check
----------------------------- -----------------------------