#include <AppleObjCTrampolineHandler.h>

Classes
class	AppleObjCVTables
struct	DispatchFunction

Public Member Functions
	AppleObjCTrampolineHandler (const lldb::ProcessSP &process_sp, const lldb::ModuleSP &objc_module_sp)
	~AppleObjCTrampolineHandler ()
lldb::ThreadPlanSP	GetStepThroughDispatchPlan (Thread &thread, bool stop_others)
FunctionCaller *	GetLookupImplementationFunctionCaller ()
bool	AddrIsMsgForward (lldb::addr_t addr) const
lldb::addr_t	SetupDispatchFunction (Thread &thread, ValueList &dispatch_values)
const DispatchFunction *	FindDispatchFunction (lldb::addr_t addr)
void	ForEachDispatchFunction (std::function< void(lldb::addr_t, const DispatchFunction &)>)

Private Types
using	MsgsendMap = std::map<lldb::addr_t, int>

Private Attributes
MsgsendMap	m_msgSend_map
MsgsendMap	m_opt_dispatch_map
lldb::ProcessWP	m_process_wp
lldb::ModuleSP	m_objc_module_sp
std::string	m_lookup_implementation_function_code
std::unique_ptr< UtilityFunction >	m_impl_code
std::mutex	m_impl_function_mutex
lldb::addr_t	m_impl_fn_addr
lldb::addr_t	m_impl_stret_fn_addr
lldb::addr_t	m_msg_forward_addr
lldb::addr_t	m_msg_forward_stret_addr
std::unique_ptr< AppleObjCVTables >	m_vtables_up

Static Private Attributes
static const DispatchFunction	g_dispatch_functions []
static const char *	g_opt_dispatch_names []

static const char *	g_lookup_implementation_function_name
	These hold the code for the function that finds the implementation of an ObjC message send given the class & selector and the kind of dispatch.
static const char *	g_lookup_implementation_function_common_code
static const char *	g_lookup_implementation_with_stret_function_code
static const char *	g_lookup_implementation_no_stret_function_code

Detailed Description

Definition at line 21 of file AppleObjCTrampolineHandler.h.

Member Typedef Documentation

◆ MsgsendMap

using lldb_private::AppleObjCTrampolineHandler::MsgsendMap = std::map<lldb::addr_t, int>

private

Definition at line 150 of file AppleObjCTrampolineHandler.h.

Constructor & Destructor Documentation

◆ AppleObjCTrampolineHandler()

AppleObjCTrampolineHandler::AppleObjCTrampolineHandler	(	const lldb::ProcessSP &	process_sp,
		const lldb::ModuleSP &	objc_module_sp )

◆ ~AppleObjCTrampolineHandler()

AppleObjCTrampolineHandler::~AppleObjCTrampolineHandler ( )

default

Member Function Documentation

◆ AddrIsMsgForward()

bool lldb_private::AppleObjCTrampolineHandler::AddrIsMsgForward ( lldb::addr_t addr ) const

inline

Definition at line 33 of file AppleObjCTrampolineHandler.h.

References m_msg_forward_addr, and m_msg_forward_stret_addr.

◆ FindDispatchFunction()

const AppleObjCTrampolineHandler::DispatchFunction * AppleObjCTrampolineHandler::FindDispatchFunction ( lldb::addr_t addr )

Definition at line 774 of file AppleObjCTrampolineHandler.cpp.

References g_dispatch_functions, and m_msgSend_map.

Referenced by GetStepThroughDispatchPlan().

◆ ForEachDispatchFunction()

void AppleObjCTrampolineHandler::ForEachDispatchFunction ( std::function< void(lldb::addr_t, const DispatchFunction &)> )

Definition at line 783 of file AppleObjCTrampolineHandler.cpp.

References g_dispatch_functions, and m_msgSend_map.

Referenced by lldb_private::AppleThreadPlanStepThroughDirectDispatch::AppleThreadPlanStepThroughDirectDispatch().

◆ GetLookupImplementationFunctionCaller()

FunctionCaller * AppleObjCTrampolineHandler::GetLookupImplementationFunctionCaller ( )

Definition at line 1177 of file AppleObjCTrampolineHandler.cpp.

References m_impl_code.

◆ GetStepThroughDispatchPlan()

ThreadPlanSP AppleObjCTrampolineHandler::GetStepThroughDispatchPlan	(	Thread &	thread,
		bool	stop_others )

Definition at line 791 of file AppleObjCTrampolineHandler.cpp.

◆ SetupDispatchFunction()

lldb::addr_t AppleObjCTrampolineHandler::SetupDispatchFunction	(	Thread &	thread,
		ValueList &	dispatch_values )

Member Data Documentation

◆ g_dispatch_functions

const AppleObjCTrampolineHandler::DispatchFunction AppleObjCTrampolineHandler::g_dispatch_functions

staticprivate

Definition at line 147 of file AppleObjCTrampolineHandler.h.

Referenced by AppleObjCTrampolineHandler(), FindDispatchFunction(), and ForEachDispatchFunction().

◆ g_lookup_implementation_function_common_code

const char * AppleObjCTrampolineHandler::g_lookup_implementation_function_common_code

staticprivate

Definition at line 64 of file AppleObjCTrampolineHandler.h.

Referenced by AppleObjCTrampolineHandler().

◆ g_lookup_implementation_function_name

const char * AppleObjCTrampolineHandler::g_lookup_implementation_function_name

staticprivate

Initial value:

=

"__lldb_objc_find_implementation_for_selector"

These hold the code for the function that finds the implementation of an ObjC message send given the class & selector and the kind of dispatch.

There are two variants depending on whether the platform uses a separate _stret passing convention (e.g. Intel) or not (e.g. ARM). The difference is only at the very end of the function, so the code is broken into the common prefix and the suffix, which get composed appropriately before the function gets compiled.

Definition at line 63 of file AppleObjCTrampolineHandler.h.

Referenced by SetupDispatchFunction().

◆ g_lookup_implementation_no_stret_function_code

const char * AppleObjCTrampolineHandler::g_lookup_implementation_no_stret_function_code

staticprivate

Initial value:

=
        R"(
  return_struct.impl_addr =
    class_getMethodImplementation (return_struct.class_addr,
                                   return_struct.sel_addr);
  if (debug)
    printf ("\n*** getMethodImpletation for addr: 0x%p sel: 0x%p result: 0x%p.\n",
            return_struct.class_addr, return_struct.sel_addr, return_struct.impl_addr);
 
  return return_struct.impl_addr;
}
)"

Definition at line 66 of file AppleObjCTrampolineHandler.h.

Referenced by AppleObjCTrampolineHandler().

◆ g_lookup_implementation_with_stret_function_code

const char * AppleObjCTrampolineHandler::g_lookup_implementation_with_stret_function_code

staticprivate

Initial value:

=
        R"(
  if (is_stret) {
    return_struct.impl_addr =
    class_getMethodImplementation_stret (return_struct.class_addr,
                                         return_struct.sel_addr);
  } else {
    return_struct.impl_addr =
        class_getMethodImplementation (return_struct.class_addr,
                                       return_struct.sel_addr);
  }
  if (debug)
    printf ("\n*** Returning implementation: %p.\n",
            return_struct.impl_addr);
 
  return return_struct.impl_addr;
}
)"

Definition at line 65 of file AppleObjCTrampolineHandler.h.

Referenced by AppleObjCTrampolineHandler().

◆ g_opt_dispatch_names

const char * AppleObjCTrampolineHandler::g_opt_dispatch_names

staticprivate

Initial value:

= {
    "objc_alloc",
    "objc_autorelease",
    "objc_release",
    "objc_retain",
    "objc_alloc_init",
    "objc_allocWithZone",
    "objc_opt_class",
    "objc_opt_isKindOfClass",
    "objc_opt_new",
    "objc_opt_respondsToSelector",
    "objc_opt_self",
}