1 //===-- PlatformRemoteGDBServer.cpp -----------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "lldb/lldb-python.h"
11 
12 #include "PlatformRemoteGDBServer.h"
13 #include "lldb/Host/Config.h"
14 
15 // C Includes
16 #ifndef LLDB_DISABLE_POSIX
17 #include <sys/sysctl.h>
18 #endif
19 
20 // C++ Includes
21 // Other libraries and framework includes
22 // Project includes
23 #include "lldb/Breakpoint/BreakpointLocation.h"
24 #include "lldb/Core/ConnectionFileDescriptor.h"
25 #include "lldb/Core/Debugger.h"
26 #include "lldb/Core/Error.h"
27 #include "lldb/Core/Module.h"
28 #include "lldb/Core/ModuleList.h"
29 #include "lldb/Core/PluginManager.h"
30 #include "lldb/Core/StreamString.h"
31 #include "lldb/Host/FileSpec.h"
32 #include "lldb/Host/Host.h"
33 #include "lldb/Target/Process.h"
34 #include "lldb/Target/Target.h"
35 
36 using namespace lldb;
37 using namespace lldb_private;
38 
39 static bool g_initialized = false;
40 
41 void
42 PlatformRemoteGDBServer::Initialize ()
43 {
44     if (g_initialized == false)
45     {
46         g_initialized = true;
47         PluginManager::RegisterPlugin (PlatformRemoteGDBServer::GetPluginNameStatic(),
48                                        PlatformRemoteGDBServer::GetDescriptionStatic(),
49                                        PlatformRemoteGDBServer::CreateInstance);
50     }
51 }
52 
53 void
54 PlatformRemoteGDBServer::Terminate ()
55 {
56     if (g_initialized)
57     {
58         g_initialized = false;
59         PluginManager::UnregisterPlugin (PlatformRemoteGDBServer::CreateInstance);
60     }
61 }
62 
63 Platform*
64 PlatformRemoteGDBServer::CreateInstance (bool force, const lldb_private::ArchSpec *arch)
65 {
66     bool create = force;
67     if (!create)
68     {
69         create = !arch->TripleVendorWasSpecified() && !arch->TripleOSWasSpecified();
70     }
71     if (create)
72         return new PlatformRemoteGDBServer ();
73     return NULL;
74 }
75 
76 
77 lldb_private::ConstString
78 PlatformRemoteGDBServer::GetPluginNameStatic()
79 {
80     static ConstString g_name("remote-gdb-server");
81     return g_name;
82 }
83 
84 const char *
85 PlatformRemoteGDBServer::GetDescriptionStatic()
86 {
87     return "A platform that uses the GDB remote protocol as the communication transport.";
88 }
89 
90 const char *
91 PlatformRemoteGDBServer::GetDescription ()
92 {
93     if (m_platform_description.empty())
94     {
95         if (IsConnected())
96         {
97             // Send the get description packet
98         }
99     }
100 
101     if (!m_platform_description.empty())
102         return m_platform_description.c_str();
103     return GetDescriptionStatic();
104 }
105 
106 Error
107 PlatformRemoteGDBServer::ResolveExecutable (const FileSpec &exe_file,
108                                             const ArchSpec &exe_arch,
109                                             lldb::ModuleSP &exe_module_sp,
110                                             const FileSpecList *module_search_paths_ptr)
111 {
112     Error error;
113     //error.SetErrorString ("PlatformRemoteGDBServer::ResolveExecutable() is unimplemented");
114     if (m_gdb_client.GetFileExists(exe_file))
115         return error;
116     // TODO: get the remote end to somehow resolve this file
117     error.SetErrorString("file not found on remote end");
118     return error;
119 }
120 
121 Error
122 PlatformRemoteGDBServer::GetFileWithUUID (const FileSpec &platform_file,
123                                           const UUID *uuid_ptr,
124                                           FileSpec &local_file)
125 {
126     // Default to the local case
127     local_file = platform_file;
128     return Error();
129 }
130 
131 //------------------------------------------------------------------
132 /// Default Constructor
133 //------------------------------------------------------------------
134 PlatformRemoteGDBServer::PlatformRemoteGDBServer () :
135     Platform(false), // This is a remote platform
136     m_gdb_client(true)
137 {
138 }
139 
140 //------------------------------------------------------------------
141 /// Destructor.
142 ///
143 /// The destructor is virtual since this class is designed to be
144 /// inherited from by the plug-in instance.
145 //------------------------------------------------------------------
146 PlatformRemoteGDBServer::~PlatformRemoteGDBServer()
147 {
148 }
149 
150 bool
151 PlatformRemoteGDBServer::GetSupportedArchitectureAtIndex (uint32_t idx, ArchSpec &arch)
152 {
153     return false;
154 }
155 
156 size_t
157 PlatformRemoteGDBServer::GetSoftwareBreakpointTrapOpcode (Target &target, BreakpointSite *bp_site)
158 {
159     // This isn't needed if the z/Z packets are supported in the GDB remote
160     // server. But we might need a packet to detect this.
161     return 0;
162 }
163 
164 bool
165 PlatformRemoteGDBServer::GetRemoteOSVersion ()
166 {
167     uint32_t major, minor, update;
168     if (m_gdb_client.GetOSVersion (major, minor, update))
169     {
170         m_major_os_version = major;
171         m_minor_os_version = minor;
172         m_update_os_version = update;
173         return true;
174     }
175     return false;
176 }
177 
178 bool
179 PlatformRemoteGDBServer::GetRemoteOSBuildString (std::string &s)
180 {
181     return m_gdb_client.GetOSBuildString (s);
182 }
183 
184 bool
185 PlatformRemoteGDBServer::GetRemoteOSKernelDescription (std::string &s)
186 {
187     return m_gdb_client.GetOSKernelDescription (s);
188 }
189 
190 // Remote Platform subclasses need to override this function
191 ArchSpec
192 PlatformRemoteGDBServer::GetRemoteSystemArchitecture ()
193 {
194     return m_gdb_client.GetSystemArchitecture();
195 }
196 
197 lldb_private::ConstString
198 PlatformRemoteGDBServer::GetRemoteWorkingDirectory()
199 {
200     if (IsConnected())
201     {
202         Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
203         std::string cwd;
204         if (m_gdb_client.GetWorkingDir(cwd))
205         {
206             ConstString working_dir(cwd.c_str());
207             if (log)
208                 log->Printf("PlatformRemoteGDBServer::GetRemoteWorkingDirectory() -> '%s'", working_dir.GetCString());
209             return working_dir;
210         }
211         else
212         {
213             return ConstString();
214         }
215     }
216     else
217     {
218         return Platform::GetRemoteWorkingDirectory();
219     }
220 }
221 
222 bool
223 PlatformRemoteGDBServer::SetRemoteWorkingDirectory(const lldb_private::ConstString &path)
224 {
225     if (IsConnected())
226     {
227         // Clear the working directory it case it doesn't get set correctly. This will
228         // for use to re-read it
229         Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
230         if (log)
231             log->Printf("PlatformRemoteGDBServer::SetRemoteWorkingDirectory('%s')", path.GetCString());
232         return m_gdb_client.SetWorkingDir(path.GetCString()) == 0;
233     }
234     else
235         return Platform::SetRemoteWorkingDirectory(path);
236 }
237 
238 bool
239 PlatformRemoteGDBServer::IsConnected () const
240 {
241     return m_gdb_client.IsConnected();
242 }
243 
244 Error
245 PlatformRemoteGDBServer::ConnectRemote (Args& args)
246 {
247     Error error;
248     if (IsConnected())
249     {
250         error.SetErrorStringWithFormat ("the platform is already connected to '%s', execute 'platform disconnect' to close the current connection",
251                                         GetHostname());
252     }
253     else
254     {
255         if (args.GetArgumentCount() == 1)
256         {
257             const char *url = args.GetArgumentAtIndex(0);
258             m_gdb_client.SetConnection (new ConnectionFileDescriptor());
259             const ConnectionStatus status = m_gdb_client.Connect(url, &error);
260             if (status == eConnectionStatusSuccess)
261             {
262                 if (m_gdb_client.HandshakeWithServer(&error))
263                 {
264                     m_gdb_client.GetHostInfo();
265                     // If a working directory was set prior to connecting, send it down now
266                     if (m_working_dir)
267                         m_gdb_client.SetWorkingDir(m_working_dir.GetCString());
268                 }
269                 else
270                 {
271                     m_gdb_client.Disconnect();
272                     if (error.Success())
273                         error.SetErrorString("handshake failed");
274                 }
275             }
276         }
277         else
278         {
279             error.SetErrorString ("\"platform connect\" takes a single argument: <connect-url>");
280         }
281     }
282 
283     return error;
284 }
285 
286 Error
287 PlatformRemoteGDBServer::DisconnectRemote ()
288 {
289     Error error;
290     m_gdb_client.Disconnect(&error);
291     return error;
292 }
293 
294 const char *
295 PlatformRemoteGDBServer::GetHostname ()
296 {
297     m_gdb_client.GetHostname (m_name);
298     if (m_name.empty())
299         return NULL;
300     return m_name.c_str();
301 }
302 
303 const char *
304 PlatformRemoteGDBServer::GetUserName (uint32_t uid)
305 {
306     // Try and get a cache user name first
307     const char *cached_user_name = Platform::GetUserName(uid);
308     if (cached_user_name)
309         return cached_user_name;
310     std::string name;
311     if (m_gdb_client.GetUserName(uid, name))
312         return SetCachedUserName(uid, name.c_str(), name.size());
313 
314     SetUserNameNotFound(uid); // Negative cache so we don't keep sending packets
315     return NULL;
316 }
317 
318 const char *
319 PlatformRemoteGDBServer::GetGroupName (uint32_t gid)
320 {
321     const char *cached_group_name = Platform::GetGroupName(gid);
322     if (cached_group_name)
323         return cached_group_name;
324     std::string name;
325     if (m_gdb_client.GetGroupName(gid, name))
326         return SetCachedGroupName(gid, name.c_str(), name.size());
327 
328     SetGroupNameNotFound(gid); // Negative cache so we don't keep sending packets
329     return NULL;
330 }
331 
332 uint32_t
333 PlatformRemoteGDBServer::FindProcesses (const ProcessInstanceInfoMatch &match_info,
334                                         ProcessInstanceInfoList &process_infos)
335 {
336     return m_gdb_client.FindProcesses (match_info, process_infos);
337 }
338 
339 bool
340 PlatformRemoteGDBServer::GetProcessInfo (lldb::pid_t pid, ProcessInstanceInfo &process_info)
341 {
342     return m_gdb_client.GetProcessInfo (pid, process_info);
343 }
344 
345 
346 Error
347 PlatformRemoteGDBServer::LaunchProcess (ProcessLaunchInfo &launch_info)
348 {
349     Error error;
350     lldb::pid_t pid = LLDB_INVALID_PROCESS_ID;
351 
352     m_gdb_client.SetSTDIN ("/dev/null");
353     m_gdb_client.SetSTDOUT ("/dev/null");
354     m_gdb_client.SetSTDERR ("/dev/null");
355     m_gdb_client.SetDisableASLR (launch_info.GetFlags().Test (eLaunchFlagDisableASLR));
356     m_gdb_client.SetDetachOnError (launch_info.GetFlags().Test (eLaunchFlagDetachOnError));
357 
358     const char *working_dir = launch_info.GetWorkingDirectory();
359     if (working_dir && working_dir[0])
360     {
361         m_gdb_client.SetWorkingDir (working_dir);
362     }
363 
364     // Send the environment and the program + arguments after we connect
365     const char **envp = launch_info.GetEnvironmentEntries().GetConstArgumentVector();
366 
367     if (envp)
368     {
369         const char *env_entry;
370         for (int i=0; (env_entry = envp[i]); ++i)
371         {
372             if (m_gdb_client.SendEnvironmentPacket(env_entry) != 0)
373                 break;
374         }
375     }
376 
377     ArchSpec arch_spec = launch_info.GetArchitecture();
378     const char *arch_triple = arch_spec.GetTriple().str().c_str();
379 
380     m_gdb_client.SendLaunchArchPacket(arch_triple);
381 
382     const uint32_t old_packet_timeout = m_gdb_client.SetPacketTimeout (5);
383     int arg_packet_err = m_gdb_client.SendArgumentsPacket (launch_info);
384     m_gdb_client.SetPacketTimeout (old_packet_timeout);
385     if (arg_packet_err == 0)
386     {
387         std::string error_str;
388         if (m_gdb_client.GetLaunchSuccess (error_str))
389         {
390             pid = m_gdb_client.GetCurrentProcessID ();
391             if (pid != LLDB_INVALID_PROCESS_ID)
392                 launch_info.SetProcessID (pid);
393         }
394         else
395         {
396             error.SetErrorString (error_str.c_str());
397         }
398     }
399     else
400     {
401         error.SetErrorStringWithFormat("'A' packet returned an error: %i", arg_packet_err);
402     }
403     return error;
404 }
405 
406 lldb::ProcessSP
407 PlatformRemoteGDBServer::DebugProcess (lldb_private::ProcessLaunchInfo &launch_info,
408                                        lldb_private::Debugger &debugger,
409                                        lldb_private::Target *target,       // Can be NULL, if NULL create a new target, else use existing one
410                                        lldb_private::Listener &listener,
411                                        lldb_private::Error &error)
412 {
413     lldb::ProcessSP process_sp;
414     if (IsRemote())
415     {
416         if (IsConnected())
417         {
418             lldb::pid_t debugserver_pid = LLDB_INVALID_PROCESS_ID;
419             ArchSpec remote_arch = GetRemoteSystemArchitecture();
420             llvm::Triple &remote_triple = remote_arch.GetTriple();
421             uint16_t port = 0;
422             if (remote_triple.getVendor() == llvm::Triple::Apple && remote_triple.getOS() == llvm::Triple::IOS)
423             {
424                 // When remote debugging to iOS, we use a USB mux that always talks
425                 // to localhost, so we will need the remote debugserver to accept connections
426                 // only from localhost, no matter what our current hostname is
427                 port = m_gdb_client.LaunchGDBserverAndGetPort(debugserver_pid, "127.0.0.1");
428             }
429             else
430             {
431                 // All other hosts should use their actual hostname
432                 port = m_gdb_client.LaunchGDBserverAndGetPort(debugserver_pid, NULL);
433             }
434 
435             if (port == 0)
436             {
437                 error.SetErrorStringWithFormat ("unable to launch a GDB server on '%s'", GetHostname ());
438             }
439             else
440             {
441                 if (target == NULL)
442                 {
443                     TargetSP new_target_sp;
444 
445                     error = debugger.GetTargetList().CreateTarget (debugger,
446                                                                    NULL,
447                                                                    NULL,
448                                                                    false,
449                                                                    NULL,
450                                                                    new_target_sp);
451                     target = new_target_sp.get();
452                 }
453                 else
454                     error.Clear();
455 
456                 if (target && error.Success())
457                 {
458                     debugger.GetTargetList().SetSelectedTarget(target);
459 
460                     // The darwin always currently uses the GDB remote debugger plug-in
461                     // so even when debugging locally we are debugging remotely!
462                     process_sp = target->CreateProcess (listener, "gdb-remote", NULL);
463 
464                     if (process_sp)
465                     {
466                         char connect_url[256];
467                         const char *override_hostname = getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_HOSTNAME");
468                         const char *port_offset_c_str = getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_PORT_OFFSET");
469                         int port_offset = port_offset_c_str ? ::atoi(port_offset_c_str) : 0;
470                         const int connect_url_len = ::snprintf (connect_url,
471                                                                 sizeof(connect_url),
472                                                                 "connect://%s:%u",
473                                                                 override_hostname ? override_hostname : GetHostname (),
474                                                                 port + port_offset);
475                         assert (connect_url_len < (int)sizeof(connect_url));
476                         error = process_sp->ConnectRemote (NULL, connect_url);
477                         if (error.Success())
478                             error = process_sp->Launch(launch_info);
479                         else if (debugserver_pid != LLDB_INVALID_PROCESS_ID)
480                             m_gdb_client.KillSpawnedProcess(debugserver_pid);
481                     }
482                 }
483             }
484         }
485         else
486         {
487             error.SetErrorString("not connected to remote gdb server");
488         }
489     }
490     return process_sp;
491 
492 }
493 
494 lldb::ProcessSP
495 PlatformRemoteGDBServer::Attach (lldb_private::ProcessAttachInfo &attach_info,
496                                  Debugger &debugger,
497                                  Target *target,       // Can be NULL, if NULL create a new target, else use existing one
498                                  Listener &listener,
499                                  Error &error)
500 {
501     lldb::ProcessSP process_sp;
502     if (IsRemote())
503     {
504         if (IsConnected())
505         {
506             lldb::pid_t debugserver_pid = LLDB_INVALID_PROCESS_ID;
507             ArchSpec remote_arch = GetRemoteSystemArchitecture();
508             llvm::Triple &remote_triple = remote_arch.GetTriple();
509             uint16_t port = 0;
510             if (remote_triple.getVendor() == llvm::Triple::Apple && remote_triple.getOS() == llvm::Triple::IOS)
511             {
512                 // When remote debugging to iOS, we use a USB mux that always talks
513                 // to localhost, so we will need the remote debugserver to accept connections
514                 // only from localhost, no matter what our current hostname is
515                 port = m_gdb_client.LaunchGDBserverAndGetPort(debugserver_pid, "127.0.0.1");
516             }
517             else
518             {
519                 // All other hosts should use their actual hostname
520                 port = m_gdb_client.LaunchGDBserverAndGetPort(debugserver_pid, NULL);
521             }
522 
523             if (port == 0)
524             {
525                 error.SetErrorStringWithFormat ("unable to launch a GDB server on '%s'", GetHostname ());
526             }
527             else
528             {
529                 if (target == NULL)
530                 {
531                     TargetSP new_target_sp;
532 
533                     error = debugger.GetTargetList().CreateTarget (debugger,
534                                                                    NULL,
535                                                                    NULL,
536                                                                    false,
537                                                                    NULL,
538                                                                    new_target_sp);
539                     target = new_target_sp.get();
540                 }
541                 else
542                     error.Clear();
543 
544                 if (target && error.Success())
545                 {
546                     debugger.GetTargetList().SetSelectedTarget(target);
547 
548                     // The darwin always currently uses the GDB remote debugger plug-in
549                     // so even when debugging locally we are debugging remotely!
550                     process_sp = target->CreateProcess (listener, "gdb-remote", NULL);
551 
552                     if (process_sp)
553                     {
554                         char connect_url[256];
555                         const char *override_hostname = getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_HOSTNAME");
556                         const char *port_offset_c_str = getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_PORT_OFFSET");
557                         int port_offset = port_offset_c_str ? ::atoi(port_offset_c_str) : 0;
558                         const int connect_url_len = ::snprintf (connect_url,
559                                                                 sizeof(connect_url),
560                                                                 "connect://%s:%u",
561                                                                 override_hostname ? override_hostname : GetHostname (),
562                                                                 port + port_offset);
563                         assert (connect_url_len < (int)sizeof(connect_url));
564                         error = process_sp->ConnectRemote (NULL, connect_url);
565                         if (error.Success())
566                             error = process_sp->Attach(attach_info);
567                         else if (debugserver_pid != LLDB_INVALID_PROCESS_ID)
568                         {
569                             m_gdb_client.KillSpawnedProcess(debugserver_pid);
570                         }
571                     }
572                 }
573             }
574         }
575         else
576         {
577             error.SetErrorString("not connected to remote gdb server");
578         }
579     }
580     return process_sp;
581 }
582 
583 Error
584 PlatformRemoteGDBServer::MakeDirectory (const char *path, uint32_t mode)
585 {
586     Error error = m_gdb_client.MakeDirectory(path,mode);
587     Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
588     if (log)
589         log->Printf ("PlatformRemoteGDBServer::MakeDirectory(path='%s', mode=%o) error = %u (%s)", path, mode, error.GetError(), error.AsCString());
590     return error;
591 }
592 
593 
594 Error
595 PlatformRemoteGDBServer::GetFilePermissions (const char *path, uint32_t &file_permissions)
596 {
597     Error error = m_gdb_client.GetFilePermissions(path, file_permissions);
598     Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
599     if (log)
600         log->Printf ("PlatformRemoteGDBServer::GetFilePermissions(path='%s', file_permissions=%o) error = %u (%s)", path, file_permissions, error.GetError(), error.AsCString());
601     return error;
602 }
603 
604 Error
605 PlatformRemoteGDBServer::SetFilePermissions (const char *path, uint32_t file_permissions)
606 {
607     Error error = m_gdb_client.SetFilePermissions(path, file_permissions);
608     Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
609     if (log)
610         log->Printf ("PlatformRemoteGDBServer::SetFilePermissions(path='%s', file_permissions=%o) error = %u (%s)", path, file_permissions, error.GetError(), error.AsCString());
611     return error;
612 }
613 
614 
615 lldb::user_id_t
616 PlatformRemoteGDBServer::OpenFile (const lldb_private::FileSpec& file_spec,
617                                    uint32_t flags,
618                                    uint32_t mode,
619                                    Error &error)
620 {
621     return m_gdb_client.OpenFile (file_spec, flags, mode, error);
622 }
623 
624 bool
625 PlatformRemoteGDBServer::CloseFile (lldb::user_id_t fd, Error &error)
626 {
627     return m_gdb_client.CloseFile (fd, error);
628 }
629 
630 lldb::user_id_t
631 PlatformRemoteGDBServer::GetFileSize (const lldb_private::FileSpec& file_spec)
632 {
633     return m_gdb_client.GetFileSize(file_spec);
634 }
635 
636 uint64_t
637 PlatformRemoteGDBServer::ReadFile (lldb::user_id_t fd,
638                                    uint64_t offset,
639                                    void *dst,
640                                    uint64_t dst_len,
641                                    Error &error)
642 {
643     return m_gdb_client.ReadFile (fd, offset, dst, dst_len, error);
644 }
645 
646 uint64_t
647 PlatformRemoteGDBServer::WriteFile (lldb::user_id_t fd,
648                                     uint64_t offset,
649                                     const void* src,
650                                     uint64_t src_len,
651                                     Error &error)
652 {
653     return m_gdb_client.WriteFile (fd, offset, src, src_len, error);
654 }
655 
656 lldb_private::Error
657 PlatformRemoteGDBServer::PutFile (const lldb_private::FileSpec& source,
658          const lldb_private::FileSpec& destination,
659          uint32_t uid,
660          uint32_t gid)
661 {
662     return Platform::PutFile(source,destination,uid,gid);
663 }
664 
665 Error
666 PlatformRemoteGDBServer::CreateSymlink (const char *src,    // The name of the link is in src
667                                         const char *dst)    // The symlink points to dst
668 {
669     Error error = m_gdb_client.CreateSymlink (src, dst);
670     Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
671     if (log)
672         log->Printf ("PlatformRemoteGDBServer::CreateSymlink(src='%s', dst='%s') error = %u (%s)", src, dst, error.GetError(), error.AsCString());
673     return error;
674 }
675 
676 Error
677 PlatformRemoteGDBServer::Unlink (const char *path)
678 {
679     Error error = m_gdb_client.Unlink (path);
680     Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
681     if (log)
682         log->Printf ("PlatformRemoteGDBServer::Unlink(path='%s') error = %u (%s)", path, error.GetError(), error.AsCString());
683     return error;
684 }
685 
686 bool
687 PlatformRemoteGDBServer::GetFileExists (const lldb_private::FileSpec& file_spec)
688 {
689     return m_gdb_client.GetFileExists (file_spec);
690 }
691 
692 lldb_private::Error
693 PlatformRemoteGDBServer::RunShellCommand (const char *command,           // Shouldn't be NULL
694                                           const char *working_dir,       // Pass NULL to use the current working directory
695                                           int *status_ptr,               // Pass NULL if you don't want the process exit status
696                                           int *signo_ptr,                // Pass NULL if you don't want the signal that caused the process to exit
697                                           std::string *command_output,   // Pass NULL if you don't want the command output
698                                           uint32_t timeout_sec)          // Timeout in seconds to wait for shell program to finish
699 {
700     return m_gdb_client.RunShellCommand (command, working_dir, status_ptr, signo_ptr, command_output, timeout_sec);
701 }
702 
703 void
704 PlatformRemoteGDBServer::CalculateTrapHandlerSymbolNames ()
705 {
706     m_trap_handlers.push_back (ConstString ("_sigtramp"));
707 }
708