301a9420d9
debuginfod is a lightweight web service that indexes ELF/DWARF debugging resources by build-id and serves them over HTTP. This patch enables objdump and readelf to query debuginfod servers when they are otherwise not able to find separate debug files. Binutils can be built with debuginfod using the --with-debuginfod configure option. This requires that libdebuginfod be installed and found at configure time. debuginfod is packaged with elfutils, starting with version 0.178. For more information see https://sourceware.org/elfutils/. toplevel* config/debuginfod.m4: New file. Add macro AC_DEBUGINFOD. Adds new configure option --with-debuginfod. * configure: Regenerate. * configure.ac: Call AC_DEBUGINFOD. binutils* Makefile.am (readelf_LDADD, objdump_LDADD): Add libdebuginfod. * Makefile.in: Regenerate. * NEWS: Update. * config.in: Regenerate. * configure: Regenerate. * configure.ac: Call AC_DEBUGINFOD. * doc/Makefile.in: Regenerate. * doc/binutils.texi: Add section on using binutils with debuginfod. * dwarf.c (debuginfod_fetch_separate_debug_info): New function. Query debuginfod servers for the target debug file. (load_separate_debug_info): Call debuginfod_fetch_separate_debug_info if configured with debuginfod. (load_separate_debug_files): Add file argument to load_separate_debug_info calls. * dwarf.h (get_build_id): Add declaration. * objdump.c (get_build_id): New function. Get build-id of file. * readelf.c (get_build_id): Likewise. * testsuite/binutils-all/debuginfod.exp: New tests. * testsuite/binutils-all/linkdebug.s: Add .note.gnu.build-id section.
317 lines
8.8 KiB
C
317 lines
8.8 KiB
C
/* dwarf.h - DWARF support header file
|
|
Copyright (C) 2005-2020 Free Software Foundation, Inc.
|
|
|
|
This file is part of GNU Binutils.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
|
|
MA 02110-1301, USA. */
|
|
|
|
#include "dwarf2.h" /* for enum dwarf_unit_type */
|
|
|
|
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
|
|
{
|
|
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;
|
|
|
|
/* Structure found in .debug_pubnames section. */
|
|
typedef struct
|
|
{
|
|
dwarf_vma pn_length;
|
|
unsigned short pn_version;
|
|
dwarf_vma pn_offset;
|
|
dwarf_vma pn_size;
|
|
}
|
|
DWARF2_Internal_PubNames;
|
|
|
|
/* 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
|
|
we extract from the.debug_info section. */
|
|
typedef struct
|
|
{
|
|
unsigned int pointer_size;
|
|
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. */
|
|
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. */
|
|
dwarf_vma * range_lists;
|
|
unsigned int num_range_lists;
|
|
unsigned int max_range_lists;
|
|
}
|
|
debug_info;
|
|
|
|
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 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_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_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 *);
|
|
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)
|
|
|
|
#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)
|