dwarf parse/expr/unwind/dump 2 -> 1; move old stuff to obsolete

2026-08-14 09:18:09 +00:00 · 2026-06-02 12:11:14 -07:00
parent ef5fc82e9c
commit a2700de35d
27 changed files with 11634 additions and 11635 deletions
@@ -0,0 +1,73 @@
+// Copyright (c) Epic Games Tools
+// Licensed under the MIT license (https://opensource.org/license/mit/)
+
+#ifndef DWARF_DUMP_H
+#define DWARF_DUMP_H
+
+typedef enum
+{
+  DW_DumperCacheFlag_InfoRanges = (1 << 0),
+  DW_DumperCacheFlag_CuArr      = (1 << 1),
+  DW_DumperCacheFlag_LineVmMap  = (1 << 2),
+  DW_DumperCacheFlag_TagTrees   = (1 << 3),
+} DW_DumperCacheFlags;
+
+typedef struct DW_Dumper
+{
+  Arena               *arena;
+  Arch                 arch;
+  B32                  is_relaxed;
+  B32                  is_verbose;
+  DW_Raw            *input;
+  DW_DumperCacheFlags  cache_flags;
+  struct {
+    Rng1U64Array         info_ranges;
+    DW_CompUnit         *cu_arr;
+    HashTable           *line_vm_map;
+    DW_TagTree          *tag_trees;
+  } cache;
+} DW_Dumper;
+
+#define DW_PRINTER(name) void name(Arena *arena, String8List *strings, int indent, DW_Dumper *dumper)
+typedef DW_PRINTER(DW_Printer);
+
+////////////////////////////////
+
+// cache
+internal Rng1U64Array  dw_get_info_ranges(DW_Dumper *dumper);
+internal DW_CompUnit * dw_get_cu_arr(DW_Dumper *dumper);
+internal HashTable *   dw_get_line_vm_map(DW_Dumper *dumper);
+internal DW_TagTree *  dw_get_tag_trees(DW_Dumper *dumper);
+
+////////////////////////////////
+//~ rjf: Stringification Helpers
+
+internal String8List dw_string_list_from_cfi_program(Arena *arena, U64 cu_base, Arch arch, DW_Version ver, DW_Ext ext, DW_Format format, U64 pc_begin, DW_CIE *cie, DW_DecodePtr *decode_ptr_func, void *deocde_ptr_ud, String8 program);
+internal String8List dw_string_list_from_expression (Arena *arena, String8 raw_data, U64 cu_base, U64 addr_size, Arch arch, DW_Version ver, DW_Ext ext, DW_Format format);
+
+internal String8 dw_string_from_reg_off     (Arena *arena, Arch arch, DW_Reg reg_idx, S64 reg_off);
+internal String8 dw_string_from_attrib_value(Arena *arena, DW_Raw *input, Arch arch, DW_CompUnit *cu, DW_LineVM *line_vm, DW_Attrib *attrib);
+internal String8 dw_string_from_expression  (Arena *arena, String8 expr, U64 cu_base, U64 addr_size, Arch arch, DW_Version ver, DW_Ext ext, DW_Format format);
+internal String8 dw_string_from_cfa         (Arena *arena, Arch arch, U64 address_size, DW_Version version, DW_Ext ext, DW_Format format, DW_CFA cfa);
+internal String8 dw_string_from_cfi_row     (Arena *arena, Arch arch, U64 address_size, DW_Version version, DW_Ext ext, DW_Format format, DW_CFI_Row *row);
+
+#if 0
+internal void dw_print_eh_frame         (Arena *arena, String8List *out, String8 indent, String8 raw_eh_frame, Arch arch, DW_Version ver, DW_Ext ext, EH_PtrCtx *ptr_ctx);
+internal void dw_print_debug_loc        (Arena *arena, String8List *out, String8 indent, DW_Raw *input, Arch arch, ExecutableImageKind image_type, B32 relaxed);
+internal void dw_print_debug_ranges     (Arena *arena, String8List *out, String8 indent, DW_Raw *input, Arch arch, ExecutableImageKind image_type, B32 relaxed);
+internal void dw_print_debug_aranges    (Arena *arena, String8List *out, String8 indent, DW_Raw *input);
+internal void dw_print_debug_addr       (Arena *arena, String8List *out, String8 indent, DW_Raw *input);
+internal void dw_print_debug_loclists   (Arena *arena, String8List *out, String8 indent, DW_Raw *input, Rng1U64Array segment_vranges, Arch arch);
+internal void dw_print_debug_rnglists   (Arena *arena, String8List *out, String8 indent, DW_Raw *input, Rng1U64Array segment_vranges);
+internal void dw_print_debug_pubnames   (Arena *arena, String8List *out, String8 indent, DW_Raw *input);
+internal void dw_print_debug_pubtypes   (Arena *arena, String8List *out, String8 indent, DW_Raw *input);
+internal void dw_print_debug_line_str   (Arena *arena, String8List *out, String8 indent, DW_Raw *input);
+internal void dw_print_debug_str_offsets(Arena *arena, String8List *out, String8 indent, DW_Raw *input);
+#endif
+
+////////////////////////////////
+//~ rjf: Dump Entry Point
+
+internal String8List dw_dump_list_from_sections(Arena *arena, DW_Raw *input, Arch arch, DW_SectionFlags dump_sections, B32 is_verbose);
+
+#endif // DWARF_DUMP_H