LLDB  mainline
Public Member Functions | Static Public Member Functions | Private Member Functions | List of all members
DynamicLoaderStatic Class Reference

#include <DynamicLoaderStatic.h>

Inheritance diagram for DynamicLoaderStatic:
Inheritance graph
[legend]
Collaboration diagram for DynamicLoaderStatic:
Collaboration graph
[legend]

Public Member Functions

 DynamicLoaderStatic (lldb_private::Process *process)
 
void DidAttach () override
 Called after attaching a process. More...
 
void DidLaunch () override
 Called after attaching a process. More...
 
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. More...
 
lldb_private::Status CanLoadImage () override
 Ask if it is ok to try and load or unload an shared library (image). More...
 
lldb_private::ConstString GetPluginName () override
 
uint32_t GetPluginVersion () override
 
- Public Member Functions inherited from lldb_private::DynamicLoader
 DynamicLoader (Process *process)
 Construct with a process. More...
 
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. More...
 
bool GetStopWhenImagesChange () const
 Get whether the process should stop when images change. More...
 
void SetStopWhenImagesChange (bool stop)
 Set whether the process should stop when images change. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
virtual bool IsFullyInitialized ()
 Return whether the dynamic loader is fully initialized and it's safe to call its APIs. More...
 
- Public Member Functions inherited from lldb_private::PluginInterface
 PluginInterface ()=default
 
virtual ~PluginInterface ()=default
 
 PluginInterface (const PluginInterface &)=delete
 
PluginInterfaceoperator= (const PluginInterface &)=delete
 

Static Public Member Functions

static void Initialize ()
 
static void Terminate ()
 
static lldb_private::ConstString GetPluginNameStatic ()
 
static const char * GetPluginDescriptionStatic ()
 
static lldb_private::DynamicLoaderCreateInstance (lldb_private::Process *process, bool force)
 
- Static Public Member Functions inherited from lldb_private::DynamicLoader
static DynamicLoaderFindPlugin (Process *process, const char *plugin_name)
 Find a dynamic loader plugin for a given process. More...
 

Private Member Functions

void LoadAllImagesAtFileAddresses ()
 

Additional Inherited Members

- Protected Member Functions inherited from lldb_private::DynamicLoader
lldb::ModuleSP GetTargetExecutable ()
 Checks to see if the target module has changed, updates the target accordingly and returns the target executable module. More...
 
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. More...
 
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. More...
 
void UnloadSectionsCommon (const lldb::ModuleSP module)
 
const lldb_private::SectionListGetSectionListFromModule (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)
 
- Protected Attributes inherited from lldb_private::DynamicLoader
Processm_process
 The process that this dynamic loader plug-in is tracking. More...
 

Detailed Description

Definition at line 17 of file DynamicLoaderStatic.h.

Constructor & Destructor Documentation

◆ DynamicLoaderStatic()

DynamicLoaderStatic::DynamicLoaderStatic ( lldb_private::Process process)

Definition at line 64 of file DynamicLoaderStatic.cpp.

Member Function Documentation

◆ CanLoadImage()

Status DynamicLoaderStatic::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 140 of file DynamicLoaderStatic.cpp.

References error().

◆ CreateInstance()

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

◆ DidAttach()

void DynamicLoaderStatic::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 71 of file DynamicLoaderStatic.cpp.

References LoadAllImagesAtFileAddresses().

◆ DidLaunch()

void DynamicLoaderStatic::DidLaunch ( )
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 77 of file DynamicLoaderStatic.cpp.

References LoadAllImagesAtFileAddresses().

◆ GetPluginDescriptionStatic()

const char * DynamicLoaderStatic::GetPluginDescriptionStatic ( )
static

Definition at line 160 of file DynamicLoaderStatic.cpp.

Referenced by Initialize().

◆ GetPluginName()

lldb_private::ConstString DynamicLoaderStatic::GetPluginName ( )
overridevirtual

Implements lldb_private::PluginInterface.

Definition at line 166 of file DynamicLoaderStatic.cpp.

References GetPluginNameStatic().

◆ GetPluginNameStatic()

lldb_private::ConstString DynamicLoaderStatic::GetPluginNameStatic ( )
static

Definition at line 155 of file DynamicLoaderStatic.cpp.

Referenced by ProcessMachCore::DoLoadCore(), GetPluginName(), and Initialize().

◆ GetPluginVersion()

uint32_t DynamicLoaderStatic::GetPluginVersion ( )
overridevirtual

Implements lldb_private::PluginInterface.

Definition at line 170 of file DynamicLoaderStatic.cpp.

◆ GetStepThroughTrampolinePlan()

ThreadPlanSP DynamicLoaderStatic::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_othersWhether 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 135 of file DynamicLoaderStatic.cpp.

◆ Initialize()

void DynamicLoaderStatic::Initialize ( )
static

◆ LoadAllImagesAtFileAddresses()

void DynamicLoaderStatic::LoadAllImagesAtFileAddresses ( )
private

◆ Terminate()

void DynamicLoaderStatic::Terminate ( )
static

Definition at line 151 of file DynamicLoaderStatic.cpp.

References CreateInstance().


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