mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-03-31 14:11:36 +08:00
1d506c26d9
This commit is the result of the following actions:
- Running gdb/copyright.py to update all of the copyright headers to
include 2024,
- Manually updating a few files the copyright.py script told me to
update, these files had copyright headers embedded within the
file,
- Regenerating gdbsupport/Makefile.in to refresh it's copyright
date,
- Using grep to find other files that still mentioned 2023. If
these files were updated last year from 2022 to 2023 then I've
updated them this year to 2024.
I'm sure I've probably missed some dates. Feel free to fix them up as
you spot them.
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,
|
|
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,
|
|
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
|