#include <DebuggerThread.h>

Inheritance diagram for lldb_private::DebuggerThread:

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
const std::string &	GetImagePath () const
	The path the process was created with, as recorded in its process parameters, or an empty string if it could not be read.
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	ReportDeferredStopAndWaitForResume ()
	Have the delegate report the stop it collected, then wait until the client resumes before taking the next debug event.
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
Guarded< HostProcess >	m_process
HostThread	m_main_thread
HANDLE	m_image_file = nullptr
std::string	m_image_path
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 29 of file DebuggerThread.h.

Constructor & Destructor Documentation

◆ DebuggerThread()

DebuggerThread::DebuggerThread ( DebugDelegateSP debug_delegate )

Definition at line 74 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 81 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 271 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 249 of file DebuggerThread.cpp.

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

Referenced by HandleExceptionEvent(), and StopDebugging().

◆ DebugAttach()

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

Definition at line 99 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 144 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 117 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 83 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

◆ FreeProcessHandles()

void DebuggerThread::FreeProcessHandles ( )

private

Definition at line 275 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 244 of file DebuggerThread.cpp.

References m_active_exception, and m_active_exception_mutex.

Referenced by StopDebugging().

◆ GetImagePath()

const std::string & lldb_private::DebuggerThread::GetImagePath ( ) const

inline

The path the process was created with, as recorded in its process parameters, or an empty string if it could not be read.

Set by the create-process event.

Definition at line 43 of file DebuggerThread.h.

References m_image_path.

◆ GetMainThread()

HostThread lldb_private::DebuggerThread::GetMainThread ( ) const

inline

Definition at line 38 of file DebuggerThread.h.

References m_main_thread.

◆ GetProcess()

HostProcess lldb_private::DebuggerThread::GetProcess ( ) const

inline

Definition at line 37 of file DebuggerThread.h.

References m_process.

Referenced by ContinueAsyncException(), DebugLoop(), HandleCreateThreadEvent(), HandleExitProcessEvent(), HandleExitThreadEvent(), HandleLoadDllEvent(), HandleRipEvent(), HandleUnloadDllEvent(), and StopDebugging().

◆ HandleCreateProcessEvent()

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

private

Definition at line 546 of file DebuggerThread.cpp.

References lldb_private::Event, GetImagePathFromPEB(), lldb_private::GetLog(), LLDB_LOG, m_debug_delegate, m_image_file, m_image_path, 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 491 of file DebuggerThread.cpp.

References lldb_private::Event, lldb_private::GetLog(), GetProcess(), LLDB_LOG, m_debug_delegate, 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 439 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 588 of file DebuggerThread.cpp.

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

Referenced by DebugLoop().

◆ HandleExitThreadEvent()

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

private

Definition at line 578 of file DebuggerThread.cpp.

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

Referenced by DebugLoop().

◆ HandleLoadDllEvent()

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

private

◆ HandleODSEvent()

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

private

Definition at line 926 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 936 of file DebuggerThread.cpp.

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

Referenced by DebugLoop().

◆ HandleUnloadDllEvent()

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

private

Definition at line 909 of file DebuggerThread.cpp.

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

Referenced by DebugLoop().

◆ ReportDeferredStopAndWaitForResume()

void DebuggerThread::ReportDeferredStopAndWaitForResume ( )

private

Have the delegate report the stop it collected, then wait until the client resumes before taking the next debug event.

Definition at line 264 of file DebuggerThread.cpp.

References lldb_private::eBroadcastNever, m_debug_delegate, m_dll_event_pred, and m_is_shutting_down.

Referenced by DebugLoop().

◆ StopDebugging()

Status DebuggerThread::StopDebugging ( bool terminate )

Member Data Documentation

◆ m_active_exception

ExceptionRecordSP lldb_private::DebuggerThread::m_active_exception

private

Definition at line 91 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 92 of file DebuggerThread.h.

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

◆ m_debug_delegate

DebugDelegateSP lldb_private::DebuggerThread::m_debug_delegate

private

Definition at line 81 of file DebuggerThread.h.

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

◆ m_debugging_ended_event

HANDLE lldb_private::DebuggerThread::m_debugging_ended_event = nullptr

private

Definition at line 104 of file DebuggerThread.h.

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

◆ m_detached

bool lldb_private::DebuggerThread::m_detached = false

private

Definition at line 115 of file DebuggerThread.h.

Referenced by DebugLoop().

◆ m_dll_event_pred

Predicate<bool> lldb_private::DebuggerThread::m_dll_event_pred

private

Definition at line 100 of file DebuggerThread.h.

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

◆ m_exception_pred

Predicate<ExceptionResult> lldb_private::DebuggerThread::m_exception_pred

private

Definition at line 96 of file DebuggerThread.h.

Referenced by ContinueAsyncException(), and HandleExceptionEvent().

◆ m_image_file

HANDLE lldb_private::DebuggerThread::m_image_file = nullptr

private

Definition at line 87 of file DebuggerThread.h.

Referenced by FreeProcessHandles(), and HandleCreateProcessEvent().

◆ m_image_path

std::string lldb_private::DebuggerThread::m_image_path

private

Definition at line 88 of file DebuggerThread.h.

Referenced by GetImagePath(), and HandleCreateProcessEvent().

◆ m_is_shutting_down

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

private

Definition at line 111 of file DebuggerThread.h.

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

◆ m_main_thread

HostThread lldb_private::DebuggerThread::m_main_thread

private

Definition at line 84 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 107 of file DebuggerThread.h.

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

◆ m_process

Guarded<HostProcess> lldb_private::DebuggerThread::m_process

private

Definition at line 83 of file DebuggerThread.h.

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

The documentation for this class was generated from the following files:

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ DebuggerThread()

◆ ~DebuggerThread()

Member Function Documentation

◆ ContinueAsyncDllEvent()

◆ ContinueAsyncException()

◆ DebugAttach()

◆ DebuggerThreadAttachRoutine()

◆ DebuggerThreadLaunchRoutine()

◆ DebugLaunch()

◆ DebugLoop()

◆ FreeProcessHandles()

◆ GetActiveException()

◆ GetImagePath()

◆ GetMainThread()

◆ GetProcess()

◆ HandleCreateProcessEvent()

◆ HandleCreateThreadEvent()

◆ HandleExceptionEvent()

◆ HandleExitProcessEvent()

◆ HandleExitThreadEvent()

◆ HandleLoadDllEvent()

◆ HandleODSEvent()

◆ HandleRipEvent()

◆ HandleUnloadDllEvent()

◆ ReportDeferredStopAndWaitForResume()

◆ StopDebugging()

Member Data Documentation

◆ m_active_exception

◆ m_active_exception_mutex

◆ m_debug_delegate

◆ m_debugging_ended_event

◆ m_detached

◆ m_dll_event_pred

◆ m_exception_pred

◆ m_image_file

◆ m_image_path

◆ m_is_shutting_down

◆ m_main_thread

◆ m_pid_to_detach

◆ m_process