lldb_private::process_gdb_remote::GDBRemoteCommunication Class Reference

#include <GDBRemoteCommunication.h>

Inheritance diagram for lldb_private::process_gdb_remote::GDBRemoteCommunication:

Collaboration diagram for lldb_private::process_gdb_remote::GDBRemoteCommunication:

Classes
class	ScopedTimeout

Public Types
enum	{ eBroadcastBitRunPacketSent = kLoUserBroadcastBit, eBroadcastBitGdbReadThreadGotNotify }
enum	PacketType { PacketType::Invalid = 0, PacketType::Standard, PacketType::Notify }
enum	PacketResult {   PacketResult::Success = 0, PacketResult::ErrorSendFailed, PacketResult::ErrorSendAck, PacketResult::ErrorReplyFailed,   PacketResult::ErrorReplyTimeout, PacketResult::ErrorReplyInvalid, PacketResult::ErrorReplyAck, PacketResult::ErrorDisconnected,   PacketResult::ErrorNoSequenceLock }
Public Types inherited from lldb_private::Communication
typedef void(*	ReadThreadBytesReceived) (void *baton, const void *src, size_t src_len)

Public Member Functions
	GDBRemoteCommunication (const char *comm_name, const char *listener_name)
	~GDBRemoteCommunication () override
PacketResult	GetAck ()
size_t	SendAck ()
size_t	SendNack ()
char	CalculcateChecksum (llvm::StringRef payload)
PacketType	CheckForPacket (const uint8_t *src, size_t src_len, StringExtractorGDBRemote &packet)
bool	GetSendAcks ()
std::chrono::seconds	SetPacketTimeout (std::chrono::seconds packet_timeout)
std::chrono::seconds	GetPacketTimeout () const
Status	StartDebugserverProcess (const char *url, Platform *platform, ProcessLaunchInfo &launch_info, uint16_t *port, const Args *inferior_args, int pass_comm_fd)
void	DumpHistory (Stream &strm)
void	SetPacketRecorder (repro::PacketRecorder *recorder)
Public Member Functions inherited from lldb_private::Communication
	FLAGS_ANONYMOUS_ENUM ()
	Communication (const char *broadcaster_name)
	Construct the Communication object with the specified name for the Broadcaster that this object inherits from. More...
	~Communication () override
	Destructor. More...
void	Clear ()
lldb::ConnectionStatus	Connect (const char *url, Status *error_ptr)
	Connect using the current connection by passing url to its connect function. More...
lldb::ConnectionStatus	Disconnect (Status *error_ptr=nullptr)
	Disconnect the communications connection if one is currently connected. More...
bool	IsConnected () const
	Check if the connection is valid. More...
bool	HasConnection () const
lldb_private::Connection *	GetConnection ()
size_t	Read (void *dst, size_t dst_len, const Timeout< std::micro > &timeout, lldb::ConnectionStatus &status, Status *error_ptr)
	Read bytes from the current connection. More...
size_t	Write (const void *src, size_t src_len, lldb::ConnectionStatus &status, Status *error_ptr)
	The actual write function that attempts to write to the communications protocol. More...
void	SetConnection (std::unique_ptr< Connection > connection)
	Sets the connection that it to be used by this class. More...
virtual bool	StartReadThread (Status *error_ptr=nullptr)
	Starts a read thread whose sole purpose it to read bytes from the current connection. More...
virtual bool	StopReadThread (Status *error_ptr=nullptr)
	Stops the read thread by cancelling it. More...
virtual bool	JoinReadThread (Status *error_ptr=nullptr)
bool	ReadThreadIsRunning ()
	Checks if there is a currently running read thread. More...
void	SetReadThreadBytesReceivedCallback (ReadThreadBytesReceived callback, void *callback_baton)
void	SynchronizeWithReadThread ()
	Wait for the read thread to process all outstanding data. More...
bool	GetCloseOnEOF () const
void	SetCloseOnEOF (bool b)
ConstString &	GetBroadcasterClass () const override
	This needs to be filled in if you are going to register the broadcaster with the broadcaster manager and do broadcaster class matching. More...
Public Member Functions inherited from lldb_private::Broadcaster
	Broadcaster (lldb::BroadcasterManagerSP manager_sp, const char *name)
	Construct with a broadcaster with a name. More...
virtual	~Broadcaster ()
	Destructor. More...
void	CheckInWithManager ()
void	BroadcastEvent (lldb::EventSP &event_sp)
	Broadcast an event which has no associated data. More...
void	BroadcastEventIfUnique (lldb::EventSP &event_sp)
void	BroadcastEvent (uint32_t event_type, const lldb::EventDataSP &event_data_sp)
void	BroadcastEvent (uint32_t event_type, EventData *event_data=nullptr)
void	BroadcastEventIfUnique (uint32_t event_type, EventData *event_data=nullptr)
void	Clear ()
virtual void	AddInitialEventsToListener (const lldb::ListenerSP &listener_sp, uint32_t requested_events)
uint32_t	AddListener (const lldb::ListenerSP &listener_sp, uint32_t event_mask)
	Listen for any events specified by event_mask. More...
ConstString	GetBroadcasterName ()
	Get the NULL terminated C string name of this Broadcaster object. More...
bool	GetEventNames (Stream &s, const uint32_t event_mask, bool prefix_with_broadcaster_name) const
	Get the event name(s) for one or more event bits. More...
void	SetEventName (uint32_t event_mask, const char *name)
	Set the name for an event bit. More...
const char *	GetEventName (uint32_t event_mask) const
bool	EventTypeHasListeners (uint32_t event_type)
bool	RemoveListener (const lldb::ListenerSP &listener_sp, uint32_t event_mask=UINT32_MAX)
	Removes a Listener from this broadcasters list and frees the event bits specified by event_mask that were previously acquired by listener (assuming listener was listening to this object) for other listener objects to use. More...
bool	HijackBroadcaster (const lldb::ListenerSP &listener_sp, uint32_t event_mask=UINT32_MAX)
	Provides a simple mechanism to temporarily redirect events from broadcaster. More...
bool	IsHijackedForEvent (uint32_t event_mask)
void	RestoreBroadcaster ()
	Restore the state of the Broadcaster from a previous hijack attempt. More...
lldb::BroadcasterManagerSP	GetManager ()

Static Public Member Functions
static llvm::Error	ConnectLocally (GDBRemoteCommunication &client, GDBRemoteCommunication &server)
static std::string	ExpandRLE (std::string)
	Expand GDB run-length encoding. More...
Static Public Member Functions inherited from lldb_private::Communication
static lldb::thread_result_t	ReadThread (lldb::thread_arg_t comm_ptr)
	The static read thread function. More...
static std::string	ConnectionStatusAsString (lldb::ConnectionStatus status)
static ConstString &	GetStaticBroadcasterClass ()

Protected Member Functions
PacketResult	SendPacketNoLock (llvm::StringRef payload)
PacketResult	SendRawPacketNoLock (llvm::StringRef payload, bool skip_ack=false)
PacketResult	ReadPacket (StringExtractorGDBRemote &response, Timeout< std::micro > timeout, bool sync_on_timeout)
PacketResult	ReadPacketWithOutputSupport (StringExtractorGDBRemote &response, Timeout< std::micro > timeout, bool sync_on_timeout, llvm::function_ref< void(llvm::StringRef)> output_callback)
PacketResult	PopPacketFromQueue (StringExtractorGDBRemote &response, Timeout< std::micro > timeout)
PacketResult	WaitForPacketNoLock (StringExtractorGDBRemote &response, Timeout< std::micro > timeout, bool sync_on_timeout)
bool	CompressionIsEnabled ()
bool	DecompressPacket ()
Status	StartListenThread (const char *hostname="127.0.0.1", uint16_t port=0)
bool	JoinListenThread ()
void	AppendBytesToCache (const uint8_t *bytes, size_t len, bool broadcast, lldb::ConnectionStatus status) override
	Append new bytes that get read from the read thread into the internal object byte cache. More...
Protected Member Functions inherited from lldb_private::Communication
size_t	ReadFromConnection (void *dst, size_t dst_len, const Timeout< std::micro > &timeout, lldb::ConnectionStatus &status, Status *error_ptr)
size_t	GetCachedBytes (void *dst, size_t dst_len)
	Get any available bytes from our data cache. More...
Protected Member Functions inherited from lldb_private::Broadcaster
BroadcasterImplSP	GetBroadcasterImpl ()
const char *	GetHijackingListenerName ()

Static Protected Member Functions
static lldb::thread_result_t	ListenThread (lldb::thread_arg_t arg)

Protected Attributes
std::chrono::seconds	m_packet_timeout
uint32_t	m_echo_number
LazyBool	m_supports_qEcho
GDBRemoteCommunicationHistory	m_history
bool	m_send_acks
bool	m_is_platform
CompressionType	m_compression_type
Protected Attributes inherited from lldb_private::Communication
lldb::ConnectionSP	m_connection_sp
	The connection that is current in use by this communications class. More...
HostThread	m_read_thread
	The read thread handle in case we need to cancel the thread. More...
std::atomic< bool >	m_read_thread_enabled
std::atomic< bool >	m_read_thread_did_exit
std::string	m_bytes
	A buffer to cache bytes read in the ReadThread function. More...
std::recursive_mutex	m_bytes_mutex
	A mutex to protect multi-threaded access to the cached bytes. More...
std::mutex	m_write_mutex
	Don't let multiple threads write at the same time... More...
std::mutex	m_synchronize_mutex
ReadThreadBytesReceived	m_callback
void *	m_callback_baton
bool	m_close_on_eof

Private Member Functions
	GDBRemoteCommunication (const GDBRemoteCommunication &)=delete
const GDBRemoteCommunication &	operator= (const GDBRemoteCommunication &)=delete

Private Attributes
std::queue< StringExtractorGDBRemote >	m_packet_queue
std::mutex	m_packet_queue_mutex
std::condition_variable	m_condition_queue_not_empty
HostThread	m_listen_thread
std::string	m_listen_url

Additional Inherited Members
Protected Types inherited from lldb_private::Broadcaster
typedef std::shared_ptr< BroadcasterImpl >	BroadcasterImplSP
typedef std::weak_ptr< BroadcasterImpl >	BroadcasterImplWP

Detailed Description

Definition at line 82 of file GDBRemoteCommunication.h.

Member Enumeration Documentation

anonymous enum

anonymous enum

Enumerator
eBroadcastBitRunPacketSent
eBroadcastBitGdbReadThreadGotNotify

Definition at line 84 of file GDBRemoteCommunication.h.

PacketResult

enum lldb_private::process_gdb_remote::GDBRemoteCommunication::PacketResult

strong

Enumerator
Success
ErrorSendFailed
ErrorSendAck
ErrorReplyFailed
ErrorReplyTimeout
ErrorReplyInvalid
ErrorReplyAck
ErrorDisconnected
ErrorNoSequenceLock

Definition at line 92 of file GDBRemoteCommunication.h.

PacketType

enum lldb_private::process_gdb_remote::GDBRemoteCommunication::PacketType

strong

Enumerator
Invalid
Standard
Notify

Definition at line 90 of file GDBRemoteCommunication.h.

Constructor & Destructor Documentation

GDBRemoteCommunication() [1/2]

GDBRemoteCommunication::GDBRemoteCommunication	(	const char *	comm_name,
		const char *	listener_name
	)

Definition at line 62 of file GDBRemoteCommunication.cpp.

References lldb_private::process_gdb_remote::None.

~GDBRemoteCommunication()

GDBRemoteCommunication::~GDBRemoteCommunication ( )

override

Definition at line 76 of file GDBRemoteCommunication.cpp.

References lldb_private::Communication::Disconnect(), lldb_private::Communication::IsConnected(), lldb_private::Communication::m_read_thread_enabled, and lldb_private::Communication::StopReadThread().

GDBRemoteCommunication() [2/2]

lldb_private::process_gdb_remote::GDBRemoteCommunication::GDBRemoteCommunication ( const GDBRemoteCommunication &  )

privatedelete

Member Function Documentation

AppendBytesToCache()

void GDBRemoteCommunication::AppendBytesToCache ( const uint8_t *  src, size_t  src_len, bool  broadcast, lldb::ConnectionStatus  status  )

overrideprotectedvirtual

Append new bytes that get read from the read thread into the internal object byte cache.

This will cause a eBroadcastBitReadThreadGotBytes event to be broadcast if broadcast is true.

Subclasses can override this function in order to inspect the received data and check if a packet is available.

Subclasses can also still call this function from the overridden method to allow the caching to correctly happen and suppress the broadcasting of the eBroadcastBitReadThreadGotBytes event by setting broadcast to false.

Parameters

[in]	src	A source buffer that must be at least src_len bytes long.
[in]	src_len	The number of bytes to append to the cache.

Reimplemented from lldb_private::Communication.

Definition at line 1288 of file GDBRemoteCommunication.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), CheckForPacket(), eBroadcastBitGdbReadThreadGotNotify, StringExtractor::GetStringRef(), Invalid, m_condition_queue_not_empty, m_packet_queue, m_packet_queue_mutex, Notify, and Standard.

CalculcateChecksum()

char GDBRemoteCommunication::CalculcateChecksum

(

llvm::StringRef

payload

)

Definition at line 92 of file GDBRemoteCommunication.cpp.

Referenced by CheckForPacket(), DecompressPacket(), and SendPacketNoLock().

CheckForPacket()

GDBRemoteCommunication::PacketType GDBRemoteCommunication::CheckForPacket	(	const uint8_t *	src,
		size_t	src_len,
		StringExtractorGDBRemote &	packet
	)

Definition at line 642 of file GDBRemoteCommunication.cpp.

References lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::AddPacket(), CalculcateChecksum(), StringExtractor::Clear(), CompressionIsEnabled(), DecompressPacket(), lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::DidDumpToLog(), lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::Dump(), lldb_private::GDBRemotePacket::ePacketTypeRecv, ExpandRLE(), GDBR_LOG_PACKETS, lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), GetSendAcks(), lldb_private::StreamString::GetString(), lldb_private::Log::GetVerbose(), Invalid, LLDB_LOGF, lldb_private::Communication::m_bytes, lldb_private::Communication::m_bytes_mutex, m_history, Notify, lldb_private::Stream::Printf(), lldb_private::Log::PutString(), SendAck(), SendNack(), StringExtractor::SetFilePos(), Standard, and string().

Referenced by AppendBytesToCache(), and WaitForPacketNoLock().

CompressionIsEnabled()

bool lldb_private::process_gdb_remote::GDBRemoteCommunication::CompressionIsEnabled ( )

inlineprotected

Definition at line 206 of file GDBRemoteCommunication.h.

References m_compression_type, and lldb_private::process_gdb_remote::None.

Referenced by CheckForPacket(), and DecompressPacket().

ConnectLocally()

llvm::Error GDBRemoteCommunication::ConnectLocally ( GDBRemoteCommunication &  client, GDBRemoteCommunication &  server  )

static

Definition at line 1231 of file GDBRemoteCommunication.cpp.

References lldb_private::TCPSocket::Accept(), lldb_private::Status::AsCString(), lldb::eConnectionStatusSuccess, error(), lldb_private::TCPSocket::GetLocalPortNumber(), lldb_private::TCPSocket::Listen(), lldb_private::Communication::SetConnection(), and lldb_private::Status::ToError().

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationReplayServer::Connect().

DecompressPacket()

bool GDBRemoteCommunication::DecompressPacket ( )

protected

Definition at line 412 of file GDBRemoteCommunication.cpp.

References CalculcateChecksum(), CompressionIsEnabled(), GDBR_LOG_PACKETS, lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), GetSendAcks(), LLDB_LOGF, lldb_private::process_gdb_remote::LZ4, lldb_private::process_gdb_remote::LZFSE, lldb_private::process_gdb_remote::LZMA, lldb_private::Communication::m_bytes, m_compression_type, SendAck(), SendNack(), string(), x20, and lldb_private::process_gdb_remote::ZlibDeflate.

Referenced by CheckForPacket().

DumpHistory()

void GDBRemoteCommunication::DumpHistory

(

Stream &

strm

)

Definition at line 1223 of file GDBRemoteCommunication.cpp.

References lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::Dump(), and m_history.

Referenced by CommandObjectProcessGDBRemotePacketHistory::DoExecute(), lldb_private::process_gdb_remote::GDBRemoteRegisterContext::ReadAllRegisterValues(), lldb_private::process_gdb_remote::GDBRemoteRegisterContext::WriteAllRegisterValues(), and lldb_private::process_gdb_remote::GDBRemoteRegisterContext::WriteRegisterBytes().

ExpandRLE()

std::string GDBRemoteCommunication::ExpandRLE ( std::string  packet )

static

Expand GDB run-length encoding.

Definition at line 1365 of file GDBRemoteCommunication.cpp.

References string().

Referenced by CheckForPacket(), and lldb_private::process_gdb_remote::GDBRemoteCommunicationReplayServer::GetPacketAndSendResponse().

GetAck()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::GetAck

(

)

Definition at line 195 of file GDBRemoteCommunication.cpp.

References ErrorSendAck, GetPacketTimeout(), StringExtractorGDBRemote::GetResponseType(), ReadPacket(), and Success.

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationReplayServer::HandshakeWithClient(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::HandshakeWithClient(), and SendRawPacketNoLock().

GetPacketTimeout()

std::chrono::seconds lldb_private::process_gdb_remote::GDBRemoteCommunication::GetPacketTimeout ( ) const

inline

Definition at line 152 of file GDBRemoteCommunication.h.

References m_packet_timeout.

Referenced by GetAck(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::QueryNoAckModeSupported(), lldb_private::process_gdb_remote::GDBRemoteCommunication::ScopedTimeout::ScopedTimeout(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendPacketAndReceiveResponseWithOutputSupport(), and lldb_private::process_gdb_remote::GDBRemoteClientBase::SendPacketAndWaitForResponseNoLock().

GetSendAcks()

bool lldb_private::process_gdb_remote::GDBRemoteCommunication::GetSendAcks ( )

inline

Definition at line 139 of file GDBRemoteCommunication.h.

References m_send_acks.

Referenced by CheckForPacket(), DecompressPacket(), and SendRawPacketNoLock().

JoinListenThread()

bool GDBRemoteCommunication::JoinListenThread ( )

protected

Definition at line 882 of file GDBRemoteCommunication.cpp.

References lldb_private::HostThread::IsJoinable(), lldb_private::HostThread::Join(), and m_listen_thread.

Referenced by StartDebugserverProcess().

ListenThread()

lldb::thread_result_t GDBRemoteCommunication::ListenThread ( lldb::thread_arg_t  arg )

staticprotected

Definition at line 889 of file GDBRemoteCommunication.cpp.

References lldb_private::ConnectionFileDescriptor::Connect(), lldb::eConnectionStatusSuccess, error(), lldb_private::Communication::GetConnection(), m_listen_url, and lldb_private::Communication::SetConnection().

Referenced by StartListenThread().

operator=()

const GDBRemoteCommunication& lldb_private::process_gdb_remote::GDBRemoteCommunication::operator= ( const GDBRemoteCommunication &  )

privatedelete

PopPacketFromQueue()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::PopPacketFromQueue ( StringExtractorGDBRemote &  response, Timeout< std::micro >  timeout  )

protected

Definition at line 240 of file GDBRemoteCommunication.cpp.

References ErrorDisconnected, ErrorReplyTimeout, lldb_private::Communication::IsConnected(), m_condition_queue_not_empty, m_packet_queue, m_packet_queue_mutex, and Success.

Referenced by ReadPacket().

ReadPacket()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::ReadPacket ( StringExtractorGDBRemote &  response, Timeout< std::micro >  timeout, bool  sync_on_timeout  )

protected

Definition at line 226 of file GDBRemoteCommunication.cpp.

References lldb_private::Communication::m_read_thread_enabled, PopPacketFromQueue(), and WaitForPacketNoLock().

Referenced by GetAck(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::HandshakeWithServer(), ReadPacketWithOutputSupport(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendContinuePacketAndWaitForResponse(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendPacketAndWaitForResponseNoLock(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendvContPacket(), and lldb_private::process_gdb_remote::GDBRemoteClientBase::ShouldStop().

ReadPacketWithOutputSupport()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::ReadPacketWithOutputSupport ( StringExtractorGDBRemote &  response, Timeout< std::micro >  timeout, bool  sync_on_timeout, llvm::function_ref< void(llvm::StringRef)>  output_callback  )

protected

Definition at line 209 of file GDBRemoteCommunication.cpp.

References StringExtractor::GetChar(), StringExtractor::GetHexByteString(), StringExtractorGDBRemote::IsNormalResponse(), StringExtractor::PeekChar(), ReadPacket(), string(), and Success.

Referenced by lldb_private::process_gdb_remote::GDBRemoteClientBase::SendPacketAndReceiveResponseWithOutputSupport().

SendAck()

size_t GDBRemoteCommunication::SendAck

(

)

Definition at line 101 of file GDBRemoteCommunication.cpp.

References lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::AddPacket(), lldb::eConnectionStatusSuccess, lldb_private::GDBRemotePacket::ePacketTypeSend, GDBR_LOG_PACKETS, lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), LLDB_LOGF, m_history, and lldb_private::Communication::Write().

Referenced by CheckForPacket(), DecompressPacket(), and lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::HandshakeWithServer().

SendNack()

size_t GDBRemoteCommunication::SendNack

(

)

Definition at line 111 of file GDBRemoteCommunication.cpp.

References lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::AddPacket(), lldb::eConnectionStatusSuccess, lldb_private::GDBRemotePacket::ePacketTypeSend, GDBR_LOG_PACKETS, lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), LLDB_LOGF, m_history, and lldb_private::Communication::Write().

Referenced by CheckForPacket(), and DecompressPacket().

SendPacketNoLock()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::SendPacketNoLock ( llvm::StringRef  payload )

protected

Definition at line 122 of file GDBRemoteCommunication.cpp.

References CalculcateChecksum(), lldb::eByteOrderBig, lldb_private::StreamString::GetString(), lldb_private::Stream::PutChar(), lldb_private::Stream::PutHex8(), SendRawPacketNoLock(), string(), and lldb_private::Stream::Write().

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle__M(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_g(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_jLLDBTraceGetBinaryData(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_jModulesInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_jSignalsInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_jThreadsInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_memory_read(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_p(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qC(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qC(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qEcho(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qFileLoadAddress(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qfThreadInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qGetWorkingDir(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qGetWorkingDir(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qGroupName(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qHostInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qLaunchGDBServer(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qLaunchSuccess(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qMemoryRegionInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qMemTags(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qModuleInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qPathComplete(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qPlatform_chmod(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qPlatform_mkdir(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qPlatform_shell(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qProcessInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qProcessInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qProcessInfoPID(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qQueryGDBServer(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qRegisterInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qSaveCore(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_QSaveRegisterState(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qSpeedTest(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qsProcessInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qsThreadInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qSupported(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_qUserName(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qWatchpointSupportInfo(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_qXfer(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::Handle_vCont_actions(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_Close(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_Exists(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_FStat(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_MD5(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_Mode(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_Open(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_pRead(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_pWrite(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_Size(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_symlink(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_vFile_unlink(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::SendErrorResponse(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::SendOKResponse(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::SendONotification(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendPacketAndReceiveResponseWithOutputSupport(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendPacketAndWaitForResponseNoLock(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::SendStopReplyPacketForThread(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::SendUnimplementedResponse(), lldb_private::process_gdb_remote::GDBRemoteClientBase::SendvContPacket(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerLLGS::SendWResponse(), and WaitForPacketNoLock().

SendRawPacketNoLock()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::SendRawPacketNoLock ( llvm::StringRef  payload, bool  skip_ack = false  )

protected

Definition at line 134 of file GDBRemoteCommunication.cpp.

References lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::AddPacket(), lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::DidDumpToLog(), lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::Dump(), lldb::eConnectionStatusSuccess, lldb_private::GDBRemotePacket::ePacketTypeSend, ErrorSendFailed, GDBR_LOG_PACKETS, GetAck(), lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), GetSendAcks(), lldb_private::StreamString::GetString(), lldb_private::Communication::IsConnected(), LLDB_LOGF, m_history, lldb_private::Stream::Printf(), lldb_private::Log::PutString(), Success, and lldb_private::Communication::Write().

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationReplayServer::GetPacketAndSendResponse(), and SendPacketNoLock().

SetPacketRecorder()

void GDBRemoteCommunication::SetPacketRecorder

(

repro::PacketRecorder *

recorder

)

Definition at line 1225 of file GDBRemoteCommunication.cpp.

References m_history, and lldb_private::process_gdb_remote::GDBRemoteCommunicationHistory::SetRecorder().

Referenced by lldb_private::platform_gdb_server::PlatformRemoteGDBServer::ConnectRemote().

SetPacketTimeout()

std::chrono::seconds lldb_private::process_gdb_remote::GDBRemoteCommunication::SetPacketTimeout ( std::chrono::seconds  packet_timeout )

inline

Definition at line 146 of file GDBRemoteCommunication.h.

References m_packet_timeout.

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetHostInfo(), lldb_private::platform_gdb_server::PlatformRemoteGDBServer::PlatformRemoteGDBServer(), and lldb_private::process_gdb_remote::GDBRemoteCommunication::ScopedTimeout::ScopedTimeout().

StartDebugserverProcess()

Status GDBRemoteCommunication::StartDebugserverProcess	(	const char *	url,
		Platform *	platform,
		ProcessLaunchInfo &	launch_info,
		uint16_t *	port,
		const Args *	inferior_args,
		int	pass_comm_fd
	)

Definition at line 904 of file GDBRemoteCommunication.cpp.

References lldb_private::Args::AppendArgument(), lldb_private::Args::AppendArguments(), lldb_private::ProcessLaunchInfo::AppendCloseFileAction(), lldb_private::ProcessLaunchInfo::AppendDuplicateFileAction(), lldb_private::FileSpec::AppendPathComponent(), lldb_private::ProcessLaunchInfo::AppendSuppressFileAction(), lldb_private::FileSpec::Clear(), lldb_private::Args::Clear(), DEBUGSERVER_BASENAME, lldb_private::ProcessInfo::Dump(), error(), lldb_private::FileSystem::Exists(), GDBR_LOG_PROCESS, lldb_private::Args::GetArgumentCount(), lldb_private::ProcessInfo::GetArguments(), lldb_private::Communication::GetConnection(), lldb_private::StreamString::GetData(), lldb_private::ProcessInfo::GetEnvironment(), lldb_private::Host::GetEnvironment(), lldb_private::ProcessInfo::GetExecutableFile(), lldb_private::ProcessLaunchInfo::GetLaunchInSeparateProcessGroup(), lldb_private::ConnectionFileDescriptor::GetListeningPort(), lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), lldb_private::FileSpec::GetPath(), lldb_private::ProcessInfo::GetProcessID(), lldb_private::StreamString::GetString(), lldb_private::FileSystem::Instance(), JoinListenThread(), lldb_private::Host::LaunchProcess(), LLDB_INVALID_PROCESS_ID, LLDB_LOGF, lldb_private::Platform::LocateExecutable(), PATH_MAX, lldb_private::Stream::Printf(), lldb_private::FileSpec::SetFile(), StartListenThread(), string(), and lldb_private::StringConvert::ToUInt32().

Referenced by lldb_private::process_gdb_remote::ProcessGDBRemote::LaunchAndConnectToDebugserver(), and lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::LaunchGDBServer().

StartListenThread()

Status GDBRemoteCommunication::StartListenThread ( const char *  hostname = "127.0.0.1", uint16_t  port = 0  )

protected

Definition at line 861 of file GDBRemoteCommunication.cpp.

References lldb_private::HostThread::IsJoinable(), lldb_private::ThreadLauncher::LaunchThread(), ListenThread(), m_listen_thread, m_listen_url, and lldb_private::Communication::SetConnection().

Referenced by StartDebugserverProcess().

WaitForPacketNoLock()

GDBRemoteCommunication::PacketResult GDBRemoteCommunication::WaitForPacketNoLock ( StringExtractorGDBRemote &  response, Timeout< std::micro >  timeout, bool  sync_on_timeout  )

protected

Sync the remote GDB server and make sure we get a response that corresponds to what we send.

Sends a "qEcho" packet and makes sure it gets the exact packet echoed back. If the qEcho packet isn't supported, we send a qC packet and make sure we get a valid thread ID back. We use the "qC" packet since its response if very unique: is responds with "QC%x" where x is the thread ID of the current thread. This makes the response unique enough from other packet responses to ensure we are back on track.

This packet is needed after we time out sending a packet so we can ensure that we are getting the response for the packet we are sending. There are no sequence IDs in the GDB remote protocol (there used to be, but they are not supported anymore) so if you timeout sending packet "abc", you might then send packet "cde" and get the response for the previous "abc" packet. Many responses are "OK" or "" (unsupported) or "EXX" (error) so many responses for packets can look like responses for other packets. So if we timeout, we need to ensure that we can get back on track. If we can't get back on track, we must disconnect.

Definition at line 266 of file GDBRemoteCommunication.cpp.

References CheckForPacket(), StringExtractor::Clear(), lldb_private::Communication::ConnectionStatusAsString(), lldb_private::Communication::Disconnect(), lldb::eConnectionStatusEndOfFile, lldb::eConnectionStatusError, lldb::eConnectionStatusInterrupted, lldb::eConnectionStatusLostConnection, lldb::eConnectionStatusNoConnection, lldb::eConnectionStatusSuccess, lldb::eConnectionStatusTimedOut, lldb_private::eLazyBoolYes, error(), ErrorDisconnected, ErrorReplyFailed, ErrorReplyTimeout, lldb_private::RegularExpression::Execute(), GDBR_LOG_PACKETS, lldb_private::process_gdb_remote::ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(), StringExtractor::GetStringRef(), Invalid, lldb_private::Communication::IsConnected(), LLDB_LOGV, m_echo_number, m_supports_qEcho, lldb_private::Communication::Read(), SendPacketNoLock(), string(), and Success.

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::GetPacketAndSendResponse(), lldb_private::process_gdb_remote::GDBRemoteCommunicationReplayServer::GetPacketAndSendResponse(), and ReadPacket().

Member Data Documentation

m_compression_type

CompressionType lldb_private::process_gdb_remote::GDBRemoteCommunication::m_compression_type

protected

Definition at line 184 of file GDBRemoteCommunication.h.

Referenced by CompressionIsEnabled(), DecompressPacket(), and lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::MaybeEnableCompression().

m_condition_queue_not_empty

std::condition_variable lldb_private::process_gdb_remote::GDBRemoteCommunication::m_condition_queue_not_empty

private

Definition at line 245 of file GDBRemoteCommunication.h.

Referenced by AppendBytesToCache(), and PopPacketFromQueue().

m_echo_number

uint32_t lldb_private::process_gdb_remote::GDBRemoteCommunication::m_echo_number

protected

Definition at line 176 of file GDBRemoteCommunication.h.

Referenced by WaitForPacketNoLock().

m_history

GDBRemoteCommunicationHistory lldb_private::process_gdb_remote::GDBRemoteCommunication::m_history

protected

Definition at line 178 of file GDBRemoteCommunication.h.

Referenced by CheckForPacket(), DumpHistory(), SendAck(), SendNack(), SendRawPacketNoLock(), and SetPacketRecorder().

m_is_platform

bool lldb_private::process_gdb_remote::GDBRemoteCommunication::m_is_platform

protected

Definition at line 180 of file GDBRemoteCommunication.h.

m_listen_thread

HostThread lldb_private::process_gdb_remote::GDBRemoteCommunication::m_listen_thread

private

Definition at line 247 of file GDBRemoteCommunication.h.

Referenced by JoinListenThread(), and StartListenThread().

m_listen_url

std::string lldb_private::process_gdb_remote::GDBRemoteCommunication::m_listen_url

private

Definition at line 248 of file GDBRemoteCommunication.h.

Referenced by ListenThread(), and StartListenThread().

m_packet_queue

std::queue<StringExtractorGDBRemote> lldb_private::process_gdb_remote::GDBRemoteCommunication::m_packet_queue

private

Definition at line 242 of file GDBRemoteCommunication.h.

Referenced by AppendBytesToCache(), and PopPacketFromQueue().

m_packet_queue_mutex

std::mutex lldb_private::process_gdb_remote::GDBRemoteCommunication::m_packet_queue_mutex

private

Definition at line 243 of file GDBRemoteCommunication.h.

Referenced by AppendBytesToCache(), and PopPacketFromQueue().

m_packet_timeout

std::chrono::seconds lldb_private::process_gdb_remote::GDBRemoteCommunication::m_packet_timeout

protected

Definition at line 175 of file GDBRemoteCommunication.h.

Referenced by GetPacketTimeout(), and SetPacketTimeout().

m_send_acks

bool lldb_private::process_gdb_remote::GDBRemoteCommunication::m_send_acks

protected

Definition at line 179 of file GDBRemoteCommunication.h.

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationReplayServer::GetPacketAndSendResponse(), GetSendAcks(), lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::Handle_QStartNoAckMode(), and lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::QueryNoAckModeSupported().

m_supports_qEcho

LazyBool lldb_private::process_gdb_remote::GDBRemoteCommunication::m_supports_qEcho

protected

Definition at line 177 of file GDBRemoteCommunication.h.

Referenced by lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetEchoSupported(), lldb_private::process_gdb_remote::GDBRemoteCommunicationClient::GetRemoteQSupported(), and WaitForPacketNoLock().

---

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

• GDBRemoteCommunication.h
• GDBRemoteCommunication.cpp