1 /* Target-dependent code for the HP PA-RISC architecture. 2 3 Copyright (C) 2003-2023 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 HPPA_TDEP_H 21 #define HPPA_TDEP_H 22 23 #include "gdbarch.h" 24 25 struct trad_frame_saved_reg; 26 struct objfile; 27 struct so_list; 28 29 /* Register numbers of various important registers. */ 30 31 enum hppa_regnum 32 { 33 HPPA_R0_REGNUM = 0, /* Doesn't actually exist, used as base for 34 other r registers. */ 35 HPPA_R1_REGNUM = 1, 36 HPPA_FLAGS_REGNUM = 0, /* Various status flags */ 37 HPPA_RP_REGNUM = 2, /* return pointer */ 38 HPPA_FP_REGNUM = 3, /* The ABI's frame pointer, when used */ 39 HPPA_DP_REGNUM = 27, 40 HPPA_RET0_REGNUM = 28, 41 HPPA_RET1_REGNUM = 29, 42 HPPA_SP_REGNUM = 30, /* Stack pointer. */ 43 HPPA_R31_REGNUM = 31, 44 HPPA_SAR_REGNUM = 32, /* Shift Amount Register */ 45 HPPA_IPSW_REGNUM = 41, /* Interrupt Processor Status Word */ 46 HPPA_PCOQ_HEAD_REGNUM = 33, /* instruction offset queue head */ 47 HPPA_PCSQ_HEAD_REGNUM = 34, /* instruction space queue head */ 48 HPPA_PCOQ_TAIL_REGNUM = 35, /* instruction offset queue tail */ 49 HPPA_PCSQ_TAIL_REGNUM = 36, /* instruction space queue tail */ 50 HPPA_EIEM_REGNUM = 37, /* External Interrupt Enable Mask */ 51 HPPA_IIR_REGNUM = 38, /* Interrupt Instruction Register */ 52 HPPA_ISR_REGNUM = 39, /* Interrupt Space Register */ 53 HPPA_IOR_REGNUM = 40, /* Interrupt Offset Register */ 54 HPPA_SR4_REGNUM = 43, /* space register 4 */ 55 HPPA_SR0_REGNUM = 44, /* space register 0 */ 56 HPPA_SR1_REGNUM = 45, /* space register 1 */ 57 HPPA_SR2_REGNUM = 46, /* space register 2 */ 58 HPPA_SR3_REGNUM = 47, /* space register 3 */ 59 HPPA_SR5_REGNUM = 48, /* space register 5 */ 60 HPPA_SR6_REGNUM = 49, /* space register 6 */ 61 HPPA_SR7_REGNUM = 50, /* space register 7 */ 62 HPPA_RCR_REGNUM = 51, /* Recover Counter (also known as cr0) */ 63 HPPA_PID0_REGNUM = 52, /* Protection ID */ 64 HPPA_PID1_REGNUM = 53, /* Protection ID */ 65 HPPA_PID2_REGNUM = 55, /* Protection ID */ 66 HPPA_PID3_REGNUM = 56, /* Protection ID */ 67 HPPA_CCR_REGNUM = 54, /* Coprocessor Configuration Register */ 68 HPPA_TR0_REGNUM = 57, /* Temporary Registers (cr24 -> cr31) */ 69 HPPA_CR26_REGNUM = 59, 70 HPPA_CR27_REGNUM = 60, /* Base register for thread-local 71 storage, cr27 */ 72 HPPA_FP0_REGNUM = 64, /* First floating-point. */ 73 HPPA_FP4_REGNUM = 72, 74 HPPA64_FP4_REGNUM = 68, 75 HPPA_FP31R_REGNUM = 127, /* Last floating-point. */ 76 77 HPPA_ARG0_REGNUM = 26, /* The first argument of a callee. */ 78 HPPA_ARG1_REGNUM = 25, /* The second argument of a callee. */ 79 HPPA_ARG2_REGNUM = 24, /* The third argument of a callee. */ 80 HPPA_ARG3_REGNUM = 23 /* The fourth argument of a callee. */ 81 }; 82 83 /* Instruction size. */ 84 #define HPPA_INSN_SIZE 4 85 86 /* Target-dependent structure in gdbarch. */ 87 struct hppa_gdbarch_tdep : gdbarch_tdep_base 88 { 89 /* The number of bytes in an address. For now, this field is designed 90 to allow us to differentiate hppa32 from hppa64 targets. */ 91 int bytes_per_address = 0; 92 93 /* Is this an ELF target? This can be 64-bit HP-UX, or a 32/64-bit GNU/Linux 94 system. */ 95 int is_elf = 0; 96 97 /* Given a function address, try to find the global pointer for the 98 corresponding shared object. */ 99 CORE_ADDR (*find_global_pointer) (struct gdbarch *, struct value *) = nullptr; 100 101 /* For shared libraries, each call goes through a small piece of 102 trampoline code in the ".plt" section. IN_SOLIB_CALL_TRAMPOLINE 103 evaluates to nonzero if we are currently stopped in one of these. */ 104 int (*in_solib_call_trampoline) (struct gdbarch *gdbarch, 105 CORE_ADDR pc) = nullptr; 106 107 /* For targets that support multiple spaces, we may have additional stubs 108 in the return path. These stubs are internal to the ABI, and users are 109 not interested in them. If we detect that we are returning to a stub, 110 adjust the pc to the real caller. This improves the behavior of commands 111 that traverse frames such as "up" and "finish". */ 112 void (*unwind_adjust_stub) (frame_info_ptr this_frame, CORE_ADDR base, 113 trad_frame_saved_reg *saved_regs) = nullptr; 114 115 /* These are solib-dependent methods. They are really HPUX only, but 116 we don't have a HPUX-specific tdep vector at the moment. */ 117 CORE_ADDR (*solib_thread_start_addr) (struct so_list *so) = nullptr; 118 CORE_ADDR (*solib_get_got_by_pc) (CORE_ADDR addr) = nullptr; 119 CORE_ADDR (*solib_get_solib_by_pc) (CORE_ADDR addr) = nullptr; 120 CORE_ADDR (*solib_get_text_base) (struct objfile *objfile) = nullptr; 121 }; 122 123 /* 124 * Unwind table and descriptor. 125 */ 126 127 struct unwind_table_entry 128 { 129 CORE_ADDR region_start; 130 CORE_ADDR region_end; 131 132 unsigned int Cannot_unwind:1; /* 0 */ 133 unsigned int Millicode:1; /* 1 */ 134 unsigned int Millicode_save_sr0:1; /* 2 */ 135 unsigned int Region_description:2; /* 3..4 */ 136 unsigned int reserved:1; /* 5 */ 137 unsigned int Entry_SR:1; /* 6 */ 138 unsigned int Entry_FR:4; /* number saved *//* 7..10 */ 139 unsigned int Entry_GR:5; /* number saved *//* 11..15 */ 140 unsigned int Args_stored:1; /* 16 */ 141 unsigned int Variable_Frame:1; /* 17 */ 142 unsigned int Separate_Package_Body:1; /* 18 */ 143 unsigned int Frame_Extension_Millicode:1; /* 19 */ 144 unsigned int Stack_Overflow_Check:1; /* 20 */ 145 unsigned int Two_Instruction_SP_Increment:1; /* 21 */ 146 unsigned int sr4export:1; /* 22 */ 147 unsigned int cxx_info:1; /* 23 */ 148 unsigned int cxx_try_catch:1; /* 24 */ 149 unsigned int sched_entry_seq:1; /* 25 */ 150 unsigned int reserved1:1; /* 26 */ 151 unsigned int Save_SP:1; /* 27 */ 152 unsigned int Save_RP:1; /* 28 */ 153 unsigned int Save_MRP_in_frame:1; /* 29 */ 154 unsigned int save_r19:1; /* 30 */ 155 unsigned int Cleanup_defined:1; /* 31 */ 156 157 unsigned int MPE_XL_interrupt_marker:1; /* 0 */ 158 unsigned int HP_UX_interrupt_marker:1; /* 1 */ 159 unsigned int Large_frame:1; /* 2 */ 160 unsigned int alloca_frame:1; /* 3 */ 161 unsigned int reserved2:1; /* 4 */ 162 unsigned int Total_frame_size:27; /* 5..31 */ 163 164 /* This is *NOT* part of an actual unwind_descriptor in an object 165 file. It is *ONLY* part of the "internalized" descriptors that 166 we create from those in a file. */ 167 168 struct 169 { 170 unsigned int stub_type:4; /* 0..3 */ 171 unsigned int padding:28; /* 4..31 */ 172 } 173 stub_unwind; 174 }; 175 176 /* HP linkers also generate unwinds for various linker-generated stubs. 177 GDB reads in the stubs from the $UNWIND_END$ subspace, then 178 "converts" them into normal unwind entries using some of the reserved 179 fields to store the stub type. */ 180 181 /* The gaps represent linker stubs used in MPE and space for future 182 expansion. */ 183 enum unwind_stub_types 184 { 185 LONG_BRANCH = 1, 186 PARAMETER_RELOCATION = 2, 187 EXPORT = 10, 188 IMPORT = 11, 189 IMPORT_SHLIB = 12, 190 }; 191 192 struct unwind_table_entry *find_unwind_entry (CORE_ADDR); 193 194 int hppa_get_field (unsigned word, int from, int to); 195 int hppa_extract_5_load (unsigned int); 196 unsigned hppa_extract_5R_store (unsigned int); 197 unsigned hppa_extract_5r_store (unsigned int); 198 int hppa_extract_17 (unsigned int); 199 int hppa_extract_21 (unsigned); 200 int hppa_extract_14 (unsigned); 201 CORE_ADDR hppa_symbol_address(const char *sym); 202 203 extern struct value * 204 hppa_frame_prev_register_helper (frame_info_ptr this_frame, 205 trad_frame_saved_reg *saved_regs, 206 int regnum); 207 208 extern CORE_ADDR hppa_read_pc (struct regcache *regcache); 209 extern void hppa_write_pc (struct regcache *regcache, CORE_ADDR pc); 210 extern CORE_ADDR hppa_unwind_pc (struct gdbarch *gdbarch, 211 frame_info_ptr next_frame); 212 213 extern int hppa_in_solib_call_trampoline (struct gdbarch *gdbarch, 214 CORE_ADDR pc); 215 extern CORE_ADDR hppa_skip_trampoline_code (frame_info_ptr, CORE_ADDR pc); 216 217 #endif /* hppa-tdep.h */ 218