Manages communication with the inferior (debugee) process. More...

#include <NativeProcessLinux.h>

Inheritance diagram for lldb_private::process_linux::NativeProcessLinux:

Collaboration diagram for lldb_private::process_linux::NativeProcessLinux:

[legend]

Classes
class	Factory

Public Member Functions
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. More...

Status	Interrupt () override
	Tells a process to interrupt all operations as if by a Ctrl-C. More...

Status	Kill () 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

Status	AllocateMemory (size_t size, uint32_t permissions, lldb::addr_t &addr) override

Status	DeallocateMemory (lldb::addr_t addr) override

size_t	UpdateThreads () override

const ArchSpec &	GetArchitecture () const override

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

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

void	DoStopIDBumped (uint32_t newBumpId) override

Status	GetLoadedModuleFileSpec (const char *module_path, FileSpec &file_spec) override

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

NativeThreadLinux *	GetThreadByID (lldb::tid_t id)

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

lldb::user_id_t	StartTrace (const TraceOptions &config, Status &error) override
	StartTracing API for starting a tracing instance with the TraceOptions on a specific thread or process. More...

Status	StopTrace (lldb::user_id_t traceid, lldb::tid_t thread) override
	StopTracing API as the name suggests stops a tracing instance. More...

Status	GetData (lldb::user_id_t traceid, lldb::tid_t thread, llvm::MutableArrayRef< uint8_t > &buffer, size_t offset=0) override
	This API provides the trace data collected in the form of raw data. More...

Status	GetMetaData (lldb::user_id_t traceid, lldb::tid_t thread, llvm::MutableArrayRef< uint8_t > &buffer, size_t offset=0) override
	Similar API as above except it aims to provide any extra data useful for decoding the actual trace data. More...

Status	GetTraceConfig (lldb::user_id_t traceid, TraceOptions &config) override
	API to query the TraceOptions for a given user id. More...

bool	SupportHardwareSingleStepping () const

Public Member Functions inherited from lldb_private::NativeProcessProtocol
virtual	~NativeProcessProtocol ()

virtual Status	IgnoreSignals (llvm::ArrayRef< int > signals)

Status	ReadMemoryWithoutTrap (lldb::addr_t addr, void *buf, size_t size, size_t &bytes_read)

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. More...

virtual bool	IsAlive () const

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 llvm::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 llvm::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 ()

NativeThreadProtocol *	GetCurrentThread ()

virtual int	GetTerminalFileDescriptor ()

uint32_t	GetStopID () const

bool	RegisterNativeDelegate (NativeDelegate &native_delegate)
	Register a native delegate. More...

bool	UnregisterNativeDelegate (NativeDelegate &native_delegate)
	Unregister a native delegate previously registered. More...

Static Public Member Functions
static Status	PtraceWrapper (int req, lldb::pid_t pid, void addr=nullptr, void data=nullptr, size_t data_size=0, long *result=nullptr)

Protected Member Functions
llvm::Expected< llvm::ArrayRef< uint8_t > >	GetSoftwareBreakpointTrapOpcode (size_t size_hint) override

Protected Member Functions inherited from lldb_private::NativeProcessELF
llvm::Optional< uint64_t >	GetAuxValue (enum AuxVector::EntryType type)

lldb::addr_t	GetSharedLibraryInfoAddress () override

template<typename ELF_EHDR , typename ELF_PHDR , typename ELF_DYN >
lldb::addr_t	GetELFImageInfoAddress ()

llvm::Expected< std::vector< SVR4LibraryInfo > >	GetLoadedSVR4Libraries () override

template<typename T >
llvm::Expected< SVR4LibraryInfo >	ReadSVR4LibraryInfo (lldb::addr_t link_map_addr)

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)

Status	SetSoftwareBreakpoint (lldb::addr_t addr, uint32_t size_hint)

Status	RemoveSoftwareBreakpoint (lldb::addr_t addr)

virtual size_t	GetSoftwareBreakpointPCOffset ()
	Return the offset of the PC relative to the software breakpoint that was hit. More...

void	FixupBreakpointPCAsNeeded (NativeThreadProtocol &thread)

void	NotifyDidExec ()
	Notify the delegate that an exec occurred. More...

NativeThreadProtocol *	GetThreadByIDUnlocked (lldb::tid_t tid)

Private Member Functions
	NativeProcessLinux (::pid_t pid, int terminal_fd, NativeDelegate &delegate, const ArchSpec &arch, MainLoop &mainloop, llvm::ArrayRef<::pid_t > tids)

void	MonitorCallback (lldb::pid_t pid, bool exited, WaitStatus status)

void	WaitForNewThread (::pid_t tid)

void	MonitorSIGTRAP (const siginfo_t &info, NativeThreadLinux &thread)

void	MonitorTrace (NativeThreadLinux &thread)

void	MonitorBreakpoint (NativeThreadLinux &thread)

void	MonitorWatchpoint (NativeThreadLinux &thread, uint32_t wp_index)

void	MonitorSignal (const siginfo_t &info, NativeThreadLinux &thread, bool exited)

Status	SetupSoftwareSingleStepping (NativeThreadLinux &thread)

bool	HasThreadNoLock (lldb::tid_t thread_id)

bool	StopTrackingThread (lldb::tid_t thread_id)

NativeThreadLinux &	AddThread (lldb::tid_t thread_id)

Status	GetSignalInfo (lldb::tid_t tid, void *siginfo)
	Writes a siginfo_t structure corresponding to the given thread ID to the memory region pointed to by `siginfo`. More...

Status	GetEventMessage (lldb::tid_t tid, unsigned long *message)
	Writes the raw event message code (vis-a-vis PTRACE_GETEVENTMSG) corresponding to the given thread ID to the memory pointed to by `message`. More...

void	NotifyThreadDeath (lldb::tid_t tid)

Status	Detach (lldb::tid_t tid)

void	StopRunningThreads (lldb::tid_t triggering_tid)

void	SignalIfAllThreadsStopped ()

Status	ResumeThread (NativeThreadLinux &thread, lldb::StateType state, int signo)

void	ThreadWasCreated (NativeThreadLinux &thread)

void	SigchldHandler ()

Status	PopulateMemoryRegionCache ()

lldb::user_id_t	StartTraceGroup (const TraceOptions &config, Status &error)

Status	StopTracingForThread (lldb::tid_t thread)

llvm::Expected< ProcessorTraceMonitor & >	LookupProcessorTraceInstance (lldb::user_id_t traceid, lldb::tid_t thread)

Status	StopProcessorTracingOnThread (lldb::user_id_t traceid, lldb::tid_t thread)

void	StopProcessorTracingOnProcess ()

Static Private Member Functions
static llvm::Expected< std::vector<::pid_t > >	Attach (::pid_t pid)

static Status	SetDefaultPtraceOpts (const lldb::pid_t)

Private Attributes
MainLoop::SignalHandleUP	m_sigchld_handle

ArchSpec	m_arch

LazyBool	m_supports_mem_region = eLazyBoolCalculate

std::vector< std::pair< MemoryRegionInfo, FileSpec > >	m_mem_region_cache

lldb::tid_t	m_pending_notification_tid = LLDB_INVALID_THREAD_ID

std::map< lldb::tid_t, lldb::addr_t >	m_threads_stepping_with_breakpoint

llvm::DenseMap< lldb::tid_t, ProcessorTraceMonitorUP >	m_processor_trace_monitor

llvm::DenseSet< lldb::tid_t >	m_pt_traced_thread_group

lldb::user_id_t	m_pt_proces_trace_id = LLDB_INVALID_UID

TraceOptions	m_pt_process_trace_config

Additional Inherited Members
Protected Attributes inherited from lldb_private::NativeProcessELF
std::unique_ptr< AuxVector >	m_aux_vector

llvm::Optional< lldb::addr_t >	m_shared_library_info_addr

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

llvm::Optional< WaitStatus >	m_exit_status

std::recursive_mutex	m_delegates_mutex

std::vector< NativeDelegate * >	m_delegates

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

Detailed Description

Manages communication with the inferior (debugee) process.

Upon construction, this class prepares and launches an inferior process for debugging.

Changes in the inferior process state are broadcasted.

Definition at line 39 of file NativeProcessLinux.h.

Constructor & Destructor Documentation

◆ NativeProcessLinux()

NativeProcessLinux::NativeProcessLinux	(	::pid_t	pid,
		int	terminal_fd,
		NativeDelegate &	delegate,
		const ArchSpec &	arch,
		MainLoop &	mainloop,
		llvm::ArrayRef<::pid_t >	tids
	)

private

Definition at line 287 of file NativeProcessLinux.cpp.

References AddThread(), EnsureFDFlags(), lldb::eStateStopped, m_sigchld_handle, lldb_private::NativeProcessProtocol::m_terminal_fd, O_NONBLOCK, lldb_private::MainLoop::RegisterSignal(), lldb_private::NativeProcessProtocol::SetCurrentThreadID(), lldb_private::NativeProcessProtocol::SetState(), lldb_private::process_linux::NativeThreadLinux::SetStoppedBySignal(), SigchldHandler(), SIGSTOP, lldb_private::Status::Success(), and ThreadWasCreated().

Member Function Documentation

◆ AddThread()

NativeThreadLinux & NativeProcessLinux::AddThread ( lldb::tid_t thread_id )

private

Definition at line 1583 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::ProcessorTraceMonitor::Create(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), HasThreadNoLock(), LLDB_INVALID_UID, LLDB_LOG, m_processor_trace_monitor, m_pt_proces_trace_id, m_pt_process_trace_config, m_pt_traced_thread_group, lldb_private::NativeProcessProtocol::m_threads, POSIX_LOG_THREAD, and lldb_private::NativeProcessProtocol::SetCurrentThreadID().

Referenced by MonitorCallback(), NativeProcessLinux(), and WaitForNewThread().

◆ AllocateMemory()

Status NativeProcessLinux::AllocateMemory	(	size_t	size,
		uint32_t	permissions,
		lldb::addr_t &	addr
	)

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1350 of file NativeProcessLinux.cpp.

References lldb_private::eMmapFlagsAnon, lldb_private::eMmapFlagsPrivate, lldb_private::eMmapProtExec, lldb_private::eMmapProtRead, lldb_private::eMmapProtWrite, lldb_private::GetPermissionsAsCString(), lldb_private::InferiorCallMmap(), and LLDB_INVALID_ADDRESS.

◆ Attach()

llvm::Expected< std::vector<::pid_t > > NativeProcessLinux::Attach ( ::pid_t pid )

staticprivate

Definition at line 316 of file NativeProcessLinux.cpp.

References lldb_private::Host::FindProcessThreads(), lldb_private::Status::GetError(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, POSIX_LOG_PROCESS, PtraceWrapper(), SetDefaultPtraceOpts(), and lldb_private::Status::ToError().

◆ DeallocateMemory()

Status NativeProcessLinux::DeallocateMemory ( lldb::addr_t addr )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1383 of file NativeProcessLinux.cpp.

◆ Detach() [1/2]

Status NativeProcessLinux::Detach ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1105 of file NativeProcessLinux.cpp.

References lldb_private::Status::Fail(), lldb_private::NativeProcessProtocol::GetID(), LLDB_INVALID_PROCESS_ID, LLDB_INVALID_UID, m_processor_trace_monitor, m_pt_proces_trace_id, m_sigchld_handle, and lldb_private::NativeProcessProtocol::m_threads.

◆ Detach() [2/2]

Status NativeProcessLinux::Detach ( lldb::tid_t tid )

private

Definition at line 1544 of file NativeProcessLinux.cpp.

References LLDB_INVALID_THREAD_ID, and PtraceWrapper().

◆ DoStopIDBumped()

void NativeProcessLinux::DoStopIDBumped ( uint32_t newBumpId )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1342 of file NativeProcessLinux.cpp.

References lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, m_mem_region_cache, and POSIX_LOG_PROCESS.

Referenced by GetArchitecture().

◆ GetArchitecture()

const ArchSpec& lldb_private::process_linux::NativeProcessLinux::GetArchitecture ( ) const

inlineoverridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 81 of file NativeProcessLinux.h.

References DoStopIDBumped(), GetFileLoadAddress(), GetLoadedModuleFileSpec(), GetThreadByID(), m_arch, RemoveBreakpoint(), and SetBreakpoint().

Referenced by GetSoftwareBreakpointTrapOpcode().

◆ GetAuxvData()

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

inlineoverridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 99 of file NativeProcessLinux.h.

References GetData(), lldb_private::NativeProcessProtocol::GetID(), GetMetaData(), lldb_private::getProcFile(), GetSoftwareBreakpointTrapOpcode(), GetTraceConfig(), PtraceWrapper(), StartTrace(), StopTrace(), and SupportHardwareSingleStepping().

◆ GetData()

Status NativeProcessLinux::GetData	(	lldb::user_id_t	traceid,
		lldb::tid_t	thread,
		llvm::MutableArrayRef< uint8_t > &	buffer,
		size_t	offset = `0`
	)

overridevirtual

This API provides the trace data collected in the form of raw data.

Parameters

[in]	traceid	thread The traceid and thread provide the context for the trace instance.
[in]	buffer	The buffer provides the destination buffer where the trace data would be read to. The buffer should be truncated to the filled length by this function.
[in]	offset	There is possibility to read partially the trace data from a specified offset where in such cases the buffer provided may be smaller than the internal trace collection container.

Returns: The size of the data actually read.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1862 of file NativeProcessLinux.cpp.

References lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, LookupProcessorTraceInstance(), and POSIX_LOG_PTRACE.

Referenced by GetAuxvData().

◆ GetEventMessage()

Status NativeProcessLinux::GetEventMessage	(	lldb::tid_t	tid,
		unsigned long *	message
	)

private

Writes the raw event message code (vis-a-vis PTRACE_GETEVENTMSG) corresponding to the given thread ID to the memory pointed to by message.

Definition at line 1539 of file NativeProcessLinux.cpp.

References PtraceWrapper().

Referenced by MonitorSIGTRAP().

◆ GetFileLoadAddress()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1633 of file NativeProcessLinux.cpp.

References lldb_private::Status::Fail(), LLDB_INVALID_ADDRESS, m_mem_region_cache, and PopulateMemoryRegionCache().

Referenced by GetArchitecture().

◆ GetLoadedModuleFileSpec()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1613 of file NativeProcessLinux.cpp.

References lldb_private::ConstString::AsCString(), lldb_private::FileSpec::Clear(), lldb_private::Status::Fail(), lldb_private::FileSpec::GetFilename(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::FileSystem::Instance(), m_mem_region_cache, PopulateMemoryRegionCache(), and lldb_private::FileSystem::Resolve().

Referenced by GetArchitecture().

◆ GetMemoryRegionInfo()

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

overridevirtual

◆ GetMetaData()

Status NativeProcessLinux::GetMetaData	(	lldb::user_id_t	traceid,
		lldb::tid_t	thread,
		llvm::MutableArrayRef< uint8_t > &	buffer,
		size_t	offset = `0`
	)

overridevirtual

Similar API as above except it aims to provide any extra data useful for decoding the actual trace data.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1842 of file NativeProcessLinux.cpp.

References lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, LookupProcessorTraceInstance(), and POSIX_LOG_PTRACE.

Referenced by GetAuxvData().

◆ GetSignalInfo()

Status NativeProcessLinux::GetSignalInfo	(	lldb::tid_t	tid,
		void *	siginfo
	)

private

Writes a siginfo_t structure corresponding to the given thread ID to the memory region pointed to by siginfo.

Definition at line 1535 of file NativeProcessLinux.cpp.

References PtraceWrapper().

Referenced by MonitorCallback().

◆ GetSoftwareBreakpointTrapOpcode()

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

overrideprotectedvirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1412 of file NativeProcessLinux.cpp.

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

Referenced by GetAuxvData().

◆ GetThreadByID()

NativeThreadLinux * NativeProcessLinux::GetThreadByID ( lldb::tid_t id )

Definition at line 1650 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::GetThreadByID().

Referenced by GetArchitecture(), MonitorCallback(), StartTrace(), and WaitForNewThread().

◆ GetTraceConfig()

Status NativeProcessLinux::GetTraceConfig	(	lldb::user_id_t	traceid,
		TraceOptions &	config
	)

overridevirtual

API to query the TraceOptions for a given user id.

Parameters

[in]	traceid	The user id of the tracing instance.
[out]	config	The configuration being used for tracing.

Returns: A status indicating what went wrong.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1880 of file NativeProcessLinux.cpp.

References lldb_private::TraceOptions::getThreadID(), LLDB_INVALID_THREAD_ID, LLDB_INVALID_UID, LookupProcessorTraceInstance(), m_pt_proces_trace_id, m_pt_process_trace_config, and lldb_private::Status::SetErrorString().

Referenced by GetAuxvData(), and StopTrace().

◆ Halt()

Status NativeProcessLinux::Halt ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1096 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::GetID(), lldb_private::Status::SetErrorToErrno(), and SIGSTOP.

◆ HasThreadNoLock()

bool NativeProcessLinux::HasThreadNoLock ( lldb::tid_t thread_id )

private

Definition at line 1551 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::m_threads.

Referenced by AddThread().

◆ Interrupt()

Status NativeProcessLinux::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 1141 of file NativeProcessLinux.cpp.

References lldb::eStateRunning, lldb::eStateStepping, lldb_private::NativeThreadProtocol::GetID(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, lldb_private::NativeProcessProtocol::m_threads, POSIX_LOG_PROCESS, lldb_private::StateIsStoppedState(), and StopRunningThreads().

◆ Kill()

Status NativeProcessLinux::Kill ( )

overridevirtual

◆ LookupProcessorTraceInstance()

llvm::Expected< ProcessorTraceMonitor & > NativeProcessLinux::LookupProcessorTraceInstance	(	lldb::user_id_t	traceid,
		lldb::tid_t	thread
	)

private

Definition at line 1824 of file NativeProcessLinux.cpp.

References lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_INVALID_THREAD_ID, LLDB_LOG, m_processor_trace_monitor, m_pt_proces_trace_id, POSIX_LOG_PTRACE, and lldb_private::Status::ToError().

Referenced by GetData(), GetMetaData(), and GetTraceConfig().

◆ MonitorBreakpoint()

void NativeProcessLinux::MonitorBreakpoint ( NativeThreadLinux & thread )

private

Definition at line 744 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::FixupBreakpointPCAsNeeded(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::GetLogIfAnyCategoriesSet(), LIBLLDB_LOG_BREAKPOINTS, LIBLLDB_LOG_PROCESS, LLDB_LOG, m_threads_stepping_with_breakpoint, lldb_private::process_linux::NativeThreadLinux::SetStoppedByBreakpoint(), lldb_private::process_linux::NativeThreadLinux::SetStoppedByTrace(), and StopRunningThreads().

Referenced by MonitorSIGTRAP().

◆ MonitorCallback()

void NativeProcessLinux::MonitorCallback	(	lldb::pid_t	pid,
		bool	exited,
		WaitStatus	status
	)

private

◆ MonitorSignal()

void NativeProcessLinux::MonitorSignal	(	const siginfo_t &	info,
		NativeThreadLinux &	thread,
		bool	exited
	)

private

Definition at line 776 of file NativeProcessLinux.cpp.

References EmulatorBaton::EmulatorBaton(), lldb_private::Status::Fail(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), lldb_private::Host::GetSignalAsCString(), lldb_private::process_linux::NativeThreadLinux::GetState(), LLDB_INVALID_THREAD_ID, LLDB_LOG, m_pending_notification_tid, lldb_private::NativeProcessProtocol::m_signals_to_ignore, POSIX_LOG_PROCESS, ResumeThread(), lldb_private::NativeProcessProtocol::SetCurrentThreadID(), lldb_private::process_linux::NativeThreadLinux::SetStoppedBySignal(), lldb_private::process_linux::NativeThreadLinux::SetStoppedWithNoReason(), SignalIfAllThreadsStopped(), SIGSTOP, lldb_private::StateIsStoppedState(), and StopRunningThreads().

Referenced by MonitorCallback(), and MonitorSIGTRAP().

◆ MonitorSIGTRAP()

void NativeProcessLinux::MonitorSIGTRAP	(	const siginfo_t &	info,
		NativeThreadLinux &	thread
	)

private

Definition at line 561 of file NativeProcessLinux.cpp.

References lldb::eStateRunning, lldb_private::Status::Fail(), GetEventMessage(), lldb_private::NativeRegisterContext::GetHardwareBreakHitIndex(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), lldb_private::process_linux::NativeThreadLinux::GetState(), lldb_private::NativeRegisterContext::GetWatchpointHitIndex(), LLDB_INVALID_ADDRESS, LLDB_INVALID_INDEX32, LLDB_INVALID_SIGNAL_NUMBER, LLDB_INVALID_THREAD_ID, LLDB_LOG, m_pending_notification_tid, lldb_private::NativeProcessProtocol::m_threads, MonitorBreakpoint(), MonitorSignal(), MonitorTrace(), MonitorWatchpoint(), lldb_private::NativeProcessProtocol::NotifyDidExec(), POSIX_LOG_PROCESS, ResumeThread(), lldb_private::NativeProcessProtocol::SetCurrentThreadID(), SIGTRAP, lldb_private::StateIsRunningState(), StopRunningThreads(), ThreadWasCreated(), TRAP_HWBKPT, and WaitForNewThread().

Referenced by MonitorCallback().

◆ MonitorTrace()

void NativeProcessLinux::MonitorTrace ( NativeThreadLinux & thread )

private

Definition at line 734 of file NativeProcessLinux.cpp.

References lldb_private::NativeThreadProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, POSIX_LOG_PROCESS, lldb_private::process_linux::NativeThreadLinux::SetStoppedByTrace(), and StopRunningThreads().

Referenced by MonitorSIGTRAP().

◆ MonitorWatchpoint()

void NativeProcessLinux::MonitorWatchpoint	(	NativeThreadLinux &	thread,
		uint32_t	wp_index
	)

private

Definition at line 760 of file NativeProcessLinux.cpp.

References lldb_private::NativeThreadProtocol::GetID(), lldb_private::GetLogIfAnyCategoriesSet(), LIBLLDB_LOG_PROCESS, LIBLLDB_LOG_WATCHPOINTS, LLDB_LOG, lldb_private::process_linux::NativeThreadLinux::SetStoppedByWatchpoint(), and StopRunningThreads().

Referenced by MonitorSIGTRAP().

◆ NotifyThreadDeath()

void lldb_private::process_linux::NativeProcessLinux::NotifyThreadDeath ( lldb::tid_t tid )

private

◆ PopulateMemoryRegionCache()

Status NativeProcessLinux::PopulateMemoryRegionCache ( )

private

◆ PtraceWrapper()

Status NativeProcessLinux::PtraceWrapper	(	int	req,
		lldb::pid_t	pid,
		void *	addr = `nullptr`,
		void *	data = `nullptr`,
		size_t	data_size = `0`,
		long *	result = `nullptr`
	)

static

Definition at line 1788 of file NativeProcessLinux.cpp.

References lldb_private::Status::Fail(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, POSIX_LOG_PTRACE, PTRACE_GETREGSET, PTRACE_SETREGSET, and lldb_private::Status::SetErrorToErrno().

◆ ReadMemory()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1434 of file NativeProcessLinux.cpp.

References lldb_private::Status::Fail(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, POSIX_LOG_MEMORY, POSIX_LOG_PROCESS, process_vm_readv(), ProcessVmReadvSupported(), and PtraceWrapper().

Referenced by WriteMemory().

◆ RemoveBreakpoint()

Status NativeProcessLinux::RemoveBreakpoint	(	lldb::addr_t	addr,
		bool	hardware = `false`
	)

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1404 of file NativeProcessLinux.cpp.

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

Referenced by GetArchitecture(), and SignalIfAllThreadsStopped().

◆ Resume()

Status NativeProcessLinux::Resume ( const ResumeActionList & resume_actions )

overridevirtual

◆ ResumeThread()

Status NativeProcessLinux::ResumeThread	(	NativeThreadLinux &	thread,
		lldb::StateType	state,
		int	signo
	)

private

Definition at line 1655 of file NativeProcessLinux.cpp.

References lldb::eStateRunning, lldb::eStateStepping, lldb_private::NativeThreadProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_INVALID_THREAD_ID, LLDB_LOG, m_pending_notification_tid, POSIX_LOG_THREAD, lldb_private::process_linux::NativeThreadLinux::Resume(), lldb_private::NativeProcessProtocol::SetState(), and lldb_private::process_linux::NativeThreadLinux::SingleStep().

Referenced by MonitorCallback(), MonitorSignal(), MonitorSIGTRAP(), Resume(), and WaitForNewThread().

◆ SetBreakpoint()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1396 of file NativeProcessLinux.cpp.

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

Referenced by GetArchitecture().

◆ SetDefaultPtraceOpts()

Status NativeProcessLinux::SetDefaultPtraceOpts ( const lldb::pid_t pid )

staticprivate

Definition at line 380 of file NativeProcessLinux.cpp.

References PtraceWrapper().

Referenced by Attach().

◆ SetupSoftwareSingleStepping()

Status NativeProcessLinux::SetupSoftwareSingleStepping ( NativeThreadLinux & thread )

private

Definition at line 940 of file NativeProcessLinux.cpp.

References lldb_private::eInstructionTypePCModifying, lldb::eRegisterKindDWARF, lldb::eRegisterKindGeneric, lldb_private::Status::Fail(), lldb_private::EmulateInstruction::FindPlugin(), lldb_private::Status::GetError(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::ArchSpec::GetMachine(), lldb_private::NativeRegisterContext::GetPC(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), lldb_private::NativeRegisterContext::GetRegisterInfo(), lldb_private::ArchSpec::GetTriple(), lldb_private::ArchSpec::IsMIPS(), LLDB_REGNUM_GENERIC_FLAGS, LLDB_REGNUM_GENERIC_PC, m_arch, m_threads_stepping_with_breakpoint, ReadFlags(), ReadMemoryCallback(), ReadRegisterCallback(), lldb_private::NativeProcessProtocol::SetSoftwareBreakpoint(), WriteMemoryCallback(), WriteRegisterCallback(), and x20.

Referenced by Resume().

◆ SigchldHandler()

void NativeProcessLinux::SigchldHandler ( )

private

Definition at line 1755 of file NativeProcessLinux.cpp.

References lldb_private::WaitStatus::Decode(), lldb::eErrorTypePOSIX, lldb_private::WaitStatus::Exit, lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, MonitorCallback(), POSIX_LOG_PROCESS, lldb_private::WaitStatus::Signal, and lldb_private::WaitStatus::type.

Referenced by NativeProcessLinux().

◆ Signal()

Status NativeProcessLinux::Signal ( int signo )

overridevirtual

Sends a process a UNIX signal signal.

Returns: Returns an error object.

Implements lldb_private::NativeProcessProtocol.

Definition at line 1128 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), lldb_private::Host::GetSignalAsCString(), LLDB_LOG, POSIX_LOG_PROCESS, and lldb_private::Status::SetErrorToErrno().

◆ SignalIfAllThreadsStopped()

void NativeProcessLinux::SignalIfAllThreadsStopped ( )

private

Definition at line 1714 of file NativeProcessLinux.cpp.

References lldb::eStateStopped, lldb_private::Status::Fail(), lldb_private::GetLogIfAnyCategoriesSet(), LIBLLDB_LOG_BREAKPOINTS, LIBLLDB_LOG_PROCESS, LLDB_INVALID_THREAD_ID, LLDB_LOG, m_pending_notification_tid, lldb_private::NativeProcessProtocol::m_threads, m_threads_stepping_with_breakpoint, RemoveBreakpoint(), lldb_private::NativeProcessProtocol::SetCurrentThreadID(), lldb_private::NativeProcessProtocol::SetState(), and lldb_private::StateIsRunningState().

Referenced by MonitorSignal(), StopRunningThreads(), and StopTrackingThread().

◆ StartTrace()

lldb::user_id_t NativeProcessLinux::StartTrace	(	const TraceOptions &	config,
		Status &	error
	)

overridevirtual

StartTracing API for starting a tracing instance with the TraceOptions on a specific thread or process.

Parameters

[in]	config	The configuration to use when starting tracing.
[out]	error	Status indicates what went wrong.

Returns: The API returns a user_id which can be used to get trace data, trace configuration or stopping the trace instance. The user_id is a key to identify and operate with a tracing instance. It may refer to the complete process or a single thread.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1934 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::ProcessorTraceMonitor::Create(), lldb::eTraceTypeProcessorTrace, lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), GetThreadByID(), lldb_private::TraceOptions::getThreadID(), lldb_private::TraceOptions::getType(), LLDB_INVALID_THREAD_ID, LLDB_INVALID_UID, LLDB_LOG, m_processor_trace_monitor, POSIX_LOG_PTRACE, lldb_private::Status::SetErrorString(), lldb_private::NativeProcessProtocol::StartTrace(), and StartTraceGroup().

Referenced by GetAuxvData().

◆ StartTraceGroup()

lldb::user_id_t NativeProcessLinux::StartTraceGroup	(	const TraceOptions &	config,
		Status &	error
	)

private

Definition at line 1903 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::ProcessorTraceMonitor::Create(), lldb::eTraceTypeProcessorTrace, lldb_private::process_linux::ProcessorTraceMonitor::GetCPUType(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), lldb_private::TraceOptions::getType(), LLDB_INVALID_UID, LLDB_LOG, m_processor_trace_monitor, m_pt_proces_trace_id, m_pt_process_trace_config, m_pt_traced_thread_group, lldb_private::NativeProcessProtocol::m_threads, POSIX_LOG_PTRACE, and lldb_private::Status::SetErrorString().

Referenced by StartTrace().

◆ StopProcessorTracingOnProcess()

void NativeProcessLinux::StopProcessorTracingOnProcess ( )

private

Definition at line 2022 of file NativeProcessLinux.cpp.

References LLDB_INVALID_UID, m_processor_trace_monitor, m_pt_proces_trace_id, and m_pt_traced_thread_group.

Referenced by StopTrace().

◆ StopProcessorTracingOnThread()

Status NativeProcessLinux::StopProcessorTracingOnThread	(	lldb::user_id_t	traceid,
		lldb::tid_t	thread
	)

private

Definition at line 2029 of file NativeProcessLinux.cpp.

References lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_INVALID_THREAD_ID, LLDB_LOG, m_processor_trace_monitor, m_pt_proces_trace_id, m_pt_traced_thread_group, POSIX_LOG_PTRACE, and lldb_private::Status::SetErrorString().

Referenced by StopTrace().

◆ StopRunningThreads()

void NativeProcessLinux::StopRunningThreads ( lldb::tid_t triggering_tid )

private

Definition at line 1696 of file NativeProcessLinux.cpp.

References lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, m_pending_notification_tid, lldb_private::NativeProcessProtocol::m_threads, POSIX_LOG_THREAD, SignalIfAllThreadsStopped(), and lldb_private::StateIsRunningState().

Referenced by Interrupt(), MonitorBreakpoint(), MonitorSignal(), MonitorSIGTRAP(), MonitorTrace(), and MonitorWatchpoint().

◆ StopTrace()

Status NativeProcessLinux::StopTrace	(	lldb::user_id_t	traceid,
		lldb::tid_t	thread
	)

overridevirtual

StopTracing API as the name suggests stops a tracing instance.

Parameters

[in]	traceid	The user id of the trace intended to be stopped. Now a user_id may map to multiple threads in which case this API could be used to stop the tracing for a specific thread by supplying its thread id.
[in]	thread	Thread is needed when the complete process is being traced and the user wishes to stop tracing on a particular thread.