forked from Imagelibrary/binutils-gdb
8480a37e14
We currently pass frames to function by value, as `frame_info_ptr`.
This is somewhat expensive:
- the size of `frame_info_ptr` is 64 bytes, which is a bit big to pass
by value
- the constructors and destructor link/unlink the object in the global
`frame_info_ptr::frame_list` list. This is an `intrusive_list`, so
it's not so bad: it's just assigning a few points, there's no memory
allocation as if it was `std::list`, but still it's useless to do
that over and over.
As suggested by Tom Tromey, change many function signatures to accept
`const frame_info_ptr &` instead of `frame_info_ptr`.
Some functions reassign their `frame_info_ptr` parameter, like:
void
the_func (frame_info_ptr frame)
{
for (; frame != nullptr; frame = get_prev_frame (frame))
{
...
}
}
I wondered what to do about them, do I leave them as-is or change them
(and need to introduce a separate local variable that can be
re-assigned). I opted for the later for consistency. It might not be
clear why some functions take `const frame_info_ptr &` while others take
`frame_info_ptr`. Also, if a function took a `frame_info_ptr` because
it did re-assign its parameter, I doubt that we would think to change it
to `const frame_info_ptr &` should the implementation change such that
it doesn't need to take `frame_info_ptr` anymore. It seems better to
have a simple rule and apply it everywhere.
Change-Id: I59d10addef687d157f82ccf4d54f5dde9a963fd0
Approved-By: Andrew Burgess <aburgess@redhat.com>
89 lines
3.2 KiB
C++
89 lines
3.2 KiB
C++
/* Signal trampoline unwinder.
|
|
|
|
Copyright (C) 2004-2024 Free Software Foundation, Inc.
|
|
|
|
This file is part of GDB.
|
|
|
|
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/>. */
|
|
|
|
#ifndef TRAMP_FRAME_H
|
|
#define TRAMP_FRAME_H
|
|
|
|
#include "frame.h"
|
|
#include "frame-unwind.h" /* For frame_prev_arch_ftype. */
|
|
|
|
class frame_info_ptr;
|
|
struct trad_frame_cache;
|
|
|
|
/* A trampoline consists of a small sequence of instructions placed at
|
|
an unspecified location in the inferior's address space. The only
|
|
identifying attribute of the trampoline's address is that it does
|
|
not fall inside an object file's section.
|
|
|
|
The only way to identify a trampoline is to perform a brute force
|
|
examination of the instructions at and around the PC.
|
|
|
|
This module provides a convenient interface for performing that
|
|
operation. */
|
|
|
|
/* A trampoline descriptor. */
|
|
|
|
/* Magic instruction that to mark the end of the signal trampoline
|
|
instruction sequence. */
|
|
#define TRAMP_SENTINEL_INSN ULONGEST_MAX
|
|
|
|
struct tramp_frame
|
|
{
|
|
/* The trampoline's type, some a signal trampolines, some are normal
|
|
call-frame trampolines (aka thunks). */
|
|
enum frame_type frame_type;
|
|
/* The trampoline's entire instruction sequence. It consists of a
|
|
bytes/mask pair. Search for this in the inferior at or around
|
|
the frame's PC. It is assumed that the PC is INSN_SIZE aligned,
|
|
and that each element of TRAMP contains one INSN_SIZE
|
|
instruction. It is also assumed that INSN[0] contains the first
|
|
instruction of the trampoline and hence the address of the
|
|
instruction matching INSN[0] is the trampoline's "func" address.
|
|
The instruction sequence is terminated by
|
|
TRAMP_SENTINEL_INSN. */
|
|
int insn_size;
|
|
struct
|
|
{
|
|
ULONGEST bytes;
|
|
ULONGEST mask;
|
|
} insn[48];
|
|
/* Initialize a trad-frame cache corresponding to the tramp-frame.
|
|
FUNC is the address of the instruction TRAMP[0] in memory. */
|
|
void (*init) (const struct tramp_frame *self,
|
|
const frame_info_ptr &this_frame,
|
|
struct trad_frame_cache *this_cache,
|
|
CORE_ADDR func);
|
|
/* Return non-zero if the tramp-frame is valid for the PC requested.
|
|
Adjust the PC to point to the address to check the instruction
|
|
sequence against if required. If this is NULL, then the tramp-frame
|
|
is valid for any PC. */
|
|
int (*validate) (const struct tramp_frame *self,
|
|
const frame_info_ptr &this_frame,
|
|
CORE_ADDR *pc);
|
|
|
|
/* Given the current frame in THIS_FRAME and a frame cache in FRAME_CACHE,
|
|
return the architecture of the previous frame. */
|
|
frame_prev_arch_ftype *prev_arch;
|
|
};
|
|
|
|
void tramp_frame_prepend_unwinder (struct gdbarch *gdbarch,
|
|
const struct tramp_frame *tramp);
|
|
|
|
#endif
|