dwarf.h revision f9b7af51ed3e2facd519a9bfd243ea367a242d35
1eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* libunwind - a platform-independent unwind library 2f9b7af51ed3e2facd519a9bfd243ea367a242d35hp.com!davidm Copyright (c) 2003-2005 Hewlett-Packard Development Company, L.P. 3eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm Contributed by David Mosberger-Tang <davidm@hpl.hp.com> 4eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 5eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmThis file is part of libunwind. 6eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 7eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmPermission is hereby granted, free of charge, to any person obtaining 8eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidma copy of this software and associated documentation files (the 9eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm"Software"), to deal in the Software without restriction, including 10eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmwithout limitation the rights to use, copy, modify, merge, publish, 11eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdistribute, sublicense, and/or sell copies of the Software, and to 12eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmpermit persons to whom the Software is furnished to do so, subject to 13eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmthe following conditions: 14eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 15eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmThe above copyright notice and this permission notice shall be 16eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmincluded in all copies or substantial portions of the Software. 17eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 18eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmTHE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 19eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 21eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 22eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 23eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 24eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ 25eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 26eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#ifndef dwarf_h 27eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_h 28eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 29f9b7af51ed3e2facd519a9bfd243ea367a242d35hp.com!davidm#include <libunwind.h> 30eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 31eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmstruct dwarf_cursor; /* forward-declaration */ 32eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 33eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#include "dwarf-config.h" 34eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 35eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* DWARF expression opcodes. */ 36eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 37eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef enum 38eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 39eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_addr = 0x03, 40eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_deref = 0x06, 41eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const1u = 0x08, 42eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const1s = 0x09, 43eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const2u = 0x0a, 44eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const2s = 0x0b, 45eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const4u = 0x0c, 46eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const4s = 0x0d, 47eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const8u = 0x0e, 48eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_const8s = 0x0f, 49eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_constu = 0x10, 50eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_consts = 0x11, 51eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_dup = 0x12, 52eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_drop = 0x13, 53eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_over = 0x14, 54eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_pick = 0x15, 55eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_swap = 0x16, 56eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_rot = 0x17, 57eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_xderef = 0x18, 58eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_abs = 0x19, 59eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_and = 0x1a, 60eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_div = 0x1b, 61eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_minus = 0x1c, 62eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_mod = 0x1d, 63eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_mul = 0x1e, 64eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_neg = 0x1f, 65eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_not = 0x20, 66eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_or = 0x21, 67eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_plus = 0x22, 68eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_plus_uconst = 0x23, 69eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_shl = 0x24, 70eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_shr = 0x25, 71eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_shra = 0x26, 72eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_xor = 0x27, 73eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_skip = 0x2f, 74eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_bra = 0x28, 75eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_eq = 0x29, 76eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_ge = 0x2a, 77eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_gt = 0x2b, 78eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_le = 0x2c, 79eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lt = 0x2d, 80eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_ne = 0x2e, 81eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit0 = 0x30, 82eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit1, DW_OP_lit2, DW_OP_lit3, DW_OP_lit4, DW_OP_lit5, 83eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit6, DW_OP_lit7, DW_OP_lit8, DW_OP_lit9, DW_OP_lit10, 84eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit11, DW_OP_lit12, DW_OP_lit13, DW_OP_lit14, DW_OP_lit15, 85eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit16, DW_OP_lit17, DW_OP_lit18, DW_OP_lit19, DW_OP_lit20, 86eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit21, DW_OP_lit22, DW_OP_lit23, DW_OP_lit24, DW_OP_lit25, 87eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit26, DW_OP_lit27, DW_OP_lit28, DW_OP_lit29, DW_OP_lit30, 88eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lit31, 89eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg0 = 0x50, 90eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg1, DW_OP_reg2, DW_OP_reg3, DW_OP_reg4, DW_OP_reg5, 91eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg6, DW_OP_reg7, DW_OP_reg8, DW_OP_reg9, DW_OP_reg10, 92eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg11, DW_OP_reg12, DW_OP_reg13, DW_OP_reg14, DW_OP_reg15, 93eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg16, DW_OP_reg17, DW_OP_reg18, DW_OP_reg19, DW_OP_reg20, 94eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg21, DW_OP_reg22, DW_OP_reg23, DW_OP_reg24, DW_OP_reg25, 95eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg26, DW_OP_reg27, DW_OP_reg28, DW_OP_reg29, DW_OP_reg30, 96eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_reg31, 97eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg0 = 0x70, 98eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg1, DW_OP_breg2, DW_OP_breg3, DW_OP_breg4, DW_OP_breg5, 99eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg6, DW_OP_breg7, DW_OP_breg8, DW_OP_breg9, DW_OP_breg10, 100eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg11, DW_OP_breg12, DW_OP_breg13, DW_OP_breg14, DW_OP_breg15, 101eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg16, DW_OP_breg17, DW_OP_breg18, DW_OP_breg19, DW_OP_breg20, 102eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg21, DW_OP_breg22, DW_OP_breg23, DW_OP_breg24, DW_OP_breg25, 103eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg26, DW_OP_breg27, DW_OP_breg28, DW_OP_breg29, DW_OP_breg30, 104eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_breg31, 105eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_regx = 0x90, 106eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_fbreg = 0x91, 107eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_bregx = 0x92, 108eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_piece = 0x93, 109eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_deref_size = 0x94, 110eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_xderef_size = 0x95, 111eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_nop = 0x96, 112eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_push_object_address = 0x97, 113eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_call2 = 0x98, 114eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_call4 = 0x99, 115eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_call_ref = 0x9a, 116eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_lo_user = 0xe0, 117eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_OP_hi_user = 0xff 118eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 119eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_expr_op_t; 120eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 121eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DWARF_CIE_VERSION 3 /* GCC emits version 1??? */ 122eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 123eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DWARF_CFA_OPCODE_MASK 0xc0 124eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DWARF_CFA_OPERAND_MASK 0x3f 125eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 126eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef enum 127eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 128eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_advance_loc = 0x40, 129eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_offset = 0x80, 130eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_restore = 0xc0, 131eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_nop = 0x00, 132eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_set_loc = 0x01, 133eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_advance_loc1 = 0x02, 134eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_advance_loc2 = 0x03, 135eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_advance_loc4 = 0x04, 136eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_offset_extended = 0x05, 137eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_restore_extended = 0x06, 138eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_undefined = 0x07, 139eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_same_value = 0x08, 140eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_register = 0x09, 141eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_remember_state = 0x0a, 142eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_restore_state = 0x0b, 143eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_def_cfa = 0x0c, 144eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_def_cfa_register = 0x0d, 145eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_def_cfa_offset = 0x0e, 146eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_def_cfa_expression = 0x0f, 147adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm DW_CFA_expression = 0x10, 148eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_offset_extended_sf = 0x11, 149eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_def_cfa_sf = 0x12, 150eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_def_cfa_offset_sf = 0x13, 151eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_lo_user = 0x1c, 152eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_MIPS_advance_loc8 = 0x1d, 153eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_GNU_window_save = 0x2d, 154eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_GNU_args_size = 0x2e, 155eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_GNU_negative_offset_extended = 0x2f, 156eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DW_CFA_hi_user = 0x3c 157eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 158eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_cfa_t; 159eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 160eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* DWARF Pointer-Encoding (PEs). 161eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 162eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm Pointer-Encodings were invented for the GCC exception-handling 163eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm support for C++, but they represent a rather generic way of 164eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm describing the format in which an address/pointer is stored and 165eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm hence we include the definitions here, in the main dwarf.h file. 166eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm The Pointer-Encoding format is partially documented in Linux Base 167eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm Spec v1.3 (http://www.linuxbase.org/spec/). The rest is reverse 168eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm engineered from GCC. 169eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 170eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm*/ 171eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_FORMAT_MASK 0x0f /* format of the encoded value */ 172eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_APPL_MASK 0x70 /* how the value is to be applied */ 173eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* Flag bit. If set, the resulting pointer is the address of the word 174eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm that contains the final address. */ 175eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_indirect 0x80 176eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 177eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* Pointer-encoding formats: */ 178eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_omit 0xff 179eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_ptr 0x00 /* pointer-sized unsigned value */ 180eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_uleb128 0x01 /* unsigned LE base-128 value */ 181eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_udata2 0x02 /* unsigned 16-bit value */ 182eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_udata4 0x03 /* unsigned 32-bit value */ 183eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_udata8 0x04 /* unsigned 64-bit value */ 184eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_sleb128 0x09 /* signed LE base-128 value */ 185eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_sdata2 0x0a /* signed 16-bit value */ 186eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_sdata4 0x0b /* signed 32-bit value */ 187eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_sdata8 0x0c /* signed 64-bit value */ 188eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 189eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* Pointer-encoding application: */ 190eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_absptr 0x00 /* absolute value */ 191eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_pcrel 0x10 /* rel. to addr. of encoded value */ 192eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_textrel 0x20 /* text-relative (GCC-specific???) */ 193eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_datarel 0x30 /* data-relative */ 194eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* The following are not documented by LSB v1.3, yet they are used by 195eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm GCC, presumably they aren't documented by LSB since they aren't 196eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm used on Linux: */ 197eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_funcrel 0x40 /* start-of-procedure-relative */ 198eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DW_EH_PE_aligned 0x50 /* aligned pointer */ 199eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 200eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef enum 201eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 202eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DWARF_WHERE_UNDEF, /* register isn't saved at all */ 203eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DWARF_WHERE_SAME, /* register has same value as in prev. frame */ 204eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DWARF_WHERE_CFAREL, /* register saved at CFA-relative address */ 205eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DWARF_WHERE_REG, /* register saved in another register */ 206eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm DWARF_WHERE_EXPR, /* register saved */ 207eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 208eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_where_t; 209eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 210eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef struct 211eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 212eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm dwarf_where_t where; /* how is the register saved? */ 213eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_word_t val; /* where it's saved */ 214eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 215eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_save_loc_t; 216eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 217eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* For uniformity, we'd like to treat the CFA save-location like any 218eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm other register save-location, but this doesn't quite work, because 219eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm the CFA can be expressed as a (REGISTER,OFFSET) pair. To handle 220eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm this, we use two dwarf_save_loc structures to describe the CFA. 221eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm The first one (CFA_REG_COLUMN), tells us where the CFA is saved. 222eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm In the case of DWARF_WHERE_EXPR, the CFA is defined by a DWARF 223eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm location expression whose address is given by member "val". In the 224eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm case of DWARF_WHERE_REG, member "val" gives the number of the 225eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm base-register and the "val" member of DWARF_CFA_OFF_COLUMN gives 226eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm the offset value. */ 227eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DWARF_CFA_REG_COLUMN DWARF_NUM_PRESERVED_REGS 228eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define DWARF_CFA_OFF_COLUMN (DWARF_NUM_PRESERVED_REGS + 1) 229eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 230eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef struct dwarf_reg_state 231eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 232eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm struct dwarf_reg_state *next; /* for rs_stack */ 233eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm dwarf_save_loc_t reg[DWARF_NUM_PRESERVED_REGS + 2]; 234eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 235eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_reg_state_t; 236eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 237adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidmtypedef struct dwarf_cie_info 238adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm { 239adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t cie_instr_start; /* start addr. of CIE "initial_instructions" */ 240adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t cie_instr_end; /* end addr. of CIE "initial_instructions" */ 241adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t fde_instr_start; /* start addr. of FDE "instructions" */ 242adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t fde_instr_end; /* end addr. of FDE "instructions" */ 243adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t code_align; /* code-alignment factor */ 244adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t data_align; /* data-alignment factor */ 245adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t ret_addr_column; /* column of return-address register */ 246adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t handler; /* address of personality-routine */ 247adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm uint16_t abi; 248adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm uint16_t tag; 249adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm uint8_t fde_encoding; 250adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm uint8_t lsda_encoding; 251adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unsigned int sized_augmentation : 1; 252adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unsigned int have_abi_marker : 1; 253adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm } 254adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidmdwarf_cie_info_t; 255adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm 256eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef struct dwarf_state_record 257eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 258eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unsigned char fde_encoding; 259eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_word_t args_size; 260eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 261eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm dwarf_reg_state_t rs_initial; /* reg-state after CIE instructions */ 262eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm dwarf_reg_state_t rs_current; /* current reg-state */ 263eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 264eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_state_record_t; 265eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 266eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmtypedef struct dwarf_cursor 267eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm { 268eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm void *as_arg; /* argument to address-space callbacks */ 269eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_addr_space_t as; /* reference to per-address-space info */ 270eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 271eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_word_t cfa; /* canonical frame address; aka frame-/stack-pointer */ 272eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_word_t ip; /* instruction pointer */ 273eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_word_t args_size; /* size of arguments */ 274eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_word_t ret_addr_column; /* column for return-address */ 275adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t eh_args[UNW_TDEP_NUM_EH_REGS]; 276adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unsigned int eh_valid_mask; 277eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 278eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm dwarf_loc_t loc[DWARF_NUM_PRESERVED_REGS]; 279eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 280eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unsigned int pi_valid :1; /* is proc_info valid? */ 281eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unsigned int pi_is_dynamic :1; /* proc_info found via dynamic proc info? */ 282eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm unw_proc_info_t pi; /* info about current procedure */ 283eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm } 284eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidmdwarf_cursor_t; 285eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 286eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm/* Convenience macros: */ 287eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_init UNW_ARCH_OBJ (dwarf_init) 288eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_find_proc_info UNW_OBJ (dwarf_find_proc_info) 289eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_search_unwind_table UNW_OBJ (dwarf_search_unwind_table) 290eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_put_unwind_info UNW_OBJ (dwarf_put_unwind_info) 291eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_put_unwind_info UNW_OBJ (dwarf_put_unwind_info) 292eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_eval_expr UNW_OBJ (dwarf_eval_expr) 293adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm#define dwarf_extract_proc_info_from_fde \ 294adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm UNW_OBJ (dwarf_extract_proc_info_from_fde) 295eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_find_save_locs UNW_OBJ (dwarf_find_save_locs) 296eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_create_state_record UNW_OBJ (dwarf_create_state_record) 297eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_make_proc_info UNW_OBJ (dwarf_make_proc_info) 298eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_read_encoded_pointer UNW_OBJ (dwarf_read_encoded_pointer) 299eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#define dwarf_step UNW_OBJ (dwarf_step) 300eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 301b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_init (void); 302b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_find_proc_info (unw_addr_space_t as, unw_word_t ip, 303b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_proc_info_t *pi, 304b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm int need_unwind_info, void *arg); 305b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_search_unwind_table (unw_addr_space_t as, 306b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_word_t ip, 307b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_dyn_info_t *di, 308b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_proc_info_t *pi, 309b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm int need_unwind_info, void *arg); 310b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern void dwarf_put_unwind_info (unw_addr_space_t as, 311b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_proc_info_t *pi, void *arg); 312b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_eval_expr (struct dwarf_cursor *c, unw_word_t *addr, 313b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_word_t len, unw_word_t *valp, 314b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm int *is_register); 315adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidmextern int dwarf_extract_proc_info_from_fde (unw_addr_space_t as, 316adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_accessors_t *a, 317adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_word_t *fde_addr, 318adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm unw_proc_info_t *pi, 319adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm int need_unwind_info, 320adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm void *arg); 321b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_find_save_locs (struct dwarf_cursor *c); 322b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_create_state_record (struct dwarf_cursor *c, 323b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm dwarf_state_record_t *sr); 324b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_make_proc_info (struct dwarf_cursor *c); 325b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_read_encoded_pointer (unw_addr_space_t as, 326b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_accessors_t *a, 327b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_word_t *addr, 328b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unsigned char encoding, 329adeb9b598452963f25808f5c338ea0c5f2eaf2b7mostang.com!davidm const unw_proc_info_t *pi, 330b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidm unw_word_t *valp, void *arg); 331b9d2cc7919cf343596fd007506492621311b1c43mostang.com!davidmextern int dwarf_step (struct dwarf_cursor *c); 332eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm 333eb51b4294aa18ab13c9496378abb25162688235bhp.com!davidm#endif /* dwarf_h */ 334