diff options
Diffstat (limited to 'lldb/source/Plugins/SystemRuntime/MacOSX/AppleGetThreadItemInfoHandler.h')
-rw-r--r-- | lldb/source/Plugins/SystemRuntime/MacOSX/AppleGetThreadItemInfoHandler.h | 135 |
1 files changed, 70 insertions, 65 deletions
diff --git a/lldb/source/Plugins/SystemRuntime/MacOSX/AppleGetThreadItemInfoHandler.h b/lldb/source/Plugins/SystemRuntime/MacOSX/AppleGetThreadItemInfoHandler.h index 21a63e8c225..f7804de4089 100644 --- a/lldb/source/Plugins/SystemRuntime/MacOSX/AppleGetThreadItemInfoHandler.h +++ b/lldb/source/Plugins/SystemRuntime/MacOSX/AppleGetThreadItemInfoHandler.h @@ -1,4 +1,5 @@ -//===-- AppleGetThreadItemInfoHandler.h ----------------------------*- C++ -*-===// +//===-- AppleGetThreadItemInfoHandler.h ----------------------------*- C++ +//-*-===// // // The LLVM Compiler Infrastructure // @@ -18,12 +19,13 @@ // Other libraries and framework includes // Project includes -#include "lldb/lldb-public.h" #include "lldb/Core/Error.h" #include "lldb/Symbol/CompilerType.h" +#include "lldb/lldb-public.h" // This class will insert a UtilityFunction into the inferior process for -// calling libBacktraceRecording's __introspection_dispatch_thread_get_item_info() +// calling libBacktraceRecording's +// __introspection_dispatch_thread_get_item_info() // function. The function in the inferior will return a struct by value // with these members: // @@ -35,79 +37,82 @@ // // The item_buffer pointer is an address in the inferior program's address // space (item_buffer_size in size) which must be mach_vm_deallocate'd by -// lldb. +// lldb. // -// The AppleGetThreadItemInfoHandler object should persist so that the UtilityFunction +// The AppleGetThreadItemInfoHandler object should persist so that the +// UtilityFunction // can be reused multiple times. -namespace lldb_private -{ +namespace lldb_private { class AppleGetThreadItemInfoHandler { public: - - AppleGetThreadItemInfoHandler (lldb_private::Process *process); - - ~AppleGetThreadItemInfoHandler(); - - struct GetThreadItemInfoReturnInfo - { - lldb::addr_t item_buffer_ptr; /* the address of the item buffer from libBacktraceRecording */ - lldb::addr_t item_buffer_size; /* the size of the item buffer from libBacktraceRecording */ - - GetThreadItemInfoReturnInfo() : - item_buffer_ptr(LLDB_INVALID_ADDRESS), - item_buffer_size(0) - {} - }; - - //---------------------------------------------------------- - /// Get the information about a work item by calling - /// __introspection_dispatch_thread_get_item_info. If there's a page of - /// memory that needs to be freed, pass in the address and size and it will - /// be freed before getting the list of queues. - /// - /// @param [in] thread_id - /// The thread to get the extended backtrace for. - /// - /// @param [in] page_to_free - /// An address of an inferior process vm page that needs to be deallocated, - /// LLDB_INVALID_ADDRESS if this is not needed. - /// - /// @param [in] page_to_free_size - /// The size of the vm page that needs to be deallocated if an address was - /// passed in to page_to_free. - /// - /// @param [out] error - /// This object will be updated with the error status / error string from any failures encountered. - /// - /// @returns - /// The result of the inferior function call execution. If there was a failure of any kind while getting - /// the information, the item_buffer_ptr value will be LLDB_INVALID_ADDRESS. - //---------------------------------------------------------- - GetThreadItemInfoReturnInfo - GetThreadItemInfo (Thread &thread, lldb::tid_t thread_id, lldb::addr_t page_to_free, uint64_t page_to_free_size, lldb_private::Error &error); - - - void - Detach (); + AppleGetThreadItemInfoHandler(lldb_private::Process *process); + + ~AppleGetThreadItemInfoHandler(); + + struct GetThreadItemInfoReturnInfo { + lldb::addr_t item_buffer_ptr; /* the address of the item buffer from + libBacktraceRecording */ + lldb::addr_t item_buffer_size; /* the size of the item buffer from + libBacktraceRecording */ + + GetThreadItemInfoReturnInfo() + : item_buffer_ptr(LLDB_INVALID_ADDRESS), item_buffer_size(0) {} + }; + + //---------------------------------------------------------- + /// Get the information about a work item by calling + /// __introspection_dispatch_thread_get_item_info. If there's a page of + /// memory that needs to be freed, pass in the address and size and it will + /// be freed before getting the list of queues. + /// + /// @param [in] thread_id + /// The thread to get the extended backtrace for. + /// + /// @param [in] page_to_free + /// An address of an inferior process vm page that needs to be + /// deallocated, + /// LLDB_INVALID_ADDRESS if this is not needed. + /// + /// @param [in] page_to_free_size + /// The size of the vm page that needs to be deallocated if an address was + /// passed in to page_to_free. + /// + /// @param [out] error + /// This object will be updated with the error status / error string from + /// any failures encountered. + /// + /// @returns + /// The result of the inferior function call execution. If there was a + /// failure of any kind while getting + /// the information, the item_buffer_ptr value will be + /// LLDB_INVALID_ADDRESS. + //---------------------------------------------------------- + GetThreadItemInfoReturnInfo GetThreadItemInfo(Thread &thread, + lldb::tid_t thread_id, + lldb::addr_t page_to_free, + uint64_t page_to_free_size, + lldb_private::Error &error); + + void Detach(); private: + lldb::addr_t + SetupGetThreadItemInfoFunction(Thread &thread, + ValueList &get_thread_item_info_arglist); - lldb::addr_t - SetupGetThreadItemInfoFunction (Thread &thread, ValueList &get_thread_item_info_arglist); - - static const char *g_get_thread_item_info_function_name; - static const char *g_get_thread_item_info_function_code; + static const char *g_get_thread_item_info_function_name; + static const char *g_get_thread_item_info_function_code; - lldb_private::Process *m_process; - std::unique_ptr<UtilityFunction> m_get_thread_item_info_impl_code; - std::mutex m_get_thread_item_info_function_mutex; + lldb_private::Process *m_process; + std::unique_ptr<UtilityFunction> m_get_thread_item_info_impl_code; + std::mutex m_get_thread_item_info_function_mutex; - lldb::addr_t m_get_thread_item_info_return_buffer_addr; - std::mutex m_get_thread_item_info_retbuffer_mutex; + lldb::addr_t m_get_thread_item_info_return_buffer_addr; + std::mutex m_get_thread_item_info_retbuffer_mutex; }; -} // using namespace lldb_private +} // using namespace lldb_private -#endif // lldb_AppleGetThreadItemInfoHandler_h_ +#endif // lldb_AppleGetThreadItemInfoHandler_h_ |