zig/lib/std/dwarf.zig
Andrew Kelley 4607770a57 std.debug.Dwarf.expression: partial rework
- use labeled continue
- avoid anytype
- avoid dependency on a "seeking" API
- simpler, more optimal VM interpreter loop
- progress decoupling from host machine
- type safety for opcodes. see #15556
2025-07-01 16:35:29 -07:00

403 lines
9.4 KiB
Zig

//! DWARF debugging data format.
//!
//! This namespace contains unopinionated types and data definitions only. For
//! an implementation of parsing and caching DWARF information, see
//! `std.debug.Dwarf`.
pub const TAG = @import("dwarf/TAG.zig");
pub const AT = @import("dwarf/AT.zig");
pub const OP = enum(u8) {
addr = 0x03,
deref = 0x06,
const1u = 0x08,
const1s = 0x09,
const2u = 0x0a,
const2s = 0x0b,
const4u = 0x0c,
const4s = 0x0d,
const8u = 0x0e,
const8s = 0x0f,
constu = 0x10,
consts = 0x11,
dup = 0x12,
drop = 0x13,
over = 0x14,
pick = 0x15,
swap = 0x16,
rot = 0x17,
xderef = 0x18,
abs = 0x19,
@"and" = 0x1a,
div = 0x1b,
minus = 0x1c,
mod = 0x1d,
mul = 0x1e,
neg = 0x1f,
not = 0x20,
@"or" = 0x21,
plus = 0x22,
plus_uconst = 0x23,
shl = 0x24,
shr = 0x25,
shra = 0x26,
xor = 0x27,
bra = 0x28,
eq = 0x29,
ge = 0x2a,
gt = 0x2b,
le = 0x2c,
lt = 0x2d,
ne = 0x2e,
skip = 0x2f,
lit0 = 0x30,
lit1 = 0x31,
lit2 = 0x32,
lit3 = 0x33,
lit4 = 0x34,
lit5 = 0x35,
lit6 = 0x36,
lit7 = 0x37,
lit8 = 0x38,
lit9 = 0x39,
lit10 = 0x3a,
lit11 = 0x3b,
lit12 = 0x3c,
lit13 = 0x3d,
lit14 = 0x3e,
lit15 = 0x3f,
lit16 = 0x40,
lit17 = 0x41,
lit18 = 0x42,
lit19 = 0x43,
lit20 = 0x44,
lit21 = 0x45,
lit22 = 0x46,
lit23 = 0x47,
lit24 = 0x48,
lit25 = 0x49,
lit26 = 0x4a,
lit27 = 0x4b,
lit28 = 0x4c,
lit29 = 0x4d,
lit30 = 0x4e,
lit31 = 0x4f,
reg0 = 0x50,
reg1 = 0x51,
reg2 = 0x52,
reg3 = 0x53,
reg4 = 0x54,
reg5 = 0x55,
reg6 = 0x56,
reg7 = 0x57,
reg8 = 0x58,
reg9 = 0x59,
reg10 = 0x5a,
reg11 = 0x5b,
reg12 = 0x5c,
reg13 = 0x5d,
reg14 = 0x5e,
reg15 = 0x5f,
reg16 = 0x60,
reg17 = 0x61,
reg18 = 0x62,
reg19 = 0x63,
reg20 = 0x64,
reg21 = 0x65,
reg22 = 0x66,
reg23 = 0x67,
reg24 = 0x68,
reg25 = 0x69,
reg26 = 0x6a,
reg27 = 0x6b,
reg28 = 0x6c,
reg29 = 0x6d,
reg30 = 0x6e,
reg31 = 0x6f,
breg0 = 0x70,
breg1 = 0x71,
breg2 = 0x72,
breg3 = 0x73,
breg4 = 0x74,
breg5 = 0x75,
breg6 = 0x76,
breg7 = 0x77,
breg8 = 0x78,
breg9 = 0x79,
breg10 = 0x7a,
breg11 = 0x7b,
breg12 = 0x7c,
breg13 = 0x7d,
breg14 = 0x7e,
breg15 = 0x7f,
breg16 = 0x80,
breg17 = 0x81,
breg18 = 0x82,
breg19 = 0x83,
breg20 = 0x84,
breg21 = 0x85,
breg22 = 0x86,
breg23 = 0x87,
breg24 = 0x88,
breg25 = 0x89,
breg26 = 0x8a,
breg27 = 0x8b,
breg28 = 0x8c,
breg29 = 0x8d,
breg30 = 0x8e,
breg31 = 0x8f,
regx = 0x90,
fbreg = 0x91,
bregx = 0x92,
piece = 0x93,
deref_size = 0x94,
xderef_size = 0x95,
nop = 0x96,
// DWARF 3 extensions.
push_object_address = 0x97,
call2 = 0x98,
call4 = 0x99,
call_ref = 0x9a,
form_tls_address = 0x9b,
call_frame_cfa = 0x9c,
bit_piece = 0x9d,
// DWARF 4 extensions.
implicit_value = 0x9e,
stack_value = 0x9f,
// DWARF 5 extensions.
implicit_pointer = 0xa0,
addrx = 0xa1,
constx = 0xa2,
entry_value = 0xa3,
const_type = 0xa4,
regval_type = 0xa5,
deref_type = 0xa6,
xderef_type = 0xa7,
convert = 0xa8,
reinterpret = 0xa9,
// GNU extensions.
GNU_push_tls_address = 0xe0,
/// The following is for marking variables that are uninitialized.
GNU_uninit = 0xf0,
GNU_encoded_addr = 0xf1,
/// The GNU implicit pointer extension.
/// See http://www.dwarfstd.org/ShowIssue.php?issue=100831.1&type=open .
GNU_implicit_pointer = 0xf2,
/// The GNU entry value extension.
/// See http://www.dwarfstd.org/ShowIssue.php?issue=100909.1&type=open .
GNU_entry_value = 0xf3,
/// The GNU typed stack extension.
/// See http://www.dwarfstd.org/doc/040408.1.html .
GNU_const_type = 0xf4,
GNU_regval_type = 0xf5,
GNU_deref_type = 0xf6,
GNU_convert = 0xf7,
GNU_reinterpret = 0xf9,
/// The GNU parameter ref extension.
GNU_parameter_ref = 0xfa,
/// Extension for Fission. See http://gcc.gnu.org/wiki/DebugFission.
GNU_addr_index = 0xfb,
GNU_const_index = 0xfc,
// HP extensions.
HP_is_value = 0xe1,
HP_fltconst4 = 0xe2,
HP_fltconst8 = 0xe3,
HP_mod_range = 0xe4,
HP_unmod_range = 0xe5,
HP_tls = 0xe6,
// PGI (STMicroelectronics) extensions.
PGI_omp_thread_num = 0xf8,
// Wasm extensions.
WASM_location = 0xed,
WASM_local = 0x00,
WASM_global = 0x01,
WASM_operand_stack = 0x02,
_,
/// Implementation-defined range start.
pub const lo_user: OP = @enumFromInt(0xe0);
/// Implementation-defined range end.
pub const hi_user: OP = @enumFromInt(0xff);
pub const HP_unknown: OP = @enumFromInt(0xe0);
pub const WASM_global_u32: OP = @enumFromInt(0x03);
};
pub const LANG = @import("dwarf/LANG.zig");
pub const FORM = @import("dwarf/FORM.zig");
pub const ATE = @import("dwarf/ATE.zig");
pub const EH = @import("dwarf/EH.zig");
pub const Format = enum { @"32", @"64" };
pub const LLE = struct {
pub const end_of_list = 0x00;
pub const base_addressx = 0x01;
pub const startx_endx = 0x02;
pub const startx_length = 0x03;
pub const offset_pair = 0x04;
pub const default_location = 0x05;
pub const base_address = 0x06;
pub const start_end = 0x07;
pub const start_length = 0x08;
};
pub const CFA = struct {
pub const advance_loc = 0x40;
pub const offset = 0x80;
pub const restore = 0xc0;
pub const nop = 0x00;
pub const set_loc = 0x01;
pub const advance_loc1 = 0x02;
pub const advance_loc2 = 0x03;
pub const advance_loc4 = 0x04;
pub const offset_extended = 0x05;
pub const restore_extended = 0x06;
pub const @"undefined" = 0x07;
pub const same_value = 0x08;
pub const register = 0x09;
pub const remember_state = 0x0a;
pub const restore_state = 0x0b;
pub const def_cfa = 0x0c;
pub const def_cfa_register = 0x0d;
pub const def_cfa_offset = 0x0e;
// DWARF 3.
pub const def_cfa_expression = 0x0f;
pub const expression = 0x10;
pub const offset_extended_sf = 0x11;
pub const def_cfa_sf = 0x12;
pub const def_cfa_offset_sf = 0x13;
pub const val_offset = 0x14;
pub const val_offset_sf = 0x15;
pub const val_expression = 0x16;
pub const lo_user = 0x1c;
pub const hi_user = 0x3f;
// SGI/MIPS specific.
pub const MIPS_advance_loc8 = 0x1d;
// GNU extensions.
pub const GNU_window_save = 0x2d;
pub const GNU_args_size = 0x2e;
pub const GNU_negative_offset_extended = 0x2f;
};
pub const CHILDREN = struct {
pub const no = 0x00;
pub const yes = 0x01;
};
pub const LNS = struct {
pub const extended_op = 0x00;
pub const copy = 0x01;
pub const advance_pc = 0x02;
pub const advance_line = 0x03;
pub const set_file = 0x04;
pub const set_column = 0x05;
pub const negate_stmt = 0x06;
pub const set_basic_block = 0x07;
pub const const_add_pc = 0x08;
pub const fixed_advance_pc = 0x09;
pub const set_prologue_end = 0x0a;
pub const set_epilogue_begin = 0x0b;
pub const set_isa = 0x0c;
};
pub const LNE = struct {
pub const padding = 0x00;
pub const end_sequence = 0x01;
pub const set_address = 0x02;
pub const define_file = 0x03;
pub const set_discriminator = 0x04;
pub const lo_user = 0x80;
pub const hi_user = 0xff;
// Zig extensions
pub const ZIG_set_decl = 0xec;
};
pub const UT = struct {
pub const compile = 0x01;
pub const @"type" = 0x02;
pub const partial = 0x03;
pub const skeleton = 0x04;
pub const split_compile = 0x05;
pub const split_type = 0x06;
pub const lo_user = 0x80;
pub const hi_user = 0xff;
};
pub const LNCT = struct {
pub const path = 0x1;
pub const directory_index = 0x2;
pub const timestamp = 0x3;
pub const size = 0x4;
pub const MD5 = 0x5;
pub const lo_user = 0x2000;
pub const hi_user = 0x3fff;
pub const LLVM_source = 0x2001;
};
pub const RLE = struct {
pub const end_of_list = 0x00;
pub const base_addressx = 0x01;
pub const startx_endx = 0x02;
pub const startx_length = 0x03;
pub const offset_pair = 0x04;
pub const base_address = 0x05;
pub const start_end = 0x06;
pub const start_length = 0x07;
};
pub const CC = enum(u8) {
normal = 0x1,
program = 0x2,
nocall = 0x3,
pass_by_reference = 0x4,
pass_by_value = 0x5,
GNU_renesas_sh = 0x40,
GNU_borland_fastcall_i386 = 0x41,
BORLAND_safecall = 0xb0,
BORLAND_stdcall = 0xb1,
BORLAND_pascal = 0xb2,
BORLAND_msfastcall = 0xb3,
BORLAND_msreturn = 0xb4,
BORLAND_thiscall = 0xb5,
BORLAND_fastcall = 0xb6,
LLVM_vectorcall = 0xc0,
LLVM_Win64 = 0xc1,
LLVM_X86_64SysV = 0xc2,
LLVM_AAPCS = 0xc3,
LLVM_AAPCS_VFP = 0xc4,
LLVM_IntelOclBicc = 0xc5,
LLVM_SpirFunction = 0xc6,
LLVM_OpenCLKernel = 0xc7,
LLVM_Swift = 0xc8,
LLVM_PreserveMost = 0xc9,
LLVM_PreserveAll = 0xca,
LLVM_X86RegCall = 0xcb,
LLVM_M68kRTD = 0xcc,
LLVM_PreserveNone = 0xcd,
LLVM_RISCVVectorCall = 0xce,
LLVM_SwiftTail = 0xcf,
pub const lo_user = 0x40;
pub const hi_user = 0xff;
};
pub const ACCESS = struct {
pub const public = 0x01;
pub const protected = 0x02;
pub const private = 0x03;
};