#ifndef LLDB_SOURCE_PLUGINS_PROCESS_GDB_REMOTE_GDBREMOTECOMMUNICATIONCLIENT_H
#define LLDB_SOURCE_PLUGINS_PROCESS_GDB_REMOTE_GDBREMOTECOMMUNICATIONCLIENT_H
#include "GDBRemoteClientBase.h"
#include <chrono>
#include <map>
#include <mutex>
#include <optional>
#include <string>
#include <vector>
#include "lldb/Host/File.h"
#include "lldb/Utility/AddressableBits.h"
#include "lldb/Utility/ArchSpec.h"
#include "lldb/Utility/GDBRemote.h"
#include "lldb/Utility/ProcessInfo.h"
#include "lldb/Utility/StructuredData.h"
#include "lldb/Utility/TraceGDBRemotePackets.h"
#include "lldb/Utility/UUID.h"
#if defined(_WIN32)
#include "lldb/Host/windows/PosixApi.h"
#endif
#include "llvm/Support/VersionTuple.h"
#ifdef MS_DEBUGGER
#include "lldb/Utility//MessageDefines.h"
#endif
namespace lldb_private {
namespace process_gdb_remote {
struct QOffsets {
bool segments;
std::vector<uint64_t> offsets;
};
inline bool operator==(const QOffsets &a, const QOffsets &b) {
return a.segments == b.segments && a.offsets == b.offsets;
}
llvm::raw_ostream &operator<<(llvm::raw_ostream &os, const QOffsets &offsets);
struct PidTid {
uint64_t pid;
uint64_t tid;
};
class GDBRemoteCommunicationClient : public GDBRemoteClientBase {
public:
GDBRemoteCommunicationClient();
~GDBRemoteCommunicationClient() override;
bool HandshakeWithServer(Status *error_ptr);
bool GetThreadSuffixSupported();
bool QueryNoAckModeSupported();
void GetListThreadsInStopReplySupported();
lldb::pid_t GetCurrentProcessID(bool allow_lazy = true);
bool LaunchGDBServer(const char *remote_accept_hostname, lldb::pid_t &pid,
uint16_t &port, std::string &socket_name);
size_t QueryGDBServer(
std::vector<std::pair<uint16_t, std::string>> &connection_urls);
bool KillSpawnedProcess(lldb::pid_t pid);
llvm::Error LaunchProcess(const Args &args);
int SendEnvironmentPacket(char const *name_equal_value);
int SendEnvironment(const Environment &env);
int SendLaunchArchPacket(const char *arch);
int SendLaunchEventDataPacket(const char *data,
bool *was_supported = nullptr);
int SendStdinNotification(const char *data, size_t data_len);
int SetSTDIN(const FileSpec &file_spec);
int SetSTDOUT(const FileSpec &file_spec);
int SetSTDERR(const FileSpec &file_spec);
int SetDisableASLR(bool enable);
int SetDetachOnError(bool enable);
int SetWorkingDir(const FileSpec &working_dir);
bool GetWorkingDir(FileSpec &working_dir);
lldb::addr_t AllocateMemory(size_t size, uint32_t permissions);
bool DeallocateMemory(lldb::addr_t addr);
Status Detach(bool keep_stopped, lldb::pid_t pid = LLDB_INVALID_PROCESS_ID);
Status GetMemoryRegionInfo(lldb::addr_t addr, MemoryRegionInfo &range_info);
std::optional<uint32_t> GetWatchpointSlotCount();
std::optional<bool> GetWatchpointReportedAfter();
WatchpointHardwareFeature GetSupportedWatchpointTypes();
const ArchSpec &GetHostArchitecture();
std::chrono::seconds GetHostDefaultPacketTimeout();
const ArchSpec &GetProcessArchitecture();
bool GetProcessStandaloneBinary(UUID &uuid, lldb::addr_t &value,
bool &value_is_offset);
std::vector<lldb::addr_t> GetProcessStandaloneBinaries();
void GetRemoteQSupported();
bool GetVContSupported(char flavor);
bool GetpPacketSupported(lldb::tid_t tid);
bool GetxPacketSupported();
bool GetVAttachOrWaitSupported();
bool GetSyncThreadStateSupported();
void ResetDiscoverableSettings(bool did_exec);
bool GetHostInfo(bool force = false);
bool GetDefaultThreadId(lldb::tid_t &tid);
llvm::VersionTuple GetOSVersion();
llvm::VersionTuple GetMacCatalystVersion();
std::optional<std::string> GetOSBuildString();
std::optional<std::string> GetOSKernelDescription();
ArchSpec GetSystemArchitecture();
lldb_private::AddressableBits GetAddressableBits();
bool GetHostname(std::string &s);
lldb::addr_t GetShlibInfoAddr();
bool GetProcessInfo(lldb::pid_t pid, ProcessInstanceInfo &process_info);
uint32_t FindProcesses(const ProcessInstanceInfoMatch &process_match_info,
ProcessInstanceInfoList &process_infos);
bool GetUserName(uint32_t uid, std::string &name);
bool GetGroupName(uint32_t gid, std::string &name);
bool HasFullVContSupport() { return GetVContSupported('A'); }
bool HasAnyVContSupport() { return GetVContSupported('a'); }
bool GetStopReply(StringExtractorGDBRemote &response);
bool GetThreadStopInfo(lldb::tid_t tid, StringExtractorGDBRemote &response);
bool SupportsGDBStoppointPacket(GDBStoppointType type) {
switch (type) {
case eBreakpointSoftware:
return m_supports_z0;
case eBreakpointHardware:
return m_supports_z1;
case eWatchpointWrite:
return m_supports_z2;
case eWatchpointRead:
return m_supports_z3;
case eWatchpointReadWrite:
return m_supports_z4;
default:
return false;
}
}
uint8_t SendGDBStoppointTypePacket(
GDBStoppointType type,
bool insert,
lldb::addr_t addr,
uint32_t length,
std::chrono::seconds interrupt_timeout);
#ifdef MS_DEBUGGER
lldb::DataBufferSP ReadDeviceRegister(lldb::tid_t tid, uint32_t reg);
uint8_t SendGDBStoppointTypePacket(
GDBStoppointType type,
bool insert,
lldb::addr_t addr,
uint32_t length,
std::chrono::seconds interrupt_timeout,
const ArchSpec &arch_spec);
uint8_t SendDeviceAicOnFocusPacket(
int32_t core_id,
std::chrono::seconds timeout);
uint8_t SendDeviceRuningMode(
bool IsSingleCoreRun,
std::chrono::seconds timeout);
uint8_t SendDeviceAivOnFocusPacket(
int32_t core_id,
std::chrono::seconds timeout);
uint8_t SendDeviceThreadOnFocusPacket(
const int32_t linear_idx,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBAscendInfoDevicePacket(
DeviceInfo &device_info,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBAscendInfoCoresPacket(
CoreInfo &core_info,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBAscendInfoWarpsPacket(
std::vector<WarpInfo> &warps_info,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBAscendInfoKernelPacket(
KernelInfo &kernel_info,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBAscendInfoRegisterPacket(
const llvm::StringRef reg_name,
uint64_t ®_value,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBAscendInfoRegisterListPacket(
std::vector<std::string> ®_list,
std::chrono::seconds timeout);
uint8_t SendAndWaitGDBDeviceBinaryPacket(
DeviceBinaryInfo &device_binary_info, std::chrono::seconds timeout);
uint8_t SendDeviceIdPacket(const int32_t device_id);
uint8_t UpdateVFStartPC(const uint64_t start_pc);
#endif
void TestPacketSpeed(const uint32_t num_packets, uint32_t max_send,
uint32_t max_recv, uint64_t recv_amount, bool json,
Stream &strm);
bool SendSpeedTestPacket(uint32_t send_size, uint32_t recv_size);
std::optional<PidTid> SendSetCurrentThreadPacket(uint64_t tid, uint64_t pid,
char op);
bool SetCurrentThread(uint64_t tid,
lldb::pid_t pid = LLDB_INVALID_PROCESS_ID);
bool SetCurrentThreadForRun(uint64_t tid,
lldb::pid_t pid = LLDB_INVALID_PROCESS_ID);
bool GetQXferAuxvReadSupported();
void EnableErrorStringInPacket();
bool GetQXferLibrariesReadSupported();
bool GetQXferLibrariesSVR4ReadSupported();
uint64_t GetRemoteMaxPacketSize();
bool GetEchoSupported();
bool GetQPassSignalsSupported();
bool GetAugmentedLibrariesSVR4ReadSupported();
bool GetQXferFeaturesReadSupported();
bool GetQXferMemoryMapReadSupported();
bool GetQXferSigInfoReadSupported();
bool GetMultiprocessSupported();
LazyBool SupportsAllocDeallocMemory()
{
return m_supports_alloc_dealloc_memory;
}
std::vector<std::pair<lldb::pid_t, lldb::tid_t>>
GetCurrentProcessAndThreadIDs(bool &sequence_mutex_unavailable);
size_t GetCurrentThreadIDs(std::vector<lldb::tid_t> &thread_ids,
bool &sequence_mutex_unavailable);
lldb::user_id_t OpenFile(const FileSpec &file_spec, File::OpenOptions flags,
mode_t mode, Status &error);
bool CloseFile(lldb::user_id_t fd, Status &error);
std::optional<GDBRemoteFStatData> FStat(lldb::user_id_t fd);
std::optional<GDBRemoteFStatData> Stat(const FileSpec &file_spec);
lldb::user_id_t GetFileSize(const FileSpec &file_spec);
void AutoCompleteDiskFileOrDirectory(CompletionRequest &request,
bool only_dir);
Status GetFilePermissions(const FileSpec &file_spec,
uint32_t &file_permissions);
Status SetFilePermissions(const FileSpec &file_spec,
uint32_t file_permissions);
uint64_t ReadFile(lldb::user_id_t fd, uint64_t offset, void *dst,
uint64_t dst_len, Status &error);
uint64_t WriteFile(lldb::user_id_t fd, uint64_t offset, const void *src,
uint64_t src_len, Status &error);
Status CreateSymlink(const FileSpec &src, const FileSpec &dst);
Status Unlink(const FileSpec &file_spec);
Status MakeDirectory(const FileSpec &file_spec, uint32_t mode);
bool GetFileExists(const FileSpec &file_spec);
Status RunShellCommand(
llvm::StringRef command,
const FileSpec &working_dir,
int *status_ptr,
int *signo_ptr,
std::string
*command_output,
const Timeout<std::micro> &timeout);
llvm::ErrorOr<llvm::MD5::MD5Result> CalculateMD5(const FileSpec &file_spec);
lldb::DataBufferSP ReadRegister(
lldb::tid_t tid,
uint32_t
reg_num);
lldb::DataBufferSP ReadAllRegisters(lldb::tid_t tid);
bool
WriteRegister(lldb::tid_t tid,
uint32_t reg_num,
llvm::ArrayRef<uint8_t> data);
bool WriteAllRegisters(lldb::tid_t tid, llvm::ArrayRef<uint8_t> data);
bool SaveRegisterState(lldb::tid_t tid, uint32_t &save_id);
bool RestoreRegisterState(lldb::tid_t tid, uint32_t save_id);
bool SyncThreadState(lldb::tid_t tid);
const char *GetGDBServerProgramName();
uint32_t GetGDBServerProgramVersion();
bool AvoidGPackets(ProcessGDBRemote *process);
StructuredData::ObjectSP GetThreadsInfo();
bool GetThreadExtendedInfoSupported();
bool GetLoadedDynamicLibrariesInfosSupported();
bool GetSharedCacheInfoSupported();
bool GetDynamicLoaderProcessStateSupported();
bool GetMemoryTaggingSupported();
bool UsesNativeSignals();
lldb::DataBufferSP ReadMemoryTags(lldb::addr_t addr, size_t len,
int32_t type);
Status WriteMemoryTags(lldb::addr_t addr, size_t len, int32_t type,
const std::vector<uint8_t> &tags);
std::optional<QOffsets> GetQOffsets();
bool GetModuleInfo(const FileSpec &module_file_spec,
const ArchSpec &arch_spec, ModuleSpec &module_spec);
std::optional<std::vector<ModuleSpec>>
GetModulesInfo(llvm::ArrayRef<FileSpec> module_file_specs,
const llvm::Triple &triple);
llvm::Expected<std::string> ReadExtFeature(llvm::StringRef object,
llvm::StringRef annex);
void ServeSymbolLookups(lldb_private::Process *process);
Status SendSignalsToIgnore(llvm::ArrayRef<int32_t> signals);
const std::string &GetServerSupportedFeatures() const {
return m_qSupported_response;
}
lldb_private::StructuredData::Array *GetSupportedStructuredDataPlugins();
Status
ConfigureRemoteStructuredData(llvm::StringRef type_name,
const StructuredData::ObjectSP &config_sp);
llvm::Expected<TraceSupportedResponse>
SendTraceSupported(std::chrono::seconds interrupt_timeout);
llvm::Error SendTraceStart(const llvm::json::Value &request,
std::chrono::seconds interrupt_timeout);
llvm::Error SendTraceStop(const TraceStopRequest &request,
std::chrono::seconds interrupt_timeout);
llvm::Expected<std::string>
SendTraceGetState(llvm::StringRef type,
std::chrono::seconds interrupt_timeout);
llvm::Expected<std::vector<uint8_t>>
SendTraceGetBinaryData(const TraceGetBinaryDataRequest &request,
std::chrono::seconds interrupt_timeout);
bool GetSaveCoreSupported() const;
llvm::Expected<int> KillProcess(lldb::pid_t pid);
protected:
LazyBool m_supports_not_sending_acks = eLazyBoolCalculate;
LazyBool m_supports_thread_suffix = eLazyBoolCalculate;
LazyBool m_supports_threads_in_stop_reply = eLazyBoolCalculate;
LazyBool m_supports_vCont_all = eLazyBoolCalculate;
LazyBool m_supports_vCont_any = eLazyBoolCalculate;
LazyBool m_supports_vCont_c = eLazyBoolCalculate;
LazyBool m_supports_vCont_C = eLazyBoolCalculate;
LazyBool m_supports_vCont_s = eLazyBoolCalculate;
LazyBool m_supports_vCont_S = eLazyBoolCalculate;
LazyBool m_qHostInfo_is_valid = eLazyBoolCalculate;
LazyBool m_curr_pid_is_valid = eLazyBoolCalculate;
LazyBool m_qProcessInfo_is_valid = eLazyBoolCalculate;
LazyBool m_qGDBServerVersion_is_valid = eLazyBoolCalculate;
LazyBool m_supports_alloc_dealloc_memory = eLazyBoolCalculate;
LazyBool m_supports_memory_region_info = eLazyBoolCalculate;
LazyBool m_supports_watchpoint_support_info = eLazyBoolCalculate;
LazyBool m_supports_detach_stay_stopped = eLazyBoolCalculate;
LazyBool m_watchpoints_trigger_after_instruction = eLazyBoolCalculate;
LazyBool m_attach_or_wait_reply = eLazyBoolCalculate;
LazyBool m_prepare_for_reg_writing_reply = eLazyBoolCalculate;
LazyBool m_supports_p = eLazyBoolCalculate;
LazyBool m_supports_x = eLazyBoolCalculate;
LazyBool m_avoid_g_packets = eLazyBoolCalculate;
LazyBool m_supports_QSaveRegisterState = eLazyBoolCalculate;
LazyBool m_supports_qXfer_auxv_read = eLazyBoolCalculate;
LazyBool m_supports_qXfer_libraries_read = eLazyBoolCalculate;
LazyBool m_supports_qXfer_libraries_svr4_read = eLazyBoolCalculate;
LazyBool m_supports_qXfer_features_read = eLazyBoolCalculate;
LazyBool m_supports_qXfer_memory_map_read = eLazyBoolCalculate;
LazyBool m_supports_qXfer_siginfo_read = eLazyBoolCalculate;
LazyBool m_supports_augmented_libraries_svr4_read = eLazyBoolCalculate;
LazyBool m_supports_jThreadExtendedInfo = eLazyBoolCalculate;
LazyBool m_supports_jLoadedDynamicLibrariesInfos = eLazyBoolCalculate;
LazyBool m_supports_jGetSharedCacheInfo = eLazyBoolCalculate;
LazyBool m_supports_jGetDyldProcessState = eLazyBoolCalculate;
LazyBool m_supports_QPassSignals = eLazyBoolCalculate;
LazyBool m_supports_error_string_reply = eLazyBoolCalculate;
LazyBool m_supports_multiprocess = eLazyBoolCalculate;
LazyBool m_supports_memory_tagging = eLazyBoolCalculate;
LazyBool m_supports_qSaveCore = eLazyBoolCalculate;
LazyBool m_uses_native_signals = eLazyBoolCalculate;
bool m_supports_qProcessInfoPID : 1, m_supports_qfProcessInfo : 1,
m_supports_qUserName : 1, m_supports_qGroupName : 1,
m_supports_qThreadStopInfo : 1, m_supports_z0 : 1, m_supports_z1 : 1,
m_supports_z2 : 1, m_supports_z3 : 1, m_supports_z4 : 1,
m_supports_QEnvironment : 1, m_supports_QEnvironmentHexEncoded : 1,
m_supports_qSymbol : 1, m_qSymbol_requests_done : 1,
m_supports_qModuleInfo : 1, m_supports_jThreadsInfo : 1,
m_supports_jModulesInfo : 1, m_supports_vFileSize : 1,
m_supports_vFileMode : 1, m_supports_vFileExists : 1,
m_supports_vRun : 1;
lldb::pid_t m_curr_pid = LLDB_INVALID_PROCESS_ID;
lldb::pid_t m_curr_pid_run = LLDB_INVALID_PROCESS_ID;
lldb::tid_t m_curr_tid = LLDB_INVALID_THREAD_ID;
lldb::tid_t m_curr_tid_run = LLDB_INVALID_THREAD_ID;
uint32_t m_num_supported_hardware_watchpoints = 0;
WatchpointHardwareFeature m_watchpoint_types =
eWatchpointHardwareFeatureUnknown;
uint32_t m_low_mem_addressing_bits = 0;
uint32_t m_high_mem_addressing_bits = 0;
ArchSpec m_host_arch;
std::string m_host_distribution_id;
ArchSpec m_process_arch;
UUID m_process_standalone_uuid;
lldb::addr_t m_process_standalone_value = LLDB_INVALID_ADDRESS;
bool m_process_standalone_value_is_offset = false;
std::vector<lldb::addr_t> m_binary_addresses;
llvm::VersionTuple m_os_version;
llvm::VersionTuple m_maccatalyst_version;
std::string m_os_build;
std::string m_os_kernel;
std::string m_hostname;
std::string m_gdb_server_name;
uint32_t m_gdb_server_version =
UINT32_MAX;
std::chrono::seconds m_default_packet_timeout;
int m_target_vm_page_size = 0;
uint64_t m_max_packet_size = 0;
std::string m_qSupported_response;
bool m_supported_async_json_packets_is_valid = false;
lldb_private::StructuredData::ObjectSP m_supported_async_json_packets_sp;
std::vector<MemoryRegionInfo> m_qXfer_memory_map;
bool m_qXfer_memory_map_loaded = false;
bool GetCurrentProcessInfo(bool allow_lazy_pid = true);
bool GetGDBServerVersion();
void MaybeEnableCompression(
llvm::ArrayRef<llvm::StringRef> supported_compressions);
bool DecodeProcessInfoResponse(StringExtractorGDBRemote &response,
ProcessInstanceInfo &process_info);
void OnRunPacketSent(bool first) override;
PacketResult SendThreadSpecificPacketAndWaitForResponse(
lldb::tid_t tid, StreamString &&payload,
StringExtractorGDBRemote &response);
Status SendGetTraceDataPacket(StreamGDBRemote &packet, lldb::user_id_t uid,
lldb::tid_t thread_id,
llvm::MutableArrayRef<uint8_t> &buffer,
size_t offset);
Status LoadQXferMemoryMap();
Status GetQXferMemoryMapRegionInfo(lldb::addr_t addr,
MemoryRegionInfo ®ion);
LazyBool GetThreadPacketSupported(lldb::tid_t tid, llvm::StringRef packetStr);
private:
GDBRemoteCommunicationClient(const GDBRemoteCommunicationClient &) = delete;
const GDBRemoteCommunicationClient &
operator=(const GDBRemoteCommunicationClient &) = delete;
};
}
}
#endif