Re: [PATCH v5 08/13] gdb: Add command option 'bt -shadow' to print the shadow stack backtrace.

[Eli Zaretskii <eliz@gnu.org>]

> From: Christina Joos <christina.joos@intel.com>
> Cc: thiago.bauermann@linaro.org, tom@tromey.com, luis.machado.foss@gmail.com
> Date: Thu, 24 Sep 2026 10:33:05 +0200
> 
> Add command option '-shadow" to the backtrace command to print the shadow
> stack backtrace instead of the normal backtrace.
> 
> This option may be combined with '-frame-info' and implies '-no-filters'
> and '-frame-arguments none'.  Also the options @samp{-past-entry} or
> @samp{-hide} are not supported.
> 
> This is an example for the output of 'bt -shadow' on amd64 linux:
> ~~
> (gdb) bt -shadow
> /#0  0x000055555555514a in call1 at amd64-shadow-stack.c:27
> /#1  0x000055555555515f in main at amd64-shadow-stack.c:38
> ~~
> 
> Note that the normal backtrace includes one additional frame, since
> the shadow stack backtrace relies on return addresses of the shadow
> stack only.  But except the missing frame arguments and frame #0 of
> the normal backtrace, the backtrace is the same.
> ~~
> (gdb) bt
> /#0  call2 () at amd64-shadow-stack.c:21
> /#1  0x000055555555514a in call1 () at amd64-shadow-stack.c:27
> /#2  0x000055555555515f in main () at amd64-shadow-stack.c:38
> ~~
> 
> This commit also adds a test for 'bt -shadow' on amd64.
> Although the test is OS independent we can only test this on linux,
> as GDB does not support shadow stack on other OS for now.
> Also we do not add a test for 32 bit, as support for shadow stack is
> limited to 64 bit by the linux kernel.
> 
> Reviewed-by: Thiago Jung Bauermann <thiago.bauermann@linaro.org>
> ---
>  gdb/NEWS                                      |   3 +
>  gdb/doc/gdb.texinfo                           |  25 +
>  gdb/gdbarch-gen.h                             |   2 +
>  gdb/gdbarch.h                                 |   1 +
>  gdb/gdbarch_components.py                     |   2 +
>  gdb/shadow-stack.c                            | 475 ++++++++++++++++++
>  gdb/shadow-stack.h                            |  65 +++
>  gdb/stack.c                                   |  49 +-
>  gdb/stack.h                                   |  43 ++
>  .../gdb.arch/amd64-shadow-stack-cmds.exp      |  47 ++
>  gdb/testsuite/gdb.base/options.exp            |   2 +-
>  11 files changed, 689 insertions(+), 25 deletions(-)

Thanks, the documentation parts are okay.

Reviewed-By: Eli Zaretskii <eliz@gnu.org>