LLDB mainline
SymbolFileDWARFDebugMap.cpp
Go to the documentation of this file.
1//===-- SymbolFileDWARFDebugMap.cpp ---------------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
10#include "DWARFCompileUnit.h"
11#include "DWARFDebugAranges.h"
12#include "DWARFDebugInfo.h"
13
14#include "lldb/Core/Module.h"
17#include "lldb/Core/Section.h"
23#include "lldb/Utility/Timer.h"
24
25//#define DEBUG_OSO_DMAP // DO NOT CHECKIN WITH THIS NOT COMMENTED OUT
26
31#include "lldb/Symbol/TypeMap.h"
33#include "llvm/ADT/STLExtras.h"
34#include "llvm/Support/ScopedPrinter.h"
35
37
38#include "LogChannelDWARF.h"
39#include "SymbolFileDWARF.h"
41
42#include <memory>
43#include <optional>
44
45using namespace lldb;
46using namespace lldb_private;
47using namespace lldb_private::plugin::dwarf;
48
50
51// Subclass lldb_private::Module so we can intercept the
52// "Module::GetObjectFile()" (so we can fixup the object file sections) and
53// also for "Module::GetSymbolFile()" (so we can fixup the symbol file id.
54
57 SymbolFileDWARFDebugMap *exe_symfile) {
59 return file_range_map;
60
62
63 Module *oso_module = exe_symfile->GetModuleByCompUnitInfo(this);
64 if (!oso_module)
65 return file_range_map;
66
67 ObjectFile *oso_objfile = oso_module->GetObjectFile();
68 if (!oso_objfile)
69 return file_range_map;
70
73 log,
74 "%p: SymbolFileDWARFDebugMap::CompileUnitInfo::GetFileRangeMap ('%s')",
75 static_cast<void *>(this),
76 oso_module->GetSpecificationDescription().c_str());
77
78 std::vector<SymbolFileDWARFDebugMap::CompileUnitInfo *> cu_infos;
79 if (exe_symfile->GetCompUnitInfosForModule(oso_module, cu_infos)) {
80 for (auto comp_unit_info : cu_infos) {
81 Symtab *exe_symtab = exe_symfile->GetObjectFile()->GetSymtab();
82 ModuleSP oso_module_sp(oso_objfile->GetModule());
83 Symtab *oso_symtab = oso_objfile->GetSymtab();
84
85 /// const uint32_t fun_resolve_flags = SymbolContext::Module |
86 /// eSymbolContextCompUnit | eSymbolContextFunction;
87 // SectionList *oso_sections = oso_objfile->Sections();
88 // Now we need to make sections that map from zero based object file
89 // addresses to where things ended up in the main executable.
90
91 assert(comp_unit_info->first_symbol_index != UINT32_MAX);
92 // End index is one past the last valid symbol index
93 const uint32_t oso_end_idx = comp_unit_info->last_symbol_index + 1;
94 for (uint32_t idx = comp_unit_info->first_symbol_index +
95 2; // Skip the N_SO and N_OSO
96 idx < oso_end_idx; ++idx) {
97 Symbol *exe_symbol = exe_symtab->SymbolAtIndex(idx);
98 if (exe_symbol) {
99 if (!exe_symbol->IsDebug())
100 continue;
101
102 switch (exe_symbol->GetType()) {
103 default:
104 break;
105
106 case eSymbolTypeCode: {
107 // For each N_FUN, or function that we run into in the debug map we
108 // make a new section that we add to the sections found in the .o
109 // file. This new section has the file address set to what the
110 // addresses are in the .o file, and the load address is adjusted
111 // to match where it ended up in the final executable! We do this
112 // before we parse any dwarf info so that when it goes get parsed
113 // all section/offset addresses that get registered will resolve
114 // correctly to the new addresses in the main executable.
115
116 // First we find the original symbol in the .o file's symbol table
117 Symbol *oso_fun_symbol = oso_symtab->FindFirstSymbolWithNameAndType(
120 if (oso_fun_symbol) {
121 // Add the inverse OSO file address to debug map entry mapping
122 exe_symfile->AddOSOFileRange(
123 this, exe_symbol->GetAddressRef().GetFileAddress(),
124 exe_symbol->GetByteSize(),
125 oso_fun_symbol->GetAddressRef().GetFileAddress(),
126 oso_fun_symbol->GetByteSize());
127 }
128 } break;
129
130 case eSymbolTypeData: {
131 // For each N_GSYM we remap the address for the global by making a
132 // new section that we add to the sections found in the .o file.
133 // This new section has the file address set to what the addresses
134 // are in the .o file, and the load address is adjusted to match
135 // where it ended up in the final executable! We do this before we
136 // parse any dwarf info so that when it goes get parsed all
137 // section/offset addresses that get registered will resolve
138 // correctly to the new addresses in the main executable. We
139 // initially set the section size to be 1 byte, but will need to
140 // fix up these addresses further after all globals have been
141 // parsed to span the gaps, or we can find the global variable
142 // sizes from the DWARF info as we are parsing.
143
144 // Next we find the non-stab entry that corresponds to the N_GSYM
145 // in the .o file
146 Symbol *oso_gsym_symbol =
150 if (exe_symbol && oso_gsym_symbol && exe_symbol->ValueIsAddress() &&
151 oso_gsym_symbol->ValueIsAddress()) {
152 // Add the inverse OSO file address to debug map entry mapping
153 exe_symfile->AddOSOFileRange(
154 this, exe_symbol->GetAddressRef().GetFileAddress(),
155 exe_symbol->GetByteSize(),
156 oso_gsym_symbol->GetAddressRef().GetFileAddress(),
157 oso_gsym_symbol->GetByteSize());
158 }
159 } break;
160 }
161 }
162 }
163
164 exe_symfile->FinalizeOSOFileRanges(this);
165 // We don't need the symbols anymore for the .o files
166 oso_objfile->ClearSymtab();
167 }
168 }
169 return file_range_map;
170}
171
172namespace lldb_private::plugin {
173namespace dwarf {
174class DebugMapModule : public Module {
175public:
176 DebugMapModule(const ModuleSP &exe_module_sp, uint32_t cu_idx,
177 const FileSpec &file_spec, const ArchSpec &arch,
178 ConstString object_name, off_t object_offset,
179 const llvm::sys::TimePoint<> object_mod_time)
180 : Module(file_spec, arch, object_name, object_offset, object_mod_time),
181 m_exe_module_wp(exe_module_sp), m_cu_idx(cu_idx) {}
182
183 ~DebugMapModule() override = default;
184
185 SymbolFile *
186 GetSymbolFile(bool can_create = true,
187 lldb_private::Stream *feedback_strm = nullptr) override {
188 // Scope for locker
189 if (m_symfile_up.get() || !can_create)
190 return m_symfile_up ? m_symfile_up->GetSymbolFile() : nullptr;
191
192 ModuleSP exe_module_sp(m_exe_module_wp.lock());
193 if (exe_module_sp) {
194 // Now get the object file outside of a locking scope
195 ObjectFile *oso_objfile = GetObjectFile();
196 if (oso_objfile) {
197 std::lock_guard<std::recursive_mutex> guard(m_mutex);
198 if (SymbolFile *symfile =
199 Module::GetSymbolFile(can_create, feedback_strm)) {
200 // Set a pointer to this class to set our OSO DWARF file know that
201 // the DWARF is being used along with a debug map and that it will
202 // have the remapped sections that we do below.
203 SymbolFileDWARF *oso_symfile =
205
206 if (!oso_symfile)
207 return nullptr;
208
209 ObjectFile *exe_objfile = exe_module_sp->GetObjectFile();
210 SymbolFile *exe_symfile = exe_module_sp->GetSymbolFile();
211
212 if (exe_objfile && exe_symfile) {
213 oso_symfile->SetDebugMapModule(exe_module_sp);
214 // Set the ID of the symbol file DWARF to the index of the OSO
215 // shifted left by 32 bits to provide a unique prefix for any
216 // UserID's that get created in the symbol file.
217 oso_symfile->SetFileIndex((uint64_t)m_cu_idx);
218 }
219 return symfile;
220 }
221 }
222 }
223 return nullptr;
224 }
225
226protected:
228 const uint32_t m_cu_idx;
229};
230} // namespace dwarf
231} // namespace lldb_private::plugin
232
236}
237
240}
241
243 return "DWARF and DWARF3 debug symbol file reader (debug map).";
244}
245
247 return new SymbolFileDWARFDebugMap(std::move(objfile_sp));
248}
249
251 : SymbolFileCommon(std::move(objfile_sp)), m_flags(), m_compile_unit_infos(),
254
256
258
261 return;
262
264
265 // If the object file has been stripped, there is no sense in looking further
266 // as all of the debug symbols for the debug map will not be available
267 if (m_objfile_sp->IsStripped())
268 return;
269
270 // Also make sure the file type is some sort of executable. Core files, debug
271 // info files (dSYM), object files (.o files), and stub libraries all can
272 switch (m_objfile_sp->GetType()) {
280 return;
281
285 break;
286 }
287
288 // In order to get the abilities of this plug-in, we look at the list of
289 // N_OSO entries (object files) from the symbol table and make sure that
290 // these files exist and also contain valid DWARF. If we get any of that then
291 // we return the abilities of the first N_OSO's DWARF.
292
293 Symtab *symtab = m_objfile_sp->GetSymtab();
294 if (!symtab)
295 return;
296
298
299 std::vector<uint32_t> oso_indexes;
300 // When a mach-o symbol is encoded, the n_type field is encoded in bits
301 // 23:16, and the n_desc field is encoded in bits 15:0.
302 //
303 // To find all N_OSO entries that are part of the DWARF + debug map we find
304 // only object file symbols with the flags value as follows: bits 23:16 ==
305 // 0x66 (N_OSO) bits 15: 0 == 0x0001 (specifies this is a debug map object
306 // file)
307 const uint32_t k_oso_symbol_flags_value = 0x660001u;
308
309 const uint32_t oso_index_count =
311 eSymbolTypeObjectFile, k_oso_symbol_flags_value, oso_indexes);
312
313 if (oso_index_count == 0)
314 return;
315
320
323
324 for (uint32_t sym_idx :
325 llvm::concat<uint32_t>(m_func_indexes, m_glob_indexes)) {
326 const Symbol *symbol = symtab->SymbolAtIndex(sym_idx);
327 lldb::addr_t file_addr = symbol->GetAddressRef().GetFileAddress();
328 lldb::addr_t byte_size = symbol->GetByteSize();
329 DebugMap::Entry debug_map_entry(file_addr, byte_size,
331 m_debug_map.Append(debug_map_entry);
332 }
334
335 m_compile_unit_infos.resize(oso_index_count);
336
337 for (uint32_t i = 0; i < oso_index_count; ++i) {
338 const uint32_t so_idx = oso_indexes[i] - 1;
339 const uint32_t oso_idx = oso_indexes[i];
340 const Symbol *so_symbol = symtab->SymbolAtIndex(so_idx);
341 const Symbol *oso_symbol = symtab->SymbolAtIndex(oso_idx);
342 if (so_symbol && oso_symbol &&
343 so_symbol->GetType() == eSymbolTypeSourceFile &&
344 oso_symbol->GetType() == eSymbolTypeObjectFile) {
345 m_compile_unit_infos[i].so_file.SetFile(so_symbol->GetName().AsCString(),
346 FileSpec::Style::native);
347 m_compile_unit_infos[i].oso_path = oso_symbol->GetName();
348 m_compile_unit_infos[i].oso_mod_time =
349 llvm::sys::toTimePoint(oso_symbol->GetIntegerValue(0));
350 uint32_t sibling_idx = so_symbol->GetSiblingIndex();
351 // The sibling index can't be less that or equal to the current index
352 // "i"
353 if (sibling_idx <= i || sibling_idx == UINT32_MAX) {
354 m_objfile_sp->GetModule()->ReportError(
355 "N_SO in symbol with UID {0} has invalid sibling in debug "
356 "map, "
357 "please file a bug and attach the binary listed in this error",
358 so_symbol->GetID());
359 } else {
360 const Symbol *last_symbol = symtab->SymbolAtIndex(sibling_idx - 1);
361 m_compile_unit_infos[i].first_symbol_index = so_idx;
362 m_compile_unit_infos[i].last_symbol_index = sibling_idx - 1;
363 m_compile_unit_infos[i].first_symbol_id = so_symbol->GetID();
364 m_compile_unit_infos[i].last_symbol_id = last_symbol->GetID();
365
366 LLDB_LOGF(log, "Initialized OSO 0x%8.8x: file=%s", i,
367 oso_symbol->GetName().GetCString());
368 }
369 } else {
370 if (oso_symbol == nullptr)
371 m_objfile_sp->GetModule()->ReportError(
372 "N_OSO symbol[{0}] can't be found, please file a bug and "
373 "attach "
374 "the binary listed in this error",
375 oso_idx);
376 else if (so_symbol == nullptr)
377 m_objfile_sp->GetModule()->ReportError(
378 "N_SO not found for N_OSO symbol[{0}], please file a bug and "
379 "attach the binary listed in this error",
380 oso_idx);
381 else if (so_symbol->GetType() != eSymbolTypeSourceFile)
382 m_objfile_sp->GetModule()->ReportError(
383 "N_SO has incorrect symbol type ({0}) for N_OSO "
384 "symbol[{1}], "
385 "please file a bug and attach the binary listed in this error",
386 so_symbol->GetType(), oso_idx);
387 else if (oso_symbol->GetType() != eSymbolTypeSourceFile)
388 m_objfile_sp->GetModule()->ReportError(
389 "N_OSO has incorrect symbol type ({0}) for N_OSO "
390 "symbol[{1}], "
391 "please file a bug and attach the binary listed in this error",
392 oso_symbol->GetType(), oso_idx);
393 }
394 }
395}
396
398 const uint32_t cu_count = GetNumCompileUnits();
399 if (oso_idx < cu_count)
401 return nullptr;
402}
403
405 CompileUnitInfo *comp_unit_info) {
406 if (!comp_unit_info->oso_sp) {
407 auto pos = m_oso_map.find(
408 {comp_unit_info->oso_path, comp_unit_info->oso_mod_time});
409 if (pos != m_oso_map.end()) {
410 comp_unit_info->oso_sp = pos->second;
411 } else {
412 ObjectFile *obj_file = GetObjectFile();
413 comp_unit_info->oso_sp = std::make_shared<OSOInfo>();
414 m_oso_map[{comp_unit_info->oso_path, comp_unit_info->oso_mod_time}] =
415 comp_unit_info->oso_sp;
416 const char *oso_path = comp_unit_info->oso_path.GetCString();
417 FileSpec oso_file(oso_path);
418 ConstString oso_object;
419 if (FileSystem::Instance().Exists(oso_file)) {
420 // The modification time returned by the FS can have a higher precision
421 // than the one from the CU.
422 auto oso_mod_time = std::chrono::time_point_cast<std::chrono::seconds>(
423 FileSystem::Instance().GetModificationTime(oso_file));
424 // A timestamp of 0 means that the linker was in deterministic mode. In
425 // that case, we should skip the check against the filesystem last
426 // modification timestamp, since it will never match.
427 if (comp_unit_info->oso_mod_time != llvm::sys::TimePoint<>() &&
428 oso_mod_time != comp_unit_info->oso_mod_time) {
430 "debug map object file \"%s\" changed (actual: 0x%8.8x, debug "
431 "map: 0x%8.8x) since this executable was linked, debug info "
432 "will not be loaded", oso_file.GetPath().c_str(),
433 (uint32_t)llvm::sys::toTimeT(oso_mod_time),
434 (uint32_t)llvm::sys::toTimeT(comp_unit_info->oso_mod_time));
435 obj_file->GetModule()->ReportError(
436 "{0}", comp_unit_info->oso_load_error.AsCString());
437 return nullptr;
438 }
439
440 } else {
441 const bool must_exist = true;
442
443 if (!ObjectFile::SplitArchivePathWithObject(oso_path, oso_file,
444 oso_object, must_exist)) {
446 "debug map object file \"%s\" containing debug info does not "
447 "exist, debug info will not be loaded",
448 comp_unit_info->oso_path.GetCString());
449 return nullptr;
450 }
451 }
452 // Always create a new module for .o files. Why? Because we use the debug
453 // map, to add new sections to each .o file and even though a .o file
454 // might not have changed, the sections that get added to the .o file can
455 // change.
456 ArchSpec oso_arch;
457 // Only adopt the architecture from the module (not the vendor or OS)
458 // since .o files for "i386-apple-ios" will historically show up as "i386
459 // -apple-macosx" due to the lack of a LC_VERSION_MIN_MACOSX or
460 // LC_VERSION_MIN_IPHONEOS load command...
461 oso_arch.SetTriple(m_objfile_sp->GetModule()
462 ->GetArchitecture()
463 .GetTriple()
464 .getArchName()
465 .str()
466 .c_str());
467 comp_unit_info->oso_sp->module_sp = std::make_shared<DebugMapModule>(
468 obj_file->GetModule(), GetCompUnitInfoIndex(comp_unit_info), oso_file,
469 oso_arch, oso_object, 0,
470 oso_object ? comp_unit_info->oso_mod_time : llvm::sys::TimePoint<>());
471
472 if (oso_object && !comp_unit_info->oso_sp->module_sp->GetObjectFile() &&
473 FileSystem::Instance().Exists(oso_file)) {
474 // If we are loading a .o file from a .a file the "oso_object" will
475 // have a valid value name and if the .a file exists, either the .o
476 // file didn't exist in the .a file or the mod time didn't match.
478 "\"%s\" object from the \"%s\" archive: "
479 "either the .o file doesn't exist in the archive or the "
480 "modification time (0x%8.8x) of the .o file doesn't match",
481 oso_object.AsCString(), oso_file.GetPath().c_str(),
482 (uint32_t)llvm::sys::toTimeT(comp_unit_info->oso_mod_time));
483 }
484 }
485 }
486 if (comp_unit_info->oso_sp)
487 return comp_unit_info->oso_sp->module_sp.get();
488 return nullptr;
489}
490
492 FileSpec &file_spec) {
493 if (oso_idx < m_compile_unit_infos.size()) {
494 if (m_compile_unit_infos[oso_idx].so_file) {
495 file_spec = m_compile_unit_infos[oso_idx].so_file;
496 return true;
497 }
498 }
499 return false;
500}
501
503 Module *oso_module = GetModuleByOSOIndex(oso_idx);
504 if (oso_module)
505 return oso_module->GetObjectFile();
506 return nullptr;
507}
508
511 return GetSymbolFile(*sc.comp_unit);
512}
513
516 CompileUnitInfo *comp_unit_info = GetCompUnitInfo(comp_unit);
517 if (comp_unit_info)
518 return GetSymbolFileByCompUnitInfo(comp_unit_info);
519 return nullptr;
520}
521
523 CompileUnitInfo *comp_unit_info) {
524 Module *oso_module = GetModuleByCompUnitInfo(comp_unit_info);
525 if (oso_module)
526 return oso_module->GetObjectFile();
527 return nullptr;
528}
529
531 const CompileUnitInfo *comp_unit_info) {
532 if (!m_compile_unit_infos.empty()) {
533 const CompileUnitInfo *first_comp_unit_info = &m_compile_unit_infos.front();
534 const CompileUnitInfo *last_comp_unit_info = &m_compile_unit_infos.back();
535 if (first_comp_unit_info <= comp_unit_info &&
536 comp_unit_info <= last_comp_unit_info)
537 return comp_unit_info - first_comp_unit_info;
538 }
539 return UINT32_MAX;
540}
541
544 unsigned size = m_compile_unit_infos.size();
545 if (oso_idx < size)
547 return nullptr;
548}
549
552 if (sym_file &&
554 return static_cast<SymbolFileDWARF *>(sym_file);
555 return nullptr;
556}
557
559 CompileUnitInfo *comp_unit_info) {
560 if (Module *oso_module = GetModuleByCompUnitInfo(comp_unit_info))
561 return GetSymbolFileAsSymbolFileDWARF(oso_module->GetSymbolFile());
562 return nullptr;
563}
564
566 // In order to get the abilities of this plug-in, we look at the list of
567 // N_OSO entries (object files) from the symbol table and make sure that
568 // these files exist and also contain valid DWARF. If we get any of that then
569 // we return the abilities of the first N_OSO's DWARF.
570
571 const uint32_t oso_index_count = GetNumCompileUnits();
572 if (oso_index_count > 0) {
573 InitOSO();
574 if (!m_compile_unit_infos.empty()) {
579 }
580 }
581 return 0;
582}
583
585 InitOSO();
586 return m_compile_unit_infos.size();
587}
588
590 CompUnitSP comp_unit_sp;
591 const uint32_t cu_count = GetNumCompileUnits();
592
593 if (cu_idx < cu_count) {
594 auto &cu_info = m_compile_unit_infos[cu_idx];
595 Module *oso_module = GetModuleByCompUnitInfo(&cu_info);
596 if (oso_module) {
597 FileSpec so_file_spec;
598 if (GetFileSpecForSO(cu_idx, so_file_spec)) {
599 // User zero as the ID to match the compile unit at offset zero in each
600 // .o file.
601 lldb::user_id_t cu_id = 0;
602 cu_info.compile_units_sps.push_back(std::make_shared<CompileUnit>(
603 m_objfile_sp->GetModule(), nullptr,
604 std::make_shared<SupportFile>(so_file_spec), cu_id,
606 cu_info.id_to_index_map.insert({0, 0});
607 SetCompileUnitAtIndex(cu_idx, cu_info.compile_units_sps[0]);
608 // If there's a symbol file also register all the extra compile units.
609 if (SymbolFileDWARF *oso_symfile =
610 GetSymbolFileByCompUnitInfo(&cu_info)) {
611 auto num_dwarf_units = oso_symfile->DebugInfo().GetNumUnits();
612 for (size_t i = 0; i < num_dwarf_units; ++i) {
613 auto *dwarf_unit = oso_symfile->DebugInfo().GetUnitAtIndex(i);
614 if (auto *dwarf_cu = llvm::dyn_cast<DWARFCompileUnit>(dwarf_unit)) {
615 // The "main" one was already registered.
616 if (dwarf_cu->GetID() == 0)
617 continue;
618 cu_info.compile_units_sps.push_back(std::make_shared<CompileUnit>(
619 m_objfile_sp->GetModule(), nullptr,
620 std::make_shared<SupportFile>(so_file_spec),
621 dwarf_cu->GetID(), eLanguageTypeUnknown, eLazyBoolCalculate));
622 cu_info.id_to_index_map.insert(
623 {dwarf_cu->GetID(), cu_info.compile_units_sps.size() - 1});
624 }
625 }
626 }
627 }
628 }
629 if (!cu_info.compile_units_sps.empty())
630 comp_unit_sp = cu_info.compile_units_sps[0];
631 }
632
633 return comp_unit_sp;
634}
635
638 return GetCompUnitInfo(*sc.comp_unit);
639}
640
643 const uint32_t cu_count = GetNumCompileUnits();
644 for (uint32_t i = 0; i < cu_count; ++i) {
645 auto &id_to_index_map = m_compile_unit_infos[i].id_to_index_map;
646
647 auto it = id_to_index_map.find(comp_unit.GetID());
648 if (it != id_to_index_map.end() &&
649 &comp_unit ==
650 m_compile_unit_infos[i].compile_units_sps[it->getSecond()].get())
651 return &m_compile_unit_infos[i];
652 }
653 return nullptr;
654}
655
657 const lldb_private::Module *module,
658 std::vector<CompileUnitInfo *> &cu_infos) {
659 const uint32_t cu_count = GetNumCompileUnits();
660 for (uint32_t i = 0; i < cu_count; ++i) {
662 cu_infos.push_back(&m_compile_unit_infos[i]);
663 }
664 return cu_infos.size();
665}
666
669 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
670 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
671 if (oso_dwarf)
672 return oso_dwarf->ParseLanguage(comp_unit);
674}
675
677 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
678 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
679 if (oso_dwarf)
680 return oso_dwarf->ParseXcodeSDK(comp_unit);
681 return {};
682}
683
684llvm::SmallSet<lldb::LanguageType, 4>
686 lldb_private::CompileUnit &comp_unit) {
687 llvm::SmallSet<lldb::LanguageType, 4> langs;
688 auto *info = GetCompUnitInfo(comp_unit);
689 for (auto &comp_unit : info->compile_units_sps) {
690 langs.insert(comp_unit->GetLanguage());
691 }
692 return langs;
693}
694
696 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
697 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
698 if (oso_dwarf)
699 return oso_dwarf->ParseFunctions(comp_unit);
700 return 0;
701}
702
704 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
705 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
706 if (oso_dwarf)
707 return oso_dwarf->ParseLineTable(comp_unit);
708 return false;
709}
710
712 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
713 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
714 if (oso_dwarf)
715 return oso_dwarf->ParseDebugMacros(comp_unit);
716 return false;
717}
718
720 CompileUnit &comp_unit,
721 llvm::DenseSet<lldb_private::SymbolFile *> &visited_symbol_files,
722 llvm::function_ref<bool(Module &)> f) {
723 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
724 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
725 if (oso_dwarf)
726 return oso_dwarf->ForEachExternalModule(comp_unit, visited_symbol_files, f);
727 return false;
728}
729
731 CompileUnit &comp_unit, SupportFileList &support_files) {
732 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
733 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
734 if (oso_dwarf)
735 return oso_dwarf->ParseSupportFiles(comp_unit, support_files);
736 return false;
737}
738
740 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
741 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
742 if (oso_dwarf)
743 return oso_dwarf->ParseIsOptimized(comp_unit);
744 return false;
745}
746
748 const SymbolContext &sc, std::vector<SourceModule> &imported_modules) {
749 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
750 SymbolFileDWARF *oso_dwarf = GetSymbolFile(sc);
751 if (oso_dwarf)
752 return oso_dwarf->ParseImportedModules(sc, imported_modules);
753 return false;
754}
755
757 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
758 CompileUnit *comp_unit = func.GetCompileUnit();
759 if (!comp_unit)
760 return 0;
761
762 SymbolFileDWARF *oso_dwarf = GetSymbolFile(*comp_unit);
763 if (oso_dwarf)
764 return oso_dwarf->ParseBlocksRecursive(func);
765 return 0;
766}
767
769 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
770 SymbolFileDWARF *oso_dwarf = GetSymbolFile(comp_unit);
771 if (oso_dwarf)
772 return oso_dwarf->ParseTypes(comp_unit);
773 return 0;
774}
775
776size_t
778 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
779 SymbolFileDWARF *oso_dwarf = GetSymbolFile(sc);
780 if (oso_dwarf)
781 return oso_dwarf->ParseVariablesForContext(sc);
782 return 0;
783}
784
786 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
787 const uint64_t oso_idx = GetOSOIndexFromUserID(type_uid);
788 SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx);
789 if (oso_dwarf)
790 return oso_dwarf->ResolveTypeUID(type_uid);
791 return nullptr;
792}
793
794std::optional<SymbolFile::ArrayInfo>
796 lldb::user_id_t type_uid, const lldb_private::ExecutionContext *exe_ctx) {
797 const uint64_t oso_idx = GetOSOIndexFromUserID(type_uid);
798 SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx);
799 if (oso_dwarf)
800 return oso_dwarf->GetDynamicArrayInfoForUID(type_uid, exe_ctx);
801 return std::nullopt;
802}
803
805 bool success = false;
806 if (compiler_type) {
807 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
808 if (oso_dwarf->HasForwardDeclForCompilerType(compiler_type)) {
809 oso_dwarf->CompleteType(compiler_type);
810 success = true;
811 return IterationAction::Stop;
812 }
814 });
815 }
816 return success;
817}
818
819uint32_t
821 SymbolContextItem resolve_scope,
822 SymbolContext &sc) {
823 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
824 uint32_t resolved_flags = 0;
825 Symtab *symtab = m_objfile_sp->GetSymtab();
826 if (symtab) {
827 const addr_t exe_file_addr = exe_so_addr.GetFileAddress();
828
829 const DebugMap::Entry *debug_map_entry =
830 m_debug_map.FindEntryThatContains(exe_file_addr);
831 if (debug_map_entry) {
832
833 sc.symbol =
834 symtab->SymbolAtIndex(debug_map_entry->data.GetExeSymbolIndex());
835
836 if (sc.symbol != nullptr) {
837 resolved_flags |= eSymbolContextSymbol;
838
839 uint32_t oso_idx = 0;
840 CompileUnitInfo *comp_unit_info =
842 if (comp_unit_info) {
843 comp_unit_info->GetFileRangeMap(this);
844 Module *oso_module = GetModuleByCompUnitInfo(comp_unit_info);
845 if (oso_module) {
846 lldb::addr_t oso_file_addr =
847 exe_file_addr - debug_map_entry->GetRangeBase() +
848 debug_map_entry->data.GetOSOFileAddress();
849 Address oso_so_addr;
850 if (oso_module->ResolveFileAddress(oso_file_addr, oso_so_addr)) {
851 resolved_flags |=
852 oso_module->GetSymbolFile()->ResolveSymbolContext(
853 oso_so_addr, resolve_scope, sc);
854 }
855 }
856 }
857 }
858 }
859 }
860 return resolved_flags;
861}
862
864 const SourceLocationSpec &src_location_spec,
865 SymbolContextItem resolve_scope, SymbolContextList &sc_list) {
866 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
867 const uint32_t initial = sc_list.GetSize();
868 const uint32_t cu_count = GetNumCompileUnits();
869
870 for (uint32_t i = 0; i < cu_count; ++i) {
871 // If we are checking for inlines, then we need to look through all compile
872 // units no matter if "file_spec" matches.
873 bool resolve = src_location_spec.GetCheckInlines();
874
875 if (!resolve) {
876 FileSpec so_file_spec;
877 if (GetFileSpecForSO(i, so_file_spec))
878 resolve =
879 FileSpec::Match(src_location_spec.GetFileSpec(), so_file_spec);
880 }
881 if (resolve) {
883 if (oso_dwarf)
884 oso_dwarf->ResolveSymbolContext(src_location_spec, resolve_scope,
885 sc_list);
886 }
887 }
888 return sc_list.GetSize() - initial;
889}
890
892 ConstString name, const CompilerDeclContext &parent_decl_ctx,
893 const std::vector<uint32_t>
894 &indexes, // Indexes into the symbol table that match "name"
895 uint32_t max_matches, VariableList &variables) {
896 const size_t match_count = indexes.size();
897 for (size_t i = 0; i < match_count; ++i) {
898 uint32_t oso_idx;
899 CompileUnitInfo *comp_unit_info =
900 GetCompileUnitInfoForSymbolWithIndex(indexes[i], &oso_idx);
901 if (comp_unit_info) {
902 SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx);
903 if (oso_dwarf) {
904 oso_dwarf->FindGlobalVariables(name, parent_decl_ctx, max_matches,
905 variables);
906 if (variables.GetSize() > max_matches)
907 break;
908 }
909 }
910 }
911}
912
914 ConstString name, const CompilerDeclContext &parent_decl_ctx,
915 uint32_t max_matches, VariableList &variables) {
916 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
917 uint32_t total_matches = 0;
918
919 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
920 const uint32_t old_size = variables.GetSize();
921 oso_dwarf->FindGlobalVariables(name, parent_decl_ctx, max_matches,
922 variables);
923 const uint32_t oso_matches = variables.GetSize() - old_size;
924 if (oso_matches > 0) {
925 total_matches += oso_matches;
926
927 // Are we getting all matches?
928 if (max_matches == UINT32_MAX)
929 return IterationAction::Continue; // Yep, continue getting everything
930
931 // If we have found enough matches, lets get out
932 if (max_matches >= total_matches)
934
935 // Update the max matches for any subsequent calls to find globals in any
936 // other object files with DWARF
937 max_matches -= oso_matches;
938 }
939
941 });
942}
943
945 const RegularExpression &regex, uint32_t max_matches,
946 VariableList &variables) {
947 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
948 uint32_t total_matches = 0;
949 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
950 const uint32_t old_size = variables.GetSize();
951 oso_dwarf->FindGlobalVariables(regex, max_matches, variables);
952
953 const uint32_t oso_matches = variables.GetSize() - old_size;
954 if (oso_matches > 0) {
955 total_matches += oso_matches;
956
957 // Are we getting all matches?
958 if (max_matches == UINT32_MAX)
959 return IterationAction::Continue; // Yep, continue getting everything
960
961 // If we have found enough matches, lets get out
962 if (max_matches >= total_matches)
964
965 // Update the max matches for any subsequent calls to find globals in any
966 // other object files with DWARF
967 max_matches -= oso_matches;
968 }
969
971 });
972}
973
975 uint32_t *symbol_idx_ptr, const CompileUnitInfo *comp_unit_info) {
976 const uint32_t symbol_idx = *symbol_idx_ptr;
977
978 if (symbol_idx < comp_unit_info->first_symbol_index)
979 return -1;
980
981 if (symbol_idx <= comp_unit_info->last_symbol_index)
982 return 0;
983
984 return 1;
985}
986
988 user_id_t *symbol_idx_ptr, const CompileUnitInfo *comp_unit_info) {
989 const user_id_t symbol_id = *symbol_idx_ptr;
990
991 if (symbol_id < comp_unit_info->first_symbol_id)
992 return -1;
993
994 if (symbol_id <= comp_unit_info->last_symbol_id)
995 return 0;
996
997 return 1;
998}
999
1002 uint32_t symbol_idx, uint32_t *oso_idx_ptr) {
1003 const uint32_t oso_index_count = m_compile_unit_infos.size();
1004 CompileUnitInfo *comp_unit_info = nullptr;
1005 if (oso_index_count) {
1006 comp_unit_info = (CompileUnitInfo *)bsearch(
1007 &symbol_idx, &m_compile_unit_infos[0], m_compile_unit_infos.size(),
1008 sizeof(CompileUnitInfo),
1010 }
1011
1012 if (oso_idx_ptr) {
1013 if (comp_unit_info != nullptr)
1014 *oso_idx_ptr = comp_unit_info - &m_compile_unit_infos[0];
1015 else
1016 *oso_idx_ptr = UINT32_MAX;
1017 }
1018 return comp_unit_info;
1019}
1020
1023 user_id_t symbol_id, uint32_t *oso_idx_ptr) {
1024 const uint32_t oso_index_count = m_compile_unit_infos.size();
1025 CompileUnitInfo *comp_unit_info = nullptr;
1026 if (oso_index_count) {
1027 comp_unit_info = (CompileUnitInfo *)::bsearch(
1028 &symbol_id, &m_compile_unit_infos[0], m_compile_unit_infos.size(),
1029 sizeof(CompileUnitInfo),
1031 }
1032
1033 if (oso_idx_ptr) {
1034 if (comp_unit_info != nullptr)
1035 *oso_idx_ptr = comp_unit_info - &m_compile_unit_infos[0];
1036 else
1037 *oso_idx_ptr = UINT32_MAX;
1038 }
1039 return comp_unit_info;
1040}
1041
1043 SymbolContextList &sc_list,
1044 uint32_t start_idx) {
1045 // We found functions in .o files. Not all functions in the .o files will
1046 // have made it into the final output file. The ones that did make it into
1047 // the final output file will have a section whose module matches the module
1048 // from the ObjectFile for this SymbolFile. When the modules don't match,
1049 // then we have something that was in a .o file, but doesn't map to anything
1050 // in the final executable.
1051 uint32_t i = start_idx;
1052 while (i < sc_list.GetSize()) {
1053 SymbolContext sc;
1054 sc_list.GetContextAtIndex(i, sc);
1055 if (sc.function) {
1056 const SectionSP section_sp(
1058 if (section_sp->GetModule() != module_sp) {
1059 sc_list.RemoveContextAtIndex(i);
1060 continue;
1061 }
1062 }
1063 ++i;
1064 }
1065}
1066
1068 const Module::LookupInfo &lookup_info,
1069 const CompilerDeclContext &parent_decl_ctx, bool include_inlines,
1070 SymbolContextList &sc_list) {
1071 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1072 LLDB_SCOPED_TIMERF("SymbolFileDWARFDebugMap::FindFunctions (name = %s)",
1073 lookup_info.GetLookupName().GetCString());
1074
1075 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1076 uint32_t sc_idx = sc_list.GetSize();
1077 oso_dwarf->FindFunctions(lookup_info, parent_decl_ctx, include_inlines,
1078 sc_list);
1079 if (!sc_list.IsEmpty()) {
1080 RemoveFunctionsWithModuleNotEqualTo(m_objfile_sp->GetModule(), sc_list,
1081 sc_idx);
1082 }
1084 });
1085}
1086
1088 bool include_inlines,
1089 SymbolContextList &sc_list) {
1090 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1091 LLDB_SCOPED_TIMERF("SymbolFileDWARFDebugMap::FindFunctions (regex = '%s')",
1092 regex.GetText().str().c_str());
1093
1094 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1095 uint32_t sc_idx = sc_list.GetSize();
1096
1097 oso_dwarf->FindFunctions(regex, include_inlines, sc_list);
1098 if (!sc_list.IsEmpty()) {
1099 RemoveFunctionsWithModuleNotEqualTo(m_objfile_sp->GetModule(), sc_list,
1100 sc_idx);
1101 }
1103 });
1104}
1105
1107 lldb::TypeClass type_mask,
1108 TypeList &type_list) {
1109 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1110 LLDB_SCOPED_TIMERF("SymbolFileDWARFDebugMap::GetTypes (type_mask = 0x%8.8x)",
1111 type_mask);
1112
1113 SymbolFileDWARF *oso_dwarf = nullptr;
1114 if (sc_scope) {
1115 SymbolContext sc;
1116 sc_scope->CalculateSymbolContext(&sc);
1117
1118 CompileUnitInfo *cu_info = GetCompUnitInfo(sc);
1119 if (cu_info) {
1120 oso_dwarf = GetSymbolFileByCompUnitInfo(cu_info);
1121 if (oso_dwarf)
1122 oso_dwarf->GetTypes(sc_scope, type_mask, type_list);
1123 }
1124 } else {
1125 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1126 oso_dwarf->GetTypes(sc_scope, type_mask, type_list);
1128 });
1129 }
1130}
1131
1132std::vector<std::unique_ptr<lldb_private::CallEdge>>
1134 lldb_private::UserID func_id) {
1135 uint32_t oso_idx = GetOSOIndexFromUserID(func_id.GetID());
1136 SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx);
1137 if (oso_dwarf)
1138 return oso_dwarf->ParseCallEdgesInFunction(func_id);
1139 return {};
1140}
1141
1143 const DWARFDIE &die) {
1144 TypeSP type_sp;
1145 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1146 type_sp = oso_dwarf->FindDefinitionTypeForDWARFDeclContext(die);
1148 });
1149 return type_sp;
1150}
1151
1153 SymbolFileDWARF *skip_dwarf_oso) {
1156 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1157 if (skip_dwarf_oso != oso_dwarf &&
1158 oso_dwarf->Supports_DW_AT_APPLE_objc_complete_type(nullptr)) {
1159 m_supports_DW_AT_APPLE_objc_complete_type = eLazyBoolYes;
1160 return IterationAction::Stop;
1161 }
1163 });
1164 }
1166}
1167
1169 const DWARFDIE &die, ConstString type_name,
1170 bool must_be_implementation) {
1171 // If we have a debug map, we will have an Objective-C symbol whose name is
1172 // the type name and whose type is eSymbolTypeObjCClass. If we can find that
1173 // symbol and find its containing parent, we can locate the .o file that will
1174 // contain the implementation definition since it will be scoped inside the
1175 // N_SO and we can then locate the SymbolFileDWARF that corresponds to that
1176 // N_SO.
1177 SymbolFileDWARF *oso_dwarf = nullptr;
1178 TypeSP type_sp;
1179 ObjectFile *module_objfile = m_objfile_sp->GetModule()->GetObjectFile();
1180 if (module_objfile) {
1181 Symtab *symtab = module_objfile->GetSymtab();
1182 if (symtab) {
1183 Symbol *objc_class_symbol = symtab->FindFirstSymbolWithNameAndType(
1186 if (objc_class_symbol) {
1187 // Get the N_SO symbol that contains the objective C class symbol as
1188 // this should be the .o file that contains the real definition...
1189 const Symbol *source_file_symbol = symtab->GetParent(objc_class_symbol);
1190
1191 if (source_file_symbol &&
1192 source_file_symbol->GetType() == eSymbolTypeSourceFile) {
1193 const uint32_t source_file_symbol_idx =
1194 symtab->GetIndexForSymbol(source_file_symbol);
1195 if (source_file_symbol_idx != UINT32_MAX) {
1196 CompileUnitInfo *compile_unit_info =
1197 GetCompileUnitInfoForSymbolWithIndex(source_file_symbol_idx,
1198 nullptr);
1199 if (compile_unit_info) {
1200 oso_dwarf = GetSymbolFileByCompUnitInfo(compile_unit_info);
1201 if (oso_dwarf) {
1203 die, type_name, must_be_implementation));
1204 if (type_sp) {
1205 return type_sp;
1206 }
1207 }
1208 }
1209 }
1210 }
1211 }
1212 }
1213 }
1214
1215 // Only search all .o files for the definition if we don't need the
1216 // implementation because otherwise, with a valid debug map we should have
1217 // the ObjC class symbol and the code above should have found it.
1218 if (!must_be_implementation) {
1219 TypeSP type_sp;
1220
1221 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1222 type_sp = oso_dwarf->FindCompleteObjCDefinitionTypeForDIE(
1223 die, type_name, must_be_implementation);
1225 });
1226
1227 return type_sp;
1228 }
1229 return TypeSP();
1230}
1231
1233 TypeResults &results) {
1234 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1235 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1236 oso_dwarf->FindTypes(query, results);
1237 return results.Done(query) ? IterationAction::Stop
1239 });
1240}
1241
1243 lldb_private::ConstString name, const CompilerDeclContext &parent_decl_ctx,
1244 bool only_root_namespaces) {
1245 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1246 CompilerDeclContext matching_namespace;
1247
1248 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1249 matching_namespace =
1250 oso_dwarf->FindNamespace(name, parent_decl_ctx, only_root_namespaces);
1251
1252 return matching_namespace ? IterationAction::Stop
1254 });
1255
1256 return matching_namespace;
1257}
1258
1260 ForEachSymbolFile([&s](SymbolFileDWARF *oso_dwarf) {
1261 oso_dwarf->DumpClangAST(s);
1262 // The underlying assumption is that DumpClangAST(...) will obtain the
1263 // AST from the underlying TypeSystem and therefore we only need to do
1264 // this once and can stop after the first iteration hence we return true.
1265 return IterationAction::Stop;
1266 });
1267}
1268
1270 lldb_private::StructuredData::Dictionary &d, bool errors_only) {
1271 StructuredData::Array separate_debug_info_files;
1272 const uint32_t cu_count = GetNumCompileUnits();
1273 for (uint32_t cu_idx = 0; cu_idx < cu_count; ++cu_idx) {
1274 const auto &info = m_compile_unit_infos[cu_idx];
1276 std::make_shared<StructuredData::Dictionary>();
1277 oso_data->AddStringItem("so_file", info.so_file.GetPath());
1278 oso_data->AddStringItem("oso_path", info.oso_path);
1279 oso_data->AddIntegerItem("oso_mod_time",
1280 (uint32_t)llvm::sys::toTimeT(info.oso_mod_time));
1281
1282 bool loaded_successfully = false;
1283 if (GetModuleByOSOIndex(cu_idx)) {
1284 // If we have a valid pointer to the module, we successfully
1285 // loaded the oso if there are no load errors.
1286 if (!info.oso_load_error.Fail()) {
1287 loaded_successfully = true;
1288 }
1289 }
1290 if (!loaded_successfully) {
1291 oso_data->AddStringItem("error", info.oso_load_error.AsCString());
1292 }
1293 oso_data->AddBooleanItem("loaded", loaded_successfully);
1294 if (!errors_only || oso_data->HasKey("error"))
1295 separate_debug_info_files.AddItem(oso_data);
1296 }
1297
1298 d.AddStringItem("type", "oso");
1299 d.AddStringItem("symfile", GetMainObjectFile()->GetFileSpec().GetPath());
1300 d.AddItem("separate-debug-info-files",
1301 std::make_shared<StructuredData::Array>(
1302 std::move(separate_debug_info_files)));
1303 return true;
1304}
1305
1308 if (oso_dwarf) {
1309 const uint32_t cu_count = GetNumCompileUnits();
1310 for (uint32_t cu_idx = 0; cu_idx < cu_count; ++cu_idx) {
1311 SymbolFileDWARF *oso_symfile =
1313 if (oso_symfile == oso_dwarf) {
1314 if (m_compile_unit_infos[cu_idx].compile_units_sps.empty())
1316
1317 auto &id_to_index_map = m_compile_unit_infos[cu_idx].id_to_index_map;
1318 auto it = id_to_index_map.find(dwarf_cu.GetID());
1319 if (it != id_to_index_map.end())
1320 return m_compile_unit_infos[cu_idx]
1321 .compile_units_sps[it->getSecond()];
1322 }
1323 }
1324 }
1325 llvm_unreachable("this shouldn't happen");
1326}
1327
1330 if (oso_dwarf) {
1331 const uint32_t cu_count = GetNumCompileUnits();
1332 for (uint32_t cu_idx = 0; cu_idx < cu_count; ++cu_idx) {
1333 SymbolFileDWARF *oso_symfile =
1335 if (oso_symfile == oso_dwarf) {
1336 return &m_compile_unit_infos[cu_idx];
1337 }
1338 }
1339 }
1340 return nullptr;
1341}
1342
1344 const CompUnitSP &cu_sp) {
1345 if (oso_dwarf) {
1346 const uint32_t cu_count = GetNumCompileUnits();
1347 for (uint32_t cu_idx = 0; cu_idx < cu_count; ++cu_idx) {
1348 SymbolFileDWARF *oso_symfile =
1350 if (oso_symfile == oso_dwarf) {
1351 if (!m_compile_unit_infos[cu_idx].compile_units_sps.empty()) {
1352 assert(m_compile_unit_infos[cu_idx].compile_units_sps[0].get() ==
1353 cu_sp.get());
1354 } else {
1355 assert(cu_sp->GetID() == 0 &&
1356 "Setting first compile unit but with id different than 0!");
1357 auto &compile_units_sps = m_compile_unit_infos[cu_idx].compile_units_sps;
1358 compile_units_sps.push_back(cu_sp);
1359 m_compile_unit_infos[cu_idx].id_to_index_map.insert(
1360 {cu_sp->GetID(), compile_units_sps.size() - 1});
1361
1362 SetCompileUnitAtIndex(cu_idx, cu_sp);
1363 }
1364 }
1365 }
1366 }
1367}
1368
1371 const uint64_t oso_idx = GetOSOIndexFromUserID(type_uid);
1372 if (SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx))
1373 return oso_dwarf->GetDeclContextForUID(type_uid);
1374 return {};
1375}
1376
1379 const uint64_t oso_idx = GetOSOIndexFromUserID(type_uid);
1380 if (SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx))
1381 return oso_dwarf->GetDeclContextContainingUID(type_uid);
1382 return {};
1383}
1384
1385std::vector<CompilerContext>
1387 const uint64_t oso_idx = GetOSOIndexFromUserID(type_uid);
1388 if (SymbolFileDWARF *oso_dwarf = GetSymbolFileByOSOIndex(oso_idx))
1389 return oso_dwarf->GetCompilerContextForUID(type_uid);
1390 return {};
1391}
1392
1395 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1396 oso_dwarf->ParseDeclsForContext(decl_ctx);
1398 });
1399}
1400
1402 lldb::addr_t exe_file_addr,
1403 lldb::addr_t exe_byte_size,
1404 lldb::addr_t oso_file_addr,
1405 lldb::addr_t oso_byte_size) {
1406 const uint32_t debug_map_idx =
1408 if (debug_map_idx != UINT32_MAX) {
1409 DebugMap::Entry *debug_map_entry =
1410 m_debug_map.FindEntryThatContains(exe_file_addr);
1411 debug_map_entry->data.SetOSOFileAddress(oso_file_addr);
1412 addr_t range_size = std::min<addr_t>(exe_byte_size, oso_byte_size);
1413 if (range_size == 0) {
1414 range_size = std::max<addr_t>(exe_byte_size, oso_byte_size);
1415 if (range_size == 0)
1416 range_size = 1;
1417 }
1418 cu_info->file_range_map.Append(
1419 FileRangeMap::Entry(oso_file_addr, range_size, exe_file_addr));
1420 return true;
1421 }
1422 return false;
1423}
1424
1426 cu_info->file_range_map.Sort();
1427#if defined(DEBUG_OSO_DMAP)
1428 const FileRangeMap &oso_file_range_map = cu_info->GetFileRangeMap(this);
1429 const size_t n = oso_file_range_map.GetSize();
1430 printf("SymbolFileDWARFDebugMap::FinalizeOSOFileRanges (cu_info = %p) %s\n",
1431 cu_info, cu_info->oso_sp->module_sp->GetFileSpec().GetPath().c_str());
1432 for (size_t i = 0; i < n; ++i) {
1433 const FileRangeMap::Entry &entry = oso_file_range_map.GetEntryRef(i);
1434 printf("oso [0x%16.16" PRIx64 " - 0x%16.16" PRIx64
1435 ") ==> exe [0x%16.16" PRIx64 " - 0x%16.16" PRIx64 ")\n",
1436 entry.GetRangeBase(), entry.GetRangeEnd(), entry.data,
1437 entry.data + entry.GetByteSize());
1438 }
1439#endif
1440}
1441
1444 lldb::addr_t oso_file_addr) {
1445 CompileUnitInfo *cu_info = GetCompileUnitInfo(oso_symfile);
1446 if (cu_info) {
1447 const FileRangeMap::Entry *oso_range_entry =
1448 cu_info->GetFileRangeMap(this).FindEntryThatContains(oso_file_addr);
1449 if (oso_range_entry) {
1450 const DebugMap::Entry *debug_map_entry =
1451 m_debug_map.FindEntryThatContains(oso_range_entry->data);
1452 if (debug_map_entry) {
1453 const lldb::addr_t offset =
1454 oso_file_addr - oso_range_entry->GetRangeBase();
1455 const lldb::addr_t exe_file_addr =
1456 debug_map_entry->GetRangeBase() + offset;
1457 return exe_file_addr;
1458 }
1459 }
1460 }
1461 return LLDB_INVALID_ADDRESS;
1462}
1463
1465 // Make sure this address hasn't been fixed already
1466 Module *exe_module = GetObjectFile()->GetModule().get();
1467 Module *addr_module = addr.GetModule().get();
1468 if (addr_module == exe_module)
1469 return true; // Address is already in terms of the main executable module
1470
1473 if (cu_info) {
1474 const lldb::addr_t oso_file_addr = addr.GetFileAddress();
1475 const FileRangeMap::Entry *oso_range_entry =
1476 cu_info->GetFileRangeMap(this).FindEntryThatContains(oso_file_addr);
1477 if (oso_range_entry) {
1478 const DebugMap::Entry *debug_map_entry =
1479 m_debug_map.FindEntryThatContains(oso_range_entry->data);
1480 if (debug_map_entry) {
1481 const lldb::addr_t offset =
1482 oso_file_addr - oso_range_entry->GetRangeBase();
1483 const lldb::addr_t exe_file_addr =
1484 debug_map_entry->GetRangeBase() + offset;
1485 return exe_module->ResolveFileAddress(exe_file_addr, addr);
1486 }
1487 }
1488 }
1489 return true;
1490}
1491
1493 LineTable *line_table) {
1494 CompileUnitInfo *cu_info = GetCompileUnitInfo(oso_dwarf);
1495 if (cu_info)
1496 return line_table->LinkLineTable(cu_info->GetFileRangeMap(this));
1497 return nullptr;
1498}
1499
1500size_t
1502 DWARFDebugAranges *debug_aranges) {
1503 size_t num_line_entries_added = 0;
1504 if (debug_aranges && dwarf2Data) {
1505 CompileUnitInfo *compile_unit_info = GetCompileUnitInfo(dwarf2Data);
1506 if (compile_unit_info) {
1507 const FileRangeMap &file_range_map =
1508 compile_unit_info->GetFileRangeMap(this);
1509 for (size_t idx = 0; idx < file_range_map.GetSize(); idx++) {
1510 const FileRangeMap::Entry *entry = file_range_map.GetEntryAtIndex(idx);
1511 if (entry) {
1512 debug_aranges->AppendRange(*dwarf2Data->GetFileIndex(),
1513 entry->GetRangeBase(),
1514 entry->GetRangeEnd());
1515 num_line_entries_added++;
1516 }
1517 }
1518 }
1519 }
1520 return num_line_entries_added;
1521}
1522
1524 ModuleList oso_modules;
1525 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1526 ObjectFile *oso_objfile = oso_dwarf->GetObjectFile();
1527 if (oso_objfile) {
1528 ModuleSP module_sp = oso_objfile->GetModule();
1529 if (module_sp)
1530 oso_modules.Append(module_sp);
1531 }
1533 });
1534 return oso_modules;
1535}
1536
1538 std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1539
1540 // We need to make sure that our PC value from the frame matches the module
1541 // for this object file since we will lookup the PC file address in the debug
1542 // map below.
1543 Address pc_addr = frame.GetFrameCodeAddress();
1544 if (pc_addr.GetModule() == m_objfile_sp->GetModule()) {
1545 Symtab *symtab = m_objfile_sp->GetSymtab();
1546 if (symtab) {
1547 const DebugMap::Entry *debug_map_entry =
1549 if (debug_map_entry) {
1550 Symbol *symbol =
1551 symtab->SymbolAtIndex(debug_map_entry->data.GetExeSymbolIndex());
1552 if (symbol) {
1553 uint32_t oso_idx = 0;
1554 CompileUnitInfo *comp_unit_info =
1555 GetCompileUnitInfoForSymbolWithID(symbol->GetID(), &oso_idx);
1556 if (comp_unit_info) {
1557 Module *oso_module = GetModuleByCompUnitInfo(comp_unit_info);
1558 if (oso_module) {
1559 // Check the .o file's DWARF in case it has an error to display.
1560 SymbolFile *oso_sym_file = oso_module->GetSymbolFile();
1561 if (oso_sym_file)
1562 return oso_sym_file->GetFrameVariableError(frame);
1563 }
1564 // If we don't have a valid OSO module here, then something went
1565 // wrong as we have a symbol for the address in the debug map, but
1566 // we weren't able to open the .o file. Display an appropriate
1567 // error
1568 if (comp_unit_info->oso_load_error.Fail())
1569 return comp_unit_info->oso_load_error;
1570 else
1571 return Status("unable to load debug map object file \"%s\" "
1572 "exist, debug info will not be loaded",
1573 comp_unit_info->oso_path.GetCString());
1574 }
1575 }
1576 }
1577 }
1578 }
1579 return Status();
1580}
1581
1583 std::unordered_map<lldb::CompUnitSP, lldb_private::Args> &args) {
1584
1585 ForEachSymbolFile([&](SymbolFileDWARF *oso_dwarf) {
1586 oso_dwarf->GetCompileOptions(args);
1588 });
1589}
#define LLDB_LOGF(log,...)
Definition: Log.h:349
static void RemoveFunctionsWithModuleNotEqualTo(const ModuleSP &module_sp, SymbolContextList &sc_list, uint32_t start_idx)
#define LLDB_SCOPED_TIMERF(...)
Definition: Timer.h:86
Address & GetBaseAddress()
Get accessor for the base address of the range.
Definition: AddressRange.h:209
A section + offset based address class.
Definition: Address.h:62
lldb::SectionSP GetSection() const
Get const accessor for the section.
Definition: Address.h:439
lldb::ModuleSP GetModule() const
Get accessor for the module for this address.
Definition: Address.cpp:285
lldb::addr_t GetFileAddress() const
Get the file address.
Definition: Address.cpp:293
An architecture specification class.
Definition: ArchSpec.h:31
bool SetTriple(const llvm::Triple &triple)
Architecture triple setter.
Definition: ArchSpec.cpp:747
A class that describes a compilation unit.
Definition: CompileUnit.h:41
lldb::LanguageType GetLanguage()
Represents a generic declaration context in a program.
Generic representation of a type in a programming language.
Definition: CompilerType.h:36
A uniqued constant string class.
Definition: ConstString.h:40
const char * AsCString(const char *value_if_empty=nullptr) const
Get the string value as a C string.
Definition: ConstString.h:188
const char * GetCString() const
Get the string value as a C string.
Definition: ConstString.h:214
"lldb/Target/ExecutionContext.h" A class that contains an execution context.
A file utility class.
Definition: FileSpec.h:56
static bool Match(const FileSpec &pattern, const FileSpec &file)
Match FileSpec pattern against FileSpec file.
Definition: FileSpec.cpp:301
size_t GetPath(char *path, size_t max_path_length, bool denormalize=true) const
Extract the full path to the file.
Definition: FileSpec.cpp:367
bool Exists(const FileSpec &file_spec) const
Returns whether the given file exists.
static FileSystem & Instance()
A class that describes a function.
Definition: Function.h:399
const AddressRange & GetAddressRange()
Definition: Function.h:447
CompileUnit * GetCompileUnit()
Get accessor for the compile unit that owns this function.
Definition: Function.cpp:385
A line table class.
Definition: LineTable.h:40
LineTable * LinkLineTable(const FileRangeMap &file_range_map)
Definition: LineTable.cpp:406
ConstString GetName(NamePreference preference=ePreferDemangled) const
Best name get accessor.
Definition: Mangled.cpp:325
lldb::ModuleSP GetModule() const
Get const accessor for the module pointer.
Definition: ModuleChild.cpp:24
A collection class for Module objects.
Definition: ModuleList.h:103
void Append(const lldb::ModuleSP &module_sp, bool notify=true)
Append a module to the module list.
Definition: ModuleList.cpp:247
A class that encapsulates name lookup information.
Definition: Module.h:904
ConstString GetLookupName() const
Definition: Module.h:915
A class that describes an executable image and its associated object and symbol files.
Definition: Module.h:88
virtual ObjectFile * GetObjectFile()
Get the object file representation for the current architecture.
Definition: Module.cpp:1184
virtual SymbolFile * GetSymbolFile(bool can_create=true, Stream *feedback_strm=nullptr)
Get the module's symbol file.
Definition: Module.cpp:992
bool ResolveFileAddress(lldb::addr_t vm_addr, Address &so_addr)
Definition: Module.cpp:437
std::string GetSpecificationDescription() const
Get the module path and object name.
Definition: Module.cpp:1037
A plug-in interface definition class for object file parsers.
Definition: ObjectFile.h:44
Symtab * GetSymtab()
Gets the symbol table for the currently selected architecture (and object for archives).
Definition: ObjectFile.cpp:727
@ eTypeExecutable
A normal executable.
Definition: ObjectFile.h:53
@ eTypeDebugInfo
An object file that contains only debug information.
Definition: ObjectFile.h:55
@ eTypeStubLibrary
A library that can be linked against but not used for execution.
Definition: ObjectFile.h:63
@ eTypeObjectFile
An intermediate object file.
Definition: ObjectFile.h:59
@ eTypeDynamicLinker
The platform's dynamic linker executable.
Definition: ObjectFile.h:57
@ eTypeCoreFile
A core file that has a checkpoint of a program's execution state.
Definition: ObjectFile.h:51
@ eTypeSharedLibrary
A shared library that can be used during execution.
Definition: ObjectFile.h:61
@ eTypeJIT
JIT code that has symbols, sections and possibly debug info.
Definition: ObjectFile.h:65
virtual void ClearSymtab()
Frees the symbol table.
Definition: ObjectFile.cpp:576
static bool SplitArchivePathWithObject(llvm::StringRef path_with_object, lldb_private::FileSpec &archive_file, lldb_private::ConstString &archive_object, bool must_exist)
Split a path into a file path with object name.
Definition: ObjectFile.cpp:558
virtual llvm::StringRef GetPluginName()=0
static bool RegisterPlugin(llvm::StringRef name, llvm::StringRef description, ABICreateInstance create_callback)
static bool UnregisterPlugin(ABICreateInstance create_callback)
Entry & GetEntryRef(size_t i)
Definition: RangeMap.h:538
uint32_t FindEntryIndexThatContains(B addr) const
Definition: RangeMap.h:545
const Entry * GetEntryAtIndex(size_t i) const
Definition: RangeMap.h:528
RangeData< lldb::addr_t, lldb::addr_t, OSOEntry > Entry
Definition: RangeMap.h:443
void Append(const Entry &entry)
Definition: RangeMap.h:451
Entry * FindEntryThatContains(B addr)
Definition: RangeMap.h:563
llvm::StringRef GetText() const
Access the regular expression text.
"lldb/Core/SourceLocationSpec.h" A source location specifier class.
This base class provides an interface to stack frames.
Definition: StackFrame.h:42
const Address & GetFrameCodeAddress()
Get an Address for the current pc value in this StackFrame.
Definition: StackFrame.cpp:190
An error handling class.
Definition: Status.h:44
int SetErrorStringWithFormat(const char *format,...) __attribute__((format(printf
Set the current error string to a formatted error string.
Definition: Status.cpp:247
bool Fail() const
Test for error condition.
Definition: Status.cpp:181
const char * AsCString(const char *default_error_str="unknown error") const
Get the error string associated with the current error.
Definition: Status.cpp:130
A stream class that can stream formatted output to a file.
Definition: Stream.h:28
void AddItem(const ObjectSP &item)
void AddStringItem(llvm::StringRef key, llvm::StringRef value)
void AddItem(llvm::StringRef key, ObjectSP value_sp)
std::shared_ptr< Dictionary > DictionarySP
A list of support files for a CompileUnit.
Definition: FileSpecList.h:23
Defines a list of symbol context objects.
bool GetContextAtIndex(size_t idx, SymbolContext &sc) const
Get accessor for a symbol context at index idx.
uint32_t GetSize() const
Get accessor for a symbol context list size.
"lldb/Symbol/SymbolContextScope.h" Inherit from this if your object is part of a symbol context and c...
virtual void CalculateSymbolContext(SymbolContext *sc)=0
Reconstruct the object's symbol context into sc.
Defines a symbol context baton that can be handed other debug core functions.
Definition: SymbolContext.h:34
Function * function
The Function for a given query.
CompileUnit * comp_unit
The CompileUnit for a given query.
Symbol * symbol
The Symbol for a given query.
Containing protected virtual methods for child classes to override.
Definition: SymbolFile.h:496
ObjectFile * GetObjectFile() override
Definition: SymbolFile.h:525
lldb::ObjectFileSP m_objfile_sp
Definition: SymbolFile.h:601
ObjectFile * GetMainObjectFile() override
Definition: SymbolFile.cpp:169
void SetCompileUnitAtIndex(uint32_t idx, const lldb::CompUnitSP &cu_sp)
Definition: SymbolFile.cpp:203
uint32_t GetNumCompileUnits() override
Definition: SymbolFile.cpp:182
Provides public interface for all SymbolFiles.
Definition: SymbolFile.h:50
virtual std::recursive_mutex & GetModuleMutex() const
Symbols file subclasses should override this to return the Module that owns the TypeSystem that this ...
Definition: SymbolFile.cpp:36
Status GetFrameVariableError(StackFrame &frame)
Get an error that describes why variables might be missing for a given symbol context.
Definition: SymbolFile.h:271
std::unordered_map< lldb::CompUnitSP, Args > GetCompileOptions()
Returns a map of compilation unit to the compile option arguments associated with that compilation un...
Definition: SymbolFile.h:477
virtual uint32_t ResolveSymbolContext(const Address &so_addr, lldb::SymbolContextItem resolve_scope, SymbolContext &sc)=0
uint32_t GetSiblingIndex() const
Definition: Symbol.cpp:221
uint64_t GetIntegerValue(uint64_t fail_value=0) const
Definition: Symbol.h:117
uint32_t GetID() const
Definition: Symbol.h:136
bool ValueIsAddress() const
Definition: Symbol.cpp:169
bool IsDebug() const
Definition: Symbol.h:192
Mangled & GetMangled()
Definition: Symbol.h:146
Address & GetAddressRef()
Definition: Symbol.h:72
lldb::addr_t GetByteSize() const
Definition: Symbol.cpp:472
ConstString GetName() const
Definition: Symbol.cpp:552
lldb::SymbolType GetType() const
Definition: Symbol.h:168
Symbol * SymbolAtIndex(size_t idx)
Definition: Symtab.cpp:228
Symbol * FindFirstSymbolWithNameAndType(ConstString name, lldb::SymbolType symbol_type, Debug symbol_debug_type, Visibility symbol_visibility)
Definition: Symtab.cpp:873
void SortSymbolIndexesByValue(std::vector< uint32_t > &indexes, bool remove_duplicates) const
Definition: Symtab.cpp:625
uint32_t AppendSymbolIndexesWithType(lldb::SymbolType symbol_type, std::vector< uint32_t > &indexes, uint32_t start_idx=0, uint32_t end_index=UINT32_MAX) const
Definition: Symtab.cpp:499
uint32_t GetIndexForSymbol(const Symbol *symbol) const
Definition: Symtab.cpp:560
uint32_t AppendSymbolIndexesWithTypeAndFlagsValue(lldb::SymbolType symbol_type, uint32_t flags_value, std::vector< uint32_t > &indexes, uint32_t start_idx=0, uint32_t end_index=UINT32_MAX) const
Definition: Symtab.cpp:517
const Symbol * GetParent(Symbol *symbol) const
Get the parent symbol for the given symbol.
Definition: Symtab.cpp:1161
A class that contains all state required for type lookups.
Definition: Type.h:96
This class tracks the state and results of a TypeQuery.
Definition: Type.h:304
bool Done(const TypeQuery &query) const
Check if the type matching has found all of the matches that it needs.
Definition: Type.cpp:186
An abstraction for Xcode-style SDKs that works like ArchSpec.
Definition: XcodeSDK.h:24
void AppendRange(dw_offset_t cu_offset, dw_addr_t low_pc, dw_addr_t high_pc)
DebugMapModule(const ModuleSP &exe_module_sp, uint32_t cu_idx, const FileSpec &file_spec, const ArchSpec &arch, ConstString object_name, off_t object_offset, const llvm::sys::TimePoint<> object_mod_time)
SymbolFile * GetSymbolFile(bool can_create=true, lldb_private::Stream *feedback_strm=nullptr) override
Get the module's symbol file.
static SymbolFileDWARF * GetSymbolFileAsSymbolFileDWARF(SymbolFile *sym_file)
Status CalculateFrameVariableError(StackFrame &frame) override
Subclasses will override this function to for GetFrameVariableError().
CompileUnitInfo * GetCompUnitInfo(const SymbolContext &sc)
std::map< std::pair< ConstString, llvm::sys::TimePoint<> >, OSOInfoSP > m_oso_map
CompilerDeclContext GetDeclContextContainingUID(lldb::user_id_t uid) override
void ParseDeclsForContext(CompilerDeclContext decl_ctx) override
void FindGlobalVariables(ConstString name, const CompilerDeclContext &parent_decl_ctx, uint32_t max_matches, VariableList &variables) override
SymbolFileDWARF * GetSymbolFileByCompUnitInfo(CompileUnitInfo *comp_unit_info)
lldb::CompUnitSP GetCompileUnit(SymbolFileDWARF *oso_dwarf, DWARFCompileUnit &dwarf_cu)
Returns the compile unit associated with the dwarf compile unit.
bool ForEachExternalModule(CompileUnit &, llvm::DenseSet< SymbolFile * > &, llvm::function_ref< bool(Module &)>) override
uint32_t ResolveSymbolContext(const Address &so_addr, lldb::SymbolContextItem resolve_scope, SymbolContext &sc) override
lldb::TypeSP FindCompleteObjCDefinitionTypeForDIE(const DWARFDIE &die, ConstString type_name, bool must_be_implementation)
CompileUnitInfo * GetCompileUnitInfoForSymbolWithIndex(uint32_t symbol_idx, uint32_t *oso_idx_ptr)
bool GetSeparateDebugInfo(StructuredData::Dictionary &d, bool errors_only) override
List separate oso files.
bool CompleteType(CompilerType &compiler_type) override
ModuleList GetDebugInfoModules() override
Get the additional modules that this symbol file uses to parse debug info.
bool Supports_DW_AT_APPLE_objc_complete_type(SymbolFileDWARF *skip_dwarf_oso)
void ForEachSymbolFile(std::function< IterationAction(SymbolFileDWARF *)> closure)
If closure returns IterationAction::Continue, iteration continues.
lldb::CompUnitSP ParseCompileUnitAtIndex(uint32_t index) override
This function actually returns the first compile unit the object file at the given index contains.
std::vector< CompilerContext > GetCompilerContextForUID(lldb::user_id_t uid) override
lldb::addr_t LinkOSOFileAddress(SymbolFileDWARF *oso_symfile, lldb::addr_t oso_file_addr)
Convert a .o file "file address" to an executable "file address".
SymbolFileDWARF * GetSymbolFile(const SymbolContext &sc)
void PrivateFindGlobalVariables(ConstString name, const CompilerDeclContext &parent_decl_ctx, const std::vector< uint32_t > &name_symbol_indexes, uint32_t max_matches, VariableList &variables)
void FindTypes(const lldb_private::TypeQuery &match, lldb_private::TypeResults &results) override
Find types using a type-matching object that contains all search parameters.
std::optional< ArrayInfo > GetDynamicArrayInfoForUID(lldb::user_id_t type_uid, const ExecutionContext *exe_ctx) override
If type_uid points to an array type, return its characteristics.
CompileUnitInfo * GetCompileUnitInfo(SymbolFileDWARF *oso_dwarf)
bool GetFileSpecForSO(uint32_t oso_idx, FileSpec &file_spec)
ObjectFile * GetObjectFileByCompUnitInfo(CompileUnitInfo *comp_unit_info)
static SymbolFile * CreateInstance(lldb::ObjectFileSP objfile_sp)
CompilerDeclContext FindNamespace(ConstString name, const CompilerDeclContext &parent_decl_ctx, bool only_root_namespaces) override
Finds a namespace of name name and whose parent context is parent_decl_ctx.
std::vector< std::unique_ptr< CallEdge > > ParseCallEdgesInFunction(UserID func_id) override
lldb::LanguageType ParseLanguage(CompileUnit &comp_unit) override
size_t ParseVariablesForContext(const SymbolContext &sc) override
llvm::SmallSet< lldb::LanguageType, 4 > ParseAllLanguages(CompileUnit &comp_unit) override
This function exists because SymbolFileDWARFDebugMap may extra compile units which aren't exposed as ...
uint32_t GetCompUnitInfoIndex(const CompileUnitInfo *comp_unit_info)
Module * GetModuleByCompUnitInfo(CompileUnitInfo *comp_unit_info)
size_t ParseFunctions(CompileUnit &comp_unit) override
XcodeSDK ParseXcodeSDK(CompileUnit &comp_unit) override
Return the Xcode SDK comp_unit was compiled against.
size_t AddOSOARanges(SymbolFileDWARF *dwarf2Data, DWARFDebugAranges *debug_aranges)
static uint32_t GetOSOIndexFromUserID(lldb::user_id_t uid)
void FindFunctions(const Module::LookupInfo &lookup_info, const CompilerDeclContext &parent_decl_ctx, bool include_inlines, SymbolContextList &sc_list) override
void GetTypes(SymbolContextScope *sc_scope, lldb::TypeClass type_mask, TypeList &type_list) override
bool AddOSOFileRange(CompileUnitInfo *cu_info, lldb::addr_t exe_file_addr, lldb::addr_t exe_byte_size, lldb::addr_t oso_file_addr, lldb::addr_t oso_byte_size)
bool ParseSupportFiles(CompileUnit &comp_unit, SupportFileList &support_files) override
void SetCompileUnit(SymbolFileDWARF *oso_dwarf, const lldb::CompUnitSP &cu_sp)
Type * ResolveTypeUID(lldb::user_id_t type_uid) override
static int SymbolContainsSymbolWithID(lldb::user_id_t *symbol_idx_ptr, const CompileUnitInfo *comp_unit_info)
static int SymbolContainsSymbolWithIndex(uint32_t *symbol_idx_ptr, const CompileUnitInfo *comp_unit_info)
uint32_t CalculateNumCompileUnits() override
This function actually returns the number of object files, which may be less than the actual number o...
bool ParseImportedModules(const SymbolContext &sc, std::vector< SourceModule > &imported_modules) override
lldb::TypeSP FindDefinitionTypeForDWARFDeclContext(const DWARFDIE &die)
size_t GetCompUnitInfosForModule(const Module *oso_module, std::vector< CompileUnitInfo * > &cu_infos)
bool LinkOSOAddress(Address &addr)
Convert addr from a .o file address, to an executable address.
void InitializeObject() override
Initialize the SymbolFile object.
CompilerDeclContext GetDeclContextForUID(lldb::user_id_t uid) override
CompileUnitInfo * GetCompileUnitInfoForSymbolWithID(lldb::user_id_t symbol_id, uint32_t *oso_idx_ptr)
LineTable * LinkOSOLineTable(SymbolFileDWARF *oso_symfile, LineTable *line_table)
Given a line table full of lines with "file addresses" that are for a .o file represented by oso_symf...
CompilerDeclContext GetDeclContextContainingUID(lldb::user_id_t uid) override
void FindGlobalVariables(ConstString name, const CompilerDeclContext &parent_decl_ctx, uint32_t max_matches, VariableList &variables) override
bool ForEachExternalModule(CompileUnit &, llvm::DenseSet< SymbolFile * > &, llvm::function_ref< bool(Module &)>) override
virtual lldb::TypeSP FindCompleteObjCDefinitionTypeForDIE(const DWARFDIE &die, ConstString type_name, bool must_be_implementation)
void SetDebugMapModule(const lldb::ModuleSP &module_sp)
std::vector< CompilerContext > GetCompilerContextForUID(lldb::user_id_t uid) override
void FindTypes(const lldb_private::TypeQuery &match, lldb_private::TypeResults &results) override
Find types using a type-matching object that contains all search parameters.
size_t ParseVariablesForContext(const SymbolContext &sc) override
void GetCompileOptions(std::unordered_map< lldb::CompUnitSP, Args > &args) override
std::optional< ArrayInfo > GetDynamicArrayInfoForUID(lldb::user_id_t type_uid, const ExecutionContext *exe_ctx) override
If type_uid points to an array type, return its characteristics.
size_t ParseBlocksRecursive(Function &func) override
Type * ResolveTypeUID(lldb::user_id_t type_uid) override
size_t ParseFunctions(CompileUnit &comp_unit) override
bool ParseDebugMacros(CompileUnit &comp_unit) override
bool ParseSupportFiles(CompileUnit &comp_unit, SupportFileList &support_files) override
XcodeSDK ParseXcodeSDK(CompileUnit &comp_unit) override
Return the Xcode SDK comp_unit was compiled against.
bool ParseImportedModules(const SymbolContext &sc, std::vector< SourceModule > &imported_modules) override
void GetTypes(SymbolContextScope *sc_scope, lldb::TypeClass type_mask, TypeList &type_list) override
void ParseDeclsForContext(CompilerDeclContext decl_ctx) override
size_t ParseTypes(CompileUnit &comp_unit) override
bool ParseLineTable(CompileUnit &comp_unit) override
bool ParseIsOptimized(CompileUnit &comp_unit) override
virtual lldb::TypeSP FindDefinitionTypeForDWARFDeclContext(const DWARFDIE &die)
void SetFileIndex(std::optional< uint64_t > file_index)
void FindFunctions(const Module::LookupInfo &lookup_info, const CompilerDeclContext &parent_decl_ctx, bool include_inlines, SymbolContextList &sc_list) override
uint32_t ResolveSymbolContext(const Address &so_addr, lldb::SymbolContextItem resolve_scope, SymbolContext &sc) override
bool HasForwardDeclForCompilerType(const CompilerType &compiler_type)
CompilerDeclContext FindNamespace(ConstString name, const CompilerDeclContext &parent_decl_ctx, bool only_root_namespaces) override
Finds a namespace of name name and whose parent context is parent_decl_ctx.
std::vector< std::unique_ptr< CallEdge > > ParseCallEdgesInFunction(UserID func_id) override
lldb::LanguageType ParseLanguage(CompileUnit &comp_unit) override
CompilerDeclContext GetDeclContextForUID(lldb::user_id_t uid) override
std::optional< uint64_t > GetFileIndex() const
#define LLDB_INVALID_ADDRESS
Definition: lldb-defines.h:82
#define UINT32_MAX
Definition: lldb-defines.h:19
A class that represents a running process on the host machine.
Definition: SBAttachInfo.h:14
Log * GetLog(Cat mask)
Retrieve the Log object for the channel associated with the given log enum.
Definition: Log.h:314
int(* ComparisonFunction)(const void *, const void *)
Definition: SBAddress.h:15
std::weak_ptr< lldb_private::Module > ModuleWP
Definition: lldb-forward.h:366
std::shared_ptr< lldb_private::ObjectFile > ObjectFileSP
Definition: lldb-forward.h:367
LanguageType
Programming language type.
@ eLanguageTypeUnknown
Unknown or invalid language value.
std::shared_ptr< lldb_private::Type > TypeSP
Definition: lldb-forward.h:449
@ eSymbolTypeObjCClass
@ eSymbolTypeObjectFile
@ eSymbolTypeSourceFile
uint64_t user_id_t
Definition: lldb-types.h:80
std::shared_ptr< lldb_private::Section > SectionSP
Definition: lldb-forward.h:406
uint64_t addr_t
Definition: lldb-types.h:79
std::shared_ptr< lldb_private::Module > ModuleSP
Definition: lldb-forward.h:365
std::shared_ptr< lldb_private::CompileUnit > CompUnitSP
Definition: lldb-forward.h:327
BaseType GetRangeBase() const
Definition: RangeMap.h:45
SizeType GetByteSize() const
Definition: RangeMap.h:87
BaseType GetRangeEnd() const
Definition: RangeMap.h:78
A mix in class that contains a generic user ID.
Definition: UserID.h:31
lldb::user_id_t GetID() const
Get accessor for the user ID.
Definition: UserID.h:47
const FileRangeMap & GetFileRangeMap(SymbolFileDWARFDebugMap *exe_symfile)