-/* dwwrf.h - DWARF support header file
- Copyright 2005, 2007, 2008
- Free Software Foundation, Inc.
+/* dwarf.h - DWARF support header file
+ Copyright (C) 2005-2020 Free Software Foundation, Inc.
This file is part of GNU Binutils.
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
MA 02110-1301, USA. */
-#if __STDC_VERSION__ >= 199901L || (defined(__GNUC__) && __GNUC__ >= 2)
-/* We can't use any bfd types here since readelf may define BFD64 and
- objdump may not. */
-typedef unsigned long long dwarf_vma;
-typedef unsigned long long dwarf_size_type;
-#else
-typedef unsigned long dwarf_vma;
-typedef unsigned long dwarf_size_type;
-#endif
+#include "dwarf2.h" /* for enum dwarf_unit_type */
-struct dwarf_section
+typedef unsigned HOST_WIDEST_INT dwarf_vma;
+typedef HOST_WIDEST_INT dwarf_signed_vma;
+typedef unsigned HOST_WIDEST_INT dwarf_size_type;
+
+/* Structure found in the .debug_line section. */
+typedef struct
{
- const char *name;
- unsigned char *start;
- dwarf_vma address;
- dwarf_size_type size;
-};
+ dwarf_vma li_length;
+ unsigned short li_version;
+ dwarf_vma li_prologue_length;
+ unsigned char li_min_insn_length;
+ unsigned char li_max_ops_per_insn;
+ unsigned char li_default_is_stmt;
+ int li_line_base;
+ unsigned char li_line_range;
+ unsigned char li_opcode_base;
+ unsigned int li_offset_size;
+}
+DWARF2_Internal_LineInfo;
-/* A structure containing the name of a debug section
- and a pointer to a function that can decode it. */
-struct dwarf_section_display
+/* Structure found in .debug_pubnames section. */
+typedef struct
{
- struct dwarf_section section;
- int (*display) (struct dwarf_section *, void *);
- unsigned int relocate : 1;
- unsigned int eh_frame : 1;
-};
+ dwarf_vma pn_length;
+ unsigned short pn_version;
+ dwarf_vma pn_offset;
+ dwarf_vma pn_size;
+}
+DWARF2_Internal_PubNames;
-enum dwarf_section_display_enum {
+/* Structure found in .debug_info section. */
+typedef struct
+{
+ dwarf_vma cu_length;
+ unsigned short cu_version;
+ dwarf_vma cu_abbrev_offset;
+ unsigned char cu_pointer_size;
+ enum dwarf_unit_type cu_unit_type;
+}
+DWARF2_Internal_CompUnit;
+
+/* Structure found in .debug_aranges section. */
+typedef struct
+{
+ dwarf_vma ar_length;
+ unsigned short ar_version;
+ dwarf_vma ar_info_offset;
+ unsigned char ar_pointer_size;
+ unsigned char ar_segment_size;
+}
+DWARF2_Internal_ARange;
+
+/* N.B. The order here must match the order in debug_displays. */
+
+enum dwarf_section_display_enum
+{
abbrev = 0,
aranges,
frame,
info,
line,
pubnames,
+ gnu_pubnames,
eh_frame,
macinfo,
+ macro,
str,
+ line_str,
loc,
+ loclists,
pubtypes,
+ gnu_pubtypes,
ranges,
+ rnglists,
static_func,
static_vars,
types,
weaknames,
+ gdb_index,
+ debug_names,
+ trace_info,
+ trace_abbrev,
+ trace_aranges,
+ info_dwo,
+ abbrev_dwo,
+ types_dwo,
+ line_dwo,
+ loc_dwo,
+ macro_dwo,
+ macinfo_dwo,
+ str_dwo,
+ str_index,
+ str_index_dwo,
+ debug_addr,
+ dwp_cu_index,
+ dwp_tu_index,
+ gnu_debuglink,
+ gnu_debugaltlink,
+ separate_debug_str,
max
};
+struct dwarf_section
+{
+ /* A debug section has a different name when it's stored compressed
+ or not. COMPRESSED_NAME and UNCOMPRESSED_NAME are the two
+ possibilities. NAME is set to whichever one is used for this
+ input file, as determined by load_debug_section(). */
+ const char * uncompressed_name;
+ const char * compressed_name;
+ const char * name;
+ /* If non-NULL then FILENAME is the name of the separate debug info
+ file containing the section. */
+ const char * filename;
+ unsigned char * start;
+ dwarf_vma address;
+ dwarf_size_type size;
+ enum dwarf_section_display_enum abbrev_sec;
+ /* Used by clients to help them implement the reloc_at callback. */
+ void * reloc_info;
+ unsigned long num_relocs;
+ /* A spare field for random use. */
+ void * user_data;
+};
+
+/* A structure containing the name of a debug section
+ and a pointer to a function that can decode it. */
+struct dwarf_section_display
+{
+ struct dwarf_section section;
+ int (* display) (struct dwarf_section *, void *);
+ int * enabled;
+ bfd_boolean relocate;
+};
+
extern struct dwarf_section_display debug_displays [];
/* This structure records the information that
typedef struct
{
unsigned int pointer_size;
- unsigned long cu_offset;
- unsigned long base_address;
+ unsigned int offset_size;
+ int dwarf_version;
+ dwarf_vma cu_offset;
+ dwarf_vma base_address;
+ /* This field is filled in when reading the attribute DW_AT_GNU_addr_base and
+ is used with the form DW_AT_GNU_FORM_addr_index. */
+ dwarf_vma addr_base;
+ /* This field is filled in when reading the attribute DW_AT_GNU_ranges_base and
+ is used when calculating ranges. */
+ dwarf_vma ranges_base;
/* This is an array of offsets to the location list table. */
- unsigned long *loc_offsets;
- int *have_frame_base;
+ dwarf_vma * loc_offsets;
+ /* This is an array of offsets to the location view table. */
+ dwarf_vma * loc_views;
+ int * have_frame_base;
unsigned int num_loc_offsets;
unsigned int max_loc_offsets;
- unsigned long *range_lists;
+ unsigned int num_loc_views;
+ /* List of .debug_ranges offsets seen in this .debug_info. */
+ dwarf_vma * range_lists;
unsigned int num_range_lists;
unsigned int max_range_lists;
}
debug_info;
-extern dwarf_vma (*byte_get) (unsigned char *, int);
-extern dwarf_vma byte_get_little_endian (unsigned char *, int);
-extern dwarf_vma byte_get_big_endian (unsigned char *, int);
+typedef struct separate_info
+{
+ void * handle; /* The pointer returned by open_debug_file(). */
+ const char * filename;
+ struct separate_info * next;
+} separate_info;
+
+extern separate_info * first_separate_info;
-extern int eh_addr_size;
+extern unsigned int eh_addr_size;
extern int do_debug_info;
extern int do_debug_abbrevs;
extern int do_debug_lines;
-extern int do_debug_lines_decoded;
extern int do_debug_pubnames;
+extern int do_debug_pubtypes;
extern int do_debug_aranges;
extern int do_debug_ranges;
extern int do_debug_frames;
extern int do_debug_macinfo;
extern int do_debug_str;
extern int do_debug_loc;
+extern int do_gdb_index;
+extern int do_trace_info;
+extern int do_trace_abbrevs;
+extern int do_trace_aranges;
+extern int do_debug_addr;
+extern int do_debug_cu_index;
+extern int do_wide;
+extern int do_debug_links;
+extern int do_follow_links;
+
+extern int dwarf_cutoff_level;
+extern unsigned long dwarf_start_die;
+
+extern int dwarf_check;
-extern void init_dwarf_regnames (unsigned int);
+extern void init_dwarf_regnames_by_elf_machine_code (unsigned int);
+extern void init_dwarf_regnames_by_bfd_arch_and_mach (enum bfd_architecture arch,
+ unsigned long mach);
-extern int load_debug_section (enum dwarf_section_display_enum,
- void *);
-extern void free_debug_section (enum dwarf_section_display_enum);
+extern bfd_boolean load_debug_section (enum dwarf_section_display_enum, void *);
+extern void free_debug_section (enum dwarf_section_display_enum);
+extern bfd_boolean load_separate_debug_files (void *, const char *);
+extern void close_debug_file (void *);
+extern void * open_debug_file (const char *);
extern void free_debug_memory (void);
-void *cmalloc (size_t, size_t);
-void *xcmalloc (size_t, size_t);
-void *xcrealloc (void *, size_t, size_t);
+extern void dwarf_select_sections_by_names (const char *);
+extern void dwarf_select_sections_by_letters (const char *);
+extern void dwarf_select_sections_all (void);
+
+extern unsigned int * find_cu_tu_set (void *, unsigned int);
+
+extern void * cmalloc (size_t, size_t);
+extern void * xcalloc2 (size_t, size_t);
+extern void * xcmalloc (size_t, size_t);
+extern void * xcrealloc (void *, size_t, size_t);
+
+/* A callback into the client. Returns TRUE if there is a
+ relocation against the given debug section at the given
+ offset. */
+extern bfd_boolean reloc_at (struct dwarf_section *, dwarf_vma);
+
+extern dwarf_vma read_leb128 (unsigned char *, const unsigned char *const,
+ bfd_boolean, unsigned int *, int *);
+
+#if HAVE_LIBDEBUGINFOD
+extern unsigned char * get_build_id (void *);
+#endif
+
+static inline void
+report_leb_status (int status)
+{
+ if ((status & 1) != 0)
+ error (_("LEB end of data\n"));
+ else if ((status & 2) != 0)
+ error (_("LEB value too large\n"));
+}
+
+#define SKIP_ULEB(start, end) \
+ do \
+ { \
+ unsigned int _len; \
+ read_leb128 (start, end, FALSE, &_len, NULL); \
+ start += _len; \
+ } while (0)
+
+#define SKIP_SLEB(start, end) \
+ do \
+ { \
+ unsigned int _len; \
+ read_leb128 (start, end, TRUE, &_len, NULL); \
+ start += _len; \
+ } while (0)
+
+#define READ_ULEB(var, start, end) \
+ do \
+ { \
+ dwarf_vma _val; \
+ unsigned int _len; \
+ int _status; \
+ \
+ _val = read_leb128 (start, end, FALSE, &_len, &_status); \
+ start += _len; \
+ (var) = _val; \
+ if ((var) != _val) \
+ _status |= 2; \
+ report_leb_status (_status); \
+ } while (0)
-void error (const char *, ...) ATTRIBUTE_PRINTF_1;
-void warn (const char *, ...) ATTRIBUTE_PRINTF_1;
+#define READ_SLEB(var, start, end) \
+ do \
+ { \
+ dwarf_signed_vma _val; \
+ unsigned int _len; \
+ int _status; \
+ \
+ _val = read_leb128 (start, end, TRUE, &_len, &_status); \
+ start += _len; \
+ (var) = _val; \
+ if ((var) != _val) \
+ _status |= 2; \
+ report_leb_status (_status); \
+ } while (0)