#include <AppleObjCRuntime.h>

Inheritance diagram for lldb_private::AppleObjCRuntime:

[legend]

Public Member Functions
	~AppleObjCRuntime () override

bool	isA (const void *ClassID) const override

bool	GetObjectDescription (Stream &str, Value &value, ExecutionContextScope *exe_scope) override

bool	GetObjectDescription (Stream &str, ValueObject &object) override

bool	CouldHaveDynamicValue (ValueObject &in_value) override

bool	GetDynamicTypeAndAddress (ValueObject &in_value, lldb::DynamicValueType use_dynamic, TypeAndOrName &class_type_or_name, Address &address, Value::ValueType &value_type) override

TypeAndOrName	FixUpDynamicType (const TypeAndOrName &type_and_or_name, ValueObject &static_value) override

bool	IsModuleObjCLibrary (const lldb::ModuleSP &module_sp) override

bool	ReadObjCLibrary (const lldb::ModuleSP &module_sp) override

bool	HasReadObjCLibrary () override

lldb::ThreadPlanSP	GetStepThroughTrampolinePlan (Thread &thread, bool stop_others) override

lldb::ModuleSP	GetObjCModule ()

void	ModulesDidLoad (const ModuleList &module_list) override
	Called when modules have been loaded in the process.

void	SetExceptionBreakpoints () override

void	ClearExceptionBreakpoints () override

bool	ExceptionBreakpointsAreSet () override

bool	ExceptionBreakpointsExplainStop (lldb::StopInfoSP stop_reason) override

lldb::SearchFilterSP	CreateExceptionSearchFilter () override

lldb::ValueObjectSP	GetExceptionObjectForThread (lldb::ThreadSP thread_sp) override

lldb::ThreadSP	GetBacktraceThreadFromException (lldb::ValueObjectSP thread_sp) override

uint32_t	GetFoundationVersion ()

virtual void	GetValuesForGlobalCFBooleans (lldb::addr_t &cf_true, lldb::addr_t &cf_false)

virtual bool	IsTaggedPointer (lldb::addr_t addr)

Public Member Functions inherited from lldb_private::ObjCLanguageRuntime
	~ObjCLanguageRuntime () override

bool	isA (const void *ClassID) const override

virtual TaggedPointerVendor *	GetTaggedPointerVendor ()

virtual EncodingToTypeSP	GetEncodingToType ()

virtual ClassDescriptorSP	GetClassDescriptor (ValueObject &in_value)

ClassDescriptorSP	GetNonKVOClassDescriptor (ValueObject &in_value)

virtual ClassDescriptorSP	GetClassDescriptorFromClassName (ConstString class_name)

virtual ClassDescriptorSP	GetClassDescriptorFromISA (ObjCISA isa)

ClassDescriptorSP	GetNonKVOClassDescriptor (ObjCISA isa)

lldb::LanguageType	GetLanguageType () const override

virtual bool	IsModuleObjCLibrary (const lldb::ModuleSP &module_sp)=0

virtual bool	ReadObjCLibrary (const lldb::ModuleSP &module_sp)=0

virtual bool	HasReadObjCLibrary ()=0

lldb::addr_t	LookupInMethodCache (lldb::addr_t class_addr, lldb::addr_t sel)

lldb::addr_t	LookupInMethodCache (lldb::addr_t class_addr, llvm::StringRef sel_str)

void	AddToMethodCache (lldb::addr_t class_addr, lldb::addr_t sel, lldb::addr_t impl_addr)

void	AddToMethodCache (lldb::addr_t class_addr, llvm::StringRef sel_str, lldb::addr_t impl_addr)

TypeAndOrName	LookupInClassNameCache (lldb::addr_t class_addr)

void	AddToClassNameCache (lldb::addr_t class_addr, const char *name, lldb::TypeSP type_sp)

void	AddToClassNameCache (lldb::addr_t class_addr, const TypeAndOrName &class_or_type_name)

lldb::TypeSP	LookupInCompleteClassCache (ConstString &name)

std::optional< CompilerType >	GetRuntimeType (CompilerType base_type) override

virtual llvm::Expected< std::unique_ptr< UtilityFunction > >	CreateObjectChecker (std::string name, ExecutionContext &exe_ctx)=0

virtual ObjCRuntimeVersions	GetRuntimeVersion () const

bool	IsValidISA (ObjCISA isa)

virtual void	UpdateISAToDescriptorMapIfNeeded ()=0

void	UpdateISAToDescriptorMap ()

virtual ObjCISA	GetISA (ConstString name)

virtual ObjCISA	GetParentClass (ObjCISA isa)

virtual size_t	GetByteOffsetForIvar (CompilerType &parent_qual_type, const char *ivar_name)

bool	HasNewLiteralsAndIndexing ()

void	SymbolsDidLoad (const ModuleList &module_list) override

bool	GetTypeBitSize (const CompilerType &compiler_type, uint64_t &size) override

bool	IsAllowedRuntimeValue (ConstString name) override
	Check whether the name is "self" or "_cmd" and should show up in "frame variable".

Public Member Functions inherited from lldb_private::LanguageRuntime
virtual lldb::LanguageType	GetLanguageType () const =0

virtual LanguageRuntime *	GetPreferredLanguageRuntime (ValueObject &in_value)
	Return the preferred language runtime instance, which in most cases will be the current instance.

virtual bool	GetObjectDescription (Stream &str, ValueObject &object)=0

virtual bool	GetObjectDescription (Stream &str, Value &value, ExecutionContextScope *exe_scope)=0

virtual llvm::Expected< VTableInfo >	GetVTableInfo (ValueObject &in_value, bool check_type)
	Get the vtable information for a given value.

virtual bool	GetDynamicTypeAndAddress (ValueObject &in_value, lldb::DynamicValueType use_dynamic, TypeAndOrName &class_type_or_name, Address &address, Value::ValueType &value_type)=0

virtual CompilerType	GetConcreteType (ExecutionContextScope *exe_scope, ConstString abstract_type_name)

virtual bool	CouldHaveDynamicValue (ValueObject &in_value)=0

virtual TypeAndOrName	FixUpDynamicType (const TypeAndOrName &type_and_or_name, ValueObject &static_value)=0

virtual void	SetExceptionBreakpoints ()

virtual void	ClearExceptionBreakpoints ()

virtual bool	ExceptionBreakpointsAreSet ()

virtual bool	ExceptionBreakpointsExplainStop (lldb::StopInfoSP stop_reason)

virtual lldb::ValueObjectSP	GetExceptionObjectForThread (lldb::ThreadSP thread_sp)

virtual lldb::ThreadSP	GetBacktraceThreadFromException (lldb::ValueObjectSP thread_sp)

virtual DeclVendor *	GetDeclVendor ()

virtual lldb::BreakpointResolverSP	CreateExceptionResolver (const lldb::BreakpointSP &bkpt, bool catch_bp, bool throw_bp)=0

virtual lldb::SearchFilterSP	CreateExceptionSearchFilter ()

virtual bool	GetTypeBitSize (const CompilerType &compiler_type, uint64_t &size)

virtual void	SymbolsDidLoad (const ModuleList &module_list)

virtual lldb::ThreadPlanSP	GetStepThroughTrampolinePlan (Thread &thread, bool stop_others)=0

virtual bool	IsAllowedRuntimeValue (ConstString name)
	Identify whether a name is a runtime value that should not be hidden by from the user interface.

virtual std::optional< CompilerType >	GetRuntimeType (CompilerType base_type)

void	ModulesDidLoad (const ModuleList &module_list) override
	Called when modules have been loaded in the process.

virtual bool	GetIRPasses (LLVMUserExpression::IRPasses &custom_passes)

virtual lldb::addr_t	LookupRuntimeSymbol (ConstString name)

virtual bool	isA (const void *ClassID) const

Public Member Functions inherited from lldb_private::Runtime
	Runtime (Process *process)

virtual	~Runtime ()=default

	Runtime (const Runtime &)=delete

const Runtime &	operator= (const Runtime &)=delete

Process *	GetProcess ()

Target &	GetTargetRef ()

virtual void	ModulesDidLoad (const ModuleList &module_list)=0
	Called when modules have been loaded in the process.

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 bool	classof (const LanguageRuntime *runtime)

static std::tuple< FileSpec, ConstString >	GetExceptionThrowLocation ()

Static Public Member Functions inherited from lldb_private::ObjCLanguageRuntime
static lldb::BreakpointPreconditionSP	GetBreakpointExceptionPrecondition (lldb::LanguageType language, bool throw_bp)

static bool	classof (const LanguageRuntime *runtime)

static ObjCLanguageRuntime *	Get (Process &process)

Static Public Member Functions inherited from lldb_private::LanguageRuntime
static LanguageRuntime *	FindPlugin (Process *process, lldb::LanguageType language)

static void	InitializeCommands (CommandObject *parent)

static lldb::BreakpointSP	CreateExceptionBreakpoint (Target &target, lldb::LanguageType language, bool catch_bp, bool throw_bp, bool is_internal=false)

static lldb::BreakpointPreconditionSP	GetExceptionPrecondition (lldb::LanguageType language, bool throw_bp)

static lldb::UnwindPlanSP	GetRuntimeUnwindPlan (lldb_private::Thread &thread, lldb_private::RegisterContext *regctx, bool &behaves_like_zeroth_frame)
	A language runtime may be able to provide a special UnwindPlan for the frame represented by the register contents regctx when that frame is not following the normal ABI conventions.

Static Public Attributes
static char	ID = 0

Static Public Attributes inherited from lldb_private::ObjCLanguageRuntime
static char	ID = 0

Static Public Attributes inherited from lldb_private::LanguageRuntime
static char	ID = 0

Protected Member Functions
	AppleObjCRuntime (Process *process)

bool	CalculateHasNewLiteralsAndIndexing () override

void	ReadObjCLibraryIfNeeded (const ModuleList &module_list)

Address *	GetPrintForDebuggerAddr ()

Protected Member Functions inherited from lldb_private::ObjCLanguageRuntime
	ObjCLanguageRuntime (Process *process)

virtual bool	CalculateHasNewLiteralsAndIndexing ()

bool	ISAIsCached (ObjCISA isa) const

bool	AddClass (ObjCISA isa, const ClassDescriptorSP &descriptor_sp)

bool	AddClass (ObjCISA isa, const ClassDescriptorSP &descriptor_sp, const char *class_name)

bool	AddClass (ObjCISA isa, const ClassDescriptorSP &descriptor_sp, uint32_t class_name_hash)

ISAToDescriptorIterator	GetDescriptorIterator (ConstString name)

std::pair< ISAToDescriptorIterator, ISAToDescriptorIterator >	GetDescriptorIteratorPair (bool update_if_needed=true)

void	ReadObjCLibraryIfNeeded (const ModuleList &module_list)

	ObjCLanguageRuntime (const ObjCLanguageRuntime &)=delete

const ObjCLanguageRuntime &	operator= (const ObjCLanguageRuntime &)=delete

Protected Member Functions inherited from lldb_private::LanguageRuntime
virtual lldb::UnwindPlanSP	GetRuntimeUnwindPlan (lldb::ProcessSP process_sp, lldb_private::RegisterContext *regctx, bool &behaves_like_zeroth_frame)

	LanguageRuntime (Process *process)

Static Protected Member Functions
static bool	AppleIsModuleObjCLibrary (const lldb::ModuleSP &module_sp)

static ObjCRuntimeVersions	GetObjCVersion (Process *process, lldb::ModuleSP &objc_module_sp)

Protected Attributes
std::unique_ptr< Address >	m_PrintForDebugger_addr

bool	m_read_objc_library

std::unique_ptr< lldb_private::AppleObjCTrampolineHandler >	m_objc_trampoline_handler_up

lldb::BreakpointSP	m_objc_exception_bp_sp

lldb::ModuleWP	m_objc_module_wp

std::unique_ptr< FunctionCaller >	m_print_object_caller_up

std::optional< uint32_t >	m_Foundation_major

Protected Attributes inherited from lldb_private::ObjCLanguageRuntime
uint32_t	m_isa_to_descriptor_stop_id

CompleteClassMap	m_complete_class_cache

CompleteClassSet	m_negative_complete_class_cache

Protected Attributes inherited from lldb_private::Runtime
Process *	m_process

Additional Inherited Members
Public Types inherited from lldb_private::ObjCLanguageRuntime
enum class	ObjCRuntimeVersions { eObjC_VersionUnknown = 0 , eAppleObjC_V1 = 1 , eAppleObjC_V2 = 2 , eGNUstep_libobjc2 = 3 }

typedef lldb::addr_t	ObjCISA

typedef std::shared_ptr< ClassDescriptor >	ClassDescriptorSP

typedef std::shared_ptr< EncodingToType >	EncodingToTypeSP

Protected Types inherited from lldb_private::ObjCLanguageRuntime
typedef std::map< ConstString, lldb::TypeWP >	CompleteClassMap

typedef std::unordered_set< ConstString, ConstStringSetHelpers, ConstStringSetHelpers >	CompleteClassSet

Detailed Description

Definition at line 23 of file AppleObjCRuntime.h.

Constructor & Destructor Documentation

◆ ~AppleObjCRuntime()

AppleObjCRuntime::~AppleObjCRuntime ( )

overridedefault

◆ AppleObjCRuntime()

AppleObjCRuntime::AppleObjCRuntime ( Process * process )

protected

Definition at line 54 of file AppleObjCRuntime.cpp.

References lldb_private::Target::GetImages(), lldb_private::Process::GetTarget(), and ReadObjCLibraryIfNeeded().

Member Function Documentation

◆ AppleIsModuleObjCLibrary()

bool AppleObjCRuntime::AppleIsModuleObjCLibrary ( const lldb::ModuleSP & module_sp )

staticprotected

Definition at line 307 of file AppleObjCRuntime.cpp.

References lldb_private::FileSpec::GetFilename().

Referenced by GetObjCModule(), GetObjCVersion(), and IsModuleObjCLibrary().

◆ CalculateHasNewLiteralsAndIndexing()

bool AppleObjCRuntime::CalculateHasNewLiteralsAndIndexing ( )

overrideprotectedvirtual

Reimplemented from lldb_private::ObjCLanguageRuntime.

Definition at line 452 of file AppleObjCRuntime.cpp.

References lldb::eSymbolTypeCode, lldb_private::ModuleList::FindSymbolsWithNameAndType(), lldb_private::Target::GetImages(), lldb_private::Process::GetTarget(), lldb_private::SymbolContextList::IsEmpty(), and lldb_private::Runtime::m_process.

◆ classof()

static bool lldb_private::AppleObjCRuntime::classof ( const LanguageRuntime * runtime )

inlinestatic

Definition at line 42 of file AppleObjCRuntime.h.

References ID, and lldb_private::LanguageRuntime::isA().

◆ ClearExceptionBreakpoints()

void AppleObjCRuntime::ClearExceptionBreakpoints ( )

overridevirtual

Reimplemented from lldb_private::LanguageRuntime.

Definition at line 426 of file AppleObjCRuntime.cpp.

References m_objc_exception_bp_sp, and lldb_private::Runtime::m_process.

◆ CouldHaveDynamicValue()

bool AppleObjCRuntime::CouldHaveDynamicValue ( ValueObject & in_value )

overridevirtual

Implements lldb_private::LanguageRuntime.

Definition at line 263 of file AppleObjCRuntime.cpp.

References lldb_private::ValueObject::GetCompilerType(), and lldb_private::CompilerType::IsPossibleDynamicType().

Referenced by lldb_private::AppleObjCRuntimeV1::GetDynamicTypeAndAddress(), and lldb_private::AppleObjCRuntimeV2::GetDynamicTypeAndAddress().

◆ CreateExceptionSearchFilter()

lldb::SearchFilterSP AppleObjCRuntime::CreateExceptionSearchFilter ( )

overridevirtual

Reimplemented from lldb_private::LanguageRuntime.

Definition at line 473 of file AppleObjCRuntime.cpp.

References lldb_private::FileSpecList::Append(), lldb_private::Target::GetArchitecture(), GetExceptionThrowLocation(), lldb_private::Target::GetSearchFilterForModuleList(), lldb_private::Process::GetTarget(), lldb_private::ArchSpec::GetTriple(), and lldb_private::Runtime::m_process.

◆ ExceptionBreakpointsAreSet()

bool AppleObjCRuntime::ExceptionBreakpointsAreSet ( )

overridevirtual

Reimplemented from lldb_private::LanguageRuntime.

Definition at line 435 of file AppleObjCRuntime.cpp.

References m_objc_exception_bp_sp.

◆ ExceptionBreakpointsExplainStop()

bool AppleObjCRuntime::ExceptionBreakpointsExplainStop ( lldb::StopInfoSP stop_reason )

overridevirtual

Reimplemented from lldb_private::LanguageRuntime.

Definition at line 439 of file AppleObjCRuntime.cpp.

References lldb::eStopReasonBreakpoint, lldb_private::Process::GetBreakpointSiteList(), m_objc_exception_bp_sp, lldb_private::Runtime::m_process, and lldb_private::StopPointSiteList< StopPointSite >::StopPointSiteContainsBreakpoint().

◆ FixUpDynamicType()

TypeAndOrName AppleObjCRuntime::FixUpDynamicType	(	const TypeAndOrName &	type_and_or_name,
		ValueObject &	static_value
	)

overridevirtual

Implements lldb_private::LanguageRuntime.

Definition at line 278 of file AppleObjCRuntime.cpp.

References lldb_private::Flags::AllSet(), lldb_private::ValueObject::GetCompilerType(), lldb_private::TypeAndOrName::GetCompilerType(), lldb_private::ConstString::GetCString(), lldb_private::TypeAndOrName::GetName(), lldb_private::CompilerType::GetPointerType(), lldb_private::CompilerType::GetTypeInfo(), lldb_private::TypeAndOrName::HasType(), lldb_private::TypeAndOrName::SetCompilerType(), and lldb_private::TypeAndOrName::SetName().

◆ GetBacktraceThreadFromException()

ThreadSP AppleObjCRuntime::GetBacktraceThreadFromException ( lldb::ValueObjectSP thread_sp )

overridevirtual

◆ GetDynamicTypeAndAddress()

bool AppleObjCRuntime::GetDynamicTypeAndAddress	(	ValueObject &	in_value,
		lldb::DynamicValueType	use_dynamic,
		TypeAndOrName &	class_type_or_name,
		Address &	address,
		Value::ValueType &	value_type
	)