1 /* 2 * Copyright (C) 2009 Matt Fleming <matt@console-pimps.org> 3 * 4 * This file is subject to the terms and conditions of the GNU General Public 5 * License. See the file "COPYING" in the main directory of this archive 6 * for more details. 7 * 8 */ 9 #ifndef __ASM_SH_DWARF_H 10 #define __ASM_SH_DWARF_H 11 12 #ifdef CONFIG_DWARF_UNWINDER 13 14 /* 15 * DWARF expression operations 16 */ 17 #define DW_OP_addr 0x03 18 #define DW_OP_deref 0x06 19 #define DW_OP_const1u 0x08 20 #define DW_OP_const1s 0x09 21 #define DW_OP_const2u 0x0a 22 #define DW_OP_const2s 0x0b 23 #define DW_OP_const4u 0x0c 24 #define DW_OP_const4s 0x0d 25 #define DW_OP_const8u 0x0e 26 #define DW_OP_const8s 0x0f 27 #define DW_OP_constu 0x10 28 #define DW_OP_consts 0x11 29 #define DW_OP_dup 0x12 30 #define DW_OP_drop 0x13 31 #define DW_OP_over 0x14 32 #define DW_OP_pick 0x15 33 #define DW_OP_swap 0x16 34 #define DW_OP_rot 0x17 35 #define DW_OP_xderef 0x18 36 #define DW_OP_abs 0x19 37 #define DW_OP_and 0x1a 38 #define DW_OP_div 0x1b 39 #define DW_OP_minus 0x1c 40 #define DW_OP_mod 0x1d 41 #define DW_OP_mul 0x1e 42 #define DW_OP_neg 0x1f 43 #define DW_OP_not 0x20 44 #define DW_OP_or 0x21 45 #define DW_OP_plus 0x22 46 #define DW_OP_plus_uconst 0x23 47 #define DW_OP_shl 0x24 48 #define DW_OP_shr 0x25 49 #define DW_OP_shra 0x26 50 #define DW_OP_xor 0x27 51 #define DW_OP_skip 0x2f 52 #define DW_OP_bra 0x28 53 #define DW_OP_eq 0x29 54 #define DW_OP_ge 0x2a 55 #define DW_OP_gt 0x2b 56 #define DW_OP_le 0x2c 57 #define DW_OP_lt 0x2d 58 #define DW_OP_ne 0x2e 59 #define DW_OP_lit0 0x30 60 #define DW_OP_lit1 0x31 61 #define DW_OP_lit2 0x32 62 #define DW_OP_lit3 0x33 63 #define DW_OP_lit4 0x34 64 #define DW_OP_lit5 0x35 65 #define DW_OP_lit6 0x36 66 #define DW_OP_lit7 0x37 67 #define DW_OP_lit8 0x38 68 #define DW_OP_lit9 0x39 69 #define DW_OP_lit10 0x3a 70 #define DW_OP_lit11 0x3b 71 #define DW_OP_lit12 0x3c 72 #define DW_OP_lit13 0x3d 73 #define DW_OP_lit14 0x3e 74 #define DW_OP_lit15 0x3f 75 #define DW_OP_lit16 0x40 76 #define DW_OP_lit17 0x41 77 #define DW_OP_lit18 0x42 78 #define DW_OP_lit19 0x43 79 #define DW_OP_lit20 0x44 80 #define DW_OP_lit21 0x45 81 #define DW_OP_lit22 0x46 82 #define DW_OP_lit23 0x47 83 #define DW_OP_lit24 0x48 84 #define DW_OP_lit25 0x49 85 #define DW_OP_lit26 0x4a 86 #define DW_OP_lit27 0x4b 87 #define DW_OP_lit28 0x4c 88 #define DW_OP_lit29 0x4d 89 #define DW_OP_lit30 0x4e 90 #define DW_OP_lit31 0x4f 91 #define DW_OP_reg0 0x50 92 #define DW_OP_reg1 0x51 93 #define DW_OP_reg2 0x52 94 #define DW_OP_reg3 0x53 95 #define DW_OP_reg4 0x54 96 #define DW_OP_reg5 0x55 97 #define DW_OP_reg6 0x56 98 #define DW_OP_reg7 0x57 99 #define DW_OP_reg8 0x58 100 #define DW_OP_reg9 0x59 101 #define DW_OP_reg10 0x5a 102 #define DW_OP_reg11 0x5b 103 #define DW_OP_reg12 0x5c 104 #define DW_OP_reg13 0x5d 105 #define DW_OP_reg14 0x5e 106 #define DW_OP_reg15 0x5f 107 #define DW_OP_reg16 0x60 108 #define DW_OP_reg17 0x61 109 #define DW_OP_reg18 0x62 110 #define DW_OP_reg19 0x63 111 #define DW_OP_reg20 0x64 112 #define DW_OP_reg21 0x65 113 #define DW_OP_reg22 0x66 114 #define DW_OP_reg23 0x67 115 #define DW_OP_reg24 0x68 116 #define DW_OP_reg25 0x69 117 #define DW_OP_reg26 0x6a 118 #define DW_OP_reg27 0x6b 119 #define DW_OP_reg28 0x6c 120 #define DW_OP_reg29 0x6d 121 #define DW_OP_reg30 0x6e 122 #define DW_OP_reg31 0x6f 123 #define DW_OP_breg0 0x70 124 #define DW_OP_breg1 0x71 125 #define DW_OP_breg2 0x72 126 #define DW_OP_breg3 0x73 127 #define DW_OP_breg4 0x74 128 #define DW_OP_breg5 0x75 129 #define DW_OP_breg6 0x76 130 #define DW_OP_breg7 0x77 131 #define DW_OP_breg8 0x78 132 #define DW_OP_breg9 0x79 133 #define DW_OP_breg10 0x7a 134 #define DW_OP_breg11 0x7b 135 #define DW_OP_breg12 0x7c 136 #define DW_OP_breg13 0x7d 137 #define DW_OP_breg14 0x7e 138 #define DW_OP_breg15 0x7f 139 #define DW_OP_breg16 0x80 140 #define DW_OP_breg17 0x81 141 #define DW_OP_breg18 0x82 142 #define DW_OP_breg19 0x83 143 #define DW_OP_breg20 0x84 144 #define DW_OP_breg21 0x85 145 #define DW_OP_breg22 0x86 146 #define DW_OP_breg23 0x87 147 #define DW_OP_breg24 0x88 148 #define DW_OP_breg25 0x89 149 #define DW_OP_breg26 0x8a 150 #define DW_OP_breg27 0x8b 151 #define DW_OP_breg28 0x8c 152 #define DW_OP_breg29 0x8d 153 #define DW_OP_breg30 0x8e 154 #define DW_OP_breg31 0x8f 155 #define DW_OP_regx 0x90 156 #define DW_OP_fbreg 0x91 157 #define DW_OP_bregx 0x92 158 #define DW_OP_piece 0x93 159 #define DW_OP_deref_size 0x94 160 #define DW_OP_xderef_size 0x95 161 #define DW_OP_nop 0x96 162 #define DW_OP_push_object_address 0x97 163 #define DW_OP_call2 0x98 164 #define DW_OP_call4 0x99 165 #define DW_OP_call_ref 0x9a 166 #define DW_OP_form_tls_address 0x9b 167 #define DW_OP_call_frame_cfa 0x9c 168 #define DW_OP_bit_piece 0x9d 169 #define DW_OP_lo_user 0xe0 170 #define DW_OP_hi_user 0xff 171 172 /* 173 * Addresses used in FDE entries in the .eh_frame section may be encoded 174 * using one of the following encodings. 175 */ 176 #define DW_EH_PE_absptr 0x00 177 #define DW_EH_PE_omit 0xff 178 #define DW_EH_PE_uleb128 0x01 179 #define DW_EH_PE_udata2 0x02 180 #define DW_EH_PE_udata4 0x03 181 #define DW_EH_PE_udata8 0x04 182 #define DW_EH_PE_sleb128 0x09 183 #define DW_EH_PE_sdata2 0x0a 184 #define DW_EH_PE_sdata4 0x0b 185 #define DW_EH_PE_sdata8 0x0c 186 #define DW_EH_PE_signed 0x09 187 188 #define DW_EH_PE_pcrel 0x10 189 190 /* 191 * The architecture-specific register number that contains the return 192 * address in the .debug_frame table. 193 */ 194 #define DWARF_ARCH_RA_REG 17 195 196 #ifndef __ASSEMBLY__ 197 /* 198 * Read either the frame pointer (r14) or the stack pointer (r15). 199 * NOTE: this MUST be inlined. 200 */ 201 static __always_inline unsigned long dwarf_read_arch_reg(unsigned int reg) 202 { 203 unsigned long value = 0; 204 205 switch (reg) { 206 case 14: 207 __asm__ __volatile__("mov r14, %0\n" : "=r" (value)); 208 break; 209 case 15: 210 __asm__ __volatile__("mov r15, %0\n" : "=r" (value)); 211 break; 212 default: 213 BUG(); 214 } 215 216 return value; 217 } 218 219 /** 220 * dwarf_cie - Common Information Entry 221 */ 222 struct dwarf_cie { 223 unsigned long length; 224 unsigned long cie_id; 225 unsigned char version; 226 const char *augmentation; 227 unsigned int code_alignment_factor; 228 int data_alignment_factor; 229 230 /* Which column in the rule table represents return addr of func. */ 231 unsigned int return_address_reg; 232 233 unsigned char *initial_instructions; 234 unsigned char *instructions_end; 235 236 unsigned char encoding; 237 238 unsigned long cie_pointer; 239 240 struct list_head link; 241 242 unsigned long flags; 243 #define DWARF_CIE_Z_AUGMENTATION (1 << 0) 244 245 /* 246 * 'mod' will be non-NULL if this CIE came from a module's 247 * .eh_frame section. 248 */ 249 struct module *mod; 250 }; 251 252 /** 253 * dwarf_fde - Frame Description Entry 254 */ 255 struct dwarf_fde { 256 unsigned long length; 257 unsigned long cie_pointer; 258 struct dwarf_cie *cie; 259 unsigned long initial_location; 260 unsigned long address_range; 261 unsigned char *instructions; 262 unsigned char *end; 263 struct list_head link; 264 265 /* 266 * 'mod' will be non-NULL if this FDE came from a module's 267 * .eh_frame section. 268 */ 269 struct module *mod; 270 }; 271 272 /** 273 * dwarf_frame - DWARF information for a frame in the call stack 274 */ 275 struct dwarf_frame { 276 struct dwarf_frame *prev, *next; 277 278 unsigned long pc; 279 280 struct list_head reg_list; 281 282 unsigned long cfa; 283 284 /* Valid when DW_FRAME_CFA_REG_OFFSET is set in flags */ 285 unsigned int cfa_register; 286 unsigned int cfa_offset; 287 288 /* Valid when DW_FRAME_CFA_REG_EXP is set in flags */ 289 unsigned char *cfa_expr; 290 unsigned int cfa_expr_len; 291 292 unsigned long flags; 293 #define DWARF_FRAME_CFA_REG_OFFSET (1 << 0) 294 #define DWARF_FRAME_CFA_REG_EXP (1 << 1) 295 296 unsigned long return_addr; 297 }; 298 299 /** 300 * dwarf_reg - DWARF register 301 * @flags: Describes how to calculate the value of this register 302 */ 303 struct dwarf_reg { 304 struct list_head link; 305 306 unsigned int number; 307 308 unsigned long addr; 309 unsigned long flags; 310 #define DWARF_REG_OFFSET (1 << 0) 311 #define DWARF_VAL_OFFSET (1 << 1) 312 #define DWARF_UNDEFINED (1 << 2) 313 }; 314 315 /* 316 * Call Frame instruction opcodes. 317 */ 318 #define DW_CFA_advance_loc 0x40 319 #define DW_CFA_offset 0x80 320 #define DW_CFA_restore 0xc0 321 #define DW_CFA_nop 0x00 322 #define DW_CFA_set_loc 0x01 323 #define DW_CFA_advance_loc1 0x02 324 #define DW_CFA_advance_loc2 0x03 325 #define DW_CFA_advance_loc4 0x04 326 #define DW_CFA_offset_extended 0x05 327 #define DW_CFA_restore_extended 0x06 328 #define DW_CFA_undefined 0x07 329 #define DW_CFA_same_value 0x08 330 #define DW_CFA_register 0x09 331 #define DW_CFA_remember_state 0x0a 332 #define DW_CFA_restore_state 0x0b 333 #define DW_CFA_def_cfa 0x0c 334 #define DW_CFA_def_cfa_register 0x0d 335 #define DW_CFA_def_cfa_offset 0x0e 336 #define DW_CFA_def_cfa_expression 0x0f 337 #define DW_CFA_expression 0x10 338 #define DW_CFA_offset_extended_sf 0x11 339 #define DW_CFA_def_cfa_sf 0x12 340 #define DW_CFA_def_cfa_offset_sf 0x13 341 #define DW_CFA_val_offset 0x14 342 #define DW_CFA_val_offset_sf 0x15 343 #define DW_CFA_val_expression 0x16 344 #define DW_CFA_lo_user 0x1c 345 #define DW_CFA_hi_user 0x3f 346 347 /* GNU extension opcodes */ 348 #define DW_CFA_GNU_args_size 0x2e 349 #define DW_CFA_GNU_negative_offset_extended 0x2f 350 351 /* 352 * Some call frame instructions encode their operands in the opcode. We 353 * need some helper functions to extract both the opcode and operands 354 * from an instruction. 355 */ 356 static inline unsigned int DW_CFA_opcode(unsigned long insn) 357 { 358 return (insn & 0xc0); 359 } 360 361 static inline unsigned int DW_CFA_operand(unsigned long insn) 362 { 363 return (insn & 0x3f); 364 } 365 366 #define DW_EH_FRAME_CIE 0 /* .eh_frame CIE IDs are 0 */ 367 #define DW_CIE_ID 0xffffffff 368 #define DW64_CIE_ID 0xffffffffffffffffULL 369 370 /* 371 * DWARF FDE/CIE length field values. 372 */ 373 #define DW_EXT_LO 0xfffffff0 374 #define DW_EXT_HI 0xffffffff 375 #define DW_EXT_DWARF64 DW_EXT_HI 376 377 extern struct dwarf_frame *dwarf_unwind_stack(unsigned long, 378 struct dwarf_frame *); 379 extern void dwarf_free_frame(struct dwarf_frame *); 380 extern int dwarf_parse_section(char *, char *, struct module *); 381 extern void dwarf_module_unload(struct module *); 382 383 #endif /* !__ASSEMBLY__ */ 384 385 #define CFI_STARTPROC .cfi_startproc 386 #define CFI_ENDPROC .cfi_endproc 387 #define CFI_DEF_CFA .cfi_def_cfa 388 #define CFI_REGISTER .cfi_register 389 #define CFI_REL_OFFSET .cfi_rel_offset 390 #define CFI_UNDEFINED .cfi_undefined 391 392 #else 393 394 /* 395 * Use the asm comment character to ignore the rest of the line. 396 */ 397 #define CFI_IGNORE ! 398 399 #define CFI_STARTPROC CFI_IGNORE 400 #define CFI_ENDPROC CFI_IGNORE 401 #define CFI_DEF_CFA CFI_IGNORE 402 #define CFI_REGISTER CFI_IGNORE 403 #define CFI_REL_OFFSET CFI_IGNORE 404 #define CFI_UNDEFINED CFI_IGNORE 405 406 #ifndef __ASSEMBLY__ 407 static inline void dwarf_unwinder_init(void) 408 { 409 } 410 #endif 411 412 #endif /* CONFIG_DWARF_UNWINDER */ 413 414 #endif /* __ASM_SH_DWARF_H */ 415