LLDB  mainline
GDBRemoteCommunicationServerPlatform.cpp
Go to the documentation of this file.
1 //===-- GDBRemoteCommunicationServerPlatform.cpp --------------------------===//
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 
10 
11 #include <cerrno>
12 
13 #include <chrono>
14 #include <csignal>
15 #include <cstring>
16 #include <mutex>
17 #include <sstream>
18 #include <thread>
19 
20 #include "llvm/Support/FileSystem.h"
21 #include "llvm/Support/JSON.h"
22 #include "llvm/Support/Threading.h"
23 
24 #include "lldb/Host/Config.h"
26 #include "lldb/Host/FileAction.h"
27 #include "lldb/Host/Host.h"
28 #include "lldb/Host/HostInfo.h"
30 #include "lldb/Target/Platform.h"
32 #include "lldb/Utility/GDBRemote.h"
33 #include "lldb/Utility/LLDBLog.h"
34 #include "lldb/Utility/Log.h"
38 #include "lldb/Utility/UriParser.h"
39 
41 
42 using namespace lldb;
43 using namespace lldb_private::process_gdb_remote;
44 using namespace lldb_private;
45 
46 GDBRemoteCommunicationServerPlatform::PortMap::PortMap(uint16_t min_port,
47  uint16_t max_port) {
48  for (; min_port < max_port; ++min_port)
49  m_port_map[min_port] = LLDB_INVALID_PROCESS_ID;
50 }
51 
52 void GDBRemoteCommunicationServerPlatform::PortMap::AllowPort(uint16_t port) {
53  // Do not modify existing mappings
54  m_port_map.insert({port, LLDB_INVALID_PROCESS_ID});
55 }
56 
57 llvm::Expected<uint16_t>
58 GDBRemoteCommunicationServerPlatform::PortMap::GetNextAvailablePort() {
59  if (m_port_map.empty())
60  return 0; // Bind to port zero and get a port, we didn't have any
61  // limitations
62 
63  for (auto &pair : m_port_map) {
64  if (pair.second == LLDB_INVALID_PROCESS_ID) {
65  pair.second = ~(lldb::pid_t)LLDB_INVALID_PROCESS_ID;
66  return pair.first;
67  }
68  }
69  return llvm::createStringError(llvm::inconvertibleErrorCode(),
70  "No free port found in port map");
71 }
72 
73 bool GDBRemoteCommunicationServerPlatform::PortMap::AssociatePortWithProcess(
74  uint16_t port, lldb::pid_t pid) {
75  auto pos = m_port_map.find(port);
76  if (pos != m_port_map.end()) {
77  pos->second = pid;
78  return true;
79  }
80  return false;
81 }
82 
83 bool GDBRemoteCommunicationServerPlatform::PortMap::FreePort(uint16_t port) {
84  std::map<uint16_t, lldb::pid_t>::iterator pos = m_port_map.find(port);
85  if (pos != m_port_map.end()) {
86  pos->second = LLDB_INVALID_PROCESS_ID;
87  return true;
88  }
89  return false;
90 }
91 
92 bool GDBRemoteCommunicationServerPlatform::PortMap::FreePortForProcess(
93  lldb::pid_t pid) {
94  if (!m_port_map.empty()) {
95  for (auto &pair : m_port_map) {
96  if (pair.second == pid) {
97  pair.second = LLDB_INVALID_PROCESS_ID;
98  return true;
99  }
100  }
101  }
102  return false;
103 }
104 
105 bool GDBRemoteCommunicationServerPlatform::PortMap::empty() const {
106  return m_port_map.empty();
107 }
108 
109 // GDBRemoteCommunicationServerPlatform constructor
110 GDBRemoteCommunicationServerPlatform::GDBRemoteCommunicationServerPlatform(
111  const Socket::SocketProtocol socket_protocol, const char *socket_scheme)
113  m_socket_protocol(socket_protocol), m_socket_scheme(socket_scheme),
114  m_spawned_pids_mutex(), m_port_map(), m_port_offset(0) {
116  m_pending_gdb_server.port = 0;
117 
145 
148  bool &interrupt, bool &quit) {
149  error.SetErrorString("interrupt received");
150  interrupt = true;
151  return PacketResult::Success;
152  });
153 }
154 
155 // Destructor
157  default;
158 
160  const lldb_private::Args &args, std::string hostname, lldb::pid_t &pid,
161  llvm::Optional<uint16_t> &port, std::string &socket_name) {
162  if (!port) {
163  llvm::Expected<uint16_t> available_port = m_port_map.GetNextAvailablePort();
164  if (available_port)
165  port = *available_port;
166  else
167  return Status(available_port.takeError());
168  }
169 
170  // Spawn a new thread to accept the port that gets bound after binding to
171  // port 0 (zero).
172 
173  // ignore the hostname send from the remote end, just use the ip address that
174  // we're currently communicating with as the hostname
175 
176  // Spawn a debugserver and try to get the port it listens to.
177  ProcessLaunchInfo debugserver_launch_info;
178  if (hostname.empty())
179  hostname = "127.0.0.1";
180 
181  Log *log = GetLog(LLDBLog::Platform);
182  LLDB_LOGF(log, "Launching debugserver with: %s:%u...", hostname.c_str(),
183  *port);
184 
185  // Do not run in a new session so that it can not linger after the platform
186  // closes.
187  debugserver_launch_info.SetLaunchInSeparateProcessGroup(false);
188  debugserver_launch_info.SetMonitorProcessCallback(
190  this, std::placeholders::_1));
191 
192  std::ostringstream url;
193 // debugserver does not accept the URL scheme prefix.
194 #if !defined(__APPLE__)
195  url << m_socket_scheme << "://";
196 #endif
197  uint16_t *port_ptr = port.getPointer();
199  std::string platform_uri = GetConnection()->GetURI();
200  llvm::Optional<URI> parsed_uri = URI::Parse(platform_uri);
201  url << '[' << parsed_uri->hostname.str() << "]:" << *port;
202  } else {
203  socket_name = GetDomainSocketPath("gdbserver").GetPath();
204  url << socket_name;
205  port_ptr = nullptr;
206  }
207 
209  url.str().c_str(), nullptr, debugserver_launch_info, port_ptr, &args, -1);
210 
211  pid = debugserver_launch_info.GetProcessID();
212  if (pid != LLDB_INVALID_PROCESS_ID) {
213  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
214  m_spawned_pids.insert(pid);
215  if (*port > 0)
217  } else {
218  if (*port > 0)
220  }
221  return error;
222 }
223 
226  StringExtractorGDBRemote &packet) {
227  // Spawn a local debugserver as a platform so we can then attach or launch a
228  // process...
229 
230  Log *log = GetLog(LLDBLog::Platform);
231  LLDB_LOGF(log, "GDBRemoteCommunicationServerPlatform::%s() called",
232  __FUNCTION__);
233 
234  ConnectionFileDescriptor file_conn;
235  std::string hostname;
236  packet.SetFilePos(::strlen("qLaunchGDBServer;"));
237  llvm::StringRef name;
238  llvm::StringRef value;
239  llvm::Optional<uint16_t> port;
240  while (packet.GetNameColonValue(name, value)) {
241  if (name.equals("host"))
242  hostname = std::string(value);
243  else if (name.equals("port")) {
244  // Make the Optional valid so we can use its value
245  port = 0;
246  value.getAsInteger(0, *port);
247  }
248  }
249 
250  lldb::pid_t debugserver_pid = LLDB_INVALID_PROCESS_ID;
252  Status error =
253  LaunchGDBServer(Args(), hostname, debugserver_pid, port, socket_name);
254  if (error.Fail()) {
255  LLDB_LOGF(log,
256  "GDBRemoteCommunicationServerPlatform::%s() debugserver "
257  "launch failed: %s",
258  __FUNCTION__, error.AsCString());
259  return SendErrorResponse(9);
260  }
261 
262  LLDB_LOGF(log,
263  "GDBRemoteCommunicationServerPlatform::%s() debugserver "
264  "launched successfully as pid %" PRIu64,
265  __FUNCTION__, debugserver_pid);
266 
267  StreamGDBRemote response;
268  assert(port);
269  response.Printf("pid:%" PRIu64 ";port:%u;", debugserver_pid,
270  *port + m_port_offset);
271  if (!socket_name.empty()) {
272  response.PutCString("socket_name:");
274  response.PutChar(';');
275  }
276 
277  PacketResult packet_result = SendPacketNoLock(response.GetString());
278  if (packet_result != PacketResult::Success) {
279  if (debugserver_pid != LLDB_INVALID_PROCESS_ID)
280  Host::Kill(debugserver_pid, SIGINT);
281  }
282  return packet_result;
283 }
284 
287  StringExtractorGDBRemote &packet) {
288  namespace json = llvm::json;
289 
291  return SendErrorResponse(4);
292 
293  json::Object server{{"port", m_pending_gdb_server.port}};
294 
295  if (!m_pending_gdb_server.socket_name.empty())
296  server.try_emplace("socket_name", m_pending_gdb_server.socket_name);
297 
298  json::Array server_list;
299  server_list.push_back(std::move(server));
300 
301  StreamGDBRemote response;
302  response.AsRawOstream() << std::move(server_list);
303 
304  StreamGDBRemote escaped_response;
305  escaped_response.PutEscapedBytes(response.GetString().data(),
306  response.GetSize());
307  return SendPacketNoLock(escaped_response.GetString());
308 }
309 
312  StringExtractorGDBRemote &packet) {
313  packet.SetFilePos(::strlen("qKillSpawnedProcess:"));
314 
316 
317  // verify that we know anything about this pid. Scope for locker
318  {
319  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
320  if (m_spawned_pids.find(pid) == m_spawned_pids.end()) {
321  // not a pid we know about
322  return SendErrorResponse(10);
323  }
324  }
325 
326  // go ahead and attempt to kill the spawned process
327  if (KillSpawnedProcess(pid))
328  return SendOKResponse();
329  else
330  return SendErrorResponse(11);
331 }
332 
334  // make sure we know about this process
335  {
336  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
337  if (m_spawned_pids.find(pid) == m_spawned_pids.end())
338  return false;
339  }
340 
341  // first try a SIGTERM (standard kill)
342  Host::Kill(pid, SIGTERM);
343 
344  // check if that worked
345  for (size_t i = 0; i < 10; ++i) {
346  {
347  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
348  if (m_spawned_pids.find(pid) == m_spawned_pids.end()) {
349  // it is now killed
350  return true;
351  }
352  }
353  std::this_thread::sleep_for(std::chrono::milliseconds(10));
354  }
355 
356  {
357  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
358  if (m_spawned_pids.find(pid) == m_spawned_pids.end())
359  return true;
360  }
361 
362  // the launched process still lives. Now try killing it again, this time
363  // with an unblockable signal.
365 
366  for (size_t i = 0; i < 10; ++i) {
367  {
368  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
369  if (m_spawned_pids.find(pid) == m_spawned_pids.end()) {
370  // it is now killed
371  return true;
372  }
373  }
374  std::this_thread::sleep_for(std::chrono::milliseconds(10));
375  }
376 
377  // check one more time after the final sleep
378  {
379  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
380  if (m_spawned_pids.find(pid) == m_spawned_pids.end())
381  return true;
382  }
383 
384  // no luck - the process still lives
385  return false;
386 }
387 
390  StringExtractorGDBRemote &packet) {
393 
395  return SendErrorResponse(1);
396 
397  ProcessInstanceInfo proc_info;
398  if (!Host::GetProcessInfo(pid, proc_info))
399  return SendErrorResponse(1);
400 
401  StreamString response;
402  CreateProcessInfoResponse_DebugServerStyle(proc_info, response);
403  return SendPacketNoLock(response.GetString());
404 }
405 
408  StringExtractorGDBRemote &packet) {
409  packet.SetFilePos(::strlen("qPathComplete:"));
410  const bool only_dir = (packet.GetHexMaxU32(false, 0) == 1);
411  if (packet.GetChar() != ',')
412  return SendErrorResponse(85);
413  std::string path;
414  packet.GetHexByteString(path);
415 
416  StringList matches;
418  if (only_dir)
419  CommandCompletions::DiskDirectories(path, matches, resolver);
420  else
421  CommandCompletions::DiskFiles(path, matches, resolver);
422 
423  StreamString response;
424  response.PutChar('M');
425  llvm::StringRef separator;
426  std::sort(matches.begin(), matches.end());
427  for (const auto &match : matches) {
428  response << separator;
429  separator = ",";
430  // encode result strings into hex bytes to avoid unexpected error caused by
431  // special characters like '$'.
432  response.PutStringAsRawHex8(match.c_str());
433  }
434 
435  return SendPacketNoLock(response.GetString());
436 }
437 
440  StringExtractorGDBRemote &packet) {
441 
442  llvm::SmallString<64> cwd;
443  if (std::error_code ec = llvm::sys::fs::current_path(cwd))
444  return SendErrorResponse(ec.value());
445 
446  StreamString response;
447  response.PutBytesAsRawHex8(cwd.data(), cwd.size());
448  return SendPacketNoLock(response.GetString());
449 }
450 
453  StringExtractorGDBRemote &packet) {
454  packet.SetFilePos(::strlen("QSetWorkingDir:"));
455  std::string path;
456  packet.GetHexByteString(path);
457 
458  if (std::error_code ec = llvm::sys::fs::set_current_path(path))
459  return SendErrorResponse(ec.value());
460  return SendOKResponse();
461 }
462 
465  StringExtractorGDBRemote &packet) {
466  // NOTE: lldb should now be using qProcessInfo for process IDs. This path
467  // here
468  // should not be used. It is reporting process id instead of thread id. The
469  // correct answer doesn't seem to make much sense for lldb-platform.
470  // CONSIDER: flip to "unsupported".
472 
473  StreamString response;
474  response.Printf("QC%" PRIx64, pid);
475 
476  // If we launch a process and this GDB server is acting as a platform, then
477  // we need to clear the process launch state so we can start launching
478  // another process. In order to launch a process a bunch or packets need to
479  // be sent: environment packets, working directory, disable ASLR, and many
480  // more settings. When we launch a process we then need to know when to clear
481  // this information. Currently we are selecting the 'qC' packet as that
482  // packet which seems to make the most sense.
483  if (pid != LLDB_INVALID_PROCESS_ID) {
485  }
486 
487  return SendPacketNoLock(response.GetString());
488 }
489 
492  StringExtractorGDBRemote &packet) {
493  StructuredData::Array signal_array;
494 
495  lldb::UnixSignalsSP signals = UnixSignals::CreateForHost();
496  for (auto signo = signals->GetFirstSignalNumber();
498  signo = signals->GetNextSignalNumber(signo)) {
499  auto dictionary = std::make_shared<StructuredData::Dictionary>();
500 
501  dictionary->AddIntegerItem("signo", signo);
502  dictionary->AddStringItem("name", signals->GetSignalAsCString(signo));
503 
504  bool suppress, stop, notify;
505  signals->GetSignalInfo(signo, suppress, stop, notify);
506  dictionary->AddBooleanItem("suppress", suppress);
507  dictionary->AddBooleanItem("stop", stop);
508  dictionary->AddBooleanItem("notify", notify);
509 
510  signal_array.Push(dictionary);
511  }
512 
513  StreamString response;
514  signal_array.Dump(response);
515  return SendPacketNoLock(response.GetString());
516 }
517 
519  lldb::pid_t pid) {
520  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
522  m_spawned_pids.erase(pid);
523 }
524 
527  return Status("%s: no process command line specified to launch",
528  __FUNCTION__);
529 
530  // specify the process monitor if not already set. This should generally be
531  // what happens since we need to reap started processes.
535  std::placeholders::_1));
536 
538  if (!error.Success()) {
539  fprintf(stderr, "%s: failed to launch executable %s", __FUNCTION__,
541  return error;
542  }
543 
544  printf("Launched '%s' as process %" PRIu64 "...\n",
547 
548  // add to list of spawned processes. On an lldb-gdbserver, we would expect
549  // there to be only one.
550  const auto pid = m_process_launch_info.GetProcessID();
551  if (pid != LLDB_INVALID_PROCESS_ID) {
552  // add to spawned pids
553  std::lock_guard<std::recursive_mutex> guard(m_spawned_pids_mutex);
554  m_spawned_pids.insert(pid);
555  }
556 
557  return error;
558 }
559 
561  m_port_map = port_map;
562 }
563 
565  static FileSpec g_domainsocket_dir;
566  static llvm::once_flag g_once_flag;
567 
568  llvm::call_once(g_once_flag, []() {
569  const char *domainsocket_dir_env =
570  ::getenv("LLDB_DEBUGSERVER_DOMAINSOCKET_DIR");
571  if (domainsocket_dir_env != nullptr)
572  g_domainsocket_dir = FileSpec(domainsocket_dir_env);
573  else
574  g_domainsocket_dir = HostInfo::GetProcessTempDir();
575  });
576 
577  return g_domainsocket_dir;
578 }
579 
580 FileSpec
582  llvm::SmallString<128> socket_path;
583  llvm::SmallString<128> socket_name(
584  (llvm::StringRef(prefix) + ".%%%%%%").str());
585 
586  FileSpec socket_path_spec(GetDomainSocketDir());
587  socket_path_spec.AppendPathComponent(socket_name.c_str());
588 
589  llvm::sys::fs::createUniqueFile(socket_path_spec.GetPath().c_str(),
590  socket_path);
591  return FileSpec(socket_path.c_str());
592 }
593 
595  m_port_offset = port_offset;
596 }
597 
599  lldb::pid_t pid, uint16_t port, const std::string &socket_name) {
601  m_pending_gdb_server.port = port;
602  m_pending_gdb_server.socket_name = socket_name;
603 }
lldb_private::ProcessInfo::GetArguments
Args & GetArguments()
Definition: ProcessInfo.h:74
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qProcessInfo
PacketResult Handle_qProcessInfo(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:389
lldb_private::ProcessInstanceInfo
Definition: ProcessInfo.h:106
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qGetWorkingDir
PacketResult Handle_qGetWorkingDir(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:439
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_jSignalsInfo
PacketResult Handle_jSignalsInfo(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:491
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_socket_protocol
const Socket::SocketProtocol m_socket_protocol
Definition: GDBRemoteCommunicationServerPlatform.h:100
lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::SendErrorResponse
PacketResult SendErrorResponse(const Status &error)
Definition: GDBRemoteCommunicationServer.cpp:105
lldb_private::StandardTildeExpressionResolver
Definition: TildeExpressionResolver.h:56
lldb_private::Host::LaunchProcess
static Status LaunchProcess(ProcessLaunchInfo &launch_info)
Launch the process specified in launch_info.
Definition: common/Host.cpp:524
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::LaunchProcess
Status LaunchProcess() override
Launch a process with the current launch settings.
Definition: GDBRemoteCommunicationServerPlatform.cpp:525
lldb_private::StringList::begin
iterator begin()
Definition: StringList.h:63
LLDB_INVALID_PROCESS_ID
#define LLDB_INVALID_PROCESS_ID
Definition: lldb-defines.h:81
StringExtractor::SetFilePos
void SetFilePos(uint32_t idx)
Definition: StringExtractor.h:39
lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::RegisterPacketHandler
void RegisterPacketHandler(StringExtractorGDBRemote::ServerPacketType packet_type, PacketHandler handler)
Definition: GDBRemoteCommunicationServer.cpp:37
lldb_private::StructuredData::Array
Definition: StructuredData.h:165
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qQueryGDBServer
PacketResult Handle_qQueryGDBServer(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:286
StructuredData.h
lldb_private::URI::Parse
static llvm::Optional< URI > Parse(llvm::StringRef uri)
Definition: UriParser.cpp:27
lldb_private::Socket::SocketProtocol
SocketProtocol
Definition: Socket.h:43
Host.h
lldb_private::Connection::GetURI
virtual std::string GetURI()=0
Returns a URI that describes this connection object.
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::PortMap::AssociatePortWithProcess
bool AssociatePortWithProcess(uint16_t port, lldb::pid_t pid)
Definition: GDBRemoteCommunicationServerPlatform.cpp:73
StringExtractorGDBRemote::eServerPacketType_qQueryGDBServer
@ eServerPacketType_qQueryGDBServer
Definition: StringExtractorGDBRemote.h:60
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::GetDomainSocketPath
static FileSpec GetDomainSocketPath(const char *prefix)
Definition: GDBRemoteCommunicationServerPlatform.cpp:581
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::PortMap
Definition: GDBRemoteCommunicationServerPlatform.h:28
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::~GDBRemoteCommunicationServerPlatform
~GDBRemoteCommunicationServerPlatform() override
lldb_private::process_gdb_remote::GDBRemoteCommunication::PacketResult
PacketResult
Definition: GDBRemoteCommunication.h:87
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::SetPortMap
void SetPortMap(PortMap &&port_map)
Definition: GDBRemoteCommunicationServerPlatform.cpp:560
LLDB_LOGF
#define LLDB_LOGF(log,...)
Definition: Log.h:344
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_port_map
PortMap m_port_map
Definition: GDBRemoteCommunicationServerPlatform.h:105
StringExtractorGDBRemote::eServerPacketType_qC
@ eServerPacketType_qC
Definition: StringExtractorGDBRemote.h:55
StringExtractorGDBRemote::eServerPacketType_qProcessInfo
@ eServerPacketType_qProcessInfo
Definition: StringExtractorGDBRemote.h:116
lldb_private::ProcessInfo::GetProcessID
lldb::pid_t GetProcessID() const
Definition: ProcessInfo.h:66
StringExtractor::GetHexMaxU32
uint32_t GetHexMaxU32(bool little_endian, uint32_t fail_value)
Definition: StringExtractor.cpp:153
StringExtractorGDBRemote.h
lldb_private::Args
Definition: Args.h:33
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qLaunchGDBServer
PacketResult Handle_qLaunchGDBServer(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:225
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon
Definition: GDBRemoteCommunicationServerCommon.h:26
lldb_private::Stream::PutStringAsRawHex8
size_t PutStringAsRawHex8(llvm::StringRef s)
Definition: Stream.cpp:383
lldb_private::StreamString::GetString
llvm::StringRef GetString() const
Definition: StreamString.cpp:51
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::LaunchGDBServer
Status LaunchGDBServer(const lldb_private::Args &args, std::string hostname, lldb::pid_t &pid, llvm::Optional< uint16_t > &port, std::string &socket_name)
Definition: GDBRemoteCommunicationServerPlatform.cpp:159
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::SetPortOffset
void SetPortOffset(uint16_t port_offset)
Definition: GDBRemoteCommunicationServerPlatform.cpp:594
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_spawned_pids
std::set< lldb::pid_t > m_spawned_pids
Definition: GDBRemoteCommunicationServerPlatform.h:103
lldb_private::StringList::end
iterator end()
Definition: StringList.h:64
llvm::json
Definition: Trace.cpp:35
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::PortMap::GetNextAvailablePort
llvm::Expected< uint16_t > GetNextAvailablePort()
Definition: GDBRemoteCommunicationServerPlatform.cpp:58
Platform.h
lldb_private::FileSpec
Definition: FileSpec.h:55
error
static llvm::raw_ostream & error(Stream &strm)
Definition: CommandReturnObject.cpp:17
LLDB_INVALID_SIGNAL_NUMBER
#define LLDB_INVALID_SIGNAL_NUMBER
Definition: lldb-defines.h:84
lldb_private::StreamString::GetSize
size_t GetSize() const
Definition: StreamString.cpp:38
lldb_private::ProcessLaunchInfo::Clear
void Clear()
Definition: ProcessLaunchInfo.cpp:164
lldb_private::process_gdb_remote::GDBRemoteCommunication::StartDebugserverProcess
Status StartDebugserverProcess(const char *url, Platform *platform, ProcessLaunchInfo &launch_info, uint16_t *port, const Args *inferior_args, int pass_comm_fd)
Definition: GDBRemoteCommunication.cpp:901
lldb_private::StructuredData::Object::Dump
void Dump(lldb_private::Stream &s, bool pretty_print=true) const
Definition: StructuredData.h:156
SIGKILL
#define SIGKILL
Definition: windows/PosixApi.h:31
lldb_private::ProcessLaunchInfo
Definition: ProcessLaunchInfo.h:31
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::PortMap::FreePortForProcess
bool FreePortForProcess(lldb::pid_t pid)
Definition: GDBRemoteCommunicationServerPlatform.cpp:92
Log.h
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::PortMap::FreePort
bool FreePort(uint16_t port)
Definition: GDBRemoteCommunicationServerPlatform.cpp:83
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qC
PacketResult Handle_qC(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:464
UnixSignals.h
StringExtractorGDBRemote::eServerPacketType_qPathComplete
@ eServerPacketType_qPathComplete
Definition: StringExtractorGDBRemote.h:79
StreamString.h
StringExtractorGDBRemote::eServerPacketType_jSignalsInfo
@ eServerPacketType_jSignalsInfo
Definition: StringExtractorGDBRemote.h:130
lldb_private::UnixSignals::CreateForHost
static lldb::UnixSignalsSP CreateForHost()
Definition: UnixSignals.cpp:56
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::RegisterMemberFunctionHandler
void RegisterMemberFunctionHandler(StringExtractorGDBRemote::ServerPacketType packet_type, PacketResult(T::*handler)(StringExtractorGDBRemote &packet))
Definition: GDBRemoteCommunicationServerCommon.h:117
StringExtractorGDBRemote::eServerPacketType_qKillSpawnedProcess
@ eServerPacketType_qKillSpawnedProcess
Definition: StringExtractorGDBRemote.h:61
lldb_private::StringList
Definition: StringList.h:26
lldb_private::StreamString
Definition: StreamString.h:23
GDBRemote.h
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qPathComplete
PacketResult Handle_qPathComplete(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:407
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_QSetWorkingDir
PacketResult Handle_QSetWorkingDir(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:452
ConnectionFileDescriptor.h
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_spawned_pids_mutex
std::recursive_mutex m_spawned_pids_mutex
Definition: GDBRemoteCommunicationServerPlatform.h:102
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_socket_scheme
const std::string m_socket_scheme
Definition: GDBRemoteCommunicationServerPlatform.h:101
lldb_private::StructuredData::Array::Push
void Push(const ObjectSP &item)
Definition: StructuredData.h:274
HostInfo.h
lldb_private::CommandCompletions::DiskDirectories
static void DiskDirectories(CommandInterpreter &interpreter, CompletionRequest &request, SearchFilter *searcher)
Definition: CommandCompletions.cpp:484
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::pid
lldb::pid_t pid
Definition: GDBRemoteCommunicationServerPlatform.h:108
StringExtractor::GetChar
char GetChar(char fail_value='\0')
Definition: StringExtractor.cpp:43
string
string(SUBSTRING ${p} 10 -1 pStripped) if($
Definition: Plugins/CMakeLists.txt:40
StringExtractor::GetNameColonValue
bool GetNameColonValue(llvm::StringRef &name, llvm::StringRef &value)
Definition: StringExtractor.cpp:333
lldb_private::Stream::PutChar
size_t PutChar(char ch)
Definition: Stream.cpp:104
lldb_private::process_gdb_remote
Definition: GDBRemoteClientBase.h:17
lldb_private::CommandCompletions::DiskFiles
static void DiskFiles(CommandInterpreter &interpreter, CompletionRequest &request, SearchFilter *searcher)
Definition: CommandCompletions.cpp:472
StringExtractorGDBRemote::eServerPacketType_qLaunchGDBServer
@ eServerPacketType_qLaunchGDBServer
Definition: StringExtractorGDBRemote.h:59
StringExtractorGDBRemote::eServerPacketType_QSetWorkingDir
@ eServerPacketType_QSetWorkingDir
Definition: StringExtractorGDBRemote.h:77
lldb_private::ProcessLaunchInfo::SetLaunchInSeparateProcessGroup
void SetLaunchInSeparateProcessGroup(bool separate)
Definition: ProcessLaunchInfo.cpp:150
lldb_private::process_gdb_remote::GDBRemoteCommunication::PacketResult::Success
@ Success
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::DebugserverProcessReaped
void DebugserverProcessReaped(lldb::pid_t pid)
Definition: GDBRemoteCommunicationServerPlatform.cpp:518
StringExtractor::GetHexByteString
size_t GetHexByteString(std::string &str)
Definition: StringExtractor.cpp:298
StringExtractor::GetU64
uint64_t GetU64(uint64_t fail_value, int base=0)
Definition: StringExtractor.cpp:123
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::socket_name
std::string socket_name
Definition: GDBRemoteCommunicationServerPlatform.h:110
GDBRemoteCommunicationServerPlatform.h
lldb_private::Stream::PutBytesAsRawHex8
size_t PutBytesAsRawHex8(const void *src, size_t src_len, lldb::ByteOrder src_byte_order=lldb::eByteOrderInvalid, lldb::ByteOrder dst_byte_order=lldb::eByteOrderInvalid)
Definition: Stream.cpp:356
lldb_private::Status
Definition: Status.h:44
lldb_private::Socket::ProtocolTcp
@ ProtocolTcp
Definition: Socket.h:44
lldb_private::Args::GetArgumentAtIndex
const char * GetArgumentAtIndex(size_t idx) const
Gets the NULL terminated C string argument pointer for the argument at index idx.
Definition: Args.cpp:264
TildeExpressionResolver.h
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::Handle_qKillSpawnedProcess
PacketResult Handle_qKillSpawnedProcess(StringExtractorGDBRemote &packet)
Definition: GDBRemoteCommunicationServerPlatform.cpp:311
lldb::pid_t
uint64_t pid_t
Definition: lldb-types.h:85
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::GetDomainSocketDir
static const FileSpec & GetDomainSocketDir()
Definition: GDBRemoteCommunicationServerPlatform.cpp:564
StringExtractorGDBRemote::eServerPacketType_interrupt
@ eServerPacketType_interrupt
Definition: StringExtractorGDBRemote.h:51
lldb_private::Host::GetProcessInfo
static bool GetProcessInfo(lldb::pid_t pid, ProcessInstanceInfo &proc_info)
Definition: freebsd/Host.cpp:230
lldb_private::StreamGDBRemote
Definition: GDBRemote.h:25
lldb_private::Stream::AsRawOstream
llvm::raw_ostream & AsRawOstream()
Returns a raw_ostream that forwards the data to this Stream object.
Definition: Stream.h:357
lldb_private::process_gdb_remote::GDBRemoteCommunication::SendPacketNoLock
PacketResult SendPacketNoLock(llvm::StringRef payload)
Definition: GDBRemoteCommunication.cpp:114
uint16_t
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::SetPendingGdbServer
void SetPendingGdbServer(lldb::pid_t pid, uint16_t port, const std::string &socket_name)
Definition: GDBRemoteCommunicationServerPlatform.cpp:598
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::port
uint16_t port
Definition: GDBRemoteCommunicationServerPlatform.h:109
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_port_offset
uint16_t m_port_offset
Definition: GDBRemoteCommunicationServerPlatform.h:106
lldb_private::process_gdb_remote::GDBRemoteCommunicationServer::SendOKResponse
PacketResult SendOKResponse()
Definition: GDBRemoteCommunicationServer.cpp:148
lldb_private::Stream::Printf
size_t Printf(const char *format,...) __attribute__((format(printf
Output printf formatted output to the stream.
Definition: Stream.cpp:107
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::CreateProcessInfoResponse_DebugServerStyle
static void CreateProcessInfoResponse_DebugServerStyle(const ProcessInstanceInfo &proc_info, StreamString &response)
Definition: GDBRemoteCommunicationServerCommon.cpp:1236
lldb_private::LLDBLog::Platform
@ Platform
lldb_private::FileSpec::AppendPathComponent
void AppendPathComponent(llvm::StringRef component)
Definition: FileSpec.cpp:451
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::m_pending_gdb_server
struct lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::@76 m_pending_gdb_server
lldb_private
A class that represents a running process on the host machine.
Definition: SBCommandInterpreterRunOptions.h:16
lldb_private::StreamGDBRemote::PutEscapedBytes
int PutEscapedBytes(const void *s, size_t src_len)
Output a block of data to the stream performing GDB-remote escaping.
Definition: GDBRemote.cpp:28
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerCommon::m_process_launch_info
ProcessLaunchInfo m_process_launch_info
Definition: GDBRemoteCommunicationServerCommon.h:33
StringExtractorGDBRemote::eServerPacketType_qGetWorkingDir
@ eServerPacketType_qGetWorkingDir
Definition: StringExtractorGDBRemote.h:67
StringExtractorGDBRemote
Definition: StringExtractorGDBRemote.h:21
lldb_private::Communication::GetConnection
lldb_private::Connection * GetConnection()
Definition: Communication.h:87
lldb_private::Log
Definition: Log.h:115
lldb_private::Stream::PutCString
size_t PutCString(llvm::StringRef cstr)
Output a C string to the stream.
Definition: Stream.cpp:63
UriParser.h
lldb_private::GetLog
Log * GetLog(Cat mask)
Retrieve the Log object for the channel associated with the given log enum.
Definition: Log.h:309
FileAction.h
lldb_private::FileSpec::GetPath
size_t GetPath(char *path, size_t max_path_length, bool denormalize=true) const
Extract the full path to the file.
Definition: FileSpec.cpp:364
lldb_private::Host::Kill
static void Kill(lldb::pid_t pid, int signo)
Definition: common/Host.cpp:545
lldb_private::process_gdb_remote::GDBRemoteCommunicationServerPlatform::KillSpawnedProcess
bool KillSpawnedProcess(lldb::pid_t pid)
Definition: GDBRemoteCommunicationServerPlatform.cpp:333
lldb_private::Args::GetArgumentCount
size_t GetArgumentCount() const
Gets the number of arguments left in this command object.
Definition: Args.h:116
lldb_private::ConnectionFileDescriptor
Definition: ConnectionFileDescriptorPosix.h:29
lldb
Definition: SBAddress.h:15
LLDBLog.h
CommandCompletions.h
lldb_private::ProcessLaunchInfo::SetMonitorProcessCallback
void SetMonitorProcessCallback(Host::MonitorChildProcessCallback callback)
Definition: ProcessLaunchInfo.h:102
lldb_private::ProcessLaunchInfo::GetMonitorProcessCallback
const Host::MonitorChildProcessCallback & GetMonitorProcessCallback() const
Definition: ProcessLaunchInfo.h:106