1 //===-- debugserver.cpp -----------------------------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #include <sys/socket.h>
11 #include <sys/types.h>
14 #include <netinet/in.h>
15 #include <sys/select.h>
16 #include <sys/sysctl.h>
20 #include <arpa/inet.h>
22 #include <netinet/in.h>
23 #include <netinet/tcp.h>
25 #include <sys/types.h>
26 #include <crt_externs.h> // for _NSGetEnviron()
28 #if defined (__APPLE__)
30 extern "C" int proc_set_wakemon_params(pid_t, int, int); // <libproc_internal.h> SPI
37 #include "PseudoTerminal.h"
38 #include "RNBContext.h"
39 #include "RNBServices.h"
40 #include "RNBSocket.h"
41 #include "RNBRemote.h"
42 #include "SysSignal.h"
44 // Global PID in case we get a signal and need to stop the process...
45 nub_process_t g_pid = INVALID_NUB_PROCESS;
47 //----------------------------------------------------------------------
48 // Run loop modes which determine which run loop function will be called
49 //----------------------------------------------------------------------
52 eRNBRunLoopModeInvalid = 0,
53 eRNBRunLoopModeGetStartModeFromRemoteProtocol,
54 eRNBRunLoopModeInferiorAttaching,
55 eRNBRunLoopModeInferiorLaunching,
56 eRNBRunLoopModeInferiorExecuting,
57 eRNBRunLoopModePlatformMode,
62 //----------------------------------------------------------------------
64 //----------------------------------------------------------------------
65 RNBRemoteSP g_remoteSP;
66 static int g_lockdown_opt = 0;
67 static int g_applist_opt = 0;
68 static nub_launch_flavor_t g_launch_flavor = eLaunchFlavorDefault;
69 int g_disable_aslr = 0;
72 bool g_detach_on_error = true;
74 #define RNBLogSTDOUT(fmt, ...) do { if (g_isatty) { fprintf(stdout, fmt, ## __VA_ARGS__); } else { _DNBLog(0, fmt, ## __VA_ARGS__); } } while (0)
75 #define RNBLogSTDERR(fmt, ...) do { if (g_isatty) { fprintf(stderr, fmt, ## __VA_ARGS__); } else { _DNBLog(0, fmt, ## __VA_ARGS__); } } while (0)
77 //----------------------------------------------------------------------
78 // Get our program path and arguments from the remote connection.
79 // We will need to start up the remote connection without a PID, get the
80 // arguments, wait for the new process to finish launching and hit its
81 // entry point, and then return the run loop mode that should come next.
82 //----------------------------------------------------------------------
84 RNBRunLoopGetStartModeFromRemote (RNBRemote* remote)
90 RNBContext& ctx = remote->Context();
91 uint32_t event_mask = RNBContext::event_read_packet_available |
92 RNBContext::event_read_thread_exiting;
94 // Spin waiting to get the A packet.
97 DNBLogThreadedIf (LOG_RNB_MAX, "%s ctx.Events().WaitForSetEvents( 0x%08x ) ...",__FUNCTION__, event_mask);
98 nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
99 DNBLogThreadedIf (LOG_RNB_MAX, "%s ctx.Events().WaitForSetEvents( 0x%08x ) => 0x%08x", __FUNCTION__, event_mask, set_events);
101 if (set_events & RNBContext::event_read_thread_exiting)
103 RNBLogSTDERR ("error: packet read thread exited.\n");
104 return eRNBRunLoopModeExit;
107 if (set_events & RNBContext::event_read_packet_available)
109 rnb_err_t err = rnb_err;
110 RNBRemote::PacketEnum type;
112 err = remote->HandleReceivedPacket (&type);
114 // check if we tried to attach to a process
115 if (type == RNBRemote::vattach || type == RNBRemote::vattachwait || type == RNBRemote::vattachorwait)
117 if (err == rnb_success)
119 RNBLogSTDOUT ("Attach succeeded, ready to debug.\n");
120 return eRNBRunLoopModeInferiorExecuting;
124 RNBLogSTDERR ("error: attach failed.\n");
125 return eRNBRunLoopModeExit;
129 if (err == rnb_success)
131 // If we got our arguments we are ready to launch using the arguments
132 // and any environment variables we received.
133 if (type == RNBRemote::set_argv)
135 return eRNBRunLoopModeInferiorLaunching;
138 else if (err == rnb_not_connected)
140 RNBLogSTDERR ("error: connection lost.\n");
141 return eRNBRunLoopModeExit;
145 // a catch all for any other gdb remote packets that failed
146 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Error getting packet.",__FUNCTION__);
150 DNBLogThreadedIf (LOG_RNB_MINIMAL, "#### %s", __FUNCTION__);
154 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Connection closed before getting \"A\" packet.", __FUNCTION__);
155 return eRNBRunLoopModeExit;
159 return eRNBRunLoopModeExit;
163 //----------------------------------------------------------------------
164 // This run loop mode will wait for the process to launch and hit its
165 // entry point. It will currently ignore all events except for the
166 // process state changed event, where it watches for the process stopped
167 // or crash process state.
168 //----------------------------------------------------------------------
170 RNBRunLoopLaunchInferior (RNBRemote *remote, const char *stdin_path, const char *stdout_path, const char *stderr_path, bool no_stdio)
172 RNBContext& ctx = remote->Context();
174 // The Process stuff takes a c array, the RNBContext has a vector...
175 // So make up a c array.
177 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Launching '%s'...", __FUNCTION__, ctx.ArgumentAtIndex(0));
179 size_t inferior_argc = ctx.ArgumentCount();
180 // Initialize inferior_argv with inferior_argc + 1 NULLs
181 std::vector<const char *> inferior_argv(inferior_argc + 1, NULL);
184 for (i = 0; i < inferior_argc; i++)
185 inferior_argv[i] = ctx.ArgumentAtIndex(i);
187 // Pass the environment array the same way:
189 size_t inferior_envc = ctx.EnvironmentCount();
190 // Initialize inferior_argv with inferior_argc + 1 NULLs
191 std::vector<const char *> inferior_envp(inferior_envc + 1, NULL);
193 for (i = 0; i < inferior_envc; i++)
194 inferior_envp[i] = ctx.EnvironmentAtIndex(i);
196 // Our launch type hasn't been set to anything concrete, so we need to
197 // figure our how we are going to launch automatically.
199 nub_launch_flavor_t launch_flavor = g_launch_flavor;
200 if (launch_flavor == eLaunchFlavorDefault)
202 // Our default launch method is posix spawn
203 launch_flavor = eLaunchFlavorPosixSpawn;
206 // Check if we have an app bundle, if so launch using BackBoard Services.
207 if (strstr(inferior_argv[0], ".app"))
209 launch_flavor = eLaunchFlavorFBS;
211 #elif defined WITH_BKS
212 // Check if we have an app bundle, if so launch using BackBoard Services.
213 if (strstr(inferior_argv[0], ".app"))
215 launch_flavor = eLaunchFlavorBKS;
217 #elif defined WITH_SPRINGBOARD
218 // Check if we have an app bundle, if so launch using SpringBoard.
219 if (strstr(inferior_argv[0], ".app"))
221 launch_flavor = eLaunchFlavorSpringBoard;
226 ctx.SetLaunchFlavor(launch_flavor);
227 char resolved_path[PATH_MAX];
229 // If we fail to resolve the path to our executable, then just use what we
230 // were given and hope for the best
231 if ( !DNBResolveExecutablePath (inferior_argv[0], resolved_path, sizeof(resolved_path)) )
232 ::strncpy(resolved_path, inferior_argv[0], sizeof(resolved_path));
234 char launch_err_str[PATH_MAX];
235 launch_err_str[0] = '\0';
236 const char * cwd = (ctx.GetWorkingDirPath() != NULL ? ctx.GetWorkingDirPath()
237 : ctx.GetWorkingDirectory());
238 const char *process_event = ctx.GetProcessEvent();
239 nub_process_t pid = DNBProcessLaunch (resolved_path,
251 sizeof(launch_err_str));
255 if (pid == INVALID_NUB_PROCESS && strlen (launch_err_str) > 0)
257 DNBLogThreaded ("%s DNBProcessLaunch() returned error: '%s'", __FUNCTION__, launch_err_str);
258 ctx.LaunchStatus().SetError(-1, DNBError::Generic);
259 ctx.LaunchStatus().SetErrorString(launch_err_str);
261 else if (pid == INVALID_NUB_PROCESS)
263 DNBLogThreaded ("%s DNBProcessLaunch() failed to launch process, unknown failure", __FUNCTION__);
264 ctx.LaunchStatus().SetError(-1, DNBError::Generic);
265 ctx.LaunchStatus().SetErrorString("<unknown failure>");
269 ctx.LaunchStatus().Clear();
272 if (remote->Comm().IsConnected())
274 // It we are connected already, the next thing gdb will do is ask
275 // whether the launch succeeded, and if not, whether there is an
276 // error code. So we need to fetch one packet from gdb before we wait
277 // on the stop from the target.
279 uint32_t event_mask = RNBContext::event_read_packet_available;
280 nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
282 if (set_events & RNBContext::event_read_packet_available)
284 rnb_err_t err = rnb_err;
285 RNBRemote::PacketEnum type;
287 err = remote->HandleReceivedPacket (&type);
289 if (err != rnb_success)
291 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Error getting packet.", __FUNCTION__);
292 return eRNBRunLoopModeExit;
294 if (type != RNBRemote::query_launch_success)
296 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Didn't get the expected qLaunchSuccess packet.", __FUNCTION__);
301 while (pid != INVALID_NUB_PROCESS)
303 // Wait for process to start up and hit entry point
304 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s DNBProcessWaitForEvent (%4.4x, eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged, true, INFINITE)...", __FUNCTION__, pid);
305 nub_event_t set_events = DNBProcessWaitForEvents (pid, eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged, true, NULL);
306 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s DNBProcessWaitForEvent (%4.4x, eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged, true, INFINITE) => 0x%8.8x", __FUNCTION__, pid, set_events);
310 pid = INVALID_NUB_PROCESS;
315 if (set_events & (eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged))
317 nub_state_t pid_state = DNBProcessGetState (pid);
318 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s process %4.4x state changed (eEventProcessStateChanged): %s", __FUNCTION__, pid, DNBStateAsString(pid_state));
324 case eStateAttaching:
325 case eStateLaunching:
326 case eStateSuspended:
331 // Still waiting to stop at entry point...
336 ctx.SetProcessID(pid);
337 return eRNBRunLoopModeInferiorExecuting;
341 pid = INVALID_NUB_PROCESS;
343 return eRNBRunLoopModeExit;
347 DNBProcessResetEvents(pid, set_events);
351 return eRNBRunLoopModeExit;
355 //----------------------------------------------------------------------
356 // This run loop mode will wait for the process to launch and hit its
357 // entry point. It will currently ignore all events except for the
358 // process state changed event, where it watches for the process stopped
359 // or crash process state.
360 //----------------------------------------------------------------------
362 RNBRunLoopLaunchAttaching (RNBRemote *remote, nub_process_t attach_pid, nub_process_t& pid)
364 RNBContext& ctx = remote->Context();
366 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Attaching to pid %i...", __FUNCTION__, attach_pid);
368 pid = DNBProcessAttach (attach_pid, NULL, err_str, sizeof(err_str));
371 if (pid == INVALID_NUB_PROCESS)
373 ctx.LaunchStatus().SetError(-1, DNBError::Generic);
375 ctx.LaunchStatus().SetErrorString(err_str);
376 return eRNBRunLoopModeExit;
380 ctx.SetProcessID(pid);
381 return eRNBRunLoopModeInferiorExecuting;
385 //----------------------------------------------------------------------
386 // Watch for signals:
387 // SIGINT: so we can halt our inferior. (disabled for now)
388 // SIGPIPE: in case our child process dies
389 //----------------------------------------------------------------------
390 int g_sigint_received = 0;
391 int g_sigpipe_received = 0;
393 signal_handler(int signo)
395 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (%s)", __FUNCTION__, SysSignal::Name(signo));
401 if (g_pid != INVALID_NUB_PROCESS)
403 // Only send a SIGINT once...
404 if (g_sigint_received == 1)
406 switch (DNBProcessGetState (g_pid))
410 DNBProcessSignal (g_pid, SIGSTOP);
421 g_sigpipe_received = 1;
426 // Return the new run loop mode based off of the current process state
428 HandleProcessStateChange (RNBRemote *remote, bool initialize)
430 RNBContext& ctx = remote->Context();
431 nub_process_t pid = ctx.ProcessID();
433 if (pid == INVALID_NUB_PROCESS)
435 DNBLogThreadedIf (LOG_RNB_MINIMAL, "#### %s error: pid invalid, exiting...", __FUNCTION__);
436 return eRNBRunLoopModeExit;
438 nub_state_t pid_state = DNBProcessGetState (pid);
440 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (&remote, initialize=%i) pid_state = %s", __FUNCTION__, (int)initialize, DNBStateAsString (pid_state));
446 // Something bad happened
447 return eRNBRunLoopModeExit;
450 case eStateAttaching:
451 case eStateLaunching:
452 return eRNBRunLoopModeInferiorExecuting;
454 case eStateSuspended:
457 // If we stop due to a signal, so clear the fact that we got a SIGINT
458 // so we can stop ourselves again (but only while our inferior
459 // process is running..)
460 g_sigint_received = 0;
461 if (initialize == false)
463 // Compare the last stop count to our current notion of a stop count
464 // to make sure we don't notify more than once for a given stop.
465 nub_size_t prev_pid_stop_count = ctx.GetProcessStopCount();
466 bool pid_stop_count_changed = ctx.SetProcessStopCount(DNBProcessGetStopCount(pid));
467 if (pid_stop_count_changed)
469 remote->FlushSTDIO();
471 if (ctx.GetProcessStopCount() == 1)
473 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (&remote, initialize=%i) pid_state = %s pid_stop_count %llu (old %llu)) Notify??? no, first stop...", __FUNCTION__, (int)initialize, DNBStateAsString (pid_state), (uint64_t)ctx.GetProcessStopCount(), (uint64_t)prev_pid_stop_count);
478 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (&remote, initialize=%i) pid_state = %s pid_stop_count %llu (old %llu)) Notify??? YES!!!", __FUNCTION__, (int)initialize, DNBStateAsString (pid_state), (uint64_t)ctx.GetProcessStopCount(), (uint64_t)prev_pid_stop_count);
479 remote->NotifyThatProcessStopped ();
484 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (&remote, initialize=%i) pid_state = %s pid_stop_count %llu (old %llu)) Notify??? skipping...", __FUNCTION__, (int)initialize, DNBStateAsString (pid_state), (uint64_t)ctx.GetProcessStopCount(), (uint64_t)prev_pid_stop_count);
487 return eRNBRunLoopModeInferiorExecuting;
491 return eRNBRunLoopModeInferiorExecuting;
494 remote->HandlePacket_last_signal(NULL);
496 return eRNBRunLoopModeExit;
501 return eRNBRunLoopModeExit;
503 // This function handles the case where our inferior program is stopped and
504 // we are waiting for gdb remote protocol packets. When a packet occurs that
505 // makes the inferior run, we need to leave this function with a new state
506 // as the return code.
508 RNBRunLoopInferiorExecuting (RNBRemote *remote)
510 DNBLogThreadedIf (LOG_RNB_MINIMAL, "#### %s", __FUNCTION__);
511 RNBContext& ctx = remote->Context();
513 // Init our mode and set 'is_running' based on the current process state
514 RNBRunLoopMode mode = HandleProcessStateChange (remote, true);
516 while (ctx.ProcessID() != INVALID_NUB_PROCESS)
519 std::string set_events_str;
520 uint32_t event_mask = ctx.NormalEventBits();
522 if (!ctx.ProcessStateRunning())
524 // Clear some bits if we are not running so we don't send any async packets
525 event_mask &= ~RNBContext::event_proc_stdio_available;
526 event_mask &= ~RNBContext::event_proc_profile_data;
529 // We want to make sure we consume all process state changes and have
530 // whomever is notifying us to wait for us to reset the event bit before
532 //ctx.Events().SetResetAckMask (RNBContext::event_proc_state_changed);
534 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s ctx.Events().WaitForSetEvents(0x%08x) ...",__FUNCTION__, event_mask);
535 nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
536 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s ctx.Events().WaitForSetEvents(0x%08x) => 0x%08x (%s)",__FUNCTION__, event_mask, set_events, ctx.EventsAsString(set_events, set_events_str));
540 if ((set_events & RNBContext::event_proc_thread_exiting) ||
541 (set_events & RNBContext::event_proc_stdio_available))
543 remote->FlushSTDIO();
546 if (set_events & RNBContext::event_proc_profile_data)
548 remote->SendAsyncProfileData();
551 if (set_events & RNBContext::event_read_packet_available)
553 // handleReceivedPacket will take care of resetting the
554 // event_read_packet_available events when there are no more...
555 set_events ^= RNBContext::event_read_packet_available;
557 if (ctx.ProcessStateRunning())
559 if (remote->HandleAsyncPacket() == rnb_not_connected)
561 // TODO: connect again? Exit?
566 if (remote->HandleReceivedPacket() == rnb_not_connected)
568 // TODO: connect again? Exit?
573 if (set_events & RNBContext::event_proc_state_changed)
575 mode = HandleProcessStateChange (remote, false);
576 ctx.Events().ResetEvents(RNBContext::event_proc_state_changed);
577 set_events ^= RNBContext::event_proc_state_changed;
580 if (set_events & RNBContext::event_proc_thread_exiting)
582 mode = eRNBRunLoopModeExit;
585 if (set_events & RNBContext::event_read_thread_exiting)
587 // Out remote packet receiving thread exited, exit for now.
588 if (ctx.HasValidProcessID())
590 // TODO: We should add code that will leave the current process
591 // in its current state and listen for another connection...
592 if (ctx.ProcessStateRunning())
594 if (ctx.GetDetachOnError())
596 DNBLog ("debugserver's event read thread is exiting, detaching from the inferior process.");
597 DNBProcessDetach (ctx.ProcessID());
601 DNBLog ("debugserver's event read thread is exiting, killing the inferior process.");
602 DNBProcessKill (ctx.ProcessID());
607 if (ctx.GetDetachOnError())
609 DNBLog ("debugserver's event read thread is exiting, detaching from the inferior process.");
610 DNBProcessDetach (ctx.ProcessID());
614 mode = eRNBRunLoopModeExit;
618 // Reset all event bits that weren't reset for now...
620 ctx.Events().ResetEvents(set_events);
622 if (mode != eRNBRunLoopModeInferiorExecuting)
631 RNBRunLoopPlatform (RNBRemote *remote)
633 RNBRunLoopMode mode = eRNBRunLoopModePlatformMode;
634 RNBContext& ctx = remote->Context();
636 while (mode == eRNBRunLoopModePlatformMode)
638 std::string set_events_str;
639 const uint32_t event_mask = RNBContext::event_read_packet_available |
640 RNBContext::event_read_thread_exiting;
642 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s ctx.Events().WaitForSetEvents(0x%08x) ...",__FUNCTION__, event_mask);
643 nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
644 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s ctx.Events().WaitForSetEvents(0x%08x) => 0x%08x (%s)",__FUNCTION__, event_mask, set_events, ctx.EventsAsString(set_events, set_events_str));
648 if (set_events & RNBContext::event_read_packet_available)
650 if (remote->HandleReceivedPacket() == rnb_not_connected)
651 mode = eRNBRunLoopModeExit;
654 if (set_events & RNBContext::event_read_thread_exiting)
656 mode = eRNBRunLoopModeExit;
658 ctx.Events().ResetEvents(set_events);
661 return eRNBRunLoopModeExit;
664 //----------------------------------------------------------------------
665 // Convenience function to set up the remote listening port
666 // Returns 1 for success 0 for failure.
667 //----------------------------------------------------------------------
670 PortWasBoundCallbackUnixSocket (const void *baton, in_port_t port)
672 //::printf ("PortWasBoundCallbackUnixSocket (baton = %p, port = %u)\n", baton, port);
674 const char *unix_socket_name = (const char *)baton;
676 if (unix_socket_name && unix_socket_name[0])
678 // We were given a unix socket name to use to communicate the port
679 // that we ended up binding to back to our parent process
680 struct sockaddr_un saddr_un;
681 int s = ::socket (AF_UNIX, SOCK_STREAM, 0);
684 perror("error: socket (AF_UNIX, SOCK_STREAM, 0)");
688 saddr_un.sun_family = AF_UNIX;
689 ::strncpy(saddr_un.sun_path, unix_socket_name, sizeof(saddr_un.sun_path) - 1);
690 saddr_un.sun_path[sizeof(saddr_un.sun_path) - 1] = '\0';
691 saddr_un.sun_len = SUN_LEN (&saddr_un);
693 if (::connect (s, (struct sockaddr *)&saddr_un, static_cast<socklen_t>(SUN_LEN (&saddr_un))) < 0)
695 perror("error: connect (socket, &saddr_un, saddr_un_len)");
699 //::printf ("connect () sucess!!\n");
702 // We were able to connect to the socket, now write our PID so whomever
703 // launched us will know this process's ID
704 RNBLogSTDOUT ("Listening to port %i...\n", port);
707 const int pid_str_len = ::snprintf (pid_str, sizeof(pid_str), "%u", port);
708 const ssize_t bytes_sent = ::send (s, pid_str, pid_str_len, 0);
710 if (pid_str_len != bytes_sent)
712 perror("error: send (s, pid_str, pid_str_len, 0)");
716 //::printf ("send () sucess!!\n");
718 // We are done with the socket
724 PortWasBoundCallbackNamedPipe (const void *baton, uint16_t port)
726 const char *named_pipe = (const char *)baton;
727 if (named_pipe && named_pipe[0])
729 int fd = ::open(named_pipe, O_WRONLY);
733 const ssize_t port_str_len = ::snprintf (port_str, sizeof(port_str), "%u", port);
734 // Write the port number as a C string with the NULL terminator
735 ::write (fd, port_str, port_str_len + 1);
742 ConnectRemote (RNBRemote *remote,
745 bool reverse_connect,
746 const char *named_pipe_path,
747 const char *unix_socket_name)
749 if (!remote->Comm().IsConnected())
755 DNBLogThreaded("error: invalid port supplied for reverse connection: %i.\n", port);
758 if (remote->Comm().Connect(host, port) != rnb_success)
760 DNBLogThreaded("Failed to reverse connect to %s:%i.\n", host, port);
767 RNBLogSTDOUT ("Listening to port %i for a connection from %s...\n", port, host ? host : "127.0.0.1");
768 if (unix_socket_name && unix_socket_name[0])
770 if (remote->Comm().Listen(host, port, PortWasBoundCallbackUnixSocket, unix_socket_name) != rnb_success)
772 RNBLogSTDERR ("Failed to get connection from a remote gdb process.\n");
778 if (remote->Comm().Listen(host, port, PortWasBoundCallbackNamedPipe, named_pipe_path) != rnb_success)
780 RNBLogSTDERR ("Failed to get connection from a remote gdb process.\n");
785 remote->StartReadRemoteDataThread();
790 //----------------------------------------------------------------------
791 // ASL Logging callback that can be registered with DNBLogSetLogCallback
792 //----------------------------------------------------------------------
794 ASLLogCallback(void *baton, uint32_t flags, const char *format, va_list args)
798 static aslmsg g_aslmsg = NULL;
799 if (g_aslmsg == NULL)
801 g_aslmsg = ::asl_new (ASL_TYPE_MSG);
802 char asl_key_sender[PATH_MAX];
803 snprintf(asl_key_sender, sizeof(asl_key_sender), "com.apple.%s-%s", DEBUGSERVER_PROGRAM_NAME, DEBUGSERVER_VERSION_STR);
804 ::asl_set (g_aslmsg, ASL_KEY_SENDER, asl_key_sender);
808 if (flags & DNBLOG_FLAG_FATAL) asl_level = ASL_LEVEL_CRIT;
809 else if (flags & DNBLOG_FLAG_ERROR) asl_level = ASL_LEVEL_ERR;
810 else if (flags & DNBLOG_FLAG_WARNING) asl_level = ASL_LEVEL_WARNING;
811 else if (flags & DNBLOG_FLAG_VERBOSE) asl_level = ASL_LEVEL_WARNING; //ASL_LEVEL_INFO;
812 else asl_level = ASL_LEVEL_WARNING; //ASL_LEVEL_DEBUG;
814 ::asl_vlog (NULL, g_aslmsg, asl_level, format, args);
817 //----------------------------------------------------------------------
818 // FILE based Logging callback that can be registered with
819 // DNBLogSetLogCallback
820 //----------------------------------------------------------------------
822 FileLogCallback(void *baton, uint32_t flags, const char *format, va_list args)
824 if (baton == NULL || format == NULL)
827 ::vfprintf ((FILE *)baton, format, args);
828 ::fprintf ((FILE *)baton, "\n");
833 show_usage_and_exit (int exit_code)
835 RNBLogSTDERR ("Usage:\n %s host:port [program-name program-arg1 program-arg2 ...]\n", DEBUGSERVER_PROGRAM_NAME);
836 RNBLogSTDERR (" %s /path/file [program-name program-arg1 program-arg2 ...]\n", DEBUGSERVER_PROGRAM_NAME);
837 RNBLogSTDERR (" %s host:port --attach=<pid>\n", DEBUGSERVER_PROGRAM_NAME);
838 RNBLogSTDERR (" %s /path/file --attach=<pid>\n", DEBUGSERVER_PROGRAM_NAME);
839 RNBLogSTDERR (" %s host:port --attach=<process_name>\n", DEBUGSERVER_PROGRAM_NAME);
840 RNBLogSTDERR (" %s /path/file --attach=<process_name>\n", DEBUGSERVER_PROGRAM_NAME);
845 //----------------------------------------------------------------------
846 // option descriptors for getopt_long_only()
847 //----------------------------------------------------------------------
848 static struct option g_long_options[] =
850 { "attach", required_argument, NULL, 'a' },
851 { "arch", required_argument, NULL, 'A' },
852 { "debug", no_argument, NULL, 'g' },
853 { "kill-on-error", no_argument, NULL, 'K' },
854 { "verbose", no_argument, NULL, 'v' },
855 { "lockdown", no_argument, &g_lockdown_opt, 1 }, // short option "-k"
856 { "applist", no_argument, &g_applist_opt, 1 }, // short option "-t"
857 { "log-file", required_argument, NULL, 'l' },
858 { "log-flags", required_argument, NULL, 'f' },
859 { "launch", required_argument, NULL, 'x' }, // Valid values are "auto", "posix-spawn", "fork-exec", "springboard" (arm only)
860 { "waitfor", required_argument, NULL, 'w' }, // Wait for a process whose name starts with ARG
861 { "waitfor-interval", required_argument, NULL, 'i' }, // Time in usecs to wait between sampling the pid list when waiting for a process by name
862 { "waitfor-duration", required_argument, NULL, 'd' }, // The time in seconds to wait for a process to show up by name
863 { "native-regs", no_argument, NULL, 'r' }, // Specify to use the native registers instead of the gdb defaults for the architecture.
864 { "stdio-path", required_argument, NULL, 's' }, // Set the STDIO path to be used when launching applications (STDIN, STDOUT and STDERR) (only if debugserver launches the process)
865 { "stdin-path", required_argument, NULL, 'I' }, // Set the STDIN path to be used when launching applications (only if debugserver launches the process)
866 { "stdout-path", required_argument, NULL, 'O' }, // Set the STDOUT path to be used when launching applications (only if debugserver launches the process)
867 { "stderr-path", required_argument, NULL, 'E' }, // Set the STDERR path to be used when launching applications (only if debugserver launches the process)
868 { "no-stdio", no_argument, NULL, 'n' }, // Do not set up any stdio (perhaps the program is a GUI program) (only if debugserver launches the process)
869 { "setsid", no_argument, NULL, 'S' }, // call setsid() to make debugserver run in its own session
870 { "disable-aslr", no_argument, NULL, 'D' }, // Use _POSIX_SPAWN_DISABLE_ASLR to avoid shared library randomization
871 { "working-dir", required_argument, NULL, 'W' }, // The working directory that the inferior process should have (only if debugserver launches the process)
872 { "platform", required_argument, NULL, 'p' }, // Put this executable into a remote platform mode
873 { "unix-socket", required_argument, NULL, 'u' }, // If we need to handshake with our parent process, an option will be passed down that specifies a unix socket name to use
874 { "named-pipe", required_argument, NULL, 'P' },
875 { "reverse-connect", no_argument, NULL, 'R' },
876 { "env", required_argument, NULL, 'e' }, // When debugserver launches the process, set a single environment entry as specified by the option value ("./debugserver -e FOO=1 -e BAR=2 localhost:1234 -- /bin/ls")
877 { "forward-env", no_argument, NULL, 'F' }, // When debugserver launches the process, forward debugserver's current environment variables to the child process ("./debugserver -F localhost:1234 -- /bin/ls"
882 //----------------------------------------------------------------------
884 //----------------------------------------------------------------------
886 main (int argc, char *argv[])
888 const char *argv_sub_zero = argv[0]; // save a copy of argv[0] for error reporting post-launch
890 #if defined (__APPLE__)
891 pthread_setname_np ("main thread");
892 #if defined (__arm__) || defined (__arm64__) || defined (__aarch64__)
893 struct sched_param thread_param;
894 int thread_sched_policy;
895 if (pthread_getschedparam(pthread_self(), &thread_sched_policy, &thread_param) == 0)
897 thread_param.sched_priority = 47;
898 pthread_setschedparam(pthread_self(), thread_sched_policy, &thread_param);
901 ::proc_set_wakemon_params (getpid(), 500, 0); // Allow up to 500 wakeups/sec to avoid EXC_RESOURCE for normal use.
905 g_isatty = ::isatty (STDIN_FILENO);
907 // ::printf ("uid=%u euid=%u gid=%u egid=%u\n",
914 // signal (SIGINT, signal_handler);
915 signal (SIGPIPE, signal_handler);
916 signal (SIGHUP, signal_handler);
918 // We're always sitting in waitpid or kevent waiting on our target process' death,
919 // we don't need no stinking SIGCHLD's...
922 sigemptyset(&sigset);
923 sigaddset(&sigset, SIGCHLD);
924 sigprocmask(SIG_BLOCK, &sigset, NULL);
926 g_remoteSP.reset (new RNBRemote ());
929 RNBRemote *remote = g_remoteSP.get();
932 RNBLogSTDERR ("error: failed to create a remote connection class\n");
936 RNBContext& ctx = remote->Context();
939 int attach_pid = INVALID_NUB_PROCESS;
941 FILE* log_file = NULL;
942 uint32_t log_flags = 0;
945 int long_option_index = 0;
947 std::string compile_options;
948 std::string waitfor_pid_name; // Wait for a process that starts with this name
949 std::string attach_pid_name;
950 std::string arch_name;
951 std::string working_dir; // The new working directory to use for the inferior
952 std::string unix_socket_name; // If we need to handshake with our parent process, an option will be passed down that specifies a unix socket name to use
953 std::string named_pipe_path; // If we need to handshake with our parent process, an option will be passed down that specifies a named pipe to use
954 useconds_t waitfor_interval = 1000; // Time in usecs between process lists polls when waiting for a process by name, default 1 msec.
955 useconds_t waitfor_duration = 0; // Time in seconds to wait for a process by name, 0 means wait forever.
956 bool no_stdio = false;
957 bool reverse_connect = false; // Set to true by an option to indicate we should reverse connect to the host:port supplied as the first debugserver argument
959 #if !defined (DNBLOG_ENABLED)
960 compile_options += "(no-logging) ";
963 RNBRunLoopMode start_mode = eRNBRunLoopModeExit;
965 char short_options[512];
966 uint32_t short_options_idx = 0;
968 // Handle the two case that don't have short options in g_long_options
969 short_options[short_options_idx++] = 'k';
970 short_options[short_options_idx++] = 't';
972 for (i=0; g_long_options[i].name != NULL; ++i)
974 if (isalpha(g_long_options[i].val))
976 short_options[short_options_idx++] = g_long_options[i].val;
977 switch (g_long_options[i].has_arg)
983 case optional_argument:
984 short_options[short_options_idx++] = ':';
985 // Fall through to required_argument case below...
986 case required_argument:
987 short_options[short_options_idx++] = ':';
992 // NULL terminate the short option string.
993 short_options[short_options_idx++] = '\0';
1002 while ((ch = getopt_long_only(argc, argv, short_options, g_long_options, &long_option_index)) != -1)
1004 DNBLogDebug("option: ch == %c (0x%2.2x) --%s%c%s\n",
1006 g_long_options[long_option_index].name,
1007 g_long_options[long_option_index].has_arg ? '=' : ' ',
1008 optarg ? optarg : "");
1011 case 0: // Any optional that auto set themselves will return 0
1015 if (optarg && optarg[0])
1016 arch_name.assign(optarg);
1020 if (optarg && optarg[0])
1022 if (isdigit(optarg[0]))
1025 attach_pid = static_cast<int>(strtoul(optarg, &end, 0));
1026 if (end == NULL || *end != '\0')
1028 RNBLogSTDERR ("error: invalid pid option '%s'\n", optarg);
1034 attach_pid_name = optarg;
1036 start_mode = eRNBRunLoopModeInferiorAttaching;
1042 if (optarg && optarg[0])
1044 waitfor_pid_name = optarg;
1045 start_mode = eRNBRunLoopModeInferiorAttaching;
1049 // --waitfor-interval=USEC
1051 if (optarg && optarg[0])
1054 waitfor_interval = static_cast<useconds_t>(strtoul(optarg, &end, 0));
1055 if (end == NULL || *end != '\0')
1057 RNBLogSTDERR ("error: invalid waitfor-interval option value '%s'.\n", optarg);
1063 // --waitfor-duration=SEC
1065 if (optarg && optarg[0])
1068 waitfor_duration = static_cast<useconds_t>(strtoul(optarg, &end, 0));
1069 if (end == NULL || *end != '\0')
1071 RNBLogSTDERR ("error: invalid waitfor-duration option value '%s'.\n", optarg);
1078 g_detach_on_error = false;
1081 if (optarg && optarg[0])
1082 working_dir.assign(optarg);
1086 if (optarg && optarg[0])
1088 if (strcasecmp(optarg, "auto") == 0)
1089 g_launch_flavor = eLaunchFlavorDefault;
1090 else if (strcasestr(optarg, "posix") == optarg)
1091 g_launch_flavor = eLaunchFlavorPosixSpawn;
1092 else if (strcasestr(optarg, "fork") == optarg)
1093 g_launch_flavor = eLaunchFlavorForkExec;
1094 #ifdef WITH_SPRINGBOARD
1095 else if (strcasestr(optarg, "spring") == optarg)
1096 g_launch_flavor = eLaunchFlavorSpringBoard;
1099 else if (strcasestr(optarg, "backboard") == optarg)
1100 g_launch_flavor = eLaunchFlavorBKS;
1103 else if (strcasestr(optarg, "frontboard") == optarg)
1104 g_launch_flavor = eLaunchFlavorFBS;
1109 RNBLogSTDERR ("error: invalid TYPE for the --launch=TYPE (-x TYPE) option: '%s'\n", optarg);
1110 RNBLogSTDERR ("Valid values TYPE are:\n");
1111 RNBLogSTDERR (" auto Auto-detect the best launch method to use.\n");
1112 RNBLogSTDERR (" posix Launch the executable using posix_spawn.\n");
1113 RNBLogSTDERR (" fork Launch the executable using fork and exec.\n");
1114 #ifdef WITH_SPRINGBOARD
1115 RNBLogSTDERR (" spring Launch the executable through Springboard.\n");
1118 RNBLogSTDERR (" backboard Launch the executable through BackBoard Services.\n");
1121 RNBLogSTDERR (" frontboard Launch the executable through FrontBoard Services.\n");
1128 case 'l': // Set Log File
1129 if (optarg && optarg[0])
1131 if (strcasecmp(optarg, "stdout") == 0)
1133 else if (strcasecmp(optarg, "stderr") == 0)
1137 log_file = fopen(optarg, "w");
1138 if (log_file != NULL)
1139 setlinebuf(log_file);
1142 if (log_file == NULL)
1144 const char *errno_str = strerror(errno);
1145 RNBLogSTDERR ("Failed to open log file '%s' for writing: errno = %i (%s)", optarg, errno, errno_str ? errno_str : "unknown error");
1150 case 'f': // Log Flags
1151 if (optarg && optarg[0])
1152 log_flags = static_cast<uint32_t>(strtoul(optarg, NULL, 0));
1157 DNBLogSetDebug(debug);
1169 // Do nothing, native regs is the default these days
1173 reverse_connect = true;
1176 DNBLogSetVerbose(1);
1180 ctx.GetSTDIN().assign(optarg);
1181 ctx.GetSTDOUT().assign(optarg);
1182 ctx.GetSTDERR().assign(optarg);
1186 ctx.GetSTDIN().assign(optarg);
1190 ctx.GetSTDOUT().assign(optarg);
1194 ctx.GetSTDERR().assign(optarg);
1202 // Put debugserver into a new session. Terminals group processes
1203 // into sessions and when a special terminal key sequences
1204 // (like control+c) are typed they can cause signals to go out to
1205 // all processes in a session. Using this --setsid (-S) option
1206 // will cause debugserver to run in its own sessions and be free
1207 // from such issues.
1209 // This is useful when debugserver is spawned from a command
1210 // line application that uses debugserver to do the debugging,
1211 // yet that application doesn't want debugserver receiving the
1212 // signals sent to the session (i.e. dying when anyone hits ^C).
1220 start_mode = eRNBRunLoopModePlatformMode;
1224 unix_socket_name.assign (optarg);
1228 named_pipe_path.assign (optarg);
1232 // Pass a single specified environment variable down to the process that gets launched
1233 remote->Context().PushEnvironment(optarg);
1237 // Pass the current environment down to the process that gets launched
1239 char **host_env = *_NSGetEnviron();
1242 for (i=0; (env_entry = host_env[i]) != NULL; ++i)
1243 remote->Context().PushEnvironment(env_entry);
1249 if (arch_name.empty())
1251 #if defined (__arm__)
1252 arch_name.assign ("arm");
1257 DNBSetArchitecture (arch_name.c_str());
1260 // if (arch_name.empty())
1262 // fprintf(stderr, "error: no architecture was specified\n");
1265 // Skip any options we consumed with getopt_long_only
1270 if (!working_dir.empty())
1272 if (remote->Context().SetWorkingDirectory (working_dir.c_str()) == false)
1274 RNBLogSTDERR ("error: working directory doesn't exist '%s'.\n", working_dir.c_str());
1279 remote->Context().SetDetachOnError(g_detach_on_error);
1281 remote->Initialize();
1283 // It is ok for us to set NULL as the logfile (this will disable any logging)
1285 if (log_file != NULL)
1287 DNBLogSetLogCallback(FileLogCallback, log_file);
1288 // If our log file was set, yet we have no log flags, log everything!
1290 log_flags = LOG_ALL | LOG_RNB_ALL;
1292 DNBLogSetLogMask (log_flags);
1296 // Enable DNB logging
1297 DNBLogSetLogCallback(ASLLogCallback, NULL);
1298 DNBLogSetLogMask (log_flags);
1302 if (DNBLogEnabled())
1304 for (i=0; i<argc; i++)
1305 DNBLogDebug("argv[%i] = %s", i, argv[i]);
1308 // as long as we're dropping remotenub in as a replacement for gdbserver,
1309 // explicitly note that this is not gdbserver.
1311 RNBLogSTDOUT ("%s-%s %sfor %s.\n",
1312 DEBUGSERVER_PROGRAM_NAME,
1313 DEBUGSERVER_VERSION_STR,
1314 compile_options.c_str(),
1318 int port = INT32_MAX;
1322 if (g_lockdown_opt == 0 && g_applist_opt == 0)
1324 // Make sure we at least have port
1327 show_usage_and_exit (1);
1329 // accept 'localhost:' prefix on port number
1331 int items_scanned = ::sscanf (argv[0], "%[^:]:%i", str, &port);
1332 if (items_scanned == 2)
1335 DNBLogDebug("host = '%s' port = %i", host.c_str(), port);
1339 // No hostname means "localhost"
1340 int items_scanned = ::sscanf (argv[0], "%i", &port);
1341 if (items_scanned == 1)
1344 DNBLogDebug("host = '%s' port = %i", host.c_str(), port);
1346 else if (argv[0][0] == '/')
1349 strncpy(str, argv[0], sizeof(str));
1353 show_usage_and_exit (2);
1357 // We just used the 'host:port' or the '/path/file' arg...
1363 // If we know we're waiting to attach, we don't need any of this other info.
1364 if (start_mode != eRNBRunLoopModeInferiorAttaching &&
1365 start_mode != eRNBRunLoopModePlatformMode)
1367 if (argc == 0 || g_lockdown_opt)
1369 if (g_lockdown_opt != 0)
1371 // Work around for SIGPIPE crashes due to posix_spawn issue.
1372 // We have to close STDOUT and STDERR, else the first time we
1373 // try and do any, we get SIGPIPE and die as posix_spawn is
1374 // doing bad things with our file descriptors at the moment.
1375 int null = open("/dev/null", O_RDWR);
1376 dup2(null, STDOUT_FILENO);
1377 dup2(null, STDERR_FILENO);
1379 else if (g_applist_opt != 0)
1381 // List all applications we are able to see
1382 std::string applist_plist;
1383 int err = ListApplications(applist_plist, false, false);
1386 fputs (applist_plist.c_str(), stdout);
1390 RNBLogSTDERR ("error: ListApplications returned error %i\n", err);
1392 // Exit with appropriate error if we were asked to list the applications
1393 // with no other args were given (and we weren't trying to do this over
1398 DNBLogDebug("Get args from remote protocol...");
1399 start_mode = eRNBRunLoopModeGetStartModeFromRemoteProtocol;
1403 start_mode = eRNBRunLoopModeInferiorLaunching;
1404 // Fill in the argv array in the context from the rest of our args.
1405 // Skip the name of this executable and the port number
1406 for (int i = 0; i < argc; i++)
1408 DNBLogDebug("inferior_argv[%i] = '%s'", i, argv[i]);
1409 ctx.PushArgument (argv[i]);
1414 if (start_mode == eRNBRunLoopModeExit)
1417 RNBRunLoopMode mode = start_mode;
1418 char err_str[1024] = {'\0'};
1420 while (mode != eRNBRunLoopModeExit)
1424 case eRNBRunLoopModeGetStartModeFromRemoteProtocol:
1425 #ifdef WITH_LOCKDOWN
1428 if (!remote->Comm().IsConnected())
1430 if (remote->Comm().ConnectToService () != rnb_success)
1432 RNBLogSTDERR ("Failed to get connection from a remote gdb process.\n");
1433 mode = eRNBRunLoopModeExit;
1435 else if (g_applist_opt != 0)
1437 // List all applications we are able to see
1438 std::string applist_plist;
1439 if (ListApplications(applist_plist, false, false) == 0)
1441 DNBLogDebug("Task list: %s", applist_plist.c_str());
1443 remote->Comm().Write(applist_plist.c_str(), applist_plist.size());
1444 // Issue a read that will never yield any data until the other side
1445 // closes the socket so this process doesn't just exit and cause the
1446 // socket to close prematurely on the other end and cause data loss.
1448 remote->Comm().Read(buf);
1450 remote->Comm().Disconnect(false);
1451 mode = eRNBRunLoopModeExit;
1456 // Start watching for remote packets
1457 remote->StartReadRemoteDataThread();
1463 if (port != INT32_MAX)
1465 if (!ConnectRemote (remote, host.c_str(), port, reverse_connect, named_pipe_path.c_str(), unix_socket_name.c_str()))
1466 mode = eRNBRunLoopModeExit;
1468 else if (str[0] == '/')
1470 if (remote->Comm().OpenFile (str))
1471 mode = eRNBRunLoopModeExit;
1474 if (mode != eRNBRunLoopModeExit)
1476 RNBLogSTDOUT ("Got a connection, waiting for process information for launching or attaching.\n");
1478 mode = RNBRunLoopGetStartModeFromRemote (remote);
1482 case eRNBRunLoopModeInferiorAttaching:
1483 if (!waitfor_pid_name.empty())
1485 // Set our end wait time if we are using a waitfor-duration
1486 // option that may have been specified
1487 struct timespec attach_timeout_abstime, *timeout_ptr = NULL;
1488 if (waitfor_duration != 0)
1490 DNBTimer::OffsetTimeOfDay(&attach_timeout_abstime, waitfor_duration, 0);
1491 timeout_ptr = &attach_timeout_abstime;
1493 nub_launch_flavor_t launch_flavor = g_launch_flavor;
1494 if (launch_flavor == eLaunchFlavorDefault)
1496 // Our default launch method is posix spawn
1497 launch_flavor = eLaunchFlavorPosixSpawn;
1499 #if defined WITH_FBS
1500 // Check if we have an app bundle, if so launch using SpringBoard.
1501 if (waitfor_pid_name.find (".app") != std::string::npos)
1503 launch_flavor = eLaunchFlavorFBS;
1505 #elif defined WITH_BKS
1506 // Check if we have an app bundle, if so launch using SpringBoard.
1507 if (waitfor_pid_name.find (".app") != std::string::npos)
1509 launch_flavor = eLaunchFlavorBKS;
1511 #elif defined WITH_SPRINGBOARD
1512 // Check if we have an app bundle, if so launch using SpringBoard.
1513 if (waitfor_pid_name.find (".app") != std::string::npos)
1515 launch_flavor = eLaunchFlavorSpringBoard;
1520 ctx.SetLaunchFlavor(launch_flavor);
1521 bool ignore_existing = false;
1522 RNBLogSTDOUT ("Waiting to attach to process %s...\n", waitfor_pid_name.c_str());
1523 nub_process_t pid = DNBProcessAttachWait (waitfor_pid_name.c_str(), launch_flavor, ignore_existing, timeout_ptr, waitfor_interval, err_str, sizeof(err_str));
1526 if (pid == INVALID_NUB_PROCESS)
1528 ctx.LaunchStatus().SetError(-1, DNBError::Generic);
1530 ctx.LaunchStatus().SetErrorString(err_str);
1531 RNBLogSTDERR ("error: failed to attach to process named: \"%s\" %s\n", waitfor_pid_name.c_str(), err_str);
1532 mode = eRNBRunLoopModeExit;
1536 ctx.SetProcessID(pid);
1537 mode = eRNBRunLoopModeInferiorExecuting;
1540 else if (attach_pid != INVALID_NUB_PROCESS)
1543 RNBLogSTDOUT ("Attaching to process %i...\n", attach_pid);
1544 nub_process_t attached_pid;
1545 mode = RNBRunLoopLaunchAttaching (remote, attach_pid, attached_pid);
1546 if (mode != eRNBRunLoopModeInferiorExecuting)
1548 const char *error_str = remote->Context().LaunchStatus().AsString();
1549 RNBLogSTDERR ("error: failed to attach process %i: %s\n", attach_pid, error_str ? error_str : "unknown error.");
1550 mode = eRNBRunLoopModeExit;
1553 else if (!attach_pid_name.empty ())
1555 struct timespec attach_timeout_abstime, *timeout_ptr = NULL;
1556 if (waitfor_duration != 0)
1558 DNBTimer::OffsetTimeOfDay(&attach_timeout_abstime, waitfor_duration, 0);
1559 timeout_ptr = &attach_timeout_abstime;
1562 RNBLogSTDOUT ("Attaching to process %s...\n", attach_pid_name.c_str());
1563 nub_process_t pid = DNBProcessAttachByName (attach_pid_name.c_str(), timeout_ptr, err_str, sizeof(err_str));
1565 if (pid == INVALID_NUB_PROCESS)
1567 ctx.LaunchStatus().SetError(-1, DNBError::Generic);
1569 ctx.LaunchStatus().SetErrorString(err_str);
1570 RNBLogSTDERR ("error: failed to attach to process named: \"%s\" %s\n", waitfor_pid_name.c_str(), err_str);
1571 mode = eRNBRunLoopModeExit;
1575 ctx.SetProcessID(pid);
1576 mode = eRNBRunLoopModeInferiorExecuting;
1582 RNBLogSTDERR ("error: asked to attach with empty name and invalid PID.\n");
1583 mode = eRNBRunLoopModeExit;
1586 if (mode != eRNBRunLoopModeExit)
1588 if (port != INT32_MAX)
1590 if (!ConnectRemote (remote, host.c_str(), port, reverse_connect, named_pipe_path.c_str(), unix_socket_name.c_str()))
1591 mode = eRNBRunLoopModeExit;
1593 else if (str[0] == '/')
1595 if (remote->Comm().OpenFile (str))
1596 mode = eRNBRunLoopModeExit;
1598 if (mode != eRNBRunLoopModeExit)
1599 RNBLogSTDOUT ("Waiting for debugger instructions for process %d.\n", attach_pid);
1603 case eRNBRunLoopModeInferiorLaunching:
1605 mode = RNBRunLoopLaunchInferior (remote,
1607 ctx.GetSTDOUTPath(),
1608 ctx.GetSTDERRPath(),
1611 if (mode == eRNBRunLoopModeInferiorExecuting)
1613 if (port != INT32_MAX)
1615 if (!ConnectRemote (remote, host.c_str(), port, reverse_connect, named_pipe_path.c_str(), unix_socket_name.c_str()))
1616 mode = eRNBRunLoopModeExit;
1618 else if (str[0] == '/')
1620 if (remote->Comm().OpenFile (str))
1621 mode = eRNBRunLoopModeExit;
1624 if (mode != eRNBRunLoopModeExit)
1626 const char *proc_name = "<unknown>";
1627 if (ctx.ArgumentCount() > 0)
1628 proc_name = ctx.ArgumentAtIndex(0);
1629 RNBLogSTDOUT ("Got a connection, launched process %s (pid = %d).\n", proc_name, ctx.ProcessID());
1634 const char *error_str = remote->Context().LaunchStatus().AsString();
1635 RNBLogSTDERR ("error: failed to launch process %s: %s\n", argv_sub_zero, error_str ? error_str : "unknown error.");
1640 case eRNBRunLoopModeInferiorExecuting:
1641 mode = RNBRunLoopInferiorExecuting(remote);
1644 case eRNBRunLoopModePlatformMode:
1645 if (port != INT32_MAX)
1647 if (!ConnectRemote (remote, host.c_str(), port, reverse_connect, named_pipe_path.c_str(), unix_socket_name.c_str()))
1648 mode = eRNBRunLoopModeExit;
1650 else if (str[0] == '/')
1652 if (remote->Comm().OpenFile (str))
1653 mode = eRNBRunLoopModeExit;
1656 if (mode != eRNBRunLoopModeExit)
1657 mode = RNBRunLoopPlatform (remote);
1661 mode = eRNBRunLoopModeExit;
1662 case eRNBRunLoopModeExit:
1667 remote->StopReadRemoteDataThread ();
1668 remote->Context().SetProcessID(INVALID_NUB_PROCESS);
1669 RNBLogSTDOUT ("Exiting.\n");