#include <DynamicLoaderPOSIXDYLD.h>

Inheritance diagram for DynamicLoaderPOSIXDYLD:

Public Member Functions
	DynamicLoaderPOSIXDYLD (lldb_private::Process *process)

	~DynamicLoaderPOSIXDYLD () override

void	DidAttach () override
	Called after attaching a process.

void	DidLaunch () override
	Called after launching a process.

lldb::ThreadPlanSP	GetStepThroughTrampolinePlan (lldb_private::Thread &thread, bool stop_others) override
	Provides a plan to step through the dynamic loader trampoline for the current state of thread.

lldb_private::Status	CanLoadImage () override
	Ask if it is ok to try and load or unload an shared library (image).

lldb::addr_t	GetThreadLocalData (const lldb::ModuleSP module, const lldb::ThreadSP thread, lldb::addr_t tls_file_addr) override
	Retrieves the per-module TLS block for a given thread.

llvm::StringRef	GetPluginName () override

lldb::ModuleSP	LoadModuleAtAddress (const lldb_private::FileSpec &file, lldb::addr_t link_map_addr, lldb::addr_t base_addr, bool base_addr_is_offset) override
	Locates or creates a module given by `file` and updates/loads the resulting module at the virtual base address `base_addr`.

void	CalculateDynamicSaveCoreRanges (lldb_private::Process &process, std::vector< lldb_private::MemoryRegionInfo > &ranges, llvm::function_ref< bool(const lldb_private::Thread &)> save_thread_predicate) override

Public Member Functions inherited from lldb_private::DynamicLoader
	DynamicLoader (Process *process)
	Construct with a process.

virtual void	DidAttach ()=0
	Called after attaching a process.

virtual void	DidLaunch ()=0
	Called after launching a process.

virtual bool	ProcessDidExec ()
	Helper function that can be used to detect when a process has called exec and is now a new and different process.

bool	GetStopWhenImagesChange () const
	Get whether the process should stop when images change.

void	SetStopWhenImagesChange (bool stop)
	Set whether the process should stop when images change.

virtual lldb::ThreadPlanSP	GetStepThroughTrampolinePlan (Thread &thread, bool stop_others)=0
	Provides a plan to step through the dynamic loader trampoline for the current state of thread.

virtual void	FindEquivalentSymbols (Symbol *original_symbol, ModuleList &module_list, SymbolContextList &equivalent_symbols)
	Some dynamic loaders provide features where there are a group of symbols "equivalent to" a given symbol one of which will be chosen when the symbol is bound.

virtual Status	CanLoadImage ()=0
	Ask if it is ok to try and load or unload an shared library (image).

virtual bool	AlwaysRelyOnEHUnwindInfo (SymbolContext &sym_ctx)
	Ask if the eh_frame information for the given SymbolContext should be relied on even when it's the first frame in a stack unwind.

virtual lldb::addr_t	GetThreadLocalData (const lldb::ModuleSP module, const lldb::ThreadSP thread, lldb::addr_t tls_file_addr)
	Retrieves the per-module TLS block for a given thread.

virtual lldb::ModuleSP	LoadModuleAtAddress (const lldb_private::FileSpec &file, lldb::addr_t link_map_addr, lldb::addr_t base_addr, bool base_addr_is_offset)
	Locates or creates a module given by `file` and updates/loads the resulting module at the virtual base address `base_addr`.

virtual bool	GetSharedCacheInformation (lldb::addr_t &base_address, UUID &uuid, LazyBool &using_shared_cache, LazyBool &private_shared_cache)
	Get information about the shared cache for a process, if possible.

virtual bool	IsFullyInitialized ()
	Return whether the dynamic loader is fully initialized and it's safe to call its APIs.

virtual std::optional< lldb_private::Address >	GetStartAddress ()
	Return the `start` address in the dynamic loader module.

virtual void	CalculateDynamicSaveCoreRanges (lldb_private::Process &process, std::vector< lldb_private::MemoryRegionInfo > &ranges, llvm::function_ref< bool(const lldb_private::Thread &)> save_thread_predicate)
	Returns a list of memory ranges that should be saved in the core file, specific for this dynamic loader.

Public Member Functions inherited from lldb_private::PluginInterface
	PluginInterface ()=default

virtual	~PluginInterface ()=default

virtual llvm::StringRef	GetPluginName ()=0

	PluginInterface (const PluginInterface &)=delete

PluginInterface &	operator= (const PluginInterface &)=delete

Static Public Member Functions
static void	Initialize ()

static void	Terminate ()

static llvm::StringRef	GetPluginNameStatic ()

static llvm::StringRef	GetPluginDescriptionStatic ()

static lldb_private::DynamicLoader *	CreateInstance (lldb_private::Process *process, bool force)

Static Public Member Functions inherited from lldb_private::DynamicLoader
static DynamicLoader *	FindPlugin (Process *process, llvm::StringRef plugin_name)
	Find a dynamic loader plugin for a given process.

static lldb::ModuleSP	LoadBinaryWithUUIDAndAddress (Process *process, llvm::StringRef name, UUID uuid, lldb::addr_t value, bool value_is_offset, bool force_symbol_search, bool notify, bool set_address_in_target, bool allow_memory_image_last_resort)
	Find/load a binary into lldb given a UUID and the address where it is loaded in memory, or a slide to be applied to the file address.

Protected Member Functions
bool	IsCoreFile () const
	Returns true if the process is for a core file.

bool	SetRendezvousBreakpoint ()
	If possible sets a breakpoint on a function called by the runtime linker each time a module is loaded or unloaded.

void	RefreshModules ()
	Helper method for RendezvousBreakpointHit.

void	UpdateLoadedSections (lldb::ModuleSP module, lldb::addr_t link_map_addr, lldb::addr_t base_addr, bool base_addr_is_offset) override
	Updates the load address of every allocatable section in `module`.

void	UnloadSections (const lldb::ModuleSP module) override
	Removes the loaded sections from the target in `module`.

void	ProbeEntry ()
	Resolves the entry point for the current inferior process and sets a breakpoint at that address.

virtual void	LoadAllCurrentModules ()
	Helper for the entry breakpoint callback.

void	LoadVDSO ()

lldb::ModuleSP	LoadInterpreterModule ()

lldb::addr_t	ComputeLoadOffset ()
	Computes a value for m_load_offset returning the computed address on success and LLDB_INVALID_ADDRESS on failure.

lldb::addr_t	GetEntryPoint ()
	Computes a value for m_entry_point returning the computed address on success and LLDB_INVALID_ADDRESS on failure.

void	EvalSpecialModulesStatus ()
	Evaluate if Aux vectors contain vDSO and LD information in case they do, read and assign the address to m_vdso_base and m_interpreter_base.

void	ResolveExecutableModule (lldb::ModuleSP &module_sp)
	Loads Module from inferior process.

bool	AlwaysRelyOnEHUnwindInfo (lldb_private::SymbolContext &sym_ctx) override
	Ask if the eh_frame information for the given SymbolContext should be relied on even when it's the first frame in a stack unwind.

Protected Member Functions inherited from lldb_private::DynamicLoader
lldb::ModuleSP	FindModuleViaTarget (const FileSpec &file)

lldb::ModuleSP	GetTargetExecutable ()
	Checks to see if the target module has changed, updates the target accordingly and returns the target executable module.

virtual void	UpdateLoadedSections (lldb::ModuleSP module, lldb::addr_t link_map_addr, lldb::addr_t base_addr, bool base_addr_is_offset)
	Updates the load address of every allocatable section in `module`.

void	UpdateLoadedSectionsCommon (lldb::ModuleSP module, lldb::addr_t base_addr, bool base_addr_is_offset)

virtual void	UnloadSections (const lldb::ModuleSP module)
	Removes the loaded sections from the target in `module`.

void	UnloadSectionsCommon (const lldb::ModuleSP module)

const lldb_private::SectionList *	GetSectionListFromModule (const lldb::ModuleSP module) const

int64_t	ReadUnsignedIntWithSizeInBytes (lldb::addr_t addr, int size_in_bytes)

lldb::addr_t	ReadPointer (lldb::addr_t addr)

void	LoadOperatingSystemPlugin (bool flush)

Static Protected Member Functions
static bool	RendezvousBreakpointHit (void baton, lldb_private::StoppointCallbackContext context, lldb::user_id_t break_id, lldb::user_id_t break_loc_id)
	Callback routine which updates the current list of loaded modules based on the information supplied by the runtime linker.

static bool	EntryBreakpointHit (void baton, lldb_private::StoppointCallbackContext context, lldb::user_id_t break_id, lldb::user_id_t break_loc_id)
	Callback routine invoked when we hit the breakpoint on process entry.

Protected Attributes
DYLDRendezvous	m_rendezvous
	Runtime linker rendezvous structure.

lldb::addr_t	m_load_offset
	Virtual load address of the inferior process.

lldb::addr_t	m_entry_point
	Virtual entry address of the inferior process.

std::unique_ptr< AuxVector >	m_auxv
	Auxiliary vector of the inferior process.

lldb::break_id_t	m_dyld_bid
	Rendezvous breakpoint.

lldb::addr_t	m_vdso_base
	Contains AT_SYSINFO_EHDR, which means a vDSO has been mapped to the address space.

lldb::addr_t	m_interpreter_base
	Contains AT_BASE, which means a dynamic loader has been mapped to the address space.

std::weak_ptr< lldb_private::Module >	m_interpreter_module
	Contains the pointer to the interpret module, if loaded.

std::map< lldb::ModuleWP, lldb::addr_t, std::owner_less< lldb::ModuleWP > >	m_loaded_modules
	Loaded module list. (link map for each module)

bool	m_initial_modules_added
	Indicates whether the initial set of modules was reported added.

Protected Attributes inherited from lldb_private::DynamicLoader
Process *	m_process
	The process that this dynamic loader plug-in is tracking.

Private Member Functions
	DynamicLoaderPOSIXDYLD (const DynamicLoaderPOSIXDYLD &)=delete

const DynamicLoaderPOSIXDYLD &	operator= (const DynamicLoaderPOSIXDYLD &)=delete

Detailed Description

Definition at line 23 of file DynamicLoaderPOSIXDYLD.h.

Constructor & Destructor Documentation

◆ DynamicLoaderPOSIXDYLD() [1/2]

DynamicLoaderPOSIXDYLD::DynamicLoaderPOSIXDYLD ( lldb_private::Process * process )

Definition at line 67 of file DynamicLoaderPOSIXDYLD.cpp.

◆ ~DynamicLoaderPOSIXDYLD()

DynamicLoaderPOSIXDYLD::~DynamicLoaderPOSIXDYLD ( )

override

Definition at line 75 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Process::GetTarget(), LLDB_INVALID_BREAK_ID, m_dyld_bid, lldb_private::DynamicLoader::m_process, and lldb_private::Target::RemoveBreakpointByID().

◆ DynamicLoaderPOSIXDYLD() [2/2]

DynamicLoaderPOSIXDYLD::DynamicLoaderPOSIXDYLD ( const DynamicLoaderPOSIXDYLD & )

privatedelete

Member Function Documentation

◆ AlwaysRelyOnEHUnwindInfo()

bool DynamicLoaderPOSIXDYLD::AlwaysRelyOnEHUnwindInfo ( lldb_private::SymbolContext & sym_ctx )

overrideprotectedvirtual

Ask if the eh_frame information for the given SymbolContext should be relied on even when it's the first frame in a stack unwind.

The CFI instructions from the eh_frame section are normally only valid at call sites – places where a program could throw an exception and need to unwind out. But some Modules may be known to the system as having reliable eh_frame information at all call sites. This would be the case if the Module's contents are largely hand-written assembly with hand-written eh_frame information. Normally when unwinding from a function at the beginning of a stack unwind lldb will examine the assembly instructions to understand how the stack frame is set up and where saved registers are stored. But with hand-written assembly this is not reliable enough – we need to consult those function's hand-written eh_frame information.

Returns: True if the symbol context should use eh_frame instructions unconditionally when unwinding from this frame. Else false, the normal lldb unwind behavior of only using eh_frame when the function appears in the middle of the stack.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 853 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::SymbolContext::function, lldb_private::Function::GetAddressRange(), lldb_private::Symbol::GetAddressRef(), lldb_private::AddressRange::GetBaseAddress(), lldb_private::Address::GetModule(), and lldb_private::SymbolContext::symbol.

◆ CalculateDynamicSaveCoreRanges()

void DynamicLoaderPOSIXDYLD::CalculateDynamicSaveCoreRanges	(	lldb_private::Process &	process,
		std::vector< lldb_private::MemoryRegionInfo > &	ranges,
		llvm::function_ref< bool(const lldb_private::Thread &)>	save_thread_predicate
	)

override

Definition at line 930 of file DynamicLoaderPOSIXDYLD.cpp.

References AddLinkMapSections(), AddThreadLocalMemoryRegions(), lldb_private::ThreadList::GetSize(), lldb_private::ThreadList::GetThreadAtIndex(), and lldb_private::Process::GetThreadList().

◆ CanLoadImage()

Status DynamicLoaderPOSIXDYLD::CanLoadImage ( )

overridevirtual

Ask if it is ok to try and load or unload an shared library (image).

The dynamic loader often knows when it would be ok to try and load or unload a shared library. This function call allows the dynamic loader plug-ins to check any current dyld state to make sure it is an ok time to load a shared library.

Returns: true if it is currently ok to try and load a shared library into the process, false otherwise.

Implements lldb_private::DynamicLoader.

Definition at line 185 of file DynamicLoaderPOSIXDYLD.cpp.

◆ ComputeLoadOffset()

addr_t DynamicLoaderPOSIXDYLD::ComputeLoadOffset ( )

protected

Computes a value for m_load_offset returning the computed address on success and LLDB_INVALID_ADDRESS on failure.

Definition at line 669 of file DynamicLoaderPOSIXDYLD.cpp.

References GetEntryPoint(), lldb_private::ObjectFile::GetEntryPointAddress(), lldb_private::Target::GetExecutableModule(), lldb_private::Address::GetFileAddress(), lldb_private::Process::GetTarget(), lldb_private::Address::IsValid(), LLDB_INVALID_ADDRESS, m_load_offset, and lldb_private::DynamicLoader::m_process.

Referenced by DidAttach(), and DidLaunch().

◆ CreateInstance()

DynamicLoader * DynamicLoaderPOSIXDYLD::CreateInstance	(	lldb_private::Process *	process,
		bool	force
	)

static

Definition at line 49 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Target::GetArchitecture(), lldb_private::Process::GetTarget(), and lldb_private::ArchSpec::GetTriple().

◆ DidAttach()

void DynamicLoaderPOSIXDYLD::DidAttach ( )

overridevirtual

Called after attaching a process.

Allow DynamicLoader plug-ins to execute some code after attaching to a process.

Implements lldb_private::DynamicLoader.

Definition at line 82 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::ModuleList::Append(), ComputeLoadOffset(), EvalSpecialModulesStatus(), lldb_private::Process::GetAuxvData(), lldb_private::Process::GetID(), lldb_private::GetLog(), lldb_private::Process::GetTarget(), lldb_private::DynamicLoader::GetTargetExecutable(), LLDB_INVALID_ADDRESS, LLDB_INVALID_PROCESS_ID, LLDB_LOGF, LoadAllCurrentModules(), m_auxv, lldb_private::DynamicLoader::m_process, m_rendezvous, lldb_private::ModuleList::Modules(), lldb_private::Target::ModulesDidLoad(), ProbeEntry(), ResolveExecutableModule(), SetRendezvousBreakpoint(), DYLDRendezvous::UpdateExecutablePath(), and UpdateLoadedSections().

◆ DidLaunch()

void DynamicLoaderPOSIXDYLD::DidLaunch ( )

overridevirtual

Called after launching a process.

Allow DynamicLoader plug-ins to execute some code after the process has stopped for the first time on launch.

Implements lldb_private::DynamicLoader.

Definition at line 153 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::ModuleList::Append(), ComputeLoadOffset(), EvalSpecialModulesStatus(), lldb_private::Process::GetAuxvData(), lldb_private::GetLog(), lldb_private::Process::GetTarget(), lldb_private::DynamicLoader::GetTargetExecutable(), LLDB_INVALID_ADDRESS, LLDB_LOGF, LoadVDSO(), m_auxv, lldb_private::DynamicLoader::m_process, lldb_private::Target::ModulesDidLoad(), ProbeEntry(), SetRendezvousBreakpoint(), and UpdateLoadedSections().

◆ EntryBreakpointHit()

bool DynamicLoaderPOSIXDYLD::EntryBreakpointHit	(	void *	baton,
		lldb_private::StoppointCallbackContext *	context,
		lldb::user_id_t	break_id,
		lldb::user_id_t	break_loc_id
	)

staticprotected

Callback routine invoked when we hit the breakpoint on process entry.

This routine is responsible for resolving the load addresses of all dependent modules required by the inferior and setting up the rendezvous breakpoint.

Definition at line 242 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Target::GetBreakpointByID(), lldb_private::Process::GetID(), lldb_private::GetLog(), lldb_private::Process::GetTarget(), LLDB_INVALID_PROCESS_ID, LLDB_LOGF, LoadAllCurrentModules(), lldb_private::DynamicLoader::m_process, and SetRendezvousBreakpoint().

Referenced by ProbeEntry().

◆ EvalSpecialModulesStatus()

void DynamicLoaderPOSIXDYLD::EvalSpecialModulesStatus ( )

protected

Evaluate if Aux vectors contain vDSO and LD information in case they do, read and assign the address to m_vdso_base and m_interpreter_base.

Definition at line 695 of file DynamicLoaderPOSIXDYLD.cpp.

References AuxVector::AUXV_AT_BASE, AuxVector::AUXV_AT_SYSINFO_EHDR, m_auxv, m_interpreter_base, and m_vdso_base.

Referenced by DidAttach(), and DidLaunch().

◆ GetEntryPoint()

addr_t DynamicLoaderPOSIXDYLD::GetEntryPoint ( )

protected

Computes a value for m_entry_point returning the computed address on success and LLDB_INVALID_ADDRESS on failure.

Definition at line 705 of file DynamicLoaderPOSIXDYLD.cpp.

References AuxVector::AUXV_AT_ENTRY, lldb_private::Target::GetArchitecture(), lldb_private::ArchSpec::GetMachine(), lldb_private::Process::GetTarget(), LLDB_INVALID_ADDRESS, m_auxv, m_entry_point, lldb_private::DynamicLoader::m_process, and lldb_private::DynamicLoader::ReadUnsignedIntWithSizeInBytes().

Referenced by ComputeLoadOffset(), and ProbeEntry().

◆ GetPluginDescriptionStatic()

llvm::StringRef DynamicLoaderPOSIXDYLD::GetPluginDescriptionStatic ( )

static

Definition at line 44 of file DynamicLoaderPOSIXDYLD.cpp.

◆ GetPluginName()

llvm::StringRef DynamicLoaderPOSIXDYLD::GetPluginName ( )

inlineoverridevirtual

Implements lldb_private::PluginInterface.

Definition at line 56 of file DynamicLoaderPOSIXDYLD.h.

References GetPluginNameStatic().

◆ GetPluginNameStatic()

static llvm::StringRef DynamicLoaderPOSIXDYLD::GetPluginNameStatic ( )

inlinestatic

Definition at line 33 of file DynamicLoaderPOSIXDYLD.h.

Referenced by ProcessElfCore::GetDynamicLoader(), and GetPluginName().

◆ GetStepThroughTrampolinePlan()

ThreadPlanSP DynamicLoaderPOSIXDYLD::GetStepThroughTrampolinePlan	(	lldb_private::Thread &	thread,
		bool	stop_others
	)

overridevirtual

Provides a plan to step through the dynamic loader trampoline for the current state of thread.

Parameters

[in] stop_others Whether the plan should be set to stop other threads.

Returns: A pointer to the plan (caller owned) or NULL if we are not at such a trampoline.

Implements lldb_private::DynamicLoader.

Definition at line 476 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Mangled::ePreferMangled, lldb::eSymbolTypeCode, lldb_private::ModuleList::FindSymbolsWithNameAndType(), lldb_private::SymbolContext::GetAddressRange(), lldb_private::AddressRange::GetBaseAddress(), lldb_private::Target::GetImages(), lldb_private::Address::GetLoadAddress(), lldb_private::Symbol::GetMangled(), lldb_private::Mangled::GetName(), lldb_private::Thread::GetProcess(), lldb_private::SymbolContextList::GetSize(), lldb_private::Thread::GetStackFrameAtIndex(), lldb_private::ConstString::GetStringRef(), lldb_private::StackFrame::GetSymbolContext(), lldb_private::Symbol::IsTrampoline(), LLDB_INVALID_ADDRESS, and lldb_private::SymbolContext::symbol.

◆ GetThreadLocalData()

lldb::addr_t DynamicLoaderPOSIXDYLD::GetThreadLocalData	(	const lldb::ModuleSP	module,
		const lldb::ThreadSP	thread,
		lldb::addr_t	tls_file_addr
	)

overridevirtual

Retrieves the per-module TLS block for a given thread.

Parameters

[in]	module	The module to query TLS data for.
[in]	thread	The specific thread to query TLS data for.

Returns: If the given thread has TLS data allocated for the module, the address of the TLS block. Otherwise LLDB_INVALID_ADDRESS is returned.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 729 of file DynamicLoaderPOSIXDYLD.cpp.

References DYLDRendezvous::ThreadInfo::dtv_offset, DYLDRendezvous::ThreadInfo::dtv_slot_size, lldb_private::GetLog(), DYLDRendezvous::GetThreadInfo(), LLDB_INVALID_ADDRESS, LLDB_LOGF, m_loaded_modules, m_rendezvous, DYLDRendezvous::ThreadInfo::modid_offset, lldb_private::DynamicLoader::ReadPointer(), lldb_private::DynamicLoader::ReadUnsignedIntWithSizeInBytes(), DYLDRendezvous::ThreadInfo::tls_offset, and DYLDRendezvous::ThreadInfo::valid.

◆ Initialize()

void DynamicLoaderPOSIXDYLD::Initialize ( )

static

Definition at line 37 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::PluginManager::RegisterPlugin().

◆ IsCoreFile()

bool DynamicLoaderPOSIXDYLD::IsCoreFile ( ) const

protected

Returns true if the process is for a core file.

Definition at line 867 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Process::IsLiveDebugSession(), and lldb_private::DynamicLoader::m_process.

Referenced by ProbeEntry(), and SetRendezvousBreakpoint().

◆ LoadAllCurrentModules()

void DynamicLoaderPOSIXDYLD::LoadAllCurrentModules ( )

protectedvirtual

Helper for the entry breakpoint callback.

Resolves the load addresses of all dependent modules.

Definition at line 622 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::ModuleList::Append(), DYLDRendezvous::begin(), DYLDRendezvous::end(), lldb_private::Target::GetArchitecture(), DYLDRendezvous::GetLinkMapAddress(), lldb_private::GetLog(), lldb_private::Process::GetTarget(), lldb_private::DynamicLoader::GetTargetExecutable(), lldb_private::ArchSpec::GetTriple(), LLDB_LOG, LLDB_LOGF, LoadModuleAtAddress(), LoadVDSO(), m_initial_modules_added, m_loaded_modules, lldb_private::DynamicLoader::m_process, m_rendezvous, lldb_private::Target::ModulesDidLoad(), lldb_private::Process::PrefetchModuleSpecs(), and DYLDRendezvous::Resolve().

Referenced by DidAttach(), and EntryBreakpointHit().

◆ LoadInterpreterModule()

ModuleSP DynamicLoaderPOSIXDYLD::LoadInterpreterModule ( )

protected

◆ LoadModuleAtAddress()

ModuleSP DynamicLoaderPOSIXDYLD::LoadModuleAtAddress	(	const lldb_private::FileSpec &	file,
		lldb::addr_t	link_map_addr,
		lldb::addr_t	base_addr,
		bool	base_addr_is_offset
	)

overridevirtual

Locates or creates a module given by file and updates/loads the resulting module at the virtual base address base_addr.

Note that this calls Target::GetOrCreateModule with notify being false, so it is necessary to call Target::ModulesDidLoad afterwards.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 590 of file DynamicLoaderPOSIXDYLD.cpp.

References error(), lldb_private::Target::GetArchitecture(), lldb_private::MemoryRegionInfo::GetMapped(), lldb_private::Process::GetMemoryRegionInfo(), lldb_private::MemoryRegionInfo::GetName(), lldb_private::MemoryRegionInfo::GetRange(), lldb_private::Range< B, S >::GetRangeBase(), lldb_private::ConstString::GetStringRef(), lldb_private::Process::GetTarget(), lldb_private::ArchSpec::GetTriple(), lldb_private::ConstString::IsEmpty(), lldb_private::DynamicLoader::LoadModuleAtAddress(), and lldb_private::DynamicLoader::m_process.

Referenced by LoadAllCurrentModules(), and RefreshModules().

◆ LoadVDSO()

void DynamicLoaderPOSIXDYLD::LoadVDSO ( )

protected

Definition at line 535 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::ModuleList::AppendIfNeeded(), lldb_private::Status::Fail(), lldb_private::Range< B, S >::GetByteSize(), lldb_private::Target::GetImages(), lldb_private::GetLog(), lldb_private::Process::GetMemoryRegionInfo(), lldb_private::MemoryRegionInfo::GetRange(), lldb_private::Process::GetTarget(), LLDB_INVALID_ADDRESS, LLDB_LOG, lldb_private::DynamicLoader::m_process, m_vdso_base, lldb_private::Process::ReadModuleFromMemory(), and UpdateLoadedSections().

Referenced by DidLaunch(), and LoadAllCurrentModules().

◆ operator=()

const DynamicLoaderPOSIXDYLD & DynamicLoaderPOSIXDYLD::operator= ( const DynamicLoaderPOSIXDYLD & )

privatedelete

◆ ProbeEntry()

void DynamicLoaderPOSIXDYLD::ProbeEntry ( )

protected

Resolves the entry point for the current inferior process and sets a breakpoint at that address.

Definition at line 201 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Target::CreateBreakpoint(), EntryBreakpointHit(), GetEntryPoint(), lldb_private::Process::GetID(), lldb_private::GetLog(), lldb_private::Process::GetTarget(), IsCoreFile(), LLDB_INVALID_ADDRESS, LLDB_INVALID_PROCESS_ID, LLDB_LOGF, lldb_private::DynamicLoader::m_process, lldb_private::Breakpoint::SetBreakpointKind(), lldb_private::Breakpoint::SetCallback(), and lldb_private::Breakpoint::SetOneShot().

Referenced by DidAttach(), and DidLaunch().

◆ RefreshModules()

void DynamicLoaderPOSIXDYLD::RefreshModules ( )

protected

Helper method for RendezvousBreakpointHit.

Updates LLDB's current set of loaded modules.

Definition at line 397 of file DynamicLoaderPOSIXDYLD.cpp.

Referenced by RendezvousBreakpointHit().

◆ RendezvousBreakpointHit()

bool DynamicLoaderPOSIXDYLD::RendezvousBreakpointHit	(	void *	baton,
		lldb_private::StoppointCallbackContext *	context,
		lldb::user_id_t	break_id,
		lldb::user_id_t	break_loc_id
	)

staticprotected

Callback routine which updates the current list of loaded modules based on the information supplied by the runtime linker.

Definition at line 368 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::Process::GetID(), lldb_private::GetLog(), lldb_private::DynamicLoader::GetStopWhenImagesChange(), LLDB_INVALID_PROCESS_ID, LLDB_LOGF, lldb_private::DynamicLoader::m_process, and RefreshModules().

Referenced by SetRendezvousBreakpoint().

◆ ResolveExecutableModule()

void DynamicLoaderPOSIXDYLD::ResolveExecutableModule ( lldb::ModuleSP & module_sp )

protected

Loads Module from inferior process.

Definition at line 806 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::ModuleSpec::Dump(), lldb_private::eLoadDependentsNo, error(), lldb_private::ProcessInfo::GetArchitecture(), lldb_private::StreamString::GetData(), lldb_private::Target::GetDefaultExecutableSearchPaths(), lldb_private::ProcessInfo::GetExecutableFile(), lldb_private::Process::GetID(), lldb_private::GetLog(), lldb_private::FileSpec::GetPath(), lldb_private::Target::GetPlatform(), lldb_private::Process::GetProcessInfo(), lldb_private::Process::GetTarget(), LLDB_LOGF, and lldb_private::DynamicLoader::m_process.

Referenced by DidAttach().

◆ SetRendezvousBreakpoint()

bool DynamicLoaderPOSIXDYLD::SetRendezvousBreakpoint ( )

protected

If possible sets a breakpoint on a function called by the runtime linker each time a module is loaded or unloaded.

Definition at line 290 of file DynamicLoaderPOSIXDYLD.cpp.

References lldb_private::FileSpecList::Append(), lldb_private::Target::CreateBreakpoint(), lldb::eLanguageTypeC, lldb_private::eLazyBoolNo, DYLDRendezvous::GetBreakAddress(), lldb_private::Target::GetExecutableModulePointer(), lldb_private::Module::GetFileSpec(), lldb_private::Process::GetID(), lldb_private::GetLog(), lldb_private::Process::GetTarget(), IsCoreFile(), DYLDRendezvous::IsValid(), LLDB_INVALID_BREAK_ID, LLDB_INVALID_PROCESS_ID, LLDB_LOG, LoadInterpreterModule(), m_dyld_bid, lldb_private::DynamicLoader::m_process, m_rendezvous, lldb_private::Target::RemoveBreakpointByID(), and RendezvousBreakpointHit().

Referenced by DidAttach(), DidLaunch(), and EntryBreakpointHit().

◆ Terminate()

void DynamicLoaderPOSIXDYLD::Terminate ( )

static

Definition at line 42 of file DynamicLoaderPOSIXDYLD.cpp.

◆ UnloadSections()

void DynamicLoaderPOSIXDYLD::UnloadSections ( const lldb::ModuleSP module )

overrideprotectedvirtual

Removes the loaded sections from the target in module.

Parameters

module The module to traverse.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 195 of file DynamicLoaderPOSIXDYLD.cpp.

References m_loaded_modules, and lldb_private::DynamicLoader::UnloadSectionsCommon().

Referenced by RefreshModules().

◆ UpdateLoadedSections()

void DynamicLoaderPOSIXDYLD::UpdateLoadedSections	(	lldb::ModuleSP	module,
		lldb::addr_t	link_map_addr,
		lldb::addr_t	base_addr,
		bool	base_addr_is_offset
	)

overrideprotectedvirtual

Updates the load address of every allocatable section in module.

Parameters

module	The module to traverse.
link_map_addr	The virtual address of the link map for the `module`.
base_addr	The virtual base address `module` is loaded at.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 187 of file DynamicLoaderPOSIXDYLD.cpp.

References m_loaded_modules, and lldb_private::DynamicLoader::UpdateLoadedSectionsCommon().

Referenced by DidAttach(), DidLaunch(), LoadInterpreterModule(), and LoadVDSO().

Member Data Documentation

◆ m_auxv

std::unique_ptr<AuxVector> DynamicLoaderPOSIXDYLD::m_auxv

protected

Auxiliary vector of the inferior process.

Definition at line 80 of file DynamicLoaderPOSIXDYLD.h.

Referenced by DidAttach(), DidLaunch(), EvalSpecialModulesStatus(), and GetEntryPoint().

◆ m_dyld_bid

lldb::break_id_t DynamicLoaderPOSIXDYLD::m_dyld_bid

protected

Rendezvous breakpoint.

Definition at line 83 of file DynamicLoaderPOSIXDYLD.h.

Referenced by SetRendezvousBreakpoint(), and ~DynamicLoaderPOSIXDYLD().

◆ m_entry_point

lldb::addr_t DynamicLoaderPOSIXDYLD::m_entry_point

protected

Virtual entry address of the inferior process.

Definition at line 77 of file DynamicLoaderPOSIXDYLD.h.

Referenced by GetEntryPoint().

◆ m_initial_modules_added

bool DynamicLoaderPOSIXDYLD::m_initial_modules_added

protected

Indicates whether the initial set of modules was reported added.

Definition at line 114 of file DynamicLoaderPOSIXDYLD.h.

Referenced by LoadAllCurrentModules(), and RefreshModules().

◆ m_interpreter_base

lldb::addr_t DynamicLoaderPOSIXDYLD::m_interpreter_base

protected

Contains AT_BASE, which means a dynamic loader has been mapped to the address space.

Definition at line 91 of file DynamicLoaderPOSIXDYLD.h.

Referenced by EvalSpecialModulesStatus(), LoadInterpreterModule(), and RefreshModules().

◆ m_interpreter_module

std::weak_ptr<lldb_private::Module> DynamicLoaderPOSIXDYLD::m_interpreter_module

protected

Contains the pointer to the interpret module, if loaded.

Definition at line 94 of file DynamicLoaderPOSIXDYLD.h.

Referenced by LoadInterpreterModule(), and RefreshModules().

◆ m_load_offset

lldb::addr_t DynamicLoaderPOSIXDYLD::m_load_offset

protected

Virtual load address of the inferior process.

Definition at line 74 of file DynamicLoaderPOSIXDYLD.h.

Referenced by ComputeLoadOffset().

◆ m_loaded_modules

std::map<lldb::ModuleWP, lldb::addr_t, std::owner_less<lldb::ModuleWP> > DynamicLoaderPOSIXDYLD::m_loaded_modules

protected

Loaded module list. (link map for each module)

Definition at line 98 of file DynamicLoaderPOSIXDYLD.h.

Referenced by GetThreadLocalData(), LoadAllCurrentModules(), RefreshModules(), UnloadSections(), and UpdateLoadedSections().

◆ m_rendezvous

DYLDRendezvous DynamicLoaderPOSIXDYLD::m_rendezvous

protected

Runtime linker rendezvous structure.

Definition at line 71 of file DynamicLoaderPOSIXDYLD.h.

Referenced by DidAttach(), GetThreadLocalData(), LoadAllCurrentModules(), RefreshModules(), and SetRendezvousBreakpoint().

◆ m_vdso_base

lldb::addr_t DynamicLoaderPOSIXDYLD::m_vdso_base

protected

Contains AT_SYSINFO_EHDR, which means a vDSO has been mapped to the address space.

Definition at line 87 of file DynamicLoaderPOSIXDYLD.h.

Referenced by EvalSpecialModulesStatus(), and LoadVDSO().

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ DynamicLoaderPOSIXDYLD() [1/2]

◆ ~DynamicLoaderPOSIXDYLD()

◆ DynamicLoaderPOSIXDYLD() [2/2]

Member Function Documentation

◆ AlwaysRelyOnEHUnwindInfo()

◆ CalculateDynamicSaveCoreRanges()

◆ CanLoadImage()

◆ ComputeLoadOffset()

◆ CreateInstance()

◆ DidAttach()

◆ DidLaunch()

◆ EntryBreakpointHit()

◆ EvalSpecialModulesStatus()

◆ GetEntryPoint()

◆ GetPluginDescriptionStatic()

◆ GetPluginName()

◆ GetPluginNameStatic()

◆ GetStepThroughTrampolinePlan()

◆ GetThreadLocalData()

◆ Initialize()

◆ IsCoreFile()

◆ LoadAllCurrentModules()

◆ LoadInterpreterModule()

◆ LoadModuleAtAddress()

◆ LoadVDSO()

◆ operator=()

◆ ProbeEntry()

◆ RefreshModules()

◆ RendezvousBreakpointHit()

◆ ResolveExecutableModule()

◆ SetRendezvousBreakpoint()

◆ Terminate()

◆ UnloadSections()

◆ UpdateLoadedSections()

Member Data Documentation

◆ m_auxv

◆ m_dyld_bid

◆ m_entry_point

◆ m_initial_modules_added

◆ m_interpreter_base

◆ m_interpreter_module

◆ m_load_offset

◆ m_loaded_modules

◆ m_rendezvous

◆ m_vdso_base