gdb/hppa-tdep.h

   1 /* Target-dependent code for the HP PA-RISC architecture.
   2
   3    Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
   4    Free Software Foundation, Inc.
   5
   6    This file is part of GDB.
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  20
  21 #ifndef HPPA_TDEP_H
  22 #define HPPA_TDEP_H
  23
  24 struct trad_frame_saved_reg;
  25 struct objfile;
  26 struct so_list;
  27
  28 /* Register numbers of various important registers.  */
  29
  30 enum hppa_regnum
  31 {
  32   HPPA_R0_REGNUM = 0,           /* Doesn't actually exist, used as base for
  33                                    other r registers.  */
  34   HPPA_R1_REGNUM = 1,
  35   HPPA_FLAGS_REGNUM = 0,        /* Various status flags */
  36   HPPA_RP_REGNUM = 2,           /* return pointer */
  37   HPPA_FP_REGNUM = 3,           /* The ABI's frame pointer, when used */
  38   HPPA_DP_REGNUM = 27,
  39   HPPA_RET0_REGNUM = 28,
  40   HPPA_RET1_REGNUM = 29,
  41   HPPA_SP_REGNUM = 30,          /* Stack pointer.  */
  42   HPPA_R31_REGNUM = 31,
  43   HPPA_SAR_REGNUM = 32,         /* Shift Amount Register */
  44   HPPA_IPSW_REGNUM = 41,        /* Interrupt Processor Status Word */
  45   HPPA_PCOQ_HEAD_REGNUM = 33,   /* instruction offset queue head */
  46   HPPA_PCSQ_HEAD_REGNUM = 34,   /* instruction space queue head */
  47   HPPA_PCOQ_TAIL_REGNUM = 35,   /* instruction offset queue tail */
  48   HPPA_PCSQ_TAIL_REGNUM = 36,   /* instruction space queue tail */
  49   HPPA_EIEM_REGNUM = 37,        /* External Interrupt Enable Mask */
  50   HPPA_IIR_REGNUM = 38,         /* Interrupt Instruction Register */
  51   HPPA_ISR_REGNUM = 39,         /* Interrupt Space Register */
  52   HPPA_IOR_REGNUM = 40,         /* Interrupt Offset Register */
  53   HPPA_SR4_REGNUM = 43,         /* space register 4 */
  54   HPPA_RCR_REGNUM = 51,         /* Recover Counter (also known as cr0) */
  55   HPPA_PID0_REGNUM = 52,        /* Protection ID */
  56   HPPA_PID1_REGNUM = 53,        /* Protection ID */
  57   HPPA_PID2_REGNUM = 55,        /* Protection ID */
  58   HPPA_PID3_REGNUM = 56,        /* Protection ID */
  59   HPPA_CCR_REGNUM = 54,         /* Coprocessor Configuration Register */
  60   HPPA_TR0_REGNUM = 57,         /* Temporary Registers (cr24 -> cr31) */
  61   HPPA_CR26_REGNUM = 59,
  62   HPPA_CR27_REGNUM = 60,        /* Base register for thread-local
  63                                    storage, cr27 */
  64   HPPA_FP0_REGNUM = 64,         /* First floating-point.  */
  65   HPPA_FP4_REGNUM = 72,
  66   HPPA64_FP4_REGNUM = 68,
  67   HPPA_FP31R_REGNUM = 127,      /* Last floating-point.  */
  68
  69   HPPA_ARG0_REGNUM = 26,        /* The first argument of a callee.  */
  70   HPPA_ARG1_REGNUM = 25,        /* The second argument of a callee.  */
  71   HPPA_ARG2_REGNUM = 24,        /* The third argument of a callee.  */
  72   HPPA_ARG3_REGNUM = 23         /* The fourth argument of a callee.  */
  73 };
  74
  75 /* Instruction size.  */
  76 #define HPPA_INSN_SIZE 4
  77
  78 /* Target-dependent structure in gdbarch.  */
  79 struct gdbarch_tdep
  80 {
  81   /* The number of bytes in an address.  For now, this field is designed
  82      to allow us to differentiate hppa32 from hppa64 targets.  */
  83   int bytes_per_address;
  84
  85   /* Is this an ELF target? This can be 64-bit HP-UX, or a 32/64-bit GNU/Linux
  86      system.  */
  87   int is_elf;
  88
  89   /* Given a function address, try to find the global pointer for the
  90      corresponding shared object.  */
  91   CORE_ADDR (*find_global_pointer) (struct gdbarch *, struct value *);
  92
  93   /* For shared libraries, each call goes through a small piece of
  94      trampoline code in the ".plt", or equivalent, section.
  95      IN_SOLIB_CALL_TRAMPOLINE evaluates to nonzero if we are currently
  96      stopped in one of these.  */
  97   int (*in_solib_call_trampoline) (struct gdbarch *gdbarch,
  98                                    CORE_ADDR pc, char *name);
  99
 100   /* For targets that support multiple spaces, we may have additional stubs
 101      in the return path.  These stubs are internal to the ABI, and users are
 102      not interested in them.  If we detect that we are returning to a stub,
 103      adjust the pc to the real caller.  This improves the behavior of commands
 104      that traverse frames such as "up" and "finish".  */
 105   void (*unwind_adjust_stub) (struct frame_info *this_frame, CORE_ADDR base,
 106                               struct trad_frame_saved_reg *saved_regs);
 107
 108   /* These are solib-dependent methods.  They are really HPUX only, but
 109      we don't have a HPUX-specific tdep vector at the moment.  */
 110   CORE_ADDR (*solib_thread_start_addr) (struct so_list *so);
 111   CORE_ADDR (*solib_get_got_by_pc) (CORE_ADDR addr);
 112   CORE_ADDR (*solib_get_solib_by_pc) (CORE_ADDR addr);
 113   CORE_ADDR (*solib_get_text_base) (struct objfile *objfile);
 114 };
 115
 116 /*
 117  * Unwind table and descriptor.
 118  */
 119
 120 struct unwind_table_entry
 121   {
 122     CORE_ADDR region_start;
 123     CORE_ADDR region_end;
 124
 125     unsigned int Cannot_unwind:1;       /* 0 */
 126     unsigned int Millicode:1;   /* 1 */
 127     unsigned int Millicode_save_sr0:1;  /* 2 */
 128     unsigned int Region_description:2;  /* 3..4 */
 129     unsigned int reserved:1;    /* 5 */
 130     unsigned int Entry_SR:1;    /* 6 */
 131     unsigned int Entry_FR:4;    /* number saved *//* 7..10 */
 132     unsigned int Entry_GR:5;    /* number saved *//* 11..15 */
 133     unsigned int Args_stored:1; /* 16 */
 134     unsigned int Variable_Frame:1;      /* 17 */
 135     unsigned int Separate_Package_Body:1;       /* 18 */
 136     unsigned int Frame_Extension_Millicode:1;   /* 19 */
 137     unsigned int Stack_Overflow_Check:1;        /* 20 */
 138     unsigned int Two_Instruction_SP_Increment:1;        /* 21 */
 139     unsigned int sr4export:1;   /* 22 */
 140     unsigned int cxx_info:1;    /* 23 */
 141     unsigned int cxx_try_catch:1;       /* 24 */
 142     unsigned int sched_entry_seq:1;     /* 25 */
 143     unsigned int reserved1:1;   /* 26 */
 144     unsigned int Save_SP:1;     /* 27 */
 145     unsigned int Save_RP:1;     /* 28 */
 146     unsigned int Save_MRP_in_frame:1;   /* 29 */
 147     unsigned int save_r19:1;    /* 30 */
 148     unsigned int Cleanup_defined:1;     /* 31 */
 149
 150     unsigned int MPE_XL_interrupt_marker:1;     /* 0 */
 151     unsigned int HP_UX_interrupt_marker:1;      /* 1 */
 152     unsigned int Large_frame:1; /* 2 */
 153     unsigned int alloca_frame:1;        /* 3 */
 154     unsigned int reserved2:1;   /* 4 */
 155     unsigned int Total_frame_size:27;   /* 5..31 */
 156
 157     /* This is *NOT* part of an actual unwind_descriptor in an object
 158        file.  It is *ONLY* part of the "internalized" descriptors that
 159        we create from those in a file.  */
 160
 161     struct
 162       {
 163         unsigned int stub_type:4;       /* 0..3 */
 164         unsigned int padding:28;        /* 4..31 */
 165       }
 166     stub_unwind;
 167   };
 168
 169 /* HP linkers also generate unwinds for various linker-generated stubs.
 170    GDB reads in the stubs from the $UNWIND_END$ subspace, then
 171    "converts" them into normal unwind entries using some of the reserved
 172    fields to store the stub type.  */
 173
 174 /* The gaps represent linker stubs used in MPE and space for future
 175    expansion.  */
 176 enum unwind_stub_types
 177   {
 178     LONG_BRANCH = 1,
 179     PARAMETER_RELOCATION = 2,
 180     EXPORT = 10,
 181     IMPORT = 11,
 182     IMPORT_SHLIB = 12,
 183   };
 184
 185 struct unwind_table_entry *find_unwind_entry (CORE_ADDR);
 186
 187 /* We use the objfile->obj_private pointer for two things:
 188  * 1.  An unwind table;
 189  *
 190  * 2.  A pointer to any associated shared library object.
 191  *
 192  * #defines are used to help refer to these objects.
 193  */
 194
 195 /* Info about the unwind table associated with an object file.
 196  * This is hung off of the "objfile->obj_private" pointer, and
 197  * is allocated in the objfile's psymbol obstack.  This allows
 198  * us to have unique unwind info for each executable and shared
 199  * library that we are debugging.
 200  */
 201 struct hppa_unwind_info
 202   {
 203     struct unwind_table_entry *table;   /* Pointer to unwind info */
 204     struct unwind_table_entry *cache;   /* Pointer to last entry we found */
 205     int last;                           /* Index of last entry */
 206   };
 207
 208 struct hppa_objfile_private
 209   {
 210     struct hppa_unwind_info *unwind_info;       /* a pointer */
 211     struct so_list *so_info;                    /* a pointer  */
 212     CORE_ADDR dp;
 213
 214     int dummy_call_sequence_reg;
 215     CORE_ADDR dummy_call_sequence_addr;
 216   };
 217
 218 extern const struct objfile_data *hppa_objfile_priv_data;
 219
 220 int hppa_get_field (unsigned word, int from, int to);
 221 int hppa_extract_5_load (unsigned int);
 222 unsigned hppa_extract_5R_store (unsigned int);
 223 unsigned hppa_extract_5r_store (unsigned int);
 224 int hppa_extract_17 (unsigned int);
 225 int hppa_extract_21 (unsigned);
 226 int hppa_extract_14 (unsigned);
 227 CORE_ADDR hppa_symbol_address(const char *sym);
 228
 229 extern struct value *
 230   hppa_frame_prev_register_helper (struct frame_info *this_frame,
 231                                    struct trad_frame_saved_reg *saved_regs,
 232                                    int regnum);
 233
 234 extern CORE_ADDR hppa_read_pc (struct regcache *regcache);
 235 extern void hppa_write_pc (struct regcache *regcache, CORE_ADDR pc);
 236 extern CORE_ADDR hppa_unwind_pc (struct gdbarch *gdbarch,
 237                                  struct frame_info *next_frame);
 238
 239 extern struct minimal_symbol *
 240   hppa_lookup_stub_minimal_symbol (const char *name,
 241                                    enum unwind_stub_types stub_type);
 242
 243 extern struct hppa_objfile_private *
 244 hppa_init_objfile_priv_data (struct objfile *objfile);
 245
 246 extern int hppa_in_solib_call_trampoline (struct gdbarch *gdbarch,
 247                                           CORE_ADDR pc, char *name);
 248 extern CORE_ADDR hppa_skip_trampoline_code (struct frame_info *, CORE_ADDR pc);
 249
 250 #endif  /* hppa-tdep.h */