58#include "llvm/ADT/STLExtras.h"
59#include "llvm/Support/Compiler.h"
60#include "llvm/Support/DJB.h"
61#include "llvm/Support/FileSystem.h"
62#include "llvm/Support/FormatVariadic.h"
63#include "llvm/Support/JSON.h"
64#include "llvm/Support/Signals.h"
65#include "llvm/Support/raw_ostream.h"
100 if (g_module_collection ==
nullptr)
103 return *g_module_collection;
112 static std::recursive_mutex *g_module_collection_mutex =
nullptr;
113 if (g_module_collection_mutex ==
nullptr)
114 g_module_collection_mutex =
new std::recursive_mutex;
115 return *g_module_collection_mutex;
119 std::lock_guard<std::recursive_mutex> guard(
125 std::lock_guard<std::recursive_mutex> guard(
128 if (idx < modules.size())
134 : m_unwind_table(*this), m_file_has_changed(false),
135 m_first_file_changed_log(false) {
138 std::lock_guard<std::recursive_mutex> guard(
145 LLDB_LOGF(log,
"%p Module::Module((%s) '%s%s%s%s')",
146 static_cast<void *
>(
this),
153 auto data_sp = module_spec.
GetData();
156 file_size = data_sp->GetByteSize();
162 module_spec.
GetFileSpec(), 0, file_size, modules_specs, data_sp) == 0)
174 matching_module_spec)) {
176 LLDB_LOGF(log,
"Found local object file but the specs didn't match");
184 if (
auto module_spec_data_sp = module_spec.
GetData()) {
238 const llvm::sys::TimePoint<> &object_mod_time)
239 : m_mod_time(
FileSystem::Instance().GetModificationTime(file_spec)),
240 m_arch(arch), m_file(file_spec), m_object_name(object_name),
241 m_object_offset(object_offset), m_object_mod_time(object_mod_time),
242 m_unwind_table(*this), m_file_has_changed(false),
243 m_first_file_changed_log(false) {
246 std::lock_guard<std::recursive_mutex> guard(
253 LLDB_LOGF(log,
"%p Module::Module((%s) '%s%s%s%s')",
260 : m_unwind_table(*this), m_file_has_changed(false),
261 m_first_file_changed_log(false) {
262 std::lock_guard<std::recursive_mutex> guard(
270 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
273 std::lock_guard<std::recursive_mutex> guard(
276 ModuleCollection::iterator end = modules.end();
277 ModuleCollection::iterator pos = std::find(modules.begin(), end,
this);
283 LLDB_LOGF(log,
"%p Module::~Module((%s) '%s%s%s%s')",
299 size_t size_to_read) {
303 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
306 std::shared_ptr<DataBufferHeap> data_sp =
307 std::make_shared<DataBufferHeap>(size_to_read, 0);
309 const size_t bytes_read =
310 process_sp->ReadMemory(header_addr, data_sp->GetBytes(),
311 data_sp->GetByteSize(), readmem_error);
312 if (bytes_read < size_to_read)
313 data_sp->SetByteSize(bytes_read);
314 if (data_sp->GetByteSize() > 0) {
316 header_addr, data_sp);
319 s.
Printf(
"0x%16.16" PRIx64, header_addr);
334 "unable to find suitable object file plug-in");
338 "unable to read header from memory: %s", readmem_error.
AsCString());
349 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
353 if (obj_file !=
nullptr) {
363 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
368 lldbassert(0 &&
"Attempting to overwrite the existing module UUID");
372llvm::Expected<TypeSystemSP>
383 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
385 if (num_comp_units == 0)
390 for (
size_t cu_idx = 0; cu_idx < num_comp_units; cu_idx++) {
422 s->
Printf(
", Module{%p}",
static_cast<void *
>(
this));
426 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
428 return symbols->GetNumCompileUnits();
433 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
437 if (index < num_comp_units) {
439 cu_sp = symbols->GetCompileUnitAtIndex(index);
445 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
453 const Address &so_addr, lldb::SymbolContextItem resolve_scope,
455 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
456 uint32_t resolved_flags = 0;
466 if (section_sp && section_sp->GetModule().get() ==
this) {
470 resolved_flags |= eSymbolContextModule;
474 return resolved_flags;
478 if (resolve_scope & eSymbolContextCompUnit ||
479 resolve_scope & eSymbolContextFunction ||
480 resolve_scope & eSymbolContextBlock ||
481 resolve_scope & eSymbolContextLineEntry ||
482 resolve_scope & eSymbolContextVariable) {
490 if (resolve_scope & eSymbolContextSymbol &&
491 !(resolved_flags & eSymbolContextSymbol)) {
494 Symbol *matching_symbol =
nullptr;
498 [&matching_symbol](
Symbol *symbol) ->
bool {
499 if (symbol->GetType() != eSymbolTypeInvalid) {
500 matching_symbol = symbol;
505 sc.
symbol = matching_symbol;
506 if (!sc.
symbol && resolve_scope & eSymbolContextFunction &&
507 !(resolved_flags & eSymbolContextFunction)) {
508 bool verify_unique =
false;
513 obj_file->ResolveSymbolForAddress(so_addr, verify_unique);
524 if (symtab_objfile && symtab_objfile->
IsStripped()) {
526 if (symfile_objfile != symtab_objfile) {
528 if (symfile_symtab) {
539 resolved_flags |= eSymbolContextSymbol;
547 if (resolve_scope & eSymbolContextSymbol &&
548 !(resolved_flags & eSymbolContextSymbol) && resolve_tail_call_address &&
550 Address previous_addr = so_addr;
551 previous_addr.
Slide(-1);
553 bool do_resolve_tail_call_address =
false;
555 previous_addr, resolve_scope, sc, do_resolve_tail_call_address);
556 if (flags & eSymbolContextSymbol) {
558 if (sc.
GetAddressRange(eSymbolContextFunction | eSymbolContextSymbol, 0,
559 false, addr_range)) {
570 resolved_flags |= flags;
580 return resolved_flags;
584 const char *file_path, uint32_t line,
bool check_inlines,
588 resolve_scope, sc_list);
592 const FileSpec &file_spec, uint32_t line,
bool check_inlines,
594 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
596 "check_inlines = %s, resolve_scope = 0x%8.8x)",
597 file_spec.
GetPath().c_str(), line,
598 check_inlines ?
"yes" :
"no", resolve_scope);
600 const uint32_t initial_count = sc_list.
GetSize();
605 check_inlines,
false);
607 symbols->ResolveSymbolContext(location_spec, resolve_scope, sc_list);
610 return sc_list.
GetSize() - initial_count;
617 symbols->FindGlobalVariables(name, parent_decl_ctx, max_matches, variables);
632 for (
size_t i = 0; i < num_compile_units; ++i) {
642 FunctionNameType name_type_mask,
644 : m_name(name), m_lookup_name(), m_language(language) {
646 llvm::StringRef basename;
647 llvm::StringRef context;
649 if (name_type_mask & eFunctionNameTypeAuto) {
651 m_name_type_mask = eFunctionNameTypeFull;
655 m_name_type_mask = eFunctionNameTypeFull;
657 m_name_type_mask = eFunctionNameTypeFull;
662 m_name_type_mask |= eFunctionNameTypeSelector;
665 basename = cpp_method.GetBasename();
666 if (basename.empty()) {
669 m_name_type_mask |= (eFunctionNameTypeMethod | eFunctionNameTypeBase);
671 m_name_type_mask |= eFunctionNameTypeFull;
673 m_name_type_mask |= (eFunctionNameTypeMethod | eFunctionNameTypeBase);
677 m_name_type_mask = name_type_mask;
678 if (name_type_mask & eFunctionNameTypeMethod ||
679 name_type_mask & eFunctionNameTypeBase) {
683 if (cpp_method.IsValid()) {
684 basename = cpp_method.GetBasename();
686 if (!cpp_method.GetQualifiers().empty()) {
689 m_name_type_mask &= ~(eFunctionNameTypeBase);
690 if (m_name_type_mask == eFunctionNameTypeNone)
702 if (name_type_mask & eFunctionNameTypeSelector) {
704 m_name_type_mask &= ~(eFunctionNameTypeSelector);
705 if (m_name_type_mask == eFunctionNameTypeNone)
712 if (basename.empty()) {
713 if (name_type_mask & eFunctionNameTypeFull &&
716 basename = cpp_method.GetBasename();
717 if (basename.empty())
724 if (!basename.empty()) {
729 m_lookup_name.SetString(basename);
730 m_match_name_after_lookup =
true;
734 m_lookup_name = name;
735 m_match_name_after_lookup =
false;
746 if (
m_name == function_name)
754 const bool function_name_may_be_mangled =
756 ConstString demangled_function_name = function_name;
757 if (function_name_may_be_mangled) {
758 Mangled mangled_function_name(function_name);
766 return language->DemangledNameContainsPath(
m_name, demangled_function_name);
768 llvm::StringRef function_name_ref = demangled_function_name;
769 return function_name_ref.contains(
m_name);
773 size_t start_idx)
const {
774 if (m_match_name_after_lookup && m_name) {
776 size_t i = start_idx;
777 while (i < sc_list.
GetSize()) {
794 if (m_name_type_mask == eFunctionNameTypeFull) {
796 size_t i = start_idx;
797 while (i < sc_list.
GetSize()) {
804 if (mangled_name != m_name && full_name != m_name) {
808 if (cpp_method.
GetBasename().compare(m_name) != 0) {
813 std::string qualified_name;
814 llvm::StringRef anon_prefix(
"(anonymous namespace)");
819 if (qualified_name != m_name.GetCString()) {
837 symbols->FindFunctions(lookup_info, parent_decl_ctx,
842 if (
Symtab *symtab = symbols->GetSymtab()) {
852 FunctionNameType name_type_mask,
855 const size_t old_size = sc_list.
GetSize();
857 FindFunctions(lookup_info, parent_decl_ctx, options, sc_list);
858 if (name_type_mask & eFunctionNameTypeAuto) {
859 const size_t new_size = sc_list.
GetSize();
860 if (old_size < new_size)
861 lookup_info.Prune(sc_list, old_size);
866 FunctionNameType name_type_mask,
869 if (compiler_ctx.empty() ||
877 for (
auto &sc : unfiltered)
878 if (sc.function && compiler_ctx.equals(sc.function->GetCompilerContext()))
885 const size_t start_size = sc_list.
GetSize();
893 Symtab *symtab = symbols->GetSymtab();
895 std::vector<uint32_t> symbol_indexes;
899 const size_t num_matches = symbol_indexes.size();
902 const size_t end_functions_added_index = sc_list.
GetSize();
903 size_t num_functions_added_to_sc_list =
904 end_functions_added_index - start_size;
905 if (num_functions_added_to_sc_list == 0) {
908 for (
size_t i = 0; i < num_matches; ++i) {
916 typedef std::map<lldb::addr_t, uint32_t> FileAddrToIndexMap;
917 FileAddrToIndexMap file_addr_to_index;
918 for (
size_t i = start_size; i < end_functions_added_index; ++i) {
927 FileAddrToIndexMap::const_iterator end = file_addr_to_index.
end();
930 for (
size_t i = start_size; i < num_matches; ++i) {
936 FileAddrToIndexMap::const_iterator pos =
937 file_addr_to_index.find(
942 sc_list[pos->second].symbol = sc.
symbol;
953 const FileSpec &file, uint32_t line,
955 std::vector<Address> &output_local,
956 std::vector<Address> &output_extern) {
969 if (f && f == function)
970 output_local.push_back(addr);
972 output_extern.push_back(addr);
978 symbols->FindTypes(query, results);
986 if (requestors.empty())
989 for (
auto debugger_sp : requestors) {
990 if (!debugger_sp->InterruptRequested())
992 if (debugger_sp->GetTargetList()
993 .AnyTargetContainsModule(module))
994 interruptors.push_back(debugger_sp);
1001 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
1005 if (!interruptors.empty()) {
1006 for (
auto debugger_sp : interruptors) {
1008 "Interrupted fetching symbols for module {0}",
1009 this->GetFileSpec());
1014 if (obj_file !=
nullptr) {
1028 return symbols->GetSymtab();
1072 s << llvm::formatv(
"({0})", object_name);
1087 std::optional<lldb::user_id_t> debugger_id) {
1094 <<
" was compiled with optimization - stepping may behave "
1095 "oddly; variables may not be available.";
1101 LanguageType language, std::optional<lldb::user_id_t> debugger_id) {
1103 ss <<
"This version of LLDB has no plugin for the language \""
1106 "Inspection of frame variables will be limited.";
1112 const llvm::formatv_object_base &payload) {
1121 strm.
PutCString(
"The debug session should be aborted as the original "
1122 "debug information has been overwritten.");
1132 once_ptr = std::make_unique<std::once_flag>();
1133 return once_ptr.get();
1139 std::string msg = payload.str();
1147 std::string msg = payload.str();
1162 Log *log,
const llvm::formatv_object_base &payload) {
1168 std::string back_trace;
1169 llvm::raw_string_ostream stream(back_trace);
1170 llvm::sys::PrintStackTrace(stream);
1177 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
1201 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
1231 ReportError(
"failed to load objfile for {0}\nDebugging will be "
1232 "degraded for this module.",
1245 if (obj_file !=
nullptr)
1256 symbols->SectionFileAddressesChanged();
1274 "Module::FindFirstSymbolWithNameAndType (name = %s, type = %i)",
1277 return symtab->FindFirstSymbolWithNameAndType(
1282 Symtab *symtab, std::vector<uint32_t> &symbol_indexes,
1287 size_t num_indices = symbol_indexes.size();
1288 if (num_indices > 0) {
1291 for (
size_t i = 0; i < num_indices; i++) {
1304 symtab->FindFunctionSymbols(name, name_type_mask, sc_list);
1313 std::vector<uint32_t> symbol_indexes;
1314 symtab->FindAllSymbolsWithNameAndType(name, symbol_type, symbol_indexes);
1325 "Module::FindSymbolsMatchingRegExAndType (regex = %s, type = %i)",
1326 regex.
GetText().str().c_str(), symbol_type);
1328 std::vector<uint32_t> symbol_indexes;
1329 symtab->FindAllSymbolsMatchingRexExAndType(
1331 symbol_indexes, mangling_preference);
1337 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
1345 symtab->PreloadSymbols();
1360 if (section_list && symbol_file) {
1383 std::string new_path(file.
GetPath());
1385 if (llvm::StringRef(old_path).starts_with(new_path)) {
1394 for (
size_t idx = num_sections; idx > 0; --idx) {
1397 if (section_sp->GetObjectFile() == obj_file) {
1424 if (sections !=
nullptr) {
1425 size_t num_sections = sections->
GetSize();
1426 for (
size_t sect_idx = 0; sect_idx < num_sections; sect_idx++) {
1438 Stream &feedback_stream) {
1445 target->TargetProperties::GetLoadScriptFromSymbolFile();
1461 FileSpecList file_specs = platform_sp->LocateExecutableScriptingResources(
1462 target, *
this, feedback_stream);
1464 const uint32_t num_specs = file_specs.
GetSize();
1467 if (script_interpreter) {
1468 for (uint32_t i = 0; i < num_specs; ++i) {
1470 if (scripting_fspec &&
1474 "warning: '%s' contains a debug script. To run this script "
1476 "this debug session:\n\n command script import "
1478 "To run all discovered debug scripts in this session:\n\n"
1479 " settings set target.load-script-from-symbol-file "
1481 GetFileSpec().GetFileNameStrippingExtension().GetCString(),
1482 scripting_fspec.
GetPath().c_str());
1512 bool value_is_offset,
bool &changed) {
1514 if (object_file !=
nullptr) {
1515 changed = object_file->
SetLoadAddress(target, value, value_is_offset);
1556 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
1558 new_spec = *remapped;
1565 std::lock_guard<std::recursive_mutex> guard(
m_mutex);
1567 return remapped->GetPath();
1572 llvm::StringRef sysroot) {
1573 auto sdk_path_or_err =
1574 HostInfo::GetSDKRoot(HostInfo::SDKOptions{sdk_name.str()});
1576 if (!sdk_path_or_err) {
1578 toString(sdk_path_or_err.takeError()));
1582 auto sdk_path = *sdk_path_or_err;
1583 if (sdk_path.empty())
1596 "module has arch %s, merging/replacing with arch %s",
1598 arch_spec.
GetTriple().getTriple().c_str());
1622 return obj_file->GetVersion();
1623 return llvm::VersionTuple();
1636 std::string identifier;
1637 llvm::raw_string_ostream id_strm(identifier);
1646 return llvm::djbHash(identifier);
1651 llvm::raw_string_ostream strm(key);
1655 strm <<
'-' << llvm::format_hex(
Hash(), 10);
1666 .GetLLDBIndexCachePath()
1668 return g_data_file_cache;
static llvm::raw_ostream & error(Stream &strm)
#define REPORT_INTERRUPTION(debugger,...)
#define LLDB_LOGF(log,...)
std::vector< Module * > ModuleCollection
static ModuleCollection & GetModuleCollection()
static Debugger::DebuggerList DebuggersOwningModuleRequestingInterruption(Module &module)
#define LLDB_SCOPED_TIMER()
#define LLDB_SCOPED_TIMERF(...)
A section + offset based address range class.
Address & GetBaseAddress()
Get accessor for the base address of the range.
lldb::addr_t GetByteSize() const
Get accessor for the byte size of this range.
"lldb/Core/AddressResolverFileLine.h" This class finds address for source file and line.
size_t GetNumberOfAddresses()
virtual void ResolveAddress(SearchFilter &filter)
AddressRange & GetAddressRangeAtIndex(size_t idx)
A section + offset based address class.
bool ResolveAddressUsingFileSections(lldb::addr_t addr, const SectionList *sections)
Resolve a file virtual address using a section list.
lldb::SectionSP GetSection() const
Get const accessor for the section.
Function * CalculateSymbolContextFunction() const
bool Slide(int64_t offset)
lldb::addr_t GetFileAddress() const
Get the file address.
lldb::addr_t GetOffset() const
Get the section relative offset value.
bool IsSectionOffset() const
Check if an address is section offset.
An architecture specification class.
bool IsValid() const
Tests if this ArchSpec is valid.
llvm::Triple & GetTriple()
Architecture triple accessor.
void MergeFrom(const ArchSpec &other)
Merges fields from another ArchSpec into this ArchSpec.
bool IsCompatibleMatch(const ArchSpec &rhs) const
Shorthand for IsMatch(rhs, CompatibleMatch).
const char * GetArchitectureName() const
Returns a static string representing the current architecture.
std::string GetScopeQualifiedName()
llvm::StringRef GetContext()
llvm::StringRef GetBasename()
static bool IsCPPMangledName(llvm::StringRef name)
static bool ExtractContextAndIdentifier(const char *name, llvm::StringRef &context, llvm::StringRef &identifier)
const FileSpec & GetPrimaryFile() const
Return the primary source spec associated with this compile unit.
void ForeachFunction(llvm::function_ref< bool(const lldb::FunctionSP &)> lambda) const
Apply a lambda to each function in this compile unit.
Represents a generic declaration context in a program.
A uniqued constant string class.
const char * AsCString(const char *value_if_empty=nullptr) const
Get the string value as a C string.
bool IsEmpty() const
Test for empty string.
void SetString(llvm::StringRef s)
const char * GetCString() const
Get the string value as a C string.
This class enables data to be cached into a directory using the llvm caching code.
A class to manage flag bits.
static void ReportWarning(std::string message, std::optional< lldb::user_id_t > debugger_id=std::nullopt, std::once_flag *once=nullptr)
Report warning events.
lldb::ScriptLanguage GetScriptLanguage() const
static void ReportError(std::string message, std::optional< lldb::user_id_t > debugger_id=std::nullopt, std::once_flag *once=nullptr)
Report error events.
ScriptInterpreter * GetScriptInterpreter(bool can_create=true, std::optional< lldb::ScriptLanguage > language={})
std::vector< lldb::DebuggerSP > DebuggerList
static DebuggerList DebuggersRequestingInterruption()
const FileSpec & GetFileSpecAtIndex(size_t idx) const
Get file at index.
size_t GetSize() const
Get the number of files in the file list.
static bool Match(const FileSpec &pattern, const FileSpec &file)
Match FileSpec pattern against FileSpec file.
const ConstString & GetFilename() const
Filename string const get accessor.
size_t GetPath(char *path, size_t max_path_length, bool denormalize=true) const
Extract the full path to the file.
void Dump(llvm::raw_ostream &s) const
Dump this object to a Stream.
uint64_t GetByteSize(const FileSpec &file_spec) const
Returns the on-disk size of the given file in bytes.
llvm::sys::TimePoint GetModificationTime(const FileSpec &file_spec) const
Returns the modification time of the given file.
static FileSystem & Instance()
A class that describes a function.
const AddressRange & GetAddressRange()
DEPRECATED: Use GetAddressRanges instead.
static Language * FindPlugin(lldb::LanguageType language)
static const char * GetNameForLanguageType(lldb::LanguageType language)
static bool LanguageIsC(lldb::LanguageType language)
static bool LanguageIsObjC(lldb::LanguageType language)
void PutCString(const char *cstr)
A class that handles mangled names.
static Mangled::ManglingScheme GetManglingScheme(llvm::StringRef const name)
Try to identify the mangling scheme used.
ConstString GetDemangledName() const
Demangled name get accessor.
static ModuleListProperties & GetGlobalModuleListProperties()
bool FindMatchingModuleSpec(const ModuleSpec &module_spec, ModuleSpec &match_module_spec) const
uint64_t GetObjectOffset() const
ConstString & GetObjectName()
FileSpec & GetPlatformFileSpec()
lldb::DataBufferSP GetData() const
ArchSpec & GetArchitecture()
FileSpec & GetSymbolFileSpec()
llvm::sys::TimePoint & GetObjectModificationTime()
A class that encapsulates name lookup information.
lldb::FunctionNameType GetNameTypeMask() const
ConstString GetLookupName() const
bool NameMatchesLookupInfo(ConstString function_name, lldb::LanguageType language_type=lldb::eLanguageTypeUnknown) const
ConstString m_name
What the user originally typed.
void Prune(SymbolContextList &sc_list, size_t start_idx) const
A class that describes an executable image and its associated object and symbol files.
const lldb_private::UUID & GetUUID()
Get a reference to the UUID value contained in this object.
uint32_t ResolveSymbolContextForFilePath(const char *file_path, uint32_t line, bool check_inlines, lldb::SymbolContextItem resolve_scope, SymbolContextList &sc_list)
Resolve items in the symbol context for a given file and line.
std::atomic< bool > m_did_set_uuid
void ReportWarningOptimization(std::optional< lldb::user_id_t > debugger_id)
PathMappingList m_source_mappings
Module specific source remappings for when you have debug info for a module that doesn't match where ...
llvm::sys::TimePoint m_object_mod_time
virtual ObjectFile * GetObjectFile()
Get the object file representation for the current architecture.
void FindGlobalVariables(ConstString name, const CompilerDeclContext &parent_decl_ctx, size_t max_matches, VariableList &variable_list)
Find global and static variables by name.
void ReportWarning(const char *format, Args &&...args)
FileSpec m_file
The file representation on disk for this module (if there is one).
virtual SymbolFile * GetSymbolFile(bool can_create=true, Stream *feedback_strm=nullptr)
Get the module's symbol file.
static DataFileCache * GetIndexCache()
Get the global index file cache.
std::vector< lldb::SymbolVendorUP > m_old_symfiles
If anyone calls Module::SetSymbolFileFileSpec() and changes the symbol file,.
void ReportWarningUnsupportedLanguage(lldb::LanguageType language, std::optional< lldb::user_id_t > debugger_id)
std::once_flag * GetDiagnosticOnceFlag(llvm::StringRef msg)
void FindCompileUnits(const FileSpec &path, SymbolContextList &sc_list)
Find compile units by partial or full path.
ConstString GetObjectName() const
uint32_t Hash()
Get a unique hash for this module.
lldb::ModuleSP CalculateSymbolContextModule() override
static Module * GetAllocatedModuleAtIndex(size_t idx)
std::recursive_mutex m_diagnostic_mutex
UUID m_uuid
Each module is assumed to have a unique identifier to help match it up to debug symbols.
std::optional< std::string > RemapSourceFile(llvm::StringRef path) const
Remaps a source file given path into new_path.
llvm::sys::TimePoint m_mod_time
The modification time for this module when it was created.
lldb::CompUnitSP GetCompileUnitAtIndex(size_t idx)
uint32_t ResolveSymbolContextForAddress(const Address &so_addr, lldb::SymbolContextItem resolve_scope, SymbolContext &sc, bool resolve_tail_call_address=false)
Resolve the symbol context for the given address.
void SetFileSpecAndObjectName(const FileSpec &file, ConstString object_name)
std::recursive_mutex m_mutex
A mutex to keep this object happy in multi-threaded environments.
static std::recursive_mutex & GetAllocationModuleCollectionMutex()
lldb::DataBufferSP m_data_sp
DataBuffer containing the module image, if it was provided at construction time.
bool SetLoadAddress(Target &target, lldb::addr_t value, bool value_is_offset, bool &changed)
Set the load address for all sections in a module to be the file address plus slide.
void SetSymbolFileFileSpec(const FileSpec &file)
void RegisterXcodeSDK(llvm::StringRef sdk, llvm::StringRef sysroot)
This callback will be called by SymbolFile implementations when parsing a compile unit that contains ...
void FindSymbolsWithNameAndType(ConstString name, lldb::SymbolType symbol_type, SymbolContextList &sc_list)
void CalculateSymbolContext(SymbolContext *sc) override
Reconstruct the object's symbol context into sc.
FileSpec m_symfile_spec
If this path is valid, then this is the file that will be used as the symbol file for this module.
StatsDuration m_symtab_index_time
We store a symbol named index time duration here because we might have an object file and a symbol fi...
bool ResolveFileAddress(lldb::addr_t vm_addr, Address &so_addr)
ArchSpec m_arch
The architecture for this module.
void ReportError(const char *format, Args &&...args)
const FileSpec & GetPlatformFileSpec() const
Get accessor for the module platform file specification.
lldb::SymbolVendorUP m_symfile_up
A pointer to the symbol vendor for this module.
const Symbol * FindFirstSymbolWithNameAndType(ConstString name, lldb::SymbolType symbol_type=lldb::eSymbolTypeAny)
Find a symbol in the object file's symbol table.
llvm::DenseMap< llvm::stable_hash, std::unique_ptr< std::once_flag > > m_shown_diagnostics
A set of hashes of all warnings and errors, to avoid reporting them multiple times to the same Debugg...
llvm::VersionTuple GetVersion()
void FindAddressesForLine(const lldb::TargetSP target_sp, const FileSpec &file, uint32_t line, Function *function, std::vector< Address > &output_local, std::vector< Address > &output_extern)
Find addresses by file/line.
void FindFunctions(const LookupInfo &lookup_info, const CompilerDeclContext &parent_decl_ctx, const ModuleFunctionSearchOptions &options, SymbolContextList &sc_list)
Find functions by lookup info.
void DumpSymbolContext(Stream *s) override
Dump the object's symbol context to the stream s.
void FindFunctionSymbols(ConstString name, uint32_t name_type_mask, SymbolContextList &sc_list)
Find a function symbols in the object file's symbol table.
size_t GetNumCompileUnits()
Get the number of compile units for this module.
ConstString m_object_name
The name an object within this module that is selected, or empty of the module is represented by m_fi...
void LogMessage(Log *log, const char *format, Args &&...args)
bool MatchesModuleSpec(const ModuleSpec &module_ref)
~Module() override
Destructor.
static size_t GetNumberAllocatedModules()
ObjectFile * GetMemoryObjectFile(const lldb::ProcessSP &process_sp, lldb::addr_t header_addr, Status &error, size_t size_to_read=512)
Load an object file from memory.
bool LoadScriptingResourceInTarget(Target *target, Status &error, Stream &feedback_stream)
TypeSystemMap m_type_system_map
A map of any type systems associated with this module.
void ForEachTypeSystem(llvm::function_ref< bool(lldb::TypeSystemSP)> callback)
Call callback for each TypeSystem in this Module.
lldb::SectionListUP m_sections_up
Unified section list for module that is used by the ObjectFile and ObjectFile instances for the debug...
bool IsExecutable()
Tells whether this module is capable of being the main executable for a process.
FileSpec m_platform_file
The path to the module on the platform on which it is being debugged.
bool MergeArchitecture(const ArchSpec &arch_spec)
Update the ArchSpec to a more specific variant.
bool FileHasChanged() const
const ArchSpec & GetArchitecture() const
Get const accessor for the module architecture.
void LogMessageVerboseBacktrace(Log *log, const char *format, Args &&...args)
bool GetIsDynamicLinkEditor()
std::string GetCacheKey()
Get a unique cache key for the current module.
virtual SectionList * GetSectionList()
Get the unified section list for the module.
llvm::Expected< lldb::TypeSystemSP > GetTypeSystemForLanguage(lldb::LanguageType language)
void Dump(Stream *s)
Dump a description of this object to a Stream.
uint32_t ResolveSymbolContextsForFileSpec(const FileSpec &file_spec, uint32_t line, bool check_inlines, lldb::SymbolContextItem resolve_scope, SymbolContextList &sc_list)
Resolve items in the symbol context for a given file and line.
lldb::ObjectFileSP m_objfile_sp
A shared pointer to the object file parser for this module as it may or may not be shared with the Sy...
void ReportErrorIfModifyDetected(const char *format, Args &&...args)
void FindSymbolsMatchingRegExAndType(const RegularExpression ®ex, lldb::SymbolType symbol_type, SymbolContextList &sc_list, Mangled::NamePreference mangling_preference=Mangled::ePreferDemangled)
std::atomic< bool > m_did_load_symfile
UnwindTable & GetUnwindTable()
Returns a reference to the UnwindTable for this Module.
std::string GetSpecificationDescription() const
Get the module path and object name.
UnwindTable m_unwind_table
Table of FuncUnwinders objects created for this Module's functions.
const FileSpec & GetFileSpec() const
Get const accessor for the module file specification.
bool IsLoadedInTarget(Target *target)
Tells whether this module has been loaded in the target passed in.
void GetDescription(llvm::raw_ostream &s, lldb::DescriptionLevel level=lldb::eDescriptionLevelFull)
void SetUUID(const lldb_private::UUID &uuid)
bool m_first_file_changed_log
void SymbolIndicesToSymbolContextList(Symtab *symtab, std::vector< uint32_t > &symbol_indexes, SymbolContextList &sc_list)
virtual void SectionFileAddressesChanged()
Notify the module that the file addresses for the Sections have been updated.
std::atomic< bool > m_did_load_objfile
bool FindSourceFile(const FileSpec &orig_spec, FileSpec &new_spec) const
Finds a source file given a file spec using the module source path remappings (if any).
void FindTypes(const TypeQuery &query, TypeResults &results)
Find types using a type-matching object that contains all search parameters.
bool SetArchitecture(const ArchSpec &new_arch)
SectionList * GetUnifiedSectionList()
StatsDuration m_symtab_parse_time
See if the module was modified after it was initially opened.
void ParseAllDebugSymbols()
A debugging function that will cause everything in a module to be parsed.
static bool IsPossibleObjCSelector(const char *name)
static bool IsPossibleObjCMethodName(const char *name)
A plug-in interface definition class for object file parsers.
static lldb::ObjectFileSP FindPlugin(const lldb::ModuleSP &module_sp, const FileSpec *file_spec, lldb::offset_t file_offset, lldb::offset_t file_size, lldb::DataBufferSP &data_sp, lldb::offset_t &data_offset)
Find a ObjectFile plug-in that can parse file_spec.
virtual bool SetLoadAddress(Target &target, lldb::addr_t value, bool value_is_offset)
Sets the load address for an entire module, assuming a rigid slide of sections, if possible in the im...
virtual void Dump(Stream *s)=0
Dump a description of this object to a Stream.
Symtab * GetSymtab()
Gets the symbol table for the currently selected architecture (and object for archives).
virtual bool IsStripped()=0
Detect if this object file has been stripped of local symbols.
virtual bool IsExecutable() const =0
Tells whether this object file is capable of being the main executable for a process.
virtual void ClearSymtab()
Frees the symbol table.
virtual FileSpec & GetFileSpec()
Get accessor to the object file specification.
virtual void CreateSections(SectionList &unified_section_list)=0
virtual void SectionFileAddressesChanged()
Notify the ObjectFile that the file addresses in the Sections for this module have been changed.
virtual UUID GetUUID()=0
Gets the UUID for this object file.
virtual bool GetIsDynamicLinkEditor()
Return true if this file is a dynamic link editor (dyld)
static size_t GetModuleSpecifications(const FileSpec &file, lldb::offset_t file_offset, lldb::offset_t file_size, ModuleSpecList &specs, lldb::DataBufferSP data_sp=lldb::DataBufferSP())
std::optional< FileSpec > FindFile(const FileSpec &orig_spec) const
Finds a source file given a file spec using the path remappings.
bool Replace(llvm::StringRef path, llvm::StringRef replacement, bool notify)
void Append(llvm::StringRef path, llvm::StringRef replacement, bool notify)
bool RemapPath(ConstString path, ConstString &new_path) const
llvm::StringRef GetText() const
Access the regular expression text.
virtual bool LoadScriptingModule(const char *filename, const LoadScriptOptions &options, lldb_private::Status &error, StructuredData::ObjectSP *module_sp=nullptr, FileSpec extra_search_dir={})
This is a SearchFilter that restricts the search to a given module.
size_t GetNumSections(uint32_t depth) const
bool DeleteSection(size_t idx)
lldb::SectionSP GetSectionAtIndex(size_t idx) const
"lldb/Core/SourceLocationSpec.h" A source location specifier class.
static Status FromErrorStringWithFormat(const char *format,...) __attribute__((format(printf
static Status FromErrorString(const char *str)
const char * AsCString(const char *default_error_str="unknown error") const
Get the error string associated with the current error.
const char * GetData() const
llvm::StringRef GetString() const
A stream class that can stream formatted output to a file.
llvm::raw_ostream & AsRawOstream()
Returns a raw_ostream that forwards the data to this Stream object.
size_t Indent(llvm::StringRef s="")
Indent the current line in the stream.
size_t Printf(const char *format,...) __attribute__((format(printf
Output printf formatted output to the stream.
size_t PutCString(llvm::StringRef cstr)
Output a C string to the stream.
void IndentLess(unsigned amount=2)
Decrement the current indentation level.
void IndentMore(unsigned amount=2)
Increment the current indentation level.
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.
const_iterator end() const
bool RemoveContextAtIndex(size_t idx)
void Append(const SymbolContext &sc)
Append a new symbol context to the list.
Defines a symbol context baton that can be handed other debug core functions.
lldb::LanguageType GetLanguage() const
Function * function
The Function for a given query.
ConstString GetFunctionName(Mangled::NamePreference preference=Mangled::ePreferDemangled) const
Find a name of the innermost function for the symbol context.
Block * block
The Block for a given query.
lldb::ModuleSP module_sp
The Module for a given query.
CompileUnit * comp_unit
The CompileUnit for a given query.
void Clear(bool clear_target)
Clear the object's state.
bool GetAddressRange(uint32_t scope, uint32_t range_idx, bool use_inline_block_range, AddressRange &range) const
Get the address range contained within a symbol context.
Symbol * symbol
The Symbol for a given query.
Provides public interface for all SymbolFiles.
virtual size_t ParseTypes(CompileUnit &comp_unit)=0
virtual Symtab * GetSymtab()=0
virtual void SetLoadDebugInfoEnabled()
Specify debug info should be loaded.
virtual void PreloadSymbols()
virtual void FindGlobalVariables(ConstString name, const CompilerDeclContext &parent_decl_ctx, uint32_t max_matches, VariableList &variables)
virtual size_t ParseFunctions(CompileUnit &comp_unit)=0
virtual size_t ParseBlocksRecursive(Function &func)=0
virtual lldb::CompUnitSP GetCompileUnitAtIndex(uint32_t idx)=0
virtual size_t ParseVariablesForContext(const SymbolContext &sc)=0
virtual ObjectFile * GetObjectFile()=0
virtual void ResetStatistics()
Reset the statistics for the symbol file.
virtual uint32_t ResolveSymbolContext(const Address &so_addr, lldb::SymbolContextItem resolve_scope, SymbolContext &sc)=0
static void DownloadSymbolFileAsync(const UUID &uuid)
Locate the symbol file for the given UUID on a background thread.
static SymbolVendor * FindPlugin(const lldb::ModuleSP &module_sp, Stream *feedback_strm)
bool ValueIsAddress() const
Address & GetAddressRef()
lldb::SymbolType GetType() const
Symbol * SymbolAtIndex(size_t idx)
void ForEachSymbolContainingFileAddress(lldb::addr_t file_addr, std::function< bool(Symbol *)> const &callback)
Symbol * FindSymbolContainingFileAddress(lldb::addr_t file_addr)
ObjectFile * GetObjectFile() const
uint32_t AppendSymbolIndexesMatchingRegExAndType(const RegularExpression ®ex, lldb::SymbolType symbol_type, std::vector< uint32_t > &indexes, Mangled::NamePreference name_preference=Mangled::ePreferDemangled)
lldb::PlatformSP GetPlatform()
A class that contains all state required for type lookups.
This class tracks the state and results of a TypeQuery.
llvm::Expected< lldb::TypeSystemSP > GetTypeSystemForLanguage(lldb::LanguageType language, Module *module, bool can_create)
void ForEach(std::function< bool(lldb::TypeSystemSP)> const &callback)
void ModuleWasUpdated()
Called after an ObjectFile/SymbolFile has been added to a Module to add any new unwind sections that ...
#define LLDB_INVALID_ADDRESS
A class that represents a running process on the host machine.
Log * GetLog(Cat mask)
Retrieve the Log object for the channel associated with the given log enum.
@ eLoadScriptFromSymFileFalse
@ eLoadScriptFromSymFileWarn
const char * toString(AppleArm64ExceptionClass EC)
std::shared_ptr< lldb_private::Function > FunctionSP
ScriptLanguage
Script interpreter types.
std::shared_ptr< lldb_private::TypeSystem > TypeSystemSP
DescriptionLevel
Description levels for "void GetDescription(Stream *, DescriptionLevel)" calls.
std::shared_ptr< lldb_private::Platform > PlatformSP
LanguageType
Programming language type.
@ eLanguageTypeUnknown
Unknown or invalid language value.
std::shared_ptr< lldb_private::Process > ProcessSP
std::shared_ptr< lldb_private::Section > SectionSP
std::shared_ptr< lldb_private::Target > TargetSP
std::shared_ptr< lldb_private::Module > ModuleSP
std::shared_ptr< lldb_private::CompileUnit > CompUnitSP
Options used by Module::FindFunctions.
bool include_inlines
Include inlined functions.
bool include_symbols
Include the symbol table.