1 /* DWARF DWZ handling for GDB. 2 3 Copyright (C) 2003-2021 Free Software Foundation, Inc. 4 5 This file is part of GDB. 6 7 This program is free software; you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation; either version 3 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 GNU General Public License for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */ 19 20 #ifndef GDB_DWARF2_DWZ_H 21 #define GDB_DWARF2_DWZ_H 22 23 #include "gdb_bfd.h" 24 #include "dwarf2/index-cache.h" 25 #include "dwarf2/section.h" 26 27 struct dwarf2_per_bfd; 28 29 /* This represents a '.dwz' file. */ 30 31 struct dwz_file 32 { dwz_filedwz_file33 dwz_file (gdb_bfd_ref_ptr &&bfd) 34 : dwz_bfd (std::move (bfd)) 35 { 36 } 37 filenamedwz_file38 const char *filename () const 39 { 40 return bfd_get_filename (this->dwz_bfd.get ()); 41 } 42 43 /* A dwz file can only contain a few sections. */ 44 struct dwarf2_section_info abbrev {}; 45 struct dwarf2_section_info info {}; 46 struct dwarf2_section_info str {}; 47 struct dwarf2_section_info line {}; 48 struct dwarf2_section_info macro {}; 49 struct dwarf2_section_info gdb_index {}; 50 struct dwarf2_section_info debug_names {}; 51 52 /* The dwz's BFD. */ 53 gdb_bfd_ref_ptr dwz_bfd; 54 55 /* If we loaded the index from an external file, this contains the 56 resources associated to the open file, memory mapping, etc. */ 57 std::unique_ptr<index_cache_resource> index_cache_res; 58 59 /* Read a string at offset STR_OFFSET in the .debug_str section from 60 this dwz file. Throw an error if the offset is too large. If 61 the string consists of a single NUL byte, return NULL; otherwise 62 return a pointer to the string. */ 63 64 const char *read_string (struct objfile *objfile, LONGEST str_offset); 65 }; 66 67 /* Open the separate '.dwz' debug file, if needed. If there is no 68 .gnu_debugaltlink section in the file, then the result depends on 69 REQUIRE: if REQUIRE is true, then error; if REQUIRE is false, 70 return NULL. Always error if there is such a section but the file 71 cannot be found. */ 72 73 extern dwz_file *dwarf2_get_dwz_file (dwarf2_per_bfd *per_bfd, 74 bool require = false); 75 76 #endif /* GDB_DWARF2_DWZ_H */ 77