#include <NativeProcessWindows.h>

Inheritance diagram for lldb_private::NativeProcessWindows:

Classes
class	Manager

Public Member Functions
	~NativeProcessWindows () override
Status	Resume (const ResumeActionList &resume_actions) override
Status	Halt () override
Status	Detach () override
Status	Signal (int signo) override
	Sends a process a UNIX signal signal.
Status	Interrupt () override
	Tells a process to interrupt all operations as if by a Ctrl-C.
Status	Kill () override
Status	IgnoreSignals (llvm::ArrayRef< int > signals) override
Status	GetMemoryRegionInfo (lldb::addr_t load_addr, MemoryRegionInfo &range_info) override
Status	ReadMemory (lldb::addr_t addr, void *buf, size_t size, size_t &bytes_read) override
Status	WriteMemory (lldb::addr_t addr, const void *buf, size_t size, size_t &bytes_written) override
llvm::Expected< lldb::addr_t >	AllocateMemory (size_t size, uint32_t permissions) override
llvm::Error	DeallocateMemory (lldb::addr_t addr) override
lldb::addr_t	GetSharedLibraryInfoAddress () override
bool	IsAlive () const override
size_t	UpdateThreads () override
const ArchSpec &	GetArchitecture () const override
void	SetArchitecture (const ArchSpec &arch_spec)
Status	SetBreakpoint (lldb::addr_t addr, uint32_t size, bool hardware) override
Status	RemoveBreakpoint (lldb::addr_t addr, bool hardware=false) override
llvm::ErrorOr< std::unique_ptr< llvm::MemoryBuffer > >	GetAuxvData () const override
Status	GetLoadedModuleFileSpec (const char *module_path, FileSpec &file_spec) override
Status	GetFileLoadAddress (const llvm::StringRef &file_name, lldb::addr_t &load_addr) override
llvm::Expected< std::vector< LoadedLibraryInfo > >	GetLoadedLibraries () override
	Return the currently loaded libraries of the target in the qXfer:libraries:read form (generic name + base address pairs; used on Windows, where the inferior is not SVR4 and the module list comes from the PE loader).
bool	HasPendingLibraryEvents () override
size_t	WriteStdin (const void *buf, size_t len, Status &error) override
	Forward bytes from the gdb-remote I packet into the inferior's ConPTY-backed stdin via m_stdio_communication.Write → ConnectionConPTY::Write → WriteFile on the parent-side STDIN HANDLE.
void	OnExitProcess (uint32_t exit_code) override
void	OnDebuggerConnected (lldb::addr_t image_base) override
ExceptionResult	OnDebugException (bool first_chance, const ExceptionRecord &record) override
void	OnCreateThread (const HostThread &thread) override
void	OnExitThread (lldb::tid_t thread_id, uint32_t exit_code) override
void	OnLoadDll (const ModuleSpec &module_spec, lldb::addr_t module_addr) override
void	OnUnloadDll (lldb::addr_t module_addr) override
void	OnDebugString (lldb::addr_t debug_string_addr, bool is_unicode, uint16_t length_lower_word) override
Public Member Functions inherited from lldb_private::NativeProcessProtocol
virtual	~NativeProcessProtocol ()=default
Status	ReadMemoryWithoutTrap (lldb::addr_t addr, void *buf, size_t size, size_t &bytes_read)
virtual Status	ReadMemoryTags (int32_t type, lldb::addr_t addr, size_t len, std::vector< uint8_t > &tags)
virtual Status	WriteMemoryTags (int32_t type, lldb::addr_t addr, size_t len, const std::vector< uint8_t > &tags)
llvm::Expected< llvm::StringRef >	ReadCStringFromMemory (lldb::addr_t addr, char *buffer, size_t max_size, size_t &total_bytes_read)
	Reads a null terminated string from memory.
virtual llvm::Expected< std::vector< SVR4LibraryInfo > >	GetLoadedSVR4Libraries ()
bool	HasSoftwareBreakpoint (lldb::addr_t addr)
virtual const HardwareBreakpointMap &	GetHardwareBreakpointMap () const
virtual Status	SetHardwareBreakpoint (lldb::addr_t addr, size_t size)
virtual Status	RemoveHardwareBreakpoint (lldb::addr_t addr)
virtual const NativeWatchpointList::WatchpointMap &	GetWatchpointMap () const
virtual std::optional< std::pair< uint32_t, uint32_t > >	GetHardwareDebugSupportInfo () const
virtual Status	SetWatchpoint (lldb::addr_t addr, size_t size, uint32_t watch_flags, bool hardware)
virtual Status	RemoveWatchpoint (lldb::addr_t addr)
lldb::pid_t	GetID () const
lldb::StateType	GetState () const
bool	IsRunning () const
bool	IsStepping () const
bool	CanResume () const
lldb::ByteOrder	GetByteOrder () const
uint32_t	GetAddressByteSize () const
virtual std::optional< WaitStatus >	GetExitStatus ()
virtual bool	SetExitStatus (WaitStatus status, bool bNotifyStateChange)
NativeThreadProtocol *	GetThreadAtIndex (uint32_t idx)
NativeThreadProtocol *	GetThreadByID (lldb::tid_t tid)
void	SetCurrentThreadID (lldb::tid_t tid)
lldb::tid_t	GetCurrentThreadID () const
NativeThreadProtocol *	GetCurrentThread ()
ThreadIterable	Threads () const
virtual int	GetTerminalFileDescriptor ()
uint32_t	GetStopID () const
virtual void	NotifyTracersProcessWillResume ()
	Notify tracers that the target process will resume.
virtual void	NotifyTracersProcessDidStop ()
	Notify tracers that the target process just stopped.
virtual llvm::Error	TraceStart (llvm::StringRef json_params, llvm::StringRef type)
	Start tracing a process or its threads.
virtual llvm::Error	TraceStop (const TraceStopRequest &request)
	Stop tracing a live process or its threads.
virtual llvm::Expected< llvm::json::Value >	TraceGetState (llvm::StringRef type)
	Get the current tracing state of the process and its threads.
virtual llvm::Expected< std::vector< uint8_t > >	TraceGetBinaryData (const TraceGetBinaryDataRequest &request)
	Get binary data given a trace technology and a data identifier.
virtual llvm::Expected< TraceSupportedResponse >	TraceSupported ()
	Get the processor tracing type supported for this process.
virtual void	SetEnabledExtensions (Extension flags)
	Method called in order to propagate the bitmap of protocol extensions supported by the client.
virtual llvm::Expected< std::string >	SaveCore (llvm::StringRef path_hint)
	Write a core dump (without crashing the program).
virtual std::vector< std::string >	GetStructuredDataPlugins ()
	Get the list of structured data plugins supported by this process.
Public Member Functions inherited from lldb_private::ProcessDebugger
virtual	~ProcessDebugger ()
virtual void	OnDebuggerError (const Status &error, uint32_t type)

Protected Member Functions
NativeThreadWindows *	GetThreadByID (lldb::tid_t thread_id)
llvm::Expected< llvm::ArrayRef< uint8_t > >	GetSoftwareBreakpointTrapOpcode (size_t size_hint) override
size_t	GetSoftwareBreakpointPCOffset () override
	Return the offset of the PC relative to the software breakpoint that was hit.
bool	FindSoftwareBreakpoint (lldb::addr_t addr)
void	StopThread (lldb::tid_t thread_id, lldb::StopReason reason, std::string description="")
void	SetStopReasonForThread (NativeThreadWindows &thread, lldb::StopReason reason, std::string description="")
Protected Member Functions inherited from lldb_private::NativeProcessProtocol
	NativeProcessProtocol (lldb::pid_t pid, int terminal_fd, NativeDelegate &delegate)
void	SetID (lldb::pid_t pid)
void	SetState (lldb::StateType state, bool notify_delegates=true)
virtual void	DoStopIDBumped (uint32_t newBumpId)
Status	SetSoftwareBreakpoint (lldb::addr_t addr, uint32_t size_hint)
Status	RemoveSoftwareBreakpoint (lldb::addr_t addr)
void	FixupBreakpointPCAsNeeded (NativeThreadProtocol &thread)
virtual void	NotifyDidExec ()
	Notify the delegate that an exec occurred.
NativeThreadProtocol *	GetThreadByIDUnlocked (lldb::tid_t tid)
Protected Member Functions inherited from lldb_private::ProcessDebugger
Status	DetachProcess ()
Status	LaunchProcess (ProcessLaunchInfo &launch_info, DebugDelegateSP delegate)
Status	AttachProcess (lldb::pid_t pid, const ProcessAttachInfo &attach_info, DebugDelegateSP delegate)
Status	DestroyProcess (lldb::StateType process_state)
Status	HaltProcess (bool &caused_stop)
Status	GetMemoryRegionInfo (lldb::addr_t load_addr, MemoryRegionInfo &range_info)
Status	ReadMemory (lldb::addr_t addr, void *buf, size_t size, size_t &bytes_read)
llvm::Error	ReadDebugString (lldb::addr_t debug_string_addr, bool is_unicode, uint16_t length_lower_word, llvm::SmallVectorImpl< char > &output)
	Read an OUTPUT_DEBUG_STRING_INFO payload from the inferior.
Status	WriteMemory (lldb::addr_t addr, const void *buf, size_t size, size_t &bytes_written)
Status	AllocateMemory (size_t size, uint32_t permissions, lldb::addr_t &addr)
Status	DeallocateMemory (lldb::addr_t addr)
lldb::pid_t	GetDebuggedProcessId () const
Status	WaitForDebuggerConnection (DebuggerThreadSP debugger, HostProcess &process)

Private Member Functions
	NativeProcessWindows (ProcessLaunchInfo &launch_info, NativeDelegate &delegate, llvm::Error &E)
	NativeProcessWindows (lldb::pid_t pid, int terminal_fd, NativeDelegate &delegate, llvm::Error &E)
ExceptionResult	HandleSingleStepException (const ExceptionRecord &record)
ExceptionResult	HandleBreakpointException (const ExceptionRecord &record)
ExceptionResult	HandleGenericException (bool first_chance, const ExceptionRecord &record)
Status	CacheLoadedModules ()
void	StartStdioForwarding ()
	Wire up m_stdio_communication on m_pty's STDOUT HANDLE.
void	StopStdioForwarding ()
	Tear down the read thread and disconnect m_stdio_communication.

Static Private Member Functions
static void	STDIOReadThreadBytesReceived (void baton, const void src, size_t src_len)
	Bridge between m_stdio_communication's read thread and NativeDelegate::NewProcessOutput.

Private Attributes
ArchSpec	m_arch
std::map< lldb_private::FileSpec, lldb::addr_t >	m_loaded_modules
bool	m_pending_library_events = true
	Set whenever an OS DLL load/unload event has been seen since the last stop reply.
bool	m_initial_stop_seen = false
	Whether we've seen the loader breakpoint that fires once per process at launch / attach.
bool	m_pending_halt = false
	Set when Halt() / Interrupt() schedules a DebugBreakProcess injection.
std::shared_ptr< PseudoConsole >	m_pty
	PseudoConsole for the lldb-server stdio-forwarding path.
ThreadedCommunication	m_stdio_communication
	Wraps a ConnectionConPTY around the PTY's parent-side STDOUT HANDLE.

Additional Inherited Members
Public Types inherited from lldb_private::NativeProcessProtocol
enum class	Extension { multiprocess = (1u << 0) , fork = (1u << 1) , vfork = (1u << 2) , pass_signals = (1u << 3) , auxv = (1u << 4) , libraries_svr4 = (1u << 5) , memory_tagging = (1u << 6) , savecore = (1u << 7) , siginfo_read = (1u << 8) , libraries = (1u << 9) , accelerator_plugins = (1u << 10) }
	Extension flag constants, returned by Manager::GetSupportedExtensions() and passed to SetEnabledExtension() More...
typedef std::vector< std::unique_ptr< NativeThreadProtocol > >	thread_collection
typedef LockingAdaptedIterable< std::recursive_mutex, thread_collection, llvm::pointee_iterator< thread_collection::const_iterator > >	ThreadIterable
Protected Attributes inherited from lldb_private::NativeProcessProtocol
std::unordered_map< lldb::addr_t, SoftwareBreakpoint >	m_software_breakpoints
lldb::pid_t	m_pid
std::vector< std::unique_ptr< NativeThreadProtocol > >	m_threads
lldb::tid_t	m_current_thread_id = LLDB_INVALID_THREAD_ID
std::recursive_mutex	m_threads_mutex
lldb::StateType	m_state = lldb::eStateInvalid
std::recursive_mutex	m_state_mutex
std::optional< WaitStatus >	m_exit_status
NativeDelegate &	m_delegate
NativeWatchpointList	m_watchpoint_list
HardwareBreakpointMap	m_hw_breakpoints_map
int	m_terminal_fd
uint32_t	m_stop_id = 0
llvm::DenseSet< int >	m_signals_to_ignore
Extension	m_enabled_extensions
Protected Attributes inherited from lldb_private::ProcessDebugger
llvm::sys::Mutex	m_mutex
std::unique_ptr< ProcessWindowsData >	m_session_data

Detailed Description

Definition at line 32 of file NativeProcessWindows.h.

Constructor & Destructor Documentation

◆ ~NativeProcessWindows()

lldb_private::NativeProcessWindows::~NativeProcessWindows ( )

override

Definition at line 778 of file NativeProcessWindows.cpp.

References StopStdioForwarding().

◆ NativeProcessWindows() [1/2]

lldb_private::NativeProcessWindows::NativeProcessWindows	(	ProcessLaunchInfo &	launch_info,
		NativeDelegate &	delegate,
		llvm::Error &	E )

private

Definition at line 53 of file NativeProcessWindows.cpp.

References GetArchitecture(), lldb_private::ProcessDebugger::GetDebuggedProcessId(), lldb_private::ProcessDebugger::LaunchProcess(), LLDB_INVALID_PROCESS_ID, m_arch, m_pty, m_stdio_communication, lldb_private::NativeProcessProtocol::NativeProcessProtocol(), lldb_private::NativeProcessProtocol::SetID(), StartStdioForwarding(), lldb_private::ProcessLaunchInfo::TakePTY(), and lldb_private::Status::ToError().

Referenced by lldb_private::NativeProcessWindows::Manager::Attach(), lldb_private::NativeProcessWindows::Manager::Launch(), and STDIOReadThreadBytesReceived().

◆ NativeProcessWindows() [2/2]

lldb_private::NativeProcessWindows::NativeProcessWindows	(	lldb::pid_t	pid,
		int	terminal_fd,
		NativeDelegate &	delegate,
		llvm::Error &	E )

private

Definition at line 74 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::AttachProcess(), lldb_private::ProcessInfo::GetArchitecture(), lldb_private::ProcessDebugger::GetDebuggedProcessId(), lldb_private::Host::GetProcessInfo(), m_arch, m_stdio_communication, lldb_private::NativeProcessProtocol::NativeProcessProtocol(), lldb_private::NativeProcessProtocol::SetID(), lldb_private::ProcessInfo::SetProcessID(), and lldb_private::Status::ToError().

Member Function Documentation

◆ AllocateMemory()

llvm::Expected< lldb::addr_t > lldb_private::NativeProcessWindows::AllocateMemory	(	size_t	size,
		uint32_t	permissions )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 242 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::AllocateMemory(), lldb_private::Status::Success(), and lldb_private::Status::ToError().

◆ CacheLoadedModules()

Status lldb_private::NativeProcessWindows::CacheLoadedModules ( )

private

Definition at line 355 of file NativeProcessWindows.cpp.

References lldb::eErrorTypeWin32, error(), lldb_private::AutoHandle::get(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::FileSystem::Instance(), lldb_private::AutoHandle::IsValid(), m_loaded_modules, lldb_private::FileSystem::Resolve(), and lldb_private::Status.

Referenced by GetFileLoadAddress(), GetLoadedLibraries(), and GetLoadedModuleFileSpec().

◆ DeallocateMemory()

llvm::Error lldb_private::NativeProcessWindows::DeallocateMemory ( lldb::addr_t addr )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 250 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::DeallocateMemory(), and lldb_private::Status::ToError().

◆ Detach()

Status lldb_private::NativeProcessWindows::Detach ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 188 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::DetachProcess(), error(), lldb::eStateDetached, lldb::eStateExited, lldb_private::Status::FromErrorStringWithFormatv(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::GetLog(), lldb_private::NativeProcessProtocol::GetState(), LLDB_LOG, lldb_private::Process, and lldb_private::NativeProcessProtocol::SetState().

◆ FindSoftwareBreakpoint()

bool lldb_private::NativeProcessWindows::FindSoftwareBreakpoint ( lldb::addr_t addr )

protected

Definition at line 337 of file NativeProcessWindows.cpp.

References lldb_private::NativeProcessProtocol::m_software_breakpoints.

Referenced by HandleBreakpointException().

◆ GetArchitecture()

const ArchSpec & lldb_private::NativeProcessWindows::GetArchitecture ( ) const

inlineoverridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 88 of file NativeProcessWindows.h.

References m_arch.

Referenced by GetSoftwareBreakpointTrapOpcode(), NativeProcessWindows(), lldb_private::NativeThreadWindows::NativeThreadWindows(), and OnDebuggerConnected().

◆ GetAuxvData()

llvm::ErrorOr< std::unique_ptr< llvm::MemoryBuffer > > lldb_private::NativeProcessWindows::GetAuxvData ( ) const

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 307 of file NativeProcessWindows.cpp.

◆ GetFileLoadAddress()

Status lldb_private::NativeProcessWindows::GetFileLoadAddress	(	const llvm::StringRef &	file_name,
		lldb::addr_t &	load_addr )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 405 of file NativeProcessWindows.cpp.

References CacheLoadedModules(), error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::FileSpec::GetPath(), lldb_private::FileSystem::Instance(), LLDB_INVALID_ADDRESS, m_loaded_modules, lldb_private::FileSystem::Resolve(), and lldb_private::Status.

◆ GetLoadedLibraries()

llvm::Expected< std::vector< LoadedLibraryInfo > > lldb_private::NativeProcessWindows::GetLoadedLibraries ( )

overridevirtual

Return the currently loaded libraries of the target in the qXfer:libraries:read form (generic name + base address pairs; used on Windows, where the inferior is not SVR4 and the module list comes from the PE loader).

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 426 of file NativeProcessWindows.cpp.

References lldb_private::LoadedLibraryInfo::base_addr, CacheLoadedModules(), error(), m_loaded_modules, and lldb_private::LoadedLibraryInfo::name.

◆ GetLoadedModuleFileSpec()

Status lldb_private::NativeProcessWindows::GetLoadedModuleFileSpec	(	const char *	module_path,
		FileSpec &	file_spec )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 385 of file NativeProcessWindows.cpp.

References CacheLoadedModules(), error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::FileSpec::GetPath(), lldb_private::FileSystem::Instance(), m_loaded_modules, lldb_private::FileSystem::Resolve(), and lldb_private::Status.

◆ GetMemoryRegionInfo()

Status lldb_private::NativeProcessWindows::GetMemoryRegionInfo	(	lldb::addr_t	load_addr,
		MemoryRegionInfo &	range_info )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 226 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::GetMemoryRegionInfo().

◆ GetSharedLibraryInfoAddress()

lldb::addr_t lldb_private::NativeProcessWindows::GetSharedLibraryInfoAddress ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 254 of file NativeProcessWindows.cpp.

◆ GetSoftwareBreakpointPCOffset()

size_t lldb_private::NativeProcessWindows::GetSoftwareBreakpointPCOffset ( )

overrideprotectedvirtual

Return the offset of the PC relative to the software breakpoint that was hit.

If an architecture (e.g. arm) reports breakpoint hits before incrementing the PC, this offset will be 0. If an architecture (e.g. intel) reports breakpoints hits after incrementing the PC, this offset will be the size of the breakpoint opcode.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 331 of file NativeProcessWindows.cpp.

References GetSoftwareBreakpointTrapOpcode().

Referenced by HandleBreakpointException().

◆ GetSoftwareBreakpointTrapOpcode()

llvm::Expected< llvm::ArrayRef< uint8_t > > lldb_private::NativeProcessWindows::GetSoftwareBreakpointTrapOpcode ( size_t size_hint )

overrideprotectedvirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 313 of file NativeProcessWindows.cpp.

References GetArchitecture(), and lldb_private::NativeProcessProtocol::GetSoftwareBreakpointTrapOpcode().

Referenced by GetSoftwareBreakpointPCOffset().

◆ GetThreadByID()

NativeThreadWindows * lldb_private::NativeProcessWindows::GetThreadByID ( lldb::tid_t thread_id )

protected

Definition at line 170 of file NativeProcessWindows.cpp.

References lldb_private::NativeProcessProtocol::GetThreadByID().

Referenced by HandleBreakpointException(), HandleSingleStepException(), and StopThread().

◆ Halt()

Status lldb_private::NativeProcessWindows::Halt ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 175 of file NativeProcessWindows.cpp.

References lldb::eStateStopped, lldb_private::Status::Fail(), lldb_private::NativeProcessProtocol::GetState(), lldb_private::ProcessDebugger::HaltProcess(), m_pending_halt, and lldb_private::Status.

Referenced by Interrupt().

◆ HandleBreakpointException()

ExceptionResult lldb_private::NativeProcessWindows::HandleBreakpointException ( const ExceptionRecord & record )

private

Definition at line 520 of file NativeProcessWindows.cpp.

References BreakInDebugger, error(), lldb::eStateStopped, lldb::eStopReasonBreakpoint, lldb::eStopReasonException, lldb::eStopReasonSignal, lldb::eStopReasonWatchpoint, lldb_private::Exception, lldb_private::Status::Fail(), FindSoftwareBreakpoint(), lldb_private::ExceptionRecord::GetExceptionAddress(), lldb_private::ExceptionRecord::GetExceptionArguments(), lldb_private::ExceptionRecord::GetExceptionValue(), lldb_private::GetLog(), GetSoftwareBreakpointPCOffset(), GetThreadByID(), lldb_private::ExceptionRecord::GetThreadID(), LLDB_INVALID_INDEX32, LLDB_LOG, m_initial_stop_seen, m_pending_halt, lldb_private::NativeProcessProtocol::m_threads, MaskException, lldb_private::ThreadStopInfo::reason, lldb_private::NativeProcessProtocol::SetCurrentThreadID(), lldb_private::NativeProcessProtocol::SetState(), SetStopReasonForThread(), lldb_private::ThreadStopInfo::signo, and StopThread().

Referenced by OnDebugException().

◆ HandleGenericException()

ExceptionResult lldb_private::NativeProcessWindows::HandleGenericException	(	bool	first_chance,
		const ExceptionRecord &	record )

private

Definition at line 626 of file NativeProcessWindows.cpp.

References BreakInDebugger, lldb_private::ExceptionRecord::Dump(), lldb::eStateStopped, lldb::eStopReasonException, lldb_private::Exception, lldb_private::ExceptionRecord::GetExceptionAddress(), lldb_private::ExceptionRecord::GetExceptionValue(), lldb_private::GetLog(), lldb_private::ExceptionRecord::GetThreadID(), LLDB_LOG, SendToApplication, lldb_private::NativeProcessProtocol::SetState(), and StopThread().

Referenced by OnDebugException().

◆ HandleSingleStepException()

ExceptionResult lldb_private::NativeProcessWindows::HandleSingleStepException ( const ExceptionRecord & record )

private

◆ HasPendingLibraryEvents()

bool lldb_private::NativeProcessWindows::HasPendingLibraryEvents ( )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 441 of file NativeProcessWindows.cpp.

References m_pending_library_events.

◆ IgnoreSignals()

Status lldb_private::NativeProcessWindows::IgnoreSignals ( llvm::ArrayRef< int > signals )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 222 of file NativeProcessWindows.cpp.

References lldb_private::Status.

◆ Interrupt()

Status lldb_private::NativeProcessWindows::Interrupt ( )

overridevirtual

Tells a process to interrupt all operations as if by a Ctrl-C.

The default implementation will send a local host's equivalent of a SIGSTOP to the process via the NativeProcessProtocol::Signal() operation.

Returns: Returns an error object.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 215 of file NativeProcessWindows.cpp.

References Halt().

◆ IsAlive()

bool lldb_private::NativeProcessWindows::IsAlive ( ) const

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 256 of file NativeProcessWindows.cpp.

References lldb::eStateCrashed, lldb::eStateDetached, lldb::eStateExited, lldb::eStateInvalid, lldb::eStateUnloaded, and lldb_private::NativeProcessProtocol::GetState().

◆ Kill()

Status lldb_private::NativeProcessWindows::Kill ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 217 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::DestroyProcess(), and lldb_private::NativeProcessProtocol::GetState().

◆ OnCreateThread()

void lldb_private::NativeProcessWindows::OnCreateThread ( const HostThread & thread )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 671 of file NativeProcessWindows.cpp.

References error(), lldb::eStateCrashed, lldb::eStateStopped, lldb::eStopReasonNone, lldb_private::GetLog(), lldb_private::NativeProcessProtocol::GetState(), lldb_private::NativeProcessProtocol::GetWatchpointMap(), LLDB_LOG, lldb_private::NativeWatchpoint::m_addr, lldb_private::NativeWatchpoint::m_hardware, lldb_private::ProcessDebugger::m_mutex, lldb_private::NativeWatchpoint::m_size, lldb_private::NativeProcessProtocol::m_threads, lldb_private::NativeWatchpoint::m_watch_flags, lldb_private::ThreadStopInfo::reason, and lldb_private::Thread.

◆ OnDebugException()

ExceptionResult lldb_private::NativeProcessWindows::OnDebugException	(	bool	first_chance,
		const ExceptionRecord &	record )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 652 of file NativeProcessWindows.cpp.

References lldb_private::ExceptionRecord::GetExceptionValue(), HandleBreakpointException(), HandleGenericException(), HandleSingleStepException(), lldb_private::ProcessDebugger::m_mutex, lldb_private::ProcessDebugger::OnDebugException(), and STATUS_WX86_BREAKPOINT.

◆ OnDebuggerConnected()

void lldb_private::NativeProcessWindows::OnDebuggerConnected ( lldb::addr_t image_base )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 463 of file NativeProcessWindows.cpp.

References GetArchitecture(), lldb_private::ProcessInfo::GetArchitecture(), lldb_private::ProcessDebugger::GetDebuggedProcessId(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::GetLog(), lldb_private::Host::GetProcessInfo(), LLDB_INVALID_PROCESS_ID, LLDB_LOG, lldb_private::ProcessDebugger::m_session_data, lldb_private::NativeProcessProtocol::m_threads, lldb_private::Process, SetArchitecture(), and lldb_private::NativeProcessProtocol::SetID().

◆ OnDebugString()

void lldb_private::NativeProcessWindows::OnDebugString	(	lldb::addr_t	debug_string_addr,
		bool	is_unicode,
		uint16_t	length_lower_word )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 716 of file NativeProcessWindows.cpp.

References lldb_private::GetLog(), LLDB_LOG, lldb_private::NativeProcessProtocol::m_delegate, lldb_private::Process, and lldb_private::ProcessDebugger::ReadDebugString().

◆ OnExitProcess()

void lldb_private::NativeProcessWindows::OnExitProcess ( uint32_t exit_code )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 445 of file NativeProcessWindows.cpp.

References lldb::eStateExited, lldb_private::WaitStatus::Exit, lldb_private::NativeProcessProtocol::GetID(), lldb_private::GetLog(), LLDB_LOG, lldb_private::ProcessDebugger::OnExitProcess(), lldb_private::Process, lldb_private::NativeProcessProtocol::SetExitStatus(), lldb_private::NativeProcessProtocol::SetState(), and StopStdioForwarding().

◆ OnExitThread()

void lldb_private::NativeProcessWindows::OnExitThread	(	lldb::tid_t	thread_id,
		uint32_t	exit_code )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 697 of file NativeProcessWindows.cpp.

References lldb_private::NativeProcessProtocol::m_threads, and lldb_private::NativeProcessProtocol::m_threads_mutex.

◆ OnLoadDll()

void lldb_private::NativeProcessWindows::OnLoadDll	(	const ModuleSpec &	module_spec,
		lldb::addr_t	module_addr )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 705 of file NativeProcessWindows.cpp.

References m_loaded_modules, and m_pending_library_events.

◆ OnUnloadDll()

void lldb_private::NativeProcessWindows::OnUnloadDll ( lldb::addr_t module_addr )

overridevirtual

Reimplemented from lldb_private::ProcessDebugger.

Definition at line 711 of file NativeProcessWindows.cpp.

References m_loaded_modules, and m_pending_library_events.

◆ ReadMemory()

Status lldb_private::NativeProcessWindows::ReadMemory	(	lldb::addr_t	addr,
		void *	buf,
		size_t	size,
		size_t &	bytes_read )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 231 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::ReadMemory().

◆ RemoveBreakpoint()

Status lldb_private::NativeProcessWindows::RemoveBreakpoint	(	lldb::addr_t	addr,
		bool	hardware = false )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 348 of file NativeProcessWindows.cpp.

References lldb_private::NativeProcessProtocol::RemoveHardwareBreakpoint(), and lldb_private::NativeProcessProtocol::RemoveSoftwareBreakpoint().

◆ Resume()

Status lldb_private::NativeProcessWindows::Resume ( const ResumeActionList & resume_actions )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 98 of file NativeProcessWindows.cpp.

References error(), lldb::eStateCrashed, lldb::eStateRunning, lldb::eStateStepping, lldb::eStateStopped, lldb::eStateSuspended, lldb_private::Status::Fail(), lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::ResumeActionList::GetActionForThread(), lldb_private::ProcessDebugger::GetDebuggedProcessId(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::GetLog(), lldb_private::NativeProcessProtocol::GetState(), LLDB_LOG, lldb_private::ProcessDebugger::m_mutex, m_pending_library_events, lldb_private::ProcessDebugger::m_session_data, lldb_private::NativeProcessProtocol::m_threads, MaskException, lldb_private::Process, lldb_private::NativeProcessProtocol::SetState(), lldb_private::ResumeAction::state, and lldb_private::StateAsCString().

◆ SetArchitecture()

void lldb_private::NativeProcessWindows::SetArchitecture ( const ArchSpec & arch_spec )

inline

Definition at line 90 of file NativeProcessWindows.h.

References m_arch.

Referenced by OnDebuggerConnected().

◆ SetBreakpoint()

Status lldb_private::NativeProcessWindows::SetBreakpoint	(	lldb::addr_t	addr,
		uint32_t	size,
		bool	hardware )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 341 of file NativeProcessWindows.cpp.

References lldb_private::NativeProcessProtocol::SetHardwareBreakpoint(), and lldb_private::NativeProcessProtocol::SetSoftwareBreakpoint().

◆ SetStopReasonForThread()

void lldb_private::NativeProcessWindows::SetStopReasonForThread	(	NativeThreadWindows &	thread,
		lldb::StopReason	reason,
		std::string	description = "" )

protected

Definition at line 270 of file NativeProcessWindows.cpp.

References lldb_private::ThreadStopInfo::data_count, lldb_private::ThreadStopInfo::details, lldb::eStopReasonException, lldb_private::ThreadStopInfo::exception, lldb_private::ThreadStopInfo::reason, lldb_private::NativeProcessProtocol::SetCurrentThreadID(), lldb_private::ThreadStopInfo::signo, SIGTRAP, and lldb_private::ThreadStopInfo::type.

Referenced by HandleBreakpointException(), and StopThread().

◆ Signal()

Status lldb_private::NativeProcessWindows::Signal ( int signo )

overridevirtual

Sends a process a UNIX signal signal.

Returns: Returns an error object.

Implements lldb_private::NativeProcessProtocol.

Definition at line 208 of file NativeProcessWindows.cpp.

References error(), and lldb_private::Status::FromErrorString().

◆ StartStdioForwarding()

void lldb_private::NativeProcessWindows::StartStdioForwarding ( )

private

Wire up m_stdio_communication on m_pty's STDOUT HANDLE.

Definition at line 780 of file NativeProcessWindows.cpp.

References m_pty, m_stdio_communication, and STDIOReadThreadBytesReceived().

Referenced by NativeProcessWindows().

◆ STDIOReadThreadBytesReceived()

void lldb_private::NativeProcessWindows::STDIOReadThreadBytesReceived	(	void *	baton,
		const void *	src,
		size_t	src_len )

staticprivate

Bridge between m_stdio_communication's read thread and NativeDelegate::NewProcessOutput.

Definition at line 807 of file NativeProcessWindows.cpp.

References NativeProcessWindows().

Referenced by StartStdioForwarding().

◆ StopStdioForwarding()

void lldb_private::NativeProcessWindows::StopStdioForwarding ( )

private

Tear down the read thread and disconnect m_stdio_communication.

Definition at line 793 of file NativeProcessWindows.cpp.

References m_pty, and m_stdio_communication.

Referenced by OnExitProcess(), and ~NativeProcessWindows().

◆ StopThread()

void lldb_private::NativeProcessWindows::StopThread	(	lldb::tid_t	thread_id,
		lldb::StopReason	reason,
		std::string	description = "" )

protected

Definition at line 288 of file NativeProcessWindows.cpp.

References error(), lldb_private::GetLog(), GetThreadByID(), LLDB_LOG, lldb_private::NativeProcessProtocol::m_threads, SetStopReasonForThread(), and lldb_private::Thread.

Referenced by HandleBreakpointException(), HandleGenericException(), and HandleSingleStepException().

◆ UpdateThreads()

size_t lldb_private::NativeProcessWindows::UpdateThreads ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 304 of file NativeProcessWindows.cpp.

References lldb_private::NativeProcessProtocol::m_threads.

◆ WriteMemory()

Status lldb_private::NativeProcessWindows::WriteMemory	(	lldb::addr_t	addr,
		const void *	buf,
		size_t	size,
		size_t &	bytes_written )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 236 of file NativeProcessWindows.cpp.

References lldb_private::ProcessDebugger::WriteMemory().

◆ WriteStdin()

size_t lldb_private::NativeProcessWindows::WriteStdin	(	const void *	buf,
		size_t	len,
		Status &	error )

overridevirtual

Forward bytes from the gdb-remote I packet into the inferior's ConPTY-backed stdin via m_stdio_communication.Write → ConnectionConPTY::Write → WriteFile on the parent-side STDIN HANDLE.

Returns the number of bytes written (0 if the PTY is disconnected or write fails).

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 817 of file NativeProcessWindows.cpp.

References lldb::eConnectionStatusSuccess, error(), lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormatv(), and m_stdio_communication.

Member Data Documentation

◆ m_arch

ArchSpec lldb_private::NativeProcessWindows::m_arch

private

Definition at line 148 of file NativeProcessWindows.h.

Referenced by GetArchitecture(), NativeProcessWindows(), NativeProcessWindows(), and SetArchitecture().

◆ m_initial_stop_seen

bool lldb_private::NativeProcessWindows::m_initial_stop_seen = false

private

Whether we've seen the loader breakpoint that fires once per process at launch / attach.

Definition at line 170 of file NativeProcessWindows.h.

Referenced by HandleBreakpointException().

◆ m_loaded_modules

std::map<lldb_private::FileSpec, lldb::addr_t> lldb_private::NativeProcessWindows::m_loaded_modules

private

Definition at line 162 of file NativeProcessWindows.h.

Referenced by CacheLoadedModules(), GetFileLoadAddress(), GetLoadedLibraries(), GetLoadedModuleFileSpec(), OnLoadDll(), and OnUnloadDll().

◆ m_pending_halt

bool lldb_private::NativeProcessWindows::m_pending_halt = false

private

Set when Halt() / Interrupt() schedules a DebugBreakProcess injection.

Definition at line 173 of file NativeProcessWindows.h.

Referenced by Halt(), and HandleBreakpointException().

◆ m_pending_library_events

bool lldb_private::NativeProcessWindows::m_pending_library_events = true

private

Set whenever an OS DLL load/unload event has been seen since the last stop reply.

Definition at line 166 of file NativeProcessWindows.h.

Referenced by HasPendingLibraryEvents(), OnLoadDll(), OnUnloadDll(), and Resume().

◆ m_pty

std::shared_ptr<PseudoConsole> lldb_private::NativeProcessWindows::m_pty

private

PseudoConsole for the lldb-server stdio-forwarding path.

Definition at line 176 of file NativeProcessWindows.h.

Referenced by NativeProcessWindows(), StartStdioForwarding(), and StopStdioForwarding().

◆ m_stdio_communication

ThreadedCommunication lldb_private::NativeProcessWindows::m_stdio_communication

private

Wraps a ConnectionConPTY around the PTY's parent-side STDOUT HANDLE.

Definition at line 179 of file NativeProcessWindows.h.

Referenced by NativeProcessWindows(), NativeProcessWindows(), StartStdioForwarding(), StopStdioForwarding(), and WriteStdin().

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

Classes

Public Member Functions

Protected Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~NativeProcessWindows()

◆ NativeProcessWindows() [1/2]

◆ NativeProcessWindows() [2/2]

Member Function Documentation

◆ AllocateMemory()

◆ CacheLoadedModules()

◆ DeallocateMemory()

◆ Detach()

◆ FindSoftwareBreakpoint()

◆ GetArchitecture()

◆ GetAuxvData()

◆ GetFileLoadAddress()

◆ GetLoadedLibraries()

◆ GetLoadedModuleFileSpec()

◆ GetMemoryRegionInfo()

◆ GetSharedLibraryInfoAddress()

◆ GetSoftwareBreakpointPCOffset()

◆ GetSoftwareBreakpointTrapOpcode()

◆ GetThreadByID()

◆ Halt()

◆ HandleBreakpointException()

◆ HandleGenericException()

◆ HandleSingleStepException()

◆ HasPendingLibraryEvents()

◆ IgnoreSignals()

◆ Interrupt()

◆ IsAlive()

◆ Kill()

◆ OnCreateThread()

◆ OnDebugException()

◆ OnDebuggerConnected()

◆ OnDebugString()

◆ OnExitProcess()

◆ OnExitThread()

◆ OnLoadDll()

◆ OnUnloadDll()

◆ ReadMemory()

◆ RemoveBreakpoint()

◆ Resume()

◆ SetArchitecture()

◆ SetBreakpoint()

◆ SetStopReasonForThread()

◆ Signal()

◆ StartStdioForwarding()

◆ STDIOReadThreadBytesReceived()

◆ StopStdioForwarding()

◆ StopThread()

◆ UpdateThreads()

◆ WriteMemory()

◆ WriteStdin()

Member Data Documentation

◆ m_arch

◆ m_initial_stop_seen

◆ m_loaded_modules

◆ m_pending_halt

◆ m_pending_library_events

◆ m_pty

◆ m_stdio_communication