1 //===-- debugserver.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 <sys/socket.h>
11 #include <sys/types.h>
12 #include <errno.h>
13 #include <getopt.h>
14 #include <netinet/in.h>
15 #include <sys/select.h>
16 #include <sys/sysctl.h>
17 #include <string>
18 #include <vector>
19 #include <asl.h>
20 #include <arpa/inet.h>
21 #include <netdb.h>
22 #include <netinet/in.h>
23 #include <netinet/tcp.h>
24 #include <sys/un.h>
25 #include <sys/types.h>
26 
27 #include "CFString.h"
28 #include "DNB.h"
29 #include "DNBLog.h"
30 #include "DNBTimer.h"
31 #include "PseudoTerminal.h"
32 #include "RNBContext.h"
33 #include "RNBServices.h"
34 #include "RNBSocket.h"
35 #include "RNBRemote.h"
36 #include "SysSignal.h"
37 
38 // Global PID in case we get a signal and need to stop the process...
39 nub_process_t g_pid = INVALID_NUB_PROCESS;
40 
41 //----------------------------------------------------------------------
42 // Run loop modes which determine which run loop function will be called
43 //----------------------------------------------------------------------
44 typedef enum
45 {
46     eRNBRunLoopModeInvalid = 0,
47     eRNBRunLoopModeGetStartModeFromRemoteProtocol,
48     eRNBRunLoopModeInferiorAttaching,
49     eRNBRunLoopModeInferiorLaunching,
50     eRNBRunLoopModeInferiorExecuting,
51     eRNBRunLoopModePlatformMode,
52     eRNBRunLoopModeExit
53 } RNBRunLoopMode;
54 
55 
56 //----------------------------------------------------------------------
57 // Global Variables
58 //----------------------------------------------------------------------
59 RNBRemoteSP g_remoteSP;
60 static int g_lockdown_opt  = 0;
61 static int g_applist_opt = 0;
62 static nub_launch_flavor_t g_launch_flavor = eLaunchFlavorDefault;
63 int g_disable_aslr = 0;
64 
65 int g_isatty = 0;
66 
67 #define RNBLogSTDOUT(fmt, ...) do { if (g_isatty) { fprintf(stdout, fmt, ## __VA_ARGS__); } else { _DNBLog(0, fmt, ## __VA_ARGS__); } } while (0)
68 #define RNBLogSTDERR(fmt, ...) do { if (g_isatty) { fprintf(stderr, fmt, ## __VA_ARGS__); } else { _DNBLog(0, fmt, ## __VA_ARGS__); } } while (0)
69 
70 //----------------------------------------------------------------------
71 // Get our program path and arguments from the remote connection.
72 // We will need to start up the remote connection without a PID, get the
73 // arguments, wait for the new process to finish launching and hit its
74 // entry point,  and then return the run loop mode that should come next.
75 //----------------------------------------------------------------------
76 RNBRunLoopMode
77 RNBRunLoopGetStartModeFromRemote (RNBRemote* remote)
78 {
79     std::string packet;
80 
81     if (remote)
82     {
83         RNBContext& ctx = remote->Context();
84         uint32_t event_mask = RNBContext::event_read_packet_available |
85                               RNBContext::event_read_thread_exiting;
86 
87         // Spin waiting to get the A packet.
88         while (1)
89         {
90             DNBLogThreadedIf (LOG_RNB_MAX, "%s ctx.Events().WaitForSetEvents( 0x%08x ) ...",__FUNCTION__, event_mask);
91             nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
92             DNBLogThreadedIf (LOG_RNB_MAX, "%s ctx.Events().WaitForSetEvents( 0x%08x ) => 0x%08x", __FUNCTION__, event_mask, set_events);
93 
94             if (set_events & RNBContext::event_read_thread_exiting)
95             {
96                 RNBLogSTDERR ("error: packet read thread exited.\n");
97                 return eRNBRunLoopModeExit;
98             }
99 
100             if (set_events & RNBContext::event_read_packet_available)
101             {
102                 rnb_err_t err = rnb_err;
103                 RNBRemote::PacketEnum type;
104 
105                 err = remote->HandleReceivedPacket (&type);
106 
107                 // check if we tried to attach to a process
108                 if (type == RNBRemote::vattach || type == RNBRemote::vattachwait || type == RNBRemote::vattachorwait)
109                 {
110                     if (err == rnb_success)
111                     {
112                         RNBLogSTDOUT ("Attach succeeded, ready to debug.\n");
113                         return eRNBRunLoopModeInferiorExecuting;
114                     }
115                     else
116                     {
117                         RNBLogSTDERR ("error: attach failed.\n");
118                         return eRNBRunLoopModeExit;
119                     }
120                 }
121 
122                 if (err == rnb_success)
123                 {
124                     // If we got our arguments we are ready to launch using the arguments
125                     // and any environment variables we received.
126                     if (type == RNBRemote::set_argv)
127                     {
128                         return eRNBRunLoopModeInferiorLaunching;
129                     }
130                 }
131                 else if (err == rnb_not_connected)
132                 {
133                     RNBLogSTDERR ("error: connection lost.\n");
134                     return eRNBRunLoopModeExit;
135                 }
136                 else
137                 {
138                     // a catch all for any other gdb remote packets that failed
139                     DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Error getting packet.",__FUNCTION__);
140                     continue;
141                 }
142 
143                 DNBLogThreadedIf (LOG_RNB_MINIMAL, "#### %s", __FUNCTION__);
144             }
145             else
146             {
147                 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Connection closed before getting \"A\" packet.", __FUNCTION__);
148                 return eRNBRunLoopModeExit;
149             }
150         }
151     }
152     return eRNBRunLoopModeExit;
153 }
154 
155 
156 //----------------------------------------------------------------------
157 // This run loop mode will wait for the process to launch and hit its
158 // entry point. It will currently ignore all events except for the
159 // process state changed event, where it watches for the process stopped
160 // or crash process state.
161 //----------------------------------------------------------------------
162 RNBRunLoopMode
163 RNBRunLoopLaunchInferior (RNBRemote *remote, const char *stdin_path, const char *stdout_path, const char *stderr_path, bool no_stdio)
164 {
165     RNBContext& ctx = remote->Context();
166 
167     // The Process stuff takes a c array, the RNBContext has a vector...
168     // So make up a c array.
169 
170     DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Launching '%s'...", __FUNCTION__, ctx.ArgumentAtIndex(0));
171 
172     size_t inferior_argc = ctx.ArgumentCount();
173     // Initialize inferior_argv with inferior_argc + 1 NULLs
174     std::vector<const char *> inferior_argv(inferior_argc + 1, NULL);
175 
176     size_t i;
177     for (i = 0; i < inferior_argc; i++)
178         inferior_argv[i] = ctx.ArgumentAtIndex(i);
179 
180     // Pass the environment array the same way:
181 
182     size_t inferior_envc = ctx.EnvironmentCount();
183     // Initialize inferior_argv with inferior_argc + 1 NULLs
184     std::vector<const char *> inferior_envp(inferior_envc + 1, NULL);
185 
186     for (i = 0; i < inferior_envc; i++)
187         inferior_envp[i] = ctx.EnvironmentAtIndex(i);
188 
189     // Our launch type hasn't been set to anything concrete, so we need to
190     // figure our how we are going to launch automatically.
191 
192     nub_launch_flavor_t launch_flavor = g_launch_flavor;
193     if (launch_flavor == eLaunchFlavorDefault)
194     {
195         // Our default launch method is posix spawn
196         launch_flavor = eLaunchFlavorPosixSpawn;
197 
198 #ifdef WITH_SPRINGBOARD
199         // Check if we have an app bundle, if so launch using SpringBoard.
200         if (strstr(inferior_argv[0], ".app"))
201         {
202             launch_flavor = eLaunchFlavorSpringBoard;
203         }
204 #endif
205     }
206 
207     ctx.SetLaunchFlavor(launch_flavor);
208     char resolved_path[PATH_MAX];
209 
210     // If we fail to resolve the path to our executable, then just use what we
211     // were given and hope for the best
212     if ( !DNBResolveExecutablePath (inferior_argv[0], resolved_path, sizeof(resolved_path)) )
213         ::strncpy(resolved_path, inferior_argv[0], sizeof(resolved_path));
214 
215     char launch_err_str[PATH_MAX];
216     launch_err_str[0] = '\0';
217     const char * cwd = (ctx.GetWorkingDirPath() != NULL ? ctx.GetWorkingDirPath()
218                                                         : ctx.GetWorkingDirectory());
219     nub_process_t pid = DNBProcessLaunch (resolved_path,
220                                           &inferior_argv[0],
221                                           &inferior_envp[0],
222                                           cwd,
223                                           stdin_path,
224                                           stdout_path,
225                                           stderr_path,
226                                           no_stdio,
227                                           launch_flavor,
228                                           g_disable_aslr,
229                                           launch_err_str,
230                                           sizeof(launch_err_str));
231 
232     g_pid = pid;
233 
234     if (pid == INVALID_NUB_PROCESS && strlen (launch_err_str) > 0)
235     {
236         DNBLogThreaded ("%s DNBProcessLaunch() returned error: '%s'", __FUNCTION__, launch_err_str);
237         ctx.LaunchStatus().SetError(-1, DNBError::Generic);
238         ctx.LaunchStatus().SetErrorString(launch_err_str);
239     }
240     else if (pid == INVALID_NUB_PROCESS)
241     {
242         DNBLogThreaded ("%s DNBProcessLaunch() failed to launch process, unknown failure", __FUNCTION__);
243         ctx.LaunchStatus().SetError(-1, DNBError::Generic);
244         ctx.LaunchStatus().SetErrorString(launch_err_str);
245     }
246     else
247     {
248         ctx.LaunchStatus().Clear();
249     }
250 
251     if (remote->Comm().IsConnected())
252     {
253         // It we are connected already, the next thing gdb will do is ask
254         // whether the launch succeeded, and if not, whether there is an
255         // error code.  So we need to fetch one packet from gdb before we wait
256         // on the stop from the target.
257 
258         uint32_t event_mask = RNBContext::event_read_packet_available;
259         nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
260 
261         if (set_events & RNBContext::event_read_packet_available)
262         {
263             rnb_err_t err = rnb_err;
264             RNBRemote::PacketEnum type;
265 
266             err = remote->HandleReceivedPacket (&type);
267 
268             if (err != rnb_success)
269             {
270                 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Error getting packet.", __FUNCTION__);
271                 return eRNBRunLoopModeExit;
272             }
273             if (type != RNBRemote::query_launch_success)
274             {
275                 DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Didn't get the expected qLaunchSuccess packet.", __FUNCTION__);
276             }
277         }
278     }
279 
280     while (pid != INVALID_NUB_PROCESS)
281     {
282         // Wait for process to start up and hit entry point
283         DNBLogThreadedIf (LOG_RNB_EVENTS, "%s DNBProcessWaitForEvent (%4.4x, eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged, true, INFINITE)...", __FUNCTION__, pid);
284         nub_event_t set_events = DNBProcessWaitForEvents (pid, eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged, true, NULL);
285         DNBLogThreadedIf (LOG_RNB_EVENTS, "%s DNBProcessWaitForEvent (%4.4x, eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged, true, INFINITE) => 0x%8.8x", __FUNCTION__, pid, set_events);
286 
287         if (set_events == 0)
288         {
289             pid = INVALID_NUB_PROCESS;
290             g_pid = pid;
291         }
292         else
293         {
294             if (set_events & (eEventProcessRunningStateChanged | eEventProcessStoppedStateChanged))
295             {
296                 nub_state_t pid_state = DNBProcessGetState (pid);
297                 DNBLogThreadedIf (LOG_RNB_EVENTS, "%s process %4.4x state changed (eEventProcessStateChanged): %s", __FUNCTION__, pid, DNBStateAsString(pid_state));
298 
299                 switch (pid_state)
300                 {
301                     default:
302                     case eStateInvalid:
303                     case eStateUnloaded:
304                     case eStateAttaching:
305                     case eStateLaunching:
306                     case eStateSuspended:
307                         break;  // Ignore
308 
309                     case eStateRunning:
310                     case eStateStepping:
311                         // Still waiting to stop at entry point...
312                         break;
313 
314                     case eStateStopped:
315                     case eStateCrashed:
316                         ctx.SetProcessID(pid);
317                         return eRNBRunLoopModeInferiorExecuting;
318 
319                     case eStateDetached:
320                     case eStateExited:
321                         pid = INVALID_NUB_PROCESS;
322                         g_pid = pid;
323                         return eRNBRunLoopModeExit;
324                 }
325             }
326 
327             DNBProcessResetEvents(pid, set_events);
328         }
329     }
330 
331     return eRNBRunLoopModeExit;
332 }
333 
334 
335 //----------------------------------------------------------------------
336 // This run loop mode will wait for the process to launch and hit its
337 // entry point. It will currently ignore all events except for the
338 // process state changed event, where it watches for the process stopped
339 // or crash process state.
340 //----------------------------------------------------------------------
341 RNBRunLoopMode
342 RNBRunLoopLaunchAttaching (RNBRemote *remote, nub_process_t attach_pid, nub_process_t& pid)
343 {
344     RNBContext& ctx = remote->Context();
345 
346     DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s Attaching to pid %i...", __FUNCTION__, attach_pid);
347     char err_str[1024];
348     pid = DNBProcessAttach (attach_pid, NULL, err_str, sizeof(err_str));
349     g_pid = pid;
350 
351     if (pid == INVALID_NUB_PROCESS)
352     {
353         ctx.LaunchStatus().SetError(-1, DNBError::Generic);
354         if (err_str[0])
355             ctx.LaunchStatus().SetErrorString(err_str);
356         return eRNBRunLoopModeExit;
357     }
358     else
359     {
360         ctx.SetProcessID(pid);
361         return eRNBRunLoopModeInferiorExecuting;
362     }
363 }
364 
365 //----------------------------------------------------------------------
366 // Watch for signals:
367 // SIGINT: so we can halt our inferior. (disabled for now)
368 // SIGPIPE: in case our child process dies
369 //----------------------------------------------------------------------
370 int g_sigint_received = 0;
371 int g_sigpipe_received = 0;
372 void
373 signal_handler(int signo)
374 {
375     DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (%s)", __FUNCTION__, SysSignal::Name(signo));
376 
377     switch (signo)
378     {
379         case SIGINT:
380             g_sigint_received++;
381             if (g_pid != INVALID_NUB_PROCESS)
382             {
383                 // Only send a SIGINT once...
384                 if (g_sigint_received == 1)
385                 {
386                     switch (DNBProcessGetState (g_pid))
387                     {
388                         case eStateRunning:
389                         case eStateStepping:
390                             DNBProcessSignal (g_pid, SIGSTOP);
391                             return;
392                         default:
393                             break;
394                     }
395                 }
396             }
397             exit (SIGINT);
398             break;
399 
400         case SIGPIPE:
401             g_sigpipe_received = 1;
402             break;
403     }
404 }
405 
406 // Return the new run loop mode based off of the current process state
407 RNBRunLoopMode
408 HandleProcessStateChange (RNBRemote *remote, bool initialize)
409 {
410     RNBContext& ctx = remote->Context();
411     nub_process_t pid = ctx.ProcessID();
412 
413     if (pid == INVALID_NUB_PROCESS)
414     {
415         DNBLogThreadedIf (LOG_RNB_MINIMAL, "#### %s error: pid invalid, exiting...", __FUNCTION__);
416         return eRNBRunLoopModeExit;
417     }
418     nub_state_t pid_state = DNBProcessGetState (pid);
419 
420     DNBLogThreadedIf (LOG_RNB_MINIMAL, "%s (&remote, initialize=%i)  pid_state = %s", __FUNCTION__, (int)initialize, DNBStateAsString (pid_state));
421 
422     switch (pid_state)
423     {
424         case eStateInvalid:
425         case eStateUnloaded:
426             // Something bad happened
427             return eRNBRunLoopModeExit;
428             break;
429 
430         case eStateAttaching:
431         case eStateLaunching:
432             return eRNBRunLoopModeInferiorExecuting;
433 
434         case eStateSuspended:
435         case eStateCrashed:
436         case eStateStopped:
437             // If we stop due to a signal, so clear the fact that we got a SIGINT
438             // so we can stop ourselves again (but only while our inferior
439             // process is running..)
440             g_sigint_received = 0;
441             if (initialize == false)
442             {
443                 // Compare the last stop count to our current notion of a stop count
444                 // to make sure we don't notify more than once for a given stop.
445                 nub_size_t prev_pid_stop_count = ctx.GetProcessStopCount();
446                 bool pid_stop_count_changed = ctx.SetProcessStopCount(DNBProcessGetStopCount(pid));
447                 if (pid_stop_count_changed)
448                 {
449                     remote->FlushSTDIO();
450 
451                     if (ctx.GetProcessStopCount() == 1)
452                     {
453                         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);
454                     }
455                     else
456                     {
457 
458                         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);
459                         remote->NotifyThatProcessStopped ();
460                     }
461                 }
462                 else
463                 {
464                     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);
465                 }
466             }
467             return eRNBRunLoopModeInferiorExecuting;
468 
469         case eStateStepping:
470         case eStateRunning:
471             return eRNBRunLoopModeInferiorExecuting;
472 
473         case eStateExited:
474             remote->HandlePacket_last_signal(NULL);
475         case eStateDetached:
476             return eRNBRunLoopModeExit;
477 
478     }
479 
480     // Catch all...
481     return eRNBRunLoopModeExit;
482 }
483 // This function handles the case where our inferior program is stopped and
484 // we are waiting for gdb remote protocol packets. When a packet occurs that
485 // makes the inferior run, we need to leave this function with a new state
486 // as the return code.
487 RNBRunLoopMode
488 RNBRunLoopInferiorExecuting (RNBRemote *remote)
489 {
490     DNBLogThreadedIf (LOG_RNB_MINIMAL, "#### %s", __FUNCTION__);
491     RNBContext& ctx = remote->Context();
492 
493     // Init our mode and set 'is_running' based on the current process state
494     RNBRunLoopMode mode = HandleProcessStateChange (remote, true);
495 
496     while (ctx.ProcessID() != INVALID_NUB_PROCESS)
497     {
498 
499         std::string set_events_str;
500         uint32_t event_mask = ctx.NormalEventBits();
501 
502         if (!ctx.ProcessStateRunning())
503         {
504             // Clear some bits if we are not running so we don't send any async packets
505             event_mask &= ~RNBContext::event_proc_stdio_available;
506             event_mask &= ~RNBContext::event_proc_profile_data;
507         }
508 
509         // We want to make sure we consume all process state changes and have
510         // whomever is notifying us to wait for us to reset the event bit before
511         // continuing.
512         //ctx.Events().SetResetAckMask (RNBContext::event_proc_state_changed);
513 
514         DNBLogThreadedIf (LOG_RNB_EVENTS, "%s ctx.Events().WaitForSetEvents(0x%08x) ...",__FUNCTION__, event_mask);
515         nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
516         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));
517 
518         if (set_events)
519         {
520             if ((set_events & RNBContext::event_proc_thread_exiting) ||
521                 (set_events & RNBContext::event_proc_stdio_available))
522             {
523                 remote->FlushSTDIO();
524             }
525 
526             if (set_events & RNBContext::event_proc_profile_data)
527             {
528                 remote->SendAsyncProfileData();
529             }
530 
531             if (set_events & RNBContext::event_read_packet_available)
532             {
533                 // handleReceivedPacket will take care of resetting the
534                 // event_read_packet_available events when there are no more...
535                 set_events ^= RNBContext::event_read_packet_available;
536 
537                 if (ctx.ProcessStateRunning())
538                 {
539                     if (remote->HandleAsyncPacket() == rnb_not_connected)
540                     {
541                         // TODO: connect again? Exit?
542                     }
543                 }
544                 else
545                 {
546                     if (remote->HandleReceivedPacket() == rnb_not_connected)
547                     {
548                         // TODO: connect again? Exit?
549                     }
550                 }
551             }
552 
553             if (set_events & RNBContext::event_proc_state_changed)
554             {
555                 mode = HandleProcessStateChange (remote, false);
556                 ctx.Events().ResetEvents(RNBContext::event_proc_state_changed);
557                 set_events ^= RNBContext::event_proc_state_changed;
558             }
559 
560             if (set_events & RNBContext::event_proc_thread_exiting)
561             {
562                 mode = eRNBRunLoopModeExit;
563             }
564 
565             if (set_events & RNBContext::event_read_thread_exiting)
566             {
567                 // Out remote packet receiving thread exited, exit for now.
568                 if (ctx.HasValidProcessID())
569                 {
570                     // TODO: We should add code that will leave the current process
571                     // in its current state and listen for another connection...
572                     if (ctx.ProcessStateRunning())
573                     {
574                         DNBLog ("debugserver's event read thread is exiting, killing the inferior process.");
575                         DNBProcessKill (ctx.ProcessID());
576                     }
577                 }
578                 mode = eRNBRunLoopModeExit;
579             }
580         }
581 
582         // Reset all event bits that weren't reset for now...
583         if (set_events != 0)
584             ctx.Events().ResetEvents(set_events);
585 
586         if (mode != eRNBRunLoopModeInferiorExecuting)
587             break;
588     }
589 
590     return mode;
591 }
592 
593 
594 RNBRunLoopMode
595 RNBRunLoopPlatform (RNBRemote *remote)
596 {
597     RNBRunLoopMode mode = eRNBRunLoopModePlatformMode;
598     RNBContext& ctx = remote->Context();
599 
600     while (mode == eRNBRunLoopModePlatformMode)
601     {
602         std::string set_events_str;
603         const uint32_t event_mask = RNBContext::event_read_packet_available |
604                                     RNBContext::event_read_thread_exiting;
605 
606         DNBLogThreadedIf (LOG_RNB_EVENTS, "%s ctx.Events().WaitForSetEvents(0x%08x) ...",__FUNCTION__, event_mask);
607         nub_event_t set_events = ctx.Events().WaitForSetEvents(event_mask);
608         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));
609 
610         if (set_events)
611         {
612             if (set_events & RNBContext::event_read_packet_available)
613             {
614                 if (remote->HandleReceivedPacket() == rnb_not_connected)
615                     mode = eRNBRunLoopModeExit;
616             }
617 
618             if (set_events & RNBContext::event_read_thread_exiting)
619             {
620                 mode = eRNBRunLoopModeExit;
621             }
622             ctx.Events().ResetEvents(set_events);
623         }
624     }
625     return eRNBRunLoopModeExit;
626 }
627 
628 //----------------------------------------------------------------------
629 // Convenience function to set up the remote listening port
630 // Returns 1 for success 0 for failure.
631 //----------------------------------------------------------------------
632 
633 static void
634 PortWasBoundCallback (const void *baton, in_port_t port)
635 {
636     //::printf ("PortWasBoundCallback (baton = %p, port = %u)\n", baton, port);
637 
638     const char *unix_socket_name = (const char *)baton;
639 
640     if (unix_socket_name && unix_socket_name[0])
641     {
642         // We were given a unix socket name to use to communicate the port
643         // that we ended up binding to back to our parent process
644         struct sockaddr_un saddr_un;
645         int s = ::socket (AF_UNIX, SOCK_STREAM, 0);
646         if (s < 0)
647         {
648             perror("error: socket (AF_UNIX, SOCK_STREAM, 0)");
649             exit(1);
650         }
651 
652         saddr_un.sun_family = AF_UNIX;
653         ::strncpy(saddr_un.sun_path, unix_socket_name, sizeof(saddr_un.sun_path) - 1);
654         saddr_un.sun_path[sizeof(saddr_un.sun_path) - 1] = '\0';
655         saddr_un.sun_len = SUN_LEN (&saddr_un);
656 
657         if (::connect (s, (struct sockaddr *)&saddr_un, SUN_LEN (&saddr_un)) < 0)
658         {
659             perror("error: connect (socket, &saddr_un, saddr_un_len)");
660             exit(1);
661         }
662 
663         //::printf ("connect () sucess!!\n");
664 
665 
666         // We were able to connect to the socket, now write our PID so whomever
667         // launched us will know this process's ID
668         RNBLogSTDOUT ("Listening to port %i...\n", port);
669 
670         char pid_str[64];
671         const int pid_str_len = ::snprintf (pid_str, sizeof(pid_str), "%u", port);
672         const int bytes_sent = ::send (s, pid_str, pid_str_len, 0);
673 
674         if (pid_str_len != bytes_sent)
675         {
676             perror("error: send (s, pid_str, pid_str_len, 0)");
677             exit (1);
678         }
679 
680         //::printf ("send () sucess!!\n");
681 
682         // We are done with the socket
683         close (s);
684     }
685 }
686 
687 static int
688 StartListening (RNBRemote *remote, int listen_port, const char *unix_socket_name, bool localhost_only)
689 {
690     if (!remote->Comm().IsConnected())
691     {
692         if (listen_port != 0)
693             RNBLogSTDOUT ("Listening to port %i...\n", listen_port);
694         if (remote->Comm().Listen(listen_port, PortWasBoundCallback, unix_socket_name, localhost_only) != rnb_success)
695         {
696             RNBLogSTDERR ("Failed to get connection from a remote gdb process.\n");
697             return 0;
698         }
699         else
700         {
701             remote->StartReadRemoteDataThread();
702         }
703     }
704     return 1;
705 }
706 
707 //----------------------------------------------------------------------
708 // ASL Logging callback that can be registered with DNBLogSetLogCallback
709 //----------------------------------------------------------------------
710 void
711 ASLLogCallback(void *baton, uint32_t flags, const char *format, va_list args)
712 {
713     if (format == NULL)
714         return;
715     static aslmsg g_aslmsg = NULL;
716     if (g_aslmsg == NULL)
717     {
718         g_aslmsg = ::asl_new (ASL_TYPE_MSG);
719         char asl_key_sender[PATH_MAX];
720         snprintf(asl_key_sender, sizeof(asl_key_sender), "com.apple.%s-%g", DEBUGSERVER_PROGRAM_NAME, DEBUGSERVER_VERSION_NUM);
721         ::asl_set (g_aslmsg, ASL_KEY_SENDER, asl_key_sender);
722     }
723 
724     int asl_level;
725     if (flags & DNBLOG_FLAG_FATAL)        asl_level = ASL_LEVEL_CRIT;
726     else if (flags & DNBLOG_FLAG_ERROR)   asl_level = ASL_LEVEL_ERR;
727     else if (flags & DNBLOG_FLAG_WARNING) asl_level = ASL_LEVEL_WARNING;
728     else if (flags & DNBLOG_FLAG_VERBOSE) asl_level = ASL_LEVEL_WARNING; //ASL_LEVEL_INFO;
729     else                                  asl_level = ASL_LEVEL_WARNING; //ASL_LEVEL_DEBUG;
730 
731     ::asl_vlog (NULL, g_aslmsg, asl_level, format, args);
732 }
733 
734 //----------------------------------------------------------------------
735 // FILE based Logging callback that can be registered with
736 // DNBLogSetLogCallback
737 //----------------------------------------------------------------------
738 void
739 FileLogCallback(void *baton, uint32_t flags, const char *format, va_list args)
740 {
741     if (baton == NULL || format == NULL)
742         return;
743 
744     ::vfprintf ((FILE *)baton, format, args);
745     ::fprintf ((FILE *)baton, "\n");
746 }
747 
748 
749 void
750 show_usage_and_exit (int exit_code)
751 {
752     RNBLogSTDERR ("Usage:\n  %s host:port [program-name program-arg1 program-arg2 ...]\n", DEBUGSERVER_PROGRAM_NAME);
753     RNBLogSTDERR ("  %s /path/file [program-name program-arg1 program-arg2 ...]\n", DEBUGSERVER_PROGRAM_NAME);
754     RNBLogSTDERR ("  %s host:port --attach=<pid>\n", DEBUGSERVER_PROGRAM_NAME);
755     RNBLogSTDERR ("  %s /path/file --attach=<pid>\n", DEBUGSERVER_PROGRAM_NAME);
756     RNBLogSTDERR ("  %s host:port --attach=<process_name>\n", DEBUGSERVER_PROGRAM_NAME);
757     RNBLogSTDERR ("  %s /path/file --attach=<process_name>\n", DEBUGSERVER_PROGRAM_NAME);
758     exit (exit_code);
759 }
760 
761 
762 //----------------------------------------------------------------------
763 // option descriptors for getopt_long()
764 //----------------------------------------------------------------------
765 static struct option g_long_options[] =
766 {
767     { "attach",             required_argument,  NULL,               'a' },
768     { "arch",               required_argument,  NULL,               'A' },
769     { "debug",              no_argument,        NULL,               'g' },
770     { "verbose",            no_argument,        NULL,               'v' },
771     { "lockdown",           no_argument,        &g_lockdown_opt,    1   },  // short option "-k"
772     { "applist",            no_argument,        &g_applist_opt,     1   },  // short option "-t"
773     { "log-file",           required_argument,  NULL,               'l' },
774     { "log-flags",          required_argument,  NULL,               'f' },
775     { "launch",             required_argument,  NULL,               'x' },  // Valid values are "auto", "posix-spawn", "fork-exec", "springboard" (arm only)
776     { "waitfor",            required_argument,  NULL,               'w' },  // Wait for a process whose name starts with ARG
777     { "waitfor-interval",   required_argument,  NULL,               'i' },  // Time in usecs to wait between sampling the pid list when waiting for a process by name
778     { "waitfor-duration",   required_argument,  NULL,               'd' },  // The time in seconds to wait for a process to show up by name
779     { "native-regs",        no_argument,        NULL,               'r' },  // Specify to use the native registers instead of the gdb defaults for the architecture.
780     { "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)
781     { "stdin-path",         required_argument,  NULL,               'I' },  // Set the STDIN path to be used when launching applications (only if debugserver launches the process)
782     { "stdout-path",        required_argument,  NULL,               'O' },  // Set the STDOUT path to be used when launching applications (only if debugserver launches the process)
783     { "stderr-path",        required_argument,  NULL,               'E' },  // Set the STDERR path to be used when launching applications (only if debugserver launches the process)
784     { "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)
785     { "setsid",             no_argument,        NULL,               'S' },  // call setsid() to make debugserver run in its own session
786     { "disable-aslr",       no_argument,        NULL,               'D' },  // Use _POSIX_SPAWN_DISABLE_ASLR to avoid shared library randomization
787     { "working-dir",        required_argument,  NULL,               'W' },  // The working directory that the inferior process should have (only if debugserver launches the process)
788     { "platform",           required_argument,  NULL,               'p' },  // Put this executable into a remote platform mode
789     { "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
790     { "open-connection",    no_argument,        NULL,               'H' },  // If debugserver is listening to a TCP port, allow connections from any host (as opposed to just "localhost" connections)
791     { NULL,                 0,                  NULL,               0   }
792 };
793 
794 
795 //----------------------------------------------------------------------
796 // main
797 //----------------------------------------------------------------------
798 int
799 main (int argc, char *argv[])
800 {
801     const char *argv_sub_zero = argv[0]; // save a copy of argv[0] for error reporting post-launch
802 
803     g_isatty = ::isatty (STDIN_FILENO);
804 
805     //  ::printf ("uid=%u euid=%u gid=%u egid=%u\n",
806     //            getuid(),
807     //            geteuid(),
808     //            getgid(),
809     //            getegid());
810 
811 
812     //    signal (SIGINT, signal_handler);
813     signal (SIGPIPE, signal_handler);
814     signal (SIGHUP, signal_handler);
815 
816     g_remoteSP.reset (new RNBRemote ());
817 
818 
819     RNBRemote *remote = g_remoteSP.get();
820     if (remote == NULL)
821     {
822         RNBLogSTDERR ("error: failed to create a remote connection class\n");
823         return -1;
824     }
825 
826     RNBContext& ctx = remote->Context();
827 
828     int i;
829     int attach_pid = INVALID_NUB_PROCESS;
830 
831     FILE* log_file = NULL;
832     uint32_t log_flags = 0;
833     // Parse our options
834     int ch;
835     int long_option_index = 0;
836     int debug = 0;
837     std::string compile_options;
838     std::string waitfor_pid_name;           // Wait for a process that starts with this name
839     std::string attach_pid_name;
840     std::string arch_name;
841     std::string working_dir;                // The new working directory to use for the inferior
842     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
843     useconds_t waitfor_interval = 1000;     // Time in usecs between process lists polls when waiting for a process by name, default 1 msec.
844     useconds_t waitfor_duration = 0;        // Time in seconds to wait for a process by name, 0 means wait forever.
845     bool no_stdio = false;
846     bool localhost_only = true;
847 
848 #if !defined (DNBLOG_ENABLED)
849     compile_options += "(no-logging) ";
850 #endif
851 
852     RNBRunLoopMode start_mode = eRNBRunLoopModeExit;
853 
854     char short_options[512];
855     uint32_t short_options_idx = 0;
856 
857      // Handle the two case that don't have short options in g_long_options
858     short_options[short_options_idx++] = 'k';
859     short_options[short_options_idx++] = 't';
860 
861     for (i=0; g_long_options[i].name != NULL; ++i)
862     {
863         if (isalpha(g_long_options[i].val))
864         {
865             short_options[short_options_idx++] = g_long_options[i].val;
866             switch (g_long_options[i].has_arg)
867             {
868                 default:
869                 case no_argument:
870                     break;
871 
872                 case optional_argument:
873                     short_options[short_options_idx++] = ':';
874                     // Fall through to required_argument case below...
875                 case required_argument:
876                     short_options[short_options_idx++] = ':';
877                     break;
878             }
879         }
880     }
881     // NULL terminate the short option string.
882     short_options[short_options_idx++] = '\0';
883     while ((ch = getopt_long(argc, argv, short_options, g_long_options, &long_option_index)) != -1)
884     {
885         DNBLogDebug("option: ch == %c (0x%2.2x) --%s%c%s\n",
886                     ch, (uint8_t)ch,
887                     g_long_options[long_option_index].name,
888                     g_long_options[long_option_index].has_arg ? '=' : ' ',
889                     optarg ? optarg : "");
890         switch (ch)
891         {
892             case 0:   // Any optional that auto set themselves will return 0
893                 break;
894 
895             case 'A':
896                 if (optarg && optarg[0])
897                     arch_name.assign(optarg);
898                 break;
899 
900             case 'a':
901                 if (optarg && optarg[0])
902                 {
903                     if (isdigit(optarg[0]))
904                     {
905                         char *end = NULL;
906                         attach_pid = strtoul(optarg, &end, 0);
907                         if (end == NULL || *end != '\0')
908                         {
909                             RNBLogSTDERR ("error: invalid pid option '%s'\n", optarg);
910                             exit (4);
911                         }
912                     }
913                     else
914                     {
915                         attach_pid_name = optarg;
916                     }
917                     start_mode = eRNBRunLoopModeInferiorAttaching;
918                 }
919                 break;
920 
921                 // --waitfor=NAME
922             case 'w':
923                 if (optarg && optarg[0])
924                 {
925                     waitfor_pid_name = optarg;
926                     start_mode = eRNBRunLoopModeInferiorAttaching;
927                 }
928                 break;
929 
930                 // --waitfor-interval=USEC
931             case 'i':
932                 if (optarg && optarg[0])
933                 {
934                     char *end = NULL;
935                     waitfor_interval = strtoul(optarg, &end, 0);
936                     if (end == NULL || *end != '\0')
937                     {
938                         RNBLogSTDERR ("error: invalid waitfor-interval option value '%s'.\n", optarg);
939                         exit (6);
940                     }
941                 }
942                 break;
943 
944                 // --waitfor-duration=SEC
945             case 'd':
946                 if (optarg && optarg[0])
947                 {
948                     char *end = NULL;
949                     waitfor_duration = strtoul(optarg, &end, 0);
950                     if (end == NULL || *end != '\0')
951                     {
952                         RNBLogSTDERR ("error: invalid waitfor-duration option value '%s'.\n", optarg);
953                         exit (7);
954                     }
955                 }
956                 break;
957 
958             case 'W':
959                 if (optarg && optarg[0])
960                     working_dir.assign(optarg);
961                 break;
962 
963             case 'x':
964                 if (optarg && optarg[0])
965                 {
966                     if (strcasecmp(optarg, "auto") == 0)
967                         g_launch_flavor = eLaunchFlavorDefault;
968                     else if (strcasestr(optarg, "posix") == optarg)
969                         g_launch_flavor = eLaunchFlavorPosixSpawn;
970                     else if (strcasestr(optarg, "fork") == optarg)
971                         g_launch_flavor = eLaunchFlavorForkExec;
972 #ifdef WITH_SPRINGBOARD
973                     else if (strcasestr(optarg, "spring") == optarg)
974                         g_launch_flavor = eLaunchFlavorSpringBoard;
975 #endif
976                     else
977                     {
978                         RNBLogSTDERR ("error: invalid TYPE for the --launch=TYPE (-x TYPE) option: '%s'\n", optarg);
979                         RNBLogSTDERR ("Valid values TYPE are:\n");
980                         RNBLogSTDERR ("  auto    Auto-detect the best launch method to use.\n");
981                         RNBLogSTDERR ("  posix   Launch the executable using posix_spawn.\n");
982                         RNBLogSTDERR ("  fork    Launch the executable using fork and exec.\n");
983 #ifdef WITH_SPRINGBOARD
984                         RNBLogSTDERR ("  spring  Launch the executable through Springboard.\n");
985 #endif
986                         exit (5);
987                     }
988                 }
989                 break;
990 
991             case 'l': // Set Log File
992                 if (optarg && optarg[0])
993                 {
994                     if (strcasecmp(optarg, "stdout") == 0)
995                         log_file = stdout;
996                     else if (strcasecmp(optarg, "stderr") == 0)
997                         log_file = stderr;
998                     else
999                     {
1000                         log_file = fopen(optarg, "w");
1001                         if (log_file != NULL)
1002                             setlinebuf(log_file);
1003                     }
1004 
1005                     if (log_file == NULL)
1006                     {
1007                         const char *errno_str = strerror(errno);
1008                         RNBLogSTDERR ("Failed to open log file '%s' for writing: errno = %i (%s)", optarg, errno, errno_str ? errno_str : "unknown error");
1009                     }
1010                 }
1011                 break;
1012 
1013             case 'f': // Log Flags
1014                 if (optarg && optarg[0])
1015                     log_flags = strtoul(optarg, NULL, 0);
1016                 break;
1017 
1018             case 'g':
1019                 debug = 1;
1020                 DNBLogSetDebug(debug);
1021                 break;
1022 
1023             case 't':
1024                 g_applist_opt = 1;
1025                 break;
1026 
1027             case 'k':
1028                 g_lockdown_opt = 1;
1029                 break;
1030 
1031             case 'r':
1032                 remote->SetUseNativeRegisters (true);
1033                 break;
1034 
1035             case 'v':
1036                 DNBLogSetVerbose(1);
1037                 break;
1038 
1039             case 's':
1040                 ctx.GetSTDIN().assign(optarg);
1041                 ctx.GetSTDOUT().assign(optarg);
1042                 ctx.GetSTDERR().assign(optarg);
1043                 break;
1044 
1045             case 'I':
1046                 ctx.GetSTDIN().assign(optarg);
1047                 break;
1048 
1049             case 'O':
1050                 ctx.GetSTDOUT().assign(optarg);
1051                 break;
1052 
1053             case 'E':
1054                 ctx.GetSTDERR().assign(optarg);
1055                 break;
1056 
1057             case 'n':
1058                 no_stdio = true;
1059                 break;
1060 
1061             case 'S':
1062                 // Put debugserver into a new session. Terminals group processes
1063                 // into sessions and when a special terminal key sequences
1064                 // (like control+c) are typed they can cause signals to go out to
1065                 // all processes in a session. Using this --setsid (-S) option
1066                 // will cause debugserver to run in its own sessions and be free
1067                 // from such issues.
1068                 //
1069                 // This is useful when debugserver is spawned from a command
1070                 // line application that uses debugserver to do the debugging,
1071                 // yet that application doesn't want debugserver receiving the
1072                 // signals sent to the session (i.e. dying when anyone hits ^C).
1073                 setsid();
1074                 break;
1075             case 'D':
1076                 g_disable_aslr = 1;
1077                 break;
1078 
1079             case 'p':
1080                 start_mode = eRNBRunLoopModePlatformMode;
1081                 break;
1082 
1083             case 'u':
1084                 unix_socket_name.assign (optarg);
1085                 break;
1086 
1087             case 'H':
1088                 localhost_only = false;
1089                 break;
1090         }
1091     }
1092 
1093     if (arch_name.empty())
1094     {
1095 #if defined (__arm__)
1096         arch_name.assign ("arm");
1097 #endif
1098     }
1099     else
1100     {
1101         DNBSetArchitecture (arch_name.c_str());
1102     }
1103 
1104 //    if (arch_name.empty())
1105 //    {
1106 //        fprintf(stderr, "error: no architecture was specified\n");
1107 //        exit (8);
1108 //    }
1109     // Skip any options we consumed with getopt_long
1110     argc -= optind;
1111     argv += optind;
1112 
1113 
1114     if (!working_dir.empty())
1115     {
1116         if (remote->Context().SetWorkingDirectory (working_dir.c_str()) == false)
1117         {
1118             RNBLogSTDERR ("error: working directory doesn't exist '%s'.\n", working_dir.c_str());
1119             exit (8);
1120         }
1121     }
1122 
1123     remote->Initialize();
1124 
1125     // It is ok for us to set NULL as the logfile (this will disable any logging)
1126 
1127     if (log_file != NULL)
1128     {
1129         DNBLogSetLogCallback(FileLogCallback, log_file);
1130         // If our log file was set, yet we have no log flags, log everything!
1131         if (log_flags == 0)
1132             log_flags = LOG_ALL | LOG_RNB_ALL;
1133 
1134         DNBLogSetLogMask (log_flags);
1135     }
1136     else
1137     {
1138         // Enable DNB logging
1139         DNBLogSetLogCallback(ASLLogCallback, NULL);
1140         DNBLogSetLogMask (log_flags);
1141 
1142     }
1143 
1144     if (DNBLogEnabled())
1145     {
1146         for (i=0; i<argc; i++)
1147             DNBLogDebug("argv[%i] = %s", i, argv[i]);
1148     }
1149 
1150     // as long as we're dropping remotenub in as a replacement for gdbserver,
1151     // explicitly note that this is not gdbserver.
1152 
1153     RNBLogSTDOUT ("%s-%g %sfor %s.\n",
1154                   DEBUGSERVER_PROGRAM_NAME,
1155                   DEBUGSERVER_VERSION_NUM,
1156                   compile_options.c_str(),
1157                   RNB_ARCH);
1158 
1159     int listen_port = INT32_MAX;
1160     char str[PATH_MAX];
1161     str[0] = '\0';
1162 
1163     if (g_lockdown_opt == 0 && g_applist_opt == 0)
1164     {
1165         // Make sure we at least have port
1166         if (argc < 1)
1167         {
1168             show_usage_and_exit (1);
1169         }
1170         // accept 'localhost:' prefix on port number
1171 
1172         int items_scanned = ::sscanf (argv[0], "%[^:]:%i", str, &listen_port);
1173         if (items_scanned == 2)
1174         {
1175             DNBLogDebug("host = '%s'  port = %i", str, listen_port);
1176         }
1177         else if (argv[0][0] == '/')
1178         {
1179             listen_port = INT32_MAX;
1180             strncpy(str, argv[0], sizeof(str));
1181         }
1182         else
1183         {
1184             show_usage_and_exit (2);
1185         }
1186 
1187         // We just used the 'host:port' or the '/path/file' arg...
1188         argc--;
1189         argv++;
1190 
1191     }
1192 
1193     //  If we know we're waiting to attach, we don't need any of this other info.
1194     if (start_mode != eRNBRunLoopModeInferiorAttaching &&
1195         start_mode != eRNBRunLoopModePlatformMode)
1196     {
1197         if (argc == 0 || g_lockdown_opt)
1198         {
1199             if (g_lockdown_opt != 0)
1200             {
1201                 // Work around for SIGPIPE crashes due to posix_spawn issue.
1202                 // We have to close STDOUT and STDERR, else the first time we
1203                 // try and do any, we get SIGPIPE and die as posix_spawn is
1204                 // doing bad things with our file descriptors at the moment.
1205                 int null = open("/dev/null", O_RDWR);
1206                 dup2(null, STDOUT_FILENO);
1207                 dup2(null, STDERR_FILENO);
1208             }
1209             else if (g_applist_opt != 0)
1210             {
1211                 // List all applications we are able to see
1212                 std::string applist_plist;
1213                 int err = ListApplications(applist_plist, false, false);
1214                 if (err == 0)
1215                 {
1216                     fputs (applist_plist.c_str(), stdout);
1217                 }
1218                 else
1219                 {
1220                     RNBLogSTDERR ("error: ListApplications returned error %i\n", err);
1221                 }
1222                 // Exit with appropriate error if we were asked to list the applications
1223                 // with no other args were given (and we weren't trying to do this over
1224                 // lockdown)
1225                 return err;
1226             }
1227 
1228             DNBLogDebug("Get args from remote protocol...");
1229             start_mode = eRNBRunLoopModeGetStartModeFromRemoteProtocol;
1230         }
1231         else
1232         {
1233             start_mode = eRNBRunLoopModeInferiorLaunching;
1234             // Fill in the argv array in the context from the rest of our args.
1235             // Skip the name of this executable and the port number
1236             for (int i = 0; i < argc; i++)
1237             {
1238                 DNBLogDebug("inferior_argv[%i] = '%s'", i, argv[i]);
1239                 ctx.PushArgument (argv[i]);
1240             }
1241         }
1242     }
1243 
1244     if (start_mode == eRNBRunLoopModeExit)
1245         return -1;
1246 
1247     RNBRunLoopMode mode = start_mode;
1248     char err_str[1024] = {'\0'};
1249 
1250     while (mode != eRNBRunLoopModeExit)
1251     {
1252         switch (mode)
1253         {
1254             case eRNBRunLoopModeGetStartModeFromRemoteProtocol:
1255 #ifdef WITH_LOCKDOWN
1256                 if (g_lockdown_opt)
1257                 {
1258                     if (!remote->Comm().IsConnected())
1259                     {
1260                         if (remote->Comm().ConnectToService () != rnb_success)
1261                         {
1262                             RNBLogSTDERR ("Failed to get connection from a remote gdb process.\n");
1263                             mode = eRNBRunLoopModeExit;
1264                         }
1265                         else if (g_applist_opt != 0)
1266                         {
1267                             // List all applications we are able to see
1268                             std::string applist_plist;
1269                             if (ListApplications(applist_plist, false, false) == 0)
1270                             {
1271                                 DNBLogDebug("Task list: %s", applist_plist.c_str());
1272 
1273                                 remote->Comm().Write(applist_plist.c_str(), applist_plist.size());
1274                                 // Issue a read that will never yield any data until the other side
1275                                 // closes the socket so this process doesn't just exit and cause the
1276                                 // socket to close prematurely on the other end and cause data loss.
1277                                 std::string buf;
1278                                 remote->Comm().Read(buf);
1279                             }
1280                             remote->Comm().Disconnect(false);
1281                             mode = eRNBRunLoopModeExit;
1282                             break;
1283                         }
1284                         else
1285                         {
1286                             // Start watching for remote packets
1287                             remote->StartReadRemoteDataThread();
1288                         }
1289                     }
1290                 }
1291                 else
1292 #endif
1293                 if (listen_port != INT32_MAX)
1294                 {
1295                     if (!StartListening (remote, listen_port, unix_socket_name.c_str(), localhost_only))
1296                         mode = eRNBRunLoopModeExit;
1297                 }
1298                 else if (str[0] == '/')
1299                 {
1300                     if (remote->Comm().OpenFile (str))
1301                         mode = eRNBRunLoopModeExit;
1302                 }
1303 
1304                 if (mode != eRNBRunLoopModeExit)
1305                 {
1306                     RNBLogSTDOUT ("Got a connection, waiting for process information for launching or attaching.\n");
1307 
1308                     mode = RNBRunLoopGetStartModeFromRemote (remote);
1309                 }
1310                 break;
1311 
1312             case eRNBRunLoopModeInferiorAttaching:
1313                 if (!waitfor_pid_name.empty())
1314                 {
1315                     // Set our end wait time if we are using a waitfor-duration
1316                     // option that may have been specified
1317                     struct timespec attach_timeout_abstime, *timeout_ptr = NULL;
1318                     if (waitfor_duration != 0)
1319                     {
1320                         DNBTimer::OffsetTimeOfDay(&attach_timeout_abstime, waitfor_duration, 0);
1321                         timeout_ptr = &attach_timeout_abstime;
1322                     }
1323                     nub_launch_flavor_t launch_flavor = g_launch_flavor;
1324                     if (launch_flavor == eLaunchFlavorDefault)
1325                     {
1326                         // Our default launch method is posix spawn
1327                         launch_flavor = eLaunchFlavorPosixSpawn;
1328 
1329 #ifdef WITH_SPRINGBOARD
1330                         // Check if we have an app bundle, if so launch using SpringBoard.
1331                         if (waitfor_pid_name.find (".app") != std::string::npos)
1332                         {
1333                             launch_flavor = eLaunchFlavorSpringBoard;
1334                         }
1335 #endif
1336                     }
1337 
1338                     ctx.SetLaunchFlavor(launch_flavor);
1339                     bool ignore_existing = false;
1340                     RNBLogSTDOUT ("Waiting to attach to process %s...\n", waitfor_pid_name.c_str());
1341                     nub_process_t pid = DNBProcessAttachWait (waitfor_pid_name.c_str(), launch_flavor, ignore_existing, timeout_ptr, waitfor_interval, err_str, sizeof(err_str));
1342                     g_pid = pid;
1343 
1344                     if (pid == INVALID_NUB_PROCESS)
1345                     {
1346                         ctx.LaunchStatus().SetError(-1, DNBError::Generic);
1347                         if (err_str[0])
1348                             ctx.LaunchStatus().SetErrorString(err_str);
1349                         RNBLogSTDERR ("error: failed to attach to process named: \"%s\" %s\n", waitfor_pid_name.c_str(), err_str);
1350                         mode = eRNBRunLoopModeExit;
1351                     }
1352                     else
1353                     {
1354                         ctx.SetProcessID(pid);
1355                         mode = eRNBRunLoopModeInferiorExecuting;
1356                     }
1357                 }
1358                 else if (attach_pid != INVALID_NUB_PROCESS)
1359                 {
1360 
1361                     RNBLogSTDOUT ("Attaching to process %i...\n", attach_pid);
1362                     nub_process_t attached_pid;
1363                     mode = RNBRunLoopLaunchAttaching (remote, attach_pid, attached_pid);
1364                     if (mode != eRNBRunLoopModeInferiorExecuting)
1365                     {
1366                         const char *error_str = remote->Context().LaunchStatus().AsString();
1367                         RNBLogSTDERR ("error: failed to attach process %i: %s\n", attach_pid, error_str ? error_str : "unknown error.");
1368                         mode = eRNBRunLoopModeExit;
1369                     }
1370                 }
1371                 else if (!attach_pid_name.empty ())
1372                 {
1373                     struct timespec attach_timeout_abstime, *timeout_ptr = NULL;
1374                     if (waitfor_duration != 0)
1375                     {
1376                         DNBTimer::OffsetTimeOfDay(&attach_timeout_abstime, waitfor_duration, 0);
1377                         timeout_ptr = &attach_timeout_abstime;
1378                     }
1379 
1380                     RNBLogSTDOUT ("Attaching to process %s...\n", attach_pid_name.c_str());
1381                     nub_process_t pid = DNBProcessAttachByName (attach_pid_name.c_str(), timeout_ptr, err_str, sizeof(err_str));
1382                     g_pid = pid;
1383                     if (pid == INVALID_NUB_PROCESS)
1384                     {
1385                         ctx.LaunchStatus().SetError(-1, DNBError::Generic);
1386                         if (err_str[0])
1387                             ctx.LaunchStatus().SetErrorString(err_str);
1388                         RNBLogSTDERR ("error: failed to attach to process named: \"%s\" %s\n", waitfor_pid_name.c_str(), err_str);
1389                         mode = eRNBRunLoopModeExit;
1390                     }
1391                     else
1392                     {
1393                         ctx.SetProcessID(pid);
1394                         mode = eRNBRunLoopModeInferiorExecuting;
1395                     }
1396 
1397                 }
1398                 else
1399                 {
1400                     RNBLogSTDERR ("error: asked to attach with empty name and invalid PID.\n");
1401                     mode = eRNBRunLoopModeExit;
1402                 }
1403 
1404                 if (mode != eRNBRunLoopModeExit)
1405                 {
1406                     if (listen_port != INT32_MAX)
1407                     {
1408                         if (!StartListening (remote, listen_port, unix_socket_name.c_str(), localhost_only))
1409                             mode = eRNBRunLoopModeExit;
1410                     }
1411                     else if (str[0] == '/')
1412                     {
1413                         if (remote->Comm().OpenFile (str))
1414                             mode = eRNBRunLoopModeExit;
1415                     }
1416                     if (mode != eRNBRunLoopModeExit)
1417                         RNBLogSTDOUT ("Waiting for debugger instructions for process %d.\n", attach_pid);
1418                 }
1419                 break;
1420 
1421             case eRNBRunLoopModeInferiorLaunching:
1422                 {
1423                     mode = RNBRunLoopLaunchInferior (remote,
1424                                                      ctx.GetSTDINPath(),
1425                                                      ctx.GetSTDOUTPath(),
1426                                                      ctx.GetSTDERRPath(),
1427                                                      no_stdio);
1428 
1429                     if (mode == eRNBRunLoopModeInferiorExecuting)
1430                     {
1431                         if (listen_port != INT32_MAX)
1432                         {
1433                             if (!StartListening (remote, listen_port, unix_socket_name.c_str(), localhost_only))
1434                                 mode = eRNBRunLoopModeExit;
1435                         }
1436                         else if (str[0] == '/')
1437                         {
1438                             if (remote->Comm().OpenFile (str))
1439                                 mode = eRNBRunLoopModeExit;
1440                         }
1441 
1442                         if (mode != eRNBRunLoopModeExit)
1443                             RNBLogSTDOUT ("Got a connection, launched process %s.\n", argv_sub_zero);
1444                     }
1445                     else
1446                     {
1447                         const char *error_str = remote->Context().LaunchStatus().AsString();
1448                         RNBLogSTDERR ("error: failed to launch process %s: %s\n", argv_sub_zero, error_str ? error_str : "unknown error.");
1449                     }
1450                 }
1451                 break;
1452 
1453             case eRNBRunLoopModeInferiorExecuting:
1454                 mode = RNBRunLoopInferiorExecuting(remote);
1455                 break;
1456 
1457             case eRNBRunLoopModePlatformMode:
1458                 if (listen_port != INT32_MAX)
1459                 {
1460                     if (!StartListening (remote, listen_port, unix_socket_name.c_str(), localhost_only))
1461                         mode = eRNBRunLoopModeExit;
1462                 }
1463                 else if (str[0] == '/')
1464                 {
1465                     if (remote->Comm().OpenFile (str))
1466                         mode = eRNBRunLoopModeExit;
1467                 }
1468 
1469                 if (mode != eRNBRunLoopModeExit)
1470                     mode = RNBRunLoopPlatform (remote);
1471                 break;
1472 
1473             default:
1474                 mode = eRNBRunLoopModeExit;
1475             case eRNBRunLoopModeExit:
1476                 break;
1477         }
1478     }
1479 
1480     remote->StopReadRemoteDataThread ();
1481     remote->Context().SetProcessID(INVALID_NUB_PROCESS);
1482     RNBLogSTDOUT ("Exiting.\n");
1483 
1484     return 0;
1485 }
1486