LLDB mainline
Public Member Functions | Private Member Functions | Private Attributes | List of all members
lldb_private::DebuggerThread Class Reference

#include <DebuggerThread.h>

Inheritance diagram for lldb_private::DebuggerThread:
[legend]

Public Member Functions

 DebuggerThread (DebugDelegateSP debug_delegate)
virtual ~DebuggerThread ()
Status DebugLaunch (const ProcessLaunchInfo &launch_info)
Status DebugAttach (lldb::pid_t pid, const ProcessAttachInfo &attach_info)
HostProcess GetProcess () const
HostThread GetMainThread () const
ExceptionRecordSP GetActiveException ()
 Returns the exception the debug loop is currently reporting, or null if there is none.
Status StopDebugging (bool terminate)
void ContinueAsyncException (ExceptionResult result)
void ContinueAsyncDllEvent ()
 Release a HandleLoadDllEvent / HandleUnloadDllEvent that is parked on m_dll_event_pred.

Private Member Functions

void FreeProcessHandles ()
void DebugLoop ()
ExceptionResult HandleExceptionEvent (const EXCEPTION_DEBUG_INFO &info, DWORD thread_id, bool shutting_down)
DWORD HandleCreateThreadEvent (const CREATE_THREAD_DEBUG_INFO &info, DWORD thread_id)
DWORD HandleCreateProcessEvent (const CREATE_PROCESS_DEBUG_INFO &info, DWORD thread_id)
DWORD HandleExitThreadEvent (const EXIT_THREAD_DEBUG_INFO &info, DWORD thread_id)
DWORD HandleExitProcessEvent (const EXIT_PROCESS_DEBUG_INFO &info, DWORD thread_id)
DWORD HandleLoadDllEvent (const LOAD_DLL_DEBUG_INFO &info, DWORD thread_id)
DWORD HandleUnloadDllEvent (const UNLOAD_DLL_DEBUG_INFO &info, DWORD thread_id)
DWORD HandleODSEvent (const OUTPUT_DEBUG_STRING_INFO &info, DWORD thread_id)
DWORD HandleRipEvent (const RIP_INFO &info, DWORD thread_id)
lldb::thread_result_t DebuggerThreadLaunchRoutine (const ProcessLaunchInfo &launch_info)
lldb::thread_result_t DebuggerThreadAttachRoutine (lldb::pid_t pid, const ProcessAttachInfo &launch_info)

Private Attributes

DebugDelegateSP m_debug_delegate
HostProcess m_process
HostThread m_main_thread
HANDLE m_image_file = nullptr
ExceptionRecordSP m_active_exception
std::mutex m_active_exception_mutex
Predicate< ExceptionResult > m_exception_pred
Predicate< bool > m_dll_event_pred
HANDLE m_debugging_ended_event = nullptr
std::atomic< DWORD > m_pid_to_detach
std::atomic< bool > m_is_shutting_down
bool m_detached = false

Detailed Description

Definition at line 28 of file DebuggerThread.h.

Constructor & Destructor Documentation

◆ DebuggerThread()

DebuggerThread::DebuggerThread ( DebugDelegateSP debug_delegate)

Definition at line 71 of file DebuggerThread.cpp.

References InitializeWaitForDebugEvent(), m_debug_delegate, m_debugging_ended_event, m_is_shutting_down, and m_pid_to_detach.

◆ ~DebuggerThread()

DebuggerThread::~DebuggerThread ( )
virtual

Definition at line 78 of file DebuggerThread.cpp.

References m_debugging_ended_event.

Member Function Documentation

◆ ContinueAsyncDllEvent()

void DebuggerThread::ContinueAsyncDllEvent ( )

Release a HandleLoadDllEvent / HandleUnloadDllEvent that is parked on m_dll_event_pred.

The delegate's Resume() path calls this to let the debug loop issue ContinueDebugEvent. Mirrors ContinueAsyncException.

Definition at line 262 of file DebuggerThread.cpp.

References lldb_private::eBroadcastAlways, and m_dll_event_pred.

Referenced by StopDebugging().

◆ ContinueAsyncException()

void DebuggerThread::ContinueAsyncException ( ExceptionResult result)

Definition at line 247 of file DebuggerThread.cpp.

References lldb_private::eBroadcastAlways, lldb_private::Exception, lldb_private::GetLog(), LLDB_LOG, m_active_exception, m_active_exception_mutex, m_exception_pred, m_process, and lldb_private::Process.

Referenced by HandleExceptionEvent(), and StopDebugging().

◆ DebugAttach()

Status DebuggerThread::DebugAttach ( lldb::pid_t pid,
const ProcessAttachInfo & attach_info )

Definition at line 96 of file DebuggerThread.cpp.

References DebuggerThreadAttachRoutine(), lldb_private::Status::FromError(), lldb_private::GetLog(), lldb_private::ThreadLauncher::LaunchThread(), LLDB_LOG, and lldb_private::Process.

◆ DebuggerThreadAttachRoutine()

lldb::thread_result_t DebuggerThread::DebuggerThreadAttachRoutine ( lldb::pid_t pid,
const ProcessAttachInfo & launch_info )
private

Definition at line 141 of file DebuggerThread.cpp.

References DebugLoop(), lldb::eErrorTypeWin32, error(), lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, and lldb_private::Process.

Referenced by DebugAttach().

◆ DebuggerThreadLaunchRoutine()

lldb::thread_result_t DebuggerThread::DebuggerThreadLaunchRoutine ( const ProcessLaunchInfo & launch_info)
private

Definition at line 114 of file DebuggerThread.cpp.

References DebugLoop(), error(), lldb_private::ProcessInfo::GetExecutableFile(), lldb_private::GetLog(), lldb_private::FileSpec::GetPath(), lldb_private::ProcessLauncherWindows::LaunchProcess(), LLDB_LOG, m_debug_delegate, and lldb_private::Process.

Referenced by DebugLaunch().

◆ DebugLaunch()

Status DebuggerThread::DebugLaunch ( const ProcessLaunchInfo & launch_info)

Definition at line 80 of file DebuggerThread.cpp.

References DebuggerThreadLaunchRoutine(), lldb_private::Status::FromError(), lldb_private::ProcessInfo::GetExecutableFile(), lldb_private::GetLog(), lldb_private::FileSpec::GetPath(), lldb_private::ThreadLauncher::LaunchThread(), LLDB_LOG, and lldb_private::Process.

◆ DebugLoop()

void DebuggerThread::DebugLoop ( )
private

Definition at line 275 of file DebuggerThread.cpp.

References lldb_private::Event, FreeProcessHandles(), g_wait_for_debug_event, lldb_private::GetLog(), HandleCreateProcessEvent(), HandleCreateThreadEvent(), HandleExceptionEvent(), HandleExitProcessEvent(), HandleExitThreadEvent(), HandleLoadDllEvent(), HandleODSEvent(), HandleRipEvent(), HandleUnloadDllEvent(), LLDB_LOG, LLDB_LOG_VERBOSE, m_debugging_ended_event, m_detached, m_is_shutting_down, m_pid_to_detach, MaskException, SendToApplication, and STATUS_WX86_BREAKPOINT.

Referenced by DebuggerThreadAttachRoutine(), and DebuggerThreadLaunchRoutine().

◆ FreeProcessHandles()

void DebuggerThread::FreeProcessHandles ( )
private

Definition at line 266 of file DebuggerThread.cpp.

References m_image_file, m_main_thread, and m_process.

Referenced by DebugLoop().

◆ GetActiveException()

ExceptionRecordSP DebuggerThread::GetActiveException ( )

Returns the exception the debug loop is currently reporting, or null if there is none.

Safe to call from any thread.

Definition at line 242 of file DebuggerThread.cpp.

References m_active_exception, and m_active_exception_mutex.

Referenced by StopDebugging().

◆ GetMainThread()

HostThread lldb_private::DebuggerThread::GetMainThread ( ) const
inline

Definition at line 37 of file DebuggerThread.h.

References m_main_thread.

◆ GetProcess()

HostProcess lldb_private::DebuggerThread::GetProcess ( ) const
inline

Definition at line 36 of file DebuggerThread.h.

References m_process.

Referenced by StopDebugging().

◆ HandleCreateProcessEvent()

DWORD DebuggerThread::HandleCreateProcessEvent ( const CREATE_PROCESS_DEBUG_INFO & info,
DWORD thread_id )
private

Definition at line 457 of file DebuggerThread.cpp.

References lldb_private::Event, lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_image_file, m_main_thread, m_process, lldb_private::Process, and lldb_private::HostProcessWindows::SetOwnsHandle().

Referenced by DebugLoop().

◆ HandleCreateThreadEvent()

DWORD DebuggerThread::HandleCreateThreadEvent ( const CREATE_THREAD_DEBUG_INFO & info,
DWORD thread_id )
private

Definition at line 445 of file DebuggerThread.cpp.

References lldb_private::Event, lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_process, and lldb_private::Thread.

Referenced by DebugLoop().

◆ HandleExceptionEvent()

ExceptionResult DebuggerThread::HandleExceptionEvent ( const EXCEPTION_DEBUG_INFO & info,
DWORD thread_id,
bool shutting_down )
private

Definition at line 395 of file DebuggerThread.cpp.

References BreakInDebugger, ContinueAsyncException(), lldb_private::eBroadcastNever, lldb_private::Event, lldb_private::Exception, lldb_private::GetLog(), LLDB_LOG, m_active_exception, m_active_exception_mutex, m_debug_delegate, m_exception_pred, MaskException, SendToApplication, and STATUS_WX86_BREAKPOINT.

Referenced by DebugLoop().

◆ HandleExitProcessEvent()

DWORD DebuggerThread::HandleExitProcessEvent ( const EXIT_PROCESS_DEBUG_INFO & info,
DWORD thread_id )
private

Definition at line 495 of file DebuggerThread.cpp.

References lldb_private::Event, lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_process, and lldb_private::Thread.

Referenced by DebugLoop().

◆ HandleExitThreadEvent()

DWORD DebuggerThread::HandleExitThreadEvent ( const EXIT_THREAD_DEBUG_INFO & info,
DWORD thread_id )
private

Definition at line 485 of file DebuggerThread.cpp.

References lldb_private::Event, lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_process, and lldb_private::Thread.

Referenced by DebugLoop().

◆ HandleLoadDllEvent()

DWORD DebuggerThread::HandleLoadDllEvent ( const LOAD_DLL_DEBUG_INFO & info,
DWORD thread_id )
private

Definition at line 733 of file DebuggerThread.cpp.

References ContinueDebugLoop, lldb_private::eBroadcastNever, lldb_private::Event, GetFileNameByLoadAddress(), GetFileNameFromHandleFallback(), GetFileNameFromImageNameField(), lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_dll_event_pred, m_is_shutting_down, m_process, and ParkDebugLoop.

Referenced by DebugLoop().

◆ HandleODSEvent()

DWORD DebuggerThread::HandleODSEvent ( const OUTPUT_DEBUG_STRING_INFO & info,
DWORD thread_id )
private

Definition at line 809 of file DebuggerThread.cpp.

References m_debug_delegate.

Referenced by DebugLoop().

◆ HandleRipEvent()

DWORD DebuggerThread::HandleRipEvent ( const RIP_INFO & info,
DWORD thread_id )
private

Definition at line 819 of file DebuggerThread.cpp.

References lldb::eErrorTypeWin32, error(), lldb_private::Event, lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, and m_process.

Referenced by DebugLoop().

◆ HandleUnloadDllEvent()

DWORD DebuggerThread::HandleUnloadDllEvent ( const UNLOAD_DLL_DEBUG_INFO & info,
DWORD thread_id )
private

Definition at line 794 of file DebuggerThread.cpp.

References lldb_private::eBroadcastNever, lldb_private::Event, lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_dll_event_pred, m_is_shutting_down, m_process, and ParkDebugLoop.

Referenced by DebugLoop().

◆ StopDebugging()

Status DebuggerThread::StopDebugging ( bool terminate)

Definition at line 165 of file DebuggerThread.cpp.

References ContinueAsyncDllEvent(), ContinueAsyncException(), lldb::eErrorTypeWin32, error(), GetActiveException(), lldb_private::GetLog(), GetProcess(), lldb_private::HostProcess::GetProcessId(), LLDB_INVALID_PROCESS, LLDB_LOG, m_debugging_ended_event, m_is_shutting_down, m_pid_to_detach, m_process, MaskException, lldb_private::Process, and lldb_private::Status.

Member Data Documentation

◆ m_active_exception

ExceptionRecordSP lldb_private::DebuggerThread::m_active_exception
private

Definition at line 80 of file DebuggerThread.h.

Referenced by ContinueAsyncException(), GetActiveException(), and HandleExceptionEvent().

◆ m_active_exception_mutex

std::mutex lldb_private::DebuggerThread::m_active_exception_mutex
private

Definition at line 81 of file DebuggerThread.h.

Referenced by ContinueAsyncException(), GetActiveException(), and HandleExceptionEvent().

◆ m_debug_delegate

DebugDelegateSP lldb_private::DebuggerThread::m_debug_delegate
private

Definition at line 71 of file DebuggerThread.h.

Referenced by DebuggerThread(), DebuggerThreadAttachRoutine(), DebuggerThreadLaunchRoutine(), HandleCreateProcessEvent(), HandleCreateThreadEvent(), HandleExceptionEvent(), HandleExitProcessEvent(), HandleExitThreadEvent(), HandleLoadDllEvent(), HandleODSEvent(), HandleRipEvent(), and HandleUnloadDllEvent().

◆ m_debugging_ended_event

HANDLE lldb_private::DebuggerThread::m_debugging_ended_event = nullptr
private

Definition at line 93 of file DebuggerThread.h.

Referenced by DebuggerThread(), DebugLoop(), StopDebugging(), and ~DebuggerThread().

◆ m_detached

bool lldb_private::DebuggerThread::m_detached = false
private

Definition at line 104 of file DebuggerThread.h.

Referenced by DebugLoop().

◆ m_dll_event_pred

Predicate<bool> lldb_private::DebuggerThread::m_dll_event_pred
private

Definition at line 89 of file DebuggerThread.h.

Referenced by ContinueAsyncDllEvent(), HandleLoadDllEvent(), and HandleUnloadDllEvent().

◆ m_exception_pred

Predicate<ExceptionResult> lldb_private::DebuggerThread::m_exception_pred
private

Definition at line 85 of file DebuggerThread.h.

Referenced by ContinueAsyncException(), and HandleExceptionEvent().

◆ m_image_file

HANDLE lldb_private::DebuggerThread::m_image_file = nullptr
private

Definition at line 77 of file DebuggerThread.h.

Referenced by FreeProcessHandles(), and HandleCreateProcessEvent().

◆ m_is_shutting_down

std::atomic<bool> lldb_private::DebuggerThread::m_is_shutting_down
private

Definition at line 100 of file DebuggerThread.h.

Referenced by DebuggerThread(), DebugLoop(), HandleLoadDllEvent(), HandleUnloadDllEvent(), and StopDebugging().

◆ m_main_thread

HostThread lldb_private::DebuggerThread::m_main_thread
private

Definition at line 74 of file DebuggerThread.h.

Referenced by FreeProcessHandles(), GetMainThread(), and HandleCreateProcessEvent().

◆ m_pid_to_detach

std::atomic<DWORD> lldb_private::DebuggerThread::m_pid_to_detach
private

Definition at line 96 of file DebuggerThread.h.

Referenced by DebuggerThread(), DebugLoop(), and StopDebugging().

◆ m_process

HostProcess lldb_private::DebuggerThread::m_process
private

Definition at line 73 of file DebuggerThread.h.

Referenced by ContinueAsyncException(), FreeProcessHandles(), GetProcess(), HandleCreateProcessEvent(), HandleCreateThreadEvent(), HandleExitProcessEvent(), HandleExitThreadEvent(), HandleLoadDllEvent(), HandleRipEvent(), HandleUnloadDllEvent(), and StopDebugging().

The documentation for this class was generated from the following files:
Generated on for LLDB by doxygen 1.14.0