gdb/hppa-tdep.h

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