[v9,05/10] gdb: Skip trampoline functions for the finish and reverse-finish commands.
Checks
Context |
Check |
Description |
linaro-tcwg-bot/tcwg_gdb_build--master-aarch64 |
success
|
Build passed
|
linaro-tcwg-bot/tcwg_gdb_build--master-arm |
success
|
Build passed
|
linaro-tcwg-bot/tcwg_gdb_check--master-arm |
success
|
Test passed
|
linaro-tcwg-bot/tcwg_gdb_check--master-aarch64 |
success
|
Test passed
|
Commit Message
From: "Ijaz, Abdul B" <abdul.b.ijaz@intel.com>
This change skips trampoline functions when the option
'skip-trampoline-functions' is set to 'on' for the finish or reverse-finish
command. Before this change, for these commands GDB returns to the trampoline
function indicated by the compiler with DIE "DW_AT_trampoline". For better
user experience, all such frames can be hidden from the user.
In this example the IFX compiler emits "DW_AT_trampoline" tag for the 'first'
and 'second' trampoline functions like following:
function second (x, y) result(z)
integer, intent(in) :: x, y
integer :: z
z = x * y ! breakpt-finish
end function second
function first (num1, num2) result(total)
integer, intent(in) :: num1, num2
integer :: total
total = second (num1 + 4, num2 * 3) ! first-breakpt
total = total + 30
end function first
Related Dwarf:
0x0000013f: DW_TAG_subprogram
DW_AT_low_pc (0x0000000000404350)
DW_AT_high_pc (0x000000000040435f)
DW_AT_frame_base (DW_OP_reg6 RBP)
DW_AT_linkage_name ("second_.t74p.t75p")
DW_AT_name ("second_.t74p.t75p")
DW_AT_trampoline ("second_")
0x0000015a: DW_TAG_subprogram
DW_AT_low_pc (0x00000000004044a0)
DW_AT_high_pc (0x00000000004044af)
DW_AT_frame_base (DW_OP_reg6 RBP)
DW_AT_linkage_name ("first_.t104p.t105p")
DW_AT_name ("first_.t104p.t105p")
DW_AT_trampoline ("first_")
Before this change, the finish command output looks like:
'''
(gdb) finish
Run till exit from #0 second (x=20, y=9) at test.f90:4
0x0000000000405209 in second_.t74p.t75p () at test.f90:12
12 end function first
Value returned is $1 = 180
'''
The reverse-finish command output in this test before the change:
'''
(gdb) reverse-finish
Run back to call of #0 second (x=20, y=9) at test.f90:4
0x0000000000405204 in second_.t74p.t75p () at test.f90:12
12 end function first
'''
After this change:
'''
(gdb) finish
Run till exit from #0 second (x=20, y=9) at test.f90:4
0x00000000004051e3 in first (num1=16, num2=3) at test.f90:10
10 total = second (num1 + 4, num2 * 3) ! first-breakpt
Value returned is $1 = 180
(gdb) reverse-finish
Run back to call of #0 second (x=20, y=9) at test.f90:4
0x00000000004051de in first (num1=16, num2=3) at test.f90:10
10 total = second (num1 + 4, num2 * 3) ! first-breakpt
'''
The test gdb.fortran/func-trampoline.exp is updated for testing the finish
command. The test gdb.reverse/finish-reverse-trampoline.exp is
added for testing the reverse-finish command.
2024-11-24 Ijaz, Abdul B <abdul.b.ijaz@intel.com>
---
gdb/NEWS | 5 +-
gdb/doc/gdb.texinfo | 4 ++
gdb/infcmd.c | 12 ++++
gdb/infrun.c | 8 +++
gdb/infrun.h | 5 ++
gdb/testsuite/gdb.fortran/func-trampoline.exp | 13 ++++-
.../gdb.reverse/finish-reverse-trampoline.exp | 56 +++++++++++++++++++
7 files changed, 99 insertions(+), 4 deletions(-)
create mode 100644 gdb/testsuite/gdb.reverse/finish-reverse-trampoline.exp
@@ -1085,8 +1085,9 @@ show skip-trampoline-functions
recognize function calls that have been marked as trampolines in the debug
info. It improves stepping behavior in that it steps over the trampoline
code and hides it from the user. It improves the printing of the stack by
- hiding trampoline functions from the backtrace. Currently, only DWARF
- trampolines are supported.
+ hiding the trampoline frames from the backtrace and skips trampoline
+ functions while returning from the target function of a trampoline call.
+ Currently, only DWARF trampolines are supported.
If this is turned off, GDB will handle @dfn{trampoline functions} the same
as any other function.
@@ -6544,6 +6544,10 @@ DWARF trampolines marked via DW_AT_trampoline are supported by this.
When issuing a @code{backtrace}, if @code{skip-trampoline-functions} is set,
@value{GDBN} will skip trampoline frames while printing the stack.
+When issuing a @code{finish} or @code{reverse-finish}, if
+@code{skip-trampoline-functions} is set, @value{GDBN} will skip trampoline
+frames while returning from the target function.
+
Currently, only DWARF trampolines marked via DW_AT_trampoline are supported by
this.
@@ -1803,6 +1803,18 @@ finish_command (const char *arg, int from_tty)
if (frame == 0)
error (_("\"finish\" not meaningful in the outermost frame."));
+ if (skip_trampoline_functions)
+ {
+ for (int i = 0; (SAFE_TRAMPOLINE_CHAIN (i, frame)
+ && in_trampoline_frame (frame)); ++i)
+ frame = get_prev_frame (frame);
+
+ if (frame == nullptr)
+ error (_("\"finish\" not meaningful in the outermost non-trampoline \
+frame. Consider running \"set skip-trampoline-functions off\", to stop in \
+trampoline frames for the \"finish\" command."));
+ }
+
clear_proceed_status (0);
tp = inferior_thread ();
@@ -8080,6 +8080,14 @@ process_event_stop_test (struct execution_control_state *ecs)
keep_going (ecs);
return;
}
+ else if (skip_trampoline_functions && in_trampoline_function (stop_pc))
+ {
+ /* While reverse stepping if we are in a trampoline function call
+ we will just continue single step in the hope of leaving the
+ trampoline again soon. */
+ keep_going (ecs);
+ return;
+ }
}
/* This always returns the sal for the inner-most frame when we are in a
@@ -81,6 +81,11 @@ infrun_debug_show_threads (const char *title, ThreadRange threads)
information. */
#define MAX_TRAMPOLINE_CHAIN_SIZE 10
+/* True if the trampoline index "i" is less then the maximum allowed size
+ of a trampoline chain. */
+#define SAFE_TRAMPOLINE_CHAIN(i, frame) \
+ (i < MAX_TRAMPOLINE_CHAIN_SIZE && (frame != nullptr))
+
/* Nonzero if we want to give control to the user when we're notified
of shared library events by the dynamic linker. */
extern int stop_on_solib_events;
@@ -13,8 +13,8 @@
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/> .
-# Test "backtrace" and "backtrace -n" commands for functions with trampoline
-# calls.
+# Test "backtrace", "backtrace -n" and "finish" commands for functions with
+# trampoline calls.
require allow_fortran_tests
@@ -75,3 +75,12 @@ with_test_prefix "backtrace outerframes" {
"#$decimal.* $middle_desc" \
"#$decimal.* $outer_desc.*"]
}
+
+with_test_prefix "finish" {
+ init_test
+
+ gdb_test "finish" [multi_line \
+ "Run till exit from #0 $fill second \\(x=20, y=9\\) $fill" \
+ "${fill}first \\(num1=16, num2=3\\)${fill}" \
+ "${fill}(\r\nValue returned is $valnum_re = 180)"]
+}
new file mode 100644
@@ -0,0 +1,56 @@
+# Copyright 2024 Free Software Foundation, Inc.
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+# Test "reverse-finish" command for functions with trampoline.
+
+require supports_reverse allow_fortran_tests
+
+if {![test_compiler_info {ifx-*} f90]} {
+ untested "This test is only applicable for IFX, which emits the\
+ trampoline DIE in Dwarf."
+ return -1
+}
+
+load_lib fortran.exp
+
+set testfile finish-reverse-trampoline
+set srcfile "${srcdir}/gdb.fortran/func-trampoline.f90"
+set binfile [standard_output_file $testfile]
+
+if {[prepare_for_testing "failed to prepare" ${testfile} ${srcfile} \
+ {debug f90}]} {
+ return -1
+}
+
+if {![fortran_runto_main]} {
+ return -1
+}
+
+set inner_loc [gdb_get_line_number "second-breakpt"]
+
+if [supports_process_record] {
+ # Activate process record/replay
+ gdb_test_no_output "record" "turn on process record"
+}
+
+# Set breakpoint inside the innermost function 'second'.
+gdb_breakpoint "$srcfile:$inner_loc"
+gdb_continue_to_breakpoint "innermost-body" ".*$srcfile:$inner_loc.*"
+
+gdb_test "reverse-finish" [multi_line \
+ "Run back to call of #0 second \\(x=20, y=9\\).*" \
+ ".*in first \\(num1=16, num2=3\\).*"]
+
+gdb_test "frame" "#0.*first.*" "Frame 0 shows first function"