X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=binutils%2Fdwarf.h;h=bb7f5536e35842b07f48ec2f1975e28cdec4d445;hb=e4b7104b1e0c70613d0f553cb18d25c7343647d3;hp=5d793edff6af53f8cbc28f1fec2fe9d2e04c82d3;hpb=aa820537ead0135a7c38c619039dce8a6fc74ed1;p=deliverable%2Fbinutils-gdb.git diff --git a/binutils/dwarf.h b/binutils/dwarf.h index 5d793edff6..bb7f5536e3 100644 --- a/binutils/dwarf.h +++ b/binutils/dwarf.h @@ -1,6 +1,5 @@ /* dwarf.h - DWARF support header file - Copyright 2005, 2007, 2008, 2009 - Free Software Foundation, Inc. + Copyright (C) 2005-2020 Free Software Foundation, Inc. This file is part of GNU Binutils. @@ -19,60 +18,145 @@ 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 { - /* 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; - unsigned char *start; - dwarf_vma address; - dwarf_size_type size; -}; + dwarf_vma li_length; + unsigned short li_version; + unsigned char li_address_size; + unsigned char li_segment_size; + 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 *); - int *enabled; - unsigned int relocate : 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 @@ -80,53 +164,161 @@ extern struct dwarf_section_display debug_displays []; 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 int num_loc_views; /* List of .debug_ranges offsets seen in this .debug_info. */ - unsigned long *range_lists; + 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_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_frames_interp; extern int do_debug_macinfo; extern int do_debug_str; +extern int do_debug_str_offsets; 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 bfd_boolean do_checks; + +extern int dwarf_cutoff_level; +extern unsigned long dwarf_start_die; -extern void init_dwarf_regnames (unsigned int); +extern int dwarf_check; -extern int load_debug_section (enum dwarf_section_display_enum, - void *); -extern void free_debug_section (enum dwarf_section_display_enum); +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 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); -extern void dwarf_select_sections_by_names (const char *names); -extern void dwarf_select_sections_by_letters (const char *letters); +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); -void *cmalloc (size_t, size_t); -void *xcmalloc (size_t, size_t); -void *xcrealloc (void *, size_t, size_t); +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, const char *file, unsigned long lnum) +{ + if ((status & 1) != 0) + error (_("%s:%lu: end of data encountered whilst reading LEB\n"), file, lnum); + else if ((status & 2) != 0) + error (_("%s:%lu: read LEB value is too large to store in destination variable\n"), file, lnum); +} + +#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, __FILE__, __LINE__); \ + } \ + 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, __FILE__, __LINE__); \ + } \ + while (0)