(nuttx) branch master updated: libs/libc: add configurable skip count for mutex backtrace addresses

[xiaoxiang]

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

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


The following commit(s) were added to refs/heads/master by this push:
     new 3fb1a40a4bd libs/libc: add configurable skip count for mutex backtrace 
addresses
3fb1a40a4bd is described below

commit 3fb1a40a4bda69f861b38d1f7377aa667d39e1cf
Author: chenzhaoxiang <chenzhaoxi...@bytedance.com>
AuthorDate: Thu Feb 26 16:54:00 2026 +0800

    libs/libc: add configurable skip count for mutex backtrace addresses
    
    This commit introduces a new Kconfig option LIBC_MUTEX_BACKTRACE_SKIP 
tocontrol the
    number of initial addresses skipped when generating mutex backtraces.
    
    Key changes:
    1. Add LIBC_MUTEX_BACKTRACE_SKIP Kconfig entry (depends on
    LIBC_MUTEX_BACKTRACE > 0), defaulting to 2. This option lets users configure
    how many leading addresses are omitted from the mutex backtrace output.
    
    2. Modify the nxmutex_add_backtrace() function to pass the new config value
    as the skip parameter to sched_backtrace(), replacing the hardcoded 0.
    
    This enhancement improves the usability of mutex backtraces by allowing 
removalof uninformative
    initial stack frames (e.g., backtrace helper functions ormutex acquisition 
wrappers), making the
    relevant call stack entries more visiblefor debugging lock-related issues.
    
    The default value (2) maintains sensibleout-of-the-box behavior while 
enabling customization for specific use cases.
    
    Signed-off-by: chao an <anchao.arc...@bytedance.com>
---
 libs/libc/misc/Kconfig     | 8 ++++++++
 libs/libc/misc/lib_mutex.c | 5 +++--
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/libs/libc/misc/Kconfig b/libs/libc/misc/Kconfig
index 777e49b9735..2683c763185 100644
--- a/libs/libc/misc/Kconfig
+++ b/libs/libc/misc/Kconfig
@@ -164,3 +164,11 @@ config LIBC_MUTEX_BACKTRACE
        ---help---
                Config the depth of backtrace, dumping the backtrace of thread 
which
                last acquired the mutex. Disable mutex backtrace by 0.
+
+config LIBC_MUTEX_BACKTRACE_SKIP
+       int "Number of initial addresses to skip in mutex backtrace"
+       depends on LIBC_MUTEX_BACKTRACE > 0
+       default 2
+       ---help---
+               Configure how many initial addresses to skip when dumping mutex 
backtraces.
+               When generating a backtrace, the first skip addresses will be 
skipped.
diff --git a/libs/libc/misc/lib_mutex.c b/libs/libc/misc/lib_mutex.c
index bdc89a2d434..0152f984e48 100644
--- a/libs/libc/misc/lib_mutex.c
+++ b/libs/libc/misc/lib_mutex.c
@@ -53,8 +53,9 @@ void nxmutex_add_backtrace(FAR mutex_t *mutex)
 {
   int n;
 
-  n = sched_backtrace(nxmutex_get_holder(&mutex), mutex->backtrace,
-                      CONFIG_LIBC_MUTEX_BACKTRACE, 0);
+  n = sched_backtrace(nxmutex_get_holder(mutex), mutex->backtrace,
+                      CONFIG_LIBC_MUTEX_BACKTRACE,
+                      CONFIG_LIBC_MUTEX_BACKTRACE_SKIP);
   if (n < CONFIG_LIBC_MUTEX_BACKTRACE)
     {
       mutex->backtrace[n] = NULL;