#include <GNUstepObjCRuntime.h>

Inheritance diagram for lldb_private::GNUstepObjCRuntime:

Public Member Functions
	~GNUstepObjCRuntime () override
llvm::StringRef	GetPluginName () override
void	ModulesDidLoad (const ModuleList &module_list) override
	Called when modules have been loaded in the process.
bool	isA (const void *ClassID) const override
llvm::Error	GetObjectDescription (Stream &str, Value &value, ExecutionContextScope *exe_scope) override
llvm::Error	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, llvm::ArrayRef< uint8_t > &local_buffer) override
	This call should return true if it could set the name and/or the type Sets address to the address of the dynamic type if value_type is set to a file or load address.
TypeAndOrName	FixUpDynamicType (const TypeAndOrName &type_and_or_name, ValueObject &static_value) override
lldb::BreakpointResolverSP	CreateExceptionResolver (const lldb::BreakpointSP &bkpt, bool catch_bp, bool throw_bp) override
lldb::ThreadPlanSP	GetStepThroughTrampolinePlan (Thread &thread, bool stop_others) override
bool	IsModuleObjCLibrary (const lldb::ModuleSP &module_sp) override
bool	ReadObjCLibrary (const lldb::ModuleSP &module_sp) override
bool	HasReadObjCLibrary () override
llvm::Expected< std::unique_ptr< UtilityFunction > >	CreateObjectChecker (std::string name, ExecutionContext &exe_ctx) override
ObjCRuntimeVersions	GetRuntimeVersion () const override
void	UpdateISAToDescriptorMapIfNeeded () override
Public Member Functions inherited from lldb_private::ObjCLanguageRuntime
	~ObjCLanguageRuntime () override
bool	isA (const void *ClassID) const override
virtual TaggedPointerVendor *	GetTaggedPointerVendor ()
bool	IsTaggedPointerValue (ValueObject &in_value)
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
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
bool	IsValidISA (ObjCISA isa)
void	UpdateISAToDescriptorMap ()
virtual ObjCISA	GetISA (ConstString name)
virtual ObjCISA	GetParentClass (ObjCISA isa)
virtual ObjCISA	GetPointerISA (ObjCISA isa)
virtual size_t	GetByteOffsetForIvar (CompilerType &parent_qual_type, const char *ivar_name)
bool	HasNewLiteralsAndIndexing ()
void	SymbolsDidLoad (const ModuleList &module_list) override
std::optional< uint64_t >	GetTypeBitSize (const CompilerType &compiler_type) 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 LanguageRuntime *	GetPreferredLanguageRuntime (ValueObject &in_value)
	Return the preferred language runtime instance, which in most cases will be the current instance.
virtual llvm::Expected< VTableInfo >	GetVTableInfo (ValueObject &in_value, bool check_type)
	Get the vtable information for a given value.
virtual CompilerType	GetConcreteType (ExecutionContextScope *exe_scope, ConstString abstract_type_name)
virtual llvm::Error	FixupVariableLocation (Variable &variable, Value &value)
	This allows a language runtime to adjust the location of `variable` computed from its debug info, for storage whose indirection is only known at runtime.
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::SearchFilterSP	CreateExceptionSearchFilter ()
void	ModulesDidLoad (const ModuleList &module_list) override
	Called when modules have been loaded in the process.
virtual bool	GetIRPasses (LLVMUserExpression::IRPasses &custom_passes)
virtual bool	IsSymbolARuntimeThunk (const Symbol &symbol)
virtual lldb::addr_t	LookupRuntimeSymbol (ConstString name)
virtual StructuredData::ObjectSP	GetLanguageSpecificData (SymbolContext sc)
	Language runtime plugins can use this API to report language-specific runtime information about this compile unit, such as additional language version details or feature flags.
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 ()
Public Member Functions inherited from lldb_private::PluginInterface
	PluginInterface ()=default
virtual	~PluginInterface ()=default
	PluginInterface (const PluginInterface &)=delete
PluginInterface &	operator= (const PluginInterface &)=delete

Static Public Member Functions
static void	Initialize ()
static void	Terminate ()
static lldb_private::LanguageRuntime *	CreateInstance (Process *process, lldb::LanguageType language)
static llvm::StringRef	GetPluginNameStatic ()
static bool	classof (const LanguageRuntime *runtime)
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 bool	IsSupportedForArchitecture (const ArchSpec &arch)
	Returns whether the architecture's object file format supports Objective-C code generation.
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
	GNUstepObjCRuntime (Process *process)
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)

Protected Attributes
lldb::ModuleSP	m_objc_module_sp
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 24 of file GNUstepObjCRuntime.h.

Constructor & Destructor Documentation

◆ ~GNUstepObjCRuntime()

GNUstepObjCRuntime::~GNUstepObjCRuntime ( )

overridedefault

◆ GNUstepObjCRuntime()

GNUstepObjCRuntime::GNUstepObjCRuntime ( Process * process )

protected

Definition at line 102 of file GNUstepObjCRuntime.cpp.

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

Referenced by CreateInstance().

Member Function Documentation

◆ classof()

bool lldb_private::GNUstepObjCRuntime::classof ( const LanguageRuntime * runtime )

inlinestatic

Definition at line 53 of file GNUstepObjCRuntime.h.

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

◆ CouldHaveDynamicValue()

bool GNUstepObjCRuntime::CouldHaveDynamicValue ( ValueObject & in_value )

overridevirtual

Implements lldb_private::LanguageRuntime.

Definition at line 120 of file GNUstepObjCRuntime.cpp.

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

◆ CreateExceptionResolver()

BreakpointResolverSP GNUstepObjCRuntime::CreateExceptionResolver	(	const lldb::BreakpointSP &	bkpt,
		bool	catch_bp,
		bool	throw_bp )

overridevirtual

Implements lldb_private::LanguageRuntime.

Definition at line 165 of file GNUstepObjCRuntime.cpp.

References lldb::eLanguageTypeUnknown, lldb_private::eLazyBoolNo, and lldb_private::Breakpoint::Exact.

◆ CreateInstance()

LanguageRuntime * GNUstepObjCRuntime::CreateInstance	(	Process *	process,
		lldb::LanguageType	language )

static

Definition at line 67 of file GNUstepObjCRuntime.cpp.

References lldb::eLanguageTypeObjC, lldb::eSymbolTypeCode, lldb_private::ModuleList::FindSymbolsMatchingRegExAndType(), lldb_private::ModuleList::FindSymbolsWithNameAndType(), lldb_private::Target::GetArchitecture(), lldb_private::Target::GetImages(), lldb_private::SymbolContextList::GetSize(), lldb_private::Process::GetTarget(), lldb_private::ArchSpec::GetTriple(), GNUstepObjCRuntime(), and ScanForGNUstepObjCLibraryCandidate().

Referenced by Initialize(), and Terminate().

◆ CreateObjectChecker()

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

overridevirtual

Implements lldb_private::ObjCLanguageRuntime.

Definition at line 179 of file GNUstepObjCRuntime.cpp.

References lldb_private::Target::CreateUtilityFunction(), lldb::eLanguageTypeC, lldb_private::Runtime::GetTargetRef(), and UNUSED_IF_ASSERT_DISABLED.

◆ FixUpDynamicType()

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

overridevirtual

Implements lldb_private::LanguageRuntime.

Definition at line 135 of file GNUstepObjCRuntime.cpp.

References lldb_private::Flags::AllSet(), lldb_private::TypeAndOrName::GetCompilerType(), lldb_private::ValueObject::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().

◆ GetDynamicTypeAndAddress()

bool GNUstepObjCRuntime::GetDynamicTypeAndAddress	(	ValueObject &	in_value,
		lldb::DynamicValueType	use_dynamic,
		TypeAndOrName &	class_type_or_name,
		Address &	address,
		Value::ValueType &	value_type,
		llvm::ArrayRef< uint8_t > &	local_buffer )

overridevirtual

This call should return true if it could set the name and/or the type Sets address to the address of the dynamic type if value_type is set to a file or load address.

Sets local_buffer to a buffer containing the data of the dynamic type if value_type is set to a host address. Callers should copy local_buffer over into their own buffer if they want to keep the data alive.

Implements lldb_private::LanguageRuntime.

Definition at line 127 of file GNUstepObjCRuntime.cpp.