gdb/config/pa/tm-hppa.h

   1 /* Parameters for execution on any Hewlett-Packard PA-RISC machine.
   2
   3    Copyright 1986, 1987, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
   4    1996, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Free Software
   5    Foundation, Inc.
   6
   7    Contributed by the Center for Software Science at the
   8    University of Utah (pa-gdb-bugs@cs.utah.edu).
   9
  10    This file is part of GDB.
  11
  12    This program is free software; you can redistribute it and/or modify
  13    it under the terms of the GNU General Public License as published by
  14    the Free Software Foundation; either version 2 of the License, or
  15    (at your option) any later version.
  16
  17    This program is distributed in the hope that it will be useful,
  18    but WITHOUT ANY WARRANTY; without even the implied warranty of
  19    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20    GNU General Public License for more details.
  21
  22    You should have received a copy of the GNU General Public License
  23    along with this program; if not, write to the Free Software
  24    Foundation, Inc., 59 Temple Place - Suite 330,
  25    Boston, MA 02111-1307, USA.  */
  26
  27 #include "regcache.h"
  28
  29 #define GDB_MULTI_ARCH 1
  30
  31 /* Hack, get around problem with including "arch-utils.h".  */
  32 struct frame_info;
  33
  34 /* Forward declarations of some types we use in prototypes */
  35
  36 struct frame_info;
  37 struct frame_saved_regs;
  38 struct value;
  39 struct type;
  40 struct inferior_status;
  41
  42 /* Sequence of bytes for breakpoint instruction.  */
  43
  44 const unsigned char *hppa_breakpoint_from_pc (CORE_ADDR *pcptr, int *lenptr);
  45 #define BREAKPOINT_FROM_PC(PCPTR,LENPTR) hppa_breakpoint_from_pc ((PCPTR), (LENPTR))
  46 #define BREAKPOINT32 0x10004
  47
  48 extern int hppa_pc_requires_run_before_use (CORE_ADDR pc);
  49 #define PC_REQUIRES_RUN_BEFORE_USE(pc) hppa_pc_requires_run_before_use (pc)
  50
  51 /* Register numbers of various important registers.
  52    Note that some of these values are "real" register numbers,
  53    and correspond to the general registers of the machine,
  54    and some are "phony" register numbers which are too large
  55    to be actual register numbers as far as the user is concerned
  56    but do serve to get the desired values when passed to read_register.  */
  57
  58 #define R0_REGNUM 0             /* Doesn't actually exist, used as base for
  59                                    other r registers.  */
  60 #define FLAGS_REGNUM 0          /* Various status flags */
  61 #define RP_REGNUM 2             /* return pointer */
  62 #define HPPA_FP_REGNUM 3        /* The ABI's frame pointer, when used */
  63 #define HPPA_SP_REGNUM 30       /* Stack pointer.  */
  64 #define SAR_REGNUM 32           /* Shift Amount Register */
  65 #define IPSW_REGNUM 41          /* Interrupt Processor Status Word */
  66 #define PCOQ_HEAD_REGNUM 33     /* instruction offset queue head */
  67 #define PCSQ_HEAD_REGNUM 34     /* instruction space queue head */
  68 #define PCOQ_TAIL_REGNUM 35     /* instruction offset queue tail */
  69 #define PCSQ_TAIL_REGNUM 36     /* instruction space queue tail */
  70 #define EIEM_REGNUM 37          /* External Interrupt Enable Mask */
  71 #define IIR_REGNUM 38           /* Interrupt Instruction Register */
  72 #define IOR_REGNUM 40           /* Interrupt Offset Register */
  73 #define SR4_REGNUM 43           /* space register 4 */
  74 #define RCR_REGNUM 51           /* Recover Counter (also known as cr0) */
  75 #define CCR_REGNUM 54           /* Coprocessor Configuration Register */
  76 #define TR0_REGNUM 57           /* Temporary Registers (cr24 -> cr31) */
  77 #define CR27_REGNUM 60          /* Base register for thread-local storage, cr27 */
  78 #define HPPA_FP0_REGNUM 64      /* First floating-point.  */
  79 #define FP4_REGNUM 72
  80
  81 #define ARG0_REGNUM 26          /* The first argument of a callee. */
  82 #define ARG1_REGNUM 25          /* The second argument of a callee. */
  83 #define ARG2_REGNUM 24          /* The third argument of a callee. */
  84 #define ARG3_REGNUM 23          /* The fourth argument of a callee. */
  85
  86 /* When fetching register values from an inferior or a core file,
  87    clean them up using this macro.  BUF is a char pointer to
  88    the raw value of the register in the registers[] array.  */
  89
  90 #define DEPRECATED_CLEAN_UP_REGISTER_VALUE(regno, buf) \
  91   do {  \
  92     if ((regno) == PCOQ_HEAD_REGNUM || (regno) == PCOQ_TAIL_REGNUM) \
  93       (buf)[sizeof(CORE_ADDR) -1] &= ~0x3; \
  94   } while (0)
  95
  96 /* PA specific macro to see if the current instruction is nullified. */
  97 #ifndef INSTRUCTION_NULLIFIED
  98 extern int hppa_instruction_nullified (void);
  99 #define INSTRUCTION_NULLIFIED hppa_instruction_nullified ()
 100 #endif
 101
 102 #define INSTRUCTION_SIZE 4
 103
 104 #define REG_PARM_STACK_SPACE 16
 105
 106 /*
 107  * Unwind table and descriptor.
 108  */
 109
 110 struct unwind_table_entry
 111   {
 112     CORE_ADDR region_start;
 113     CORE_ADDR region_end;
 114
 115     unsigned int Cannot_unwind:1;       /* 0 */
 116     unsigned int Millicode:1;   /* 1 */
 117     unsigned int Millicode_save_sr0:1;  /* 2 */
 118     unsigned int Region_description:2;  /* 3..4 */
 119     unsigned int reserved1:1;   /* 5 */
 120     unsigned int Entry_SR:1;    /* 6 */
 121     unsigned int Entry_FR:4;    /* number saved *//* 7..10 */
 122     unsigned int Entry_GR:5;    /* number saved *//* 11..15 */
 123     unsigned int Args_stored:1; /* 16 */
 124     unsigned int Variable_Frame:1;      /* 17 */
 125     unsigned int Separate_Package_Body:1;       /* 18 */
 126     unsigned int Frame_Extension_Millicode:1;   /* 19 */
 127     unsigned int Stack_Overflow_Check:1;        /* 20 */
 128     unsigned int Two_Instruction_SP_Increment:1;        /* 21 */
 129     unsigned int Ada_Region:1;  /* 22 */
 130     unsigned int cxx_info:1;    /* 23 */
 131     unsigned int cxx_try_catch:1;       /* 24 */
 132     unsigned int sched_entry_seq:1;     /* 25 */
 133     unsigned int reserved2:1;   /* 26 */
 134     unsigned int Save_SP:1;     /* 27 */
 135     unsigned int Save_RP:1;     /* 28 */
 136     unsigned int Save_MRP_in_frame:1;   /* 29 */
 137     unsigned int extn_ptr_defined:1;    /* 30 */
 138     unsigned int Cleanup_defined:1;     /* 31 */
 139
 140     unsigned int MPE_XL_interrupt_marker:1;     /* 0 */
 141     unsigned int HP_UX_interrupt_marker:1;      /* 1 */
 142     unsigned int Large_frame:1; /* 2 */
 143     unsigned int Pseudo_SP_Set:1;       /* 3 */
 144     unsigned int reserved4:1;   /* 4 */
 145     unsigned int Total_frame_size:27;   /* 5..31 */
 146
 147     /* This is *NOT* part of an actual unwind_descriptor in an object
 148        file.  It is *ONLY* part of the "internalized" descriptors that
 149        we create from those in a file.
 150      */
 151     struct
 152       {
 153         unsigned int stub_type:4;       /* 0..3 */
 154         unsigned int padding:28;        /* 4..31 */
 155       }
 156     stub_unwind;
 157   };
 158
 159 /* HP linkers also generate unwinds for various linker-generated stubs.
 160    GDB reads in the stubs from the $UNWIND_END$ subspace, then
 161    "converts" them into normal unwind entries using some of the reserved
 162    fields to store the stub type.  */
 163
 164 /* The gaps represent linker stubs used in MPE and space for future
 165    expansion.  */
 166 enum unwind_stub_types
 167   {
 168     LONG_BRANCH = 1,
 169     PARAMETER_RELOCATION = 2,
 170     EXPORT = 10,
 171     IMPORT = 11,
 172     IMPORT_SHLIB = 12,
 173   };
 174
 175 /* We use the objfile->obj_private pointer for two things:
 176
 177  * 1.  An unwind table;
 178  *
 179  * 2.  A pointer to any associated shared library object.
 180  *
 181  * #defines are used to help refer to these objects.
 182  */
 183
 184 /* Info about the unwind table associated with an object file.
 185
 186  * This is hung off of the "objfile->obj_private" pointer, and
 187  * is allocated in the objfile's psymbol obstack.  This allows
 188  * us to have unique unwind info for each executable and shared
 189  * library that we are debugging.
 190  */
 191 struct obj_unwind_info
 192   {
 193     struct unwind_table_entry *table;   /* Pointer to unwind info */
 194     struct unwind_table_entry *cache;   /* Pointer to last entry we found */
 195     int last;                   /* Index of last entry */
 196   };
 197
 198 typedef struct obj_private_struct
 199   {
 200     struct obj_unwind_info *unwind_info;        /* a pointer */
 201     struct so_list *so_info;    /* a pointer  */
 202     CORE_ADDR dp;
 203   }
 204 obj_private_data_t;
 205
 206 /* For a number of horrible reasons we may have to adjust the location
 207    of variables on the stack.  Ugh.  */
 208 #define HPREAD_ADJUST_STACK_ADDRESS(ADDR) hpread_adjust_stack_address(ADDR)
 209 extern int hpread_adjust_stack_address (CORE_ADDR);
 210
 211 /* Here's how to step off a permanent breakpoint.  */
 212 #define SKIP_PERMANENT_BREAKPOINT (hppa_skip_permanent_breakpoint)
 213 extern void hppa_skip_permanent_breakpoint (void);
 214
 215 /* On HP-UX, certain system routines (millicode) have names beginning
 216    with $ or $$, e.g. $$dyncall, which handles inter-space procedure
 217    calls on PA-RISC.  Tell the expression parser to check for those
 218    when parsing tokens that begin with "$".  */
 219 #define SYMBOLS_CAN_START_WITH_DOLLAR (1)