| 1 |
24 |
jeremybenn |
/* Signal trampoline unwinder.
|
| 2 |
|
|
|
| 3 |
|
|
Copyright (C) 2004, 2005, 2007, 2008 Free Software Foundation, Inc.
|
| 4 |
|
|
|
| 5 |
|
|
This file is part of GDB.
|
| 6 |
|
|
|
| 7 |
|
|
This program is free software; you can redistribute it and/or modify
|
| 8 |
|
|
it under the terms of the GNU General Public License as published by
|
| 9 |
|
|
the Free Software Foundation; either version 3 of the License, or
|
| 10 |
|
|
(at your option) any later version.
|
| 11 |
|
|
|
| 12 |
|
|
This program is distributed in the hope that it will be useful,
|
| 13 |
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
| 14 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
| 15 |
|
|
GNU General Public License for more details.
|
| 16 |
|
|
|
| 17 |
|
|
You should have received a copy of the GNU General Public License
|
| 18 |
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
| 19 |
|
|
|
| 20 |
|
|
#ifndef TRAMP_FRAME_H
|
| 21 |
|
|
#define TRAMP_FRAME_H
|
| 22 |
|
|
|
| 23 |
|
|
#include "frame.h" /* For "enum frame_type". */
|
| 24 |
|
|
|
| 25 |
|
|
struct trad_frame;
|
| 26 |
|
|
struct frame_info;
|
| 27 |
|
|
struct trad_frame_cache;
|
| 28 |
|
|
|
| 29 |
|
|
/* A trampoline consists of a small sequence of instructions placed at
|
| 30 |
|
|
an unspecified location in the inferior's address space. The only
|
| 31 |
|
|
identifying attribute of the trampoline's address is that it does
|
| 32 |
|
|
not fall inside an object file's section.
|
| 33 |
|
|
|
| 34 |
|
|
The only way to identify a trampoline is to perform a brute force
|
| 35 |
|
|
examination of the instructions at and around the PC.
|
| 36 |
|
|
|
| 37 |
|
|
This module provides a convent interface for performing that
|
| 38 |
|
|
operation. */
|
| 39 |
|
|
|
| 40 |
|
|
/* A trampoline descriptor. */
|
| 41 |
|
|
|
| 42 |
|
|
/* Magic instruction that to mark the end of the signal trampoline
|
| 43 |
|
|
instruction sequence. */
|
| 44 |
|
|
#define TRAMP_SENTINEL_INSN ((LONGEST) -1)
|
| 45 |
|
|
|
| 46 |
|
|
struct tramp_frame
|
| 47 |
|
|
{
|
| 48 |
|
|
/* The trampoline's type, some a signal trampolines, some are normal
|
| 49 |
|
|
call-frame trampolines (aka thunks). */
|
| 50 |
|
|
enum frame_type frame_type;
|
| 51 |
|
|
/* The trampoline's entire instruction sequence. It consists of a
|
| 52 |
|
|
bytes/mask pair. Search for this in the inferior at or around
|
| 53 |
|
|
the frame's PC. It is assumed that the PC is INSN_SIZE aligned,
|
| 54 |
|
|
and that each element of TRAMP contains one INSN_SIZE
|
| 55 |
|
|
instruction. It is also assumed that INSN[0] contains the first
|
| 56 |
|
|
instruction of the trampoline and hence the address of the
|
| 57 |
|
|
instruction matching INSN[0] is the trampoline's "func" address.
|
| 58 |
|
|
The instruction sequence is terminated by
|
| 59 |
|
|
TRAMP_SENTINEL_INSN. */
|
| 60 |
|
|
int insn_size;
|
| 61 |
|
|
struct
|
| 62 |
|
|
{
|
| 63 |
|
|
ULONGEST bytes;
|
| 64 |
|
|
ULONGEST mask;
|
| 65 |
|
|
} insn[48];
|
| 66 |
|
|
/* Initialize a trad-frame cache corresponding to the tramp-frame.
|
| 67 |
|
|
FUNC is the address of the instruction TRAMP[0] in memory. */
|
| 68 |
|
|
void (*init) (const struct tramp_frame *self,
|
| 69 |
|
|
struct frame_info *next_frame,
|
| 70 |
|
|
struct trad_frame_cache *this_cache,
|
| 71 |
|
|
CORE_ADDR func);
|
| 72 |
|
|
};
|
| 73 |
|
|
|
| 74 |
|
|
void tramp_frame_prepend_unwinder (struct gdbarch *gdbarch,
|
| 75 |
|
|
const struct tramp_frame *tramp);
|
| 76 |
|
|
|
| 77 |
|
|
#endif
|
