You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by ac...@apache.org on 2020/12/09 12:44:18 UTC

[incubator-nuttx] 01/06: arch/xtensa/src/common/xtensa_backtrace.S: Update the comments to show the functions in play during the backtrace.

This is an automated email from the ASF dual-hosted git repository.

acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-nuttx.git

commit 716a29ebebc0dbb00ed9e21b8fa6019602c2987c
Author: Abdelatif Guettouche <ab...@espressif.com>
AuthorDate: Fri Nov 27 10:27:36 2020 +0000

    arch/xtensa/src/common/xtensa_backtrace.S: Update the comments to show
    the functions in play during the backtrace.
    
    Signed-off-by: Abdelatif Guettouche <ab...@espressif.com>
---
 arch/xtensa/src/common/xtensa_backtrace.S | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/arch/xtensa/src/common/xtensa_backtrace.S b/arch/xtensa/src/common/xtensa_backtrace.S
index e5204b4..05329be 100644
--- a/arch/xtensa/src/common/xtensa_backtrace.S
+++ b/arch/xtensa/src/common/xtensa_backtrace.S
@@ -30,18 +30,19 @@
 #include "xtensa_abi.h"
 
 /*
- * This is how the stack looks like when calling the function below:
+ * This is how the call stack looks like when calling the function below
+ * from xtensa_dumpstate():
  *
  *         High Addr
  *     ..................
  *     |    i-3 BSA     |
- *     |   i-1 locals   | Function B
+ *     |   i-1 locals   | xtensa_assert()
  *     .................. i-1 SP
  *     |    i-2 BSA     |
- *     |    i locals    | Function A (Start of backtrace)
+ *     |    i locals    | xtensa_dumpstate()
  *     ------------------ i SP
  *     |    i-1 BSA     |
- *     |   i+1 locals   | Backtracing function (e.g. xtensa_btdump())
+ *     |   i+1 locals   | xtensa_btdump()
  *     ------------------ i+1 SP
  *     |     i BSA      |
  *     |   i+2 locals   | xtensa_backtrace_start()
@@ -56,7 +57,7 @@
  * Name: xtensa_backtrace_start
  *
  * Description:
- *   Get the first frame of the current stack's backtrace
+ *   Get the first frame of the current stack's backtrace.
  *
  *   Given the following function call flow (B -> A -> X -> xtensa_backtrace_start),
  *   this function will do the following: