#include <NativeProcessLinux.h>

Inheritance diagram for lldb_private::process_linux::NativeProcessLinux:

[legend]

Collaboration diagram for lldb_private::process_linux::NativeProcessLinux:

[legend]

Classes
struct	CloneInfo

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

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

llvm::Error	DeallocateMemory (lldb::addr_t addr) override

Status	ReadMemoryTags (int32_t type, lldb::addr_t addr, size_t len, std::vector< uint8_t > &tags) override

Status	WriteMemoryTags (int32_t type, lldb::addr_t addr, size_t len, const std::vector< uint8_t > &tags) 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)

NativeThreadLinux *	GetCurrentThread ()

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

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

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

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

virtual void	SetEnabledExtensions (Extension flags)
	Method called in order to propagate the bitmap of protocol extensions supported by the client. More...

virtual llvm::Expected< std::string >	SaveCore (llvm::StringRef path_hint)
	Write a core dump (without crashing the program). More...

MainLoop::SignalHandleUP	m_sigchld_handle

ArchSpec	m_arch

MainLoop &	m_main_loop

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

llvm::DenseMap< lldb::addr_t, lldb::addr_t >	m_allocated_memory
	Inferior memory (allocated by us) and its size. More...

IntelPTManager	m_intel_pt_manager
	Manages Intel PT process and thread traces. More...

llvm::DenseMap< lldb::pid_t, llvm::Optional< CloneInfo > >	m_pending_pid_map

llvm::Error	TraceStart (llvm::StringRef json_request, llvm::StringRef type) override
	Tracing These methods implement the jLLDBTrace packets. More...

llvm::Error	TraceStop (const TraceStopRequest &request) override
	Stop tracing a live process or its threads. More...

llvm::Expected< llvm::json::Value >	TraceGetState (llvm::StringRef type) override
	Get the current tracing state of the process and its threads. More...

llvm::Expected< std::vector< uint8_t > >	TraceGetBinaryData (const TraceGetBinaryDataRequest &request) override
	Get binary data given a trace technology and a data identifier. More...

llvm::Expected< TraceSupportedResponse >	TraceSupported () override
	Get the processor tracing type supported for this process. More...

bool	SupportHardwareSingleStepping () const

static Status	PtraceWrapper (int req, lldb::pid_t pid, void addr=nullptr, void data=nullptr, size_t data_size=0, long *result=nullptr)
	} More...

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

llvm::Expected< uint64_t >	Syscall (llvm::ArrayRef< uint64_t > args)

	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	WaitForCloneNotification (::pid_t pid)

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)

bool	HasThreadNoLock (lldb::tid_t thread_id)

bool	StopTrackingThread (lldb::tid_t thread_id)

NativeThreadLinux &	AddThread (lldb::tid_t thread_id, bool resume)
	Create a new thread. More...

Status	NotifyTracersOfNewThread (lldb::tid_t tid)
	Start tracing a new thread if process tracing is enabled. More...

Status	NotifyTracersOfThreadDestroyed (lldb::tid_t tid)
	Stop tracing threads upon a destroy event. More...

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

bool	MonitorClone (lldb::pid_t child_pid, llvm::Optional< CloneInfo > clone_info)

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

static Status	SetDefaultPtraceOpts (const lldb::pid_t)

Additional Inherited Members
Public Types inherited from lldb_private::NativeProcessProtocol
enum	Extension { Extension::multiprocess = (1u << 0), Extension::fork = (1u << 1), Extension::vfork = (1u << 2), Extension::pass_signals = (1u << 3), Extension::auxv = (1u << 4), Extension::libraries_svr4 = (1u << 5), Extension::memory_tagging = (1u << 6), Extension::savecore = (1u << 7) }
	Extension flag constants, returned by Factory::GetSupportedExtensions() and passed to SetEnabledExtension() More...

Protected Member Functions inherited from lldb_private::NativeProcessELF
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)

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

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

Private Member Functions inherited from lldb_private::NativeProcessSoftwareSingleStep
Status	SetupSoftwareSingleStepping (NativeThreadProtocol &thread)

Private Attributes inherited from lldb_private::NativeProcessSoftwareSingleStep
std::map< lldb::tid_t, lldb::addr_t >	m_threads_stepping_with_breakpoint

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 40 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 308 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(), SigchldHandler(), lldb_private::Status::Success(), and ThreadWasCreated().

Referenced by MonitorClone().

Member Function Documentation

◆ AddThread()

NativeThreadLinux & NativeProcessLinux::AddThread	(	lldb::tid_t	thread_id,
		bool	resume
	)

private

Create a new thread.

If process tracing is enabled and the thread can't be traced, then the thread is left stopped with a eStopReasonProcessorTrace status, and then the process is stopped.

Parameters

[in] resume If a tracing error didn't happen, then resume the thread after creation if true, or leave it stopped with SIGSTOP if false.

Definition at line 1772 of file NativeProcessLinux.cpp.

References lldb_private::Status::AsCString(), lldb::eStateRunning, lldb_private::Status::Fail(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), HasThreadNoLock(), LLDB_INVALID_SIGNAL_NUMBER, LLDB_LOG, lldb_private::NativeProcessProtocol::m_threads, NotifyTracersOfNewThread(), POSIX_LOG_THREAD, ResumeThread(), lldb_private::NativeProcessProtocol::SetCurrentThreadID(), lldb_private::process_linux::NativeThreadLinux::SetStoppedByProcessorTrace(), lldb_private::process_linux::NativeThreadLinux::SetStoppedBySignal(), SIGSTOP, and StopRunningThreads().

Referenced by MonitorClone(), and NativeProcessLinux().

◆ AllocateMemory()

llvm::Expected< addr_t > NativeProcessLinux::AllocateMemory	(	size_t	size,
		uint32_t	permissions
	)

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1386 of file NativeProcessLinux.cpp.

References GetCurrentThread(), lldb_private::process_linux::NativeRegisterContextLinux::GetMmapData(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), m_allocated_memory, MAP_PRIVATE, PROT_EXEC, PROT_NONE, PROT_READ, PROT_WRITE, and Syscall().

◆ Attach()

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

staticprivate

Definition at line 337 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()

llvm::Error NativeProcessLinux::DeallocateMemory ( lldb::addr_t addr )

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1412 of file NativeProcessLinux.cpp.

References GetCurrentThread(), lldb_private::process_linux::NativeRegisterContextLinux::GetMmapData(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), m_allocated_memory, and Syscall().

◆ Detach() [1/2]

Status NativeProcessLinux::Detach ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1048 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::IntelPTManager::Clear(), error(), lldb_private::Status::Fail(), lldb_private::NativeProcessProtocol::GetID(), LLDB_INVALID_PROCESS_ID, m_intel_pt_manager, m_sigchld_handle, and lldb_private::NativeProcessProtocol::m_threads.

◆ Detach() [2/2]

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

private

Definition at line 1713 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 1294 of file NativeProcessLinux.cpp.

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

◆ GetArchitecture()

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

inlineoverridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 91 of file NativeProcessLinux.h.

References m_arch.

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 110 of file NativeProcessLinux.h.

References lldb_private::NativeProcessProtocol::GetID(), and lldb_private::getProcFile().

◆ GetCurrentThread()

NativeThreadLinux * NativeProcessLinux::GetCurrentThread ( )

Definition at line 1842 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::GetCurrentThread().

Referenced by AllocateMemory(), DeallocateMemory(), ReadMemoryTags(), and WriteMemoryTags().

◆ 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 1708 of file NativeProcessLinux.cpp.

References message(), and 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 1820 of file NativeProcessLinux.cpp.

References error(), LLDB_INVALID_ADDRESS, m_mem_region_cache, and PopulateMemoryRegionCache().

◆ GetLoadedModuleFileSpec()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1800 of file NativeProcessLinux.cpp.

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

◆ GetMemoryRegionInfo()

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

overridevirtual

◆ 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 1704 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 1581 of file NativeProcessLinux.cpp.

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

◆ GetThreadByID()

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

Definition at line 1837 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::GetThreadByID().

Referenced by MonitorCallback(), MonitorClone(), and Syscall().

◆ Halt()

Status NativeProcessLinux::Halt ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1039 of file NativeProcessLinux.cpp.

References error(), lldb_private::NativeProcessProtocol::GetID(), and SIGSTOP.

◆ HasThreadNoLock()

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

private

Definition at line 1720 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 1083 of file NativeProcessLinux.cpp.

References error(), 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

◆ MonitorBreakpoint()

void NativeProcessLinux::MonitorBreakpoint ( NativeThreadLinux & thread )

private

Definition at line 771 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::FixupBreakpointPCAsNeeded(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::GetLogIfAnyCategoriesSet(), LIBLLDB_LOG_BREAKPOINTS, LIBLLDB_LOG_PROCESS, LLDB_LOG, lldb_private::NativeProcessSoftwareSingleStep::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

◆ MonitorClone()

bool NativeProcessLinux::MonitorClone	(	lldb::pid_t	child_pid,
		llvm::Optional< CloneInfo >	clone_info
	)

private

Definition at line 890 of file NativeProcessLinux.cpp.

Referenced by MonitorCallback(), MonitorSIGTRAP(), and WaitForCloneNotification().

◆ MonitorSignal()

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

private

Definition at line 803 of file NativeProcessLinux.cpp.

References error(), 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 578 of file NativeProcessLinux.cpp.

Referenced by MonitorCallback().

◆ MonitorTrace()

void NativeProcessLinux::MonitorTrace ( NativeThreadLinux & thread )

private

Definition at line 761 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 787 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

◆ NotifyTracersOfNewThread()

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

private

Start tracing a new thread if process tracing is enabled.

Trace mechanisms should modify this method to provide automatic tracing for new threads.

Definition at line 1753 of file NativeProcessLinux.cpp.

References error(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, m_intel_pt_manager, lldb_private::process_linux::IntelPTManager::OnThreadCreated(), and POSIX_LOG_THREAD.

Referenced by AddThread().

◆ NotifyTracersOfThreadDestroyed()

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

private

Stop tracing threads upon a destroy event.

Trace mechanisms should modify this method to provide automatic trace stopping for threads being destroyed.

Definition at line 1762 of file NativeProcessLinux.cpp.

References error(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, m_intel_pt_manager, lldb_private::process_linux::IntelPTManager::OnThreadDestroyed(), and POSIX_LOG_THREAD.

Referenced by StopTrackingThread().

◆ 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 1980 of file NativeProcessLinux.cpp.

References error(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), LLDB_LOG, POSIX_LOG_PTRACE, PTRACE_GETREGSET, PTRACE_SETREGSET, and PtraceDisplayBytes().

◆ 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 1603 of file NativeProcessLinux.cpp.

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

Referenced by Syscall(), and WriteMemory().

◆ ReadMemoryTags()

Status NativeProcessLinux::ReadMemoryTags	(	int32_t	type,
		lldb::addr_t	addr,
		size_t	len,
		std::vector< uint8_t > &	tags
	)

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1432 of file NativeProcessLinux.cpp.

References error(), lldb_private::Range< B, S >::GetByteSize(), GetCurrentThread(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::process_linux::NativeRegisterContextLinux::GetMemoryTaggingDetails(), lldb_private::Range< B, S >::GetRangeBase(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), and PtraceWrapper().

Referenced by lldb_private::process_linux::NativeThreadLinux::AnnotateSyncTagCheckFault().

◆ RemoveBreakpoint()

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

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1573 of file NativeProcessLinux.cpp.

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

Referenced by 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 1847 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 AddThread(), MonitorCallback(), MonitorClone(), MonitorSignal(), MonitorSIGTRAP(), and Resume().

◆ SetBreakpoint()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1565 of file NativeProcessLinux.cpp.

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

◆ SetDefaultPtraceOpts()

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

staticprivate

Definition at line 401 of file NativeProcessLinux.cpp.

References PtraceWrapper().

Referenced by Attach().

◆ SigchldHandler()

void NativeProcessLinux::SigchldHandler ( )

private

Definition at line 1947 of file NativeProcessLinux.cpp.

References lldb_private::WaitStatus::Decode(), lldb::eErrorTypePOSIX, error(), 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 1070 of file NativeProcessLinux.cpp.

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

◆ SignalIfAllThreadsStopped()

void NativeProcessLinux::SignalIfAllThreadsStopped ( )

private

Definition at line 1906 of file NativeProcessLinux.cpp.

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

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

◆ StopRunningThreads()

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

private

Definition at line 1888 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 AddThread(), Interrupt(), MonitorBreakpoint(), MonitorClone(), MonitorSignal(), MonitorSIGTRAP(), MonitorTrace(), and MonitorWatchpoint().

◆ StopTrackingThread()

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

private

Definition at line 1733 of file NativeProcessLinux.cpp.

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

Referenced by MonitorCallback().

◆ SupportHardwareSingleStepping()

bool NativeProcessLinux::SupportHardwareSingleStepping ( ) const

Definition at line 969 of file NativeProcessLinux.cpp.

References lldb_private::ArchSpec::GetMachine(), lldb_private::ArchSpec::IsMIPS(), and m_arch.

Referenced by Resume(), and Syscall().

◆ Syscall()

llvm::Expected< uint64_t > NativeProcessLinux::Syscall ( llvm::ArrayRef< uint64_t > args )

protected

Definition at line 1303 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::NativeRegisterContextLinux::SyscallData::Args, lldb::eStateStopped, lldb_private::MemoryRegionInfo::eYes, lldb_private::ArchSpec::GetAddressByteSize(), lldb_private::NativeThreadProtocol::GetID(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), lldb_private::process_linux::NativeThreadLinux::GetState(), lldb_private::process_linux::NativeRegisterContextLinux::GetSyscallData(), GetThreadByID(), lldb_private::process_linux::NativeRegisterContextLinux::SyscallData::Insn, m_arch, m_mem_region_cache, PopulateMemoryRegionCache(), PtraceWrapper(), lldb_private::NativeRegisterContext::ReadAllRegisterValues(), ReadMemory(), lldb_private::NativeRegisterContext::ReadRegisterAsUnsigned(), lldb_private::process_linux::NativeRegisterContextLinux::SyscallData::Result, lldb_private::NativeRegisterContext::SetPC(), SupportHardwareSingleStepping(), lldb_private::Status::ToError(), lldb_private::NativeRegisterContext::WriteAllRegisterValues(), and WriteMemory().

Referenced by AllocateMemory(), and DeallocateMemory().

◆ ThreadWasCreated()

void NativeProcessLinux::ThreadWasCreated ( NativeThreadLinux & thread )

private

Definition at line 1935 of file NativeProcessLinux.cpp.

References lldb_private::NativeThreadProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), lldb_private::process_linux::NativeThreadLinux::GetState(), LLDB_INVALID_THREAD_ID, LLDB_LOG, m_pending_notification_tid, POSIX_LOG_THREAD, lldb_private::process_linux::NativeThreadLinux::RequestStop(), and lldb_private::StateIsRunningState().

Referenced by MonitorClone(), MonitorSIGTRAP(), and NativeProcessLinux().

◆ TraceGetBinaryData()

Expected< std::vector< uint8_t > > NativeProcessLinux::TraceGetBinaryData ( const TraceGetBinaryDataRequest & request )

overridevirtual

Get binary data given a trace technology and a data identifier.

Parameters

[in] request Object with the params of the requested data.

Returns: A vector of bytes with the requested data, or an llvm::Error in case of failures.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 2049 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::IntelPTManager::GetBinaryData(), m_intel_pt_manager, lldb_private::NativeProcessProtocol::TraceGetBinaryData(), and lldb_private::TraceGetBinaryDataRequest::type.

◆ TraceGetState()

Expected< json::Value > NativeProcessLinux::TraceGetState ( llvm::StringRef type )

overridevirtual

Get the current tracing state of the process and its threads.

Parameters

[in] type Tracing technology type to consider.

Returns: A JSON object string with custom data depending on the trace technology, or an llvm::Error in case of errors.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 2043 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::IntelPTManager::GetState(), m_intel_pt_manager, and lldb_private::NativeProcessProtocol::TraceGetState().

◆ TraceStart()

Error NativeProcessLinux::TraceStart	(	llvm::StringRef	json_request,
		llvm::StringRef	type
	)

overridevirtual

Tracing These methods implement the jLLDBTrace packets.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 2021 of file NativeProcessLinux.cpp.

References m_intel_pt_manager, lldb_private::NativeProcessProtocol::m_threads, lldb_private::process_linux::IntelPTManager::TraceStart(), and lldb_private::NativeProcessProtocol::TraceStart().

◆ TraceStop()

Error NativeProcessLinux::TraceStop ( const TraceStopRequest & request )

overridevirtual

Stop tracing a live process or its threads.

Parameters

[in] request The information determining which threads or process to stop tracing.

Returns: llvm::Error::success if the operation was successful, or llvm::Error otherwise.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 2037 of file NativeProcessLinux.cpp.

References m_intel_pt_manager, lldb_private::process_linux::IntelPTManager::TraceStop(), lldb_private::NativeProcessProtocol::TraceStop(), and lldb_private::TraceStopRequest::type.

◆ TraceSupported()

llvm::Expected< TraceSupportedResponse > NativeProcessLinux::TraceSupported ( )

overridevirtual

Get the processor tracing type supported for this process.

Responses might be different depending on the architecture and capabilities of the underlying OS.

Returns: The supported trace type or an llvm::Error if tracing is not supported for the inferior.

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 2015 of file NativeProcessLinux.cpp.

References lldb_private::process_linux::IntelPTManager::IsSupported(), and lldb_private::NativeProcessProtocol::TraceSupported().

◆ UpdateThreads()

size_t NativeProcessLinux::UpdateThreads ( )

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1558 of file NativeProcessLinux.cpp.

References lldb_private::NativeProcessProtocol::m_threads.

◆ WaitForCloneNotification()

void NativeProcessLinux::WaitForCloneNotification ( ::pid_t pid )

private

Definition at line 542 of file NativeProcessLinux.cpp.

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

Referenced by MonitorSIGTRAP().

◆ WriteMemory()

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

overridevirtual

Implements lldb_private::NativeProcessProtocol.

Definition at line 1658 of file NativeProcessLinux.cpp.

References error(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::ProcessPOSIXLog::GetLogIfAllCategoriesSet(), k_ptrace_word_size, LLDB_LOG, POSIX_LOG_MEMORY, PtraceWrapper(), and ReadMemory().

Referenced by Syscall().

◆ WriteMemoryTags()

Status NativeProcessLinux::WriteMemoryTags	(	int32_t	type,
		lldb::addr_t	addr,
		size_t	len,
		const std::vector< uint8_t > &	tags
	)

overridevirtual

Reimplemented from lldb_private::NativeProcessProtocol.

Definition at line 1487 of file NativeProcessLinux.cpp.

References error(), GetCurrentThread(), lldb_private::NativeProcessProtocol::GetID(), lldb_private::process_linux::NativeRegisterContextLinux::GetMemoryTaggingDetails(), lldb_private::Range< B, S >::GetRangeBase(), lldb_private::process_linux::NativeThreadLinux::GetRegisterContext(), and PtraceWrapper().

Member Data Documentation

◆ m_allocated_memory

llvm::DenseMap<lldb::addr_t, lldb::addr_t> lldb_private::process_linux::NativeProcessLinux::m_allocated_memory

private

Inferior memory (allocated by us) and its size.

Definition at line 155 of file NativeProcessLinux.h.

Referenced by AllocateMemory(), and DeallocateMemory().

◆ m_arch

ArchSpec lldb_private::process_linux::NativeProcessLinux::m_arch

private

Definition at line 146 of file NativeProcessLinux.h.

Referenced by GetArchitecture(), MonitorClone(), SupportHardwareSingleStepping(), and Syscall().

◆ m_intel_pt_manager

IntelPTManager lldb_private::process_linux::NativeProcessLinux::m_intel_pt_manager

private

Manages Intel PT process and thread traces.

Definition at line 245 of file NativeProcessLinux.h.

Referenced by Detach(), NotifyTracersOfNewThread(), NotifyTracersOfThreadDestroyed(), TraceGetBinaryData(), TraceGetState(), TraceStart(), and TraceStop().

◆ m_main_loop

MainLoop& lldb_private::process_linux::NativeProcessLinux::m_main_loop

private

Definition at line 147 of file NativeProcessLinux.h.

Referenced by MonitorClone().

◆ m_mem_region_cache

std::vector<std::pair<MemoryRegionInfo, FileSpec> > lldb_private::process_linux::NativeProcessLinux::m_mem_region_cache

private

Definition at line 150 of file NativeProcessLinux.h.

Referenced by DoStopIDBumped(), GetFileLoadAddress(), GetLoadedModuleFileSpec(), GetMemoryRegionInfo(), PopulateMemoryRegionCache(), and Syscall().

◆ m_pending_notification_tid

lldb::tid_t lldb_private::process_linux::NativeProcessLinux::m_pending_notification_tid = LLDB_INVALID_THREAD_ID

private

Definition at line 152 of file NativeProcessLinux.h.

Referenced by MonitorSignal(), MonitorSIGTRAP(), ResumeThread(), SignalIfAllThreadsStopped(), StopRunningThreads(), and ThreadWasCreated().

◆ m_pending_pid_map

llvm::DenseMap<lldb::pid_t, llvm::Optional<CloneInfo> > lldb_private::process_linux::NativeProcessLinux::m_pending_pid_map

private

Definition at line 254 of file NativeProcessLinux.h.

Referenced by MonitorClone(), and WaitForCloneNotification().

◆ m_sigchld_handle

MainLoop::SignalHandleUP lldb_private::process_linux::NativeProcessLinux::m_sigchld_handle

private

Definition at line 145 of file NativeProcessLinux.h.

Referenced by Detach(), and NativeProcessLinux().

◆ m_supports_mem_region

LazyBool lldb_private::process_linux::NativeProcessLinux::m_supports_mem_region = eLazyBoolCalculate

private

Definition at line 149 of file NativeProcessLinux.h.

Referenced by GetMemoryRegionInfo(), and PopulateMemoryRegionCache().

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

Classes

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ NativeProcessLinux()

Member Function Documentation

◆ AddThread()

◆ AllocateMemory()

◆ Attach()

◆ DeallocateMemory()

◆ Detach() [1/2]

◆ Detach() [2/2]

◆ DoStopIDBumped()

◆ GetArchitecture()

◆ GetAuxvData()

◆ GetCurrentThread()

◆ GetEventMessage()

◆ GetFileLoadAddress()

◆ GetLoadedModuleFileSpec()

◆ GetMemoryRegionInfo()

◆ GetSignalInfo()

◆ GetSoftwareBreakpointTrapOpcode()

◆ GetThreadByID()

◆ Halt()

◆ HasThreadNoLock()

◆ Interrupt()

◆ Kill()

◆ MonitorBreakpoint()

◆ MonitorCallback()

◆ MonitorClone()

◆ MonitorSignal()

◆ MonitorSIGTRAP()

◆ MonitorTrace()

◆ MonitorWatchpoint()

◆ NotifyThreadDeath()

◆ NotifyTracersOfNewThread()

◆ NotifyTracersOfThreadDestroyed()

◆ PopulateMemoryRegionCache()

◆ PtraceWrapper()

◆ ReadMemory()

◆ ReadMemoryTags()

◆ RemoveBreakpoint()

◆ Resume()

◆ ResumeThread()

◆ SetBreakpoint()

◆ SetDefaultPtraceOpts()

◆ SigchldHandler()

◆ Signal()

◆ SignalIfAllThreadsStopped()

◆ StopRunningThreads()

◆ StopTrackingThread()

◆ SupportHardwareSingleStepping()

◆ Syscall()

◆ ThreadWasCreated()

◆ TraceGetBinaryData()

◆ TraceGetState()

◆ TraceStart()

◆ TraceStop()

◆ TraceSupported()

◆ UpdateThreads()

◆ WaitForCloneNotification()

◆ WriteMemory()

◆ WriteMemoryTags()

Member Data Documentation

◆ m_allocated_memory

◆ m_arch

◆ m_intel_pt_manager

◆ m_main_loop

◆ m_mem_region_cache

◆ m_pending_notification_tid

◆ m_pending_pid_map

◆ m_sigchld_handle

◆ m_supports_mem_region