LLDB mainline
Classes | Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
DynamicLoaderMacOSXDYLD Class Reference

#include <DynamicLoaderMacOSXDYLD.h>

Inheritance diagram for DynamicLoaderMacOSXDYLD:
Inheritance graph
[legend]

Classes

struct  DYLDAllImageInfos
 

Public Member Functions

 DynamicLoaderMacOSXDYLD (lldb_private::Process *process)
 
 ~DynamicLoaderMacOSXDYLD () override
 
bool ProcessDidExec () override
 Called after attaching a process.
 
lldb_private::Status CanLoadImage () override
 Ask if it is ok to try and load or unload an shared library (image).
 
bool GetSharedCacheInformation (lldb::addr_t &base_address, lldb_private::UUID &uuid, lldb_private::LazyBool &using_shared_cache, lldb_private::LazyBool &private_shared_cache) override
 Get information about the shared cache for a process, if possible.
 
llvm::StringRef GetPluginName () override
 
bool IsFullyInitialized () override
 Return whether the dynamic loader is fully initialized and it's safe to call its APIs.
 
- Public Member Functions inherited from lldb_private::DynamicLoaderDarwin
 DynamicLoaderDarwin (lldb_private::Process *process)
 
 ~DynamicLoaderDarwin () override
 
void DidAttach () override
 Called after attaching a process.
 
void DidLaunch () override
 Called after attaching 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.
 
void FindEquivalentSymbols (lldb_private::Symbol *original_symbol, lldb_private::ModuleList &module_list, lldb_private::SymbolContextList &equivalent_symbols) override
 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.
 
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.
 
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.
 
virtual void DoInitialImageFetch ()=0
 
virtual bool NeedToDoInitialImageFetch ()=0
 
std::optional< lldb_private::AddressGetStartAddress () override
 Return the start address in the dynamic loader module.
 
- 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::AddressGetStartAddress ()
 Return the start address in the dynamic loader module.
 
- Public Member Functions inherited from lldb_private::PluginInterface
 PluginInterface ()=default
 
virtual ~PluginInterface ()=default
 
virtual llvm::StringRef GetPluginName ()=0
 
 PluginInterface (const PluginInterface &)=delete
 
PluginInterfaceoperator= (const PluginInterface &)=delete
 

Static Public Member Functions

static void Initialize ()
 
static void Terminate ()
 
static llvm::StringRef GetPluginNameStatic ()
 
static llvm::StringRef GetPluginDescriptionStatic ()
 
static lldb_private::DynamicLoaderCreateInstance (lldb_private::Process *process, bool force)
 
- Static Public Member Functions inherited from lldb_private::DynamicLoader
static DynamicLoaderFindPlugin (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

void PutToLog (lldb_private::Log *log) const
 
void DoInitialImageFetch () override
 
bool NeedToDoInitialImageFetch () override
 
bool DidSetNotificationBreakpoint () override
 
void DoClear () override
 
bool ReadDYLDInfoFromMemoryAndSetNotificationCallback (lldb::addr_t addr)
 
uint32_t AddrByteSize ()
 
bool ReadMachHeader (lldb::addr_t addr, llvm::MachO::mach_header *header, lldb_private::DataExtractor *load_command_data)
 
uint32_t ParseLoadCommands (const lldb_private::DataExtractor &data, ImageInfo &dylib_info, lldb_private::FileSpec *lc_id_dylinker)
 
bool SetNotificationBreakpoint () override
 
void ClearNotificationBreakpoint () override
 
bool InitializeFromAllImageInfos ()
 
bool ReadAllImageInfosStructure ()
 
bool AddModulesUsingImageInfosAddress (lldb::addr_t image_infos_addr, uint32_t image_infos_count)
 
bool RemoveModulesUsingImageInfosAddress (lldb::addr_t image_infos_addr, uint32_t image_infos_count)
 
void UpdateImageInfosHeaderAndLoadCommands (ImageInfo::collection &image_infos, uint32_t infos_count, bool update_executable)
 
bool ReadImageInfos (lldb::addr_t image_infos_addr, uint32_t image_infos_count, ImageInfo::collection &image_infos)
 
- Protected Member Functions inherited from lldb_private::DynamicLoaderDarwin
void PrivateInitialize (lldb_private::Process *process)
 
void PrivateProcessStateChanged (lldb_private::Process *process, lldb::StateType state)
 
void Clear (bool clear_process)
 
virtual void DoClear ()=0
 
void SetDYLDModule (lldb::ModuleSP &dyld_module_sp)
 
lldb::ModuleSP GetDYLDModule ()
 
void ClearDYLDModule ()
 
bool UpdateImageLoadAddress (lldb_private::Module *module, ImageInfo &info)
 
bool UnloadModuleSections (lldb_private::Module *module, ImageInfo &info)
 
lldb::ModuleSP FindTargetModuleForImageInfo (ImageInfo &image_info, bool can_create, bool *did_create_ptr)
 
void UnloadImages (const std::vector< lldb::addr_t > &solib_addresses)
 
void UnloadAllImages ()
 
virtual bool SetNotificationBreakpoint ()=0
 
virtual void ClearNotificationBreakpoint ()=0
 
virtual bool DidSetNotificationBreakpoint ()=0
 
std::recursive_mutex & GetMutex () const
 
lldb::ModuleSP GetPThreadLibraryModule ()
 
lldb_private::Address GetPthreadSetSpecificAddress ()
 
bool JSONImageInformationIntoImageInfo (lldb_private::StructuredData::ObjectSP image_details, ImageInfo::collection &image_infos)
 
void UpdateSpecialBinariesFromNewImageInfos (ImageInfo::collection &image_infos)
 
void UpdateDYLDImageInfoFromNewImageInfo (ImageInfo &image_info)
 
void AddExecutableModuleIfInImageInfos (ImageInfo::collection &image_infos)
 
bool AddModulesUsingImageInfos (ImageInfo::collection &image_infos)
 
- 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::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)
 

Static Protected Member Functions

static bool NotifyBreakpointHit (void *baton, lldb_private::StoppointCallbackContext *context, lldb::user_id_t break_id, lldb::user_id_t break_loc_id)
 
static lldb::ByteOrder GetByteOrderFromMagic (uint32_t magic)
 
- Static Protected Member Functions inherited from lldb_private::DynamicLoaderDarwin
static bool UseDYLDSPI (lldb_private::Process *process)
 

Protected Attributes

lldb::addr_t m_dyld_all_image_infos_addr
 
DYLDAllImageInfos m_dyld_all_image_infos
 
uint32_t m_dyld_all_image_infos_stop_id
 
lldb::user_id_t m_break_id
 
std::recursive_mutex m_mutex
 
bool m_process_image_addr_is_all_images_infos
 
- Protected Attributes inherited from lldb_private::DynamicLoaderDarwin
lldb::ModuleWP m_dyld_module_wp
 
lldb::ModuleWP m_libpthread_module_wp
 
lldb_private::Address m_pthread_getspecific_addr
 
ThreadIDToTLSMap m_tid_to_tls_map
 
ImageInfo::collection m_dyld_image_infos
 
uint32_t m_dyld_image_infos_stop_id
 
ImageInfo m_dyld
 
std::recursive_mutex m_mutex
 
- Protected Attributes inherited from lldb_private::DynamicLoader
Processm_process
 The process that this dynamic loader plug-in is tracking.
 

Private Member Functions

 DynamicLoaderMacOSXDYLD (const DynamicLoaderMacOSXDYLD &)=delete
 
const DynamicLoaderMacOSXDYLDoperator= (const DynamicLoaderMacOSXDYLD &)=delete
 

Additional Inherited Members

- Protected Types inherited from lldb_private::DynamicLoaderDarwin
typedef std::map< uint64_t, lldb::addr_tPthreadKeyToTLSMap
 
typedef std::map< lldb::user_id_t, PthreadKeyToTLSMapThreadIDToTLSMap
 

Detailed Description

Definition at line 35 of file DynamicLoaderMacOSXDYLD.h.

Constructor & Destructor Documentation

◆ DynamicLoaderMacOSXDYLD() [1/2]

DynamicLoaderMacOSXDYLD::DynamicLoaderMacOSXDYLD ( lldb_private::Process process)

Definition at line 99 of file DynamicLoaderMacOSXDYLD.cpp.

◆ ~DynamicLoaderMacOSXDYLD()

DynamicLoaderMacOSXDYLD::~DynamicLoaderMacOSXDYLD ( )
override

◆ DynamicLoaderMacOSXDYLD() [2/2]

DynamicLoaderMacOSXDYLD::DynamicLoaderMacOSXDYLD ( const DynamicLoaderMacOSXDYLD )
privatedelete

Member Function Documentation

◆ AddModulesUsingImageInfosAddress()

bool DynamicLoaderMacOSXDYLD::AddModulesUsingImageInfosAddress ( lldb::addr_t  image_infos_addr,
uint32_t  image_infos_count 
)
protected

◆ AddrByteSize()

uint32_t DynamicLoaderMacOSXDYLD::AddrByteSize ( )
protected

◆ CanLoadImage()

Status DynamicLoaderMacOSXDYLD::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 1049 of file DynamicLoaderMacOSXDYLD.cpp.

References DynamicLoaderMacOSXDYLD::DYLDAllImageInfos::dylib_info_addr, error(), m_dyld_all_image_infos, and ReadAllImageInfosStructure().

◆ ClearNotificationBreakpoint()

void DynamicLoaderMacOSXDYLD::ClearNotificationBreakpoint ( )
overrideprotectedvirtual

◆ CreateInstance()

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

◆ DidSetNotificationBreakpoint()

bool DynamicLoaderMacOSXDYLD::DidSetNotificationBreakpoint ( )
overrideprotectedvirtual

◆ DoClear()

void DynamicLoaderMacOSXDYLD::DoClear ( )
overrideprotectedvirtual

◆ DoInitialImageFetch()

void DynamicLoaderMacOSXDYLD::DoInitialImageFetch ( )
overrideprotectedvirtual

◆ GetByteOrderFromMagic()

lldb::ByteOrder DynamicLoaderMacOSXDYLD::GetByteOrderFromMagic ( uint32_t  magic)
staticprotected

◆ GetPluginDescriptionStatic()

llvm::StringRef DynamicLoaderMacOSXDYLD::GetPluginDescriptionStatic ( )
static

Definition at line 1156 of file DynamicLoaderMacOSXDYLD.cpp.

Referenced by Initialize().

◆ GetPluginName()

llvm::StringRef DynamicLoaderMacOSXDYLD::GetPluginName ( )
inlineoverridevirtual

Implements lldb_private::PluginInterface.

Definition at line 67 of file DynamicLoaderMacOSXDYLD.h.

References GetPluginNameStatic().

◆ GetPluginNameStatic()

static llvm::StringRef DynamicLoaderMacOSXDYLD::GetPluginNameStatic ( )
inlinestatic

◆ GetSharedCacheInformation()

bool DynamicLoaderMacOSXDYLD::GetSharedCacheInformation ( lldb::addr_t base_address,
lldb_private::UUID uuid,
lldb_private::LazyBool using_shared_cache,
lldb_private::LazyBool private_shared_cache 
)
overridevirtual

Get information about the shared cache for a process, if possible.

On some systems (e.g. Darwin based systems), a set of libraries that are common to most processes may be put in a single region of memory and mapped into every process, this is called the shared cache, as a performance optimization.

Many targets will not have the concept of a shared cache.

Depending on how the DynamicLoader gathers information about the shared cache, it may be able to only return basic information - like the UUID of the cache - or it may be able to return additional information about the cache.

Parameters
[out]base_addressThe base address (load address) of the shared cache. LLDB_INVALID_ADDRESS if it cannot be determined.
[out]uuidThe UUID of the shared cache, if it can be determined. If the UUID cannot be fetched, IsValid() will be false.
[out]using_shared_cacheIf this process is using a shared cache. If unknown, eLazyBoolCalculate is returned.
[out]private_shared_cacheA LazyBool indicating whether this process is using a private shared cache. If this information cannot be fetched, eLazyBoolCalculate.
Returns
Returns false if this DynamicLoader cannot gather information about the shared cache / has no concept of a shared cache.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 1067 of file DynamicLoaderMacOSXDYLD.cpp.

References lldb_private::UUID::Clear(), lldb_private::eLazyBoolCalculate, lldb_private::eLazyBoolYes, error(), lldb_private::Process::GetAddressByteSize(), lldb_private::Process::GetImageInfoAddress(), lldb_private::UUID::IsValid(), LLDB_INVALID_ADDRESS, lldb_private::DynamicLoader::m_process, lldb_private::Process::ReadMemory(), and lldb_private::Process::ReadUnsignedIntegerFromMemory().

◆ Initialize()

void DynamicLoaderMacOSXDYLD::Initialize ( )
static

◆ InitializeFromAllImageInfos()

bool DynamicLoaderMacOSXDYLD::InitializeFromAllImageInfos ( )
protected

◆ IsFullyInitialized()

bool DynamicLoaderMacOSXDYLD::IsFullyInitialized ( )
overridevirtual

Return whether the dynamic loader is fully initialized and it's safe to call its APIs.

On some systems (e.g. Darwin based systems), lldb will get notified by the dynamic loader before it itself finished initializing and it's not safe to call certain APIs or SPIs.

Reimplemented from lldb_private::DynamicLoader.

Definition at line 1139 of file DynamicLoaderMacOSXDYLD.cpp.

References DynamicLoaderMacOSXDYLD::DYLDAllImageInfos::libSystemInitialized, m_dyld_all_image_infos, and ReadAllImageInfosStructure().

◆ NeedToDoInitialImageFetch()

bool DynamicLoaderMacOSXDYLD::NeedToDoInitialImageFetch ( )
overrideprotectedvirtual

◆ NotifyBreakpointHit()

bool DynamicLoaderMacOSXDYLD::NotifyBreakpointHit ( void *  baton,
lldb_private::StoppointCallbackContext context,
lldb::user_id_t  break_id,
lldb::user_id_t  break_loc_id 
)
staticprotected

◆ operator=()

const DynamicLoaderMacOSXDYLD & DynamicLoaderMacOSXDYLD::operator= ( const DynamicLoaderMacOSXDYLD )
privatedelete

◆ ParseLoadCommands()

uint32_t DynamicLoaderMacOSXDYLD::ParseLoadCommands ( const lldb_private::DataExtractor data,
ImageInfo dylib_info,
lldb_private::FileSpec lc_id_dylinker 
)
protected

◆ ProcessDidExec()

bool DynamicLoaderMacOSXDYLD::ProcessDidExec ( )
overridevirtual

◆ PutToLog()

void DynamicLoaderMacOSXDYLD::PutToLog ( lldb_private::Log log) const
protected

◆ ReadAllImageInfosStructure()

bool DynamicLoaderMacOSXDYLD::ReadAllImageInfosStructure ( )
protected

◆ ReadDYLDInfoFromMemoryAndSetNotificationCallback()

bool DynamicLoaderMacOSXDYLD::ReadDYLDInfoFromMemoryAndSetNotificationCallback ( lldb::addr_t  addr)
protected

◆ ReadImageInfos()

bool DynamicLoaderMacOSXDYLD::ReadImageInfos ( lldb::addr_t  image_infos_addr,
uint32_t  image_infos_count,
ImageInfo::collection &  image_infos 
)
protected

◆ ReadMachHeader()

bool DynamicLoaderMacOSXDYLD::ReadMachHeader ( lldb::addr_t  addr,
llvm::MachO::mach_header *  header,
lldb_private::DataExtractor load_command_data 
)
protected

◆ RemoveModulesUsingImageInfosAddress()

bool DynamicLoaderMacOSXDYLD::RemoveModulesUsingImageInfosAddress ( lldb::addr_t  image_infos_addr,
uint32_t  image_infos_count 
)
protected

◆ SetNotificationBreakpoint()

bool DynamicLoaderMacOSXDYLD::SetNotificationBreakpoint ( )
overrideprotectedvirtual

◆ Terminate()

void DynamicLoaderMacOSXDYLD::Terminate ( )
static

◆ UpdateImageInfosHeaderAndLoadCommands()

void DynamicLoaderMacOSXDYLD::UpdateImageInfosHeaderAndLoadCommands ( ImageInfo::collection &  image_infos,
uint32_t  infos_count,
bool  update_executable 
)
protected

Member Data Documentation

◆ m_break_id

lldb::user_id_t DynamicLoaderMacOSXDYLD::m_break_id
protected

◆ m_dyld_all_image_infos

DYLDAllImageInfos DynamicLoaderMacOSXDYLD::m_dyld_all_image_infos
protected

◆ m_dyld_all_image_infos_addr

lldb::addr_t DynamicLoaderMacOSXDYLD::m_dyld_all_image_infos_addr
protected

◆ m_dyld_all_image_infos_stop_id

uint32_t DynamicLoaderMacOSXDYLD::m_dyld_all_image_infos_stop_id
protected

Definition at line 161 of file DynamicLoaderMacOSXDYLD.h.

Referenced by ReadAllImageInfosStructure().

◆ m_mutex

std::recursive_mutex DynamicLoaderMacOSXDYLD::m_mutex
mutableprotected

◆ m_process_image_addr_is_all_images_infos

bool DynamicLoaderMacOSXDYLD::m_process_image_addr_is_all_images_infos
protected

Definition at line 164 of file DynamicLoaderMacOSXDYLD.h.

Referenced by DoInitialImageFetch(), and ProcessDidExec().


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