xref: /llvm-project/lldb/source/Plugins/Process/gdb-remote/GDBRemoteCommunicationClient.cpp (revision 2461061168f4ac4ca8a1823768a00d1c63355b1b)
1 //===-- GDBRemoteCommunicationClient.cpp ------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "GDBRemoteCommunicationClient.h"
10 
11 #include <math.h>
12 #include <sys/stat.h>
13 
14 #include <numeric>
15 #include <sstream>
16 
17 #include "lldb/Core/ModuleSpec.h"
18 #include "lldb/Host/HostInfo.h"
19 #include "lldb/Host/XML.h"
20 #include "lldb/Symbol/Symbol.h"
21 #include "lldb/Target/MemoryRegionInfo.h"
22 #include "lldb/Target/Target.h"
23 #include "lldb/Target/UnixSignals.h"
24 #include "lldb/Utility/Args.h"
25 #include "lldb/Utility/DataBufferHeap.h"
26 #include "lldb/Utility/JSON.h"
27 #include "lldb/Utility/LLDBAssert.h"
28 #include "lldb/Utility/Log.h"
29 #include "lldb/Utility/State.h"
30 #include "lldb/Utility/StreamString.h"
31 
32 #include "ProcessGDBRemote.h"
33 #include "ProcessGDBRemoteLog.h"
34 #include "lldb/Host/Config.h"
35 #include "lldb/Utility/StringExtractorGDBRemote.h"
36 
37 #include "llvm/ADT/StringSwitch.h"
38 
39 #if defined(HAVE_LIBCOMPRESSION)
40 #include <compression.h>
41 #endif
42 
43 using namespace lldb;
44 using namespace lldb_private;
45 using namespace lldb_private::process_gdb_remote;
46 using namespace std::chrono;
47 
48 // GDBRemoteCommunicationClient constructor
49 GDBRemoteCommunicationClient::GDBRemoteCommunicationClient()
50     : GDBRemoteClientBase("gdb-remote.client", "gdb-remote.client.rx_packet"),
51       m_supports_not_sending_acks(eLazyBoolCalculate),
52       m_supports_thread_suffix(eLazyBoolCalculate),
53       m_supports_threads_in_stop_reply(eLazyBoolCalculate),
54       m_supports_vCont_all(eLazyBoolCalculate),
55       m_supports_vCont_any(eLazyBoolCalculate),
56       m_supports_vCont_c(eLazyBoolCalculate),
57       m_supports_vCont_C(eLazyBoolCalculate),
58       m_supports_vCont_s(eLazyBoolCalculate),
59       m_supports_vCont_S(eLazyBoolCalculate),
60       m_qHostInfo_is_valid(eLazyBoolCalculate),
61       m_curr_pid_is_valid(eLazyBoolCalculate),
62       m_qProcessInfo_is_valid(eLazyBoolCalculate),
63       m_qGDBServerVersion_is_valid(eLazyBoolCalculate),
64       m_supports_alloc_dealloc_memory(eLazyBoolCalculate),
65       m_supports_memory_region_info(eLazyBoolCalculate),
66       m_supports_watchpoint_support_info(eLazyBoolCalculate),
67       m_supports_detach_stay_stopped(eLazyBoolCalculate),
68       m_watchpoints_trigger_after_instruction(eLazyBoolCalculate),
69       m_attach_or_wait_reply(eLazyBoolCalculate),
70       m_prepare_for_reg_writing_reply(eLazyBoolCalculate),
71       m_supports_p(eLazyBoolCalculate), m_supports_x(eLazyBoolCalculate),
72       m_avoid_g_packets(eLazyBoolCalculate),
73       m_supports_QSaveRegisterState(eLazyBoolCalculate),
74       m_supports_qXfer_auxv_read(eLazyBoolCalculate),
75       m_supports_qXfer_libraries_read(eLazyBoolCalculate),
76       m_supports_qXfer_libraries_svr4_read(eLazyBoolCalculate),
77       m_supports_qXfer_features_read(eLazyBoolCalculate),
78       m_supports_qXfer_memory_map_read(eLazyBoolCalculate),
79       m_supports_augmented_libraries_svr4_read(eLazyBoolCalculate),
80       m_supports_jThreadExtendedInfo(eLazyBoolCalculate),
81       m_supports_jLoadedDynamicLibrariesInfos(eLazyBoolCalculate),
82       m_supports_jGetSharedCacheInfo(eLazyBoolCalculate),
83       m_supports_QPassSignals(eLazyBoolCalculate),
84       m_supports_error_string_reply(eLazyBoolCalculate),
85       m_supports_qProcessInfoPID(true), m_supports_qfProcessInfo(true),
86       m_supports_qUserName(true), m_supports_qGroupName(true),
87       m_supports_qThreadStopInfo(true), m_supports_z0(true),
88       m_supports_z1(true), m_supports_z2(true), m_supports_z3(true),
89       m_supports_z4(true), m_supports_QEnvironment(true),
90       m_supports_QEnvironmentHexEncoded(true), m_supports_qSymbol(true),
91       m_qSymbol_requests_done(false), m_supports_qModuleInfo(true),
92       m_supports_jThreadsInfo(true), m_supports_jModulesInfo(true),
93       m_curr_pid(LLDB_INVALID_PROCESS_ID), m_curr_tid(LLDB_INVALID_THREAD_ID),
94       m_curr_tid_run(LLDB_INVALID_THREAD_ID),
95       m_num_supported_hardware_watchpoints(0), m_host_arch(), m_process_arch(),
96       m_os_build(), m_os_kernel(), m_hostname(), m_gdb_server_name(),
97       m_gdb_server_version(UINT32_MAX), m_default_packet_timeout(0),
98       m_max_packet_size(0), m_qSupported_response(),
99       m_supported_async_json_packets_is_valid(false),
100       m_supported_async_json_packets_sp(), m_qXfer_memory_map(),
101       m_qXfer_memory_map_loaded(false) {}
102 
103 // Destructor
104 GDBRemoteCommunicationClient::~GDBRemoteCommunicationClient() {
105   if (IsConnected())
106     Disconnect();
107 }
108 
109 bool GDBRemoteCommunicationClient::HandshakeWithServer(Status *error_ptr) {
110   ResetDiscoverableSettings(false);
111 
112   // Start the read thread after we send the handshake ack since if we fail to
113   // send the handshake ack, there is no reason to continue...
114   if (SendAck()) {
115     // Wait for any responses that might have been queued up in the remote
116     // GDB server and flush them all
117     StringExtractorGDBRemote response;
118     PacketResult packet_result = PacketResult::Success;
119     while (packet_result == PacketResult::Success)
120       packet_result = ReadPacket(response, milliseconds(10), false);
121 
122     // The return value from QueryNoAckModeSupported() is true if the packet
123     // was sent and _any_ response (including UNIMPLEMENTED) was received), or
124     // false if no response was received. This quickly tells us if we have a
125     // live connection to a remote GDB server...
126     if (QueryNoAckModeSupported()) {
127       return true;
128     } else {
129       if (error_ptr)
130         error_ptr->SetErrorString("failed to get reply to handshake packet");
131     }
132   } else {
133     if (error_ptr)
134       error_ptr->SetErrorString("failed to send the handshake ack");
135   }
136   return false;
137 }
138 
139 bool GDBRemoteCommunicationClient::GetEchoSupported() {
140   if (m_supports_qEcho == eLazyBoolCalculate) {
141     GetRemoteQSupported();
142   }
143   return m_supports_qEcho == eLazyBoolYes;
144 }
145 
146 bool GDBRemoteCommunicationClient::GetQPassSignalsSupported() {
147   if (m_supports_QPassSignals == eLazyBoolCalculate) {
148     GetRemoteQSupported();
149   }
150   return m_supports_QPassSignals == eLazyBoolYes;
151 }
152 
153 bool GDBRemoteCommunicationClient::GetAugmentedLibrariesSVR4ReadSupported() {
154   if (m_supports_augmented_libraries_svr4_read == eLazyBoolCalculate) {
155     GetRemoteQSupported();
156   }
157   return m_supports_augmented_libraries_svr4_read == eLazyBoolYes;
158 }
159 
160 bool GDBRemoteCommunicationClient::GetQXferLibrariesSVR4ReadSupported() {
161   if (m_supports_qXfer_libraries_svr4_read == eLazyBoolCalculate) {
162     GetRemoteQSupported();
163   }
164   return m_supports_qXfer_libraries_svr4_read == eLazyBoolYes;
165 }
166 
167 bool GDBRemoteCommunicationClient::GetQXferLibrariesReadSupported() {
168   if (m_supports_qXfer_libraries_read == eLazyBoolCalculate) {
169     GetRemoteQSupported();
170   }
171   return m_supports_qXfer_libraries_read == eLazyBoolYes;
172 }
173 
174 bool GDBRemoteCommunicationClient::GetQXferAuxvReadSupported() {
175   if (m_supports_qXfer_auxv_read == eLazyBoolCalculate) {
176     GetRemoteQSupported();
177   }
178   return m_supports_qXfer_auxv_read == eLazyBoolYes;
179 }
180 
181 bool GDBRemoteCommunicationClient::GetQXferFeaturesReadSupported() {
182   if (m_supports_qXfer_features_read == eLazyBoolCalculate) {
183     GetRemoteQSupported();
184   }
185   return m_supports_qXfer_features_read == eLazyBoolYes;
186 }
187 
188 bool GDBRemoteCommunicationClient::GetQXferMemoryMapReadSupported() {
189   if (m_supports_qXfer_memory_map_read == eLazyBoolCalculate) {
190     GetRemoteQSupported();
191   }
192   return m_supports_qXfer_memory_map_read == eLazyBoolYes;
193 }
194 
195 uint64_t GDBRemoteCommunicationClient::GetRemoteMaxPacketSize() {
196   if (m_max_packet_size == 0) {
197     GetRemoteQSupported();
198   }
199   return m_max_packet_size;
200 }
201 
202 bool GDBRemoteCommunicationClient::QueryNoAckModeSupported() {
203   if (m_supports_not_sending_acks == eLazyBoolCalculate) {
204     m_send_acks = true;
205     m_supports_not_sending_acks = eLazyBoolNo;
206 
207     // This is the first real packet that we'll send in a debug session and it
208     // may take a little longer than normal to receive a reply.  Wait at least
209     // 6 seconds for a reply to this packet.
210 
211     ScopedTimeout timeout(*this, std::max(GetPacketTimeout(), seconds(6)));
212 
213     StringExtractorGDBRemote response;
214     if (SendPacketAndWaitForResponse("QStartNoAckMode", response, false) ==
215         PacketResult::Success) {
216       if (response.IsOKResponse()) {
217         m_send_acks = false;
218         m_supports_not_sending_acks = eLazyBoolYes;
219       }
220       return true;
221     }
222   }
223   return false;
224 }
225 
226 void GDBRemoteCommunicationClient::GetListThreadsInStopReplySupported() {
227   if (m_supports_threads_in_stop_reply == eLazyBoolCalculate) {
228     m_supports_threads_in_stop_reply = eLazyBoolNo;
229 
230     StringExtractorGDBRemote response;
231     if (SendPacketAndWaitForResponse("QListThreadsInStopReply", response,
232                                      false) == PacketResult::Success) {
233       if (response.IsOKResponse())
234         m_supports_threads_in_stop_reply = eLazyBoolYes;
235     }
236   }
237 }
238 
239 bool GDBRemoteCommunicationClient::GetVAttachOrWaitSupported() {
240   if (m_attach_or_wait_reply == eLazyBoolCalculate) {
241     m_attach_or_wait_reply = eLazyBoolNo;
242 
243     StringExtractorGDBRemote response;
244     if (SendPacketAndWaitForResponse("qVAttachOrWaitSupported", response,
245                                      false) == PacketResult::Success) {
246       if (response.IsOKResponse())
247         m_attach_or_wait_reply = eLazyBoolYes;
248     }
249   }
250   return m_attach_or_wait_reply == eLazyBoolYes;
251 }
252 
253 bool GDBRemoteCommunicationClient::GetSyncThreadStateSupported() {
254   if (m_prepare_for_reg_writing_reply == eLazyBoolCalculate) {
255     m_prepare_for_reg_writing_reply = eLazyBoolNo;
256 
257     StringExtractorGDBRemote response;
258     if (SendPacketAndWaitForResponse("qSyncThreadStateSupported", response,
259                                      false) == PacketResult::Success) {
260       if (response.IsOKResponse())
261         m_prepare_for_reg_writing_reply = eLazyBoolYes;
262     }
263   }
264   return m_prepare_for_reg_writing_reply == eLazyBoolYes;
265 }
266 
267 void GDBRemoteCommunicationClient::ResetDiscoverableSettings(bool did_exec) {
268   if (!did_exec) {
269     // Hard reset everything, this is when we first connect to a GDB server
270     m_supports_not_sending_acks = eLazyBoolCalculate;
271     m_supports_thread_suffix = eLazyBoolCalculate;
272     m_supports_threads_in_stop_reply = eLazyBoolCalculate;
273     m_supports_vCont_c = eLazyBoolCalculate;
274     m_supports_vCont_C = eLazyBoolCalculate;
275     m_supports_vCont_s = eLazyBoolCalculate;
276     m_supports_vCont_S = eLazyBoolCalculate;
277     m_supports_p = eLazyBoolCalculate;
278     m_supports_x = eLazyBoolCalculate;
279     m_supports_QSaveRegisterState = eLazyBoolCalculate;
280     m_qHostInfo_is_valid = eLazyBoolCalculate;
281     m_curr_pid_is_valid = eLazyBoolCalculate;
282     m_qGDBServerVersion_is_valid = eLazyBoolCalculate;
283     m_supports_alloc_dealloc_memory = eLazyBoolCalculate;
284     m_supports_memory_region_info = eLazyBoolCalculate;
285     m_prepare_for_reg_writing_reply = eLazyBoolCalculate;
286     m_attach_or_wait_reply = eLazyBoolCalculate;
287     m_avoid_g_packets = eLazyBoolCalculate;
288     m_supports_qXfer_auxv_read = eLazyBoolCalculate;
289     m_supports_qXfer_libraries_read = eLazyBoolCalculate;
290     m_supports_qXfer_libraries_svr4_read = eLazyBoolCalculate;
291     m_supports_qXfer_features_read = eLazyBoolCalculate;
292     m_supports_qXfer_memory_map_read = eLazyBoolCalculate;
293     m_supports_augmented_libraries_svr4_read = eLazyBoolCalculate;
294     m_supports_qProcessInfoPID = true;
295     m_supports_qfProcessInfo = true;
296     m_supports_qUserName = true;
297     m_supports_qGroupName = true;
298     m_supports_qThreadStopInfo = true;
299     m_supports_z0 = true;
300     m_supports_z1 = true;
301     m_supports_z2 = true;
302     m_supports_z3 = true;
303     m_supports_z4 = true;
304     m_supports_QEnvironment = true;
305     m_supports_QEnvironmentHexEncoded = true;
306     m_supports_qSymbol = true;
307     m_qSymbol_requests_done = false;
308     m_supports_qModuleInfo = true;
309     m_host_arch.Clear();
310     m_os_version = llvm::VersionTuple();
311     m_os_build.clear();
312     m_os_kernel.clear();
313     m_hostname.clear();
314     m_gdb_server_name.clear();
315     m_gdb_server_version = UINT32_MAX;
316     m_default_packet_timeout = seconds(0);
317     m_max_packet_size = 0;
318     m_qSupported_response.clear();
319     m_supported_async_json_packets_is_valid = false;
320     m_supported_async_json_packets_sp.reset();
321     m_supports_jModulesInfo = true;
322   }
323 
324   // These flags should be reset when we first connect to a GDB server and when
325   // our inferior process execs
326   m_qProcessInfo_is_valid = eLazyBoolCalculate;
327   m_process_arch.Clear();
328 }
329 
330 void GDBRemoteCommunicationClient::GetRemoteQSupported() {
331   // Clear out any capabilities we expect to see in the qSupported response
332   m_supports_qXfer_auxv_read = eLazyBoolNo;
333   m_supports_qXfer_libraries_read = eLazyBoolNo;
334   m_supports_qXfer_libraries_svr4_read = eLazyBoolNo;
335   m_supports_augmented_libraries_svr4_read = eLazyBoolNo;
336   m_supports_qXfer_features_read = eLazyBoolNo;
337   m_supports_qXfer_memory_map_read = eLazyBoolNo;
338   m_max_packet_size = UINT64_MAX; // It's supposed to always be there, but if
339                                   // not, we assume no limit
340 
341   // build the qSupported packet
342   std::vector<std::string> features = {"xmlRegisters=i386,arm,mips"};
343   StreamString packet;
344   packet.PutCString("qSupported");
345   for (uint32_t i = 0; i < features.size(); ++i) {
346     packet.PutCString(i == 0 ? ":" : ";");
347     packet.PutCString(features[i]);
348   }
349 
350   StringExtractorGDBRemote response;
351   if (SendPacketAndWaitForResponse(packet.GetString(), response,
352                                    /*send_async=*/false) ==
353       PacketResult::Success) {
354     const char *response_cstr = response.GetStringRef().data();
355 
356     // Hang on to the qSupported packet, so that platforms can do custom
357     // configuration of the transport before attaching/launching the process.
358     m_qSupported_response = response_cstr;
359 
360     if (::strstr(response_cstr, "qXfer:auxv:read+"))
361       m_supports_qXfer_auxv_read = eLazyBoolYes;
362     if (::strstr(response_cstr, "qXfer:libraries-svr4:read+"))
363       m_supports_qXfer_libraries_svr4_read = eLazyBoolYes;
364     if (::strstr(response_cstr, "augmented-libraries-svr4-read")) {
365       m_supports_qXfer_libraries_svr4_read = eLazyBoolYes; // implied
366       m_supports_augmented_libraries_svr4_read = eLazyBoolYes;
367     }
368     if (::strstr(response_cstr, "qXfer:libraries:read+"))
369       m_supports_qXfer_libraries_read = eLazyBoolYes;
370     if (::strstr(response_cstr, "qXfer:features:read+"))
371       m_supports_qXfer_features_read = eLazyBoolYes;
372     if (::strstr(response_cstr, "qXfer:memory-map:read+"))
373       m_supports_qXfer_memory_map_read = eLazyBoolYes;
374 
375     // Look for a list of compressions in the features list e.g.
376     // qXfer:features:read+;PacketSize=20000;qEcho+;SupportedCompressions=zlib-
377     // deflate,lzma
378     const char *features_list = ::strstr(response_cstr, "qXfer:features:");
379     if (features_list) {
380       const char *compressions =
381           ::strstr(features_list, "SupportedCompressions=");
382       if (compressions) {
383         std::vector<std::string> supported_compressions;
384         compressions += sizeof("SupportedCompressions=") - 1;
385         const char *end_of_compressions = strchr(compressions, ';');
386         if (end_of_compressions == nullptr) {
387           end_of_compressions = strchr(compressions, '\0');
388         }
389         const char *current_compression = compressions;
390         while (current_compression < end_of_compressions) {
391           const char *next_compression_name = strchr(current_compression, ',');
392           const char *end_of_this_word = next_compression_name;
393           if (next_compression_name == nullptr ||
394               end_of_compressions < next_compression_name) {
395             end_of_this_word = end_of_compressions;
396           }
397 
398           if (end_of_this_word) {
399             if (end_of_this_word == current_compression) {
400               current_compression++;
401             } else {
402               std::string this_compression(
403                   current_compression, end_of_this_word - current_compression);
404               supported_compressions.push_back(this_compression);
405               current_compression = end_of_this_word + 1;
406             }
407           } else {
408             supported_compressions.push_back(current_compression);
409             current_compression = end_of_compressions;
410           }
411         }
412 
413         if (supported_compressions.size() > 0) {
414           MaybeEnableCompression(supported_compressions);
415         }
416       }
417     }
418 
419     if (::strstr(response_cstr, "qEcho"))
420       m_supports_qEcho = eLazyBoolYes;
421     else
422       m_supports_qEcho = eLazyBoolNo;
423 
424     if (::strstr(response_cstr, "QPassSignals+"))
425       m_supports_QPassSignals = eLazyBoolYes;
426     else
427       m_supports_QPassSignals = eLazyBoolNo;
428 
429     const char *packet_size_str = ::strstr(response_cstr, "PacketSize=");
430     if (packet_size_str) {
431       StringExtractorGDBRemote packet_response(packet_size_str +
432                                                strlen("PacketSize="));
433       m_max_packet_size =
434           packet_response.GetHexMaxU64(/*little_endian=*/false, UINT64_MAX);
435       if (m_max_packet_size == 0) {
436         m_max_packet_size = UINT64_MAX; // Must have been a garbled response
437         Log *log(
438             ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(GDBR_LOG_PROCESS));
439         LLDB_LOGF(log, "Garbled PacketSize spec in qSupported response");
440       }
441     }
442   }
443 }
444 
445 bool GDBRemoteCommunicationClient::GetThreadSuffixSupported() {
446   if (m_supports_thread_suffix == eLazyBoolCalculate) {
447     StringExtractorGDBRemote response;
448     m_supports_thread_suffix = eLazyBoolNo;
449     if (SendPacketAndWaitForResponse("QThreadSuffixSupported", response,
450                                      false) == PacketResult::Success) {
451       if (response.IsOKResponse())
452         m_supports_thread_suffix = eLazyBoolYes;
453     }
454   }
455   return m_supports_thread_suffix;
456 }
457 bool GDBRemoteCommunicationClient::GetVContSupported(char flavor) {
458   if (m_supports_vCont_c == eLazyBoolCalculate) {
459     StringExtractorGDBRemote response;
460     m_supports_vCont_any = eLazyBoolNo;
461     m_supports_vCont_all = eLazyBoolNo;
462     m_supports_vCont_c = eLazyBoolNo;
463     m_supports_vCont_C = eLazyBoolNo;
464     m_supports_vCont_s = eLazyBoolNo;
465     m_supports_vCont_S = eLazyBoolNo;
466     if (SendPacketAndWaitForResponse("vCont?", response, false) ==
467         PacketResult::Success) {
468       const char *response_cstr = response.GetStringRef().data();
469       if (::strstr(response_cstr, ";c"))
470         m_supports_vCont_c = eLazyBoolYes;
471 
472       if (::strstr(response_cstr, ";C"))
473         m_supports_vCont_C = eLazyBoolYes;
474 
475       if (::strstr(response_cstr, ";s"))
476         m_supports_vCont_s = eLazyBoolYes;
477 
478       if (::strstr(response_cstr, ";S"))
479         m_supports_vCont_S = eLazyBoolYes;
480 
481       if (m_supports_vCont_c == eLazyBoolYes &&
482           m_supports_vCont_C == eLazyBoolYes &&
483           m_supports_vCont_s == eLazyBoolYes &&
484           m_supports_vCont_S == eLazyBoolYes) {
485         m_supports_vCont_all = eLazyBoolYes;
486       }
487 
488       if (m_supports_vCont_c == eLazyBoolYes ||
489           m_supports_vCont_C == eLazyBoolYes ||
490           m_supports_vCont_s == eLazyBoolYes ||
491           m_supports_vCont_S == eLazyBoolYes) {
492         m_supports_vCont_any = eLazyBoolYes;
493       }
494     }
495   }
496 
497   switch (flavor) {
498   case 'a':
499     return m_supports_vCont_any;
500   case 'A':
501     return m_supports_vCont_all;
502   case 'c':
503     return m_supports_vCont_c;
504   case 'C':
505     return m_supports_vCont_C;
506   case 's':
507     return m_supports_vCont_s;
508   case 'S':
509     return m_supports_vCont_S;
510   default:
511     break;
512   }
513   return false;
514 }
515 
516 GDBRemoteCommunication::PacketResult
517 GDBRemoteCommunicationClient::SendThreadSpecificPacketAndWaitForResponse(
518     lldb::tid_t tid, StreamString &&payload, StringExtractorGDBRemote &response,
519     bool send_async) {
520   Lock lock(*this, send_async);
521   if (!lock) {
522     if (Log *log = ProcessGDBRemoteLog::GetLogIfAnyCategoryIsSet(
523             GDBR_LOG_PROCESS | GDBR_LOG_PACKETS))
524       LLDB_LOGF(log,
525                 "GDBRemoteCommunicationClient::%s: Didn't get sequence mutex "
526                 "for %s packet.",
527                 __FUNCTION__, payload.GetData());
528     return PacketResult::ErrorNoSequenceLock;
529   }
530 
531   if (GetThreadSuffixSupported())
532     payload.Printf(";thread:%4.4" PRIx64 ";", tid);
533   else {
534     if (!SetCurrentThread(tid))
535       return PacketResult::ErrorSendFailed;
536   }
537 
538   return SendPacketAndWaitForResponseNoLock(payload.GetString(), response);
539 }
540 
541 // Check if the target supports 'p' packet. It sends out a 'p' packet and
542 // checks the response. A normal packet will tell us that support is available.
543 //
544 // Takes a valid thread ID because p needs to apply to a thread.
545 bool GDBRemoteCommunicationClient::GetpPacketSupported(lldb::tid_t tid) {
546   if (m_supports_p == eLazyBoolCalculate) {
547     m_supports_p = eLazyBoolNo;
548     StreamString payload;
549     payload.PutCString("p0");
550     StringExtractorGDBRemote response;
551     if (SendThreadSpecificPacketAndWaitForResponse(tid, std::move(payload),
552                                                    response, false) ==
553             PacketResult::Success &&
554         response.IsNormalResponse()) {
555       m_supports_p = eLazyBoolYes;
556     }
557   }
558   return m_supports_p;
559 }
560 
561 StructuredData::ObjectSP GDBRemoteCommunicationClient::GetThreadsInfo() {
562   // Get information on all threads at one using the "jThreadsInfo" packet
563   StructuredData::ObjectSP object_sp;
564 
565   if (m_supports_jThreadsInfo) {
566     StringExtractorGDBRemote response;
567     response.SetResponseValidatorToJSON();
568     if (SendPacketAndWaitForResponse("jThreadsInfo", response, false) ==
569         PacketResult::Success) {
570       if (response.IsUnsupportedResponse()) {
571         m_supports_jThreadsInfo = false;
572       } else if (!response.Empty()) {
573         object_sp = StructuredData::ParseJSON(response.GetStringRef());
574       }
575     }
576   }
577   return object_sp;
578 }
579 
580 bool GDBRemoteCommunicationClient::GetThreadExtendedInfoSupported() {
581   if (m_supports_jThreadExtendedInfo == eLazyBoolCalculate) {
582     StringExtractorGDBRemote response;
583     m_supports_jThreadExtendedInfo = eLazyBoolNo;
584     if (SendPacketAndWaitForResponse("jThreadExtendedInfo:", response, false) ==
585         PacketResult::Success) {
586       if (response.IsOKResponse()) {
587         m_supports_jThreadExtendedInfo = eLazyBoolYes;
588       }
589     }
590   }
591   return m_supports_jThreadExtendedInfo;
592 }
593 
594 void GDBRemoteCommunicationClient::EnableErrorStringInPacket() {
595   if (m_supports_error_string_reply == eLazyBoolCalculate) {
596     StringExtractorGDBRemote response;
597     // We try to enable error strings in remote packets but if we fail, we just
598     // work in the older way.
599     m_supports_error_string_reply = eLazyBoolNo;
600     if (SendPacketAndWaitForResponse("QEnableErrorStrings", response, false) ==
601         PacketResult::Success) {
602       if (response.IsOKResponse()) {
603         m_supports_error_string_reply = eLazyBoolYes;
604       }
605     }
606   }
607 }
608 
609 bool GDBRemoteCommunicationClient::GetLoadedDynamicLibrariesInfosSupported() {
610   if (m_supports_jLoadedDynamicLibrariesInfos == eLazyBoolCalculate) {
611     StringExtractorGDBRemote response;
612     m_supports_jLoadedDynamicLibrariesInfos = eLazyBoolNo;
613     if (SendPacketAndWaitForResponse("jGetLoadedDynamicLibrariesInfos:",
614                                      response,
615                                      false) == PacketResult::Success) {
616       if (response.IsOKResponse()) {
617         m_supports_jLoadedDynamicLibrariesInfos = eLazyBoolYes;
618       }
619     }
620   }
621   return m_supports_jLoadedDynamicLibrariesInfos;
622 }
623 
624 bool GDBRemoteCommunicationClient::GetSharedCacheInfoSupported() {
625   if (m_supports_jGetSharedCacheInfo == eLazyBoolCalculate) {
626     StringExtractorGDBRemote response;
627     m_supports_jGetSharedCacheInfo = eLazyBoolNo;
628     if (SendPacketAndWaitForResponse("jGetSharedCacheInfo:", response, false) ==
629         PacketResult::Success) {
630       if (response.IsOKResponse()) {
631         m_supports_jGetSharedCacheInfo = eLazyBoolYes;
632       }
633     }
634   }
635   return m_supports_jGetSharedCacheInfo;
636 }
637 
638 bool GDBRemoteCommunicationClient::GetxPacketSupported() {
639   if (m_supports_x == eLazyBoolCalculate) {
640     StringExtractorGDBRemote response;
641     m_supports_x = eLazyBoolNo;
642     char packet[256];
643     snprintf(packet, sizeof(packet), "x0,0");
644     if (SendPacketAndWaitForResponse(packet, response, false) ==
645         PacketResult::Success) {
646       if (response.IsOKResponse())
647         m_supports_x = eLazyBoolYes;
648     }
649   }
650   return m_supports_x;
651 }
652 
653 GDBRemoteCommunicationClient::PacketResult
654 GDBRemoteCommunicationClient::SendPacketsAndConcatenateResponses(
655     const char *payload_prefix, std::string &response_string) {
656   Lock lock(*this, false);
657   if (!lock) {
658     Log *log(ProcessGDBRemoteLog::GetLogIfAnyCategoryIsSet(GDBR_LOG_PROCESS |
659                                                            GDBR_LOG_PACKETS));
660     LLDB_LOGF(log,
661               "error: failed to get packet sequence mutex, not sending "
662               "packets with prefix '%s'",
663               payload_prefix);
664     return PacketResult::ErrorNoSequenceLock;
665   }
666 
667   response_string = "";
668   std::string payload_prefix_str(payload_prefix);
669   unsigned int response_size = 0x1000;
670   if (response_size > GetRemoteMaxPacketSize()) { // May send qSupported packet
671     response_size = GetRemoteMaxPacketSize();
672   }
673 
674   for (unsigned int offset = 0; true; offset += response_size) {
675     StringExtractorGDBRemote this_response;
676     // Construct payload
677     char sizeDescriptor[128];
678     snprintf(sizeDescriptor, sizeof(sizeDescriptor), "%x,%x", offset,
679              response_size);
680     PacketResult result = SendPacketAndWaitForResponseNoLock(
681         payload_prefix_str + sizeDescriptor, this_response);
682     if (result != PacketResult::Success)
683       return result;
684 
685     const std::string &this_string = this_response.GetStringRef();
686 
687     // Check for m or l as first character; l seems to mean this is the last
688     // chunk
689     char first_char = *this_string.c_str();
690     if (first_char != 'm' && first_char != 'l') {
691       return PacketResult::ErrorReplyInvalid;
692     }
693     // Concatenate the result so far (skipping 'm' or 'l')
694     response_string.append(this_string, 1, std::string::npos);
695     if (first_char == 'l')
696       // We're done
697       return PacketResult::Success;
698   }
699 }
700 
701 lldb::pid_t GDBRemoteCommunicationClient::GetCurrentProcessID(bool allow_lazy) {
702   if (allow_lazy && m_curr_pid_is_valid == eLazyBoolYes)
703     return m_curr_pid;
704 
705   // First try to retrieve the pid via the qProcessInfo request.
706   GetCurrentProcessInfo(allow_lazy);
707   if (m_curr_pid_is_valid == eLazyBoolYes) {
708     // We really got it.
709     return m_curr_pid;
710   } else {
711     // If we don't get a response for qProcessInfo, check if $qC gives us a
712     // result. $qC only returns a real process id on older debugserver and
713     // lldb-platform stubs. The gdb remote protocol documents $qC as returning
714     // the thread id, which newer debugserver and lldb-gdbserver stubs return
715     // correctly.
716     StringExtractorGDBRemote response;
717     if (SendPacketAndWaitForResponse("qC", response, false) ==
718         PacketResult::Success) {
719       if (response.GetChar() == 'Q') {
720         if (response.GetChar() == 'C') {
721           m_curr_pid = response.GetHexMaxU32(false, LLDB_INVALID_PROCESS_ID);
722           if (m_curr_pid != LLDB_INVALID_PROCESS_ID) {
723             m_curr_pid_is_valid = eLazyBoolYes;
724             return m_curr_pid;
725           }
726         }
727       }
728     }
729 
730     // If we don't get a response for $qC, check if $qfThreadID gives us a
731     // result.
732     if (m_curr_pid == LLDB_INVALID_PROCESS_ID) {
733       std::vector<lldb::tid_t> thread_ids;
734       bool sequence_mutex_unavailable;
735       size_t size;
736       size = GetCurrentThreadIDs(thread_ids, sequence_mutex_unavailable);
737       if (size && !sequence_mutex_unavailable) {
738         m_curr_pid = thread_ids.front();
739         m_curr_pid_is_valid = eLazyBoolYes;
740         return m_curr_pid;
741       }
742     }
743   }
744 
745   return LLDB_INVALID_PROCESS_ID;
746 }
747 
748 bool GDBRemoteCommunicationClient::GetLaunchSuccess(std::string &error_str) {
749   error_str.clear();
750   StringExtractorGDBRemote response;
751   if (SendPacketAndWaitForResponse("qLaunchSuccess", response, false) ==
752       PacketResult::Success) {
753     if (response.IsOKResponse())
754       return true;
755     if (response.GetChar() == 'E') {
756       // A string the describes what failed when launching...
757       error_str = response.GetStringRef().substr(1);
758     } else {
759       error_str.assign("unknown error occurred launching process");
760     }
761   } else {
762     error_str.assign("timed out waiting for app to launch");
763   }
764   return false;
765 }
766 
767 int GDBRemoteCommunicationClient::SendArgumentsPacket(
768     const ProcessLaunchInfo &launch_info) {
769   // Since we don't get the send argv0 separate from the executable path, we
770   // need to make sure to use the actual executable path found in the
771   // launch_info...
772   std::vector<const char *> argv;
773   FileSpec exe_file = launch_info.GetExecutableFile();
774   std::string exe_path;
775   const char *arg = nullptr;
776   const Args &launch_args = launch_info.GetArguments();
777   if (exe_file)
778     exe_path = exe_file.GetPath(false);
779   else {
780     arg = launch_args.GetArgumentAtIndex(0);
781     if (arg)
782       exe_path = arg;
783   }
784   if (!exe_path.empty()) {
785     argv.push_back(exe_path.c_str());
786     for (uint32_t i = 1; (arg = launch_args.GetArgumentAtIndex(i)) != nullptr;
787          ++i) {
788       if (arg)
789         argv.push_back(arg);
790     }
791   }
792   if (!argv.empty()) {
793     StreamString packet;
794     packet.PutChar('A');
795     for (size_t i = 0, n = argv.size(); i < n; ++i) {
796       arg = argv[i];
797       const int arg_len = strlen(arg);
798       if (i > 0)
799         packet.PutChar(',');
800       packet.Printf("%i,%i,", arg_len * 2, (int)i);
801       packet.PutBytesAsRawHex8(arg, arg_len);
802     }
803 
804     StringExtractorGDBRemote response;
805     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
806         PacketResult::Success) {
807       if (response.IsOKResponse())
808         return 0;
809       uint8_t error = response.GetError();
810       if (error)
811         return error;
812     }
813   }
814   return -1;
815 }
816 
817 int GDBRemoteCommunicationClient::SendEnvironment(const Environment &env) {
818   for (const auto &KV : env) {
819     int r = SendEnvironmentPacket(Environment::compose(KV).c_str());
820     if (r != 0)
821       return r;
822   }
823   return 0;
824 }
825 
826 int GDBRemoteCommunicationClient::SendEnvironmentPacket(
827     char const *name_equal_value) {
828   if (name_equal_value && name_equal_value[0]) {
829     StreamString packet;
830     bool send_hex_encoding = false;
831     for (const char *p = name_equal_value; *p != '\0' && !send_hex_encoding;
832          ++p) {
833       if (isprint(*p)) {
834         switch (*p) {
835         case '$':
836         case '#':
837         case '*':
838         case '}':
839           send_hex_encoding = true;
840           break;
841         default:
842           break;
843         }
844       } else {
845         // We have non printable characters, lets hex encode this...
846         send_hex_encoding = true;
847       }
848     }
849 
850     StringExtractorGDBRemote response;
851     if (send_hex_encoding) {
852       if (m_supports_QEnvironmentHexEncoded) {
853         packet.PutCString("QEnvironmentHexEncoded:");
854         packet.PutBytesAsRawHex8(name_equal_value, strlen(name_equal_value));
855         if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
856             PacketResult::Success) {
857           if (response.IsOKResponse())
858             return 0;
859           uint8_t error = response.GetError();
860           if (error)
861             return error;
862           if (response.IsUnsupportedResponse())
863             m_supports_QEnvironmentHexEncoded = false;
864         }
865       }
866 
867     } else if (m_supports_QEnvironment) {
868       packet.Printf("QEnvironment:%s", name_equal_value);
869       if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
870           PacketResult::Success) {
871         if (response.IsOKResponse())
872           return 0;
873         uint8_t error = response.GetError();
874         if (error)
875           return error;
876         if (response.IsUnsupportedResponse())
877           m_supports_QEnvironment = false;
878       }
879     }
880   }
881   return -1;
882 }
883 
884 int GDBRemoteCommunicationClient::SendLaunchArchPacket(char const *arch) {
885   if (arch && arch[0]) {
886     StreamString packet;
887     packet.Printf("QLaunchArch:%s", arch);
888     StringExtractorGDBRemote response;
889     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
890         PacketResult::Success) {
891       if (response.IsOKResponse())
892         return 0;
893       uint8_t error = response.GetError();
894       if (error)
895         return error;
896     }
897   }
898   return -1;
899 }
900 
901 int GDBRemoteCommunicationClient::SendLaunchEventDataPacket(
902     char const *data, bool *was_supported) {
903   if (data && *data != '\0') {
904     StreamString packet;
905     packet.Printf("QSetProcessEvent:%s", data);
906     StringExtractorGDBRemote response;
907     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
908         PacketResult::Success) {
909       if (response.IsOKResponse()) {
910         if (was_supported)
911           *was_supported = true;
912         return 0;
913       } else if (response.IsUnsupportedResponse()) {
914         if (was_supported)
915           *was_supported = false;
916         return -1;
917       } else {
918         uint8_t error = response.GetError();
919         if (was_supported)
920           *was_supported = true;
921         if (error)
922           return error;
923       }
924     }
925   }
926   return -1;
927 }
928 
929 llvm::VersionTuple GDBRemoteCommunicationClient::GetOSVersion() {
930   GetHostInfo();
931   return m_os_version;
932 }
933 
934 llvm::VersionTuple GDBRemoteCommunicationClient::GetMacCatalystVersion() {
935   GetHostInfo();
936   return m_maccatalyst_version;
937 }
938 
939 bool GDBRemoteCommunicationClient::GetOSBuildString(std::string &s) {
940   if (GetHostInfo()) {
941     if (!m_os_build.empty()) {
942       s = m_os_build;
943       return true;
944     }
945   }
946   s.clear();
947   return false;
948 }
949 
950 bool GDBRemoteCommunicationClient::GetOSKernelDescription(std::string &s) {
951   if (GetHostInfo()) {
952     if (!m_os_kernel.empty()) {
953       s = m_os_kernel;
954       return true;
955     }
956   }
957   s.clear();
958   return false;
959 }
960 
961 bool GDBRemoteCommunicationClient::GetHostname(std::string &s) {
962   if (GetHostInfo()) {
963     if (!m_hostname.empty()) {
964       s = m_hostname;
965       return true;
966     }
967   }
968   s.clear();
969   return false;
970 }
971 
972 ArchSpec GDBRemoteCommunicationClient::GetSystemArchitecture() {
973   if (GetHostInfo())
974     return m_host_arch;
975   return ArchSpec();
976 }
977 
978 const lldb_private::ArchSpec &
979 GDBRemoteCommunicationClient::GetProcessArchitecture() {
980   if (m_qProcessInfo_is_valid == eLazyBoolCalculate)
981     GetCurrentProcessInfo();
982   return m_process_arch;
983 }
984 
985 bool GDBRemoteCommunicationClient::GetGDBServerVersion() {
986   if (m_qGDBServerVersion_is_valid == eLazyBoolCalculate) {
987     m_gdb_server_name.clear();
988     m_gdb_server_version = 0;
989     m_qGDBServerVersion_is_valid = eLazyBoolNo;
990 
991     StringExtractorGDBRemote response;
992     if (SendPacketAndWaitForResponse("qGDBServerVersion", response, false) ==
993         PacketResult::Success) {
994       if (response.IsNormalResponse()) {
995         llvm::StringRef name, value;
996         bool success = false;
997         while (response.GetNameColonValue(name, value)) {
998           if (name.equals("name")) {
999             success = true;
1000             m_gdb_server_name = value;
1001           } else if (name.equals("version")) {
1002             llvm::StringRef major, minor;
1003             std::tie(major, minor) = value.split('.');
1004             if (!major.getAsInteger(0, m_gdb_server_version))
1005               success = true;
1006           }
1007         }
1008         if (success)
1009           m_qGDBServerVersion_is_valid = eLazyBoolYes;
1010       }
1011     }
1012   }
1013   return m_qGDBServerVersion_is_valid == eLazyBoolYes;
1014 }
1015 
1016 void GDBRemoteCommunicationClient::MaybeEnableCompression(
1017     std::vector<std::string> supported_compressions) {
1018   CompressionType avail_type = CompressionType::None;
1019   std::string avail_name;
1020 
1021 #if defined(HAVE_LIBCOMPRESSION)
1022   if (avail_type == CompressionType::None) {
1023     for (auto compression : supported_compressions) {
1024       if (compression == "lzfse") {
1025         avail_type = CompressionType::LZFSE;
1026         avail_name = compression;
1027         break;
1028       }
1029     }
1030   }
1031 #endif
1032 
1033 #if defined(HAVE_LIBCOMPRESSION)
1034   if (avail_type == CompressionType::None) {
1035     for (auto compression : supported_compressions) {
1036       if (compression == "zlib-deflate") {
1037         avail_type = CompressionType::ZlibDeflate;
1038         avail_name = compression;
1039         break;
1040       }
1041     }
1042   }
1043 #endif
1044 
1045 #if defined(HAVE_LIBZ)
1046   if (avail_type == CompressionType::None) {
1047     for (auto compression : supported_compressions) {
1048       if (compression == "zlib-deflate") {
1049         avail_type = CompressionType::ZlibDeflate;
1050         avail_name = compression;
1051         break;
1052       }
1053     }
1054   }
1055 #endif
1056 
1057 #if defined(HAVE_LIBCOMPRESSION)
1058   if (avail_type == CompressionType::None) {
1059     for (auto compression : supported_compressions) {
1060       if (compression == "lz4") {
1061         avail_type = CompressionType::LZ4;
1062         avail_name = compression;
1063         break;
1064       }
1065     }
1066   }
1067 #endif
1068 
1069 #if defined(HAVE_LIBCOMPRESSION)
1070   if (avail_type == CompressionType::None) {
1071     for (auto compression : supported_compressions) {
1072       if (compression == "lzma") {
1073         avail_type = CompressionType::LZMA;
1074         avail_name = compression;
1075         break;
1076       }
1077     }
1078   }
1079 #endif
1080 
1081   if (avail_type != CompressionType::None) {
1082     StringExtractorGDBRemote response;
1083     std::string packet = "QEnableCompression:type:" + avail_name + ";";
1084     if (SendPacketAndWaitForResponse(packet, response, false) !=
1085         PacketResult::Success)
1086       return;
1087 
1088     if (response.IsOKResponse()) {
1089       m_compression_type = avail_type;
1090     }
1091   }
1092 }
1093 
1094 const char *GDBRemoteCommunicationClient::GetGDBServerProgramName() {
1095   if (GetGDBServerVersion()) {
1096     if (!m_gdb_server_name.empty())
1097       return m_gdb_server_name.c_str();
1098   }
1099   return nullptr;
1100 }
1101 
1102 uint32_t GDBRemoteCommunicationClient::GetGDBServerProgramVersion() {
1103   if (GetGDBServerVersion())
1104     return m_gdb_server_version;
1105   return 0;
1106 }
1107 
1108 bool GDBRemoteCommunicationClient::GetDefaultThreadId(lldb::tid_t &tid) {
1109   StringExtractorGDBRemote response;
1110   if (SendPacketAndWaitForResponse("qC", response, false) !=
1111       PacketResult::Success)
1112     return false;
1113 
1114   if (!response.IsNormalResponse())
1115     return false;
1116 
1117   if (response.GetChar() == 'Q' && response.GetChar() == 'C')
1118     tid = response.GetHexMaxU32(true, -1);
1119 
1120   return true;
1121 }
1122 
1123 bool GDBRemoteCommunicationClient::GetHostInfo(bool force) {
1124   Log *log(ProcessGDBRemoteLog::GetLogIfAnyCategoryIsSet(GDBR_LOG_PROCESS));
1125 
1126   if (force || m_qHostInfo_is_valid == eLazyBoolCalculate) {
1127     // host info computation can require DNS traffic and shelling out to external processes.
1128     // Increase the timeout to account for that.
1129     ScopedTimeout timeout(*this, seconds(10));
1130     m_qHostInfo_is_valid = eLazyBoolNo;
1131     StringExtractorGDBRemote response;
1132     if (SendPacketAndWaitForResponse("qHostInfo", response, false) ==
1133         PacketResult::Success) {
1134       if (response.IsNormalResponse()) {
1135         llvm::StringRef name;
1136         llvm::StringRef value;
1137         uint32_t cpu = LLDB_INVALID_CPUTYPE;
1138         uint32_t sub = 0;
1139         std::string arch_name;
1140         std::string os_name;
1141         std::string environment;
1142         std::string vendor_name;
1143         std::string triple;
1144         std::string distribution_id;
1145         uint32_t pointer_byte_size = 0;
1146         ByteOrder byte_order = eByteOrderInvalid;
1147         uint32_t num_keys_decoded = 0;
1148         while (response.GetNameColonValue(name, value)) {
1149           if (name.equals("cputype")) {
1150             // exception type in big endian hex
1151             if (!value.getAsInteger(0, cpu))
1152               ++num_keys_decoded;
1153           } else if (name.equals("cpusubtype")) {
1154             // exception count in big endian hex
1155             if (!value.getAsInteger(0, sub))
1156               ++num_keys_decoded;
1157           } else if (name.equals("arch")) {
1158             arch_name = value;
1159             ++num_keys_decoded;
1160           } else if (name.equals("triple")) {
1161             StringExtractor extractor(value);
1162             extractor.GetHexByteString(triple);
1163             ++num_keys_decoded;
1164           } else if (name.equals("distribution_id")) {
1165             StringExtractor extractor(value);
1166             extractor.GetHexByteString(distribution_id);
1167             ++num_keys_decoded;
1168           } else if (name.equals("os_build")) {
1169             StringExtractor extractor(value);
1170             extractor.GetHexByteString(m_os_build);
1171             ++num_keys_decoded;
1172           } else if (name.equals("hostname")) {
1173             StringExtractor extractor(value);
1174             extractor.GetHexByteString(m_hostname);
1175             ++num_keys_decoded;
1176           } else if (name.equals("os_kernel")) {
1177             StringExtractor extractor(value);
1178             extractor.GetHexByteString(m_os_kernel);
1179             ++num_keys_decoded;
1180           } else if (name.equals("ostype")) {
1181             if (value.equals("maccatalyst")) {
1182               os_name = "ios";
1183               environment = "macabi";
1184             } else
1185               os_name = value;
1186             ++num_keys_decoded;
1187           } else if (name.equals("vendor")) {
1188             vendor_name = value;
1189             ++num_keys_decoded;
1190           } else if (name.equals("endian")) {
1191             byte_order = llvm::StringSwitch<lldb::ByteOrder>(value)
1192                              .Case("little", eByteOrderLittle)
1193                              .Case("big", eByteOrderBig)
1194                              .Case("pdp", eByteOrderPDP)
1195                              .Default(eByteOrderInvalid);
1196             if (byte_order != eByteOrderInvalid)
1197               ++num_keys_decoded;
1198           } else if (name.equals("ptrsize")) {
1199             if (!value.getAsInteger(0, pointer_byte_size))
1200               ++num_keys_decoded;
1201           } else if (name.equals("os_version") ||
1202                      name.equals(
1203                          "version")) // Older debugserver binaries used the
1204                                      // "version" key instead of
1205                                      // "os_version"...
1206           {
1207             if (!m_os_version.tryParse(value))
1208               ++num_keys_decoded;
1209           } else if (name.equals("maccatalyst_version")) {
1210             if (!m_maccatalyst_version.tryParse(value))
1211               ++num_keys_decoded;
1212           } else if (name.equals("watchpoint_exceptions_received")) {
1213             m_watchpoints_trigger_after_instruction =
1214                 llvm::StringSwitch<LazyBool>(value)
1215                     .Case("before", eLazyBoolNo)
1216                     .Case("after", eLazyBoolYes)
1217                     .Default(eLazyBoolCalculate);
1218             if (m_watchpoints_trigger_after_instruction != eLazyBoolCalculate)
1219               ++num_keys_decoded;
1220           } else if (name.equals("default_packet_timeout")) {
1221             uint32_t timeout_seconds;
1222             if (!value.getAsInteger(0, timeout_seconds)) {
1223               m_default_packet_timeout = seconds(timeout_seconds);
1224               SetPacketTimeout(m_default_packet_timeout);
1225               ++num_keys_decoded;
1226             }
1227           }
1228         }
1229 
1230         if (num_keys_decoded > 0)
1231           m_qHostInfo_is_valid = eLazyBoolYes;
1232 
1233         if (triple.empty()) {
1234           if (arch_name.empty()) {
1235             if (cpu != LLDB_INVALID_CPUTYPE) {
1236               m_host_arch.SetArchitecture(eArchTypeMachO, cpu, sub);
1237               if (pointer_byte_size) {
1238                 assert(pointer_byte_size == m_host_arch.GetAddressByteSize());
1239               }
1240               if (byte_order != eByteOrderInvalid) {
1241                 assert(byte_order == m_host_arch.GetByteOrder());
1242               }
1243 
1244               if (!vendor_name.empty())
1245                 m_host_arch.GetTriple().setVendorName(
1246                     llvm::StringRef(vendor_name));
1247               if (!os_name.empty())
1248                 m_host_arch.GetTriple().setOSName(llvm::StringRef(os_name));
1249               if (!environment.empty())
1250                 m_host_arch.GetTriple().setEnvironmentName(environment);
1251             }
1252           } else {
1253             std::string triple;
1254             triple += arch_name;
1255             if (!vendor_name.empty() || !os_name.empty()) {
1256               triple += '-';
1257               if (vendor_name.empty())
1258                 triple += "unknown";
1259               else
1260                 triple += vendor_name;
1261               triple += '-';
1262               if (os_name.empty())
1263                 triple += "unknown";
1264               else
1265                 triple += os_name;
1266             }
1267             m_host_arch.SetTriple(triple.c_str());
1268 
1269             llvm::Triple &host_triple = m_host_arch.GetTriple();
1270             if (host_triple.getVendor() == llvm::Triple::Apple &&
1271                 host_triple.getOS() == llvm::Triple::Darwin) {
1272               switch (m_host_arch.GetMachine()) {
1273               case llvm::Triple::aarch64:
1274               case llvm::Triple::arm:
1275               case llvm::Triple::thumb:
1276                 host_triple.setOS(llvm::Triple::IOS);
1277                 break;
1278               default:
1279                 host_triple.setOS(llvm::Triple::MacOSX);
1280                 break;
1281               }
1282             }
1283             if (pointer_byte_size) {
1284               assert(pointer_byte_size == m_host_arch.GetAddressByteSize());
1285             }
1286             if (byte_order != eByteOrderInvalid) {
1287               assert(byte_order == m_host_arch.GetByteOrder());
1288             }
1289           }
1290         } else {
1291           m_host_arch.SetTriple(triple.c_str());
1292           if (pointer_byte_size) {
1293             assert(pointer_byte_size == m_host_arch.GetAddressByteSize());
1294           }
1295           if (byte_order != eByteOrderInvalid) {
1296             assert(byte_order == m_host_arch.GetByteOrder());
1297           }
1298 
1299           LLDB_LOGF(log,
1300                     "GDBRemoteCommunicationClient::%s parsed host "
1301                     "architecture as %s, triple as %s from triple text %s",
1302                     __FUNCTION__,
1303                     m_host_arch.GetArchitectureName()
1304                         ? m_host_arch.GetArchitectureName()
1305                         : "<null-arch-name>",
1306                     m_host_arch.GetTriple().getTriple().c_str(),
1307                     triple.c_str());
1308         }
1309         if (!distribution_id.empty())
1310           m_host_arch.SetDistributionId(distribution_id.c_str());
1311       }
1312     }
1313   }
1314   return m_qHostInfo_is_valid == eLazyBoolYes;
1315 }
1316 
1317 int GDBRemoteCommunicationClient::SendAttach(
1318     lldb::pid_t pid, StringExtractorGDBRemote &response) {
1319   if (pid != LLDB_INVALID_PROCESS_ID) {
1320     char packet[64];
1321     const int packet_len =
1322         ::snprintf(packet, sizeof(packet), "vAttach;%" PRIx64, pid);
1323     UNUSED_IF_ASSERT_DISABLED(packet_len);
1324     assert(packet_len < (int)sizeof(packet));
1325     if (SendPacketAndWaitForResponse(packet, response, false) ==
1326         PacketResult::Success) {
1327       if (response.IsErrorResponse())
1328         return response.GetError();
1329       return 0;
1330     }
1331   }
1332   return -1;
1333 }
1334 
1335 int GDBRemoteCommunicationClient::SendStdinNotification(const char *data,
1336                                                         size_t data_len) {
1337   StreamString packet;
1338   packet.PutCString("I");
1339   packet.PutBytesAsRawHex8(data, data_len);
1340   StringExtractorGDBRemote response;
1341   if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
1342       PacketResult::Success) {
1343     return 0;
1344   }
1345   return response.GetError();
1346 }
1347 
1348 const lldb_private::ArchSpec &
1349 GDBRemoteCommunicationClient::GetHostArchitecture() {
1350   if (m_qHostInfo_is_valid == eLazyBoolCalculate)
1351     GetHostInfo();
1352   return m_host_arch;
1353 }
1354 
1355 seconds GDBRemoteCommunicationClient::GetHostDefaultPacketTimeout() {
1356   if (m_qHostInfo_is_valid == eLazyBoolCalculate)
1357     GetHostInfo();
1358   return m_default_packet_timeout;
1359 }
1360 
1361 addr_t GDBRemoteCommunicationClient::AllocateMemory(size_t size,
1362                                                     uint32_t permissions) {
1363   if (m_supports_alloc_dealloc_memory != eLazyBoolNo) {
1364     m_supports_alloc_dealloc_memory = eLazyBoolYes;
1365     char packet[64];
1366     const int packet_len = ::snprintf(
1367         packet, sizeof(packet), "_M%" PRIx64 ",%s%s%s", (uint64_t)size,
1368         permissions & lldb::ePermissionsReadable ? "r" : "",
1369         permissions & lldb::ePermissionsWritable ? "w" : "",
1370         permissions & lldb::ePermissionsExecutable ? "x" : "");
1371     assert(packet_len < (int)sizeof(packet));
1372     UNUSED_IF_ASSERT_DISABLED(packet_len);
1373     StringExtractorGDBRemote response;
1374     if (SendPacketAndWaitForResponse(packet, response, false) ==
1375         PacketResult::Success) {
1376       if (response.IsUnsupportedResponse())
1377         m_supports_alloc_dealloc_memory = eLazyBoolNo;
1378       else if (!response.IsErrorResponse())
1379         return response.GetHexMaxU64(false, LLDB_INVALID_ADDRESS);
1380     } else {
1381       m_supports_alloc_dealloc_memory = eLazyBoolNo;
1382     }
1383   }
1384   return LLDB_INVALID_ADDRESS;
1385 }
1386 
1387 bool GDBRemoteCommunicationClient::DeallocateMemory(addr_t addr) {
1388   if (m_supports_alloc_dealloc_memory != eLazyBoolNo) {
1389     m_supports_alloc_dealloc_memory = eLazyBoolYes;
1390     char packet[64];
1391     const int packet_len =
1392         ::snprintf(packet, sizeof(packet), "_m%" PRIx64, (uint64_t)addr);
1393     assert(packet_len < (int)sizeof(packet));
1394     UNUSED_IF_ASSERT_DISABLED(packet_len);
1395     StringExtractorGDBRemote response;
1396     if (SendPacketAndWaitForResponse(packet, response, false) ==
1397         PacketResult::Success) {
1398       if (response.IsUnsupportedResponse())
1399         m_supports_alloc_dealloc_memory = eLazyBoolNo;
1400       else if (response.IsOKResponse())
1401         return true;
1402     } else {
1403       m_supports_alloc_dealloc_memory = eLazyBoolNo;
1404     }
1405   }
1406   return false;
1407 }
1408 
1409 Status GDBRemoteCommunicationClient::Detach(bool keep_stopped) {
1410   Status error;
1411 
1412   if (keep_stopped) {
1413     if (m_supports_detach_stay_stopped == eLazyBoolCalculate) {
1414       char packet[64];
1415       const int packet_len =
1416           ::snprintf(packet, sizeof(packet), "qSupportsDetachAndStayStopped:");
1417       assert(packet_len < (int)sizeof(packet));
1418       UNUSED_IF_ASSERT_DISABLED(packet_len);
1419       StringExtractorGDBRemote response;
1420       if (SendPacketAndWaitForResponse(packet, response, false) ==
1421               PacketResult::Success &&
1422           response.IsOKResponse()) {
1423         m_supports_detach_stay_stopped = eLazyBoolYes;
1424       } else {
1425         m_supports_detach_stay_stopped = eLazyBoolNo;
1426       }
1427     }
1428 
1429     if (m_supports_detach_stay_stopped == eLazyBoolNo) {
1430       error.SetErrorString("Stays stopped not supported by this target.");
1431       return error;
1432     } else {
1433       StringExtractorGDBRemote response;
1434       PacketResult packet_result =
1435           SendPacketAndWaitForResponse("D1", response, false);
1436       if (packet_result != PacketResult::Success)
1437         error.SetErrorString("Sending extended disconnect packet failed.");
1438     }
1439   } else {
1440     StringExtractorGDBRemote response;
1441     PacketResult packet_result =
1442         SendPacketAndWaitForResponse("D", response, false);
1443     if (packet_result != PacketResult::Success)
1444       error.SetErrorString("Sending disconnect packet failed.");
1445   }
1446   return error;
1447 }
1448 
1449 Status GDBRemoteCommunicationClient::GetMemoryRegionInfo(
1450     lldb::addr_t addr, lldb_private::MemoryRegionInfo &region_info) {
1451   Status error;
1452   region_info.Clear();
1453 
1454   if (m_supports_memory_region_info != eLazyBoolNo) {
1455     m_supports_memory_region_info = eLazyBoolYes;
1456     char packet[64];
1457     const int packet_len = ::snprintf(
1458         packet, sizeof(packet), "qMemoryRegionInfo:%" PRIx64, (uint64_t)addr);
1459     assert(packet_len < (int)sizeof(packet));
1460     UNUSED_IF_ASSERT_DISABLED(packet_len);
1461     StringExtractorGDBRemote response;
1462     if (SendPacketAndWaitForResponse(packet, response, false) ==
1463             PacketResult::Success &&
1464         response.GetResponseType() == StringExtractorGDBRemote::eResponse) {
1465       llvm::StringRef name;
1466       llvm::StringRef value;
1467       addr_t addr_value = LLDB_INVALID_ADDRESS;
1468       bool success = true;
1469       bool saw_permissions = false;
1470       while (success && response.GetNameColonValue(name, value)) {
1471         if (name.equals("start")) {
1472           if (!value.getAsInteger(16, addr_value))
1473             region_info.GetRange().SetRangeBase(addr_value);
1474         } else if (name.equals("size")) {
1475           if (!value.getAsInteger(16, addr_value))
1476             region_info.GetRange().SetByteSize(addr_value);
1477         } else if (name.equals("permissions") &&
1478                    region_info.GetRange().IsValid()) {
1479           saw_permissions = true;
1480           if (region_info.GetRange().Contains(addr)) {
1481             if (value.find('r') != llvm::StringRef::npos)
1482               region_info.SetReadable(MemoryRegionInfo::eYes);
1483             else
1484               region_info.SetReadable(MemoryRegionInfo::eNo);
1485 
1486             if (value.find('w') != llvm::StringRef::npos)
1487               region_info.SetWritable(MemoryRegionInfo::eYes);
1488             else
1489               region_info.SetWritable(MemoryRegionInfo::eNo);
1490 
1491             if (value.find('x') != llvm::StringRef::npos)
1492               region_info.SetExecutable(MemoryRegionInfo::eYes);
1493             else
1494               region_info.SetExecutable(MemoryRegionInfo::eNo);
1495 
1496             region_info.SetMapped(MemoryRegionInfo::eYes);
1497           } else {
1498             // The reported region does not contain this address -- we're
1499             // looking at an unmapped page
1500             region_info.SetReadable(MemoryRegionInfo::eNo);
1501             region_info.SetWritable(MemoryRegionInfo::eNo);
1502             region_info.SetExecutable(MemoryRegionInfo::eNo);
1503             region_info.SetMapped(MemoryRegionInfo::eNo);
1504           }
1505         } else if (name.equals("name")) {
1506           StringExtractorGDBRemote name_extractor(value);
1507           std::string name;
1508           name_extractor.GetHexByteString(name);
1509           region_info.SetName(name.c_str());
1510         } else if (name.equals("error")) {
1511           StringExtractorGDBRemote error_extractor(value);
1512           std::string error_string;
1513           // Now convert the HEX bytes into a string value
1514           error_extractor.GetHexByteString(error_string);
1515           error.SetErrorString(error_string.c_str());
1516         }
1517       }
1518 
1519       if (region_info.GetRange().IsValid()) {
1520         // We got a valid address range back but no permissions -- which means
1521         // this is an unmapped page
1522         if (!saw_permissions) {
1523           region_info.SetReadable(MemoryRegionInfo::eNo);
1524           region_info.SetWritable(MemoryRegionInfo::eNo);
1525           region_info.SetExecutable(MemoryRegionInfo::eNo);
1526           region_info.SetMapped(MemoryRegionInfo::eNo);
1527         }
1528       } else {
1529         // We got an invalid address range back
1530         error.SetErrorString("Server returned invalid range");
1531       }
1532     } else {
1533       m_supports_memory_region_info = eLazyBoolNo;
1534     }
1535   }
1536 
1537   if (m_supports_memory_region_info == eLazyBoolNo) {
1538     error.SetErrorString("qMemoryRegionInfo is not supported");
1539   }
1540 
1541   // Try qXfer:memory-map:read to get region information not included in
1542   // qMemoryRegionInfo
1543   MemoryRegionInfo qXfer_region_info;
1544   Status qXfer_error = GetQXferMemoryMapRegionInfo(addr, qXfer_region_info);
1545 
1546   if (error.Fail()) {
1547     // If qMemoryRegionInfo failed, but qXfer:memory-map:read succeeded, use
1548     // the qXfer result as a fallback
1549     if (qXfer_error.Success()) {
1550       region_info = qXfer_region_info;
1551       error.Clear();
1552     } else {
1553       region_info.Clear();
1554     }
1555   } else if (qXfer_error.Success()) {
1556     // If both qMemoryRegionInfo and qXfer:memory-map:read succeeded, and if
1557     // both regions are the same range, update the result to include the flash-
1558     // memory information that is specific to the qXfer result.
1559     if (region_info.GetRange() == qXfer_region_info.GetRange()) {
1560       region_info.SetFlash(qXfer_region_info.GetFlash());
1561       region_info.SetBlocksize(qXfer_region_info.GetBlocksize());
1562     }
1563   }
1564   return error;
1565 }
1566 
1567 Status GDBRemoteCommunicationClient::GetQXferMemoryMapRegionInfo(
1568     lldb::addr_t addr, MemoryRegionInfo &region) {
1569   Status error = LoadQXferMemoryMap();
1570   if (!error.Success())
1571     return error;
1572   for (const auto &map_region : m_qXfer_memory_map) {
1573     if (map_region.GetRange().Contains(addr)) {
1574       region = map_region;
1575       return error;
1576     }
1577   }
1578   error.SetErrorString("Region not found");
1579   return error;
1580 }
1581 
1582 Status GDBRemoteCommunicationClient::LoadQXferMemoryMap() {
1583 
1584   Status error;
1585 
1586   if (m_qXfer_memory_map_loaded)
1587     // Already loaded, return success
1588     return error;
1589 
1590   if (!XMLDocument::XMLEnabled()) {
1591     error.SetErrorString("XML is not supported");
1592     return error;
1593   }
1594 
1595   if (!GetQXferMemoryMapReadSupported()) {
1596     error.SetErrorString("Memory map is not supported");
1597     return error;
1598   }
1599 
1600   std::string xml;
1601   lldb_private::Status lldberr;
1602   if (!ReadExtFeature(ConstString("memory-map"), ConstString(""), xml,
1603                       lldberr)) {
1604     error.SetErrorString("Failed to read memory map");
1605     return error;
1606   }
1607 
1608   XMLDocument xml_document;
1609 
1610   if (!xml_document.ParseMemory(xml.c_str(), xml.size())) {
1611     error.SetErrorString("Failed to parse memory map xml");
1612     return error;
1613   }
1614 
1615   XMLNode map_node = xml_document.GetRootElement("memory-map");
1616   if (!map_node) {
1617     error.SetErrorString("Invalid root node in memory map xml");
1618     return error;
1619   }
1620 
1621   m_qXfer_memory_map.clear();
1622 
1623   map_node.ForEachChildElement([this](const XMLNode &memory_node) -> bool {
1624     if (!memory_node.IsElement())
1625       return true;
1626     if (memory_node.GetName() != "memory")
1627       return true;
1628     auto type = memory_node.GetAttributeValue("type", "");
1629     uint64_t start;
1630     uint64_t length;
1631     if (!memory_node.GetAttributeValueAsUnsigned("start", start))
1632       return true;
1633     if (!memory_node.GetAttributeValueAsUnsigned("length", length))
1634       return true;
1635     MemoryRegionInfo region;
1636     region.GetRange().SetRangeBase(start);
1637     region.GetRange().SetByteSize(length);
1638     if (type == "rom") {
1639       region.SetReadable(MemoryRegionInfo::eYes);
1640       this->m_qXfer_memory_map.push_back(region);
1641     } else if (type == "ram") {
1642       region.SetReadable(MemoryRegionInfo::eYes);
1643       region.SetWritable(MemoryRegionInfo::eYes);
1644       this->m_qXfer_memory_map.push_back(region);
1645     } else if (type == "flash") {
1646       region.SetFlash(MemoryRegionInfo::eYes);
1647       memory_node.ForEachChildElement(
1648           [&region](const XMLNode &prop_node) -> bool {
1649             if (!prop_node.IsElement())
1650               return true;
1651             if (prop_node.GetName() != "property")
1652               return true;
1653             auto propname = prop_node.GetAttributeValue("name", "");
1654             if (propname == "blocksize") {
1655               uint64_t blocksize;
1656               if (prop_node.GetElementTextAsUnsigned(blocksize))
1657                 region.SetBlocksize(blocksize);
1658             }
1659             return true;
1660           });
1661       this->m_qXfer_memory_map.push_back(region);
1662     }
1663     return true;
1664   });
1665 
1666   m_qXfer_memory_map_loaded = true;
1667 
1668   return error;
1669 }
1670 
1671 Status GDBRemoteCommunicationClient::GetWatchpointSupportInfo(uint32_t &num) {
1672   Status error;
1673 
1674   if (m_supports_watchpoint_support_info == eLazyBoolYes) {
1675     num = m_num_supported_hardware_watchpoints;
1676     return error;
1677   }
1678 
1679   // Set num to 0 first.
1680   num = 0;
1681   if (m_supports_watchpoint_support_info != eLazyBoolNo) {
1682     char packet[64];
1683     const int packet_len =
1684         ::snprintf(packet, sizeof(packet), "qWatchpointSupportInfo:");
1685     assert(packet_len < (int)sizeof(packet));
1686     UNUSED_IF_ASSERT_DISABLED(packet_len);
1687     StringExtractorGDBRemote response;
1688     if (SendPacketAndWaitForResponse(packet, response, false) ==
1689         PacketResult::Success) {
1690       m_supports_watchpoint_support_info = eLazyBoolYes;
1691       llvm::StringRef name;
1692       llvm::StringRef value;
1693       bool found_num_field = false;
1694       while (response.GetNameColonValue(name, value)) {
1695         if (name.equals("num")) {
1696           value.getAsInteger(0, m_num_supported_hardware_watchpoints);
1697           num = m_num_supported_hardware_watchpoints;
1698           found_num_field = true;
1699         }
1700       }
1701       if (!found_num_field) {
1702         m_supports_watchpoint_support_info = eLazyBoolNo;
1703       }
1704     } else {
1705       m_supports_watchpoint_support_info = eLazyBoolNo;
1706     }
1707   }
1708 
1709   if (m_supports_watchpoint_support_info == eLazyBoolNo) {
1710     error.SetErrorString("qWatchpointSupportInfo is not supported");
1711   }
1712   return error;
1713 }
1714 
1715 lldb_private::Status GDBRemoteCommunicationClient::GetWatchpointSupportInfo(
1716     uint32_t &num, bool &after, const ArchSpec &arch) {
1717   Status error(GetWatchpointSupportInfo(num));
1718   if (error.Success())
1719     error = GetWatchpointsTriggerAfterInstruction(after, arch);
1720   return error;
1721 }
1722 
1723 lldb_private::Status
1724 GDBRemoteCommunicationClient::GetWatchpointsTriggerAfterInstruction(
1725     bool &after, const ArchSpec &arch) {
1726   Status error;
1727   llvm::Triple triple = arch.GetTriple();
1728 
1729   // we assume watchpoints will happen after running the relevant opcode and we
1730   // only want to override this behavior if we have explicitly received a
1731   // qHostInfo telling us otherwise
1732   if (m_qHostInfo_is_valid != eLazyBoolYes) {
1733     // On targets like MIPS and ppc64, watchpoint exceptions are always
1734     // generated before the instruction is executed. The connected target may
1735     // not support qHostInfo or qWatchpointSupportInfo packets.
1736     after = !(triple.isMIPS() || triple.isPPC64());
1737   } else {
1738     // For MIPS and ppc64, set m_watchpoints_trigger_after_instruction to
1739     // eLazyBoolNo if it is not calculated before.
1740     if (m_watchpoints_trigger_after_instruction == eLazyBoolCalculate &&
1741         (triple.isMIPS() || triple.isPPC64()))
1742       m_watchpoints_trigger_after_instruction = eLazyBoolNo;
1743 
1744     after = (m_watchpoints_trigger_after_instruction != eLazyBoolNo);
1745   }
1746   return error;
1747 }
1748 
1749 int GDBRemoteCommunicationClient::SetSTDIN(const FileSpec &file_spec) {
1750   if (file_spec) {
1751     std::string path{file_spec.GetPath(false)};
1752     StreamString packet;
1753     packet.PutCString("QSetSTDIN:");
1754     packet.PutStringAsRawHex8(path);
1755 
1756     StringExtractorGDBRemote response;
1757     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
1758         PacketResult::Success) {
1759       if (response.IsOKResponse())
1760         return 0;
1761       uint8_t error = response.GetError();
1762       if (error)
1763         return error;
1764     }
1765   }
1766   return -1;
1767 }
1768 
1769 int GDBRemoteCommunicationClient::SetSTDOUT(const FileSpec &file_spec) {
1770   if (file_spec) {
1771     std::string path{file_spec.GetPath(false)};
1772     StreamString packet;
1773     packet.PutCString("QSetSTDOUT:");
1774     packet.PutStringAsRawHex8(path);
1775 
1776     StringExtractorGDBRemote response;
1777     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
1778         PacketResult::Success) {
1779       if (response.IsOKResponse())
1780         return 0;
1781       uint8_t error = response.GetError();
1782       if (error)
1783         return error;
1784     }
1785   }
1786   return -1;
1787 }
1788 
1789 int GDBRemoteCommunicationClient::SetSTDERR(const FileSpec &file_spec) {
1790   if (file_spec) {
1791     std::string path{file_spec.GetPath(false)};
1792     StreamString packet;
1793     packet.PutCString("QSetSTDERR:");
1794     packet.PutStringAsRawHex8(path);
1795 
1796     StringExtractorGDBRemote response;
1797     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
1798         PacketResult::Success) {
1799       if (response.IsOKResponse())
1800         return 0;
1801       uint8_t error = response.GetError();
1802       if (error)
1803         return error;
1804     }
1805   }
1806   return -1;
1807 }
1808 
1809 bool GDBRemoteCommunicationClient::GetWorkingDir(FileSpec &working_dir) {
1810   StringExtractorGDBRemote response;
1811   if (SendPacketAndWaitForResponse("qGetWorkingDir", response, false) ==
1812       PacketResult::Success) {
1813     if (response.IsUnsupportedResponse())
1814       return false;
1815     if (response.IsErrorResponse())
1816       return false;
1817     std::string cwd;
1818     response.GetHexByteString(cwd);
1819     working_dir.SetFile(cwd, GetHostArchitecture().GetTriple());
1820     return !cwd.empty();
1821   }
1822   return false;
1823 }
1824 
1825 int GDBRemoteCommunicationClient::SetWorkingDir(const FileSpec &working_dir) {
1826   if (working_dir) {
1827     std::string path{working_dir.GetPath(false)};
1828     StreamString packet;
1829     packet.PutCString("QSetWorkingDir:");
1830     packet.PutStringAsRawHex8(path);
1831 
1832     StringExtractorGDBRemote response;
1833     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
1834         PacketResult::Success) {
1835       if (response.IsOKResponse())
1836         return 0;
1837       uint8_t error = response.GetError();
1838       if (error)
1839         return error;
1840     }
1841   }
1842   return -1;
1843 }
1844 
1845 int GDBRemoteCommunicationClient::SetDisableASLR(bool enable) {
1846   char packet[32];
1847   const int packet_len =
1848       ::snprintf(packet, sizeof(packet), "QSetDisableASLR:%i", enable ? 1 : 0);
1849   assert(packet_len < (int)sizeof(packet));
1850   UNUSED_IF_ASSERT_DISABLED(packet_len);
1851   StringExtractorGDBRemote response;
1852   if (SendPacketAndWaitForResponse(packet, response, false) ==
1853       PacketResult::Success) {
1854     if (response.IsOKResponse())
1855       return 0;
1856     uint8_t error = response.GetError();
1857     if (error)
1858       return error;
1859   }
1860   return -1;
1861 }
1862 
1863 int GDBRemoteCommunicationClient::SetDetachOnError(bool enable) {
1864   char packet[32];
1865   const int packet_len = ::snprintf(packet, sizeof(packet),
1866                                     "QSetDetachOnError:%i", enable ? 1 : 0);
1867   assert(packet_len < (int)sizeof(packet));
1868   UNUSED_IF_ASSERT_DISABLED(packet_len);
1869   StringExtractorGDBRemote response;
1870   if (SendPacketAndWaitForResponse(packet, response, false) ==
1871       PacketResult::Success) {
1872     if (response.IsOKResponse())
1873       return 0;
1874     uint8_t error = response.GetError();
1875     if (error)
1876       return error;
1877   }
1878   return -1;
1879 }
1880 
1881 bool GDBRemoteCommunicationClient::DecodeProcessInfoResponse(
1882     StringExtractorGDBRemote &response, ProcessInstanceInfo &process_info) {
1883   if (response.IsNormalResponse()) {
1884     llvm::StringRef name;
1885     llvm::StringRef value;
1886     StringExtractor extractor;
1887 
1888     uint32_t cpu = LLDB_INVALID_CPUTYPE;
1889     uint32_t sub = 0;
1890     std::string vendor;
1891     std::string os_type;
1892 
1893     while (response.GetNameColonValue(name, value)) {
1894       if (name.equals("pid")) {
1895         lldb::pid_t pid = LLDB_INVALID_PROCESS_ID;
1896         value.getAsInteger(0, pid);
1897         process_info.SetProcessID(pid);
1898       } else if (name.equals("ppid")) {
1899         lldb::pid_t pid = LLDB_INVALID_PROCESS_ID;
1900         value.getAsInteger(0, pid);
1901         process_info.SetParentProcessID(pid);
1902       } else if (name.equals("uid")) {
1903         uint32_t uid = UINT32_MAX;
1904         value.getAsInteger(0, uid);
1905         process_info.SetUserID(uid);
1906       } else if (name.equals("euid")) {
1907         uint32_t uid = UINT32_MAX;
1908         value.getAsInteger(0, uid);
1909         process_info.SetEffectiveGroupID(uid);
1910       } else if (name.equals("gid")) {
1911         uint32_t gid = UINT32_MAX;
1912         value.getAsInteger(0, gid);
1913         process_info.SetGroupID(gid);
1914       } else if (name.equals("egid")) {
1915         uint32_t gid = UINT32_MAX;
1916         value.getAsInteger(0, gid);
1917         process_info.SetEffectiveGroupID(gid);
1918       } else if (name.equals("triple")) {
1919         StringExtractor extractor(value);
1920         std::string triple;
1921         extractor.GetHexByteString(triple);
1922         process_info.GetArchitecture().SetTriple(triple.c_str());
1923       } else if (name.equals("name")) {
1924         StringExtractor extractor(value);
1925         // The process name from ASCII hex bytes since we can't control the
1926         // characters in a process name
1927         std::string name;
1928         extractor.GetHexByteString(name);
1929         process_info.GetExecutableFile().SetFile(name, FileSpec::Style::native);
1930       } else if (name.equals("cputype")) {
1931         value.getAsInteger(0, cpu);
1932       } else if (name.equals("cpusubtype")) {
1933         value.getAsInteger(0, sub);
1934       } else if (name.equals("vendor")) {
1935         vendor = value;
1936       } else if (name.equals("ostype")) {
1937         os_type = value;
1938       }
1939     }
1940 
1941     if (cpu != LLDB_INVALID_CPUTYPE && !vendor.empty() && !os_type.empty()) {
1942       if (vendor == "apple") {
1943         process_info.GetArchitecture().SetArchitecture(eArchTypeMachO, cpu,
1944                                                        sub);
1945         process_info.GetArchitecture().GetTriple().setVendorName(
1946             llvm::StringRef(vendor));
1947         process_info.GetArchitecture().GetTriple().setOSName(
1948             llvm::StringRef(os_type));
1949       }
1950     }
1951 
1952     if (process_info.GetProcessID() != LLDB_INVALID_PROCESS_ID)
1953       return true;
1954   }
1955   return false;
1956 }
1957 
1958 bool GDBRemoteCommunicationClient::GetProcessInfo(
1959     lldb::pid_t pid, ProcessInstanceInfo &process_info) {
1960   process_info.Clear();
1961 
1962   if (m_supports_qProcessInfoPID) {
1963     char packet[32];
1964     const int packet_len =
1965         ::snprintf(packet, sizeof(packet), "qProcessInfoPID:%" PRIu64, pid);
1966     assert(packet_len < (int)sizeof(packet));
1967     UNUSED_IF_ASSERT_DISABLED(packet_len);
1968     StringExtractorGDBRemote response;
1969     if (SendPacketAndWaitForResponse(packet, response, false) ==
1970         PacketResult::Success) {
1971       return DecodeProcessInfoResponse(response, process_info);
1972     } else {
1973       m_supports_qProcessInfoPID = false;
1974       return false;
1975     }
1976   }
1977   return false;
1978 }
1979 
1980 bool GDBRemoteCommunicationClient::GetCurrentProcessInfo(bool allow_lazy) {
1981   Log *log(ProcessGDBRemoteLog::GetLogIfAnyCategoryIsSet(GDBR_LOG_PROCESS |
1982                                                          GDBR_LOG_PACKETS));
1983 
1984   if (allow_lazy) {
1985     if (m_qProcessInfo_is_valid == eLazyBoolYes)
1986       return true;
1987     if (m_qProcessInfo_is_valid == eLazyBoolNo)
1988       return false;
1989   }
1990 
1991   GetHostInfo();
1992 
1993   StringExtractorGDBRemote response;
1994   if (SendPacketAndWaitForResponse("qProcessInfo", response, false) ==
1995       PacketResult::Success) {
1996     if (response.IsNormalResponse()) {
1997       llvm::StringRef name;
1998       llvm::StringRef value;
1999       uint32_t cpu = LLDB_INVALID_CPUTYPE;
2000       uint32_t sub = 0;
2001       std::string arch_name;
2002       std::string os_name;
2003       std::string environment;
2004       std::string vendor_name;
2005       std::string triple;
2006       std::string elf_abi;
2007       uint32_t pointer_byte_size = 0;
2008       StringExtractor extractor;
2009       ByteOrder byte_order = eByteOrderInvalid;
2010       uint32_t num_keys_decoded = 0;
2011       lldb::pid_t pid = LLDB_INVALID_PROCESS_ID;
2012       while (response.GetNameColonValue(name, value)) {
2013         if (name.equals("cputype")) {
2014           if (!value.getAsInteger(16, cpu))
2015             ++num_keys_decoded;
2016         } else if (name.equals("cpusubtype")) {
2017           if (!value.getAsInteger(16, sub))
2018             ++num_keys_decoded;
2019         } else if (name.equals("triple")) {
2020           StringExtractor extractor(value);
2021           extractor.GetHexByteString(triple);
2022           ++num_keys_decoded;
2023         } else if (name.equals("ostype")) {
2024           if (value.equals("maccatalyst")) {
2025             os_name = "ios";
2026             environment = "macabi";
2027           } else
2028             os_name = value;
2029           ++num_keys_decoded;
2030         } else if (name.equals("vendor")) {
2031           vendor_name = value;
2032           ++num_keys_decoded;
2033         } else if (name.equals("endian")) {
2034           byte_order = llvm::StringSwitch<lldb::ByteOrder>(value)
2035                            .Case("little", eByteOrderLittle)
2036                            .Case("big", eByteOrderBig)
2037                            .Case("pdp", eByteOrderPDP)
2038                            .Default(eByteOrderInvalid);
2039           if (byte_order != eByteOrderInvalid)
2040             ++num_keys_decoded;
2041         } else if (name.equals("ptrsize")) {
2042           if (!value.getAsInteger(16, pointer_byte_size))
2043             ++num_keys_decoded;
2044         } else if (name.equals("pid")) {
2045           if (!value.getAsInteger(16, pid))
2046             ++num_keys_decoded;
2047         } else if (name.equals("elf_abi")) {
2048           elf_abi = value;
2049           ++num_keys_decoded;
2050         }
2051       }
2052       if (num_keys_decoded > 0)
2053         m_qProcessInfo_is_valid = eLazyBoolYes;
2054       if (pid != LLDB_INVALID_PROCESS_ID) {
2055         m_curr_pid_is_valid = eLazyBoolYes;
2056         m_curr_pid = pid;
2057       }
2058 
2059       // Set the ArchSpec from the triple if we have it.
2060       if (!triple.empty()) {
2061         m_process_arch.SetTriple(triple.c_str());
2062         m_process_arch.SetFlags(elf_abi);
2063         if (pointer_byte_size) {
2064           assert(pointer_byte_size == m_process_arch.GetAddressByteSize());
2065         }
2066       } else if (cpu != LLDB_INVALID_CPUTYPE && !os_name.empty() &&
2067                  !vendor_name.empty()) {
2068         llvm::Triple triple(llvm::Twine("-") + vendor_name + "-" + os_name);
2069         if (!environment.empty())
2070             triple.setEnvironmentName(environment);
2071 
2072         assert(triple.getObjectFormat() != llvm::Triple::UnknownObjectFormat);
2073         assert(triple.getObjectFormat() != llvm::Triple::Wasm);
2074         assert(triple.getObjectFormat() != llvm::Triple::XCOFF);
2075         switch (triple.getObjectFormat()) {
2076         case llvm::Triple::MachO:
2077           m_process_arch.SetArchitecture(eArchTypeMachO, cpu, sub);
2078           break;
2079         case llvm::Triple::ELF:
2080           m_process_arch.SetArchitecture(eArchTypeELF, cpu, sub);
2081           break;
2082         case llvm::Triple::COFF:
2083           m_process_arch.SetArchitecture(eArchTypeCOFF, cpu, sub);
2084           break;
2085         case llvm::Triple::Wasm:
2086         case llvm::Triple::XCOFF:
2087           LLDB_LOGF(log, "error: not supported target architecture");
2088           return false;
2089         case llvm::Triple::UnknownObjectFormat:
2090           LLDB_LOGF(log, "error: failed to determine target architecture");
2091           return false;
2092         }
2093 
2094         if (pointer_byte_size) {
2095           assert(pointer_byte_size == m_process_arch.GetAddressByteSize());
2096         }
2097         if (byte_order != eByteOrderInvalid) {
2098           assert(byte_order == m_process_arch.GetByteOrder());
2099         }
2100         m_process_arch.GetTriple().setVendorName(llvm::StringRef(vendor_name));
2101         m_process_arch.GetTriple().setOSName(llvm::StringRef(os_name));
2102         m_process_arch.GetTriple().setEnvironmentName(llvm::StringRef(environment));
2103         m_host_arch.GetTriple().setVendorName(llvm::StringRef(vendor_name));
2104         m_host_arch.GetTriple().setOSName(llvm::StringRef(os_name));
2105         m_host_arch.GetTriple().setEnvironmentName(llvm::StringRef(environment));
2106       }
2107       return true;
2108     }
2109   } else {
2110     m_qProcessInfo_is_valid = eLazyBoolNo;
2111   }
2112 
2113   return false;
2114 }
2115 
2116 uint32_t GDBRemoteCommunicationClient::FindProcesses(
2117     const ProcessInstanceInfoMatch &match_info,
2118     ProcessInstanceInfoList &process_infos) {
2119   process_infos.Clear();
2120 
2121   if (m_supports_qfProcessInfo) {
2122     StreamString packet;
2123     packet.PutCString("qfProcessInfo");
2124     if (!match_info.MatchAllProcesses()) {
2125       packet.PutChar(':');
2126       const char *name = match_info.GetProcessInfo().GetName();
2127       bool has_name_match = false;
2128       if (name && name[0]) {
2129         has_name_match = true;
2130         NameMatch name_match_type = match_info.GetNameMatchType();
2131         switch (name_match_type) {
2132         case NameMatch::Ignore:
2133           has_name_match = false;
2134           break;
2135 
2136         case NameMatch::Equals:
2137           packet.PutCString("name_match:equals;");
2138           break;
2139 
2140         case NameMatch::Contains:
2141           packet.PutCString("name_match:contains;");
2142           break;
2143 
2144         case NameMatch::StartsWith:
2145           packet.PutCString("name_match:starts_with;");
2146           break;
2147 
2148         case NameMatch::EndsWith:
2149           packet.PutCString("name_match:ends_with;");
2150           break;
2151 
2152         case NameMatch::RegularExpression:
2153           packet.PutCString("name_match:regex;");
2154           break;
2155         }
2156         if (has_name_match) {
2157           packet.PutCString("name:");
2158           packet.PutBytesAsRawHex8(name, ::strlen(name));
2159           packet.PutChar(';');
2160         }
2161       }
2162 
2163       if (match_info.GetProcessInfo().ProcessIDIsValid())
2164         packet.Printf("pid:%" PRIu64 ";",
2165                       match_info.GetProcessInfo().GetProcessID());
2166       if (match_info.GetProcessInfo().ParentProcessIDIsValid())
2167         packet.Printf("parent_pid:%" PRIu64 ";",
2168                       match_info.GetProcessInfo().GetParentProcessID());
2169       if (match_info.GetProcessInfo().UserIDIsValid())
2170         packet.Printf("uid:%u;", match_info.GetProcessInfo().GetUserID());
2171       if (match_info.GetProcessInfo().GroupIDIsValid())
2172         packet.Printf("gid:%u;", match_info.GetProcessInfo().GetGroupID());
2173       if (match_info.GetProcessInfo().EffectiveUserIDIsValid())
2174         packet.Printf("euid:%u;",
2175                       match_info.GetProcessInfo().GetEffectiveUserID());
2176       if (match_info.GetProcessInfo().EffectiveGroupIDIsValid())
2177         packet.Printf("egid:%u;",
2178                       match_info.GetProcessInfo().GetEffectiveGroupID());
2179       if (match_info.GetProcessInfo().EffectiveGroupIDIsValid())
2180         packet.Printf("all_users:%u;", match_info.GetMatchAllUsers() ? 1 : 0);
2181       if (match_info.GetProcessInfo().GetArchitecture().IsValid()) {
2182         const ArchSpec &match_arch =
2183             match_info.GetProcessInfo().GetArchitecture();
2184         const llvm::Triple &triple = match_arch.GetTriple();
2185         packet.PutCString("triple:");
2186         packet.PutCString(triple.getTriple());
2187         packet.PutChar(';');
2188       }
2189     }
2190     StringExtractorGDBRemote response;
2191     // Increase timeout as the first qfProcessInfo packet takes a long time on
2192     // Android. The value of 1min was arrived at empirically.
2193     ScopedTimeout timeout(*this, minutes(1));
2194     if (SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
2195         PacketResult::Success) {
2196       do {
2197         ProcessInstanceInfo process_info;
2198         if (!DecodeProcessInfoResponse(response, process_info))
2199           break;
2200         process_infos.Append(process_info);
2201         response = StringExtractorGDBRemote();
2202       } while (SendPacketAndWaitForResponse("qsProcessInfo", response, false) ==
2203                PacketResult::Success);
2204     } else {
2205       m_supports_qfProcessInfo = false;
2206       return 0;
2207     }
2208   }
2209   return process_infos.GetSize();
2210 }
2211 
2212 bool GDBRemoteCommunicationClient::GetUserName(uint32_t uid,
2213                                                std::string &name) {
2214   if (m_supports_qUserName) {
2215     char packet[32];
2216     const int packet_len =
2217         ::snprintf(packet, sizeof(packet), "qUserName:%i", uid);
2218     assert(packet_len < (int)sizeof(packet));
2219     UNUSED_IF_ASSERT_DISABLED(packet_len);
2220     StringExtractorGDBRemote response;
2221     if (SendPacketAndWaitForResponse(packet, response, false) ==
2222         PacketResult::Success) {
2223       if (response.IsNormalResponse()) {
2224         // Make sure we parsed the right number of characters. The response is
2225         // the hex encoded user name and should make up the entire packet. If
2226         // there are any non-hex ASCII bytes, the length won't match below..
2227         if (response.GetHexByteString(name) * 2 ==
2228             response.GetStringRef().size())
2229           return true;
2230       }
2231     } else {
2232       m_supports_qUserName = false;
2233       return false;
2234     }
2235   }
2236   return false;
2237 }
2238 
2239 bool GDBRemoteCommunicationClient::GetGroupName(uint32_t gid,
2240                                                 std::string &name) {
2241   if (m_supports_qGroupName) {
2242     char packet[32];
2243     const int packet_len =
2244         ::snprintf(packet, sizeof(packet), "qGroupName:%i", gid);
2245     assert(packet_len < (int)sizeof(packet));
2246     UNUSED_IF_ASSERT_DISABLED(packet_len);
2247     StringExtractorGDBRemote response;
2248     if (SendPacketAndWaitForResponse(packet, response, false) ==
2249         PacketResult::Success) {
2250       if (response.IsNormalResponse()) {
2251         // Make sure we parsed the right number of characters. The response is
2252         // the hex encoded group name and should make up the entire packet. If
2253         // there are any non-hex ASCII bytes, the length won't match below..
2254         if (response.GetHexByteString(name) * 2 ==
2255             response.GetStringRef().size())
2256           return true;
2257       }
2258     } else {
2259       m_supports_qGroupName = false;
2260       return false;
2261     }
2262   }
2263   return false;
2264 }
2265 
2266 bool GDBRemoteCommunicationClient::SetNonStopMode(const bool enable) {
2267   // Form non-stop packet request
2268   char packet[32];
2269   const int packet_len =
2270       ::snprintf(packet, sizeof(packet), "QNonStop:%1d", (int)enable);
2271   assert(packet_len < (int)sizeof(packet));
2272   UNUSED_IF_ASSERT_DISABLED(packet_len);
2273 
2274   StringExtractorGDBRemote response;
2275   // Send to target
2276   if (SendPacketAndWaitForResponse(packet, response, false) ==
2277       PacketResult::Success)
2278     if (response.IsOKResponse())
2279       return true;
2280 
2281   // Failed or not supported
2282   return false;
2283 }
2284 
2285 static void MakeSpeedTestPacket(StreamString &packet, uint32_t send_size,
2286                                 uint32_t recv_size) {
2287   packet.Clear();
2288   packet.Printf("qSpeedTest:response_size:%i;data:", recv_size);
2289   uint32_t bytes_left = send_size;
2290   while (bytes_left > 0) {
2291     if (bytes_left >= 26) {
2292       packet.PutCString("abcdefghijklmnopqrstuvwxyz");
2293       bytes_left -= 26;
2294     } else {
2295       packet.Printf("%*.*s;", bytes_left, bytes_left,
2296                     "abcdefghijklmnopqrstuvwxyz");
2297       bytes_left = 0;
2298     }
2299   }
2300 }
2301 
2302 duration<float>
2303 calculate_standard_deviation(const std::vector<duration<float>> &v) {
2304   using Dur = duration<float>;
2305   Dur sum = std::accumulate(std::begin(v), std::end(v), Dur());
2306   Dur mean = sum / v.size();
2307   float accum = 0;
2308   for (auto d : v) {
2309     float delta = (d - mean).count();
2310     accum += delta * delta;
2311   };
2312 
2313   return Dur(sqrtf(accum / (v.size() - 1)));
2314 }
2315 
2316 void GDBRemoteCommunicationClient::TestPacketSpeed(const uint32_t num_packets,
2317                                                    uint32_t max_send,
2318                                                    uint32_t max_recv,
2319                                                    uint64_t recv_amount,
2320                                                    bool json, Stream &strm) {
2321   uint32_t i;
2322   if (SendSpeedTestPacket(0, 0)) {
2323     StreamString packet;
2324     if (json)
2325       strm.Printf("{ \"packet_speeds\" : {\n    \"num_packets\" : %u,\n    "
2326                   "\"results\" : [",
2327                   num_packets);
2328     else
2329       strm.Printf("Testing sending %u packets of various sizes:\n",
2330                   num_packets);
2331     strm.Flush();
2332 
2333     uint32_t result_idx = 0;
2334     uint32_t send_size;
2335     std::vector<duration<float>> packet_times;
2336 
2337     for (send_size = 0; send_size <= max_send;
2338          send_size ? send_size *= 2 : send_size = 4) {
2339       for (uint32_t recv_size = 0; recv_size <= max_recv;
2340            recv_size ? recv_size *= 2 : recv_size = 4) {
2341         MakeSpeedTestPacket(packet, send_size, recv_size);
2342 
2343         packet_times.clear();
2344         // Test how long it takes to send 'num_packets' packets
2345         const auto start_time = steady_clock::now();
2346         for (i = 0; i < num_packets; ++i) {
2347           const auto packet_start_time = steady_clock::now();
2348           StringExtractorGDBRemote response;
2349           SendPacketAndWaitForResponse(packet.GetString(), response, false);
2350           const auto packet_end_time = steady_clock::now();
2351           packet_times.push_back(packet_end_time - packet_start_time);
2352         }
2353         const auto end_time = steady_clock::now();
2354         const auto total_time = end_time - start_time;
2355 
2356         float packets_per_second =
2357             ((float)num_packets) / duration<float>(total_time).count();
2358         auto average_per_packet = total_time / num_packets;
2359         const duration<float> standard_deviation =
2360             calculate_standard_deviation(packet_times);
2361         if (json) {
2362           strm.Format("{0}\n     {{\"send_size\" : {1,6}, \"recv_size\" : "
2363                       "{2,6}, \"total_time_nsec\" : {3,12:ns-}, "
2364                       "\"standard_deviation_nsec\" : {4,9:ns-f0}}",
2365                       result_idx > 0 ? "," : "", send_size, recv_size,
2366                       total_time, standard_deviation);
2367           ++result_idx;
2368         } else {
2369           strm.Format("qSpeedTest(send={0,7}, recv={1,7}) in {2:s+f9} for "
2370                       "{3,9:f2} packets/s ({4,10:ms+f6} per packet) with "
2371                       "standard deviation of {5,10:ms+f6}\n",
2372                       send_size, recv_size, duration<float>(total_time),
2373                       packets_per_second, duration<float>(average_per_packet),
2374                       standard_deviation);
2375         }
2376         strm.Flush();
2377       }
2378     }
2379 
2380     const float k_recv_amount_mb = (float)recv_amount / (1024.0f * 1024.0f);
2381     if (json)
2382       strm.Printf("\n    ]\n  },\n  \"download_speed\" : {\n    \"byte_size\" "
2383                   ": %" PRIu64 ",\n    \"results\" : [",
2384                   recv_amount);
2385     else
2386       strm.Printf("Testing receiving %2.1fMB of data using varying receive "
2387                   "packet sizes:\n",
2388                   k_recv_amount_mb);
2389     strm.Flush();
2390     send_size = 0;
2391     result_idx = 0;
2392     for (uint32_t recv_size = 32; recv_size <= max_recv; recv_size *= 2) {
2393       MakeSpeedTestPacket(packet, send_size, recv_size);
2394 
2395       // If we have a receive size, test how long it takes to receive 4MB of
2396       // data
2397       if (recv_size > 0) {
2398         const auto start_time = steady_clock::now();
2399         uint32_t bytes_read = 0;
2400         uint32_t packet_count = 0;
2401         while (bytes_read < recv_amount) {
2402           StringExtractorGDBRemote response;
2403           SendPacketAndWaitForResponse(packet.GetString(), response, false);
2404           bytes_read += recv_size;
2405           ++packet_count;
2406         }
2407         const auto end_time = steady_clock::now();
2408         const auto total_time = end_time - start_time;
2409         float mb_second = ((float)recv_amount) /
2410                           duration<float>(total_time).count() /
2411                           (1024.0 * 1024.0);
2412         float packets_per_second =
2413             ((float)packet_count) / duration<float>(total_time).count();
2414         const auto average_per_packet = total_time / packet_count;
2415 
2416         if (json) {
2417           strm.Format("{0}\n     {{\"send_size\" : {1,6}, \"recv_size\" : "
2418                       "{2,6}, \"total_time_nsec\" : {3,12:ns-}}",
2419                       result_idx > 0 ? "," : "", send_size, recv_size,
2420                       total_time);
2421           ++result_idx;
2422         } else {
2423           strm.Format("qSpeedTest(send={0,7}, recv={1,7}) {2,6} packets needed "
2424                       "to receive {3:f1}MB in {4:s+f9} for {5} MB/sec for "
2425                       "{6,9:f2} packets/sec ({7,10:ms+f6} per packet)\n",
2426                       send_size, recv_size, packet_count, k_recv_amount_mb,
2427                       duration<float>(total_time), mb_second,
2428                       packets_per_second, duration<float>(average_per_packet));
2429         }
2430         strm.Flush();
2431       }
2432     }
2433     if (json)
2434       strm.Printf("\n    ]\n  }\n}\n");
2435     else
2436       strm.EOL();
2437   }
2438 }
2439 
2440 bool GDBRemoteCommunicationClient::SendSpeedTestPacket(uint32_t send_size,
2441                                                        uint32_t recv_size) {
2442   StreamString packet;
2443   packet.Printf("qSpeedTest:response_size:%i;data:", recv_size);
2444   uint32_t bytes_left = send_size;
2445   while (bytes_left > 0) {
2446     if (bytes_left >= 26) {
2447       packet.PutCString("abcdefghijklmnopqrstuvwxyz");
2448       bytes_left -= 26;
2449     } else {
2450       packet.Printf("%*.*s;", bytes_left, bytes_left,
2451                     "abcdefghijklmnopqrstuvwxyz");
2452       bytes_left = 0;
2453     }
2454   }
2455 
2456   StringExtractorGDBRemote response;
2457   return SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
2458          PacketResult::Success;
2459 }
2460 
2461 bool GDBRemoteCommunicationClient::LaunchGDBServer(
2462     const char *remote_accept_hostname, lldb::pid_t &pid, uint16_t &port,
2463     std::string &socket_name) {
2464   pid = LLDB_INVALID_PROCESS_ID;
2465   port = 0;
2466   socket_name.clear();
2467 
2468   StringExtractorGDBRemote response;
2469   StreamString stream;
2470   stream.PutCString("qLaunchGDBServer;");
2471   std::string hostname;
2472   if (remote_accept_hostname && remote_accept_hostname[0])
2473     hostname = remote_accept_hostname;
2474   else {
2475     if (HostInfo::GetHostname(hostname)) {
2476       // Make the GDB server we launch only accept connections from this host
2477       stream.Printf("host:%s;", hostname.c_str());
2478     } else {
2479       // Make the GDB server we launch accept connections from any host since
2480       // we can't figure out the hostname
2481       stream.Printf("host:*;");
2482     }
2483   }
2484   // give the process a few seconds to startup
2485   ScopedTimeout timeout(*this, seconds(10));
2486 
2487   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2488       PacketResult::Success) {
2489     llvm::StringRef name;
2490     llvm::StringRef value;
2491     while (response.GetNameColonValue(name, value)) {
2492       if (name.equals("port"))
2493         value.getAsInteger(0, port);
2494       else if (name.equals("pid"))
2495         value.getAsInteger(0, pid);
2496       else if (name.compare("socket_name") == 0) {
2497         StringExtractor extractor(value);
2498         extractor.GetHexByteString(socket_name);
2499       }
2500     }
2501     return true;
2502   }
2503   return false;
2504 }
2505 
2506 size_t GDBRemoteCommunicationClient::QueryGDBServer(
2507     std::vector<std::pair<uint16_t, std::string>> &connection_urls) {
2508   connection_urls.clear();
2509 
2510   StringExtractorGDBRemote response;
2511   if (SendPacketAndWaitForResponse("qQueryGDBServer", response, false) !=
2512       PacketResult::Success)
2513     return 0;
2514 
2515   StructuredData::ObjectSP data =
2516       StructuredData::ParseJSON(response.GetStringRef());
2517   if (!data)
2518     return 0;
2519 
2520   StructuredData::Array *array = data->GetAsArray();
2521   if (!array)
2522     return 0;
2523 
2524   for (size_t i = 0, count = array->GetSize(); i < count; ++i) {
2525     StructuredData::Dictionary *element = nullptr;
2526     if (!array->GetItemAtIndexAsDictionary(i, element))
2527       continue;
2528 
2529     uint16_t port = 0;
2530     if (StructuredData::ObjectSP port_osp =
2531             element->GetValueForKey(llvm::StringRef("port")))
2532       port = port_osp->GetIntegerValue(0);
2533 
2534     std::string socket_name;
2535     if (StructuredData::ObjectSP socket_name_osp =
2536             element->GetValueForKey(llvm::StringRef("socket_name")))
2537       socket_name = socket_name_osp->GetStringValue();
2538 
2539     if (port != 0 || !socket_name.empty())
2540       connection_urls.emplace_back(port, socket_name);
2541   }
2542   return connection_urls.size();
2543 }
2544 
2545 bool GDBRemoteCommunicationClient::KillSpawnedProcess(lldb::pid_t pid) {
2546   StreamString stream;
2547   stream.Printf("qKillSpawnedProcess:%" PRId64, pid);
2548 
2549   StringExtractorGDBRemote response;
2550   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2551       PacketResult::Success) {
2552     if (response.IsOKResponse())
2553       return true;
2554   }
2555   return false;
2556 }
2557 
2558 bool GDBRemoteCommunicationClient::SetCurrentThread(uint64_t tid) {
2559   if (m_curr_tid == tid)
2560     return true;
2561 
2562   char packet[32];
2563   int packet_len;
2564   if (tid == UINT64_MAX)
2565     packet_len = ::snprintf(packet, sizeof(packet), "Hg-1");
2566   else
2567     packet_len = ::snprintf(packet, sizeof(packet), "Hg%" PRIx64, tid);
2568   assert(packet_len + 1 < (int)sizeof(packet));
2569   UNUSED_IF_ASSERT_DISABLED(packet_len);
2570   StringExtractorGDBRemote response;
2571   if (SendPacketAndWaitForResponse(packet, response, false) ==
2572       PacketResult::Success) {
2573     if (response.IsOKResponse()) {
2574       m_curr_tid = tid;
2575       return true;
2576     }
2577 
2578     /*
2579      * Connected bare-iron target (like YAMON gdb-stub) may not have support for
2580      * Hg packet.
2581      * The reply from '?' packet could be as simple as 'S05'. There is no packet
2582      * which can
2583      * give us pid and/or tid. Assume pid=tid=1 in such cases.
2584     */
2585     if (response.IsUnsupportedResponse() && IsConnected()) {
2586       m_curr_tid = 1;
2587       return true;
2588     }
2589   }
2590   return false;
2591 }
2592 
2593 bool GDBRemoteCommunicationClient::SetCurrentThreadForRun(uint64_t tid) {
2594   if (m_curr_tid_run == tid)
2595     return true;
2596 
2597   char packet[32];
2598   int packet_len;
2599   if (tid == UINT64_MAX)
2600     packet_len = ::snprintf(packet, sizeof(packet), "Hc-1");
2601   else
2602     packet_len = ::snprintf(packet, sizeof(packet), "Hc%" PRIx64, tid);
2603 
2604   assert(packet_len + 1 < (int)sizeof(packet));
2605   UNUSED_IF_ASSERT_DISABLED(packet_len);
2606   StringExtractorGDBRemote response;
2607   if (SendPacketAndWaitForResponse(packet, response, false) ==
2608       PacketResult::Success) {
2609     if (response.IsOKResponse()) {
2610       m_curr_tid_run = tid;
2611       return true;
2612     }
2613 
2614     /*
2615      * Connected bare-iron target (like YAMON gdb-stub) may not have support for
2616      * Hc packet.
2617      * The reply from '?' packet could be as simple as 'S05'. There is no packet
2618      * which can
2619      * give us pid and/or tid. Assume pid=tid=1 in such cases.
2620     */
2621     if (response.IsUnsupportedResponse() && IsConnected()) {
2622       m_curr_tid_run = 1;
2623       return true;
2624     }
2625   }
2626   return false;
2627 }
2628 
2629 bool GDBRemoteCommunicationClient::GetStopReply(
2630     StringExtractorGDBRemote &response) {
2631   if (SendPacketAndWaitForResponse("?", response, false) ==
2632       PacketResult::Success)
2633     return response.IsNormalResponse();
2634   return false;
2635 }
2636 
2637 bool GDBRemoteCommunicationClient::GetThreadStopInfo(
2638     lldb::tid_t tid, StringExtractorGDBRemote &response) {
2639   if (m_supports_qThreadStopInfo) {
2640     char packet[256];
2641     int packet_len =
2642         ::snprintf(packet, sizeof(packet), "qThreadStopInfo%" PRIx64, tid);
2643     assert(packet_len < (int)sizeof(packet));
2644     UNUSED_IF_ASSERT_DISABLED(packet_len);
2645     if (SendPacketAndWaitForResponse(packet, response, false) ==
2646         PacketResult::Success) {
2647       if (response.IsUnsupportedResponse())
2648         m_supports_qThreadStopInfo = false;
2649       else if (response.IsNormalResponse())
2650         return true;
2651       else
2652         return false;
2653     } else {
2654       m_supports_qThreadStopInfo = false;
2655     }
2656   }
2657   return false;
2658 }
2659 
2660 uint8_t GDBRemoteCommunicationClient::SendGDBStoppointTypePacket(
2661     GDBStoppointType type, bool insert, addr_t addr, uint32_t length) {
2662   Log *log(GetLogIfAnyCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
2663   LLDB_LOGF(log, "GDBRemoteCommunicationClient::%s() %s at addr = 0x%" PRIx64,
2664             __FUNCTION__, insert ? "add" : "remove", addr);
2665 
2666   // Check if the stub is known not to support this breakpoint type
2667   if (!SupportsGDBStoppointPacket(type))
2668     return UINT8_MAX;
2669   // Construct the breakpoint packet
2670   char packet[64];
2671   const int packet_len =
2672       ::snprintf(packet, sizeof(packet), "%c%i,%" PRIx64 ",%x",
2673                  insert ? 'Z' : 'z', type, addr, length);
2674   // Check we haven't overwritten the end of the packet buffer
2675   assert(packet_len + 1 < (int)sizeof(packet));
2676   UNUSED_IF_ASSERT_DISABLED(packet_len);
2677   StringExtractorGDBRemote response;
2678   // Make sure the response is either "OK", "EXX" where XX are two hex digits,
2679   // or "" (unsupported)
2680   response.SetResponseValidatorToOKErrorNotSupported();
2681   // Try to send the breakpoint packet, and check that it was correctly sent
2682   if (SendPacketAndWaitForResponse(packet, response, true) ==
2683       PacketResult::Success) {
2684     // Receive and OK packet when the breakpoint successfully placed
2685     if (response.IsOKResponse())
2686       return 0;
2687 
2688     // Status while setting breakpoint, send back specific error
2689     if (response.IsErrorResponse())
2690       return response.GetError();
2691 
2692     // Empty packet informs us that breakpoint is not supported
2693     if (response.IsUnsupportedResponse()) {
2694       // Disable this breakpoint type since it is unsupported
2695       switch (type) {
2696       case eBreakpointSoftware:
2697         m_supports_z0 = false;
2698         break;
2699       case eBreakpointHardware:
2700         m_supports_z1 = false;
2701         break;
2702       case eWatchpointWrite:
2703         m_supports_z2 = false;
2704         break;
2705       case eWatchpointRead:
2706         m_supports_z3 = false;
2707         break;
2708       case eWatchpointReadWrite:
2709         m_supports_z4 = false;
2710         break;
2711       case eStoppointInvalid:
2712         return UINT8_MAX;
2713       }
2714     }
2715   }
2716   // Signal generic failure
2717   return UINT8_MAX;
2718 }
2719 
2720 size_t GDBRemoteCommunicationClient::GetCurrentThreadIDs(
2721     std::vector<lldb::tid_t> &thread_ids, bool &sequence_mutex_unavailable) {
2722   thread_ids.clear();
2723 
2724   Lock lock(*this, false);
2725   if (lock) {
2726     sequence_mutex_unavailable = false;
2727     StringExtractorGDBRemote response;
2728 
2729     PacketResult packet_result;
2730     for (packet_result =
2731              SendPacketAndWaitForResponseNoLock("qfThreadInfo", response);
2732          packet_result == PacketResult::Success && response.IsNormalResponse();
2733          packet_result =
2734              SendPacketAndWaitForResponseNoLock("qsThreadInfo", response)) {
2735       char ch = response.GetChar();
2736       if (ch == 'l')
2737         break;
2738       if (ch == 'm') {
2739         do {
2740           tid_t tid = response.GetHexMaxU64(false, LLDB_INVALID_THREAD_ID);
2741 
2742           if (tid != LLDB_INVALID_THREAD_ID) {
2743             thread_ids.push_back(tid);
2744           }
2745           ch = response.GetChar(); // Skip the command separator
2746         } while (ch == ',');       // Make sure we got a comma separator
2747       }
2748     }
2749 
2750     /*
2751      * Connected bare-iron target (like YAMON gdb-stub) may not have support for
2752      * qProcessInfo, qC and qfThreadInfo packets. The reply from '?' packet
2753      * could
2754      * be as simple as 'S05'. There is no packet which can give us pid and/or
2755      * tid.
2756      * Assume pid=tid=1 in such cases.
2757     */
2758     if ((response.IsUnsupportedResponse() || response.IsNormalResponse()) &&
2759         thread_ids.size() == 0 && IsConnected()) {
2760       thread_ids.push_back(1);
2761     }
2762   } else {
2763 #if !defined(LLDB_CONFIGURATION_DEBUG)
2764     Log *log(ProcessGDBRemoteLog::GetLogIfAnyCategoryIsSet(GDBR_LOG_PROCESS |
2765                                                            GDBR_LOG_PACKETS));
2766     LLDB_LOGF(log, "error: failed to get packet sequence mutex, not sending "
2767                    "packet 'qfThreadInfo'");
2768 #endif
2769     sequence_mutex_unavailable = true;
2770   }
2771   return thread_ids.size();
2772 }
2773 
2774 lldb::addr_t GDBRemoteCommunicationClient::GetShlibInfoAddr() {
2775   StringExtractorGDBRemote response;
2776   if (SendPacketAndWaitForResponse("qShlibInfoAddr", response, false) !=
2777           PacketResult::Success ||
2778       !response.IsNormalResponse())
2779     return LLDB_INVALID_ADDRESS;
2780   return response.GetHexMaxU64(false, LLDB_INVALID_ADDRESS);
2781 }
2782 
2783 lldb_private::Status GDBRemoteCommunicationClient::RunShellCommand(
2784     const char *command, // Shouldn't be NULL
2785     const FileSpec &
2786         working_dir, // Pass empty FileSpec to use the current working directory
2787     int *status_ptr, // Pass NULL if you don't want the process exit status
2788     int *signo_ptr,  // Pass NULL if you don't want the signal that caused the
2789                      // process to exit
2790     std::string
2791         *command_output, // Pass NULL if you don't want the command output
2792     const Timeout<std::micro> &timeout) {
2793   lldb_private::StreamString stream;
2794   stream.PutCString("qPlatform_shell:");
2795   stream.PutBytesAsRawHex8(command, strlen(command));
2796   stream.PutChar(',');
2797   uint32_t timeout_sec = UINT32_MAX;
2798   if (timeout) {
2799     // TODO: Use chrono version of std::ceil once c++17 is available.
2800     timeout_sec = std::ceil(std::chrono::duration<double>(*timeout).count());
2801   }
2802   stream.PutHex32(timeout_sec);
2803   if (working_dir) {
2804     std::string path{working_dir.GetPath(false)};
2805     stream.PutChar(',');
2806     stream.PutStringAsRawHex8(path);
2807   }
2808   StringExtractorGDBRemote response;
2809   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2810       PacketResult::Success) {
2811     if (response.GetChar() != 'F')
2812       return Status("malformed reply");
2813     if (response.GetChar() != ',')
2814       return Status("malformed reply");
2815     uint32_t exitcode = response.GetHexMaxU32(false, UINT32_MAX);
2816     if (exitcode == UINT32_MAX)
2817       return Status("unable to run remote process");
2818     else if (status_ptr)
2819       *status_ptr = exitcode;
2820     if (response.GetChar() != ',')
2821       return Status("malformed reply");
2822     uint32_t signo = response.GetHexMaxU32(false, UINT32_MAX);
2823     if (signo_ptr)
2824       *signo_ptr = signo;
2825     if (response.GetChar() != ',')
2826       return Status("malformed reply");
2827     std::string output;
2828     response.GetEscapedBinaryData(output);
2829     if (command_output)
2830       command_output->assign(output);
2831     return Status();
2832   }
2833   return Status("unable to send packet");
2834 }
2835 
2836 Status GDBRemoteCommunicationClient::MakeDirectory(const FileSpec &file_spec,
2837                                                    uint32_t file_permissions) {
2838   std::string path{file_spec.GetPath(false)};
2839   lldb_private::StreamString stream;
2840   stream.PutCString("qPlatform_mkdir:");
2841   stream.PutHex32(file_permissions);
2842   stream.PutChar(',');
2843   stream.PutStringAsRawHex8(path);
2844   llvm::StringRef packet = stream.GetString();
2845   StringExtractorGDBRemote response;
2846 
2847   if (SendPacketAndWaitForResponse(packet, response, false) !=
2848       PacketResult::Success)
2849     return Status("failed to send '%s' packet", packet.str().c_str());
2850 
2851   if (response.GetChar() != 'F')
2852     return Status("invalid response to '%s' packet", packet.str().c_str());
2853 
2854   return Status(response.GetU32(UINT32_MAX), eErrorTypePOSIX);
2855 }
2856 
2857 Status
2858 GDBRemoteCommunicationClient::SetFilePermissions(const FileSpec &file_spec,
2859                                                  uint32_t file_permissions) {
2860   std::string path{file_spec.GetPath(false)};
2861   lldb_private::StreamString stream;
2862   stream.PutCString("qPlatform_chmod:");
2863   stream.PutHex32(file_permissions);
2864   stream.PutChar(',');
2865   stream.PutStringAsRawHex8(path);
2866   llvm::StringRef packet = stream.GetString();
2867   StringExtractorGDBRemote response;
2868 
2869   if (SendPacketAndWaitForResponse(packet, response, false) !=
2870       PacketResult::Success)
2871     return Status("failed to send '%s' packet", stream.GetData());
2872 
2873   if (response.GetChar() != 'F')
2874     return Status("invalid response to '%s' packet", stream.GetData());
2875 
2876   return Status(response.GetU32(UINT32_MAX), eErrorTypePOSIX);
2877 }
2878 
2879 static uint64_t ParseHostIOPacketResponse(StringExtractorGDBRemote &response,
2880                                           uint64_t fail_result, Status &error) {
2881   response.SetFilePos(0);
2882   if (response.GetChar() != 'F')
2883     return fail_result;
2884   int32_t result = response.GetS32(-2);
2885   if (result == -2)
2886     return fail_result;
2887   if (response.GetChar() == ',') {
2888     int result_errno = response.GetS32(-2);
2889     if (result_errno != -2)
2890       error.SetError(result_errno, eErrorTypePOSIX);
2891     else
2892       error.SetError(-1, eErrorTypeGeneric);
2893   } else
2894     error.Clear();
2895   return result;
2896 }
2897 lldb::user_id_t
2898 GDBRemoteCommunicationClient::OpenFile(const lldb_private::FileSpec &file_spec,
2899                                        uint32_t flags, mode_t mode,
2900                                        Status &error) {
2901   std::string path(file_spec.GetPath(false));
2902   lldb_private::StreamString stream;
2903   stream.PutCString("vFile:open:");
2904   if (path.empty())
2905     return UINT64_MAX;
2906   stream.PutStringAsRawHex8(path);
2907   stream.PutChar(',');
2908   stream.PutHex32(flags);
2909   stream.PutChar(',');
2910   stream.PutHex32(mode);
2911   StringExtractorGDBRemote response;
2912   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2913       PacketResult::Success) {
2914     return ParseHostIOPacketResponse(response, UINT64_MAX, error);
2915   }
2916   return UINT64_MAX;
2917 }
2918 
2919 bool GDBRemoteCommunicationClient::CloseFile(lldb::user_id_t fd,
2920                                              Status &error) {
2921   lldb_private::StreamString stream;
2922   stream.Printf("vFile:close:%i", (int)fd);
2923   StringExtractorGDBRemote response;
2924   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2925       PacketResult::Success) {
2926     return ParseHostIOPacketResponse(response, -1, error) == 0;
2927   }
2928   return false;
2929 }
2930 
2931 // Extension of host I/O packets to get the file size.
2932 lldb::user_id_t GDBRemoteCommunicationClient::GetFileSize(
2933     const lldb_private::FileSpec &file_spec) {
2934   std::string path(file_spec.GetPath(false));
2935   lldb_private::StreamString stream;
2936   stream.PutCString("vFile:size:");
2937   stream.PutStringAsRawHex8(path);
2938   StringExtractorGDBRemote response;
2939   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2940       PacketResult::Success) {
2941     if (response.GetChar() != 'F')
2942       return UINT64_MAX;
2943     uint32_t retcode = response.GetHexMaxU64(false, UINT64_MAX);
2944     return retcode;
2945   }
2946   return UINT64_MAX;
2947 }
2948 
2949 Status
2950 GDBRemoteCommunicationClient::GetFilePermissions(const FileSpec &file_spec,
2951                                                  uint32_t &file_permissions) {
2952   std::string path{file_spec.GetPath(false)};
2953   Status error;
2954   lldb_private::StreamString stream;
2955   stream.PutCString("vFile:mode:");
2956   stream.PutStringAsRawHex8(path);
2957   StringExtractorGDBRemote response;
2958   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2959       PacketResult::Success) {
2960     if (response.GetChar() != 'F') {
2961       error.SetErrorStringWithFormat("invalid response to '%s' packet",
2962                                      stream.GetData());
2963     } else {
2964       const uint32_t mode = response.GetS32(-1);
2965       if (static_cast<int32_t>(mode) == -1) {
2966         if (response.GetChar() == ',') {
2967           int response_errno = response.GetS32(-1);
2968           if (response_errno > 0)
2969             error.SetError(response_errno, lldb::eErrorTypePOSIX);
2970           else
2971             error.SetErrorToGenericError();
2972         } else
2973           error.SetErrorToGenericError();
2974       } else {
2975         file_permissions = mode & (S_IRWXU | S_IRWXG | S_IRWXO);
2976       }
2977     }
2978   } else {
2979     error.SetErrorStringWithFormat("failed to send '%s' packet",
2980                                    stream.GetData());
2981   }
2982   return error;
2983 }
2984 
2985 uint64_t GDBRemoteCommunicationClient::ReadFile(lldb::user_id_t fd,
2986                                                 uint64_t offset, void *dst,
2987                                                 uint64_t dst_len,
2988                                                 Status &error) {
2989   lldb_private::StreamString stream;
2990   stream.Printf("vFile:pread:%i,%" PRId64 ",%" PRId64, (int)fd, dst_len,
2991                 offset);
2992   StringExtractorGDBRemote response;
2993   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
2994       PacketResult::Success) {
2995     if (response.GetChar() != 'F')
2996       return 0;
2997     uint32_t retcode = response.GetHexMaxU32(false, UINT32_MAX);
2998     if (retcode == UINT32_MAX)
2999       return retcode;
3000     const char next = (response.Peek() ? *response.Peek() : 0);
3001     if (next == ',')
3002       return 0;
3003     if (next == ';') {
3004       response.GetChar(); // skip the semicolon
3005       std::string buffer;
3006       if (response.GetEscapedBinaryData(buffer)) {
3007         const uint64_t data_to_write =
3008             std::min<uint64_t>(dst_len, buffer.size());
3009         if (data_to_write > 0)
3010           memcpy(dst, &buffer[0], data_to_write);
3011         return data_to_write;
3012       }
3013     }
3014   }
3015   return 0;
3016 }
3017 
3018 uint64_t GDBRemoteCommunicationClient::WriteFile(lldb::user_id_t fd,
3019                                                  uint64_t offset,
3020                                                  const void *src,
3021                                                  uint64_t src_len,
3022                                                  Status &error) {
3023   lldb_private::StreamGDBRemote stream;
3024   stream.Printf("vFile:pwrite:%i,%" PRId64 ",", (int)fd, offset);
3025   stream.PutEscapedBytes(src, src_len);
3026   StringExtractorGDBRemote response;
3027   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
3028       PacketResult::Success) {
3029     if (response.GetChar() != 'F') {
3030       error.SetErrorStringWithFormat("write file failed");
3031       return 0;
3032     }
3033     uint64_t bytes_written = response.GetU64(UINT64_MAX);
3034     if (bytes_written == UINT64_MAX) {
3035       error.SetErrorToGenericError();
3036       if (response.GetChar() == ',') {
3037         int response_errno = response.GetS32(-1);
3038         if (response_errno > 0)
3039           error.SetError(response_errno, lldb::eErrorTypePOSIX);
3040       }
3041       return 0;
3042     }
3043     return bytes_written;
3044   } else {
3045     error.SetErrorString("failed to send vFile:pwrite packet");
3046   }
3047   return 0;
3048 }
3049 
3050 Status GDBRemoteCommunicationClient::CreateSymlink(const FileSpec &src,
3051                                                    const FileSpec &dst) {
3052   std::string src_path{src.GetPath(false)}, dst_path{dst.GetPath(false)};
3053   Status error;
3054   lldb_private::StreamGDBRemote stream;
3055   stream.PutCString("vFile:symlink:");
3056   // the unix symlink() command reverses its parameters where the dst if first,
3057   // so we follow suit here
3058   stream.PutStringAsRawHex8(dst_path);
3059   stream.PutChar(',');
3060   stream.PutStringAsRawHex8(src_path);
3061   StringExtractorGDBRemote response;
3062   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
3063       PacketResult::Success) {
3064     if (response.GetChar() == 'F') {
3065       uint32_t result = response.GetU32(UINT32_MAX);
3066       if (result != 0) {
3067         error.SetErrorToGenericError();
3068         if (response.GetChar() == ',') {
3069           int response_errno = response.GetS32(-1);
3070           if (response_errno > 0)
3071             error.SetError(response_errno, lldb::eErrorTypePOSIX);
3072         }
3073       }
3074     } else {
3075       // Should have returned with 'F<result>[,<errno>]'
3076       error.SetErrorStringWithFormat("symlink failed");
3077     }
3078   } else {
3079     error.SetErrorString("failed to send vFile:symlink packet");
3080   }
3081   return error;
3082 }
3083 
3084 Status GDBRemoteCommunicationClient::Unlink(const FileSpec &file_spec) {
3085   std::string path{file_spec.GetPath(false)};
3086   Status error;
3087   lldb_private::StreamGDBRemote stream;
3088   stream.PutCString("vFile:unlink:");
3089   // the unix symlink() command reverses its parameters where the dst if first,
3090   // so we follow suit here
3091   stream.PutStringAsRawHex8(path);
3092   StringExtractorGDBRemote response;
3093   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
3094       PacketResult::Success) {
3095     if (response.GetChar() == 'F') {
3096       uint32_t result = response.GetU32(UINT32_MAX);
3097       if (result != 0) {
3098         error.SetErrorToGenericError();
3099         if (response.GetChar() == ',') {
3100           int response_errno = response.GetS32(-1);
3101           if (response_errno > 0)
3102             error.SetError(response_errno, lldb::eErrorTypePOSIX);
3103         }
3104       }
3105     } else {
3106       // Should have returned with 'F<result>[,<errno>]'
3107       error.SetErrorStringWithFormat("unlink failed");
3108     }
3109   } else {
3110     error.SetErrorString("failed to send vFile:unlink packet");
3111   }
3112   return error;
3113 }
3114 
3115 // Extension of host I/O packets to get whether a file exists.
3116 bool GDBRemoteCommunicationClient::GetFileExists(
3117     const lldb_private::FileSpec &file_spec) {
3118   std::string path(file_spec.GetPath(false));
3119   lldb_private::StreamString stream;
3120   stream.PutCString("vFile:exists:");
3121   stream.PutStringAsRawHex8(path);
3122   StringExtractorGDBRemote response;
3123   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
3124       PacketResult::Success) {
3125     if (response.GetChar() != 'F')
3126       return false;
3127     if (response.GetChar() != ',')
3128       return false;
3129     bool retcode = (response.GetChar() != '0');
3130     return retcode;
3131   }
3132   return false;
3133 }
3134 
3135 bool GDBRemoteCommunicationClient::CalculateMD5(
3136     const lldb_private::FileSpec &file_spec, uint64_t &high, uint64_t &low) {
3137   std::string path(file_spec.GetPath(false));
3138   lldb_private::StreamString stream;
3139   stream.PutCString("vFile:MD5:");
3140   stream.PutStringAsRawHex8(path);
3141   StringExtractorGDBRemote response;
3142   if (SendPacketAndWaitForResponse(stream.GetString(), response, false) ==
3143       PacketResult::Success) {
3144     if (response.GetChar() != 'F')
3145       return false;
3146     if (response.GetChar() != ',')
3147       return false;
3148     if (response.Peek() && *response.Peek() == 'x')
3149       return false;
3150     low = response.GetHexMaxU64(false, UINT64_MAX);
3151     high = response.GetHexMaxU64(false, UINT64_MAX);
3152     return true;
3153   }
3154   return false;
3155 }
3156 
3157 bool GDBRemoteCommunicationClient::AvoidGPackets(ProcessGDBRemote *process) {
3158   // Some targets have issues with g/G packets and we need to avoid using them
3159   if (m_avoid_g_packets == eLazyBoolCalculate) {
3160     if (process) {
3161       m_avoid_g_packets = eLazyBoolNo;
3162       const ArchSpec &arch = process->GetTarget().GetArchitecture();
3163       if (arch.IsValid() &&
3164           arch.GetTriple().getVendor() == llvm::Triple::Apple &&
3165           arch.GetTriple().getOS() == llvm::Triple::IOS &&
3166           arch.GetTriple().getArch() == llvm::Triple::aarch64) {
3167         m_avoid_g_packets = eLazyBoolYes;
3168         uint32_t gdb_server_version = GetGDBServerProgramVersion();
3169         if (gdb_server_version != 0) {
3170           const char *gdb_server_name = GetGDBServerProgramName();
3171           if (gdb_server_name && strcmp(gdb_server_name, "debugserver") == 0) {
3172             if (gdb_server_version >= 310)
3173               m_avoid_g_packets = eLazyBoolNo;
3174           }
3175         }
3176       }
3177     }
3178   }
3179   return m_avoid_g_packets == eLazyBoolYes;
3180 }
3181 
3182 DataBufferSP GDBRemoteCommunicationClient::ReadRegister(lldb::tid_t tid,
3183                                                         uint32_t reg) {
3184   StreamString payload;
3185   payload.Printf("p%x", reg);
3186   StringExtractorGDBRemote response;
3187   if (SendThreadSpecificPacketAndWaitForResponse(
3188           tid, std::move(payload), response, false) != PacketResult::Success ||
3189       !response.IsNormalResponse())
3190     return nullptr;
3191 
3192   DataBufferSP buffer_sp(
3193       new DataBufferHeap(response.GetStringRef().size() / 2, 0));
3194   response.GetHexBytes(buffer_sp->GetData(), '\xcc');
3195   return buffer_sp;
3196 }
3197 
3198 DataBufferSP GDBRemoteCommunicationClient::ReadAllRegisters(lldb::tid_t tid) {
3199   StreamString payload;
3200   payload.PutChar('g');
3201   StringExtractorGDBRemote response;
3202   if (SendThreadSpecificPacketAndWaitForResponse(
3203           tid, std::move(payload), response, false) != PacketResult::Success ||
3204       !response.IsNormalResponse())
3205     return nullptr;
3206 
3207   DataBufferSP buffer_sp(
3208       new DataBufferHeap(response.GetStringRef().size() / 2, 0));
3209   response.GetHexBytes(buffer_sp->GetData(), '\xcc');
3210   return buffer_sp;
3211 }
3212 
3213 bool GDBRemoteCommunicationClient::WriteRegister(lldb::tid_t tid,
3214                                                  uint32_t reg_num,
3215                                                  llvm::ArrayRef<uint8_t> data) {
3216   StreamString payload;
3217   payload.Printf("P%x=", reg_num);
3218   payload.PutBytesAsRawHex8(data.data(), data.size(),
3219                             endian::InlHostByteOrder(),
3220                             endian::InlHostByteOrder());
3221   StringExtractorGDBRemote response;
3222   return SendThreadSpecificPacketAndWaitForResponse(tid, std::move(payload),
3223                                                     response, false) ==
3224              PacketResult::Success &&
3225          response.IsOKResponse();
3226 }
3227 
3228 bool GDBRemoteCommunicationClient::WriteAllRegisters(
3229     lldb::tid_t tid, llvm::ArrayRef<uint8_t> data) {
3230   StreamString payload;
3231   payload.PutChar('G');
3232   payload.PutBytesAsRawHex8(data.data(), data.size(),
3233                             endian::InlHostByteOrder(),
3234                             endian::InlHostByteOrder());
3235   StringExtractorGDBRemote response;
3236   return SendThreadSpecificPacketAndWaitForResponse(tid, std::move(payload),
3237                                                     response, false) ==
3238              PacketResult::Success &&
3239          response.IsOKResponse();
3240 }
3241 
3242 bool GDBRemoteCommunicationClient::SaveRegisterState(lldb::tid_t tid,
3243                                                      uint32_t &save_id) {
3244   save_id = 0; // Set to invalid save ID
3245   if (m_supports_QSaveRegisterState == eLazyBoolNo)
3246     return false;
3247 
3248   m_supports_QSaveRegisterState = eLazyBoolYes;
3249   StreamString payload;
3250   payload.PutCString("QSaveRegisterState");
3251   StringExtractorGDBRemote response;
3252   if (SendThreadSpecificPacketAndWaitForResponse(
3253           tid, std::move(payload), response, false) != PacketResult::Success)
3254     return false;
3255 
3256   if (response.IsUnsupportedResponse())
3257     m_supports_QSaveRegisterState = eLazyBoolNo;
3258 
3259   const uint32_t response_save_id = response.GetU32(0);
3260   if (response_save_id == 0)
3261     return false;
3262 
3263   save_id = response_save_id;
3264   return true;
3265 }
3266 
3267 bool GDBRemoteCommunicationClient::RestoreRegisterState(lldb::tid_t tid,
3268                                                         uint32_t save_id) {
3269   // We use the "m_supports_QSaveRegisterState" variable here because the
3270   // QSaveRegisterState and QRestoreRegisterState packets must both be
3271   // supported in order to be useful
3272   if (m_supports_QSaveRegisterState == eLazyBoolNo)
3273     return false;
3274 
3275   StreamString payload;
3276   payload.Printf("QRestoreRegisterState:%u", save_id);
3277   StringExtractorGDBRemote response;
3278   if (SendThreadSpecificPacketAndWaitForResponse(
3279           tid, std::move(payload), response, false) != PacketResult::Success)
3280     return false;
3281 
3282   if (response.IsOKResponse())
3283     return true;
3284 
3285   if (response.IsUnsupportedResponse())
3286     m_supports_QSaveRegisterState = eLazyBoolNo;
3287   return false;
3288 }
3289 
3290 bool GDBRemoteCommunicationClient::SyncThreadState(lldb::tid_t tid) {
3291   if (!GetSyncThreadStateSupported())
3292     return false;
3293 
3294   StreamString packet;
3295   StringExtractorGDBRemote response;
3296   packet.Printf("QSyncThreadState:%4.4" PRIx64 ";", tid);
3297   return SendPacketAndWaitForResponse(packet.GetString(), response, false) ==
3298              GDBRemoteCommunication::PacketResult::Success &&
3299          response.IsOKResponse();
3300 }
3301 
3302 lldb::user_id_t
3303 GDBRemoteCommunicationClient::SendStartTracePacket(const TraceOptions &options,
3304                                                    Status &error) {
3305   Log *log(ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(GDBR_LOG_PROCESS));
3306   lldb::user_id_t ret_uid = LLDB_INVALID_UID;
3307 
3308   StreamGDBRemote escaped_packet;
3309   escaped_packet.PutCString("jTraceStart:");
3310 
3311   StructuredData::Dictionary json_packet;
3312   json_packet.AddIntegerItem("type", options.getType());
3313   json_packet.AddIntegerItem("buffersize", options.getTraceBufferSize());
3314   json_packet.AddIntegerItem("metabuffersize", options.getMetaDataBufferSize());
3315 
3316   if (options.getThreadID() != LLDB_INVALID_THREAD_ID)
3317     json_packet.AddIntegerItem("threadid", options.getThreadID());
3318 
3319   StructuredData::DictionarySP custom_params = options.getTraceParams();
3320   if (custom_params)
3321     json_packet.AddItem("params", custom_params);
3322 
3323   StreamString json_string;
3324   json_packet.Dump(json_string, false);
3325   escaped_packet.PutEscapedBytes(json_string.GetData(), json_string.GetSize());
3326 
3327   StringExtractorGDBRemote response;
3328   if (SendPacketAndWaitForResponse(escaped_packet.GetString(), response,
3329                                    true) ==
3330       GDBRemoteCommunication::PacketResult::Success) {
3331     if (!response.IsNormalResponse()) {
3332       error = response.GetStatus();
3333       LLDB_LOG(log, "Target does not support Tracing , error {0}", error);
3334     } else {
3335       ret_uid = response.GetHexMaxU64(false, LLDB_INVALID_UID);
3336     }
3337   } else {
3338     LLDB_LOG(log, "failed to send packet");
3339     error.SetErrorStringWithFormat("failed to send packet: '%s'",
3340                                    escaped_packet.GetData());
3341   }
3342   return ret_uid;
3343 }
3344 
3345 Status
3346 GDBRemoteCommunicationClient::SendStopTracePacket(lldb::user_id_t uid,
3347                                                   lldb::tid_t thread_id) {
3348   Log *log(ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(GDBR_LOG_PROCESS));
3349   StringExtractorGDBRemote response;
3350   Status error;
3351 
3352   StructuredData::Dictionary json_packet;
3353   StreamGDBRemote escaped_packet;
3354   StreamString json_string;
3355   escaped_packet.PutCString("jTraceStop:");
3356 
3357   json_packet.AddIntegerItem("traceid", uid);
3358 
3359   if (thread_id != LLDB_INVALID_THREAD_ID)
3360     json_packet.AddIntegerItem("threadid", thread_id);
3361 
3362   json_packet.Dump(json_string, false);
3363 
3364   escaped_packet.PutEscapedBytes(json_string.GetData(), json_string.GetSize());
3365 
3366   if (SendPacketAndWaitForResponse(escaped_packet.GetString(), response,
3367                                    true) ==
3368       GDBRemoteCommunication::PacketResult::Success) {
3369     if (!response.IsOKResponse()) {
3370       error = response.GetStatus();
3371       LLDB_LOG(log, "stop tracing failed");
3372     }
3373   } else {
3374     LLDB_LOG(log, "failed to send packet");
3375     error.SetErrorStringWithFormat(
3376         "failed to send packet: '%s' with error '%d'", escaped_packet.GetData(),
3377         response.GetError());
3378   }
3379   return error;
3380 }
3381 
3382 Status GDBRemoteCommunicationClient::SendGetDataPacket(
3383     lldb::user_id_t uid, lldb::tid_t thread_id,
3384     llvm::MutableArrayRef<uint8_t> &buffer, size_t offset) {
3385 
3386   StreamGDBRemote escaped_packet;
3387   escaped_packet.PutCString("jTraceBufferRead:");
3388   return SendGetTraceDataPacket(escaped_packet, uid, thread_id, buffer, offset);
3389 }
3390 
3391 Status GDBRemoteCommunicationClient::SendGetMetaDataPacket(
3392     lldb::user_id_t uid, lldb::tid_t thread_id,
3393     llvm::MutableArrayRef<uint8_t> &buffer, size_t offset) {
3394 
3395   StreamGDBRemote escaped_packet;
3396   escaped_packet.PutCString("jTraceMetaRead:");
3397   return SendGetTraceDataPacket(escaped_packet, uid, thread_id, buffer, offset);
3398 }
3399 
3400 Status
3401 GDBRemoteCommunicationClient::SendGetTraceConfigPacket(lldb::user_id_t uid,
3402                                                        TraceOptions &options) {
3403   Log *log(ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(GDBR_LOG_PROCESS));
3404   StringExtractorGDBRemote response;
3405   Status error;
3406 
3407   StreamString json_string;
3408   StreamGDBRemote escaped_packet;
3409   escaped_packet.PutCString("jTraceConfigRead:");
3410 
3411   StructuredData::Dictionary json_packet;
3412   json_packet.AddIntegerItem("traceid", uid);
3413 
3414   if (options.getThreadID() != LLDB_INVALID_THREAD_ID)
3415     json_packet.AddIntegerItem("threadid", options.getThreadID());
3416 
3417   json_packet.Dump(json_string, false);
3418   escaped_packet.PutEscapedBytes(json_string.GetData(), json_string.GetSize());
3419 
3420   if (SendPacketAndWaitForResponse(escaped_packet.GetString(), response,
3421                                    true) ==
3422       GDBRemoteCommunication::PacketResult::Success) {
3423     if (response.IsNormalResponse()) {
3424       uint64_t type = std::numeric_limits<uint64_t>::max();
3425       uint64_t buffersize = std::numeric_limits<uint64_t>::max();
3426       uint64_t metabuffersize = std::numeric_limits<uint64_t>::max();
3427 
3428       auto json_object = StructuredData::ParseJSON(response.Peek());
3429 
3430       if (!json_object ||
3431           json_object->GetType() != lldb::eStructuredDataTypeDictionary) {
3432         error.SetErrorString("Invalid Configuration obtained");
3433         return error;
3434       }
3435 
3436       auto json_dict = json_object->GetAsDictionary();
3437 
3438       json_dict->GetValueForKeyAsInteger<uint64_t>("metabuffersize",
3439                                                    metabuffersize);
3440       options.setMetaDataBufferSize(metabuffersize);
3441 
3442       json_dict->GetValueForKeyAsInteger<uint64_t>("buffersize", buffersize);
3443       options.setTraceBufferSize(buffersize);
3444 
3445       json_dict->GetValueForKeyAsInteger<uint64_t>("type", type);
3446       options.setType(static_cast<lldb::TraceType>(type));
3447 
3448       StructuredData::ObjectSP custom_params_sp =
3449           json_dict->GetValueForKey("params");
3450       if (custom_params_sp) {
3451         if (custom_params_sp->GetType() !=
3452             lldb::eStructuredDataTypeDictionary) {
3453           error.SetErrorString("Invalid Configuration obtained");
3454           return error;
3455         } else
3456           options.setTraceParams(
3457               static_pointer_cast<StructuredData::Dictionary>(
3458                   custom_params_sp));
3459       }
3460     } else {
3461       error = response.GetStatus();
3462     }
3463   } else {
3464     LLDB_LOG(log, "failed to send packet");
3465     error.SetErrorStringWithFormat("failed to send packet: '%s'",
3466                                    escaped_packet.GetData());
3467   }
3468   return error;
3469 }
3470 
3471 Status GDBRemoteCommunicationClient::SendGetTraceDataPacket(
3472     StreamGDBRemote &packet, lldb::user_id_t uid, lldb::tid_t thread_id,
3473     llvm::MutableArrayRef<uint8_t> &buffer, size_t offset) {
3474   Log *log(ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(GDBR_LOG_PROCESS));
3475   Status error;
3476 
3477   StructuredData::Dictionary json_packet;
3478 
3479   json_packet.AddIntegerItem("traceid", uid);
3480   json_packet.AddIntegerItem("offset", offset);
3481   json_packet.AddIntegerItem("buffersize", buffer.size());
3482 
3483   if (thread_id != LLDB_INVALID_THREAD_ID)
3484     json_packet.AddIntegerItem("threadid", thread_id);
3485 
3486   StreamString json_string;
3487   json_packet.Dump(json_string, false);
3488 
3489   packet.PutEscapedBytes(json_string.GetData(), json_string.GetSize());
3490   StringExtractorGDBRemote response;
3491   if (SendPacketAndWaitForResponse(packet.GetString(), response, true) ==
3492       GDBRemoteCommunication::PacketResult::Success) {
3493     if (response.IsNormalResponse()) {
3494       size_t filled_size = response.GetHexBytesAvail(buffer);
3495       buffer = llvm::MutableArrayRef<uint8_t>(buffer.data(), filled_size);
3496     } else {
3497       error = response.GetStatus();
3498       buffer = buffer.slice(buffer.size());
3499     }
3500   } else {
3501     LLDB_LOG(log, "failed to send packet");
3502     error.SetErrorStringWithFormat("failed to send packet: '%s'",
3503                                    packet.GetData());
3504     buffer = buffer.slice(buffer.size());
3505   }
3506   return error;
3507 }
3508 
3509 bool GDBRemoteCommunicationClient::GetModuleInfo(
3510     const FileSpec &module_file_spec, const lldb_private::ArchSpec &arch_spec,
3511     ModuleSpec &module_spec) {
3512   if (!m_supports_qModuleInfo)
3513     return false;
3514 
3515   std::string module_path = module_file_spec.GetPath(false);
3516   if (module_path.empty())
3517     return false;
3518 
3519   StreamString packet;
3520   packet.PutCString("qModuleInfo:");
3521   packet.PutStringAsRawHex8(module_path);
3522   packet.PutCString(";");
3523   const auto &triple = arch_spec.GetTriple().getTriple();
3524   packet.PutStringAsRawHex8(triple);
3525 
3526   StringExtractorGDBRemote response;
3527   if (SendPacketAndWaitForResponse(packet.GetString(), response, false) !=
3528       PacketResult::Success)
3529     return false;
3530 
3531   if (response.IsErrorResponse())
3532     return false;
3533 
3534   if (response.IsUnsupportedResponse()) {
3535     m_supports_qModuleInfo = false;
3536     return false;
3537   }
3538 
3539   llvm::StringRef name;
3540   llvm::StringRef value;
3541 
3542   module_spec.Clear();
3543   module_spec.GetFileSpec() = module_file_spec;
3544 
3545   while (response.GetNameColonValue(name, value)) {
3546     if (name == "uuid" || name == "md5") {
3547       StringExtractor extractor(value);
3548       std::string uuid;
3549       extractor.GetHexByteString(uuid);
3550       module_spec.GetUUID().SetFromStringRef(uuid, uuid.size() / 2);
3551     } else if (name == "triple") {
3552       StringExtractor extractor(value);
3553       std::string triple;
3554       extractor.GetHexByteString(triple);
3555       module_spec.GetArchitecture().SetTriple(triple.c_str());
3556     } else if (name == "file_offset") {
3557       uint64_t ival = 0;
3558       if (!value.getAsInteger(16, ival))
3559         module_spec.SetObjectOffset(ival);
3560     } else if (name == "file_size") {
3561       uint64_t ival = 0;
3562       if (!value.getAsInteger(16, ival))
3563         module_spec.SetObjectSize(ival);
3564     } else if (name == "file_path") {
3565       StringExtractor extractor(value);
3566       std::string path;
3567       extractor.GetHexByteString(path);
3568       module_spec.GetFileSpec() = FileSpec(path, arch_spec.GetTriple());
3569     }
3570   }
3571 
3572   return true;
3573 }
3574 
3575 static llvm::Optional<ModuleSpec>
3576 ParseModuleSpec(StructuredData::Dictionary *dict) {
3577   ModuleSpec result;
3578   if (!dict)
3579     return llvm::None;
3580 
3581   llvm::StringRef string;
3582   uint64_t integer;
3583 
3584   if (!dict->GetValueForKeyAsString("uuid", string))
3585     return llvm::None;
3586   if (result.GetUUID().SetFromStringRef(string, string.size() / 2) !=
3587       string.size())
3588     return llvm::None;
3589 
3590   if (!dict->GetValueForKeyAsInteger("file_offset", integer))
3591     return llvm::None;
3592   result.SetObjectOffset(integer);
3593 
3594   if (!dict->GetValueForKeyAsInteger("file_size", integer))
3595     return llvm::None;
3596   result.SetObjectSize(integer);
3597 
3598   if (!dict->GetValueForKeyAsString("triple", string))
3599     return llvm::None;
3600   result.GetArchitecture().SetTriple(string);
3601 
3602   if (!dict->GetValueForKeyAsString("file_path", string))
3603     return llvm::None;
3604   result.GetFileSpec() = FileSpec(string, result.GetArchitecture().GetTriple());
3605 
3606   return result;
3607 }
3608 
3609 llvm::Optional<std::vector<ModuleSpec>>
3610 GDBRemoteCommunicationClient::GetModulesInfo(
3611     llvm::ArrayRef<FileSpec> module_file_specs, const llvm::Triple &triple) {
3612   if (!m_supports_jModulesInfo)
3613     return llvm::None;
3614 
3615   JSONArray::SP module_array_sp = std::make_shared<JSONArray>();
3616   for (const FileSpec &module_file_spec : module_file_specs) {
3617     JSONObject::SP module_sp = std::make_shared<JSONObject>();
3618     module_array_sp->AppendObject(module_sp);
3619     module_sp->SetObject(
3620         "file", std::make_shared<JSONString>(module_file_spec.GetPath(false)));
3621     module_sp->SetObject("triple",
3622                          std::make_shared<JSONString>(triple.getTriple()));
3623   }
3624   StreamString unescaped_payload;
3625   unescaped_payload.PutCString("jModulesInfo:");
3626   module_array_sp->Write(unescaped_payload);
3627   StreamGDBRemote payload;
3628   payload.PutEscapedBytes(unescaped_payload.GetString().data(),
3629                           unescaped_payload.GetSize());
3630 
3631   // Increase the timeout for jModulesInfo since this packet can take longer.
3632   ScopedTimeout timeout(*this, std::chrono::seconds(10));
3633 
3634   StringExtractorGDBRemote response;
3635   if (SendPacketAndWaitForResponse(payload.GetString(), response, false) !=
3636           PacketResult::Success ||
3637       response.IsErrorResponse())
3638     return llvm::None;
3639 
3640   if (response.IsUnsupportedResponse()) {
3641     m_supports_jModulesInfo = false;
3642     return llvm::None;
3643   }
3644 
3645   StructuredData::ObjectSP response_object_sp =
3646       StructuredData::ParseJSON(response.GetStringRef());
3647   if (!response_object_sp)
3648     return llvm::None;
3649 
3650   StructuredData::Array *response_array = response_object_sp->GetAsArray();
3651   if (!response_array)
3652     return llvm::None;
3653 
3654   std::vector<ModuleSpec> result;
3655   for (size_t i = 0; i < response_array->GetSize(); ++i) {
3656     if (llvm::Optional<ModuleSpec> module_spec = ParseModuleSpec(
3657             response_array->GetItemAtIndex(i)->GetAsDictionary()))
3658       result.push_back(*module_spec);
3659   }
3660 
3661   return result;
3662 }
3663 
3664 // query the target remote for extended information using the qXfer packet
3665 //
3666 // example: object='features', annex='target.xml', out=<xml output> return:
3667 // 'true'  on success
3668 //          'false' on failure (err set)
3669 bool GDBRemoteCommunicationClient::ReadExtFeature(
3670     const lldb_private::ConstString object,
3671     const lldb_private::ConstString annex, std::string &out,
3672     lldb_private::Status &err) {
3673 
3674   std::stringstream output;
3675   StringExtractorGDBRemote chunk;
3676 
3677   uint64_t size = GetRemoteMaxPacketSize();
3678   if (size == 0)
3679     size = 0x1000;
3680   size = size - 1; // Leave space for the 'm' or 'l' character in the response
3681   int offset = 0;
3682   bool active = true;
3683 
3684   // loop until all data has been read
3685   while (active) {
3686 
3687     // send query extended feature packet
3688     std::stringstream packet;
3689     packet << "qXfer:" << object.AsCString("")
3690            << ":read:" << annex.AsCString("") << ":" << std::hex << offset
3691            << "," << std::hex << size;
3692 
3693     GDBRemoteCommunication::PacketResult res =
3694         SendPacketAndWaitForResponse(packet.str(), chunk, false);
3695 
3696     if (res != GDBRemoteCommunication::PacketResult::Success) {
3697       err.SetErrorString("Error sending $qXfer packet");
3698       return false;
3699     }
3700 
3701     const std::string &str = chunk.GetStringRef();
3702     if (str.length() == 0) {
3703       // should have some data in chunk
3704       err.SetErrorString("Empty response from $qXfer packet");
3705       return false;
3706     }
3707 
3708     // check packet code
3709     switch (str[0]) {
3710     // last chunk
3711     case ('l'):
3712       active = false;
3713       LLVM_FALLTHROUGH;
3714 
3715     // more chunks
3716     case ('m'):
3717       if (str.length() > 1)
3718         output << &str[1];
3719       offset += size;
3720       break;
3721 
3722     // unknown chunk
3723     default:
3724       err.SetErrorString("Invalid continuation code from $qXfer packet");
3725       return false;
3726     }
3727   }
3728 
3729   out = output.str();
3730   err.Success();
3731   return true;
3732 }
3733 
3734 // Notify the target that gdb is prepared to serve symbol lookup requests.
3735 //  packet: "qSymbol::"
3736 //  reply:
3737 //  OK                  The target does not need to look up any (more) symbols.
3738 //  qSymbol:<sym_name>  The target requests the value of symbol sym_name (hex
3739 //  encoded).
3740 //                      LLDB may provide the value by sending another qSymbol
3741 //                      packet
3742 //                      in the form of"qSymbol:<sym_value>:<sym_name>".
3743 //
3744 //  Three examples:
3745 //
3746 //  lldb sends:    qSymbol::
3747 //  lldb receives: OK
3748 //     Remote gdb stub does not need to know the addresses of any symbols, lldb
3749 //     does not
3750 //     need to ask again in this session.
3751 //
3752 //  lldb sends:    qSymbol::
3753 //  lldb receives: qSymbol:64697370617463685f71756575655f6f666673657473
3754 //  lldb sends:    qSymbol::64697370617463685f71756575655f6f666673657473
3755 //  lldb receives: OK
3756 //     Remote gdb stub asks for address of 'dispatch_queue_offsets'.  lldb does
3757 //     not know
3758 //     the address at this time.  lldb needs to send qSymbol:: again when it has
3759 //     more
3760 //     solibs loaded.
3761 //
3762 //  lldb sends:    qSymbol::
3763 //  lldb receives: qSymbol:64697370617463685f71756575655f6f666673657473
3764 //  lldb sends:    qSymbol:2bc97554:64697370617463685f71756575655f6f666673657473
3765 //  lldb receives: OK
3766 //     Remote gdb stub asks for address of 'dispatch_queue_offsets'.  lldb says
3767 //     that it
3768 //     is at address 0x2bc97554.  Remote gdb stub sends 'OK' indicating that it
3769 //     does not
3770 //     need any more symbols.  lldb does not need to ask again in this session.
3771 
3772 void GDBRemoteCommunicationClient::ServeSymbolLookups(
3773     lldb_private::Process *process) {
3774   // Set to true once we've resolved a symbol to an address for the remote
3775   // stub. If we get an 'OK' response after this, the remote stub doesn't need
3776   // any more symbols and we can stop asking.
3777   bool symbol_response_provided = false;
3778 
3779   // Is this the initial qSymbol:: packet?
3780   bool first_qsymbol_query = true;
3781 
3782   if (m_supports_qSymbol && !m_qSymbol_requests_done) {
3783     Lock lock(*this, false);
3784     if (lock) {
3785       StreamString packet;
3786       packet.PutCString("qSymbol::");
3787       StringExtractorGDBRemote response;
3788       while (SendPacketAndWaitForResponseNoLock(packet.GetString(), response) ==
3789              PacketResult::Success) {
3790         if (response.IsOKResponse()) {
3791           if (symbol_response_provided || first_qsymbol_query) {
3792             m_qSymbol_requests_done = true;
3793           }
3794 
3795           // We are done serving symbols requests
3796           return;
3797         }
3798         first_qsymbol_query = false;
3799 
3800         if (response.IsUnsupportedResponse()) {
3801           // qSymbol is not supported by the current GDB server we are
3802           // connected to
3803           m_supports_qSymbol = false;
3804           return;
3805         } else {
3806           llvm::StringRef response_str(response.GetStringRef());
3807           if (response_str.startswith("qSymbol:")) {
3808             response.SetFilePos(strlen("qSymbol:"));
3809             std::string symbol_name;
3810             if (response.GetHexByteString(symbol_name)) {
3811               if (symbol_name.empty())
3812                 return;
3813 
3814               addr_t symbol_load_addr = LLDB_INVALID_ADDRESS;
3815               lldb_private::SymbolContextList sc_list;
3816               if (process->GetTarget().GetImages().FindSymbolsWithNameAndType(
3817                       ConstString(symbol_name), eSymbolTypeAny, sc_list)) {
3818                 const size_t num_scs = sc_list.GetSize();
3819                 for (size_t sc_idx = 0;
3820                      sc_idx < num_scs &&
3821                      symbol_load_addr == LLDB_INVALID_ADDRESS;
3822                      ++sc_idx) {
3823                   SymbolContext sc;
3824                   if (sc_list.GetContextAtIndex(sc_idx, sc)) {
3825                     if (sc.symbol) {
3826                       switch (sc.symbol->GetType()) {
3827                       case eSymbolTypeInvalid:
3828                       case eSymbolTypeAbsolute:
3829                       case eSymbolTypeUndefined:
3830                       case eSymbolTypeSourceFile:
3831                       case eSymbolTypeHeaderFile:
3832                       case eSymbolTypeObjectFile:
3833                       case eSymbolTypeCommonBlock:
3834                       case eSymbolTypeBlock:
3835                       case eSymbolTypeLocal:
3836                       case eSymbolTypeParam:
3837                       case eSymbolTypeVariable:
3838                       case eSymbolTypeVariableType:
3839                       case eSymbolTypeLineEntry:
3840                       case eSymbolTypeLineHeader:
3841                       case eSymbolTypeScopeBegin:
3842                       case eSymbolTypeScopeEnd:
3843                       case eSymbolTypeAdditional:
3844                       case eSymbolTypeCompiler:
3845                       case eSymbolTypeInstrumentation:
3846                       case eSymbolTypeTrampoline:
3847                         break;
3848 
3849                       case eSymbolTypeCode:
3850                       case eSymbolTypeResolver:
3851                       case eSymbolTypeData:
3852                       case eSymbolTypeRuntime:
3853                       case eSymbolTypeException:
3854                       case eSymbolTypeObjCClass:
3855                       case eSymbolTypeObjCMetaClass:
3856                       case eSymbolTypeObjCIVar:
3857                       case eSymbolTypeReExported:
3858                         symbol_load_addr =
3859                             sc.symbol->GetLoadAddress(&process->GetTarget());
3860                         break;
3861                       }
3862                     }
3863                   }
3864                 }
3865               }
3866               // This is the normal path where our symbol lookup was successful
3867               // and we want to send a packet with the new symbol value and see
3868               // if another lookup needs to be done.
3869 
3870               // Change "packet" to contain the requested symbol value and name
3871               packet.Clear();
3872               packet.PutCString("qSymbol:");
3873               if (symbol_load_addr != LLDB_INVALID_ADDRESS) {
3874                 packet.Printf("%" PRIx64, symbol_load_addr);
3875                 symbol_response_provided = true;
3876               } else {
3877                 symbol_response_provided = false;
3878               }
3879               packet.PutCString(":");
3880               packet.PutBytesAsRawHex8(symbol_name.data(), symbol_name.size());
3881               continue; // go back to the while loop and send "packet" and wait
3882                         // for another response
3883             }
3884           }
3885         }
3886       }
3887       // If we make it here, the symbol request packet response wasn't valid or
3888       // our symbol lookup failed so we must abort
3889       return;
3890 
3891     } else if (Log *log = ProcessGDBRemoteLog::GetLogIfAnyCategoryIsSet(
3892                    GDBR_LOG_PROCESS | GDBR_LOG_PACKETS)) {
3893       LLDB_LOGF(log,
3894                 "GDBRemoteCommunicationClient::%s: Didn't get sequence mutex.",
3895                 __FUNCTION__);
3896     }
3897   }
3898 }
3899 
3900 StructuredData::Array *
3901 GDBRemoteCommunicationClient::GetSupportedStructuredDataPlugins() {
3902   if (!m_supported_async_json_packets_is_valid) {
3903     // Query the server for the array of supported asynchronous JSON packets.
3904     m_supported_async_json_packets_is_valid = true;
3905 
3906     Log *log(ProcessGDBRemoteLog::GetLogIfAllCategoriesSet(GDBR_LOG_PROCESS));
3907 
3908     // Poll it now.
3909     StringExtractorGDBRemote response;
3910     const bool send_async = false;
3911     if (SendPacketAndWaitForResponse("qStructuredDataPlugins", response,
3912                                      send_async) == PacketResult::Success) {
3913       m_supported_async_json_packets_sp =
3914           StructuredData::ParseJSON(response.GetStringRef());
3915       if (m_supported_async_json_packets_sp &&
3916           !m_supported_async_json_packets_sp->GetAsArray()) {
3917         // We were returned something other than a JSON array.  This is
3918         // invalid.  Clear it out.
3919         LLDB_LOGF(log,
3920                   "GDBRemoteCommunicationClient::%s(): "
3921                   "QSupportedAsyncJSONPackets returned invalid "
3922                   "result: %s",
3923                   __FUNCTION__, response.GetStringRef().data());
3924         m_supported_async_json_packets_sp.reset();
3925       }
3926     } else {
3927       LLDB_LOGF(log,
3928                 "GDBRemoteCommunicationClient::%s(): "
3929                 "QSupportedAsyncJSONPackets unsupported",
3930                 __FUNCTION__);
3931     }
3932 
3933     if (log && m_supported_async_json_packets_sp) {
3934       StreamString stream;
3935       m_supported_async_json_packets_sp->Dump(stream);
3936       LLDB_LOGF(log,
3937                 "GDBRemoteCommunicationClient::%s(): supported async "
3938                 "JSON packets: %s",
3939                 __FUNCTION__, stream.GetData());
3940     }
3941   }
3942 
3943   return m_supported_async_json_packets_sp
3944              ? m_supported_async_json_packets_sp->GetAsArray()
3945              : nullptr;
3946 }
3947 
3948 Status GDBRemoteCommunicationClient::SendSignalsToIgnore(
3949     llvm::ArrayRef<int32_t> signals) {
3950   // Format packet:
3951   // QPassSignals:<hex_sig1>;<hex_sig2>...;<hex_sigN>
3952   auto range = llvm::make_range(signals.begin(), signals.end());
3953   std::string packet = formatv("QPassSignals:{0:$[;]@(x-2)}", range).str();
3954 
3955   StringExtractorGDBRemote response;
3956   auto send_status = SendPacketAndWaitForResponse(packet, response, false);
3957 
3958   if (send_status != GDBRemoteCommunication::PacketResult::Success)
3959     return Status("Sending QPassSignals packet failed");
3960 
3961   if (response.IsOKResponse()) {
3962     return Status();
3963   } else {
3964     return Status("Unknown error happened during sending QPassSignals packet.");
3965   }
3966 }
3967 
3968 Status GDBRemoteCommunicationClient::ConfigureRemoteStructuredData(
3969     ConstString type_name, const StructuredData::ObjectSP &config_sp) {
3970   Status error;
3971 
3972   if (type_name.GetLength() == 0) {
3973     error.SetErrorString("invalid type_name argument");
3974     return error;
3975   }
3976 
3977   // Build command: Configure{type_name}: serialized config data.
3978   StreamGDBRemote stream;
3979   stream.PutCString("QConfigure");
3980   stream.PutCString(type_name.AsCString());
3981   stream.PutChar(':');
3982   if (config_sp) {
3983     // Gather the plain-text version of the configuration data.
3984     StreamString unescaped_stream;
3985     config_sp->Dump(unescaped_stream);
3986     unescaped_stream.Flush();
3987 
3988     // Add it to the stream in escaped fashion.
3989     stream.PutEscapedBytes(unescaped_stream.GetString().data(),
3990                            unescaped_stream.GetSize());
3991   }
3992   stream.Flush();
3993 
3994   // Send the packet.
3995   const bool send_async = false;
3996   StringExtractorGDBRemote response;
3997   auto result =
3998       SendPacketAndWaitForResponse(stream.GetString(), response, send_async);
3999   if (result == PacketResult::Success) {
4000     // We failed if the config result comes back other than OK.
4001     if (strcmp(response.GetStringRef().data(), "OK") == 0) {
4002       // Okay!
4003       error.Clear();
4004     } else {
4005       error.SetErrorStringWithFormat("configuring StructuredData feature "
4006                                      "%s failed with error %s",
4007                                      type_name.AsCString(),
4008                                      response.GetStringRef().data());
4009     }
4010   } else {
4011     // Can we get more data here on the failure?
4012     error.SetErrorStringWithFormat("configuring StructuredData feature %s "
4013                                    "failed when sending packet: "
4014                                    "PacketResult=%d",
4015                                    type_name.AsCString(), (int)result);
4016   }
4017   return error;
4018 }
4019 
4020 void GDBRemoteCommunicationClient::OnRunPacketSent(bool first) {
4021   GDBRemoteClientBase::OnRunPacketSent(first);
4022   m_curr_tid = LLDB_INVALID_THREAD_ID;
4023 }
4024