#include <ModuleSpec.h>

Public Member Functions
	ModuleSpec ()=default
	ModuleSpec (const FileSpec &file_spec, const UUID &uuid=UUID(), lldb::DataExtractorSP extractor_sp=lldb::DataExtractorSP())
	If the `extractor_sp` argument is passed, its contents will be used as the module contents instead of trying to read them from `file_spec` .
	ModuleSpec (const FileSpec &file_spec, const ArchSpec &arch)
FileSpec *	GetFileSpecPtr ()
const FileSpec *	GetFileSpecPtr () const
FileSpec &	GetFileSpec ()
const FileSpec &	GetFileSpec () const
FileSpec *	GetPlatformFileSpecPtr ()
const FileSpec *	GetPlatformFileSpecPtr () const
FileSpec &	GetPlatformFileSpec ()
const FileSpec &	GetPlatformFileSpec () const
FileSpec *	GetSymbolFileSpecPtr ()
const FileSpec *	GetSymbolFileSpecPtr () const
FileSpec &	GetSymbolFileSpec ()
const FileSpec &	GetSymbolFileSpec () const
ArchSpec *	GetArchitecturePtr ()
const ArchSpec *	GetArchitecturePtr () const
ArchSpec &	GetArchitecture ()
const ArchSpec &	GetArchitecture () const
UUID *	GetUUIDPtr ()
const UUID *	GetUUIDPtr () const
UUID &	GetUUID ()
const UUID &	GetUUID () const
ConstString &	GetObjectName ()
ConstString	GetObjectName () const
uint64_t	GetObjectOffset () const
void	SetObjectOffset (uint64_t object_offset)
uint64_t	GetObjectSize () const
void	SetObjectSize (uint64_t object_size)
std::optional< lldb::addr_t >	GetLoadAddress () const
	Get the load address of a module in process memory.
void	SetLoadAddress (lldb::addr_t addr)
	Set the load address of a module in process memory.
void	ClearLoadAddress ()
llvm::sys::TimePoint &	GetObjectModificationTime ()
const llvm::sys::TimePoint &	GetObjectModificationTime () const
PathMappingList &	GetSourceMappingList () const
lldb::DataExtractorSP	GetExtractor () const
lldb::TargetSP	GetTargetSP () const
void	SetTarget (lldb::TargetSP target)
	Set the target to be used when resolving a module.
lldb::PlatformSP	GetPlatformSP () const
void	SetPlatform (lldb::PlatformSP platform)
	Set the platform to be used when resolving a module.
void	Clear ()
	operator bool () const
void	Dump (Stream &strm) const
bool	Matches (const ModuleSpec &match_module_spec, bool exact_arch_match) const

Protected Attributes
FileSpec	m_file
FileSpec	m_platform_file
FileSpec	m_symbol_file
ArchSpec	m_arch
UUID	m_uuid
ConstString	m_object_name
std::weak_ptr< Target >	m_target_wp
	The target used when resolving a module.
std::weak_ptr< Platform >	m_platform_wp
	The platform used when resolving a module.
uint64_t	m_object_offset = 0
uint64_t	m_object_size = 0
llvm::sys::TimePoint	m_object_mod_time
PathMappingList	m_source_mappings
lldb::DataExtractorSP	m_extractor_sp = {}
std::optional< lldb::addr_t >	m_load_addr = std::nullopt
	The load address of the module in a process.

Detailed Description

Definition at line 31 of file ModuleSpec.h.

Constructor & Destructor Documentation

◆ ModuleSpec() [1/3]

lldb_private::ModuleSpec::ModuleSpec ( )

default

Referenced by Matches().

◆ ModuleSpec() [2/3]

lldb_private::ModuleSpec::ModuleSpec	(	const FileSpec &	file_spec,
		const UUID &	uuid = UUID(),
		lldb::DataExtractorSP	extractor_sp = lldb::DataExtractorSP() )

inline

If the extractor_sp argument is passed, its contents will be used as the module contents instead of trying to read them from file_spec .

Definition at line 38 of file ModuleSpec.h.

References lldb_private::FileSystem::Instance(), m_extractor_sp, m_file, m_object_offset, m_object_size, and m_uuid.

◆ ModuleSpec() [3/3]

lldb_private::ModuleSpec::ModuleSpec	(	const FileSpec &	file_spec,
		const ArchSpec &	arch )

inline

Definition at line 48 of file ModuleSpec.h.

References m_arch, m_file, m_object_offset, and m_object_size.

Member Function Documentation

◆ Clear()

void lldb_private::ModuleSpec::Clear ( )

inline

◆ ClearLoadAddress()

void lldb_private::ModuleSpec::ClearLoadAddress ( )

inline

Definition at line 129 of file ModuleSpec.h.

References m_load_addr.

◆ Dump()

void lldb_private::ModuleSpec::Dump ( Stream & strm ) const

inline

Definition at line 201 of file ModuleSpec.h.

References lldb_private::Stream::AsRawOstream(), lldb_private::Stream::Format(), m_arch, m_file, m_load_addr, m_object_mod_time, m_object_name, m_object_offset, m_object_size, m_platform_file, m_symbol_file, m_uuid, lldb_private::Stream::Printf(), and lldb_private::Stream::PutCString().

Referenced by lldb_private::platform_gdb_server::PlatformRemoteGDBServer::GetModuleSpec(), lldb_private::process_gdb_remote::ProcessGDBRemote::GetModuleSpec(), and DynamicLoaderPOSIXDYLD::ResolveExecutableModule().

◆ GetArchitecture() [1/2]

ArchSpec & lldb_private::ModuleSpec::GetArchitecture ( )

inline

Definition at line 94 of file ModuleSpec.h.

References m_arch.

Referenced by lldb::SBTarget::AddModule(), CommandObjectTargetSymbolsAdd::AddModuleSymbols(), CommandObjectTargetSymbolsAdd::AddSymbolsForFile(), CommandObjectTargetSymbolsAdd::AddSymbolsForFrame(), CommandObjectTargetSymbolsAdd::AddSymbolsForStack(), ProcessKDP::DoConnectRemote(), CommandObjectTargetModulesAdd::DoExecute(), lldb_private::SymbolLocatorDebugSymbols::DownloadObjectAndSymbolFile(), ObjectFileMachO::Dump(), FileAtPathContainsArchAndUUID(), FindModulesByName(), lldb_private::SymbolLocatorDebugSymbols::FindSymbolFileInBundle(), lldb_private::DynamicLoaderDarwin::FindTargetModuleForImageInfo(), ObjectFileMachO::GetAllArchSpecs(), ObjectFileMachO::GetArchitecture(), lldb_private::ScriptedProcess::GetLoadedDynamicLibrariesInfos(), ProcessElfCore::GetMainExecutableModuleSpec(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetModuleInfo(), lldb_private::ObjectFilePDB::GetModuleSpecifications(), ObjectContainerBSDArchive::GetModuleSpecifications(), ObjectContainerClangOffloadBundle::GetModuleSpecifications(), ObjectFileELF::GetModuleSpecifications(), ObjectFilePECOFF::GetModuleSpecifications(), ObjectFileXCOFF::GetModuleSpecifications(), lldb_private::Platform::GetRemoteSharedModule(), lldb_private::ModuleList::GetSharedModule(), lldb_private::PlatformMacOSX::GetSharedModule(), lldb_private::PlatformDarwinDevice::GetSharedModuleWithLocalCache(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_jModulesInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qModuleInfo(), lldb_private::SymbolLocatorDefault::LocateExecutableSymbolFile(), Matches(), lldb_private::Module::MatchesModuleSpec(), lldb_private::Module::Module(), ObjectFileMachO::ParseHeader(), ParseModuleSpec(), lldb_private::minidump::ProcessMinidump::ReadModuleList(), lldb_private::Platform::ResolveExecutable(), and lldb_private::plugin::dwarf::SymbolFileDWARF::UpdateExternalModuleListIfNeeded().

◆ GetArchitecture() [2/2]

const ArchSpec & lldb_private::ModuleSpec::GetArchitecture ( ) const

inline

Definition at line 96 of file ModuleSpec.h.

References m_arch.

◆ GetArchitecturePtr() [1/2]

ArchSpec * lldb_private::ModuleSpec::GetArchitecturePtr ( )

inline

Definition at line 86 of file ModuleSpec.h.

References m_arch.

Referenced by FileAtPathContainsArchAndUUID(), lldb_private::ModuleSpecList::FindMatchingModuleSpec(), lldb_private::ModuleSpecList::FindMatchingModuleSpecs(), lldb_private::SymbolLocatorDebugSymbols::FindSymbolFileInBundle(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDefault::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableSymbolFile(), LocateMacOSXFilesUsingDebugSymbols(), LookForDsymNextToExecutablePath(), Matches(), and lldb_private::PlatformDarwin::ResolveSymbolFile().

◆ GetArchitecturePtr() [2/2]

const ArchSpec * lldb_private::ModuleSpec::GetArchitecturePtr ( ) const

inline

Definition at line 90 of file ModuleSpec.h.

References m_arch.

◆ GetExtractor()

lldb::DataExtractorSP lldb_private::ModuleSpec::GetExtractor ( ) const

inline

Definition at line 141 of file ModuleSpec.h.

References m_extractor_sp.

Referenced by lldb_private::Module::Module().

◆ GetFileSpec() [1/2]

FileSpec & lldb_private::ModuleSpec::GetFileSpec ( )

inline

Definition at line 58 of file ModuleSpec.h.

References m_file.

◆ GetFileSpec() [2/2]

const FileSpec & lldb_private::ModuleSpec::GetFileSpec ( ) const

inline

Definition at line 60 of file ModuleSpec.h.

References m_file.

◆ GetFileSpecPtr() [1/2]

FileSpec * lldb_private::ModuleSpec::GetFileSpecPtr ( )

inline

Definition at line 52 of file ModuleSpec.h.

References m_file.

Referenced by CommandObjectTargetModulesLoad::DoExecute(), lldb_private::SymbolLocatorDebugSymbols::DownloadObjectAndSymbolFile(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::GetModuleInfo(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableSymbolFile(), and LocateMacOSXFilesUsingDebugSymbols().

◆ GetFileSpecPtr() [2/2]

const FileSpec * lldb_private::ModuleSpec::GetFileSpecPtr ( ) const

inline

Definition at line 54 of file ModuleSpec.h.

References m_file.

◆ GetLoadAddress()

std::optional< lldb::addr_t > lldb_private::ModuleSpec::GetLoadAddress ( ) const

inline

Get the load address of a module in process memory.

If the optional has no value, there is no load address for this module spec.

Definition at line 124 of file ModuleSpec.h.

References m_load_addr.

Referenced by ProcessElfCore::FindModuleUUID(), Matches(), and lldb_private::Module::MatchesModuleSpec().

◆ GetObjectModificationTime() [1/2]

llvm::sys::TimePoint & lldb_private::ModuleSpec::GetObjectModificationTime ( )

inline

Definition at line 131 of file ModuleSpec.h.

References m_object_mod_time.

Referenced by ObjectContainerBSDArchive::GetModuleSpecifications(), lldb_private::plugin::dwarf::SymbolFileDWARFDebugMap::GetSeparateDebugInfoFiles(), and lldb_private::Module::Module().

◆ GetObjectModificationTime() [2/2]

const llvm::sys::TimePoint & lldb_private::ModuleSpec::GetObjectModificationTime ( ) const

inline

Definition at line 135 of file ModuleSpec.h.

References m_object_mod_time.

◆ GetObjectName() [1/2]

ConstString & lldb_private::ModuleSpec::GetObjectName ( )

inline

Definition at line 108 of file ModuleSpec.h.

References m_object_name.

Referenced by lldb_private::DynamicLoaderDarwin::AddModulesUsingPreloadedModules(), lldb_private::ObjectContainerMachOFileset::GetModuleSpecifications(), ObjectContainerBSDArchive::GetModuleSpecifications(), lldb_private::plugin::dwarf::SymbolFileDWARFDebugMap::GetSeparateDebugInfoFiles(), Matches(), lldb_private::Module::MatchesModuleSpec(), and lldb_private::Module::Module().

◆ GetObjectName() [2/2]

ConstString lldb_private::ModuleSpec::GetObjectName ( ) const

inline

Definition at line 110 of file ModuleSpec.h.

References m_object_name.

◆ GetObjectOffset()

uint64_t lldb_private::ModuleSpec::GetObjectOffset ( ) const

inline

Definition at line 112 of file ModuleSpec.h.

References m_object_offset.

Referenced by lldb_private::Platform::GetCachedSharedModule(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_jModulesInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qModuleInfo(), and lldb_private::Module::Module().

◆ GetObjectSize()

uint64_t lldb_private::ModuleSpec::GetObjectSize ( ) const

inline

Definition at line 118 of file ModuleSpec.h.

References m_object_size.

Referenced by lldb_private::ModuleCache::Get(), lldb_private::Platform::GetCachedSharedModule(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_jModulesInfo(), and lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qModuleInfo().

◆ GetPlatformFileSpec() [1/2]

FileSpec & lldb_private::ModuleSpec::GetPlatformFileSpec ( )

inline

Definition at line 70 of file ModuleSpec.h.

References m_platform_file.

Referenced by CommandObjectTargetSymbolsAdd::AddModuleSymbols(), CommandObjectTargetSymbolsAdd::AddSymbolsForFile(), ProcessElfCore::DoLoadCore(), lldb_private::SymbolContext::FindBestGlobalDataSymbol(), lldb_private::Platform::GetCachedExecutable(), ProcessElfCore::GetMainExecutableModuleSpec(), lldb_private::ModuleList::GetSharedModule(), lldb_private::PlatformDarwinDevice::GetSharedModuleWithLocalCache(), lldb_private::ClangExpressionDeclMap::GetSymbolAddress(), Matches(), lldb_private::Module::MatchesModuleSpec(), lldb_private::Module::Module(), lldb_private::trace_intel_pt::TraceIntelPTBundleLoader::ParseModule(), and lldb_private::ModuleList::ReplaceEquivalent().

◆ GetPlatformFileSpec() [2/2]

const FileSpec & lldb_private::ModuleSpec::GetPlatformFileSpec ( ) const

inline

Definition at line 72 of file ModuleSpec.h.

References m_platform_file.

◆ GetPlatformFileSpecPtr() [1/2]

FileSpec * lldb_private::ModuleSpec::GetPlatformFileSpecPtr ( )

inline

Definition at line 62 of file ModuleSpec.h.

References m_platform_file.

◆ GetPlatformFileSpecPtr() [2/2]

const FileSpec * lldb_private::ModuleSpec::GetPlatformFileSpecPtr ( ) const

inline

Definition at line 66 of file ModuleSpec.h.

References m_platform_file.

◆ GetPlatformSP()

lldb::PlatformSP lldb_private::ModuleSpec::GetPlatformSP ( ) const

inline

Definition at line 153 of file ModuleSpec.h.

References m_platform_wp.

Referenced by lldb_private::ModuleList::GetSharedModule().

◆ GetSourceMappingList()

PathMappingList & lldb_private::ModuleSpec::GetSourceMappingList ( ) const

inline

Definition at line 139 of file ModuleSpec.h.

References m_source_mappings.

Referenced by SymbolVendorMacOSX::CreateInstance(), and GetModuleSpecInfoFromUUIDDictionary().

◆ GetSymbolFileSpec() [1/2]

FileSpec & lldb_private::ModuleSpec::GetSymbolFileSpec ( )

inline

Definition at line 82 of file ModuleSpec.h.

References m_symbol_file.

Referenced by lldb::SBTarget::AddModule(), CommandObjectTargetSymbolsAdd::AddModuleSymbols(), lldb_private::wasm::SymbolVendorWasm::CreateInstance(), SymbolVendorELF::CreateInstance(), SymbolVendorPECOFF::CreateInstance(), ProcessKDP::DoConnectRemote(), CommandObjectTargetModulesAdd::DoExecute(), CommandObjectTargetSymbolsAdd::DoExecute(), CommandObjectTargetSymbolsAdd::DownloadObjectAndSymbolFile(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwpSymbolFile(), getFileName(), GetModuleSpecInfoFromUUIDDictionary(), lldb_private::ModuleList::GetSharedModule(), lldb_private::PlatformDarwinDevice::GetSharedModuleWithLocalCache(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableSymbolFile(), lldb_private::SymbolLocatorDefault::LocateExecutableSymbolFile(), lldb_private::SymbolLocatorSymStore::LocateExecutableSymbolFile(), LocateMacOSXFilesUsingDebugSymbols(), lldb_private::SymbolLocator::LocateWithPlugins(), LookForDsymNextToExecutablePath(), Matches(), lldb_private::Module::Module(), lldb_private::Platform::ResolveSymbolFile(), and lldb_private::PlatformDarwin::ResolveSymbolFile().

◆ GetSymbolFileSpec() [2/2]

const FileSpec & lldb_private::ModuleSpec::GetSymbolFileSpec ( ) const

inline

Definition at line 84 of file ModuleSpec.h.

References m_symbol_file.

◆ GetSymbolFileSpecPtr() [1/2]

FileSpec * lldb_private::ModuleSpec::GetSymbolFileSpecPtr ( )

inline

Definition at line 74 of file ModuleSpec.h.

References m_symbol_file.

◆ GetSymbolFileSpecPtr() [2/2]

const FileSpec * lldb_private::ModuleSpec::GetSymbolFileSpecPtr ( ) const

inline

Definition at line 78 of file ModuleSpec.h.

References m_symbol_file.

◆ GetTargetSP()

lldb::TargetSP lldb_private::ModuleSpec::GetTargetSP ( ) const

inline

Definition at line 143 of file ModuleSpec.h.

References m_target_wp.

Referenced by lldb_private::Platform::GetRemoteSharedModule(), and lldb_private::ModuleList::GetSharedModule().

◆ GetUUID() [1/2]

UUID & lldb_private::ModuleSpec::GetUUID ( )

inline

Definition at line 104 of file ModuleSpec.h.

References m_uuid.

Referenced by lldb::SBTarget::AddModule(), CommandObjectTargetSymbolsAdd::AddModuleSymbols(), CommandObjectTargetSymbolsAdd::AddSymbolsForFile(), CommandObjectTargetSymbolsAdd::AddSymbolsForFrame(), CommandObjectTargetSymbolsAdd::AddSymbolsForStack(), CommandObjectTargetSymbolsAdd::AddSymbolsForUUID(), lldb_private::wasm::SymbolVendorWasm::CreateInstance(), SymbolVendorELF::CreateInstance(), SymbolVendorMacOSX::CreateInstance(), SymbolVendorPECOFF::CreateInstance(), ProcessKDP::DoConnectRemote(), CommandObjectTargetModulesAdd::DoExecute(), CommandObjectTargetModulesLoad::DoExecute(), lldb_private::SymbolLocator::DownloadSymbolFileAsync(), FileAtPathContainsArchAndUUID(), lldb_private::Process::FindModuleUUID(), ProcessElfCore::FindModuleUUID(), lldb_private::DynamicLoader::FindModuleViaTarget(), lldb_private::SymbolLocatorDebugSymbols::FindSymbolFileInBundle(), lldb_private::DynamicLoaderDarwin::FindTargetModuleForImageInfo(), lldb_private::ModuleCache::Get(), lldb_private::ModuleCache::GetAndPut(), lldb_private::Platform::GetCachedSharedModule(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwpSymbolFile(), GetFileForModule(), lldb_private::ScriptedProcess::GetLoadedDynamicLibrariesInfos(), lldb_private::PlatformDarwin::GetModuleFromSharedCaches(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetModuleInfo(), lldb_private::breakpad::ObjectFileBreakpad::GetModuleSpecifications(), lldb_private::ObjectFileJSON::GetModuleSpecifications(), lldb_private::ObjectFilePDB::GetModuleSpecifications(), ObjectFileELF::GetModuleSpecifications(), ObjectFilePECOFF::GetModuleSpecifications(), lldb_private::Target::GetOrCreateModule(), lldb_private::Platform::GetRemoteSharedModule(), lldb_private::PlatformDarwinDevice::GetSharedModuleWithLocalCache(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_jModulesInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qModuleInfo(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDefault::LocateExecutableSymbolFile(), lldb_private::SymbolLocatorSymStore::LocateExecutableSymbolFile(), LocateMacOSXFilesUsingDebugSymbols(), Matches(), lldb_private::Module::MatchesModuleSpec(), lldb_private::trace_intel_pt::TraceIntelPTBundleLoader::ParseModule(), ParseModuleSpec(), PrepareSearch(), lldb_private::ModuleCache::Put(), lldb_private::minidump::ProcessMinidump::ReadModuleList(), and lldb_private::Platform::ResolveExecutable().

◆ GetUUID() [2/2]

const UUID & lldb_private::ModuleSpec::GetUUID ( ) const

inline

Definition at line 106 of file ModuleSpec.h.

References m_uuid.

◆ GetUUIDPtr() [1/2]

UUID * lldb_private::ModuleSpec::GetUUIDPtr ( )

inline

Definition at line 98 of file ModuleSpec.h.

References m_uuid.

Referenced by CommandObjectTargetModulesLoad::DoExecute(), lldb_private::SymbolLocatorDebugSymbols::DownloadObjectAndSymbolFile(), FileAtPathContainsArchAndUUID(), lldb_private::SymbolLocatorDebugSymbols::FindSymbolFileInBundle(), lldb_private::ModuleList::GetSharedModule(), lldb_private::PlatformAppleSimulator::GetSharedModule(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDefault::LocateExecutableObjectFile(), lldb_private::SymbolLocatorDebugSymbols::LocateExecutableSymbolFile(), LocateMacOSXFilesUsingDebugSymbols(), LookForDsymNextToExecutablePath(), Matches(), and lldb_private::PlatformDarwin::ResolveSymbolFile().

◆ GetUUIDPtr() [2/2]

const UUID * lldb_private::ModuleSpec::GetUUIDPtr ( ) const

inline

Definition at line 100 of file ModuleSpec.h.

References m_uuid.

◆ Matches()

bool lldb_private::ModuleSpec::Matches	(	const ModuleSpec &	match_module_spec,
		bool	exact_arch_match ) const

inline

Definition at line 272 of file ModuleSpec.h.

References GetArchitecture(), GetArchitecturePtr(), GetFileSpec(), GetLoadAddress(), GetObjectName(), GetPlatformFileSpec(), GetSymbolFileSpec(), GetUUID(), GetUUIDPtr(), m_load_addr, lldb_private::FileSpec::Match(), and ModuleSpec().

◆ operator bool()

lldb_private::ModuleSpec::operator bool ( ) const

inlineexplicit

Definition at line 179 of file ModuleSpec.h.

References m_arch, m_file, m_load_addr, m_object_mod_time, m_object_name, m_object_size, m_platform_file, m_symbol_file, and m_uuid.

◆ SetLoadAddress()

void lldb_private::ModuleSpec::SetLoadAddress ( lldb::addr_t addr )

inline

Set the load address of a module in process memory.

Definition at line 127 of file ModuleSpec.h.

References m_load_addr.

Referenced by ProcessElfCore::GetMainExecutableModuleSpec(), DynamicLoaderPOSIXDYLD::LoadAllCurrentModules(), and lldb_private::DynamicLoader::LoadModuleAtAddress().

◆ SetObjectOffset()

void lldb_private::ModuleSpec::SetObjectOffset ( uint64_t object_offset )

inline

Definition at line 114 of file ModuleSpec.h.

References m_object_offset.

Referenced by lldb_private::DynamicLoaderDarwin::AddModulesUsingPreloadedModules(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetModuleInfo(), ObjectContainerBSDArchive::GetModuleSpecifications(), ObjectContainerClangOffloadBundle::GetModuleSpecifications(), ObjectFileELF::GetModuleSpecifications(), ObjectFileMachO::GetModuleSpecifications(), and ParseModuleSpec().

◆ SetObjectSize()

void lldb_private::ModuleSpec::SetObjectSize ( uint64_t object_size )

inline

Definition at line 120 of file ModuleSpec.h.

References m_object_size.

Referenced by lldb_private::DynamicLoaderDarwin::AddModulesUsingPreloadedModules(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetModuleInfo(), ObjectContainerBSDArchive::GetModuleSpecifications(), ObjectContainerClangOffloadBundle::GetModuleSpecifications(), ObjectFileELF::GetModuleSpecifications(), ObjectFileMachO::GetModuleSpecifications(), and ParseModuleSpec().

◆ SetPlatform()

void lldb_private::ModuleSpec::SetPlatform ( lldb::PlatformSP platform )

inline

Set the platform to be used when resolving a module.

This is useful when a Target is not yet available (e.g., during target creation) but a Platform is. The platform can be used to invoke locate module callbacks and other platform-specific module resolution logic.

Definition at line 160 of file ModuleSpec.h.

References m_platform_wp.

◆ SetTarget()

void lldb_private::ModuleSpec::SetTarget ( lldb::TargetSP target )

inline

Set the target to be used when resolving a module.

A target can help locate a module specified by a ModuleSpec. The target settings, like the executable and debug info search paths, can be essential. The target's platform can also be used to locate or download the specified module.

Definition at line 151 of file ModuleSpec.h.

References m_target_wp.

Referenced by ProcessElfCore::CanDebug(), ProcessMachCore::CanDebug(), lldb_private::Target::GetOrCreateModule(), lldb_private::Platform::GetRemoteSharedModule(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), PrepareSearch(), DynamicLoaderPOSIXDYLD::ResolveExecutableModule(), and lldb_private::Target::SetArchitecture().

Member Data Documentation

◆ m_arch

ArchSpec lldb_private::ModuleSpec::m_arch

protected

Definition at line 315 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetArchitecture(), GetArchitecture(), GetArchitecturePtr(), GetArchitecturePtr(), ModuleSpec(), and operator bool().

◆ m_extractor_sp

lldb::DataExtractorSP lldb_private::ModuleSpec::m_extractor_sp = {}

protected

Definition at line 330 of file ModuleSpec.h.

Referenced by Clear(), GetExtractor(), and ModuleSpec().

◆ m_file

FileSpec lldb_private::ModuleSpec::m_file

protected

Definition at line 312 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetFileSpec(), GetFileSpec(), GetFileSpecPtr(), GetFileSpecPtr(), ModuleSpec(), ModuleSpec(), and operator bool().

◆ m_load_addr

std::optional<lldb::addr_t> lldb_private::ModuleSpec::m_load_addr = std::nullopt

protected

The load address of the module in a process.

This allows for modules to be uniquely identified and created by reading an object file from memory when we can't locate the correct file on disk. Useful for post mortem debugging when we might not be able to locate symbols for the core file, but we can read the object file from memory.

Definition at line 336 of file ModuleSpec.h.

Referenced by Clear(), ClearLoadAddress(), Dump(), GetLoadAddress(), Matches(), operator bool(), and SetLoadAddress().

◆ m_object_mod_time

llvm::sys::TimePoint lldb_private::ModuleSpec::m_object_mod_time

protected

Definition at line 328 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetObjectModificationTime(), GetObjectModificationTime(), and operator bool().

◆ m_object_name

ConstString lldb_private::ModuleSpec::m_object_name

protected

Definition at line 317 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetObjectName(), GetObjectName(), and operator bool().

◆ m_object_offset

uint64_t lldb_private::ModuleSpec::m_object_offset = 0

protected

Definition at line 326 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetObjectOffset(), ModuleSpec(), ModuleSpec(), and SetObjectOffset().

◆ m_object_size

uint64_t lldb_private::ModuleSpec::m_object_size = 0

protected

Definition at line 327 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetObjectSize(), ModuleSpec(), ModuleSpec(), operator bool(), and SetObjectSize().

◆ m_platform_file

FileSpec lldb_private::ModuleSpec::m_platform_file

protected

Definition at line 313 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetPlatformFileSpec(), GetPlatformFileSpec(), GetPlatformFileSpecPtr(), GetPlatformFileSpecPtr(), and operator bool().

◆ m_platform_wp

std::weak_ptr<Platform> lldb_private::ModuleSpec::m_platform_wp

protected

The platform used when resolving a module.

This is useful when a Target is not yet available (e.g., during target creation) but a Platform is.

Definition at line 325 of file ModuleSpec.h.

Referenced by Clear(), GetPlatformSP(), and SetPlatform().

◆ m_source_mappings

PathMappingList lldb_private::ModuleSpec::m_source_mappings

mutableprotected

Definition at line 329 of file ModuleSpec.h.

Referenced by Clear(), and GetSourceMappingList().

◆ m_symbol_file

FileSpec lldb_private::ModuleSpec::m_symbol_file

protected

Definition at line 314 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetSymbolFileSpec(), GetSymbolFileSpec(), GetSymbolFileSpecPtr(), GetSymbolFileSpecPtr(), and operator bool().

◆ m_target_wp

std::weak_ptr<Target> lldb_private::ModuleSpec::m_target_wp

protected

The target used when resolving a module.

A target can help locate a module specified by a ModuleSpec. The target settings, like the executable and debug info search paths, can be essential. The target's platform can also be used to locate or download the specified module.

Definition at line 322 of file ModuleSpec.h.

Referenced by Clear(), GetTargetSP(), and SetTarget().

◆ m_uuid

UUID lldb_private::ModuleSpec::m_uuid

protected

Definition at line 316 of file ModuleSpec.h.

Referenced by Clear(), Dump(), GetUUID(), GetUUID(), GetUUIDPtr(), GetUUIDPtr(), ModuleSpec(), and operator bool().

The documentation for this class was generated from the following file:

ModuleSpec.h

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ModuleSpec() [1/3]

◆ ModuleSpec() [2/3]

◆ ModuleSpec() [3/3]

Member Function Documentation

◆ Clear()

◆ ClearLoadAddress()

◆ Dump()

◆ GetArchitecture() [1/2]

◆ GetArchitecture() [2/2]

◆ GetArchitecturePtr() [1/2]

◆ GetArchitecturePtr() [2/2]

◆ GetExtractor()

◆ GetFileSpec() [1/2]

◆ GetFileSpec() [2/2]

◆ GetFileSpecPtr() [1/2]

◆ GetFileSpecPtr() [2/2]

◆ GetLoadAddress()

◆ GetObjectModificationTime() [1/2]

◆ GetObjectModificationTime() [2/2]

◆ GetObjectName() [1/2]

◆ GetObjectName() [2/2]

◆ GetObjectOffset()

◆ GetObjectSize()

◆ GetPlatformFileSpec() [1/2]

◆ GetPlatformFileSpec() [2/2]

◆ GetPlatformFileSpecPtr() [1/2]

◆ GetPlatformFileSpecPtr() [2/2]

◆ GetPlatformSP()

◆ GetSourceMappingList()

◆ GetSymbolFileSpec() [1/2]

◆ GetSymbolFileSpec() [2/2]

◆ GetSymbolFileSpecPtr() [1/2]

◆ GetSymbolFileSpecPtr() [2/2]

◆ GetTargetSP()

◆ GetUUID() [1/2]

◆ GetUUID() [2/2]

◆ GetUUIDPtr() [1/2]

◆ GetUUIDPtr() [2/2]

◆ Matches()

◆ operator bool()

◆ SetLoadAddress()

◆ SetObjectOffset()

◆ SetObjectSize()

◆ SetPlatform()

◆ SetTarget()

Member Data Documentation

◆ m_arch

◆ m_extractor_sp

◆ m_file

◆ m_load_addr

◆ m_object_mod_time

◆ m_object_name

◆ m_object_offset

◆ m_object_size

◆ m_platform_file

◆ m_platform_wp

◆ m_source_mappings

◆ m_symbol_file

◆ m_target_wp

◆ m_uuid