forked from Imagelibrary/binutils-gdb
DWARF 5 standardized the .gnu_debugaltlink section that dwz emits in multi-file mode. This is handled via some new forms, and a new .debug_sup section. This patch adds support for this to gdb. It is largely straightforward, I think, though one oddity is that I chose not to have this code search the system build-id directories for the supplementary file. My feeling was that, while it makes sense for a distro to unify the build-id concept with the hash stored in the .debug_sup section, there's no intrinsic need to do so. This in turn means that a few tests -- for example those that test the index cache -- will not work in this mode. Bug: https://sourceware.org/bugzilla/show_bug.cgi?id=32808 Acked-By: Simon Marchi <simon.marchi@efficios.com>
81 lines
2.5 KiB
C++
81 lines
2.5 KiB
C++
/* DWARF DWZ handling for GDB.
|
|
|
|
Copyright (C) 2003-2025 Free Software Foundation, Inc.
|
|
|
|
This file is part of GDB.
|
|
|
|
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, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef GDB_DWARF2_DWZ_H
|
|
#define GDB_DWARF2_DWZ_H
|
|
|
|
#include "gdb_bfd.h"
|
|
#include "dwarf2/index-cache.h"
|
|
#include "dwarf2/section.h"
|
|
|
|
struct dwarf2_per_bfd;
|
|
struct dwarf2_per_objfile;
|
|
|
|
/* This represents a '.dwz' file. */
|
|
|
|
struct dwz_file
|
|
{
|
|
/* Open the separate '.dwz' debug file, if needed. This will set
|
|
the appropriate field in the per-BFD structure. If the DWZ file
|
|
exists, the relevant sections are read in as well. Throws an
|
|
exception if the .gnu_debugaltlink or .debug_sup section exists
|
|
but is invalid or if the file cannot be found. */
|
|
static void read_dwz_file (dwarf2_per_objfile *per_objfile);
|
|
|
|
const char *filename () const
|
|
{
|
|
return bfd_get_filename (this->dwz_bfd.get ());
|
|
}
|
|
|
|
/* A dwz file can only contain a few sections. */
|
|
struct dwarf2_section_info abbrev {};
|
|
struct dwarf2_section_info info {};
|
|
struct dwarf2_section_info str {};
|
|
struct dwarf2_section_info line {};
|
|
struct dwarf2_section_info macro {};
|
|
struct dwarf2_section_info gdb_index {};
|
|
struct dwarf2_section_info debug_names {};
|
|
struct dwarf2_section_info types {};
|
|
|
|
/* The dwz's BFD. */
|
|
gdb_bfd_ref_ptr dwz_bfd;
|
|
|
|
/* If we loaded the index from an external file, this contains the
|
|
resources associated to the open file, memory mapping, etc. */
|
|
index_cache_resource_up index_cache_res;
|
|
|
|
/* Read a string at offset STR_OFFSET in the .debug_str section from
|
|
this dwz file. Throw an error if the offset is too large. If
|
|
the string consists of a single NUL byte, return NULL; otherwise
|
|
return a pointer to the string. */
|
|
|
|
const char *read_string (struct objfile *objfile, LONGEST str_offset);
|
|
|
|
private:
|
|
|
|
explicit dwz_file (gdb_bfd_ref_ptr &&bfd)
|
|
: dwz_bfd (std::move (bfd))
|
|
{
|
|
}
|
|
};
|
|
|
|
using dwz_file_up = std::unique_ptr<dwz_file>;
|
|
|
|
#endif /* GDB_DWARF2_DWZ_H */
|