1 //===-- Process.cpp ---------------------------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "lldb/Target/Process.h"
11 #include "lldb/Breakpoint/StoppointCallbackContext.h"
12 #include "lldb/Breakpoint/BreakpointLocation.h"
13 #include "lldb/Core/Event.h"
14 #include "lldb/Core/Debugger.h"
15 #include "lldb/Core/Log.h"
16 #include "lldb/Core/Module.h"
17 #include "lldb/Core/ModuleSpec.h"
18 #include "lldb/Core/PluginManager.h"
19 #include "lldb/Core/State.h"
20 #include "lldb/Core/StreamFile.h"
21 #include "lldb/Expression/UserExpression.h"
22 #include "lldb/Expression/IRDynamicChecks.h"
23 #include "lldb/Host/ConnectionFileDescriptor.h"
24 #include "lldb/Host/Host.h"
25 #include "lldb/Host/HostInfo.h"
26 #include "lldb/Host/Pipe.h"
27 #include "lldb/Host/Terminal.h"
28 #include "lldb/Host/ThreadLauncher.h"
29 #include "lldb/Interpreter/CommandInterpreter.h"
30 #include "lldb/Interpreter/OptionValueProperties.h"
31 #include "lldb/Symbol/Function.h"
32 #include "lldb/Symbol/Symbol.h"
33 #include "lldb/Target/ABI.h"
34 #include "lldb/Target/DynamicLoader.h"
35 #include "lldb/Target/InstrumentationRuntime.h"
36 #include "lldb/Target/JITLoader.h"
37 #include "lldb/Target/JITLoaderList.h"
38 #include "lldb/Target/MemoryHistory.h"
39 #include "lldb/Target/MemoryRegionInfo.h"
40 #include "lldb/Target/OperatingSystem.h"
41 #include "lldb/Target/LanguageRuntime.h"
42 #include "lldb/Target/CPPLanguageRuntime.h"
43 #include "lldb/Target/ObjCLanguageRuntime.h"
44 #include "lldb/Target/Platform.h"
45 #include "lldb/Target/RegisterContext.h"
46 #include "lldb/Target/StopInfo.h"
47 #include "lldb/Target/SystemRuntime.h"
48 #include "lldb/Target/Target.h"
49 #include "lldb/Target/TargetList.h"
50 #include "lldb/Target/Thread.h"
51 #include "lldb/Target/ThreadPlan.h"
52 #include "lldb/Target/ThreadPlanBase.h"
53 #include "lldb/Target/UnixSignals.h"
54 #include "lldb/Utility/NameMatches.h"
55 #include "Plugins/Process/Utility/InferiorCallPOSIX.h"
56 
57 using namespace lldb;
58 using namespace lldb_private;
59 
60 
61 // Comment out line below to disable memory caching, overriding the process setting
62 // target.process.disable-memory-cache
63 #define ENABLE_MEMORY_CACHING
64 
65 #ifdef ENABLE_MEMORY_CACHING
66 #define DISABLE_MEM_CACHE_DEFAULT false
67 #else
68 #define DISABLE_MEM_CACHE_DEFAULT true
69 #endif
70 
71 class ProcessOptionValueProperties : public OptionValueProperties
72 {
73 public:
74     ProcessOptionValueProperties (const ConstString &name) :
75         OptionValueProperties (name)
76     {
77     }
78 
79     // This constructor is used when creating ProcessOptionValueProperties when it
80     // is part of a new lldb_private::Process instance. It will copy all current
81     // global property values as needed
82     ProcessOptionValueProperties (ProcessProperties *global_properties) :
83         OptionValueProperties(*global_properties->GetValueProperties())
84     {
85     }
86 
87     virtual const Property *
88     GetPropertyAtIndex (const ExecutionContext *exe_ctx, bool will_modify, uint32_t idx) const
89     {
90         // When getting the value for a key from the process options, we will always
91         // try and grab the setting from the current process if there is one. Else we just
92         // use the one from this instance.
93         if (exe_ctx)
94         {
95             Process *process = exe_ctx->GetProcessPtr();
96             if (process)
97             {
98                 ProcessOptionValueProperties *instance_properties = static_cast<ProcessOptionValueProperties *>(process->GetValueProperties().get());
99                 if (this != instance_properties)
100                     return instance_properties->ProtectedGetPropertyAtIndex (idx);
101             }
102         }
103         return ProtectedGetPropertyAtIndex (idx);
104     }
105 };
106 
107 static PropertyDefinition
108 g_properties[] =
109 {
110     { "disable-memory-cache" , OptionValue::eTypeBoolean, false, DISABLE_MEM_CACHE_DEFAULT, NULL, NULL, "Disable reading and caching of memory in fixed-size units." },
111     { "extra-startup-command", OptionValue::eTypeArray  , false, OptionValue::eTypeString, NULL, NULL, "A list containing extra commands understood by the particular process plugin used.  "
112                                                                                                        "For instance, to turn on debugserver logging set this to \"QSetLogging:bitmask=LOG_DEFAULT;\"" },
113     { "ignore-breakpoints-in-expressions", OptionValue::eTypeBoolean, true, true, NULL, NULL, "If true, breakpoints will be ignored during expression evaluation." },
114     { "unwind-on-error-in-expressions", OptionValue::eTypeBoolean, true, true, NULL, NULL, "If true, errors in expression evaluation will unwind the stack back to the state before the call." },
115     { "python-os-plugin-path", OptionValue::eTypeFileSpec, false, true, NULL, NULL, "A path to a python OS plug-in module file that contains a OperatingSystemPlugIn class." },
116     { "stop-on-sharedlibrary-events" , OptionValue::eTypeBoolean, true, false, NULL, NULL, "If true, stop when a shared library is loaded or unloaded." },
117     { "detach-keeps-stopped" , OptionValue::eTypeBoolean, true, false, NULL, NULL, "If true, detach will attempt to keep the process stopped." },
118     { "memory-cache-line-size" , OptionValue::eTypeUInt64, false, 512, NULL, NULL, "The memory cache line size" },
119     { "optimization-warnings" , OptionValue::eTypeBoolean, false, true, NULL, NULL, "If true, warn when stopped in code that is optimized where stepping and variable availability may not behave as expected." },
120     {  NULL                  , OptionValue::eTypeInvalid, false, 0, NULL, NULL, NULL  }
121 };
122 
123 enum {
124     ePropertyDisableMemCache,
125     ePropertyExtraStartCommand,
126     ePropertyIgnoreBreakpointsInExpressions,
127     ePropertyUnwindOnErrorInExpressions,
128     ePropertyPythonOSPluginPath,
129     ePropertyStopOnSharedLibraryEvents,
130     ePropertyDetachKeepsStopped,
131     ePropertyMemCacheLineSize,
132     ePropertyWarningOptimization
133 };
134 
135 ProcessProperties::ProcessProperties (lldb_private::Process *process) :
136     Properties (),
137     m_process (process) // Can be NULL for global ProcessProperties
138 {
139     if (process == NULL)
140     {
141         // Global process properties, set them up one time
142         m_collection_sp.reset (new ProcessOptionValueProperties(ConstString("process")));
143         m_collection_sp->Initialize(g_properties);
144         m_collection_sp->AppendProperty(ConstString("thread"),
145                                         ConstString("Settings specific to threads."),
146                                         true,
147                                         Thread::GetGlobalProperties()->GetValueProperties());
148     }
149     else
150     {
151         m_collection_sp.reset (new ProcessOptionValueProperties(Process::GetGlobalProperties().get()));
152         m_collection_sp->SetValueChangedCallback(ePropertyPythonOSPluginPath, ProcessProperties::OptionValueChangedCallback, this);
153     }
154 }
155 
156 ProcessProperties::~ProcessProperties()
157 {
158 }
159 
160 void
161 ProcessProperties::OptionValueChangedCallback (void *baton, OptionValue *option_value)
162 {
163     ProcessProperties *properties = (ProcessProperties *)baton;
164     if (properties->m_process)
165         properties->m_process->LoadOperatingSystemPlugin(true);
166 }
167 
168 bool
169 ProcessProperties::GetDisableMemoryCache() const
170 {
171     const uint32_t idx = ePropertyDisableMemCache;
172     return m_collection_sp->GetPropertyAtIndexAsBoolean (NULL, idx, g_properties[idx].default_uint_value != 0);
173 }
174 
175 uint64_t
176 ProcessProperties::GetMemoryCacheLineSize() const
177 {
178     const uint32_t idx = ePropertyMemCacheLineSize;
179     return m_collection_sp->GetPropertyAtIndexAsUInt64 (NULL, idx, g_properties[idx].default_uint_value);
180 }
181 
182 Args
183 ProcessProperties::GetExtraStartupCommands () const
184 {
185     Args args;
186     const uint32_t idx = ePropertyExtraStartCommand;
187     m_collection_sp->GetPropertyAtIndexAsArgs(NULL, idx, args);
188     return args;
189 }
190 
191 void
192 ProcessProperties::SetExtraStartupCommands (const Args &args)
193 {
194     const uint32_t idx = ePropertyExtraStartCommand;
195     m_collection_sp->SetPropertyAtIndexFromArgs(NULL, idx, args);
196 }
197 
198 FileSpec
199 ProcessProperties::GetPythonOSPluginPath () const
200 {
201     const uint32_t idx = ePropertyPythonOSPluginPath;
202     return m_collection_sp->GetPropertyAtIndexAsFileSpec(NULL, idx);
203 }
204 
205 void
206 ProcessProperties::SetPythonOSPluginPath (const FileSpec &file)
207 {
208     const uint32_t idx = ePropertyPythonOSPluginPath;
209     m_collection_sp->SetPropertyAtIndexAsFileSpec(NULL, idx, file);
210 }
211 
212 
213 bool
214 ProcessProperties::GetIgnoreBreakpointsInExpressions () const
215 {
216     const uint32_t idx = ePropertyIgnoreBreakpointsInExpressions;
217     return m_collection_sp->GetPropertyAtIndexAsBoolean(NULL, idx, g_properties[idx].default_uint_value != 0);
218 }
219 
220 void
221 ProcessProperties::SetIgnoreBreakpointsInExpressions (bool ignore)
222 {
223     const uint32_t idx = ePropertyIgnoreBreakpointsInExpressions;
224     m_collection_sp->SetPropertyAtIndexAsBoolean(NULL, idx, ignore);
225 }
226 
227 bool
228 ProcessProperties::GetUnwindOnErrorInExpressions () const
229 {
230     const uint32_t idx = ePropertyUnwindOnErrorInExpressions;
231     return m_collection_sp->GetPropertyAtIndexAsBoolean(NULL, idx, g_properties[idx].default_uint_value != 0);
232 }
233 
234 void
235 ProcessProperties::SetUnwindOnErrorInExpressions (bool ignore)
236 {
237     const uint32_t idx = ePropertyUnwindOnErrorInExpressions;
238     m_collection_sp->SetPropertyAtIndexAsBoolean(NULL, idx, ignore);
239 }
240 
241 bool
242 ProcessProperties::GetStopOnSharedLibraryEvents () const
243 {
244     const uint32_t idx = ePropertyStopOnSharedLibraryEvents;
245     return m_collection_sp->GetPropertyAtIndexAsBoolean(NULL, idx, g_properties[idx].default_uint_value != 0);
246 }
247 
248 void
249 ProcessProperties::SetStopOnSharedLibraryEvents (bool stop)
250 {
251     const uint32_t idx = ePropertyStopOnSharedLibraryEvents;
252     m_collection_sp->SetPropertyAtIndexAsBoolean(NULL, idx, stop);
253 }
254 
255 bool
256 ProcessProperties::GetDetachKeepsStopped () const
257 {
258     const uint32_t idx = ePropertyDetachKeepsStopped;
259     return m_collection_sp->GetPropertyAtIndexAsBoolean(NULL, idx, g_properties[idx].default_uint_value != 0);
260 }
261 
262 void
263 ProcessProperties::SetDetachKeepsStopped (bool stop)
264 {
265     const uint32_t idx = ePropertyDetachKeepsStopped;
266     m_collection_sp->SetPropertyAtIndexAsBoolean(NULL, idx, stop);
267 }
268 
269 bool
270 ProcessProperties::GetWarningsOptimization () const
271 {
272     const uint32_t idx = ePropertyWarningOptimization;
273     return m_collection_sp->GetPropertyAtIndexAsBoolean (NULL, idx, g_properties[idx].default_uint_value != 0);
274 }
275 
276 void
277 ProcessInstanceInfo::Dump (Stream &s, Platform *platform) const
278 {
279     const char *cstr;
280     if (m_pid != LLDB_INVALID_PROCESS_ID)
281         s.Printf ("    pid = %" PRIu64 "\n", m_pid);
282 
283     if (m_parent_pid != LLDB_INVALID_PROCESS_ID)
284         s.Printf (" parent = %" PRIu64 "\n", m_parent_pid);
285 
286     if (m_executable)
287     {
288         s.Printf ("   name = %s\n", m_executable.GetFilename().GetCString());
289         s.PutCString ("   file = ");
290         m_executable.Dump(&s);
291         s.EOL();
292     }
293     const uint32_t argc = m_arguments.GetArgumentCount();
294     if (argc > 0)
295     {
296         for (uint32_t i=0; i<argc; i++)
297         {
298             const char *arg = m_arguments.GetArgumentAtIndex(i);
299             if (i < 10)
300                 s.Printf (" arg[%u] = %s\n", i, arg);
301             else
302                 s.Printf ("arg[%u] = %s\n", i, arg);
303         }
304     }
305 
306     const uint32_t envc = m_environment.GetArgumentCount();
307     if (envc > 0)
308     {
309         for (uint32_t i=0; i<envc; i++)
310         {
311             const char *env = m_environment.GetArgumentAtIndex(i);
312             if (i < 10)
313                 s.Printf (" env[%u] = %s\n", i, env);
314             else
315                 s.Printf ("env[%u] = %s\n", i, env);
316         }
317     }
318 
319     if (m_arch.IsValid())
320         s.Printf ("   arch = %s\n", m_arch.GetTriple().str().c_str());
321 
322     if (m_uid != UINT32_MAX)
323     {
324         cstr = platform->GetUserName (m_uid);
325         s.Printf ("    uid = %-5u (%s)\n", m_uid, cstr ? cstr : "");
326     }
327     if (m_gid != UINT32_MAX)
328     {
329         cstr = platform->GetGroupName (m_gid);
330         s.Printf ("    gid = %-5u (%s)\n", m_gid, cstr ? cstr : "");
331     }
332     if (m_euid != UINT32_MAX)
333     {
334         cstr = platform->GetUserName (m_euid);
335         s.Printf ("   euid = %-5u (%s)\n", m_euid, cstr ? cstr : "");
336     }
337     if (m_egid != UINT32_MAX)
338     {
339         cstr = platform->GetGroupName (m_egid);
340         s.Printf ("   egid = %-5u (%s)\n", m_egid, cstr ? cstr : "");
341     }
342 }
343 
344 void
345 ProcessInstanceInfo::DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose)
346 {
347     const char *label;
348     if (show_args || verbose)
349         label = "ARGUMENTS";
350     else
351         label = "NAME";
352 
353     if (verbose)
354     {
355         s.Printf     ("PID    PARENT USER       GROUP      EFF USER   EFF GROUP  TRIPLE                   %s\n", label);
356         s.PutCString ("====== ====== ========== ========== ========== ========== ======================== ============================\n");
357     }
358     else
359     {
360         s.Printf     ("PID    PARENT USER       TRIPLE                   %s\n", label);
361         s.PutCString ("====== ====== ========== ======================== ============================\n");
362     }
363 }
364 
365 void
366 ProcessInstanceInfo::DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const
367 {
368     if (m_pid != LLDB_INVALID_PROCESS_ID)
369     {
370         const char *cstr;
371         s.Printf ("%-6" PRIu64 " %-6" PRIu64 " ", m_pid, m_parent_pid);
372 
373 
374         if (verbose)
375         {
376             cstr = platform->GetUserName (m_uid);
377             if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
378                 s.Printf ("%-10s ", cstr);
379             else
380                 s.Printf ("%-10u ", m_uid);
381 
382             cstr = platform->GetGroupName (m_gid);
383             if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
384                 s.Printf ("%-10s ", cstr);
385             else
386                 s.Printf ("%-10u ", m_gid);
387 
388             cstr = platform->GetUserName (m_euid);
389             if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
390                 s.Printf ("%-10s ", cstr);
391             else
392                 s.Printf ("%-10u ", m_euid);
393 
394             cstr = platform->GetGroupName (m_egid);
395             if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
396                 s.Printf ("%-10s ", cstr);
397             else
398                 s.Printf ("%-10u ", m_egid);
399             s.Printf ("%-24s ", m_arch.IsValid() ? m_arch.GetTriple().str().c_str() : "");
400         }
401         else
402         {
403             s.Printf ("%-10s %-24s ",
404                       platform->GetUserName (m_euid),
405                       m_arch.IsValid() ? m_arch.GetTriple().str().c_str() : "");
406         }
407 
408         if (verbose || show_args)
409         {
410             const uint32_t argc = m_arguments.GetArgumentCount();
411             if (argc > 0)
412             {
413                 for (uint32_t i=0; i<argc; i++)
414                 {
415                     if (i > 0)
416                         s.PutChar (' ');
417                     s.PutCString (m_arguments.GetArgumentAtIndex(i));
418                 }
419             }
420         }
421         else
422         {
423             s.PutCString (GetName());
424         }
425 
426         s.EOL();
427     }
428 }
429 
430 Error
431 ProcessLaunchCommandOptions::SetOptionValue (uint32_t option_idx, const char *option_arg)
432 {
433     Error error;
434     const int short_option = m_getopt_table[option_idx].val;
435 
436     switch (short_option)
437     {
438         case 's':   // Stop at program entry point
439             launch_info.GetFlags().Set (eLaunchFlagStopAtEntry);
440             break;
441 
442         case 'i':   // STDIN for read only
443         {
444             FileAction action;
445             if (action.Open(STDIN_FILENO, FileSpec{option_arg, false}, true, false))
446                 launch_info.AppendFileAction (action);
447             break;
448         }
449 
450         case 'o':   // Open STDOUT for write only
451         {
452             FileAction action;
453             if (action.Open(STDOUT_FILENO, FileSpec{option_arg, false}, false, true))
454                 launch_info.AppendFileAction (action);
455             break;
456         }
457 
458         case 'e':   // STDERR for write only
459         {
460             FileAction action;
461             if (action.Open(STDERR_FILENO, FileSpec{option_arg, false}, false, true))
462                 launch_info.AppendFileAction (action);
463             break;
464         }
465 
466         case 'p':   // Process plug-in name
467             launch_info.SetProcessPluginName (option_arg);
468             break;
469 
470         case 'n':   // Disable STDIO
471         {
472             FileAction action;
473             const FileSpec dev_null{"/dev/null", false};
474             if (action.Open(STDIN_FILENO, dev_null, true, false))
475                 launch_info.AppendFileAction (action);
476             if (action.Open(STDOUT_FILENO, dev_null, false, true))
477                 launch_info.AppendFileAction (action);
478             if (action.Open(STDERR_FILENO, dev_null, false, true))
479                 launch_info.AppendFileAction (action);
480             break;
481         }
482 
483         case 'w':
484             launch_info.SetWorkingDirectory(FileSpec{option_arg, false});
485             break;
486 
487         case 't':   // Open process in new terminal window
488             launch_info.GetFlags().Set (eLaunchFlagLaunchInTTY);
489             break;
490 
491         case 'a':
492             if (!launch_info.GetArchitecture().SetTriple (option_arg, m_interpreter.GetPlatform(true).get()))
493                 launch_info.GetArchitecture().SetTriple (option_arg);
494             break;
495 
496         case 'A':   // Disable ASLR.
497         {
498             bool success;
499             const bool disable_aslr_arg = Args::StringToBoolean (option_arg, true, &success);
500             if (success)
501                 disable_aslr = disable_aslr_arg ? eLazyBoolYes : eLazyBoolNo;
502             else
503                 error.SetErrorStringWithFormat ("Invalid boolean value for disable-aslr option: '%s'", option_arg ? option_arg : "<null>");
504             break;
505         }
506 
507         case 'X':   // shell expand args.
508         {
509             bool success;
510             const bool expand_args = Args::StringToBoolean (option_arg, true, &success);
511             if (success)
512                 launch_info.SetShellExpandArguments(expand_args);
513             else
514                 error.SetErrorStringWithFormat ("Invalid boolean value for shell-expand-args option: '%s'", option_arg ? option_arg : "<null>");
515             break;
516         }
517 
518         case 'c':
519             if (option_arg && option_arg[0])
520                 launch_info.SetShell (FileSpec(option_arg, false));
521             else
522                 launch_info.SetShell (HostInfo::GetDefaultShell());
523             break;
524 
525         case 'v':
526             launch_info.GetEnvironmentEntries().AppendArgument(option_arg);
527             break;
528 
529         default:
530             error.SetErrorStringWithFormat("unrecognized short option character '%c'", short_option);
531             break;
532     }
533     return error;
534 }
535 
536 OptionDefinition
537 ProcessLaunchCommandOptions::g_option_table[] =
538 {
539 { LLDB_OPT_SET_ALL, false, "stop-at-entry", 's', OptionParser::eNoArgument,       NULL, NULL, 0, eArgTypeNone,          "Stop at the entry point of the program when launching a process."},
540 { LLDB_OPT_SET_ALL, false, "disable-aslr",  'A', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeBoolean,          "Set whether to disable address space layout randomization when launching a process."},
541 { LLDB_OPT_SET_ALL, false, "plugin",        'p', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypePlugin,        "Name of the process plugin you want to use."},
542 { LLDB_OPT_SET_ALL, false, "working-dir",   'w', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeDirectoryName,          "Set the current working directory to <path> when running the inferior."},
543 { LLDB_OPT_SET_ALL, false, "arch",          'a', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeArchitecture,  "Set the architecture for the process to launch when ambiguous."},
544 { LLDB_OPT_SET_ALL, false, "environment",   'v', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeNone,          "Specify an environment variable name/value string (--environment NAME=VALUE). Can be specified multiple times for subsequent environment entries."},
545 { LLDB_OPT_SET_1|LLDB_OPT_SET_2|LLDB_OPT_SET_3, false, "shell",         'c', OptionParser::eOptionalArgument, NULL, NULL, 0, eArgTypeFilename,          "Run the process in a shell (not supported on all platforms)."},
546 
547 { LLDB_OPT_SET_1  , false, "stdin",         'i', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeFilename,    "Redirect stdin for the process to <filename>."},
548 { LLDB_OPT_SET_1  , false, "stdout",        'o', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeFilename,    "Redirect stdout for the process to <filename>."},
549 { LLDB_OPT_SET_1  , false, "stderr",        'e', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeFilename,    "Redirect stderr for the process to <filename>."},
550 
551 { LLDB_OPT_SET_2  , false, "tty",           't', OptionParser::eNoArgument,       NULL, NULL, 0, eArgTypeNone,    "Start the process in a terminal (not supported on all platforms)."},
552 
553 { LLDB_OPT_SET_3  , false, "no-stdio",      'n', OptionParser::eNoArgument,       NULL, NULL, 0, eArgTypeNone,    "Do not set up for terminal I/O to go to running process."},
554 { LLDB_OPT_SET_4,   false, "shell-expand-args",       'X', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeBoolean,          "Set whether to shell expand arguments to the process when launching."},
555 { 0               , false, NULL,             0,  0,                 NULL, NULL, 0, eArgTypeNone,    NULL }
556 };
557 
558 
559 
560 bool
561 ProcessInstanceInfoMatch::NameMatches (const char *process_name) const
562 {
563     if (m_name_match_type == eNameMatchIgnore || process_name == NULL)
564         return true;
565     const char *match_name = m_match_info.GetName();
566     if (!match_name)
567         return true;
568 
569     return lldb_private::NameMatches (process_name, m_name_match_type, match_name);
570 }
571 
572 bool
573 ProcessInstanceInfoMatch::Matches (const ProcessInstanceInfo &proc_info) const
574 {
575     if (!NameMatches (proc_info.GetName()))
576         return false;
577 
578     if (m_match_info.ProcessIDIsValid() &&
579         m_match_info.GetProcessID() != proc_info.GetProcessID())
580         return false;
581 
582     if (m_match_info.ParentProcessIDIsValid() &&
583         m_match_info.GetParentProcessID() != proc_info.GetParentProcessID())
584         return false;
585 
586     if (m_match_info.UserIDIsValid () &&
587         m_match_info.GetUserID() != proc_info.GetUserID())
588         return false;
589 
590     if (m_match_info.GroupIDIsValid () &&
591         m_match_info.GetGroupID() != proc_info.GetGroupID())
592         return false;
593 
594     if (m_match_info.EffectiveUserIDIsValid () &&
595         m_match_info.GetEffectiveUserID() != proc_info.GetEffectiveUserID())
596         return false;
597 
598     if (m_match_info.EffectiveGroupIDIsValid () &&
599         m_match_info.GetEffectiveGroupID() != proc_info.GetEffectiveGroupID())
600         return false;
601 
602     if (m_match_info.GetArchitecture().IsValid() &&
603         !m_match_info.GetArchitecture().IsCompatibleMatch(proc_info.GetArchitecture()))
604         return false;
605     return true;
606 }
607 
608 bool
609 ProcessInstanceInfoMatch::MatchAllProcesses () const
610 {
611     if (m_name_match_type != eNameMatchIgnore)
612         return false;
613 
614     if (m_match_info.ProcessIDIsValid())
615         return false;
616 
617     if (m_match_info.ParentProcessIDIsValid())
618         return false;
619 
620     if (m_match_info.UserIDIsValid ())
621         return false;
622 
623     if (m_match_info.GroupIDIsValid ())
624         return false;
625 
626     if (m_match_info.EffectiveUserIDIsValid ())
627         return false;
628 
629     if (m_match_info.EffectiveGroupIDIsValid ())
630         return false;
631 
632     if (m_match_info.GetArchitecture().IsValid())
633         return false;
634 
635     if (m_match_all_users)
636         return false;
637 
638     return true;
639 
640 }
641 
642 void
643 ProcessInstanceInfoMatch::Clear()
644 {
645     m_match_info.Clear();
646     m_name_match_type = eNameMatchIgnore;
647     m_match_all_users = false;
648 }
649 
650 ProcessSP
651 Process::FindPlugin (lldb::TargetSP target_sp, const char *plugin_name, Listener &listener, const FileSpec *crash_file_path)
652 {
653     static uint32_t g_process_unique_id = 0;
654 
655     ProcessSP process_sp;
656     ProcessCreateInstance create_callback = NULL;
657     if (plugin_name)
658     {
659         ConstString const_plugin_name(plugin_name);
660         create_callback  = PluginManager::GetProcessCreateCallbackForPluginName (const_plugin_name);
661         if (create_callback)
662         {
663             process_sp = create_callback(target_sp, listener, crash_file_path);
664             if (process_sp)
665             {
666                 if (process_sp->CanDebug(target_sp, true))
667                 {
668                     process_sp->m_process_unique_id = ++g_process_unique_id;
669                 }
670                 else
671                     process_sp.reset();
672             }
673         }
674     }
675     else
676     {
677         for (uint32_t idx = 0; (create_callback = PluginManager::GetProcessCreateCallbackAtIndex(idx)) != NULL; ++idx)
678         {
679             process_sp = create_callback(target_sp, listener, crash_file_path);
680             if (process_sp)
681             {
682                 if (process_sp->CanDebug(target_sp, false))
683                 {
684                     process_sp->m_process_unique_id = ++g_process_unique_id;
685                     break;
686                 }
687                 else
688                     process_sp.reset();
689             }
690         }
691     }
692     return process_sp;
693 }
694 
695 ConstString &
696 Process::GetStaticBroadcasterClass ()
697 {
698     static ConstString class_name ("lldb.process");
699     return class_name;
700 }
701 
702 //----------------------------------------------------------------------
703 // Process constructor
704 //----------------------------------------------------------------------
705 Process::Process(lldb::TargetSP target_sp, Listener &listener) :
706     Process(target_sp, listener, UnixSignals::Create(HostInfo::GetArchitecture()))
707 {
708     // This constructor just delegates to the full Process constructor,
709     // defaulting to using the Host's UnixSignals.
710 }
711 
712 Process::Process(lldb::TargetSP target_sp, Listener &listener, const UnixSignalsSP &unix_signals_sp) :
713     ProcessProperties (this),
714     UserID (LLDB_INVALID_PROCESS_ID),
715     Broadcaster (&(target_sp->GetDebugger()), Process::GetStaticBroadcasterClass().AsCString()),
716     m_target_sp (target_sp),
717     m_public_state (eStateUnloaded),
718     m_private_state (eStateUnloaded),
719     m_private_state_broadcaster (NULL, "lldb.process.internal_state_broadcaster"),
720     m_private_state_control_broadcaster (NULL, "lldb.process.internal_state_control_broadcaster"),
721     m_private_state_listener ("lldb.process.internal_state_listener"),
722     m_private_state_control_wait(),
723     m_mod_id (),
724     m_process_unique_id(0),
725     m_thread_index_id (0),
726     m_thread_id_to_index_id_map (),
727     m_exit_status (-1),
728     m_exit_string (),
729     m_exit_status_mutex(),
730     m_thread_mutex (Mutex::eMutexTypeRecursive),
731     m_thread_list_real (this),
732     m_thread_list (this),
733     m_extended_thread_list (this),
734     m_extended_thread_stop_id (0),
735     m_queue_list (this),
736     m_queue_list_stop_id (0),
737     m_notifications (),
738     m_image_tokens (),
739     m_listener (listener),
740     m_breakpoint_site_list (),
741     m_dynamic_checkers_ap (),
742     m_unix_signals_sp (unix_signals_sp),
743     m_abi_sp (),
744     m_process_input_reader (),
745     m_stdio_communication ("process.stdio"),
746     m_stdio_communication_mutex (Mutex::eMutexTypeRecursive),
747     m_stdin_forward (false),
748     m_stdout_data (),
749     m_stderr_data (),
750     m_profile_data_comm_mutex (Mutex::eMutexTypeRecursive),
751     m_profile_data (),
752     m_iohandler_sync (0),
753     m_memory_cache (*this),
754     m_allocated_memory_cache (*this),
755     m_should_detach (false),
756     m_next_event_action_ap(),
757     m_public_run_lock (),
758     m_private_run_lock (),
759     m_currently_handling_event(false),
760     m_stop_info_override_callback (NULL),
761     m_finalizing (false),
762     m_finalize_called (false),
763     m_clear_thread_plans_on_stop (false),
764     m_force_next_event_delivery (false),
765     m_last_broadcast_state (eStateInvalid),
766     m_destroy_in_process (false),
767     m_can_interpret_function_calls(false),
768     m_warnings_issued (),
769     m_can_jit(eCanJITDontKnow)
770 {
771     CheckInWithManager ();
772 
773     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
774     if (log)
775         log->Printf ("%p Process::Process()", static_cast<void*>(this));
776 
777     if (!m_unix_signals_sp)
778         m_unix_signals_sp = std::make_shared<UnixSignals>();
779 
780     SetEventName (eBroadcastBitStateChanged, "state-changed");
781     SetEventName (eBroadcastBitInterrupt, "interrupt");
782     SetEventName (eBroadcastBitSTDOUT, "stdout-available");
783     SetEventName (eBroadcastBitSTDERR, "stderr-available");
784     SetEventName (eBroadcastBitProfileData, "profile-data-available");
785 
786     m_private_state_control_broadcaster.SetEventName (eBroadcastInternalStateControlStop  , "control-stop"  );
787     m_private_state_control_broadcaster.SetEventName (eBroadcastInternalStateControlPause , "control-pause" );
788     m_private_state_control_broadcaster.SetEventName (eBroadcastInternalStateControlResume, "control-resume");
789 
790     listener.StartListeningForEvents (this,
791                                       eBroadcastBitStateChanged |
792                                       eBroadcastBitInterrupt |
793                                       eBroadcastBitSTDOUT |
794                                       eBroadcastBitSTDERR |
795                                       eBroadcastBitProfileData);
796 
797     m_private_state_listener.StartListeningForEvents(&m_private_state_broadcaster,
798                                                      eBroadcastBitStateChanged |
799                                                      eBroadcastBitInterrupt);
800 
801     m_private_state_listener.StartListeningForEvents(&m_private_state_control_broadcaster,
802                                                      eBroadcastInternalStateControlStop |
803                                                      eBroadcastInternalStateControlPause |
804                                                      eBroadcastInternalStateControlResume);
805     // We need something valid here, even if just the default UnixSignalsSP.
806     assert (m_unix_signals_sp && "null m_unix_signals_sp after initialization");
807 }
808 
809 //----------------------------------------------------------------------
810 // Destructor
811 //----------------------------------------------------------------------
812 Process::~Process()
813 {
814     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
815     if (log)
816         log->Printf ("%p Process::~Process()", static_cast<void*>(this));
817     StopPrivateStateThread();
818 
819     // ThreadList::Clear() will try to acquire this process's mutex, so
820     // explicitly clear the thread list here to ensure that the mutex
821     // is not destroyed before the thread list.
822     m_thread_list.Clear();
823 }
824 
825 const ProcessPropertiesSP &
826 Process::GetGlobalProperties()
827 {
828     static ProcessPropertiesSP g_settings_sp;
829     if (!g_settings_sp)
830         g_settings_sp.reset (new ProcessProperties (NULL));
831     return g_settings_sp;
832 }
833 
834 void
835 Process::Finalize()
836 {
837     m_finalizing = true;
838 
839     // Destroy this process if needed
840     switch (GetPrivateState())
841     {
842         case eStateConnected:
843         case eStateAttaching:
844         case eStateLaunching:
845         case eStateStopped:
846         case eStateRunning:
847         case eStateStepping:
848         case eStateCrashed:
849         case eStateSuspended:
850             Destroy(false);
851             break;
852 
853         case eStateInvalid:
854         case eStateUnloaded:
855         case eStateDetached:
856         case eStateExited:
857             break;
858     }
859 
860     // Clear our broadcaster before we proceed with destroying
861     Broadcaster::Clear();
862 
863     // Do any cleanup needed prior to being destructed... Subclasses
864     // that override this method should call this superclass method as well.
865 
866     // We need to destroy the loader before the derived Process class gets destroyed
867     // since it is very likely that undoing the loader will require access to the real process.
868     m_dynamic_checkers_ap.reset();
869     m_abi_sp.reset();
870     m_os_ap.reset();
871     m_system_runtime_ap.reset();
872     m_dyld_ap.reset();
873     m_jit_loaders_ap.reset();
874     m_thread_list_real.Destroy();
875     m_thread_list.Destroy();
876     m_extended_thread_list.Destroy();
877     m_queue_list.Clear();
878     m_queue_list_stop_id = 0;
879     std::vector<Notifications> empty_notifications;
880     m_notifications.swap(empty_notifications);
881     m_image_tokens.clear();
882     m_memory_cache.Clear();
883     m_allocated_memory_cache.Clear();
884     m_language_runtimes.clear();
885     m_instrumentation_runtimes.clear();
886     m_next_event_action_ap.reset();
887     m_stop_info_override_callback = NULL;
888     // Clear the last natural stop ID since it has a strong
889     // reference to this process
890     m_mod_id.SetStopEventForLastNaturalStopID(EventSP());
891 //#ifdef LLDB_CONFIGURATION_DEBUG
892 //    StreamFile s(stdout, false);
893 //    EventSP event_sp;
894 //    while (m_private_state_listener.GetNextEvent(event_sp))
895 //    {
896 //        event_sp->Dump (&s);
897 //        s.EOL();
898 //    }
899 //#endif
900     // We have to be very careful here as the m_private_state_listener might
901     // contain events that have ProcessSP values in them which can keep this
902     // process around forever. These events need to be cleared out.
903     m_private_state_listener.Clear();
904     m_public_run_lock.TrySetRunning(); // This will do nothing if already locked
905     m_public_run_lock.SetStopped();
906     m_private_run_lock.TrySetRunning(); // This will do nothing if already locked
907     m_private_run_lock.SetStopped();
908     m_finalize_called = true;
909 }
910 
911 void
912 Process::RegisterNotificationCallbacks (const Notifications& callbacks)
913 {
914     m_notifications.push_back(callbacks);
915     if (callbacks.initialize != NULL)
916         callbacks.initialize (callbacks.baton, this);
917 }
918 
919 bool
920 Process::UnregisterNotificationCallbacks(const Notifications& callbacks)
921 {
922     std::vector<Notifications>::iterator pos, end = m_notifications.end();
923     for (pos = m_notifications.begin(); pos != end; ++pos)
924     {
925         if (pos->baton == callbacks.baton &&
926             pos->initialize == callbacks.initialize &&
927             pos->process_state_changed == callbacks.process_state_changed)
928         {
929             m_notifications.erase(pos);
930             return true;
931         }
932     }
933     return false;
934 }
935 
936 void
937 Process::SynchronouslyNotifyStateChanged (StateType state)
938 {
939     std::vector<Notifications>::iterator notification_pos, notification_end = m_notifications.end();
940     for (notification_pos = m_notifications.begin(); notification_pos != notification_end; ++notification_pos)
941     {
942         if (notification_pos->process_state_changed)
943             notification_pos->process_state_changed (notification_pos->baton, this, state);
944     }
945 }
946 
947 // FIXME: We need to do some work on events before the general Listener sees them.
948 // For instance if we are continuing from a breakpoint, we need to ensure that we do
949 // the little "insert real insn, step & stop" trick.  But we can't do that when the
950 // event is delivered by the broadcaster - since that is done on the thread that is
951 // waiting for new events, so if we needed more than one event for our handling, we would
952 // stall.  So instead we do it when we fetch the event off of the queue.
953 //
954 
955 StateType
956 Process::GetNextEvent (EventSP &event_sp)
957 {
958     StateType state = eStateInvalid;
959 
960     if (m_listener.GetNextEventForBroadcaster (this, event_sp) && event_sp)
961         state = Process::ProcessEventData::GetStateFromEvent (event_sp.get());
962 
963     return state;
964 }
965 
966 void
967 Process::SyncIOHandler (uint32_t iohandler_id, uint64_t timeout_msec)
968 {
969     // don't sync (potentially context switch) in case where there is no process IO
970     if (! m_process_input_reader)
971         return;
972 
973     TimeValue timeout = TimeValue::Now();
974     timeout.OffsetWithMicroSeconds(timeout_msec*1000);
975     uint32_t new_iohandler_id = 0;
976     m_iohandler_sync.WaitForValueNotEqualTo(iohandler_id, new_iohandler_id, &timeout);
977 
978     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
979     if (log)
980         log->Printf("Process::%s waited for m_iohandler_sync to change from %u, new value is %u", __FUNCTION__, iohandler_id, new_iohandler_id);
981 }
982 
983 StateType
984 Process::WaitForProcessToStop (const TimeValue *timeout,
985                                EventSP *event_sp_ptr,
986                                bool wait_always,
987                                Listener *hijack_listener,
988                                Stream *stream)
989 {
990     // We can't just wait for a "stopped" event, because the stopped event may have restarted the target.
991     // We have to actually check each event, and in the case of a stopped event check the restarted flag
992     // on the event.
993     if (event_sp_ptr)
994         event_sp_ptr->reset();
995     StateType state = GetState();
996     // If we are exited or detached, we won't ever get back to any
997     // other valid state...
998     if (state == eStateDetached || state == eStateExited)
999         return state;
1000 
1001     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1002     if (log)
1003         log->Printf ("Process::%s (timeout = %p)", __FUNCTION__,
1004                      static_cast<const void*>(timeout));
1005 
1006     if (!wait_always &&
1007         StateIsStoppedState(state, true) &&
1008         StateIsStoppedState(GetPrivateState(), true))
1009     {
1010         if (log)
1011             log->Printf("Process::%s returning without waiting for events; process private and public states are already 'stopped'.",
1012                         __FUNCTION__);
1013         // We need to toggle the run lock as this won't get done in
1014         // SetPublicState() if the process is hijacked.
1015         if (hijack_listener)
1016             m_public_run_lock.SetStopped();
1017         return state;
1018     }
1019 
1020     while (state != eStateInvalid)
1021     {
1022         EventSP event_sp;
1023         state = WaitForStateChangedEvents (timeout, event_sp, hijack_listener);
1024         if (event_sp_ptr && event_sp)
1025             *event_sp_ptr = event_sp;
1026 
1027         bool pop_process_io_handler = hijack_listener != NULL;
1028         Process::HandleProcessStateChangedEvent (event_sp, stream, pop_process_io_handler);
1029 
1030         switch (state)
1031         {
1032         case eStateCrashed:
1033         case eStateDetached:
1034         case eStateExited:
1035         case eStateUnloaded:
1036             // We need to toggle the run lock as this won't get done in
1037             // SetPublicState() if the process is hijacked.
1038             if (hijack_listener)
1039                 m_public_run_lock.SetStopped();
1040             return state;
1041         case eStateStopped:
1042             if (Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
1043                 continue;
1044             else
1045             {
1046                 // We need to toggle the run lock as this won't get done in
1047                 // SetPublicState() if the process is hijacked.
1048                 if (hijack_listener)
1049                     m_public_run_lock.SetStopped();
1050                 return state;
1051             }
1052         default:
1053             continue;
1054         }
1055     }
1056     return state;
1057 }
1058 
1059 bool
1060 Process::HandleProcessStateChangedEvent (const EventSP &event_sp,
1061                                          Stream *stream,
1062                                          bool &pop_process_io_handler)
1063 {
1064     const bool handle_pop = pop_process_io_handler == true;
1065 
1066     pop_process_io_handler = false;
1067     ProcessSP process_sp = Process::ProcessEventData::GetProcessFromEvent(event_sp.get());
1068 
1069     if (!process_sp)
1070         return false;
1071 
1072     StateType event_state = Process::ProcessEventData::GetStateFromEvent (event_sp.get());
1073     if (event_state == eStateInvalid)
1074         return false;
1075 
1076     switch (event_state)
1077     {
1078         case eStateInvalid:
1079         case eStateUnloaded:
1080         case eStateAttaching:
1081         case eStateLaunching:
1082         case eStateStepping:
1083         case eStateDetached:
1084             {
1085                 if (stream)
1086                     stream->Printf ("Process %" PRIu64 " %s\n",
1087                                     process_sp->GetID(),
1088                                     StateAsCString (event_state));
1089 
1090                 if (event_state == eStateDetached)
1091                     pop_process_io_handler = true;
1092             }
1093             break;
1094 
1095         case eStateConnected:
1096         case eStateRunning:
1097             // Don't be chatty when we run...
1098             break;
1099 
1100         case eStateExited:
1101             if (stream)
1102                 process_sp->GetStatus(*stream);
1103             pop_process_io_handler = true;
1104             break;
1105 
1106         case eStateStopped:
1107         case eStateCrashed:
1108         case eStateSuspended:
1109             // Make sure the program hasn't been auto-restarted:
1110             if (Process::ProcessEventData::GetRestartedFromEvent (event_sp.get()))
1111             {
1112                 if (stream)
1113                 {
1114                     size_t num_reasons = Process::ProcessEventData::GetNumRestartedReasons(event_sp.get());
1115                     if (num_reasons > 0)
1116                     {
1117                         // FIXME: Do we want to report this, or would that just be annoyingly chatty?
1118                         if (num_reasons == 1)
1119                         {
1120                             const char *reason = Process::ProcessEventData::GetRestartedReasonAtIndex (event_sp.get(), 0);
1121                             stream->Printf ("Process %" PRIu64 " stopped and restarted: %s\n",
1122                                             process_sp->GetID(),
1123                                             reason ? reason : "<UNKNOWN REASON>");
1124                         }
1125                         else
1126                         {
1127                             stream->Printf ("Process %" PRIu64 " stopped and restarted, reasons:\n",
1128                                             process_sp->GetID());
1129 
1130 
1131                             for (size_t i = 0; i < num_reasons; i++)
1132                             {
1133                                 const char *reason = Process::ProcessEventData::GetRestartedReasonAtIndex (event_sp.get(), i);
1134                                 stream->Printf("\t%s\n", reason ? reason : "<UNKNOWN REASON>");
1135                             }
1136                         }
1137                     }
1138                 }
1139             }
1140             else
1141             {
1142                 // Lock the thread list so it doesn't change on us, this is the scope for the locker:
1143                 {
1144                     ThreadList &thread_list = process_sp->GetThreadList();
1145                     Mutex::Locker locker (thread_list.GetMutex());
1146 
1147                     ThreadSP curr_thread (thread_list.GetSelectedThread());
1148                     ThreadSP thread;
1149                     StopReason curr_thread_stop_reason = eStopReasonInvalid;
1150                     if (curr_thread)
1151                         curr_thread_stop_reason = curr_thread->GetStopReason();
1152                     if (!curr_thread ||
1153                         !curr_thread->IsValid() ||
1154                         curr_thread_stop_reason == eStopReasonInvalid ||
1155                         curr_thread_stop_reason == eStopReasonNone)
1156                     {
1157                         // Prefer a thread that has just completed its plan over another thread as current thread.
1158                         ThreadSP plan_thread;
1159                         ThreadSP other_thread;
1160 
1161                         const size_t num_threads = thread_list.GetSize();
1162                         size_t i;
1163                         for (i = 0; i < num_threads; ++i)
1164                         {
1165                             thread = thread_list.GetThreadAtIndex(i);
1166                             StopReason thread_stop_reason = thread->GetStopReason();
1167                             switch (thread_stop_reason)
1168                             {
1169                                 case eStopReasonInvalid:
1170                                 case eStopReasonNone:
1171                                     break;
1172 
1173                                  case eStopReasonSignal:
1174                                 {
1175                                     // Don't select a signal thread if we weren't going to stop at that
1176                                     // signal.  We have to have had another reason for stopping here, and
1177                                     // the user doesn't want to see this thread.
1178                                     uint64_t signo = thread->GetStopInfo()->GetValue();
1179                                     if (process_sp->GetUnixSignals()->GetShouldStop(signo))
1180                                     {
1181                                         if (!other_thread)
1182                                             other_thread = thread;
1183                                     }
1184                                     break;
1185                                 }
1186                                 case eStopReasonTrace:
1187                                 case eStopReasonBreakpoint:
1188                                 case eStopReasonWatchpoint:
1189                                 case eStopReasonException:
1190                                 case eStopReasonExec:
1191                                 case eStopReasonThreadExiting:
1192                                 case eStopReasonInstrumentation:
1193                                     if (!other_thread)
1194                                         other_thread = thread;
1195                                     break;
1196                                 case eStopReasonPlanComplete:
1197                                     if (!plan_thread)
1198                                         plan_thread = thread;
1199                                     break;
1200                             }
1201                         }
1202                         if (plan_thread)
1203                             thread_list.SetSelectedThreadByID (plan_thread->GetID());
1204                         else if (other_thread)
1205                             thread_list.SetSelectedThreadByID (other_thread->GetID());
1206                         else
1207                         {
1208                             if (curr_thread && curr_thread->IsValid())
1209                                 thread = curr_thread;
1210                             else
1211                                 thread = thread_list.GetThreadAtIndex(0);
1212 
1213                             if (thread)
1214                                 thread_list.SetSelectedThreadByID (thread->GetID());
1215                         }
1216                     }
1217                 }
1218                 // Drop the ThreadList mutex by here, since GetThreadStatus below might have to run code,
1219                 // e.g. for Data formatters, and if we hold the ThreadList mutex, then the process is going to
1220                 // have a hard time restarting the process.
1221                 if (stream)
1222                 {
1223                     Debugger &debugger = process_sp->GetTarget().GetDebugger();
1224                     if (debugger.GetTargetList().GetSelectedTarget().get() == &process_sp->GetTarget())
1225                     {
1226                         const bool only_threads_with_stop_reason = true;
1227                         const uint32_t start_frame = 0;
1228                         const uint32_t num_frames = 1;
1229                         const uint32_t num_frames_with_source = 1;
1230                         process_sp->GetStatus(*stream);
1231                         process_sp->GetThreadStatus (*stream,
1232                                                      only_threads_with_stop_reason,
1233                                                      start_frame,
1234                                                      num_frames,
1235                                                      num_frames_with_source);
1236                     }
1237                     else
1238                     {
1239                         uint32_t target_idx = debugger.GetTargetList().GetIndexOfTarget(process_sp->GetTarget().shared_from_this());
1240                         if (target_idx != UINT32_MAX)
1241                             stream->Printf ("Target %d: (", target_idx);
1242                         else
1243                             stream->Printf ("Target <unknown index>: (");
1244                         process_sp->GetTarget().Dump (stream, eDescriptionLevelBrief);
1245                         stream->Printf (") stopped.\n");
1246                     }
1247                 }
1248 
1249                 // Pop the process IO handler
1250                 pop_process_io_handler = true;
1251             }
1252             break;
1253     }
1254 
1255     if (handle_pop && pop_process_io_handler)
1256         process_sp->PopProcessIOHandler();
1257 
1258     return true;
1259 }
1260 
1261 
1262 StateType
1263 Process::WaitForState
1264 (
1265     const TimeValue *timeout,
1266     const StateType *match_states,
1267     const uint32_t num_match_states
1268 )
1269 {
1270     EventSP event_sp;
1271     uint32_t i;
1272     StateType state = GetState();
1273     while (state != eStateInvalid)
1274     {
1275         // If we are exited or detached, we won't ever get back to any
1276         // other valid state...
1277         if (state == eStateDetached || state == eStateExited)
1278             return state;
1279 
1280         state = WaitForStateChangedEvents (timeout, event_sp, NULL);
1281 
1282         for (i=0; i<num_match_states; ++i)
1283         {
1284             if (match_states[i] == state)
1285                 return state;
1286         }
1287     }
1288     return state;
1289 }
1290 
1291 bool
1292 Process::HijackProcessEvents (Listener *listener)
1293 {
1294     if (listener != NULL)
1295     {
1296         return HijackBroadcaster(listener, eBroadcastBitStateChanged | eBroadcastBitInterrupt);
1297     }
1298     else
1299         return false;
1300 }
1301 
1302 void
1303 Process::RestoreProcessEvents ()
1304 {
1305     RestoreBroadcaster();
1306 }
1307 
1308 bool
1309 Process::HijackPrivateProcessEvents (Listener *listener)
1310 {
1311     if (listener != NULL)
1312     {
1313         return m_private_state_broadcaster.HijackBroadcaster(listener, eBroadcastBitStateChanged | eBroadcastBitInterrupt);
1314     }
1315     else
1316         return false;
1317 }
1318 
1319 void
1320 Process::RestorePrivateProcessEvents ()
1321 {
1322     m_private_state_broadcaster.RestoreBroadcaster();
1323 }
1324 
1325 StateType
1326 Process::WaitForStateChangedEvents (const TimeValue *timeout, EventSP &event_sp, Listener *hijack_listener)
1327 {
1328     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1329 
1330     if (log)
1331         log->Printf ("Process::%s (timeout = %p, event_sp)...", __FUNCTION__,
1332                      static_cast<const void*>(timeout));
1333 
1334     Listener *listener = hijack_listener;
1335     if (listener == NULL)
1336         listener = &m_listener;
1337 
1338     StateType state = eStateInvalid;
1339     if (listener->WaitForEventForBroadcasterWithType (timeout,
1340                                                       this,
1341                                                       eBroadcastBitStateChanged | eBroadcastBitInterrupt,
1342                                                       event_sp))
1343     {
1344         if (event_sp && event_sp->GetType() == eBroadcastBitStateChanged)
1345             state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
1346         else if (log)
1347             log->Printf ("Process::%s got no event or was interrupted.", __FUNCTION__);
1348     }
1349 
1350     if (log)
1351         log->Printf ("Process::%s (timeout = %p, event_sp) => %s",
1352                      __FUNCTION__, static_cast<const void*>(timeout),
1353                      StateAsCString(state));
1354     return state;
1355 }
1356 
1357 Event *
1358 Process::PeekAtStateChangedEvents ()
1359 {
1360     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1361 
1362     if (log)
1363         log->Printf ("Process::%s...", __FUNCTION__);
1364 
1365     Event *event_ptr;
1366     event_ptr = m_listener.PeekAtNextEventForBroadcasterWithType (this,
1367                                                                   eBroadcastBitStateChanged);
1368     if (log)
1369     {
1370         if (event_ptr)
1371         {
1372             log->Printf ("Process::%s (event_ptr) => %s",
1373                          __FUNCTION__,
1374                          StateAsCString(ProcessEventData::GetStateFromEvent (event_ptr)));
1375         }
1376         else
1377         {
1378             log->Printf ("Process::%s no events found",
1379                          __FUNCTION__);
1380         }
1381     }
1382     return event_ptr;
1383 }
1384 
1385 StateType
1386 Process::WaitForStateChangedEventsPrivate (const TimeValue *timeout, EventSP &event_sp)
1387 {
1388     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1389 
1390     if (log)
1391         log->Printf ("Process::%s (timeout = %p, event_sp)...", __FUNCTION__,
1392                      static_cast<const void*>(timeout));
1393 
1394     StateType state = eStateInvalid;
1395     if (m_private_state_listener.WaitForEventForBroadcasterWithType (timeout,
1396                                                                      &m_private_state_broadcaster,
1397                                                                      eBroadcastBitStateChanged | eBroadcastBitInterrupt,
1398                                                                      event_sp))
1399         if (event_sp && event_sp->GetType() == eBroadcastBitStateChanged)
1400             state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
1401 
1402     // This is a bit of a hack, but when we wait here we could very well return
1403     // to the command-line, and that could disable the log, which would render the
1404     // log we got above invalid.
1405     if (log)
1406         log->Printf ("Process::%s (timeout = %p, event_sp) => %s",
1407                      __FUNCTION__, static_cast<const void *>(timeout),
1408                      state == eStateInvalid ? "TIMEOUT" : StateAsCString(state));
1409     return state;
1410 }
1411 
1412 bool
1413 Process::WaitForEventsPrivate (const TimeValue *timeout, EventSP &event_sp, bool control_only)
1414 {
1415     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1416 
1417     if (log)
1418         log->Printf ("Process::%s (timeout = %p, event_sp)...", __FUNCTION__,
1419                      static_cast<const void*>(timeout));
1420 
1421     if (control_only)
1422         return m_private_state_listener.WaitForEventForBroadcaster(timeout, &m_private_state_control_broadcaster, event_sp);
1423     else
1424         return m_private_state_listener.WaitForEvent(timeout, event_sp);
1425 }
1426 
1427 bool
1428 Process::IsRunning () const
1429 {
1430     return StateIsRunningState (m_public_state.GetValue());
1431 }
1432 
1433 int
1434 Process::GetExitStatus ()
1435 {
1436     Mutex::Locker locker (m_exit_status_mutex);
1437 
1438     if (m_public_state.GetValue() == eStateExited)
1439         return m_exit_status;
1440     return -1;
1441 }
1442 
1443 
1444 const char *
1445 Process::GetExitDescription ()
1446 {
1447     Mutex::Locker locker (m_exit_status_mutex);
1448 
1449     if (m_public_state.GetValue() == eStateExited && !m_exit_string.empty())
1450         return m_exit_string.c_str();
1451     return NULL;
1452 }
1453 
1454 bool
1455 Process::SetExitStatus (int status, const char *cstr)
1456 {
1457     // Use a mutex to protect setting the exit status.
1458     Mutex::Locker locker (m_exit_status_mutex);
1459 
1460     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1461     if (log)
1462         log->Printf("Process::SetExitStatus (status=%i (0x%8.8x), description=%s%s%s)",
1463                     status, status,
1464                     cstr ? "\"" : "",
1465                     cstr ? cstr : "NULL",
1466                     cstr ? "\"" : "");
1467 
1468     // We were already in the exited state
1469     if (m_private_state.GetValue() == eStateExited)
1470     {
1471         if (log)
1472             log->Printf("Process::SetExitStatus () ignoring exit status because state was already set to eStateExited");
1473         return false;
1474     }
1475 
1476     m_exit_status = status;
1477     if (cstr)
1478         m_exit_string = cstr;
1479     else
1480         m_exit_string.clear();
1481 
1482     // When we exit, we don't need the input reader anymore
1483     if (m_process_input_reader)
1484     {
1485         m_process_input_reader->SetIsDone(true);
1486         m_process_input_reader->Cancel();
1487         m_process_input_reader.reset();
1488     }
1489 
1490     // Clear the last natural stop ID since it has a strong
1491     // reference to this process
1492     m_mod_id.SetStopEventForLastNaturalStopID(EventSP());
1493 
1494     SetPrivateState (eStateExited);
1495 
1496     // Allow subclasses to do some cleanup
1497     DidExit ();
1498 
1499     return true;
1500 }
1501 
1502 // This static callback can be used to watch for local child processes on
1503 // the current host. The child process exits, the process will be
1504 // found in the global target list (we want to be completely sure that the
1505 // lldb_private::Process doesn't go away before we can deliver the signal.
1506 bool
1507 Process::SetProcessExitStatus (void *callback_baton,
1508                                lldb::pid_t pid,
1509                                bool exited,
1510                                int signo,          // Zero for no signal
1511                                int exit_status     // Exit value of process if signal is zero
1512 )
1513 {
1514     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS));
1515     if (log)
1516         log->Printf ("Process::SetProcessExitStatus (baton=%p, pid=%" PRIu64 ", exited=%i, signal=%i, exit_status=%i)\n",
1517                      callback_baton,
1518                      pid,
1519                      exited,
1520                      signo,
1521                      exit_status);
1522 
1523     if (exited)
1524     {
1525         TargetSP target_sp(Debugger::FindTargetWithProcessID (pid));
1526         if (target_sp)
1527         {
1528             ProcessSP process_sp (target_sp->GetProcessSP());
1529             if (process_sp)
1530             {
1531                 const char *signal_cstr = NULL;
1532                 if (signo)
1533                     signal_cstr = process_sp->GetUnixSignals()->GetSignalAsCString(signo);
1534 
1535                 process_sp->SetExitStatus (exit_status, signal_cstr);
1536             }
1537         }
1538         return true;
1539     }
1540     return false;
1541 }
1542 
1543 
1544 void
1545 Process::UpdateThreadListIfNeeded ()
1546 {
1547     const uint32_t stop_id = GetStopID();
1548     if (m_thread_list.GetSize(false) == 0 || stop_id != m_thread_list.GetStopID())
1549     {
1550         const StateType state = GetPrivateState();
1551         if (StateIsStoppedState (state, true))
1552         {
1553             Mutex::Locker locker (m_thread_list.GetMutex ());
1554             // m_thread_list does have its own mutex, but we need to
1555             // hold onto the mutex between the call to UpdateThreadList(...)
1556             // and the os->UpdateThreadList(...) so it doesn't change on us
1557             ThreadList &old_thread_list = m_thread_list;
1558             ThreadList real_thread_list(this);
1559             ThreadList new_thread_list(this);
1560             // Always update the thread list with the protocol specific
1561             // thread list, but only update if "true" is returned
1562             if (UpdateThreadList (m_thread_list_real, real_thread_list))
1563             {
1564                 // Don't call into the OperatingSystem to update the thread list if we are shutting down, since
1565                 // that may call back into the SBAPI's, requiring the API lock which is already held by whoever is
1566                 // shutting us down, causing a deadlock.
1567                 if (!m_destroy_in_process)
1568                 {
1569                     OperatingSystem *os = GetOperatingSystem ();
1570                     if (os)
1571                     {
1572                         // Clear any old backing threads where memory threads might have been
1573                         // backed by actual threads from the lldb_private::Process subclass
1574                         size_t num_old_threads = old_thread_list.GetSize(false);
1575                         for (size_t i=0; i<num_old_threads; ++i)
1576                             old_thread_list.GetThreadAtIndex(i, false)->ClearBackingThread();
1577 
1578                         // Turn off dynamic types to ensure we don't run any expressions. Objective C
1579                         // can run an expression to determine if a SBValue is a dynamic type or not
1580                         // and we need to avoid this. OperatingSystem plug-ins can't run expressions
1581                         // that require running code...
1582 
1583                         Target &target = GetTarget();
1584                         const lldb::DynamicValueType saved_prefer_dynamic = target.GetPreferDynamicValue ();
1585                         if (saved_prefer_dynamic != lldb::eNoDynamicValues)
1586                             target.SetPreferDynamicValue(lldb::eNoDynamicValues);
1587 
1588                         // Now let the OperatingSystem plug-in update the thread list
1589 
1590                         os->UpdateThreadList (old_thread_list,  // Old list full of threads created by OS plug-in
1591                                               real_thread_list, // The actual thread list full of threads created by each lldb_private::Process subclass
1592                                               new_thread_list); // The new thread list that we will show to the user that gets filled in
1593 
1594                         if (saved_prefer_dynamic != lldb::eNoDynamicValues)
1595                             target.SetPreferDynamicValue(saved_prefer_dynamic);
1596                     }
1597                     else
1598                     {
1599                         // No OS plug-in, the new thread list is the same as the real thread list
1600                         new_thread_list = real_thread_list;
1601                     }
1602                 }
1603 
1604                 m_thread_list_real.Update(real_thread_list);
1605                 m_thread_list.Update (new_thread_list);
1606                 m_thread_list.SetStopID (stop_id);
1607 
1608                 if (GetLastNaturalStopID () != m_extended_thread_stop_id)
1609                 {
1610                     // Clear any extended threads that we may have accumulated previously
1611                     m_extended_thread_list.Clear();
1612                     m_extended_thread_stop_id = GetLastNaturalStopID ();
1613 
1614                     m_queue_list.Clear();
1615                     m_queue_list_stop_id = GetLastNaturalStopID ();
1616                 }
1617             }
1618         }
1619     }
1620 }
1621 
1622 void
1623 Process::UpdateQueueListIfNeeded ()
1624 {
1625     if (m_system_runtime_ap.get())
1626     {
1627         if (m_queue_list.GetSize() == 0 || m_queue_list_stop_id != GetLastNaturalStopID())
1628         {
1629             const StateType state = GetPrivateState();
1630             if (StateIsStoppedState (state, true))
1631             {
1632                 m_system_runtime_ap->PopulateQueueList (m_queue_list);
1633                 m_queue_list_stop_id = GetLastNaturalStopID();
1634             }
1635         }
1636     }
1637 }
1638 
1639 ThreadSP
1640 Process::CreateOSPluginThread (lldb::tid_t tid, lldb::addr_t context)
1641 {
1642     OperatingSystem *os = GetOperatingSystem ();
1643     if (os)
1644         return os->CreateThread(tid, context);
1645     return ThreadSP();
1646 }
1647 
1648 uint32_t
1649 Process::GetNextThreadIndexID (uint64_t thread_id)
1650 {
1651     return AssignIndexIDToThread(thread_id);
1652 }
1653 
1654 bool
1655 Process::HasAssignedIndexIDToThread(uint64_t thread_id)
1656 {
1657     std::map<uint64_t, uint32_t>::iterator iterator = m_thread_id_to_index_id_map.find(thread_id);
1658     if (iterator == m_thread_id_to_index_id_map.end())
1659     {
1660         return false;
1661     }
1662     else
1663     {
1664         return true;
1665     }
1666 }
1667 
1668 uint32_t
1669 Process::AssignIndexIDToThread(uint64_t thread_id)
1670 {
1671     uint32_t result = 0;
1672     std::map<uint64_t, uint32_t>::iterator iterator = m_thread_id_to_index_id_map.find(thread_id);
1673     if (iterator == m_thread_id_to_index_id_map.end())
1674     {
1675         result = ++m_thread_index_id;
1676         m_thread_id_to_index_id_map[thread_id] = result;
1677     }
1678     else
1679     {
1680         result = iterator->second;
1681     }
1682 
1683     return result;
1684 }
1685 
1686 StateType
1687 Process::GetState()
1688 {
1689     // If any other threads access this we will need a mutex for it
1690     return m_public_state.GetValue ();
1691 }
1692 
1693 bool
1694 Process::StateChangedIsExternallyHijacked()
1695 {
1696     if (IsHijackedForEvent(eBroadcastBitStateChanged))
1697     {
1698         if (strcmp(m_hijacking_listeners.back()->GetName(), "lldb.Process.ResumeSynchronous.hijack"))
1699             return true;
1700     }
1701     return false;
1702 }
1703 
1704 void
1705 Process::SetPublicState (StateType new_state, bool restarted)
1706 {
1707     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1708     if (log)
1709         log->Printf("Process::SetPublicState (state = %s, restarted = %i)", StateAsCString(new_state), restarted);
1710     const StateType old_state = m_public_state.GetValue();
1711     m_public_state.SetValue (new_state);
1712 
1713     // On the transition from Run to Stopped, we unlock the writer end of the
1714     // run lock.  The lock gets locked in Resume, which is the public API
1715     // to tell the program to run.
1716     if (!StateChangedIsExternallyHijacked())
1717     {
1718         if (new_state == eStateDetached)
1719         {
1720             if (log)
1721                 log->Printf("Process::SetPublicState (%s) -- unlocking run lock for detach", StateAsCString(new_state));
1722             m_public_run_lock.SetStopped();
1723         }
1724         else
1725         {
1726             const bool old_state_is_stopped = StateIsStoppedState(old_state, false);
1727             const bool new_state_is_stopped = StateIsStoppedState(new_state, false);
1728             if ((old_state_is_stopped != new_state_is_stopped))
1729             {
1730                 if (new_state_is_stopped && !restarted)
1731                 {
1732                     if (log)
1733                         log->Printf("Process::SetPublicState (%s) -- unlocking run lock", StateAsCString(new_state));
1734                     m_public_run_lock.SetStopped();
1735                 }
1736             }
1737         }
1738     }
1739 }
1740 
1741 Error
1742 Process::Resume ()
1743 {
1744     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1745     if (log)
1746         log->Printf("Process::Resume -- locking run lock");
1747     if (!m_public_run_lock.TrySetRunning())
1748     {
1749         Error error("Resume request failed - process still running.");
1750         if (log)
1751             log->Printf ("Process::Resume: -- TrySetRunning failed, not resuming.");
1752         return error;
1753     }
1754     return PrivateResume();
1755 }
1756 
1757 Error
1758 Process::ResumeSynchronous (Stream *stream)
1759 {
1760     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1761     if (log)
1762         log->Printf("Process::ResumeSynchronous -- locking run lock");
1763     if (!m_public_run_lock.TrySetRunning())
1764     {
1765         Error error("Resume request failed - process still running.");
1766         if (log)
1767             log->Printf ("Process::Resume: -- TrySetRunning failed, not resuming.");
1768         return error;
1769     }
1770 
1771     ListenerSP listener_sp (new Listener("lldb.Process.ResumeSynchronous.hijack"));
1772     HijackProcessEvents(listener_sp.get());
1773 
1774     Error error = PrivateResume();
1775     if (error.Success())
1776     {
1777         StateType state = WaitForProcessToStop (NULL, NULL, true, listener_sp.get(), stream);
1778         const bool must_be_alive = false; // eStateExited is ok, so this must be false
1779         if (!StateIsStoppedState(state, must_be_alive))
1780             error.SetErrorStringWithFormat("process not in stopped state after synchronous resume: %s", StateAsCString(state));
1781     }
1782 
1783     // Undo the hijacking of process events...
1784     RestoreProcessEvents();
1785 
1786     return error;
1787 }
1788 
1789 StateType
1790 Process::GetPrivateState ()
1791 {
1792     return m_private_state.GetValue();
1793 }
1794 
1795 void
1796 Process::SetPrivateState (StateType new_state)
1797 {
1798     if (m_finalize_called)
1799         return;
1800 
1801     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1802     bool state_changed = false;
1803 
1804     if (log)
1805         log->Printf("Process::SetPrivateState (%s)", StateAsCString(new_state));
1806 
1807     Mutex::Locker thread_locker(m_thread_list.GetMutex());
1808     Mutex::Locker locker(m_private_state.GetMutex());
1809 
1810     const StateType old_state = m_private_state.GetValueNoLock ();
1811     state_changed = old_state != new_state;
1812 
1813     const bool old_state_is_stopped = StateIsStoppedState(old_state, false);
1814     const bool new_state_is_stopped = StateIsStoppedState(new_state, false);
1815     if (old_state_is_stopped != new_state_is_stopped)
1816     {
1817         if (new_state_is_stopped)
1818             m_private_run_lock.SetStopped();
1819         else
1820             m_private_run_lock.SetRunning();
1821     }
1822 
1823     if (state_changed)
1824     {
1825         m_private_state.SetValueNoLock (new_state);
1826         EventSP event_sp (new Event (eBroadcastBitStateChanged, new ProcessEventData (shared_from_this(), new_state)));
1827         if (StateIsStoppedState(new_state, false))
1828         {
1829             // Note, this currently assumes that all threads in the list
1830             // stop when the process stops.  In the future we will want to
1831             // support a debugging model where some threads continue to run
1832             // while others are stopped.  When that happens we will either need
1833             // a way for the thread list to identify which threads are stopping
1834             // or create a special thread list containing only threads which
1835             // actually stopped.
1836             //
1837             // The process plugin is responsible for managing the actual
1838             // behavior of the threads and should have stopped any threads
1839             // that are going to stop before we get here.
1840             m_thread_list.DidStop();
1841 
1842             m_mod_id.BumpStopID();
1843             if (!m_mod_id.IsLastResumeForUserExpression())
1844                 m_mod_id.SetStopEventForLastNaturalStopID(event_sp);
1845             m_memory_cache.Clear();
1846             if (log)
1847                 log->Printf("Process::SetPrivateState (%s) stop_id = %u", StateAsCString(new_state), m_mod_id.GetStopID());
1848         }
1849 
1850         // Use our target to get a shared pointer to ourselves...
1851         if (m_finalize_called && PrivateStateThreadIsValid() == false)
1852             BroadcastEvent (event_sp);
1853         else
1854             m_private_state_broadcaster.BroadcastEvent (event_sp);
1855     }
1856     else
1857     {
1858         if (log)
1859             log->Printf("Process::SetPrivateState (%s) state didn't change. Ignoring...", StateAsCString(new_state));
1860     }
1861 }
1862 
1863 void
1864 Process::SetRunningUserExpression (bool on)
1865 {
1866     m_mod_id.SetRunningUserExpression (on);
1867 }
1868 
1869 addr_t
1870 Process::GetImageInfoAddress()
1871 {
1872     return LLDB_INVALID_ADDRESS;
1873 }
1874 
1875 //----------------------------------------------------------------------
1876 // LoadImage
1877 //
1878 // This function provides a default implementation that works for most
1879 // unix variants. Any Process subclasses that need to do shared library
1880 // loading differently should override LoadImage and UnloadImage and
1881 // do what is needed.
1882 //----------------------------------------------------------------------
1883 uint32_t
1884 Process::LoadImage (const FileSpec &image_spec, Error &error)
1885 {
1886     if (m_finalizing)
1887     {
1888         error.SetErrorString("process is tearing itself down");
1889         return LLDB_INVALID_IMAGE_TOKEN;
1890     }
1891 
1892     char path[PATH_MAX];
1893     image_spec.GetPath(path, sizeof(path));
1894 
1895     DynamicLoader *loader = GetDynamicLoader();
1896     if (loader)
1897     {
1898         error = loader->CanLoadImage();
1899         if (error.Fail())
1900             return LLDB_INVALID_IMAGE_TOKEN;
1901     }
1902 
1903     if (error.Success())
1904     {
1905         ThreadSP thread_sp(GetThreadList ().GetSelectedThread());
1906 
1907         if (thread_sp)
1908         {
1909             StackFrameSP frame_sp (thread_sp->GetStackFrameAtIndex (0));
1910 
1911             if (frame_sp)
1912             {
1913                 ExecutionContext exe_ctx;
1914                 frame_sp->CalculateExecutionContext (exe_ctx);
1915                 EvaluateExpressionOptions expr_options;
1916                 expr_options.SetUnwindOnError(true);
1917                 expr_options.SetIgnoreBreakpoints(true);
1918                 expr_options.SetExecutionPolicy(eExecutionPolicyAlways);
1919                 expr_options.SetResultIsInternal(true);
1920                 expr_options.SetLanguage(eLanguageTypeC_plus_plus);
1921 
1922                 StreamString expr;
1923                 expr.Printf(R"(
1924                                struct __lldb_dlopen_result { void *image_ptr; const char *error_str; } the_result;
1925                                the_result.image_ptr = dlopen ("%s", 2);
1926                                if (the_result.image_ptr == (void *) 0x0)
1927                                {
1928                                    the_result.error_str = dlerror();
1929                                }
1930                                else
1931                                {
1932                                    the_result.error_str = (const char *) 0x0;
1933                                }
1934                                the_result;
1935                               )",
1936                               path);
1937                 const char *prefix = R"(
1938                                         extern "C" void* dlopen (const char *path, int mode);
1939                                         extern "C" const char *dlerror (void);
1940                                         )";
1941                 lldb::ValueObjectSP result_valobj_sp;
1942                 Error expr_error;
1943                 UserExpression::Evaluate (exe_ctx,
1944                                           expr_options,
1945                                           expr.GetData(),
1946                                           prefix,
1947                                           result_valobj_sp,
1948                                           expr_error);
1949                 if (expr_error.Success())
1950                 {
1951                     error = result_valobj_sp->GetError();
1952                     if (error.Success())
1953                     {
1954                         Scalar scalar;
1955                         ValueObjectSP image_ptr_sp = result_valobj_sp->GetChildAtIndex(0, true);
1956                         if (image_ptr_sp && image_ptr_sp->ResolveValue (scalar))
1957                         {
1958                             addr_t image_ptr = scalar.ULongLong(LLDB_INVALID_ADDRESS);
1959                             if (image_ptr != 0 && image_ptr != LLDB_INVALID_ADDRESS)
1960                             {
1961                                 uint32_t image_token = m_image_tokens.size();
1962                                 m_image_tokens.push_back (image_ptr);
1963                                 return image_token;
1964                             }
1965                             else if (image_ptr == 0)
1966                             {
1967                                 ValueObjectSP error_str_sp = result_valobj_sp->GetChildAtIndex(1, true);
1968                                 if (error_str_sp)
1969                                 {
1970                                     if (error_str_sp->IsCStringContainer(true))
1971                                     {
1972                                         DataBufferSP buffer_sp(new DataBufferHeap(10240,0));
1973                                         size_t num_chars = error_str_sp->ReadPointedString (buffer_sp, error, 10240);
1974                                         if (error.Success() && num_chars > 0)
1975                                         {
1976                                             error.Clear();
1977                                             error.SetErrorStringWithFormat("dlopen error: %s", buffer_sp->GetBytes());
1978                                         }
1979                                         else
1980                                         {
1981                                             error.Clear();
1982                                             error.SetErrorStringWithFormat("dlopen failed for unknown reasons.");
1983                                         }
1984                                     }
1985                                 }
1986                             }
1987                         }
1988                     }
1989                 }
1990                 else
1991                     error = expr_error;
1992             }
1993         }
1994     }
1995     if (!error.AsCString())
1996         error.SetErrorStringWithFormat("unable to load '%s'", path);
1997     return LLDB_INVALID_IMAGE_TOKEN;
1998 }
1999 
2000 //----------------------------------------------------------------------
2001 // UnloadImage
2002 //
2003 // This function provides a default implementation that works for most
2004 // unix variants. Any Process subclasses that need to do shared library
2005 // loading differently should override LoadImage and UnloadImage and
2006 // do what is needed.
2007 //----------------------------------------------------------------------
2008 Error
2009 Process::UnloadImage (uint32_t image_token)
2010 {
2011     Error error;
2012 
2013     if (m_finalizing)
2014     {
2015         error.SetErrorString("process is tearing itself down");
2016         return error;
2017     }
2018 
2019     if (image_token < m_image_tokens.size())
2020     {
2021         const addr_t image_addr = m_image_tokens[image_token];
2022         if (image_addr == LLDB_INVALID_ADDRESS)
2023         {
2024             error.SetErrorString("image already unloaded");
2025         }
2026         else
2027         {
2028             DynamicLoader *loader = GetDynamicLoader();
2029             if (loader)
2030                 error = loader->CanLoadImage();
2031 
2032             if (error.Success())
2033             {
2034                 ThreadSP thread_sp(GetThreadList ().GetSelectedThread());
2035 
2036                 if (thread_sp)
2037                 {
2038                     StackFrameSP frame_sp (thread_sp->GetStackFrameAtIndex (0));
2039 
2040                     if (frame_sp)
2041                     {
2042                         ExecutionContext exe_ctx;
2043                         frame_sp->CalculateExecutionContext (exe_ctx);
2044                         EvaluateExpressionOptions expr_options;
2045                         expr_options.SetUnwindOnError(true);
2046                         expr_options.SetIgnoreBreakpoints(true);
2047                         expr_options.SetExecutionPolicy(eExecutionPolicyAlways);
2048                         expr_options.SetLanguage(eLanguageTypeC_plus_plus);
2049 
2050                         StreamString expr;
2051                         expr.Printf("dlclose ((void *)0x%" PRIx64 ")", image_addr);
2052                         const char *prefix = "extern \"C\" int dlclose(void* handle);\n";
2053                         lldb::ValueObjectSP result_valobj_sp;
2054                         Error expr_error;
2055                         UserExpression::Evaluate (exe_ctx,
2056                                                   expr_options,
2057                                                   expr.GetData(),
2058                                                   prefix,
2059                                                   result_valobj_sp,
2060                                                   expr_error);
2061                         if (result_valobj_sp->GetError().Success())
2062                         {
2063                             Scalar scalar;
2064                             if (result_valobj_sp->ResolveValue (scalar))
2065                             {
2066                                 if (scalar.UInt(1))
2067                                 {
2068                                     error.SetErrorStringWithFormat("expression failed: \"%s\"", expr.GetData());
2069                                 }
2070                                 else
2071                                 {
2072                                     m_image_tokens[image_token] = LLDB_INVALID_ADDRESS;
2073                                 }
2074                             }
2075                         }
2076                         else
2077                         {
2078                             error = result_valobj_sp->GetError();
2079                         }
2080                     }
2081                 }
2082             }
2083         }
2084     }
2085     else
2086     {
2087         error.SetErrorString("invalid image token");
2088     }
2089     return error;
2090 }
2091 
2092 const lldb::ABISP &
2093 Process::GetABI()
2094 {
2095     if (!m_abi_sp)
2096         m_abi_sp = ABI::FindPlugin(GetTarget().GetArchitecture());
2097     return m_abi_sp;
2098 }
2099 
2100 LanguageRuntime *
2101 Process::GetLanguageRuntime(lldb::LanguageType language, bool retry_if_null)
2102 {
2103     if (m_finalizing)
2104         return nullptr;
2105 
2106     LanguageRuntimeCollection::iterator pos;
2107     pos = m_language_runtimes.find (language);
2108     if (pos == m_language_runtimes.end() || (retry_if_null && !(*pos).second))
2109     {
2110         lldb::LanguageRuntimeSP runtime_sp(LanguageRuntime::FindPlugin(this, language));
2111 
2112         m_language_runtimes[language] = runtime_sp;
2113         return runtime_sp.get();
2114     }
2115     else
2116         return (*pos).second.get();
2117 }
2118 
2119 CPPLanguageRuntime *
2120 Process::GetCPPLanguageRuntime (bool retry_if_null)
2121 {
2122     LanguageRuntime *runtime = GetLanguageRuntime(eLanguageTypeC_plus_plus, retry_if_null);
2123     if (runtime != NULL && runtime->GetLanguageType() == eLanguageTypeC_plus_plus)
2124         return static_cast<CPPLanguageRuntime *> (runtime);
2125     return NULL;
2126 }
2127 
2128 ObjCLanguageRuntime *
2129 Process::GetObjCLanguageRuntime (bool retry_if_null)
2130 {
2131     LanguageRuntime *runtime = GetLanguageRuntime(eLanguageTypeObjC, retry_if_null);
2132     if (runtime != NULL && runtime->GetLanguageType() == eLanguageTypeObjC)
2133         return static_cast<ObjCLanguageRuntime *> (runtime);
2134     return NULL;
2135 }
2136 
2137 bool
2138 Process::IsPossibleDynamicValue (ValueObject& in_value)
2139 {
2140     if (m_finalizing)
2141         return false;
2142 
2143     if (in_value.IsDynamic())
2144         return false;
2145     LanguageType known_type = in_value.GetObjectRuntimeLanguage();
2146 
2147     if (known_type != eLanguageTypeUnknown && known_type != eLanguageTypeC)
2148     {
2149         LanguageRuntime *runtime = GetLanguageRuntime (known_type);
2150         return runtime ? runtime->CouldHaveDynamicValue(in_value) : false;
2151     }
2152 
2153     LanguageRuntime *cpp_runtime = GetLanguageRuntime (eLanguageTypeC_plus_plus);
2154     if (cpp_runtime && cpp_runtime->CouldHaveDynamicValue(in_value))
2155         return true;
2156 
2157     LanguageRuntime *objc_runtime = GetLanguageRuntime (eLanguageTypeObjC);
2158     return objc_runtime ? objc_runtime->CouldHaveDynamicValue(in_value) : false;
2159 }
2160 
2161 void
2162 Process::SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers)
2163 {
2164     m_dynamic_checkers_ap.reset(dynamic_checkers);
2165 }
2166 
2167 BreakpointSiteList &
2168 Process::GetBreakpointSiteList()
2169 {
2170     return m_breakpoint_site_list;
2171 }
2172 
2173 const BreakpointSiteList &
2174 Process::GetBreakpointSiteList() const
2175 {
2176     return m_breakpoint_site_list;
2177 }
2178 
2179 
2180 void
2181 Process::DisableAllBreakpointSites ()
2182 {
2183     m_breakpoint_site_list.ForEach([this](BreakpointSite *bp_site) -> void {
2184 //        bp_site->SetEnabled(true);
2185         DisableBreakpointSite(bp_site);
2186     });
2187 }
2188 
2189 Error
2190 Process::ClearBreakpointSiteByID (lldb::user_id_t break_id)
2191 {
2192     Error error (DisableBreakpointSiteByID (break_id));
2193 
2194     if (error.Success())
2195         m_breakpoint_site_list.Remove(break_id);
2196 
2197     return error;
2198 }
2199 
2200 Error
2201 Process::DisableBreakpointSiteByID (lldb::user_id_t break_id)
2202 {
2203     Error error;
2204     BreakpointSiteSP bp_site_sp = m_breakpoint_site_list.FindByID (break_id);
2205     if (bp_site_sp)
2206     {
2207         if (bp_site_sp->IsEnabled())
2208             error = DisableBreakpointSite (bp_site_sp.get());
2209     }
2210     else
2211     {
2212         error.SetErrorStringWithFormat("invalid breakpoint site ID: %" PRIu64, break_id);
2213     }
2214 
2215     return error;
2216 }
2217 
2218 Error
2219 Process::EnableBreakpointSiteByID (lldb::user_id_t break_id)
2220 {
2221     Error error;
2222     BreakpointSiteSP bp_site_sp = m_breakpoint_site_list.FindByID (break_id);
2223     if (bp_site_sp)
2224     {
2225         if (!bp_site_sp->IsEnabled())
2226             error = EnableBreakpointSite (bp_site_sp.get());
2227     }
2228     else
2229     {
2230         error.SetErrorStringWithFormat("invalid breakpoint site ID: %" PRIu64, break_id);
2231     }
2232     return error;
2233 }
2234 
2235 lldb::break_id_t
2236 Process::CreateBreakpointSite (const BreakpointLocationSP &owner, bool use_hardware)
2237 {
2238     addr_t load_addr = LLDB_INVALID_ADDRESS;
2239 
2240     bool show_error = true;
2241     switch (GetState())
2242     {
2243         case eStateInvalid:
2244         case eStateUnloaded:
2245         case eStateConnected:
2246         case eStateAttaching:
2247         case eStateLaunching:
2248         case eStateDetached:
2249         case eStateExited:
2250             show_error = false;
2251             break;
2252 
2253         case eStateStopped:
2254         case eStateRunning:
2255         case eStateStepping:
2256         case eStateCrashed:
2257         case eStateSuspended:
2258             show_error = IsAlive();
2259             break;
2260     }
2261 
2262     // Reset the IsIndirect flag here, in case the location changes from
2263     // pointing to a indirect symbol to a regular symbol.
2264     owner->SetIsIndirect (false);
2265 
2266     if (owner->ShouldResolveIndirectFunctions())
2267     {
2268         Symbol *symbol = owner->GetAddress().CalculateSymbolContextSymbol();
2269         if (symbol && symbol->IsIndirect())
2270         {
2271             Error error;
2272             Address symbol_address = symbol->GetAddress();
2273             load_addr = ResolveIndirectFunction (&symbol_address, error);
2274             if (!error.Success() && show_error)
2275             {
2276                 GetTarget().GetDebugger().GetErrorFile()->Printf ("warning: failed to resolve indirect function at 0x%" PRIx64 " for breakpoint %i.%i: %s\n",
2277                                                                    symbol->GetLoadAddress(&GetTarget()),
2278                                                                    owner->GetBreakpoint().GetID(),
2279                                                                    owner->GetID(),
2280                                                                    error.AsCString() ? error.AsCString() : "unknown error");
2281                 return LLDB_INVALID_BREAK_ID;
2282             }
2283             Address resolved_address(load_addr);
2284             load_addr = resolved_address.GetOpcodeLoadAddress (&GetTarget());
2285             owner->SetIsIndirect(true);
2286         }
2287         else
2288             load_addr = owner->GetAddress().GetOpcodeLoadAddress (&GetTarget());
2289     }
2290     else
2291         load_addr = owner->GetAddress().GetOpcodeLoadAddress (&GetTarget());
2292 
2293     if (load_addr != LLDB_INVALID_ADDRESS)
2294     {
2295         BreakpointSiteSP bp_site_sp;
2296 
2297         // Look up this breakpoint site.  If it exists, then add this new owner, otherwise
2298         // create a new breakpoint site and add it.
2299 
2300         bp_site_sp = m_breakpoint_site_list.FindByAddress (load_addr);
2301 
2302         if (bp_site_sp)
2303         {
2304             bp_site_sp->AddOwner (owner);
2305             owner->SetBreakpointSite (bp_site_sp);
2306             return bp_site_sp->GetID();
2307         }
2308         else
2309         {
2310             bp_site_sp.reset (new BreakpointSite (&m_breakpoint_site_list, owner, load_addr, use_hardware));
2311             if (bp_site_sp)
2312             {
2313                 Error error = EnableBreakpointSite (bp_site_sp.get());
2314                 if (error.Success())
2315                 {
2316                     owner->SetBreakpointSite (bp_site_sp);
2317                     return m_breakpoint_site_list.Add (bp_site_sp);
2318                 }
2319                 else
2320                 {
2321                     if (show_error)
2322                     {
2323                         // Report error for setting breakpoint...
2324                         GetTarget().GetDebugger().GetErrorFile()->Printf ("warning: failed to set breakpoint site at 0x%" PRIx64 " for breakpoint %i.%i: %s\n",
2325                                                                            load_addr,
2326                                                                            owner->GetBreakpoint().GetID(),
2327                                                                            owner->GetID(),
2328                                                                            error.AsCString() ? error.AsCString() : "unknown error");
2329                     }
2330                 }
2331             }
2332         }
2333     }
2334     // We failed to enable the breakpoint
2335     return LLDB_INVALID_BREAK_ID;
2336 
2337 }
2338 
2339 void
2340 Process::RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, lldb::user_id_t owner_loc_id, BreakpointSiteSP &bp_site_sp)
2341 {
2342     uint32_t num_owners = bp_site_sp->RemoveOwner (owner_id, owner_loc_id);
2343     if (num_owners == 0)
2344     {
2345         // Don't try to disable the site if we don't have a live process anymore.
2346         if (IsAlive())
2347             DisableBreakpointSite (bp_site_sp.get());
2348         m_breakpoint_site_list.RemoveByAddress(bp_site_sp->GetLoadAddress());
2349     }
2350 }
2351 
2352 
2353 size_t
2354 Process::RemoveBreakpointOpcodesFromBuffer (addr_t bp_addr, size_t size, uint8_t *buf) const
2355 {
2356     size_t bytes_removed = 0;
2357     BreakpointSiteList bp_sites_in_range;
2358 
2359     if (m_breakpoint_site_list.FindInRange (bp_addr, bp_addr + size, bp_sites_in_range))
2360     {
2361         bp_sites_in_range.ForEach([bp_addr, size, buf, &bytes_removed](BreakpointSite *bp_site) -> void {
2362             if (bp_site->GetType() == BreakpointSite::eSoftware)
2363             {
2364                 addr_t intersect_addr;
2365                 size_t intersect_size;
2366                 size_t opcode_offset;
2367                 if (bp_site->IntersectsRange(bp_addr, size, &intersect_addr, &intersect_size, &opcode_offset))
2368                 {
2369                     assert(bp_addr <= intersect_addr && intersect_addr < bp_addr + size);
2370                     assert(bp_addr < intersect_addr + intersect_size && intersect_addr + intersect_size <= bp_addr + size);
2371                     assert(opcode_offset + intersect_size <= bp_site->GetByteSize());
2372                     size_t buf_offset = intersect_addr - bp_addr;
2373                     ::memcpy(buf + buf_offset, bp_site->GetSavedOpcodeBytes() + opcode_offset, intersect_size);
2374                 }
2375             }
2376         });
2377     }
2378     return bytes_removed;
2379 }
2380 
2381 
2382 
2383 size_t
2384 Process::GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site)
2385 {
2386     PlatformSP platform_sp (GetTarget().GetPlatform());
2387     if (platform_sp)
2388         return platform_sp->GetSoftwareBreakpointTrapOpcode (GetTarget(), bp_site);
2389     return 0;
2390 }
2391 
2392 Error
2393 Process::EnableSoftwareBreakpoint (BreakpointSite *bp_site)
2394 {
2395     Error error;
2396     assert (bp_site != NULL);
2397     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
2398     const addr_t bp_addr = bp_site->GetLoadAddress();
2399     if (log)
2400         log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64, bp_site->GetID(), (uint64_t)bp_addr);
2401     if (bp_site->IsEnabled())
2402     {
2403         if (log)
2404             log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- already enabled", bp_site->GetID(), (uint64_t)bp_addr);
2405         return error;
2406     }
2407 
2408     if (bp_addr == LLDB_INVALID_ADDRESS)
2409     {
2410         error.SetErrorString("BreakpointSite contains an invalid load address.");
2411         return error;
2412     }
2413     // Ask the lldb::Process subclass to fill in the correct software breakpoint
2414     // trap for the breakpoint site
2415     const size_t bp_opcode_size = GetSoftwareBreakpointTrapOpcode(bp_site);
2416 
2417     if (bp_opcode_size == 0)
2418     {
2419         error.SetErrorStringWithFormat ("Process::GetSoftwareBreakpointTrapOpcode() returned zero, unable to get breakpoint trap for address 0x%" PRIx64, bp_addr);
2420     }
2421     else
2422     {
2423         const uint8_t * const bp_opcode_bytes = bp_site->GetTrapOpcodeBytes();
2424 
2425         if (bp_opcode_bytes == NULL)
2426         {
2427             error.SetErrorString ("BreakpointSite doesn't contain a valid breakpoint trap opcode.");
2428             return error;
2429         }
2430 
2431         // Save the original opcode by reading it
2432         if (DoReadMemory(bp_addr, bp_site->GetSavedOpcodeBytes(), bp_opcode_size, error) == bp_opcode_size)
2433         {
2434             // Write a software breakpoint in place of the original opcode
2435             if (DoWriteMemory(bp_addr, bp_opcode_bytes, bp_opcode_size, error) == bp_opcode_size)
2436             {
2437                 uint8_t verify_bp_opcode_bytes[64];
2438                 if (DoReadMemory(bp_addr, verify_bp_opcode_bytes, bp_opcode_size, error) == bp_opcode_size)
2439                 {
2440                     if (::memcmp(bp_opcode_bytes, verify_bp_opcode_bytes, bp_opcode_size) == 0)
2441                     {
2442                         bp_site->SetEnabled(true);
2443                         bp_site->SetType (BreakpointSite::eSoftware);
2444                         if (log)
2445                             log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- SUCCESS",
2446                                          bp_site->GetID(),
2447                                          (uint64_t)bp_addr);
2448                     }
2449                     else
2450                         error.SetErrorString("failed to verify the breakpoint trap in memory.");
2451                 }
2452                 else
2453                     error.SetErrorString("Unable to read memory to verify breakpoint trap.");
2454             }
2455             else
2456                 error.SetErrorString("Unable to write breakpoint trap to memory.");
2457         }
2458         else
2459             error.SetErrorString("Unable to read memory at breakpoint address.");
2460     }
2461     if (log && error.Fail())
2462         log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- FAILED: %s",
2463                      bp_site->GetID(),
2464                      (uint64_t)bp_addr,
2465                      error.AsCString());
2466     return error;
2467 }
2468 
2469 Error
2470 Process::DisableSoftwareBreakpoint (BreakpointSite *bp_site)
2471 {
2472     Error error;
2473     assert (bp_site != NULL);
2474     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
2475     addr_t bp_addr = bp_site->GetLoadAddress();
2476     lldb::user_id_t breakID = bp_site->GetID();
2477     if (log)
2478         log->Printf ("Process::DisableSoftwareBreakpoint (breakID = %" PRIu64 ") addr = 0x%" PRIx64, breakID, (uint64_t)bp_addr);
2479 
2480     if (bp_site->IsHardware())
2481     {
2482         error.SetErrorString("Breakpoint site is a hardware breakpoint.");
2483     }
2484     else if (bp_site->IsEnabled())
2485     {
2486         const size_t break_op_size = bp_site->GetByteSize();
2487         const uint8_t * const break_op = bp_site->GetTrapOpcodeBytes();
2488         if (break_op_size > 0)
2489         {
2490             // Clear a software breakpoint instruction
2491             uint8_t curr_break_op[8];
2492             assert (break_op_size <= sizeof(curr_break_op));
2493             bool break_op_found = false;
2494 
2495             // Read the breakpoint opcode
2496             if (DoReadMemory (bp_addr, curr_break_op, break_op_size, error) == break_op_size)
2497             {
2498                 bool verify = false;
2499                 // Make sure the breakpoint opcode exists at this address
2500                 if (::memcmp (curr_break_op, break_op, break_op_size) == 0)
2501                 {
2502                     break_op_found = true;
2503                     // We found a valid breakpoint opcode at this address, now restore
2504                     // the saved opcode.
2505                     if (DoWriteMemory (bp_addr, bp_site->GetSavedOpcodeBytes(), break_op_size, error) == break_op_size)
2506                     {
2507                         verify = true;
2508                     }
2509                     else
2510                         error.SetErrorString("Memory write failed when restoring original opcode.");
2511                 }
2512                 else
2513                 {
2514                     error.SetErrorString("Original breakpoint trap is no longer in memory.");
2515                     // Set verify to true and so we can check if the original opcode has already been restored
2516                     verify = true;
2517                 }
2518 
2519                 if (verify)
2520                 {
2521                     uint8_t verify_opcode[8];
2522                     assert (break_op_size < sizeof(verify_opcode));
2523                     // Verify that our original opcode made it back to the inferior
2524                     if (DoReadMemory (bp_addr, verify_opcode, break_op_size, error) == break_op_size)
2525                     {
2526                         // compare the memory we just read with the original opcode
2527                         if (::memcmp (bp_site->GetSavedOpcodeBytes(), verify_opcode, break_op_size) == 0)
2528                         {
2529                             // SUCCESS
2530                             bp_site->SetEnabled(false);
2531                             if (log)
2532                                 log->Printf ("Process::DisableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- SUCCESS", bp_site->GetID(), (uint64_t)bp_addr);
2533                             return error;
2534                         }
2535                         else
2536                         {
2537                             if (break_op_found)
2538                                 error.SetErrorString("Failed to restore original opcode.");
2539                         }
2540                     }
2541                     else
2542                         error.SetErrorString("Failed to read memory to verify that breakpoint trap was restored.");
2543                 }
2544             }
2545             else
2546                 error.SetErrorString("Unable to read memory that should contain the breakpoint trap.");
2547         }
2548     }
2549     else
2550     {
2551         if (log)
2552             log->Printf ("Process::DisableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- already disabled", bp_site->GetID(), (uint64_t)bp_addr);
2553         return error;
2554     }
2555 
2556     if (log)
2557         log->Printf ("Process::DisableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- FAILED: %s",
2558                      bp_site->GetID(),
2559                      (uint64_t)bp_addr,
2560                      error.AsCString());
2561     return error;
2562 
2563 }
2564 
2565 // Uncomment to verify memory caching works after making changes to caching code
2566 //#define VERIFY_MEMORY_READS
2567 
2568 size_t
2569 Process::ReadMemory (addr_t addr, void *buf, size_t size, Error &error)
2570 {
2571     error.Clear();
2572     if (!GetDisableMemoryCache())
2573     {
2574 #if defined (VERIFY_MEMORY_READS)
2575         // Memory caching is enabled, with debug verification
2576 
2577         if (buf && size)
2578         {
2579             // Uncomment the line below to make sure memory caching is working.
2580             // I ran this through the test suite and got no assertions, so I am
2581             // pretty confident this is working well. If any changes are made to
2582             // memory caching, uncomment the line below and test your changes!
2583 
2584             // Verify all memory reads by using the cache first, then redundantly
2585             // reading the same memory from the inferior and comparing to make sure
2586             // everything is exactly the same.
2587             std::string verify_buf (size, '\0');
2588             assert (verify_buf.size() == size);
2589             const size_t cache_bytes_read = m_memory_cache.Read (this, addr, buf, size, error);
2590             Error verify_error;
2591             const size_t verify_bytes_read = ReadMemoryFromInferior (addr, const_cast<char *>(verify_buf.data()), verify_buf.size(), verify_error);
2592             assert (cache_bytes_read == verify_bytes_read);
2593             assert (memcmp(buf, verify_buf.data(), verify_buf.size()) == 0);
2594             assert (verify_error.Success() == error.Success());
2595             return cache_bytes_read;
2596         }
2597         return 0;
2598 #else // !defined(VERIFY_MEMORY_READS)
2599         // Memory caching is enabled, without debug verification
2600 
2601         return m_memory_cache.Read (addr, buf, size, error);
2602 #endif // defined (VERIFY_MEMORY_READS)
2603     }
2604     else
2605     {
2606         // Memory caching is disabled
2607 
2608         return ReadMemoryFromInferior (addr, buf, size, error);
2609     }
2610 }
2611 
2612 size_t
2613 Process::ReadCStringFromMemory (addr_t addr, std::string &out_str, Error &error)
2614 {
2615     char buf[256];
2616     out_str.clear();
2617     addr_t curr_addr = addr;
2618     while (1)
2619     {
2620         size_t length = ReadCStringFromMemory (curr_addr, buf, sizeof(buf), error);
2621         if (length == 0)
2622             break;
2623         out_str.append(buf, length);
2624         // If we got "length - 1" bytes, we didn't get the whole C string, we
2625         // need to read some more characters
2626         if (length == sizeof(buf) - 1)
2627             curr_addr += length;
2628         else
2629             break;
2630     }
2631     return out_str.size();
2632 }
2633 
2634 
2635 size_t
2636 Process::ReadStringFromMemory (addr_t addr, char *dst, size_t max_bytes, Error &error,
2637                                 size_t type_width)
2638 {
2639     size_t total_bytes_read = 0;
2640     if (dst && max_bytes && type_width && max_bytes >= type_width)
2641     {
2642         // Ensure a null terminator independent of the number of bytes that is read.
2643         memset (dst, 0, max_bytes);
2644         size_t bytes_left = max_bytes - type_width;
2645 
2646         const char terminator[4] = {'\0', '\0', '\0', '\0'};
2647         assert(sizeof(terminator) >= type_width &&
2648                "Attempting to validate a string with more than 4 bytes per character!");
2649 
2650         addr_t curr_addr = addr;
2651         const size_t cache_line_size = m_memory_cache.GetMemoryCacheLineSize();
2652         char *curr_dst = dst;
2653 
2654         error.Clear();
2655         while (bytes_left > 0 && error.Success())
2656         {
2657             addr_t cache_line_bytes_left = cache_line_size - (curr_addr % cache_line_size);
2658             addr_t bytes_to_read = std::min<addr_t>(bytes_left, cache_line_bytes_left);
2659             size_t bytes_read = ReadMemory (curr_addr, curr_dst, bytes_to_read, error);
2660 
2661             if (bytes_read == 0)
2662                 break;
2663 
2664             // Search for a null terminator of correct size and alignment in bytes_read
2665             size_t aligned_start = total_bytes_read - total_bytes_read % type_width;
2666             for (size_t i = aligned_start; i + type_width <= total_bytes_read + bytes_read; i += type_width)
2667                 if (::strncmp(&dst[i], terminator, type_width) == 0)
2668                 {
2669                     error.Clear();
2670                     return i;
2671                 }
2672 
2673             total_bytes_read += bytes_read;
2674             curr_dst += bytes_read;
2675             curr_addr += bytes_read;
2676             bytes_left -= bytes_read;
2677         }
2678     }
2679     else
2680     {
2681         if (max_bytes)
2682             error.SetErrorString("invalid arguments");
2683     }
2684     return total_bytes_read;
2685 }
2686 
2687 // Deprecated in favor of ReadStringFromMemory which has wchar support and correct code to find
2688 // null terminators.
2689 size_t
2690 Process::ReadCStringFromMemory (addr_t addr, char *dst, size_t dst_max_len, Error &result_error)
2691 {
2692     size_t total_cstr_len = 0;
2693     if (dst && dst_max_len)
2694     {
2695         result_error.Clear();
2696         // NULL out everything just to be safe
2697         memset (dst, 0, dst_max_len);
2698         Error error;
2699         addr_t curr_addr = addr;
2700         const size_t cache_line_size = m_memory_cache.GetMemoryCacheLineSize();
2701         size_t bytes_left = dst_max_len - 1;
2702         char *curr_dst = dst;
2703 
2704         while (bytes_left > 0)
2705         {
2706             addr_t cache_line_bytes_left = cache_line_size - (curr_addr % cache_line_size);
2707             addr_t bytes_to_read = std::min<addr_t>(bytes_left, cache_line_bytes_left);
2708             size_t bytes_read = ReadMemory (curr_addr, curr_dst, bytes_to_read, error);
2709 
2710             if (bytes_read == 0)
2711             {
2712                 result_error = error;
2713                 dst[total_cstr_len] = '\0';
2714                 break;
2715             }
2716             const size_t len = strlen(curr_dst);
2717 
2718             total_cstr_len += len;
2719 
2720             if (len < bytes_to_read)
2721                 break;
2722 
2723             curr_dst += bytes_read;
2724             curr_addr += bytes_read;
2725             bytes_left -= bytes_read;
2726         }
2727     }
2728     else
2729     {
2730         if (dst == NULL)
2731             result_error.SetErrorString("invalid arguments");
2732         else
2733             result_error.Clear();
2734     }
2735     return total_cstr_len;
2736 }
2737 
2738 size_t
2739 Process::ReadMemoryFromInferior (addr_t addr, void *buf, size_t size, Error &error)
2740 {
2741     if (buf == NULL || size == 0)
2742         return 0;
2743 
2744     size_t bytes_read = 0;
2745     uint8_t *bytes = (uint8_t *)buf;
2746 
2747     while (bytes_read < size)
2748     {
2749         const size_t curr_size = size - bytes_read;
2750         const size_t curr_bytes_read = DoReadMemory (addr + bytes_read,
2751                                                      bytes + bytes_read,
2752                                                      curr_size,
2753                                                      error);
2754         bytes_read += curr_bytes_read;
2755         if (curr_bytes_read == curr_size || curr_bytes_read == 0)
2756             break;
2757     }
2758 
2759     // Replace any software breakpoint opcodes that fall into this range back
2760     // into "buf" before we return
2761     if (bytes_read > 0)
2762         RemoveBreakpointOpcodesFromBuffer (addr, bytes_read, (uint8_t *)buf);
2763     return bytes_read;
2764 }
2765 
2766 uint64_t
2767 Process::ReadUnsignedIntegerFromMemory (lldb::addr_t vm_addr, size_t integer_byte_size, uint64_t fail_value, Error &error)
2768 {
2769     Scalar scalar;
2770     if (ReadScalarIntegerFromMemory(vm_addr, integer_byte_size, false, scalar, error))
2771         return scalar.ULongLong(fail_value);
2772     return fail_value;
2773 }
2774 
2775 addr_t
2776 Process::ReadPointerFromMemory (lldb::addr_t vm_addr, Error &error)
2777 {
2778     Scalar scalar;
2779     if (ReadScalarIntegerFromMemory(vm_addr, GetAddressByteSize(), false, scalar, error))
2780         return scalar.ULongLong(LLDB_INVALID_ADDRESS);
2781     return LLDB_INVALID_ADDRESS;
2782 }
2783 
2784 
2785 bool
2786 Process::WritePointerToMemory (lldb::addr_t vm_addr,
2787                                lldb::addr_t ptr_value,
2788                                Error &error)
2789 {
2790     Scalar scalar;
2791     const uint32_t addr_byte_size = GetAddressByteSize();
2792     if (addr_byte_size <= 4)
2793         scalar = (uint32_t)ptr_value;
2794     else
2795         scalar = ptr_value;
2796     return WriteScalarToMemory(vm_addr, scalar, addr_byte_size, error) == addr_byte_size;
2797 }
2798 
2799 size_t
2800 Process::WriteMemoryPrivate (addr_t addr, const void *buf, size_t size, Error &error)
2801 {
2802     size_t bytes_written = 0;
2803     const uint8_t *bytes = (const uint8_t *)buf;
2804 
2805     while (bytes_written < size)
2806     {
2807         const size_t curr_size = size - bytes_written;
2808         const size_t curr_bytes_written = DoWriteMemory (addr + bytes_written,
2809                                                          bytes + bytes_written,
2810                                                          curr_size,
2811                                                          error);
2812         bytes_written += curr_bytes_written;
2813         if (curr_bytes_written == curr_size || curr_bytes_written == 0)
2814             break;
2815     }
2816     return bytes_written;
2817 }
2818 
2819 size_t
2820 Process::WriteMemory (addr_t addr, const void *buf, size_t size, Error &error)
2821 {
2822 #if defined (ENABLE_MEMORY_CACHING)
2823     m_memory_cache.Flush (addr, size);
2824 #endif
2825 
2826     if (buf == NULL || size == 0)
2827         return 0;
2828 
2829     m_mod_id.BumpMemoryID();
2830 
2831     // We need to write any data that would go where any current software traps
2832     // (enabled software breakpoints) any software traps (breakpoints) that we
2833     // may have placed in our tasks memory.
2834 
2835     BreakpointSiteList bp_sites_in_range;
2836 
2837     if (m_breakpoint_site_list.FindInRange (addr, addr + size, bp_sites_in_range))
2838     {
2839         // No breakpoint sites overlap
2840         if (bp_sites_in_range.IsEmpty())
2841             return WriteMemoryPrivate (addr, buf, size, error);
2842         else
2843         {
2844             const uint8_t *ubuf = (const uint8_t *)buf;
2845             uint64_t bytes_written = 0;
2846 
2847             bp_sites_in_range.ForEach([this, addr, size, &bytes_written, &ubuf, &error](BreakpointSite *bp) -> void {
2848 
2849                 if (error.Success())
2850                 {
2851                     addr_t intersect_addr;
2852                     size_t intersect_size;
2853                     size_t opcode_offset;
2854                     const bool intersects = bp->IntersectsRange(addr, size, &intersect_addr, &intersect_size, &opcode_offset);
2855                     UNUSED_IF_ASSERT_DISABLED(intersects);
2856                     assert(intersects);
2857                     assert(addr <= intersect_addr && intersect_addr < addr + size);
2858                     assert(addr < intersect_addr + intersect_size && intersect_addr + intersect_size <= addr + size);
2859                     assert(opcode_offset + intersect_size <= bp->GetByteSize());
2860 
2861                     // Check for bytes before this breakpoint
2862                     const addr_t curr_addr = addr + bytes_written;
2863                     if (intersect_addr > curr_addr)
2864                     {
2865                         // There are some bytes before this breakpoint that we need to
2866                         // just write to memory
2867                         size_t curr_size = intersect_addr - curr_addr;
2868                         size_t curr_bytes_written = WriteMemoryPrivate (curr_addr,
2869                                                                         ubuf + bytes_written,
2870                                                                         curr_size,
2871                                                                         error);
2872                         bytes_written += curr_bytes_written;
2873                         if (curr_bytes_written != curr_size)
2874                         {
2875                             // We weren't able to write all of the requested bytes, we
2876                             // are done looping and will return the number of bytes that
2877                             // we have written so far.
2878                             if (error.Success())
2879                                 error.SetErrorToGenericError();
2880                         }
2881                     }
2882                     // Now write any bytes that would cover up any software breakpoints
2883                     // directly into the breakpoint opcode buffer
2884                     ::memcpy(bp->GetSavedOpcodeBytes() + opcode_offset, ubuf + bytes_written, intersect_size);
2885                     bytes_written += intersect_size;
2886                 }
2887             });
2888 
2889             if (bytes_written < size)
2890                 WriteMemoryPrivate (addr + bytes_written,
2891                                     ubuf + bytes_written,
2892                                     size - bytes_written,
2893                                     error);
2894         }
2895     }
2896     else
2897     {
2898         return WriteMemoryPrivate (addr, buf, size, error);
2899     }
2900 
2901     // Write any remaining bytes after the last breakpoint if we have any left
2902     return 0; //bytes_written;
2903 }
2904 
2905 size_t
2906 Process::WriteScalarToMemory (addr_t addr, const Scalar &scalar, size_t byte_size, Error &error)
2907 {
2908     if (byte_size == UINT32_MAX)
2909         byte_size = scalar.GetByteSize();
2910     if (byte_size > 0)
2911     {
2912         uint8_t buf[32];
2913         const size_t mem_size = scalar.GetAsMemoryData (buf, byte_size, GetByteOrder(), error);
2914         if (mem_size > 0)
2915             return WriteMemory(addr, buf, mem_size, error);
2916         else
2917             error.SetErrorString ("failed to get scalar as memory data");
2918     }
2919     else
2920     {
2921         error.SetErrorString ("invalid scalar value");
2922     }
2923     return 0;
2924 }
2925 
2926 size_t
2927 Process::ReadScalarIntegerFromMemory (addr_t addr,
2928                                       uint32_t byte_size,
2929                                       bool is_signed,
2930                                       Scalar &scalar,
2931                                       Error &error)
2932 {
2933     uint64_t uval = 0;
2934     if (byte_size == 0)
2935     {
2936         error.SetErrorString ("byte size is zero");
2937     }
2938     else if (byte_size & (byte_size - 1))
2939     {
2940         error.SetErrorStringWithFormat ("byte size %u is not a power of 2", byte_size);
2941     }
2942     else if (byte_size <= sizeof(uval))
2943     {
2944         const size_t bytes_read = ReadMemory (addr, &uval, byte_size, error);
2945         if (bytes_read == byte_size)
2946         {
2947             DataExtractor data (&uval, sizeof(uval), GetByteOrder(), GetAddressByteSize());
2948             lldb::offset_t offset = 0;
2949             if (byte_size <= 4)
2950                 scalar = data.GetMaxU32 (&offset, byte_size);
2951             else
2952                 scalar = data.GetMaxU64 (&offset, byte_size);
2953             if (is_signed)
2954                 scalar.SignExtend(byte_size * 8);
2955             return bytes_read;
2956         }
2957     }
2958     else
2959     {
2960         error.SetErrorStringWithFormat ("byte size of %u is too large for integer scalar type", byte_size);
2961     }
2962     return 0;
2963 }
2964 
2965 #define USE_ALLOCATE_MEMORY_CACHE 1
2966 addr_t
2967 Process::AllocateMemory(size_t size, uint32_t permissions, Error &error)
2968 {
2969     if (GetPrivateState() != eStateStopped)
2970         return LLDB_INVALID_ADDRESS;
2971 
2972 #if defined (USE_ALLOCATE_MEMORY_CACHE)
2973     return m_allocated_memory_cache.AllocateMemory(size, permissions, error);
2974 #else
2975     addr_t allocated_addr = DoAllocateMemory (size, permissions, error);
2976     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2977     if (log)
2978         log->Printf("Process::AllocateMemory(size=%" PRIu64 ", permissions=%s) => 0x%16.16" PRIx64 " (m_stop_id = %u m_memory_id = %u)",
2979                     (uint64_t)size,
2980                     GetPermissionsAsCString (permissions),
2981                     (uint64_t)allocated_addr,
2982                     m_mod_id.GetStopID(),
2983                     m_mod_id.GetMemoryID());
2984     return allocated_addr;
2985 #endif
2986 }
2987 
2988 bool
2989 Process::CanJIT ()
2990 {
2991     if (m_can_jit == eCanJITDontKnow)
2992     {
2993         Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2994         Error err;
2995 
2996         uint64_t allocated_memory = AllocateMemory(8,
2997                                                    ePermissionsReadable | ePermissionsWritable | ePermissionsExecutable,
2998                                                    err);
2999 
3000         if (err.Success())
3001         {
3002             m_can_jit = eCanJITYes;
3003             if (log)
3004                 log->Printf ("Process::%s pid %" PRIu64 " allocation test passed, CanJIT () is true", __FUNCTION__, GetID ());
3005         }
3006         else
3007         {
3008             m_can_jit = eCanJITNo;
3009             if (log)
3010                 log->Printf ("Process::%s pid %" PRIu64 " allocation test failed, CanJIT () is false: %s", __FUNCTION__, GetID (), err.AsCString ());
3011         }
3012 
3013         DeallocateMemory (allocated_memory);
3014     }
3015 
3016     return m_can_jit == eCanJITYes;
3017 }
3018 
3019 void
3020 Process::SetCanJIT (bool can_jit)
3021 {
3022     m_can_jit = (can_jit ? eCanJITYes : eCanJITNo);
3023 }
3024 
3025 void
3026 Process::SetCanRunCode (bool can_run_code)
3027 {
3028     SetCanJIT(can_run_code);
3029     m_can_interpret_function_calls = can_run_code;
3030 }
3031 
3032 Error
3033 Process::DeallocateMemory (addr_t ptr)
3034 {
3035     Error error;
3036 #if defined (USE_ALLOCATE_MEMORY_CACHE)
3037     if (!m_allocated_memory_cache.DeallocateMemory(ptr))
3038     {
3039         error.SetErrorStringWithFormat ("deallocation of memory at 0x%" PRIx64 " failed.", (uint64_t)ptr);
3040     }
3041 #else
3042     error = DoDeallocateMemory (ptr);
3043 
3044     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3045     if (log)
3046         log->Printf("Process::DeallocateMemory(addr=0x%16.16" PRIx64 ") => err = %s (m_stop_id = %u, m_memory_id = %u)",
3047                     ptr,
3048                     error.AsCString("SUCCESS"),
3049                     m_mod_id.GetStopID(),
3050                     m_mod_id.GetMemoryID());
3051 #endif
3052     return error;
3053 }
3054 
3055 
3056 ModuleSP
3057 Process::ReadModuleFromMemory (const FileSpec& file_spec,
3058                                lldb::addr_t header_addr,
3059                                size_t size_to_read)
3060 {
3061     Log *log = lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_HOST);
3062     if (log)
3063     {
3064         log->Printf ("Process::ReadModuleFromMemory reading %s binary from memory", file_spec.GetPath().c_str());
3065     }
3066     ModuleSP module_sp (new Module (file_spec, ArchSpec()));
3067     if (module_sp)
3068     {
3069         Error error;
3070         ObjectFile *objfile = module_sp->GetMemoryObjectFile (shared_from_this(), header_addr, error, size_to_read);
3071         if (objfile)
3072             return module_sp;
3073     }
3074     return ModuleSP();
3075 }
3076 
3077 bool
3078 Process::GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions)
3079 {
3080     MemoryRegionInfo range_info;
3081     permissions = 0;
3082     Error error (GetMemoryRegionInfo (load_addr, range_info));
3083     if (!error.Success())
3084         return false;
3085     if (range_info.GetReadable() == MemoryRegionInfo::eDontKnow
3086         || range_info.GetWritable() == MemoryRegionInfo::eDontKnow
3087         || range_info.GetExecutable() == MemoryRegionInfo::eDontKnow)
3088     {
3089         return false;
3090     }
3091 
3092     if (range_info.GetReadable() == MemoryRegionInfo::eYes)
3093         permissions |= lldb::ePermissionsReadable;
3094 
3095     if (range_info.GetWritable() == MemoryRegionInfo::eYes)
3096         permissions |= lldb::ePermissionsWritable;
3097 
3098     if (range_info.GetExecutable() == MemoryRegionInfo::eYes)
3099         permissions |= lldb::ePermissionsExecutable;
3100 
3101     return true;
3102 }
3103 
3104 Error
3105 Process::EnableWatchpoint (Watchpoint *watchpoint, bool notify)
3106 {
3107     Error error;
3108     error.SetErrorString("watchpoints are not supported");
3109     return error;
3110 }
3111 
3112 Error
3113 Process::DisableWatchpoint (Watchpoint *watchpoint, bool notify)
3114 {
3115     Error error;
3116     error.SetErrorString("watchpoints are not supported");
3117     return error;
3118 }
3119 
3120 StateType
3121 Process::WaitForProcessStopPrivate (const TimeValue *timeout, EventSP &event_sp)
3122 {
3123     StateType state;
3124     // Now wait for the process to launch and return control to us, and then
3125     // call DidLaunch:
3126     while (1)
3127     {
3128         event_sp.reset();
3129         state = WaitForStateChangedEventsPrivate (timeout, event_sp);
3130 
3131         if (StateIsStoppedState(state, false))
3132             break;
3133 
3134         // If state is invalid, then we timed out
3135         if (state == eStateInvalid)
3136             break;
3137 
3138         if (event_sp)
3139             HandlePrivateEvent (event_sp);
3140     }
3141     return state;
3142 }
3143 
3144 void
3145 Process::LoadOperatingSystemPlugin(bool flush)
3146 {
3147     if (flush)
3148         m_thread_list.Clear();
3149     m_os_ap.reset (OperatingSystem::FindPlugin (this, NULL));
3150     if (flush)
3151         Flush();
3152 }
3153 
3154 Error
3155 Process::Launch (ProcessLaunchInfo &launch_info)
3156 {
3157     Error error;
3158     m_abi_sp.reset();
3159     m_dyld_ap.reset();
3160     m_jit_loaders_ap.reset();
3161     m_system_runtime_ap.reset();
3162     m_os_ap.reset();
3163     m_process_input_reader.reset();
3164     m_stop_info_override_callback = NULL;
3165 
3166     Module *exe_module = GetTarget().GetExecutableModulePointer();
3167     if (exe_module)
3168     {
3169         char local_exec_file_path[PATH_MAX];
3170         char platform_exec_file_path[PATH_MAX];
3171         exe_module->GetFileSpec().GetPath(local_exec_file_path, sizeof(local_exec_file_path));
3172         exe_module->GetPlatformFileSpec().GetPath(platform_exec_file_path, sizeof(platform_exec_file_path));
3173         if (exe_module->GetFileSpec().Exists())
3174         {
3175             // Install anything that might need to be installed prior to launching.
3176             // For host systems, this will do nothing, but if we are connected to a
3177             // remote platform it will install any needed binaries
3178             error = GetTarget().Install(&launch_info);
3179             if (error.Fail())
3180                 return error;
3181 
3182             if (PrivateStateThreadIsValid ())
3183                 PausePrivateStateThread ();
3184 
3185             error = WillLaunch (exe_module);
3186             if (error.Success())
3187             {
3188                 const bool restarted = false;
3189                 SetPublicState (eStateLaunching, restarted);
3190                 m_should_detach = false;
3191 
3192                 if (m_public_run_lock.TrySetRunning())
3193                 {
3194                     // Now launch using these arguments.
3195                     error = DoLaunch (exe_module, launch_info);
3196                 }
3197                 else
3198                 {
3199                     // This shouldn't happen
3200                     error.SetErrorString("failed to acquire process run lock");
3201                 }
3202 
3203                 if (error.Fail())
3204                 {
3205                     if (GetID() != LLDB_INVALID_PROCESS_ID)
3206                     {
3207                         SetID (LLDB_INVALID_PROCESS_ID);
3208                         const char *error_string = error.AsCString();
3209                         if (error_string == NULL)
3210                             error_string = "launch failed";
3211                         SetExitStatus (-1, error_string);
3212                     }
3213                 }
3214                 else
3215                 {
3216                     EventSP event_sp;
3217                     TimeValue timeout_time;
3218                     timeout_time = TimeValue::Now();
3219                     timeout_time.OffsetWithSeconds(10);
3220                     StateType state = WaitForProcessStopPrivate(&timeout_time, event_sp);
3221 
3222                     if (state == eStateInvalid || event_sp.get() == NULL)
3223                     {
3224                         // We were able to launch the process, but we failed to
3225                         // catch the initial stop.
3226                         error.SetErrorString ("failed to catch stop after launch");
3227                         SetExitStatus (0, "failed to catch stop after launch");
3228                         Destroy(false);
3229                     }
3230                     else if (state == eStateStopped || state == eStateCrashed)
3231                     {
3232 
3233                         DidLaunch ();
3234 
3235                         DynamicLoader *dyld = GetDynamicLoader ();
3236                         if (dyld)
3237                             dyld->DidLaunch();
3238 
3239                         GetJITLoaders().DidLaunch();
3240 
3241                         SystemRuntime *system_runtime = GetSystemRuntime ();
3242                         if (system_runtime)
3243                             system_runtime->DidLaunch();
3244 
3245                         LoadOperatingSystemPlugin(false);
3246 
3247                         // Note, the stop event was consumed above, but not handled. This was done
3248                         // to give DidLaunch a chance to run. The target is either stopped or crashed.
3249                         // Directly set the state.  This is done to prevent a stop message with a bunch
3250                         // of spurious output on thread status, as well as not pop a ProcessIOHandler.
3251                         SetPublicState(state, false);
3252 
3253                         if (PrivateStateThreadIsValid ())
3254                             ResumePrivateStateThread ();
3255                         else
3256                             StartPrivateStateThread ();
3257 
3258                         m_stop_info_override_callback = GetTarget().GetArchitecture().GetStopInfoOverrideCallback();
3259 
3260                         // Target was stopped at entry as was intended. Need to notify the listeners
3261                         // about it.
3262                         if (state == eStateStopped && launch_info.GetFlags().Test(eLaunchFlagStopAtEntry))
3263                             HandlePrivateEvent(event_sp);
3264                     }
3265                     else if (state == eStateExited)
3266                     {
3267                         // We exited while trying to launch somehow.  Don't call DidLaunch as that's
3268                         // not likely to work, and return an invalid pid.
3269                         HandlePrivateEvent (event_sp);
3270                     }
3271                 }
3272             }
3273         }
3274         else
3275         {
3276             error.SetErrorStringWithFormat("file doesn't exist: '%s'", local_exec_file_path);
3277         }
3278     }
3279     return error;
3280 }
3281 
3282 
3283 Error
3284 Process::LoadCore ()
3285 {
3286     Error error = DoLoadCore();
3287     if (error.Success())
3288     {
3289         Listener listener ("lldb.process.load_core_listener");
3290         HijackProcessEvents(&listener);
3291 
3292         if (PrivateStateThreadIsValid ())
3293             ResumePrivateStateThread ();
3294         else
3295             StartPrivateStateThread ();
3296 
3297         DynamicLoader *dyld = GetDynamicLoader ();
3298         if (dyld)
3299             dyld->DidAttach();
3300 
3301         GetJITLoaders().DidAttach();
3302 
3303         SystemRuntime *system_runtime = GetSystemRuntime ();
3304         if (system_runtime)
3305             system_runtime->DidAttach();
3306 
3307         m_os_ap.reset (OperatingSystem::FindPlugin (this, NULL));
3308         // We successfully loaded a core file, now pretend we stopped so we can
3309         // show all of the threads in the core file and explore the crashed
3310         // state.
3311         SetPrivateState (eStateStopped);
3312 
3313         // Wait indefinitely for a stopped event since we just posted one above...
3314         lldb::EventSP event_sp;
3315         listener.WaitForEvent (NULL, event_sp);
3316         StateType state = ProcessEventData::GetStateFromEvent(event_sp.get());
3317 
3318         if (!StateIsStoppedState (state, false))
3319         {
3320             Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3321             if (log)
3322                 log->Printf("Process::Halt() failed to stop, state is: %s", StateAsCString(state));
3323             error.SetErrorString ("Did not get stopped event after loading the core file.");
3324         }
3325         RestoreProcessEvents ();
3326     }
3327     return error;
3328 }
3329 
3330 DynamicLoader *
3331 Process::GetDynamicLoader ()
3332 {
3333     if (m_dyld_ap.get() == NULL)
3334         m_dyld_ap.reset (DynamicLoader::FindPlugin(this, NULL));
3335     return m_dyld_ap.get();
3336 }
3337 
3338 const lldb::DataBufferSP
3339 Process::GetAuxvData()
3340 {
3341     return DataBufferSP ();
3342 }
3343 
3344 JITLoaderList &
3345 Process::GetJITLoaders ()
3346 {
3347     if (!m_jit_loaders_ap)
3348     {
3349         m_jit_loaders_ap.reset(new JITLoaderList());
3350         JITLoader::LoadPlugins(this, *m_jit_loaders_ap);
3351     }
3352     return *m_jit_loaders_ap;
3353 }
3354 
3355 SystemRuntime *
3356 Process::GetSystemRuntime ()
3357 {
3358     if (m_system_runtime_ap.get() == NULL)
3359         m_system_runtime_ap.reset (SystemRuntime::FindPlugin(this));
3360     return m_system_runtime_ap.get();
3361 }
3362 
3363 Process::AttachCompletionHandler::AttachCompletionHandler (Process *process, uint32_t exec_count) :
3364     NextEventAction (process),
3365     m_exec_count (exec_count)
3366 {
3367     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3368     if (log)
3369         log->Printf ("Process::AttachCompletionHandler::%s process=%p, exec_count=%" PRIu32, __FUNCTION__, static_cast<void*>(process), exec_count);
3370 }
3371 
3372 Process::NextEventAction::EventActionResult
3373 Process::AttachCompletionHandler::PerformAction (lldb::EventSP &event_sp)
3374 {
3375     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3376 
3377     StateType state = ProcessEventData::GetStateFromEvent (event_sp.get());
3378     if (log)
3379         log->Printf ("Process::AttachCompletionHandler::%s called with state %s (%d)", __FUNCTION__, StateAsCString(state), static_cast<int> (state));
3380 
3381     switch (state)
3382     {
3383         case eStateAttaching:
3384             return eEventActionSuccess;
3385 
3386         case eStateRunning:
3387         case eStateConnected:
3388             return eEventActionRetry;
3389 
3390         case eStateStopped:
3391         case eStateCrashed:
3392             {
3393                 // During attach, prior to sending the eStateStopped event,
3394                 // lldb_private::Process subclasses must set the new process ID.
3395                 assert (m_process->GetID() != LLDB_INVALID_PROCESS_ID);
3396                 // We don't want these events to be reported, so go set the ShouldReportStop here:
3397                 m_process->GetThreadList().SetShouldReportStop (eVoteNo);
3398 
3399                 if (m_exec_count > 0)
3400                 {
3401                     --m_exec_count;
3402 
3403                     if (log)
3404                         log->Printf ("Process::AttachCompletionHandler::%s state %s: reduced remaining exec count to %" PRIu32 ", requesting resume", __FUNCTION__, StateAsCString(state), m_exec_count);
3405 
3406                     RequestResume();
3407                     return eEventActionRetry;
3408                 }
3409                 else
3410                 {
3411                     if (log)
3412                         log->Printf ("Process::AttachCompletionHandler::%s state %s: no more execs expected to start, continuing with attach", __FUNCTION__, StateAsCString(state));
3413 
3414                     m_process->CompleteAttach ();
3415                     return eEventActionSuccess;
3416                 }
3417             }
3418             break;
3419 
3420         default:
3421         case eStateExited:
3422         case eStateInvalid:
3423             break;
3424     }
3425 
3426     m_exit_string.assign ("No valid Process");
3427     return eEventActionExit;
3428 }
3429 
3430 Process::NextEventAction::EventActionResult
3431 Process::AttachCompletionHandler::HandleBeingInterrupted()
3432 {
3433     return eEventActionSuccess;
3434 }
3435 
3436 const char *
3437 Process::AttachCompletionHandler::GetExitString ()
3438 {
3439     return m_exit_string.c_str();
3440 }
3441 
3442 Listener &
3443 ProcessAttachInfo::GetListenerForProcess (Debugger &debugger)
3444 {
3445     if (m_listener_sp)
3446         return *m_listener_sp;
3447     else
3448         return debugger.GetListener();
3449 }
3450 
3451 Error
3452 Process::Attach (ProcessAttachInfo &attach_info)
3453 {
3454     m_abi_sp.reset();
3455     m_process_input_reader.reset();
3456     m_dyld_ap.reset();
3457     m_jit_loaders_ap.reset();
3458     m_system_runtime_ap.reset();
3459     m_os_ap.reset();
3460     m_stop_info_override_callback = NULL;
3461 
3462     lldb::pid_t attach_pid = attach_info.GetProcessID();
3463     Error error;
3464     if (attach_pid == LLDB_INVALID_PROCESS_ID)
3465     {
3466         char process_name[PATH_MAX];
3467 
3468         if (attach_info.GetExecutableFile().GetPath (process_name, sizeof(process_name)))
3469         {
3470             const bool wait_for_launch = attach_info.GetWaitForLaunch();
3471 
3472             if (wait_for_launch)
3473             {
3474                 error = WillAttachToProcessWithName(process_name, wait_for_launch);
3475                 if (error.Success())
3476                 {
3477                     if (m_public_run_lock.TrySetRunning())
3478                     {
3479                         m_should_detach = true;
3480                         const bool restarted = false;
3481                         SetPublicState (eStateAttaching, restarted);
3482                         // Now attach using these arguments.
3483                         error = DoAttachToProcessWithName (process_name, attach_info);
3484                     }
3485                     else
3486                     {
3487                         // This shouldn't happen
3488                         error.SetErrorString("failed to acquire process run lock");
3489                     }
3490 
3491                     if (error.Fail())
3492                     {
3493                         if (GetID() != LLDB_INVALID_PROCESS_ID)
3494                         {
3495                             SetID (LLDB_INVALID_PROCESS_ID);
3496                             if (error.AsCString() == NULL)
3497                                 error.SetErrorString("attach failed");
3498 
3499                             SetExitStatus(-1, error.AsCString());
3500                         }
3501                     }
3502                     else
3503                     {
3504                         SetNextEventAction(new Process::AttachCompletionHandler(this, attach_info.GetResumeCount()));
3505                         StartPrivateStateThread();
3506                     }
3507                     return error;
3508                 }
3509             }
3510             else
3511             {
3512                 ProcessInstanceInfoList process_infos;
3513                 PlatformSP platform_sp (GetTarget().GetPlatform ());
3514 
3515                 if (platform_sp)
3516                 {
3517                     ProcessInstanceInfoMatch match_info;
3518                     match_info.GetProcessInfo() = attach_info;
3519                     match_info.SetNameMatchType (eNameMatchEquals);
3520                     platform_sp->FindProcesses (match_info, process_infos);
3521                     const uint32_t num_matches = process_infos.GetSize();
3522                     if (num_matches == 1)
3523                     {
3524                         attach_pid = process_infos.GetProcessIDAtIndex(0);
3525                         // Fall through and attach using the above process ID
3526                     }
3527                     else
3528                     {
3529                         match_info.GetProcessInfo().GetExecutableFile().GetPath (process_name, sizeof(process_name));
3530                         if (num_matches > 1)
3531                         {
3532                             StreamString s;
3533                             ProcessInstanceInfo::DumpTableHeader (s, platform_sp.get(), true, false);
3534                             for (size_t i = 0; i < num_matches; i++)
3535                             {
3536                                 process_infos.GetProcessInfoAtIndex(i).DumpAsTableRow(s, platform_sp.get(), true, false);
3537                             }
3538                             error.SetErrorStringWithFormat ("more than one process named %s:\n%s",
3539                                                             process_name,
3540                                                             s.GetData());
3541                         }
3542                         else
3543                             error.SetErrorStringWithFormat ("could not find a process named %s", process_name);
3544                     }
3545                 }
3546                 else
3547                 {
3548                     error.SetErrorString ("invalid platform, can't find processes by name");
3549                     return error;
3550                 }
3551             }
3552         }
3553         else
3554         {
3555             error.SetErrorString ("invalid process name");
3556         }
3557     }
3558 
3559     if (attach_pid != LLDB_INVALID_PROCESS_ID)
3560     {
3561         error = WillAttachToProcessWithID(attach_pid);
3562         if (error.Success())
3563         {
3564 
3565             if (m_public_run_lock.TrySetRunning())
3566             {
3567                 // Now attach using these arguments.
3568                 m_should_detach = true;
3569                 const bool restarted = false;
3570                 SetPublicState (eStateAttaching, restarted);
3571                 error = DoAttachToProcessWithID (attach_pid, attach_info);
3572             }
3573             else
3574             {
3575                 // This shouldn't happen
3576                 error.SetErrorString("failed to acquire process run lock");
3577             }
3578 
3579             if (error.Success())
3580             {
3581 
3582                 SetNextEventAction(new Process::AttachCompletionHandler(this, attach_info.GetResumeCount()));
3583                 StartPrivateStateThread();
3584             }
3585             else
3586             {
3587                 if (GetID() != LLDB_INVALID_PROCESS_ID)
3588                     SetID (LLDB_INVALID_PROCESS_ID);
3589 
3590                 const char *error_string = error.AsCString();
3591                 if (error_string == NULL)
3592                     error_string = "attach failed";
3593 
3594                 SetExitStatus(-1, error_string);
3595             }
3596         }
3597     }
3598     return error;
3599 }
3600 
3601 void
3602 Process::CompleteAttach ()
3603 {
3604     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3605     if (log)
3606         log->Printf ("Process::%s()", __FUNCTION__);
3607 
3608     // Let the process subclass figure out at much as it can about the process
3609     // before we go looking for a dynamic loader plug-in.
3610     ArchSpec process_arch;
3611     DidAttach(process_arch);
3612 
3613     if (process_arch.IsValid())
3614     {
3615         GetTarget().SetArchitecture(process_arch);
3616         if (log)
3617         {
3618             const char *triple_str = process_arch.GetTriple().getTriple().c_str ();
3619             log->Printf ("Process::%s replacing process architecture with DidAttach() architecture: %s",
3620                          __FUNCTION__,
3621                          triple_str ? triple_str : "<null>");
3622         }
3623     }
3624 
3625     // We just attached.  If we have a platform, ask it for the process architecture, and if it isn't
3626     // the same as the one we've already set, switch architectures.
3627     PlatformSP platform_sp (GetTarget().GetPlatform ());
3628     assert (platform_sp.get());
3629     if (platform_sp)
3630     {
3631         const ArchSpec &target_arch = GetTarget().GetArchitecture();
3632         if (target_arch.IsValid() && !platform_sp->IsCompatibleArchitecture (target_arch, false, NULL))
3633         {
3634             ArchSpec platform_arch;
3635             platform_sp = platform_sp->GetPlatformForArchitecture (target_arch, &platform_arch);
3636             if (platform_sp)
3637             {
3638                 GetTarget().SetPlatform (platform_sp);
3639                 GetTarget().SetArchitecture(platform_arch);
3640                 if (log)
3641                     log->Printf ("Process::%s switching platform to %s and architecture to %s based on info from attach", __FUNCTION__, platform_sp->GetName().AsCString (""), platform_arch.GetTriple().getTriple().c_str ());
3642             }
3643         }
3644         else if (!process_arch.IsValid())
3645         {
3646             ProcessInstanceInfo process_info;
3647             platform_sp->GetProcessInfo (GetID(), process_info);
3648             const ArchSpec &process_arch = process_info.GetArchitecture();
3649             if (process_arch.IsValid() && !GetTarget().GetArchitecture().IsExactMatch(process_arch))
3650             {
3651                 GetTarget().SetArchitecture (process_arch);
3652                 if (log)
3653                     log->Printf ("Process::%s switching architecture to %s based on info the platform retrieved for pid %" PRIu64, __FUNCTION__, process_arch.GetTriple().getTriple().c_str (), GetID ());
3654             }
3655         }
3656     }
3657 
3658     // We have completed the attach, now it is time to find the dynamic loader
3659     // plug-in
3660     DynamicLoader *dyld = GetDynamicLoader ();
3661     if (dyld)
3662     {
3663         dyld->DidAttach();
3664         if (log)
3665         {
3666             ModuleSP exe_module_sp = GetTarget().GetExecutableModule ();
3667             log->Printf ("Process::%s after DynamicLoader::DidAttach(), target executable is %s (using %s plugin)",
3668                          __FUNCTION__,
3669                          exe_module_sp ? exe_module_sp->GetFileSpec().GetPath().c_str () : "<none>",
3670                          dyld->GetPluginName().AsCString ("<unnamed>"));
3671         }
3672     }
3673 
3674     GetJITLoaders().DidAttach();
3675 
3676     SystemRuntime *system_runtime = GetSystemRuntime ();
3677     if (system_runtime)
3678     {
3679         system_runtime->DidAttach();
3680         if (log)
3681         {
3682             ModuleSP exe_module_sp = GetTarget().GetExecutableModule ();
3683             log->Printf ("Process::%s after SystemRuntime::DidAttach(), target executable is %s (using %s plugin)",
3684                          __FUNCTION__,
3685                          exe_module_sp ? exe_module_sp->GetFileSpec().GetPath().c_str () : "<none>",
3686                          system_runtime->GetPluginName().AsCString("<unnamed>"));
3687         }
3688     }
3689 
3690     m_os_ap.reset (OperatingSystem::FindPlugin (this, NULL));
3691     // Figure out which one is the executable, and set that in our target:
3692     const ModuleList &target_modules = GetTarget().GetImages();
3693     Mutex::Locker modules_locker(target_modules.GetMutex());
3694     size_t num_modules = target_modules.GetSize();
3695     ModuleSP new_executable_module_sp;
3696 
3697     for (size_t i = 0; i < num_modules; i++)
3698     {
3699         ModuleSP module_sp (target_modules.GetModuleAtIndexUnlocked (i));
3700         if (module_sp && module_sp->IsExecutable())
3701         {
3702             if (GetTarget().GetExecutableModulePointer() != module_sp.get())
3703                 new_executable_module_sp = module_sp;
3704             break;
3705         }
3706     }
3707     if (new_executable_module_sp)
3708     {
3709         GetTarget().SetExecutableModule (new_executable_module_sp, false);
3710         if (log)
3711         {
3712             ModuleSP exe_module_sp = GetTarget().GetExecutableModule ();
3713             log->Printf ("Process::%s after looping through modules, target executable is %s",
3714                          __FUNCTION__,
3715                          exe_module_sp ? exe_module_sp->GetFileSpec().GetPath().c_str () : "<none>");
3716         }
3717     }
3718 
3719     m_stop_info_override_callback = process_arch.GetStopInfoOverrideCallback();
3720 }
3721 
3722 Error
3723 Process::ConnectRemote (Stream *strm, const char *remote_url)
3724 {
3725     m_abi_sp.reset();
3726     m_process_input_reader.reset();
3727 
3728     // Find the process and its architecture.  Make sure it matches the architecture
3729     // of the current Target, and if not adjust it.
3730 
3731     Error error (DoConnectRemote (strm, remote_url));
3732     if (error.Success())
3733     {
3734         if (GetID() != LLDB_INVALID_PROCESS_ID)
3735         {
3736             EventSP event_sp;
3737             StateType state = WaitForProcessStopPrivate(NULL, event_sp);
3738 
3739             if (state == eStateStopped || state == eStateCrashed)
3740             {
3741                 // If we attached and actually have a process on the other end, then
3742                 // this ended up being the equivalent of an attach.
3743                 CompleteAttach ();
3744 
3745                 // This delays passing the stopped event to listeners till
3746                 // CompleteAttach gets a chance to complete...
3747                 HandlePrivateEvent (event_sp);
3748 
3749             }
3750         }
3751 
3752         if (PrivateStateThreadIsValid ())
3753             ResumePrivateStateThread ();
3754         else
3755             StartPrivateStateThread ();
3756     }
3757     return error;
3758 }
3759 
3760 
3761 Error
3762 Process::PrivateResume ()
3763 {
3764     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS|LIBLLDB_LOG_STEP));
3765     if (log)
3766         log->Printf("Process::PrivateResume() m_stop_id = %u, public state: %s private state: %s",
3767                     m_mod_id.GetStopID(),
3768                     StateAsCString(m_public_state.GetValue()),
3769                     StateAsCString(m_private_state.GetValue()));
3770 
3771     Error error (WillResume());
3772     // Tell the process it is about to resume before the thread list
3773     if (error.Success())
3774     {
3775         // Now let the thread list know we are about to resume so it
3776         // can let all of our threads know that they are about to be
3777         // resumed. Threads will each be called with
3778         // Thread::WillResume(StateType) where StateType contains the state
3779         // that they are supposed to have when the process is resumed
3780         // (suspended/running/stepping). Threads should also check
3781         // their resume signal in lldb::Thread::GetResumeSignal()
3782         // to see if they are supposed to start back up with a signal.
3783         if (m_thread_list.WillResume())
3784         {
3785             // Last thing, do the PreResumeActions.
3786             if (!RunPreResumeActions())
3787             {
3788                 error.SetErrorStringWithFormat ("Process::PrivateResume PreResumeActions failed, not resuming.");
3789             }
3790             else
3791             {
3792                 m_mod_id.BumpResumeID();
3793                 error = DoResume();
3794                 if (error.Success())
3795                 {
3796                     DidResume();
3797                     m_thread_list.DidResume();
3798                     if (log)
3799                         log->Printf ("Process thinks the process has resumed.");
3800                 }
3801             }
3802         }
3803         else
3804         {
3805             // Somebody wanted to run without running (e.g. we were faking a step from one frame of a set of inlined
3806             // frames that share the same PC to another.)  So generate a continue & a stopped event,
3807             // and let the world handle them.
3808             if (log)
3809                 log->Printf ("Process::PrivateResume() asked to simulate a start & stop.");
3810 
3811             SetPrivateState(eStateRunning);
3812             SetPrivateState(eStateStopped);
3813         }
3814     }
3815     else if (log)
3816         log->Printf ("Process::PrivateResume() got an error \"%s\".", error.AsCString("<unknown error>"));
3817     return error;
3818 }
3819 
3820 Error
3821 Process::Halt (bool clear_thread_plans)
3822 {
3823     // Don't clear the m_clear_thread_plans_on_stop, only set it to true if
3824     // in case it was already set and some thread plan logic calls halt on its
3825     // own.
3826     m_clear_thread_plans_on_stop |= clear_thread_plans;
3827 
3828     // First make sure we aren't in the middle of handling an event, or we might restart.  This is pretty weak, since
3829     // we could just straightaway get another event.  It just narrows the window...
3830     m_currently_handling_event.WaitForValueEqualTo(false);
3831 
3832 
3833     // Pause our private state thread so we can ensure no one else eats
3834     // the stop event out from under us.
3835     Listener halt_listener ("lldb.process.halt_listener");
3836     HijackPrivateProcessEvents(&halt_listener);
3837 
3838     EventSP event_sp;
3839     Error error (WillHalt());
3840 
3841     bool restored_process_events = false;
3842     if (error.Success())
3843     {
3844 
3845         bool caused_stop = false;
3846 
3847         // Ask the process subclass to actually halt our process
3848         error = DoHalt(caused_stop);
3849         if (error.Success())
3850         {
3851             if (m_public_state.GetValue() == eStateAttaching)
3852             {
3853                 // Don't hijack and eat the eStateExited as the code that was doing
3854                 // the attach will be waiting for this event...
3855                 RestorePrivateProcessEvents();
3856                 restored_process_events = true;
3857                 SetExitStatus(SIGKILL, "Cancelled async attach.");
3858                 Destroy (false);
3859             }
3860             else
3861             {
3862                 // If "caused_stop" is true, then DoHalt stopped the process. If
3863                 // "caused_stop" is false, the process was already stopped.
3864                 // If the DoHalt caused the process to stop, then we want to catch
3865                 // this event and set the interrupted bool to true before we pass
3866                 // this along so clients know that the process was interrupted by
3867                 // a halt command.
3868                 if (caused_stop)
3869                 {
3870                     // Wait for 1 second for the process to stop.
3871                     TimeValue timeout_time;
3872                     timeout_time = TimeValue::Now();
3873                     timeout_time.OffsetWithSeconds(10);
3874                     bool got_event = halt_listener.WaitForEvent (&timeout_time, event_sp);
3875                     StateType state = ProcessEventData::GetStateFromEvent(event_sp.get());
3876 
3877                     if (!got_event || state == eStateInvalid)
3878                     {
3879                         // We timeout out and didn't get a stop event...
3880                         error.SetErrorStringWithFormat ("Halt timed out. State = %s", StateAsCString(GetState()));
3881                     }
3882                     else
3883                     {
3884                         if (StateIsStoppedState (state, false))
3885                         {
3886                             // We caused the process to interrupt itself, so mark this
3887                             // as such in the stop event so clients can tell an interrupted
3888                             // process from a natural stop
3889                             ProcessEventData::SetInterruptedInEvent (event_sp.get(), true);
3890                         }
3891                         else
3892                         {
3893                             Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3894                             if (log)
3895                                 log->Printf("Process::Halt() failed to stop, state is: %s", StateAsCString(state));
3896                             error.SetErrorString ("Did not get stopped event after halt.");
3897                         }
3898                     }
3899                 }
3900                 DidHalt();
3901             }
3902         }
3903     }
3904     // Resume our private state thread before we post the event (if any)
3905     if (!restored_process_events)
3906         RestorePrivateProcessEvents();
3907 
3908     // Post any event we might have consumed. If all goes well, we will have
3909     // stopped the process, intercepted the event and set the interrupted
3910     // bool in the event.  Post it to the private event queue and that will end up
3911     // correctly setting the state.
3912     if (event_sp)
3913         m_private_state_broadcaster.BroadcastEvent(event_sp);
3914 
3915     return error;
3916 }
3917 
3918 Error
3919 Process::HaltForDestroyOrDetach(lldb::EventSP &exit_event_sp)
3920 {
3921     Error error;
3922     if (m_public_state.GetValue() == eStateRunning)
3923     {
3924         Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3925         if (log)
3926             log->Printf("Process::%s() About to halt.", __FUNCTION__);
3927         error = Halt();
3928         if (error.Success())
3929         {
3930             // Consume the halt event.
3931             TimeValue timeout (TimeValue::Now());
3932             timeout.OffsetWithSeconds(1);
3933             StateType state = WaitForProcessToStop (&timeout, &exit_event_sp);
3934 
3935             // If the process exited while we were waiting for it to stop, put the exited event into
3936             // the shared pointer passed in and return.  Our caller doesn't need to do anything else, since
3937             // they don't have a process anymore...
3938 
3939             if (state == eStateExited || m_private_state.GetValue() == eStateExited)
3940             {
3941                 if (log)
3942                     log->Printf("Process::HaltForDestroyOrDetach() Process exited while waiting to Halt.");
3943                 return error;
3944             }
3945             else
3946                 exit_event_sp.reset(); // It is ok to consume any non-exit stop events
3947 
3948             if (state != eStateStopped)
3949             {
3950                 if (log)
3951                     log->Printf("Process::HaltForDestroyOrDetach() Halt failed to stop, state is: %s", StateAsCString(state));
3952                 // If we really couldn't stop the process then we should just error out here, but if the
3953                 // lower levels just bobbled sending the event and we really are stopped, then continue on.
3954                 StateType private_state = m_private_state.GetValue();
3955                 if (private_state != eStateStopped)
3956                 {
3957                     return error;
3958                 }
3959             }
3960         }
3961         else
3962         {
3963             if (log)
3964                 log->Printf("Process::HaltForDestroyOrDetach() Halt got error: %s", error.AsCString());
3965         }
3966     }
3967     return error;
3968 }
3969 
3970 Error
3971 Process::Detach (bool keep_stopped)
3972 {
3973     EventSP exit_event_sp;
3974     Error error;
3975     m_destroy_in_process = true;
3976 
3977     error = WillDetach();
3978 
3979     if (error.Success())
3980     {
3981         if (DetachRequiresHalt())
3982         {
3983             error = HaltForDestroyOrDetach (exit_event_sp);
3984             if (!error.Success())
3985             {
3986                 m_destroy_in_process = false;
3987                 return error;
3988             }
3989             else if (exit_event_sp)
3990             {
3991                 // We shouldn't need to do anything else here.  There's no process left to detach from...
3992                 StopPrivateStateThread();
3993                 m_destroy_in_process = false;
3994                 return error;
3995             }
3996         }
3997 
3998         m_thread_list.DiscardThreadPlans();
3999         DisableAllBreakpointSites();
4000 
4001         error = DoDetach(keep_stopped);
4002         if (error.Success())
4003         {
4004             DidDetach();
4005             StopPrivateStateThread();
4006         }
4007         else
4008         {
4009             return error;
4010         }
4011     }
4012     m_destroy_in_process = false;
4013 
4014     // If we exited when we were waiting for a process to stop, then
4015     // forward the event here so we don't lose the event
4016     if (exit_event_sp)
4017     {
4018         // Directly broadcast our exited event because we shut down our
4019         // private state thread above
4020         BroadcastEvent(exit_event_sp);
4021     }
4022 
4023     // If we have been interrupted (to kill us) in the middle of running, we may not end up propagating
4024     // the last events through the event system, in which case we might strand the write lock.  Unlock
4025     // it here so when we do to tear down the process we don't get an error destroying the lock.
4026 
4027     m_public_run_lock.SetStopped();
4028     return error;
4029 }
4030 
4031 Error
4032 Process::Destroy (bool force_kill)
4033 {
4034 
4035     // Tell ourselves we are in the process of destroying the process, so that we don't do any unnecessary work
4036     // that might hinder the destruction.  Remember to set this back to false when we are done.  That way if the attempt
4037     // failed and the process stays around for some reason it won't be in a confused state.
4038 
4039     if (force_kill)
4040         m_should_detach = false;
4041 
4042     if (GetShouldDetach())
4043     {
4044         // FIXME: This will have to be a process setting:
4045         bool keep_stopped = false;
4046         Detach(keep_stopped);
4047     }
4048 
4049     m_destroy_in_process = true;
4050 
4051     Error error (WillDestroy());
4052     if (error.Success())
4053     {
4054         EventSP exit_event_sp;
4055         if (DestroyRequiresHalt())
4056         {
4057             error = HaltForDestroyOrDetach(exit_event_sp);
4058         }
4059 
4060         if (m_public_state.GetValue() != eStateRunning)
4061         {
4062             // Ditch all thread plans, and remove all our breakpoints: in case we have to restart the target to
4063             // kill it, we don't want it hitting a breakpoint...
4064             // Only do this if we've stopped, however, since if we didn't manage to halt it above, then
4065             // we're not going to have much luck doing this now.
4066             m_thread_list.DiscardThreadPlans();
4067             DisableAllBreakpointSites();
4068         }
4069 
4070         error = DoDestroy();
4071         if (error.Success())
4072         {
4073             DidDestroy();
4074             StopPrivateStateThread();
4075         }
4076         m_stdio_communication.Disconnect();
4077         m_stdio_communication.StopReadThread();
4078         m_stdin_forward = false;
4079 
4080         if (m_process_input_reader)
4081         {
4082             m_process_input_reader->SetIsDone(true);
4083             m_process_input_reader->Cancel();
4084             m_process_input_reader.reset();
4085         }
4086 
4087         // If we exited when we were waiting for a process to stop, then
4088         // forward the event here so we don't lose the event
4089         if (exit_event_sp)
4090         {
4091             // Directly broadcast our exited event because we shut down our
4092             // private state thread above
4093             BroadcastEvent(exit_event_sp);
4094         }
4095 
4096         // If we have been interrupted (to kill us) in the middle of running, we may not end up propagating
4097         // the last events through the event system, in which case we might strand the write lock.  Unlock
4098         // it here so when we do to tear down the process we don't get an error destroying the lock.
4099         m_public_run_lock.SetStopped();
4100     }
4101 
4102     m_destroy_in_process = false;
4103 
4104     return error;
4105 }
4106 
4107 Error
4108 Process::Signal (int signal)
4109 {
4110     Error error (WillSignal());
4111     if (error.Success())
4112     {
4113         error = DoSignal(signal);
4114         if (error.Success())
4115             DidSignal();
4116     }
4117     return error;
4118 }
4119 
4120 void
4121 Process::SetUnixSignals(UnixSignalsSP &&signals_sp)
4122 {
4123     assert (signals_sp && "null signals_sp");
4124     m_unix_signals_sp = signals_sp;
4125 }
4126 
4127 const lldb::UnixSignalsSP &
4128 Process::GetUnixSignals ()
4129 {
4130     assert (m_unix_signals_sp && "null m_unix_signals_sp");
4131     return m_unix_signals_sp;
4132 }
4133 
4134 lldb::ByteOrder
4135 Process::GetByteOrder () const
4136 {
4137     return GetTarget().GetArchitecture().GetByteOrder();
4138 }
4139 
4140 uint32_t
4141 Process::GetAddressByteSize () const
4142 {
4143     return GetTarget().GetArchitecture().GetAddressByteSize();
4144 }
4145 
4146 
4147 bool
4148 Process::ShouldBroadcastEvent (Event *event_ptr)
4149 {
4150     const StateType state = Process::ProcessEventData::GetStateFromEvent (event_ptr);
4151     bool return_value = true;
4152     Log *log(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_EVENTS | LIBLLDB_LOG_PROCESS));
4153 
4154     switch (state)
4155     {
4156         case eStateDetached:
4157         case eStateExited:
4158         case eStateUnloaded:
4159             m_stdio_communication.SynchronizeWithReadThread();
4160             m_stdio_communication.Disconnect();
4161             m_stdio_communication.StopReadThread();
4162             m_stdin_forward = false;
4163 
4164             // fall-through
4165         case eStateConnected:
4166         case eStateAttaching:
4167         case eStateLaunching:
4168             // These events indicate changes in the state of the debugging session, always report them.
4169             return_value = true;
4170             break;
4171         case eStateInvalid:
4172             // We stopped for no apparent reason, don't report it.
4173             return_value = false;
4174             break;
4175         case eStateRunning:
4176         case eStateStepping:
4177             // If we've started the target running, we handle the cases where we
4178             // are already running and where there is a transition from stopped to
4179             // running differently.
4180             // running -> running: Automatically suppress extra running events
4181             // stopped -> running: Report except when there is one or more no votes
4182             //     and no yes votes.
4183             SynchronouslyNotifyStateChanged (state);
4184             if (m_force_next_event_delivery)
4185                 return_value = true;
4186             else
4187             {
4188                 switch (m_last_broadcast_state)
4189                 {
4190                     case eStateRunning:
4191                     case eStateStepping:
4192                         // We always suppress multiple runnings with no PUBLIC stop in between.
4193                         return_value = false;
4194                         break;
4195                     default:
4196                         // TODO: make this work correctly. For now always report
4197                         // run if we aren't running so we don't miss any running
4198                         // events. If I run the lldb/test/thread/a.out file and
4199                         // break at main.cpp:58, run and hit the breakpoints on
4200                         // multiple threads, then somehow during the stepping over
4201                         // of all breakpoints no run gets reported.
4202 
4203                         // This is a transition from stop to run.
4204                         switch (m_thread_list.ShouldReportRun (event_ptr))
4205                         {
4206                             case eVoteYes:
4207                             case eVoteNoOpinion:
4208                                 return_value = true;
4209                                 break;
4210                             case eVoteNo:
4211                                 return_value = false;
4212                                 break;
4213                         }
4214                         break;
4215                 }
4216             }
4217             break;
4218         case eStateStopped:
4219         case eStateCrashed:
4220         case eStateSuspended:
4221         {
4222             // We've stopped.  First see if we're going to restart the target.
4223             // If we are going to stop, then we always broadcast the event.
4224             // If we aren't going to stop, let the thread plans decide if we're going to report this event.
4225             // If no thread has an opinion, we don't report it.
4226 
4227             m_stdio_communication.SynchronizeWithReadThread();
4228             RefreshStateAfterStop ();
4229             if (ProcessEventData::GetInterruptedFromEvent (event_ptr))
4230             {
4231                 if (log)
4232                     log->Printf ("Process::ShouldBroadcastEvent (%p) stopped due to an interrupt, state: %s",
4233                                  static_cast<void*>(event_ptr),
4234                                  StateAsCString(state));
4235                 // Even though we know we are going to stop, we should let the threads have a look at the stop,
4236                 // so they can properly set their state.
4237                 m_thread_list.ShouldStop (event_ptr);
4238                 return_value = true;
4239             }
4240             else
4241             {
4242                 bool was_restarted = ProcessEventData::GetRestartedFromEvent (event_ptr);
4243                 bool should_resume = false;
4244 
4245                 // It makes no sense to ask "ShouldStop" if we've already been restarted...
4246                 // Asking the thread list is also not likely to go well, since we are running again.
4247                 // So in that case just report the event.
4248 
4249                 if (!was_restarted)
4250                     should_resume = m_thread_list.ShouldStop (event_ptr) == false;
4251 
4252                 if (was_restarted || should_resume || m_resume_requested)
4253                 {
4254                     Vote stop_vote = m_thread_list.ShouldReportStop (event_ptr);
4255                     if (log)
4256                         log->Printf ("Process::ShouldBroadcastEvent: should_stop: %i state: %s was_restarted: %i stop_vote: %d.",
4257                                      should_resume, StateAsCString(state),
4258                                      was_restarted, stop_vote);
4259 
4260                     switch (stop_vote)
4261                     {
4262                         case eVoteYes:
4263                             return_value = true;
4264                             break;
4265                         case eVoteNoOpinion:
4266                         case eVoteNo:
4267                             return_value = false;
4268                             break;
4269                     }
4270 
4271                     if (!was_restarted)
4272                     {
4273                         if (log)
4274                             log->Printf ("Process::ShouldBroadcastEvent (%p) Restarting process from state: %s",
4275                                          static_cast<void*>(event_ptr),
4276                                          StateAsCString(state));
4277                         ProcessEventData::SetRestartedInEvent(event_ptr, true);
4278                         PrivateResume ();
4279                     }
4280 
4281                 }
4282                 else
4283                 {
4284                     return_value = true;
4285                     SynchronouslyNotifyStateChanged (state);
4286                 }
4287             }
4288         }
4289         break;
4290     }
4291 
4292     // Forcing the next event delivery is a one shot deal.  So reset it here.
4293     m_force_next_event_delivery = false;
4294 
4295     // We do some coalescing of events (for instance two consecutive running events get coalesced.)
4296     // But we only coalesce against events we actually broadcast.  So we use m_last_broadcast_state
4297     // to track that.  NB - you can't use "m_public_state.GetValue()" for that purpose, as was originally done,
4298     // because the PublicState reflects the last event pulled off the queue, and there may be several
4299     // events stacked up on the queue unserviced.  So the PublicState may not reflect the last broadcasted event
4300     // yet.  m_last_broadcast_state gets updated here.
4301 
4302     if (return_value)
4303         m_last_broadcast_state = state;
4304 
4305     if (log)
4306         log->Printf ("Process::ShouldBroadcastEvent (%p) => new state: %s, last broadcast state: %s - %s",
4307                      static_cast<void*>(event_ptr), StateAsCString(state),
4308                      StateAsCString(m_last_broadcast_state),
4309                      return_value ? "YES" : "NO");
4310     return return_value;
4311 }
4312 
4313 
4314 bool
4315 Process::StartPrivateStateThread (bool is_secondary_thread)
4316 {
4317     Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_EVENTS));
4318 
4319     bool already_running = PrivateStateThreadIsValid ();
4320     if (log)
4321         log->Printf ("Process::%s()%s ", __FUNCTION__, already_running ? " already running" : " starting private state thread");
4322 
4323     if (!is_secondary_thread && already_running)
4324         return true;
4325 
4326     // Create a thread that watches our internal state and controls which
4327     // events make it to clients (into the DCProcess event queue).
4328     char thread_name[1024];
4329 
4330     if (HostInfo::GetMaxThreadNameLength() <= 30)
4331     {
4332         // On platforms with abbreviated thread name lengths, choose thread names that fit within the limit.
4333         if (already_running)
4334             snprintf(thread_name, sizeof(thread_name), "intern-state-OV");
4335         else
4336             snprintf(thread_name, sizeof(thread_name), "intern-state");
4337     }
4338     else
4339     {
4340         if (already_running)
4341             snprintf(thread_name, sizeof(thread_name), "<lldb.process.internal-state-override(pid=%" PRIu64 ")>", GetID());
4342         else
4343             snprintf(thread_name, sizeof(thread_name), "<lldb.process.internal-state(pid=%" PRIu64 ")>", GetID());
4344     }
4345 
4346     // Create the private state thread, and start it running.
4347     PrivateStateThreadArgs args = {this, is_secondary_thread};
4348     m_private_state_thread = ThreadLauncher::LaunchThread(thread_name, Process::PrivateStateThread, (void *) &args, NULL);
4349     if (m_private_state_thread.IsJoinable())
4350     {
4351         ResumePrivateStateThread();
4352         return true;
4353     }
4354     else
4355         return false;
4356 }
4357 
4358 void
4359 Process::PausePrivateStateThread ()
4360 {
4361     ControlPrivateStateThread (eBroadcastInternalStateControlPause);
4362 }
4363 
4364 void
4365 Process::ResumePrivateStateThread ()
4366 {
4367     ControlPrivateStateThread (eBroadcastInternalStateControlResume);
4368 }
4369 
4370 void
4371 Process::StopPrivateStateThread ()
4372 {
4373     if (PrivateStateThreadIsValid ())
4374         ControlPrivateStateThread (eBroadcastInternalStateControlStop);
4375     else
4376     {
4377         Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
4378         if (log)
4379             log->Printf ("Went to stop the private state thread, but it was already invalid.");
4380     }
4381 }
4382 
4383 void
4384 Process::ControlPrivateStateThread (uint32_t signal)
4385 {
4386     Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
4387 
4388     assert (signal == eBroadcastInternalStateControlStop ||
4389             signal == eBroadcastInternalStateControlPause ||
4390             signal == eBroadcastInternalStateControlResume);
4391 
4392     if (log)
4393         log->Printf ("Process::%s (signal = %d)", __FUNCTION__, signal);
4394 
4395     // Signal the private state thread. First we should copy this is case the
4396     // thread starts exiting since the private state thread will NULL this out
4397     // when it exits
4398     HostThread private_state_thread(m_private_state_thread);
4399     if (private_state_thread.IsJoinable())
4400     {
4401         TimeValue timeout_time;
4402         bool timed_out;
4403 
4404         m_private_state_control_broadcaster.BroadcastEvent (signal, NULL);
4405 
4406         timeout_time = TimeValue::Now();
4407         timeout_time.OffsetWithSeconds(2);
4408         if (log)
4409             log->Printf ("Sending control event of type: %d.", signal);
4410         m_private_state_control_wait.WaitForValueEqualTo (true, &timeout_time, &timed_out);
4411         m_private_state_control_wait.SetValue (false, eBroadcastNever);
4412 
4413         if (signal == eBroadcastInternalStateControlStop)
4414         {
4415             if (timed_out)
4416             {
4417                 Error error = private_state_thread.Cancel();
4418                 if (log)
4419                     log->Printf ("Timed out responding to the control event, cancel got error: \"%s\".", error.AsCString());
4420             }
4421             else
4422             {
4423                 if (log)
4424                     log->Printf ("The control event killed the private state thread without having to cancel.");
4425             }
4426 
4427             thread_result_t result = NULL;
4428             private_state_thread.Join(&result);
4429             m_private_state_thread.Reset();
4430         }
4431     }
4432     else
4433     {
4434         if (log)
4435             log->Printf ("Private state thread already dead, no need to signal it to stop.");
4436     }
4437 }
4438 
4439 void
4440 Process::SendAsyncInterrupt ()
4441 {
4442     if (PrivateStateThreadIsValid())
4443         m_private_state_broadcaster.BroadcastEvent (Process::eBroadcastBitInterrupt, NULL);
4444     else
4445         BroadcastEvent (Process::eBroadcastBitInterrupt, NULL);
4446 }
4447 
4448 void
4449 Process::HandlePrivateEvent (EventSP &event_sp)
4450 {
4451     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4452     m_resume_requested = false;
4453 
4454     m_currently_handling_event.SetValue(true, eBroadcastNever);
4455 
4456     const StateType new_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
4457 
4458     // First check to see if anybody wants a shot at this event:
4459     if (m_next_event_action_ap.get() != NULL)
4460     {
4461         NextEventAction::EventActionResult action_result = m_next_event_action_ap->PerformAction(event_sp);
4462         if (log)
4463             log->Printf ("Ran next event action, result was %d.", action_result);
4464 
4465         switch (action_result)
4466         {
4467             case NextEventAction::eEventActionSuccess:
4468                 SetNextEventAction(NULL);
4469                 break;
4470 
4471             case NextEventAction::eEventActionRetry:
4472                 break;
4473 
4474             case NextEventAction::eEventActionExit:
4475                 // Handle Exiting Here.  If we already got an exited event,
4476                 // we should just propagate it.  Otherwise, swallow this event,
4477                 // and set our state to exit so the next event will kill us.
4478                 if (new_state != eStateExited)
4479                 {
4480                     // FIXME: should cons up an exited event, and discard this one.
4481                     SetExitStatus(0, m_next_event_action_ap->GetExitString());
4482                     m_currently_handling_event.SetValue(false, eBroadcastAlways);
4483                     SetNextEventAction(NULL);
4484                     return;
4485                 }
4486                 SetNextEventAction(NULL);
4487                 break;
4488         }
4489     }
4490 
4491     // See if we should broadcast this state to external clients?
4492     const bool should_broadcast = ShouldBroadcastEvent (event_sp.get());
4493 
4494     if (should_broadcast)
4495     {
4496         const bool is_hijacked = IsHijackedForEvent(eBroadcastBitStateChanged);
4497         if (log)
4498         {
4499             log->Printf ("Process::%s (pid = %" PRIu64 ") broadcasting new state %s (old state %s) to %s",
4500                          __FUNCTION__,
4501                          GetID(),
4502                          StateAsCString(new_state),
4503                          StateAsCString (GetState ()),
4504                          is_hijacked ? "hijacked" : "public");
4505         }
4506         Process::ProcessEventData::SetUpdateStateOnRemoval(event_sp.get());
4507         if (StateIsRunningState (new_state))
4508         {
4509             // Only push the input handler if we aren't fowarding events,
4510             // as this means the curses GUI is in use...
4511             // Or don't push it if we are launching since it will come up stopped.
4512             if (!GetTarget().GetDebugger().IsForwardingEvents() && new_state != eStateLaunching &&
4513                 new_state != eStateAttaching)
4514             {
4515                 PushProcessIOHandler ();
4516                 m_iohandler_sync.SetValue(m_iohandler_sync.GetValue()+1, eBroadcastAlways);
4517                 if (log)
4518                     log->Printf("Process::%s updated m_iohandler_sync to %d", __FUNCTION__, m_iohandler_sync.GetValue());
4519             }
4520         }
4521         else if (StateIsStoppedState(new_state, false))
4522         {
4523             if (!Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
4524             {
4525                 // If the lldb_private::Debugger is handling the events, we don't
4526                 // want to pop the process IOHandler here, we want to do it when
4527                 // we receive the stopped event so we can carefully control when
4528                 // the process IOHandler is popped because when we stop we want to
4529                 // display some text stating how and why we stopped, then maybe some
4530                 // process/thread/frame info, and then we want the "(lldb) " prompt
4531                 // to show up. If we pop the process IOHandler here, then we will
4532                 // cause the command interpreter to become the top IOHandler after
4533                 // the process pops off and it will update its prompt right away...
4534                 // See the Debugger.cpp file where it calls the function as
4535                 // "process_sp->PopProcessIOHandler()" to see where I am talking about.
4536                 // Otherwise we end up getting overlapping "(lldb) " prompts and
4537                 // garbled output.
4538                 //
4539                 // If we aren't handling the events in the debugger (which is indicated
4540                 // by "m_target.GetDebugger().IsHandlingEvents()" returning false) or we
4541                 // are hijacked, then we always pop the process IO handler manually.
4542                 // Hijacking happens when the internal process state thread is running
4543                 // thread plans, or when commands want to run in synchronous mode
4544                 // and they call "process->WaitForProcessToStop()". An example of something
4545                 // that will hijack the events is a simple expression:
4546                 //
4547                 //  (lldb) expr (int)puts("hello")
4548                 //
4549                 // This will cause the internal process state thread to resume and halt
4550                 // the process (and _it_ will hijack the eBroadcastBitStateChanged
4551                 // events) and we do need the IO handler to be pushed and popped
4552                 // correctly.
4553 
4554                 if (is_hijacked || GetTarget().GetDebugger().IsHandlingEvents() == false)
4555                     PopProcessIOHandler ();
4556             }
4557         }
4558 
4559         BroadcastEvent (event_sp);
4560     }
4561     else
4562     {
4563         if (log)
4564         {
4565             log->Printf ("Process::%s (pid = %" PRIu64 ") suppressing state %s (old state %s): should_broadcast == false",
4566                          __FUNCTION__,
4567                          GetID(),
4568                          StateAsCString(new_state),
4569                          StateAsCString (GetState ()));
4570         }
4571     }
4572     m_currently_handling_event.SetValue(false, eBroadcastAlways);
4573 }
4574 
4575 thread_result_t
4576 Process::PrivateStateThread (void *arg)
4577 {
4578     PrivateStateThreadArgs *real_args = static_cast<PrivateStateThreadArgs *> (arg);
4579     thread_result_t result = real_args->process->RunPrivateStateThread(real_args->is_secondary_thread);
4580     return result;
4581 }
4582 
4583 thread_result_t
4584 Process::RunPrivateStateThread (bool is_secondary_thread)
4585 {
4586     bool control_only = true;
4587     m_private_state_control_wait.SetValue (false, eBroadcastNever);
4588 
4589     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4590     if (log)
4591         log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") thread starting...",
4592                      __FUNCTION__, static_cast<void*>(this), GetID());
4593 
4594     bool exit_now = false;
4595     while (!exit_now)
4596     {
4597         EventSP event_sp;
4598         WaitForEventsPrivate (NULL, event_sp, control_only);
4599         if (event_sp->BroadcasterIs(&m_private_state_control_broadcaster))
4600         {
4601             if (log)
4602                 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") got a control event: %d",
4603                              __FUNCTION__, static_cast<void*>(this), GetID(),
4604                              event_sp->GetType());
4605 
4606             switch (event_sp->GetType())
4607             {
4608             case eBroadcastInternalStateControlStop:
4609                 exit_now = true;
4610                 break;      // doing any internal state management below
4611 
4612             case eBroadcastInternalStateControlPause:
4613                 control_only = true;
4614                 break;
4615 
4616             case eBroadcastInternalStateControlResume:
4617                 control_only = false;
4618                 break;
4619             }
4620 
4621             m_private_state_control_wait.SetValue (true, eBroadcastAlways);
4622             continue;
4623         }
4624         else if (event_sp->GetType() == eBroadcastBitInterrupt)
4625         {
4626             if (m_public_state.GetValue() == eStateAttaching)
4627             {
4628                 if (log)
4629                     log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") woke up with an interrupt while attaching - forwarding interrupt.",
4630                                  __FUNCTION__, static_cast<void*>(this),
4631                                  GetID());
4632                 BroadcastEvent (eBroadcastBitInterrupt, NULL);
4633             }
4634             else
4635             {
4636                 if (log)
4637                     log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") woke up with an interrupt - Halting.",
4638                                  __FUNCTION__, static_cast<void*>(this),
4639                                  GetID());
4640                 Halt();
4641             }
4642             continue;
4643         }
4644 
4645         const StateType internal_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
4646 
4647         if (internal_state != eStateInvalid)
4648         {
4649             if (m_clear_thread_plans_on_stop &&
4650                 StateIsStoppedState(internal_state, true))
4651             {
4652                 m_clear_thread_plans_on_stop = false;
4653                 m_thread_list.DiscardThreadPlans();
4654             }
4655             HandlePrivateEvent (event_sp);
4656         }
4657 
4658         if (internal_state == eStateInvalid ||
4659             internal_state == eStateExited  ||
4660             internal_state == eStateDetached )
4661         {
4662             if (log)
4663                 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") about to exit with internal state %s...",
4664                              __FUNCTION__, static_cast<void*>(this), GetID(),
4665                              StateAsCString(internal_state));
4666 
4667             break;
4668         }
4669     }
4670 
4671     // Verify log is still enabled before attempting to write to it...
4672     if (log)
4673         log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") thread exiting...",
4674                      __FUNCTION__, static_cast<void*>(this), GetID());
4675 
4676     // If we are a secondary thread, then the primary thread we are working for will have already
4677     // acquired the public_run_lock, and isn't done with what it was doing yet, so don't
4678     // try to change it on the way out.
4679     if (!is_secondary_thread)
4680         m_public_run_lock.SetStopped();
4681     m_private_state_control_wait.SetValue (true, eBroadcastAlways);
4682     m_private_state_thread.Reset();
4683     return NULL;
4684 }
4685 
4686 //------------------------------------------------------------------
4687 // Process Event Data
4688 //------------------------------------------------------------------
4689 
4690 Process::ProcessEventData::ProcessEventData () :
4691     EventData (),
4692     m_process_wp (),
4693     m_state (eStateInvalid),
4694     m_restarted (false),
4695     m_update_state (0),
4696     m_interrupted (false)
4697 {
4698 }
4699 
4700 Process::ProcessEventData::ProcessEventData (const ProcessSP &process_sp, StateType state) :
4701     EventData (),
4702     m_process_wp (),
4703     m_state (state),
4704     m_restarted (false),
4705     m_update_state (0),
4706     m_interrupted (false)
4707 {
4708     if (process_sp)
4709         m_process_wp = process_sp;
4710 }
4711 
4712 Process::ProcessEventData::~ProcessEventData()
4713 {
4714 }
4715 
4716 const ConstString &
4717 Process::ProcessEventData::GetFlavorString ()
4718 {
4719     static ConstString g_flavor ("Process::ProcessEventData");
4720     return g_flavor;
4721 }
4722 
4723 const ConstString &
4724 Process::ProcessEventData::GetFlavor () const
4725 {
4726     return ProcessEventData::GetFlavorString ();
4727 }
4728 
4729 void
4730 Process::ProcessEventData::DoOnRemoval (Event *event_ptr)
4731 {
4732     ProcessSP process_sp(m_process_wp.lock());
4733 
4734     if (!process_sp)
4735         return;
4736 
4737     // This function gets called twice for each event, once when the event gets pulled
4738     // off of the private process event queue, and then any number of times, first when it gets pulled off of
4739     // the public event queue, then other times when we're pretending that this is where we stopped at the
4740     // end of expression evaluation.  m_update_state is used to distinguish these
4741     // three cases; it is 0 when we're just pulling it off for private handling,
4742     // and > 1 for expression evaluation, and we don't want to do the breakpoint command handling then.
4743     if (m_update_state != 1)
4744         return;
4745 
4746     process_sp->SetPublicState (m_state, Process::ProcessEventData::GetRestartedFromEvent(event_ptr));
4747 
4748     // If this is a halt event, even if the halt stopped with some reason other than a plain interrupt (e.g. we had
4749     // already stopped for a breakpoint when the halt request came through) don't do the StopInfo actions, as they may
4750     // end up restarting the process.
4751     if (m_interrupted)
4752         return;
4753 
4754     // If we're stopped and haven't restarted, then do the StopInfo actions here:
4755     if (m_state == eStateStopped && ! m_restarted)
4756     {
4757         // Let process subclasses know we are about to do a public stop and
4758         // do anything they might need to in order to speed up register and
4759         // memory accesses.
4760         process_sp->WillPublicStop();
4761 
4762         ThreadList &curr_thread_list = process_sp->GetThreadList();
4763         uint32_t num_threads = curr_thread_list.GetSize();
4764         uint32_t idx;
4765 
4766         // The actions might change one of the thread's stop_info's opinions about whether we should
4767         // stop the process, so we need to query that as we go.
4768 
4769         // One other complication here, is that we try to catch any case where the target has run (except for expressions)
4770         // and immediately exit, but if we get that wrong (which is possible) then the thread list might have changed, and
4771         // that would cause our iteration here to crash.  We could make a copy of the thread list, but we'd really like
4772         // to also know if it has changed at all, so we make up a vector of the thread ID's and check what we get back
4773         // against this list & bag out if anything differs.
4774         std::vector<uint32_t> thread_index_array(num_threads);
4775         for (idx = 0; idx < num_threads; ++idx)
4776             thread_index_array[idx] = curr_thread_list.GetThreadAtIndex(idx)->GetIndexID();
4777 
4778         // Use this to track whether we should continue from here.  We will only continue the target running if
4779         // no thread says we should stop.  Of course if some thread's PerformAction actually sets the target running,
4780         // then it doesn't matter what the other threads say...
4781 
4782         bool still_should_stop = false;
4783 
4784         // Sometimes - for instance if we have a bug in the stub we are talking to, we stop but no thread has a
4785         // valid stop reason.  In that case we should just stop, because we have no way of telling what the right
4786         // thing to do is, and it's better to let the user decide than continue behind their backs.
4787 
4788         bool does_anybody_have_an_opinion = false;
4789 
4790         for (idx = 0; idx < num_threads; ++idx)
4791         {
4792             curr_thread_list = process_sp->GetThreadList();
4793             if (curr_thread_list.GetSize() != num_threads)
4794             {
4795                 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STEP | LIBLLDB_LOG_PROCESS));
4796                 if (log)
4797                     log->Printf("Number of threads changed from %u to %u while processing event.", num_threads, curr_thread_list.GetSize());
4798                 break;
4799             }
4800 
4801             lldb::ThreadSP thread_sp = curr_thread_list.GetThreadAtIndex(idx);
4802 
4803             if (thread_sp->GetIndexID() != thread_index_array[idx])
4804             {
4805                 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STEP | LIBLLDB_LOG_PROCESS));
4806                 if (log)
4807                     log->Printf("The thread at position %u changed from %u to %u while processing event.",
4808                                 idx,
4809                                 thread_index_array[idx],
4810                                 thread_sp->GetIndexID());
4811                 break;
4812             }
4813 
4814             StopInfoSP stop_info_sp = thread_sp->GetStopInfo ();
4815             if (stop_info_sp && stop_info_sp->IsValid())
4816             {
4817                 does_anybody_have_an_opinion = true;
4818                 bool this_thread_wants_to_stop;
4819                 if (stop_info_sp->GetOverrideShouldStop())
4820                 {
4821                     this_thread_wants_to_stop = stop_info_sp->GetOverriddenShouldStopValue();
4822                 }
4823                 else
4824                 {
4825                     stop_info_sp->PerformAction(event_ptr);
4826                     // The stop action might restart the target.  If it does, then we want to mark that in the
4827                     // event so that whoever is receiving it will know to wait for the running event and reflect
4828                     // that state appropriately.
4829                     // We also need to stop processing actions, since they aren't expecting the target to be running.
4830 
4831                     // FIXME: we might have run.
4832                     if (stop_info_sp->HasTargetRunSinceMe())
4833                     {
4834                         SetRestarted (true);
4835                         break;
4836                     }
4837 
4838                     this_thread_wants_to_stop = stop_info_sp->ShouldStop(event_ptr);
4839                 }
4840 
4841                 if (still_should_stop == false)
4842                     still_should_stop = this_thread_wants_to_stop;
4843             }
4844         }
4845 
4846 
4847         if (!GetRestarted())
4848         {
4849             if (!still_should_stop && does_anybody_have_an_opinion)
4850             {
4851                 // We've been asked to continue, so do that here.
4852                 SetRestarted(true);
4853                 // Use the public resume method here, since this is just
4854                 // extending a public resume.
4855                 process_sp->PrivateResume();
4856             }
4857             else
4858             {
4859                 // If we didn't restart, run the Stop Hooks here:
4860                 // They might also restart the target, so watch for that.
4861                 process_sp->GetTarget().RunStopHooks();
4862                 if (process_sp->GetPrivateState() == eStateRunning)
4863                     SetRestarted(true);
4864             }
4865         }
4866     }
4867 }
4868 
4869 void
4870 Process::ProcessEventData::Dump (Stream *s) const
4871 {
4872     ProcessSP process_sp(m_process_wp.lock());
4873 
4874     if (process_sp)
4875         s->Printf(" process = %p (pid = %" PRIu64 "), ",
4876                   static_cast<void*>(process_sp.get()), process_sp->GetID());
4877     else
4878         s->PutCString(" process = NULL, ");
4879 
4880     s->Printf("state = %s", StateAsCString(GetState()));
4881 }
4882 
4883 const Process::ProcessEventData *
4884 Process::ProcessEventData::GetEventDataFromEvent (const Event *event_ptr)
4885 {
4886     if (event_ptr)
4887     {
4888         const EventData *event_data = event_ptr->GetData();
4889         if (event_data && event_data->GetFlavor() == ProcessEventData::GetFlavorString())
4890             return static_cast <const ProcessEventData *> (event_ptr->GetData());
4891     }
4892     return NULL;
4893 }
4894 
4895 ProcessSP
4896 Process::ProcessEventData::GetProcessFromEvent (const Event *event_ptr)
4897 {
4898     ProcessSP process_sp;
4899     const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4900     if (data)
4901         process_sp = data->GetProcessSP();
4902     return process_sp;
4903 }
4904 
4905 StateType
4906 Process::ProcessEventData::GetStateFromEvent (const Event *event_ptr)
4907 {
4908     const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4909     if (data == NULL)
4910         return eStateInvalid;
4911     else
4912         return data->GetState();
4913 }
4914 
4915 bool
4916 Process::ProcessEventData::GetRestartedFromEvent (const Event *event_ptr)
4917 {
4918     const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4919     if (data == NULL)
4920         return false;
4921     else
4922         return data->GetRestarted();
4923 }
4924 
4925 void
4926 Process::ProcessEventData::SetRestartedInEvent (Event *event_ptr, bool new_value)
4927 {
4928     ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4929     if (data != NULL)
4930         data->SetRestarted(new_value);
4931 }
4932 
4933 size_t
4934 Process::ProcessEventData::GetNumRestartedReasons(const Event *event_ptr)
4935 {
4936     ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4937     if (data != NULL)
4938         return data->GetNumRestartedReasons();
4939     else
4940         return 0;
4941 }
4942 
4943 const char *
4944 Process::ProcessEventData::GetRestartedReasonAtIndex(const Event *event_ptr, size_t idx)
4945 {
4946     ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4947     if (data != NULL)
4948         return data->GetRestartedReasonAtIndex(idx);
4949     else
4950         return NULL;
4951 }
4952 
4953 void
4954 Process::ProcessEventData::AddRestartedReason (Event *event_ptr, const char *reason)
4955 {
4956     ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4957     if (data != NULL)
4958         data->AddRestartedReason(reason);
4959 }
4960 
4961 bool
4962 Process::ProcessEventData::GetInterruptedFromEvent (const Event *event_ptr)
4963 {
4964     const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4965     if (data == NULL)
4966         return false;
4967     else
4968         return data->GetInterrupted ();
4969 }
4970 
4971 void
4972 Process::ProcessEventData::SetInterruptedInEvent (Event *event_ptr, bool new_value)
4973 {
4974     ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4975     if (data != NULL)
4976         data->SetInterrupted(new_value);
4977 }
4978 
4979 bool
4980 Process::ProcessEventData::SetUpdateStateOnRemoval (Event *event_ptr)
4981 {
4982     ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4983     if (data)
4984     {
4985         data->SetUpdateStateOnRemoval();
4986         return true;
4987     }
4988     return false;
4989 }
4990 
4991 lldb::TargetSP
4992 Process::CalculateTarget ()
4993 {
4994     return m_target_sp.lock();
4995 }
4996 
4997 void
4998 Process::CalculateExecutionContext (ExecutionContext &exe_ctx)
4999 {
5000     exe_ctx.SetTargetPtr (&GetTarget());
5001     exe_ctx.SetProcessPtr (this);
5002     exe_ctx.SetThreadPtr(NULL);
5003     exe_ctx.SetFramePtr (NULL);
5004 }
5005 
5006 //uint32_t
5007 //Process::ListProcessesMatchingName (const char *name, StringList &matches, std::vector<lldb::pid_t> &pids)
5008 //{
5009 //    return 0;
5010 //}
5011 //
5012 //ArchSpec
5013 //Process::GetArchSpecForExistingProcess (lldb::pid_t pid)
5014 //{
5015 //    return Host::GetArchSpecForExistingProcess (pid);
5016 //}
5017 //
5018 //ArchSpec
5019 //Process::GetArchSpecForExistingProcess (const char *process_name)
5020 //{
5021 //    return Host::GetArchSpecForExistingProcess (process_name);
5022 //}
5023 //
5024 void
5025 Process::AppendSTDOUT (const char * s, size_t len)
5026 {
5027     Mutex::Locker locker (m_stdio_communication_mutex);
5028     m_stdout_data.append (s, len);
5029     BroadcastEventIfUnique (eBroadcastBitSTDOUT, new ProcessEventData (shared_from_this(), GetState()));
5030 }
5031 
5032 void
5033 Process::AppendSTDERR (const char * s, size_t len)
5034 {
5035     Mutex::Locker locker (m_stdio_communication_mutex);
5036     m_stderr_data.append (s, len);
5037     BroadcastEventIfUnique (eBroadcastBitSTDERR, new ProcessEventData (shared_from_this(), GetState()));
5038 }
5039 
5040 void
5041 Process::BroadcastAsyncProfileData(const std::string &one_profile_data)
5042 {
5043     Mutex::Locker locker (m_profile_data_comm_mutex);
5044     m_profile_data.push_back(one_profile_data);
5045     BroadcastEventIfUnique (eBroadcastBitProfileData, new ProcessEventData (shared_from_this(), GetState()));
5046 }
5047 
5048 size_t
5049 Process::GetAsyncProfileData (char *buf, size_t buf_size, Error &error)
5050 {
5051     Mutex::Locker locker(m_profile_data_comm_mutex);
5052     if (m_profile_data.empty())
5053         return 0;
5054 
5055     std::string &one_profile_data = m_profile_data.front();
5056     size_t bytes_available = one_profile_data.size();
5057     if (bytes_available > 0)
5058     {
5059         Log *log (lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
5060         if (log)
5061             log->Printf ("Process::GetProfileData (buf = %p, size = %" PRIu64 ")",
5062                          static_cast<void*>(buf),
5063                          static_cast<uint64_t>(buf_size));
5064         if (bytes_available > buf_size)
5065         {
5066             memcpy(buf, one_profile_data.c_str(), buf_size);
5067             one_profile_data.erase(0, buf_size);
5068             bytes_available = buf_size;
5069         }
5070         else
5071         {
5072             memcpy(buf, one_profile_data.c_str(), bytes_available);
5073             m_profile_data.erase(m_profile_data.begin());
5074         }
5075     }
5076     return bytes_available;
5077 }
5078 
5079 
5080 //------------------------------------------------------------------
5081 // Process STDIO
5082 //------------------------------------------------------------------
5083 
5084 size_t
5085 Process::GetSTDOUT (char *buf, size_t buf_size, Error &error)
5086 {
5087     Mutex::Locker locker(m_stdio_communication_mutex);
5088     size_t bytes_available = m_stdout_data.size();
5089     if (bytes_available > 0)
5090     {
5091         Log *log (lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
5092         if (log)
5093             log->Printf ("Process::GetSTDOUT (buf = %p, size = %" PRIu64 ")",
5094                          static_cast<void*>(buf),
5095                          static_cast<uint64_t>(buf_size));
5096         if (bytes_available > buf_size)
5097         {
5098             memcpy(buf, m_stdout_data.c_str(), buf_size);
5099             m_stdout_data.erase(0, buf_size);
5100             bytes_available = buf_size;
5101         }
5102         else
5103         {
5104             memcpy(buf, m_stdout_data.c_str(), bytes_available);
5105             m_stdout_data.clear();
5106         }
5107     }
5108     return bytes_available;
5109 }
5110 
5111 
5112 size_t
5113 Process::GetSTDERR (char *buf, size_t buf_size, Error &error)
5114 {
5115     Mutex::Locker locker(m_stdio_communication_mutex);
5116     size_t bytes_available = m_stderr_data.size();
5117     if (bytes_available > 0)
5118     {
5119         Log *log (lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
5120         if (log)
5121             log->Printf ("Process::GetSTDERR (buf = %p, size = %" PRIu64 ")",
5122                          static_cast<void*>(buf),
5123                          static_cast<uint64_t>(buf_size));
5124         if (bytes_available > buf_size)
5125         {
5126             memcpy(buf, m_stderr_data.c_str(), buf_size);
5127             m_stderr_data.erase(0, buf_size);
5128             bytes_available = buf_size;
5129         }
5130         else
5131         {
5132             memcpy(buf, m_stderr_data.c_str(), bytes_available);
5133             m_stderr_data.clear();
5134         }
5135     }
5136     return bytes_available;
5137 }
5138 
5139 void
5140 Process::STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len)
5141 {
5142     Process *process = (Process *) baton;
5143     process->AppendSTDOUT (static_cast<const char *>(src), src_len);
5144 }
5145 
5146 class IOHandlerProcessSTDIO :
5147     public IOHandler
5148 {
5149 public:
5150     IOHandlerProcessSTDIO (Process *process,
5151                            int write_fd) :
5152     IOHandler(process->GetTarget().GetDebugger(), IOHandler::Type::ProcessIO),
5153         m_process (process),
5154         m_read_file (),
5155         m_write_file (write_fd, false),
5156         m_pipe ()
5157     {
5158         m_pipe.CreateNew(false);
5159         m_read_file.SetDescriptor(GetInputFD(), false);
5160     }
5161 
5162     virtual
5163     ~IOHandlerProcessSTDIO ()
5164     {
5165 
5166     }
5167 
5168     // Each IOHandler gets to run until it is done. It should read data
5169     // from the "in" and place output into "out" and "err and return
5170     // when done.
5171     void
5172     Run () override
5173     {
5174         if (!m_read_file.IsValid() || !m_write_file.IsValid() || !m_pipe.CanRead() || !m_pipe.CanWrite())
5175         {
5176             SetIsDone(true);
5177             return;
5178         }
5179 
5180         SetIsDone(false);
5181         const int read_fd = m_read_file.GetDescriptor();
5182         TerminalState terminal_state;
5183         terminal_state.Save (read_fd, false);
5184         Terminal terminal(read_fd);
5185         terminal.SetCanonical(false);
5186         terminal.SetEcho(false);
5187 // FD_ZERO, FD_SET are not supported on windows
5188 #ifndef _WIN32
5189         const int pipe_read_fd = m_pipe.GetReadFileDescriptor();
5190         while (!GetIsDone())
5191         {
5192             fd_set read_fdset;
5193             FD_ZERO (&read_fdset);
5194             FD_SET (read_fd, &read_fdset);
5195             FD_SET (pipe_read_fd, &read_fdset);
5196             const int nfds = std::max<int>(read_fd, pipe_read_fd) + 1;
5197             int num_set_fds = select (nfds, &read_fdset, NULL, NULL, NULL);
5198             if (num_set_fds < 0)
5199             {
5200                 const int select_errno = errno;
5201 
5202                 if (select_errno != EINTR)
5203                     SetIsDone(true);
5204             }
5205             else if (num_set_fds > 0)
5206             {
5207                 char ch = 0;
5208                 size_t n;
5209                 if (FD_ISSET (read_fd, &read_fdset))
5210                 {
5211                     n = 1;
5212                     if (m_read_file.Read(&ch, n).Success() && n == 1)
5213                     {
5214                         if (m_write_file.Write(&ch, n).Fail() || n != 1)
5215                             SetIsDone(true);
5216                     }
5217                     else
5218                         SetIsDone(true);
5219                 }
5220                 if (FD_ISSET (pipe_read_fd, &read_fdset))
5221                 {
5222                     size_t bytes_read;
5223                     // Consume the interrupt byte
5224                     Error error = m_pipe.Read(&ch, 1, bytes_read);
5225                     if (error.Success())
5226                     {
5227                         switch (ch)
5228                         {
5229                             case 'q':
5230                                 SetIsDone(true);
5231                                 break;
5232                             case 'i':
5233                                 if (StateIsRunningState(m_process->GetState()))
5234                                     m_process->Halt();
5235                                 break;
5236                         }
5237                     }
5238                 }
5239             }
5240         }
5241 #endif
5242         terminal_state.Restore();
5243     }
5244 
5245     void
5246     Cancel () override
5247     {
5248         char ch = 'q';  // Send 'q' for quit
5249         size_t bytes_written = 0;
5250         m_pipe.Write(&ch, 1, bytes_written);
5251     }
5252 
5253     bool
5254     Interrupt () override
5255     {
5256         // Do only things that are safe to do in an interrupt context (like in
5257         // a SIGINT handler), like write 1 byte to a file descriptor. This will
5258         // interrupt the IOHandlerProcessSTDIO::Run() and we can look at the byte
5259         // that was written to the pipe and then call m_process->Halt() from a
5260         // much safer location in code.
5261         if (m_active)
5262         {
5263             char ch = 'i'; // Send 'i' for interrupt
5264             size_t bytes_written = 0;
5265             Error result = m_pipe.Write(&ch, 1, bytes_written);
5266             return result.Success();
5267         }
5268         else
5269         {
5270             // This IOHandler might be pushed on the stack, but not being run currently
5271             // so do the right thing if we aren't actively watching for STDIN by sending
5272             // the interrupt to the process. Otherwise the write to the pipe above would
5273             // do nothing. This can happen when the command interpreter is running and
5274             // gets a "expression ...". It will be on the IOHandler thread and sending
5275             // the input is complete to the delegate which will cause the expression to
5276             // run, which will push the process IO handler, but not run it.
5277 
5278             if (StateIsRunningState(m_process->GetState()))
5279             {
5280                 m_process->SendAsyncInterrupt();
5281                 return true;
5282             }
5283         }
5284         return false;
5285     }
5286 
5287     void
5288     GotEOF() override
5289     {
5290 
5291     }
5292 
5293 protected:
5294     Process *m_process;
5295     File m_read_file;   // Read from this file (usually actual STDIN for LLDB
5296     File m_write_file;  // Write to this file (usually the master pty for getting io to debuggee)
5297     Pipe m_pipe;
5298 };
5299 
5300 void
5301 Process::SetSTDIOFileDescriptor (int fd)
5302 {
5303     // First set up the Read Thread for reading/handling process I/O
5304 
5305     std::unique_ptr<ConnectionFileDescriptor> conn_ap (new ConnectionFileDescriptor (fd, true));
5306 
5307     if (conn_ap.get())
5308     {
5309         m_stdio_communication.SetConnection (conn_ap.release());
5310         if (m_stdio_communication.IsConnected())
5311         {
5312             m_stdio_communication.SetReadThreadBytesReceivedCallback (STDIOReadThreadBytesReceived, this);
5313             m_stdio_communication.StartReadThread();
5314 
5315             // Now read thread is set up, set up input reader.
5316 
5317             if (!m_process_input_reader.get())
5318                 m_process_input_reader.reset (new IOHandlerProcessSTDIO (this, fd));
5319         }
5320     }
5321 }
5322 
5323 bool
5324 Process::ProcessIOHandlerIsActive ()
5325 {
5326     IOHandlerSP io_handler_sp (m_process_input_reader);
5327     if (io_handler_sp)
5328         return GetTarget().GetDebugger().IsTopIOHandler (io_handler_sp);
5329     return false;
5330 }
5331 bool
5332 Process::PushProcessIOHandler ()
5333 {
5334     IOHandlerSP io_handler_sp (m_process_input_reader);
5335     if (io_handler_sp)
5336     {
5337         Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
5338         if (log)
5339             log->Printf("Process::%s pushing IO handler", __FUNCTION__);
5340 
5341         io_handler_sp->SetIsDone(false);
5342         GetTarget().GetDebugger().PushIOHandler (io_handler_sp);
5343         return true;
5344     }
5345     return false;
5346 }
5347 
5348 bool
5349 Process::PopProcessIOHandler ()
5350 {
5351     IOHandlerSP io_handler_sp (m_process_input_reader);
5352     if (io_handler_sp)
5353         return GetTarget().GetDebugger().PopIOHandler (io_handler_sp);
5354     return false;
5355 }
5356 
5357 // The process needs to know about installed plug-ins
5358 void
5359 Process::SettingsInitialize ()
5360 {
5361     Thread::SettingsInitialize ();
5362 }
5363 
5364 void
5365 Process::SettingsTerminate ()
5366 {
5367     Thread::SettingsTerminate ();
5368 }
5369 
5370 ExpressionResults
5371 Process::RunThreadPlan (ExecutionContext &exe_ctx,
5372                         lldb::ThreadPlanSP &thread_plan_sp,
5373                         const EvaluateExpressionOptions &options,
5374                         Stream &errors)
5375 {
5376     ExpressionResults return_value = eExpressionSetupError;
5377 
5378     if (thread_plan_sp.get() == NULL)
5379     {
5380         errors.Printf("RunThreadPlan called with empty thread plan.");
5381         return eExpressionSetupError;
5382     }
5383 
5384     if (!thread_plan_sp->ValidatePlan(NULL))
5385     {
5386         errors.Printf ("RunThreadPlan called with an invalid thread plan.");
5387         return eExpressionSetupError;
5388     }
5389 
5390     if (exe_ctx.GetProcessPtr() != this)
5391     {
5392         errors.Printf("RunThreadPlan called on wrong process.");
5393         return eExpressionSetupError;
5394     }
5395 
5396     Thread *thread = exe_ctx.GetThreadPtr();
5397     if (thread == NULL)
5398     {
5399         errors.Printf("RunThreadPlan called with invalid thread.");
5400         return eExpressionSetupError;
5401     }
5402 
5403     // We rely on the thread plan we are running returning "PlanCompleted" if when it successfully completes.
5404     // For that to be true the plan can't be private - since private plans suppress themselves in the
5405     // GetCompletedPlan call.
5406 
5407     bool orig_plan_private = thread_plan_sp->GetPrivate();
5408     thread_plan_sp->SetPrivate(false);
5409 
5410     if (m_private_state.GetValue() != eStateStopped)
5411     {
5412         errors.Printf ("RunThreadPlan called while the private state was not stopped.");
5413         return eExpressionSetupError;
5414     }
5415 
5416     // Save the thread & frame from the exe_ctx for restoration after we run
5417     const uint32_t thread_idx_id = thread->GetIndexID();
5418     StackFrameSP selected_frame_sp = thread->GetSelectedFrame();
5419     if (!selected_frame_sp)
5420     {
5421         thread->SetSelectedFrame(0);
5422         selected_frame_sp = thread->GetSelectedFrame();
5423         if (!selected_frame_sp)
5424         {
5425             errors.Printf("RunThreadPlan called without a selected frame on thread %d", thread_idx_id);
5426             return eExpressionSetupError;
5427         }
5428     }
5429 
5430     StackID ctx_frame_id = selected_frame_sp->GetStackID();
5431 
5432     // N.B. Running the target may unset the currently selected thread and frame.  We don't want to do that either,
5433     // so we should arrange to reset them as well.
5434 
5435     lldb::ThreadSP selected_thread_sp = GetThreadList().GetSelectedThread();
5436 
5437     uint32_t selected_tid;
5438     StackID selected_stack_id;
5439     if (selected_thread_sp)
5440     {
5441         selected_tid = selected_thread_sp->GetIndexID();
5442         selected_stack_id = selected_thread_sp->GetSelectedFrame()->GetStackID();
5443     }
5444     else
5445     {
5446         selected_tid = LLDB_INVALID_THREAD_ID;
5447     }
5448 
5449     HostThread backup_private_state_thread;
5450     lldb::StateType old_state = eStateInvalid;
5451     lldb::ThreadPlanSP stopper_base_plan_sp;
5452 
5453     Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STEP | LIBLLDB_LOG_PROCESS));
5454     if (m_private_state_thread.EqualsThread(Host::GetCurrentThread()))
5455     {
5456         // Yikes, we are running on the private state thread!  So we can't wait for public events on this thread, since
5457         // we are the thread that is generating public events.
5458         // The simplest thing to do is to spin up a temporary thread to handle private state thread events while
5459         // we are fielding public events here.
5460         if (log)
5461             log->Printf ("Running thread plan on private state thread, spinning up another state thread to handle the events.");
5462 
5463         backup_private_state_thread = m_private_state_thread;
5464 
5465         // One other bit of business: we want to run just this thread plan and anything it pushes, and then stop,
5466         // returning control here.
5467         // But in the normal course of things, the plan above us on the stack would be given a shot at the stop
5468         // event before deciding to stop, and we don't want that.  So we insert a "stopper" base plan on the stack
5469         // before the plan we want to run.  Since base plans always stop and return control to the user, that will
5470         // do just what we want.
5471         stopper_base_plan_sp.reset(new ThreadPlanBase (*thread));
5472         thread->QueueThreadPlan (stopper_base_plan_sp, false);
5473         // Have to make sure our public state is stopped, since otherwise the reporting logic below doesn't work correctly.
5474         old_state = m_public_state.GetValue();
5475         m_public_state.SetValueNoLock(eStateStopped);
5476 
5477         // Now spin up the private state thread:
5478         StartPrivateStateThread(true);
5479     }
5480 
5481     thread->QueueThreadPlan(thread_plan_sp, false); // This used to pass "true" does that make sense?
5482 
5483     if (options.GetDebug())
5484     {
5485         // In this case, we aren't actually going to run, we just want to stop right away.
5486         // Flush this thread so we will refetch the stacks and show the correct backtrace.
5487         // FIXME: To make this prettier we should invent some stop reason for this, but that
5488         // is only cosmetic, and this functionality is only of use to lldb developers who can
5489         // live with not pretty...
5490         thread->Flush();
5491         return eExpressionStoppedForDebug;
5492     }
5493 
5494     Listener listener("lldb.process.listener.run-thread-plan");
5495 
5496     lldb::EventSP event_to_broadcast_sp;
5497 
5498     {
5499         // This process event hijacker Hijacks the Public events and its destructor makes sure that the process events get
5500         // restored on exit to the function.
5501         //
5502         // If the event needs to propagate beyond the hijacker (e.g., the process exits during execution), then the event
5503         // is put into event_to_broadcast_sp for rebroadcasting.
5504 
5505         ProcessEventHijacker run_thread_plan_hijacker (*this, &listener);
5506 
5507         if (log)
5508         {
5509             StreamString s;
5510             thread_plan_sp->GetDescription(&s, lldb::eDescriptionLevelVerbose);
5511             log->Printf ("Process::RunThreadPlan(): Resuming thread %u - 0x%4.4" PRIx64 " to run thread plan \"%s\".",
5512                          thread->GetIndexID(),
5513                          thread->GetID(),
5514                          s.GetData());
5515         }
5516 
5517         bool got_event;
5518         lldb::EventSP event_sp;
5519         lldb::StateType stop_state = lldb::eStateInvalid;
5520 
5521         TimeValue* timeout_ptr = NULL;
5522         TimeValue real_timeout;
5523 
5524         bool before_first_timeout = true;  // This is set to false the first time that we have to halt the target.
5525         bool do_resume = true;
5526         bool handle_running_event = true;
5527         const uint64_t default_one_thread_timeout_usec = 250000;
5528 
5529         // This is just for accounting:
5530         uint32_t num_resumes = 0;
5531 
5532         uint32_t timeout_usec = options.GetTimeoutUsec();
5533         uint32_t one_thread_timeout_usec;
5534         uint32_t all_threads_timeout_usec = 0;
5535 
5536         // If we are going to run all threads the whole time, or if we are only going to run one thread,
5537         // then we don't need the first timeout.  So we set the final timeout, and pretend we are after the
5538         // first timeout already.
5539 
5540         if (!options.GetStopOthers() || !options.GetTryAllThreads())
5541         {
5542             before_first_timeout = false;
5543             one_thread_timeout_usec = 0;
5544             all_threads_timeout_usec = timeout_usec;
5545         }
5546         else
5547         {
5548             uint32_t option_one_thread_timeout = options.GetOneThreadTimeoutUsec();
5549 
5550             // If the overall wait is forever, then we only need to set the one thread timeout:
5551             if (timeout_usec == 0)
5552             {
5553                 if (option_one_thread_timeout != 0)
5554                     one_thread_timeout_usec = option_one_thread_timeout;
5555                 else
5556                     one_thread_timeout_usec = default_one_thread_timeout_usec;
5557             }
5558             else
5559             {
5560                 // Otherwise, if the one thread timeout is set, make sure it isn't longer than the overall timeout,
5561                 // and use it, otherwise use half the total timeout, bounded by the default_one_thread_timeout_usec.
5562                 uint64_t computed_one_thread_timeout;
5563                 if (option_one_thread_timeout != 0)
5564                 {
5565                     if (timeout_usec < option_one_thread_timeout)
5566                     {
5567                         errors.Printf("RunThreadPlan called without one thread timeout greater than total timeout");
5568                         return eExpressionSetupError;
5569                     }
5570                     computed_one_thread_timeout = option_one_thread_timeout;
5571                 }
5572                 else
5573                 {
5574                     computed_one_thread_timeout = timeout_usec / 2;
5575                     if (computed_one_thread_timeout > default_one_thread_timeout_usec)
5576                         computed_one_thread_timeout = default_one_thread_timeout_usec;
5577                 }
5578                 one_thread_timeout_usec = computed_one_thread_timeout;
5579                 all_threads_timeout_usec = timeout_usec - one_thread_timeout_usec;
5580 
5581             }
5582         }
5583 
5584         if (log)
5585             log->Printf ("Stop others: %u, try all: %u, before_first: %u, one thread: %" PRIu32 " - all threads: %" PRIu32 ".\n",
5586                          options.GetStopOthers(),
5587                          options.GetTryAllThreads(),
5588                          before_first_timeout,
5589                          one_thread_timeout_usec,
5590                          all_threads_timeout_usec);
5591 
5592         // This isn't going to work if there are unfetched events on the queue.
5593         // Are there cases where we might want to run the remaining events here, and then try to
5594         // call the function?  That's probably being too tricky for our own good.
5595 
5596         Event *other_events = listener.PeekAtNextEvent();
5597         if (other_events != NULL)
5598         {
5599             errors.Printf("Calling RunThreadPlan with pending events on the queue.");
5600             return eExpressionSetupError;
5601         }
5602 
5603         // We also need to make sure that the next event is delivered.  We might be calling a function as part of
5604         // a thread plan, in which case the last delivered event could be the running event, and we don't want
5605         // event coalescing to cause us to lose OUR running event...
5606         ForceNextEventDelivery();
5607 
5608         // This while loop must exit out the bottom, there's cleanup that we need to do when we are done.
5609         // So don't call return anywhere within it.
5610 
5611 #ifdef LLDB_RUN_THREAD_HALT_WITH_EVENT
5612         // It's pretty much impossible to write test cases for things like:
5613         // One thread timeout expires, I go to halt, but the process already stopped
5614         // on the function call stop breakpoint.  Turning on this define will make us not
5615         // fetch the first event till after the halt.  So if you run a quick function, it will have
5616         // completed, and the completion event will be waiting, when you interrupt for halt.
5617         // The expression evaluation should still succeed.
5618         bool miss_first_event = true;
5619 #endif
5620         TimeValue one_thread_timeout;
5621         TimeValue final_timeout;
5622 
5623 
5624         while (1)
5625         {
5626             // We usually want to resume the process if we get to the top of the loop.
5627             // The only exception is if we get two running events with no intervening
5628             // stop, which can happen, we will just wait for then next stop event.
5629             if (log)
5630                 log->Printf ("Top of while loop: do_resume: %i handle_running_event: %i before_first_timeout: %i.",
5631                              do_resume,
5632                              handle_running_event,
5633                              before_first_timeout);
5634 
5635             if (do_resume || handle_running_event)
5636             {
5637                 // Do the initial resume and wait for the running event before going further.
5638 
5639                 if (do_resume)
5640                 {
5641                     num_resumes++;
5642                     Error resume_error = PrivateResume ();
5643                     if (!resume_error.Success())
5644                     {
5645                         errors.Printf("Error resuming inferior the %d time: \"%s\".\n",
5646                                       num_resumes,
5647                                       resume_error.AsCString());
5648                         return_value = eExpressionSetupError;
5649                         break;
5650                     }
5651                 }
5652 
5653                 TimeValue resume_timeout = TimeValue::Now();
5654                 resume_timeout.OffsetWithMicroSeconds(500000);
5655 
5656                 got_event = listener.WaitForEvent(&resume_timeout, event_sp);
5657                 if (!got_event)
5658                 {
5659                     if (log)
5660                         log->Printf ("Process::RunThreadPlan(): didn't get any event after resume %d, exiting.",
5661                                         num_resumes);
5662 
5663                     errors.Printf("Didn't get any event after resume %d, exiting.", num_resumes);
5664                     return_value = eExpressionSetupError;
5665                     break;
5666                 }
5667 
5668                 stop_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
5669 
5670                 if (stop_state != eStateRunning)
5671                 {
5672                     bool restarted = false;
5673 
5674                     if (stop_state == eStateStopped)
5675                     {
5676                         restarted = Process::ProcessEventData::GetRestartedFromEvent(event_sp.get());
5677                         if (log)
5678                             log->Printf("Process::RunThreadPlan(): didn't get running event after "
5679                                         "resume %d, got %s instead (restarted: %i, do_resume: %i, handle_running_event: %i).",
5680                                         num_resumes,
5681                                         StateAsCString(stop_state),
5682                                         restarted,
5683                                         do_resume,
5684                                         handle_running_event);
5685                     }
5686 
5687                     if (restarted)
5688                     {
5689                         // This is probably an overabundance of caution, I don't think I should ever get a stopped & restarted
5690                         // event here.  But if I do, the best thing is to Halt and then get out of here.
5691                         Halt();
5692                     }
5693 
5694                     errors.Printf("Didn't get running event after initial resume, got %s instead.",
5695                                   StateAsCString(stop_state));
5696                     return_value = eExpressionSetupError;
5697                     break;
5698                 }
5699 
5700                 if (log)
5701                     log->PutCString ("Process::RunThreadPlan(): resuming succeeded.");
5702                 // We need to call the function synchronously, so spin waiting for it to return.
5703                 // If we get interrupted while executing, we're going to lose our context, and
5704                 // won't be able to gather the result at this point.
5705                 // We set the timeout AFTER the resume, since the resume takes some time and we
5706                 // don't want to charge that to the timeout.
5707             }
5708             else
5709             {
5710                 if (log)
5711                     log->PutCString ("Process::RunThreadPlan(): waiting for next event.");
5712             }
5713 
5714             if (before_first_timeout)
5715             {
5716                 if (options.GetTryAllThreads())
5717                 {
5718                     one_thread_timeout = TimeValue::Now();
5719                     one_thread_timeout.OffsetWithMicroSeconds(one_thread_timeout_usec);
5720                     timeout_ptr = &one_thread_timeout;
5721                 }
5722                 else
5723                 {
5724                     if (timeout_usec == 0)
5725                         timeout_ptr = NULL;
5726                     else
5727                     {
5728                         final_timeout = TimeValue::Now();
5729                         final_timeout.OffsetWithMicroSeconds (timeout_usec);
5730                         timeout_ptr = &final_timeout;
5731                     }
5732                 }
5733             }
5734             else
5735             {
5736                 if (timeout_usec == 0)
5737                     timeout_ptr = NULL;
5738                 else
5739                 {
5740                     final_timeout = TimeValue::Now();
5741                     final_timeout.OffsetWithMicroSeconds (all_threads_timeout_usec);
5742                     timeout_ptr = &final_timeout;
5743                 }
5744             }
5745 
5746             do_resume = true;
5747             handle_running_event = true;
5748 
5749             // Now wait for the process to stop again:
5750             event_sp.reset();
5751 
5752             if (log)
5753             {
5754                 if (timeout_ptr)
5755                 {
5756                     log->Printf ("Process::RunThreadPlan(): about to wait - now is %" PRIu64 " - endpoint is %" PRIu64,
5757                                  TimeValue::Now().GetAsMicroSecondsSinceJan1_1970(),
5758                                  timeout_ptr->GetAsMicroSecondsSinceJan1_1970());
5759                 }
5760                 else
5761                 {
5762                     log->Printf ("Process::RunThreadPlan(): about to wait forever.");
5763                 }
5764             }
5765 
5766 #ifdef LLDB_RUN_THREAD_HALT_WITH_EVENT
5767             // See comment above...
5768             if (miss_first_event)
5769             {
5770                 usleep(1000);
5771                 miss_first_event = false;
5772                 got_event = false;
5773             }
5774             else
5775 #endif
5776             got_event = listener.WaitForEvent (timeout_ptr, event_sp);
5777 
5778             if (got_event)
5779             {
5780                 if (event_sp.get())
5781                 {
5782                     bool keep_going = false;
5783                     if (event_sp->GetType() == eBroadcastBitInterrupt)
5784                     {
5785                         Halt();
5786                         return_value = eExpressionInterrupted;
5787                         errors.Printf ("Execution halted by user interrupt.");
5788                         if (log)
5789                             log->Printf ("Process::RunThreadPlan(): Got  interrupted by eBroadcastBitInterrupted, exiting.");
5790                         break;
5791                     }
5792                     else
5793                     {
5794                         stop_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
5795                         if (log)
5796                             log->Printf("Process::RunThreadPlan(): in while loop, got event: %s.", StateAsCString(stop_state));
5797 
5798                         switch (stop_state)
5799                         {
5800                         case lldb::eStateStopped:
5801                             {
5802                                 // We stopped, figure out what we are going to do now.
5803                                 ThreadSP thread_sp = GetThreadList().FindThreadByIndexID (thread_idx_id);
5804                                 if (!thread_sp)
5805                                 {
5806                                     // Ooh, our thread has vanished.  Unlikely that this was successful execution...
5807                                     if (log)
5808                                         log->Printf ("Process::RunThreadPlan(): execution completed but our thread (index-id=%u) has vanished.", thread_idx_id);
5809                                     return_value = eExpressionInterrupted;
5810                                 }
5811                                 else
5812                                 {
5813                                     // If we were restarted, we just need to go back up to fetch another event.
5814                                     if (Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
5815                                     {
5816                                         if (log)
5817                                         {
5818                                             log->Printf ("Process::RunThreadPlan(): Got a stop and restart, so we'll continue waiting.");
5819                                         }
5820                                        keep_going = true;
5821                                        do_resume = false;
5822                                        handle_running_event = true;
5823 
5824                                     }
5825                                     else
5826                                     {
5827                                         StopInfoSP stop_info_sp (thread_sp->GetStopInfo ());
5828                                         StopReason stop_reason = eStopReasonInvalid;
5829                                         if (stop_info_sp)
5830                                              stop_reason = stop_info_sp->GetStopReason();
5831 
5832                                         // FIXME: We only check if the stop reason is plan complete, should we make sure that
5833                                         // it is OUR plan that is complete?
5834                                         if (stop_reason == eStopReasonPlanComplete)
5835                                         {
5836                                             if (log)
5837                                                 log->PutCString ("Process::RunThreadPlan(): execution completed successfully.");
5838                                             // Now mark this plan as private so it doesn't get reported as the stop reason
5839                                             // after this point.
5840                                             if (thread_plan_sp)
5841                                                 thread_plan_sp->SetPrivate (orig_plan_private);
5842                                             return_value = eExpressionCompleted;
5843                                         }
5844                                         else
5845                                         {
5846                                             // Something restarted the target, so just wait for it to stop for real.
5847                                             if (stop_reason == eStopReasonBreakpoint)
5848                                             {
5849                                                 if (log)
5850                                                     log->Printf ("Process::RunThreadPlan() stopped for breakpoint: %s.", stop_info_sp->GetDescription());
5851                                                 return_value = eExpressionHitBreakpoint;
5852                                                 if (!options.DoesIgnoreBreakpoints())
5853                                                 {
5854                                                     event_to_broadcast_sp = event_sp;
5855                                                 }
5856                                             }
5857                                             else
5858                                             {
5859                                                 if (log)
5860                                                     log->PutCString ("Process::RunThreadPlan(): thread plan didn't successfully complete.");
5861                                                 if (!options.DoesUnwindOnError())
5862                                                     event_to_broadcast_sp = event_sp;
5863                                                 return_value = eExpressionInterrupted;
5864                                             }
5865                                         }
5866                                     }
5867                                 }
5868                             }
5869                             break;
5870 
5871                         case lldb::eStateRunning:
5872                             // This shouldn't really happen, but sometimes we do get two running events without an
5873                             // intervening stop, and in that case we should just go back to waiting for the stop.
5874                             do_resume = false;
5875                             keep_going = true;
5876                             handle_running_event = false;
5877                             break;
5878 
5879                         default:
5880                             if (log)
5881                                 log->Printf("Process::RunThreadPlan(): execution stopped with unexpected state: %s.", StateAsCString(stop_state));
5882 
5883                             if (stop_state == eStateExited)
5884                                 event_to_broadcast_sp = event_sp;
5885 
5886                             errors.Printf ("Execution stopped with unexpected state.\n");
5887                             return_value = eExpressionInterrupted;
5888                             break;
5889                         }
5890                     }
5891 
5892                     if (keep_going)
5893                         continue;
5894                     else
5895                         break;
5896                 }
5897                 else
5898                 {
5899                     if (log)
5900                         log->PutCString ("Process::RunThreadPlan(): got_event was true, but the event pointer was null.  How odd...");
5901                     return_value = eExpressionInterrupted;
5902                     break;
5903                 }
5904             }
5905             else
5906             {
5907                 // If we didn't get an event that means we've timed out...
5908                 // We will interrupt the process here.  Depending on what we were asked to do we will
5909                 // either exit, or try with all threads running for the same timeout.
5910 
5911                 if (log) {
5912                     if (options.GetTryAllThreads())
5913                     {
5914                         if (before_first_timeout)
5915                         {
5916                             if (timeout_usec != 0)
5917                             {
5918                                 log->Printf ("Process::RunThreadPlan(): Running function with one thread timeout timed out, "
5919                                              "running for %" PRIu32 " usec with all threads enabled.",
5920                                              all_threads_timeout_usec);
5921                             }
5922                             else
5923                             {
5924                                 log->Printf ("Process::RunThreadPlan(): Running function with one thread timeout timed out, "
5925                                              "running forever with all threads enabled.");
5926                             }
5927                         }
5928                         else
5929                             log->Printf ("Process::RunThreadPlan(): Restarting function with all threads enabled "
5930                                          "and timeout: %u timed out, abandoning execution.",
5931                                          timeout_usec);
5932                     }
5933                     else
5934                         log->Printf ("Process::RunThreadPlan(): Running function with timeout: %u timed out, "
5935                                      "abandoning execution.",
5936                                      timeout_usec);
5937                 }
5938 
5939                 // It is possible that between the time we issued the Halt, and we get around to calling Halt the target
5940                 // could have stopped.  That's fine, Halt will figure that out and send the appropriate Stopped event.
5941                 // BUT it is also possible that we stopped & restarted (e.g. hit a signal with "stop" set to false.)  In
5942                 // that case, we'll get the stopped & restarted event, and we should go back to waiting for the Halt's
5943                 // stopped event.  That's what this while loop does.
5944 
5945                 bool back_to_top = true;
5946                 uint32_t try_halt_again = 0;
5947                 bool do_halt = true;
5948                 const uint32_t num_retries = 5;
5949                 while (try_halt_again < num_retries)
5950                 {
5951                     Error halt_error;
5952                     if (do_halt)
5953                     {
5954                         if (log)
5955                             log->Printf ("Process::RunThreadPlan(): Running Halt.");
5956                         halt_error = Halt();
5957                     }
5958                     if (halt_error.Success())
5959                     {
5960                         if (log)
5961                             log->PutCString ("Process::RunThreadPlan(): Halt succeeded.");
5962 
5963                         real_timeout = TimeValue::Now();
5964                         real_timeout.OffsetWithMicroSeconds(500000);
5965 
5966                         got_event = listener.WaitForEvent(&real_timeout, event_sp);
5967 
5968                         if (got_event)
5969                         {
5970                             stop_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
5971                             if (log)
5972                             {
5973                                 log->Printf ("Process::RunThreadPlan(): Stopped with event: %s", StateAsCString(stop_state));
5974                                 if (stop_state == lldb::eStateStopped
5975                                     && Process::ProcessEventData::GetInterruptedFromEvent(event_sp.get()))
5976                                     log->PutCString ("    Event was the Halt interruption event.");
5977                             }
5978 
5979                             if (stop_state == lldb::eStateStopped)
5980                             {
5981                                 // Between the time we initiated the Halt and the time we delivered it, the process could have
5982                                 // already finished its job.  Check that here:
5983 
5984                                 if (thread->IsThreadPlanDone (thread_plan_sp.get()))
5985                                 {
5986                                     if (log)
5987                                         log->PutCString ("Process::RunThreadPlan(): Even though we timed out, the call plan was done.  "
5988                                                      "Exiting wait loop.");
5989                                     return_value = eExpressionCompleted;
5990                                     back_to_top = false;
5991                                     break;
5992                                 }
5993 
5994                                 if (Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
5995                                 {
5996                                     if (log)
5997                                         log->PutCString ("Process::RunThreadPlan(): Went to halt but got a restarted event, there must be an un-restarted stopped event so try again...  "
5998                                                      "Exiting wait loop.");
5999                                     try_halt_again++;
6000                                     do_halt = false;
6001                                     continue;
6002                                 }
6003 
6004                                 if (!options.GetTryAllThreads())
6005                                 {
6006                                     if (log)
6007                                         log->PutCString ("Process::RunThreadPlan(): try_all_threads was false, we stopped so now we're quitting.");
6008                                     return_value = eExpressionInterrupted;
6009                                     back_to_top = false;
6010                                     break;
6011                                 }
6012 
6013                                 if (before_first_timeout)
6014                                 {
6015                                     // Set all the other threads to run, and return to the top of the loop, which will continue;
6016                                     before_first_timeout = false;
6017                                     thread_plan_sp->SetStopOthers (false);
6018                                     if (log)
6019                                         log->PutCString ("Process::RunThreadPlan(): about to resume.");
6020 
6021                                     back_to_top = true;
6022                                     break;
6023                                 }
6024                                 else
6025                                 {
6026                                     // Running all threads failed, so return Interrupted.
6027                                     if (log)
6028                                         log->PutCString("Process::RunThreadPlan(): running all threads timed out.");
6029                                     return_value = eExpressionInterrupted;
6030                                     back_to_top = false;
6031                                     break;
6032                                 }
6033                             }
6034                         }
6035                         else
6036                         {   if (log)
6037                                 log->PutCString("Process::RunThreadPlan(): halt said it succeeded, but I got no event.  "
6038                                         "I'm getting out of here passing Interrupted.");
6039                             return_value = eExpressionInterrupted;
6040                             back_to_top = false;
6041                             break;
6042                         }
6043                     }
6044                     else
6045                     {
6046                         try_halt_again++;
6047                         continue;
6048                     }
6049                 }
6050 
6051                 if (!back_to_top || try_halt_again > num_retries)
6052                     break;
6053                 else
6054                     continue;
6055             }
6056         }  // END WAIT LOOP
6057 
6058         // If we had to start up a temporary private state thread to run this thread plan, shut it down now.
6059         if (backup_private_state_thread.IsJoinable())
6060         {
6061             StopPrivateStateThread();
6062             Error error;
6063             m_private_state_thread = backup_private_state_thread;
6064             if (stopper_base_plan_sp)
6065             {
6066                 thread->DiscardThreadPlansUpToPlan(stopper_base_plan_sp);
6067             }
6068             if (old_state != eStateInvalid)
6069                 m_public_state.SetValueNoLock(old_state);
6070         }
6071 
6072         // Restore the thread state if we are going to discard the plan execution.  There are three cases where this
6073         // could happen:
6074         // 1) The execution successfully completed
6075         // 2) We hit a breakpoint, and ignore_breakpoints was true
6076         // 3) We got some other error, and discard_on_error was true
6077         bool should_unwind = (return_value == eExpressionInterrupted && options.DoesUnwindOnError())
6078                              || (return_value == eExpressionHitBreakpoint && options.DoesIgnoreBreakpoints());
6079 
6080         if (return_value == eExpressionCompleted
6081             || should_unwind)
6082         {
6083             thread_plan_sp->RestoreThreadState();
6084         }
6085 
6086         // Now do some processing on the results of the run:
6087         if (return_value == eExpressionInterrupted || return_value == eExpressionHitBreakpoint)
6088         {
6089             if (log)
6090             {
6091                 StreamString s;
6092                 if (event_sp)
6093                     event_sp->Dump (&s);
6094                 else
6095                 {
6096                     log->PutCString ("Process::RunThreadPlan(): Stop event that interrupted us is NULL.");
6097                 }
6098 
6099                 StreamString ts;
6100 
6101                 const char *event_explanation = NULL;
6102 
6103                 do
6104                 {
6105                     if (!event_sp)
6106                     {
6107                         event_explanation = "<no event>";
6108                         break;
6109                     }
6110                     else if (event_sp->GetType() == eBroadcastBitInterrupt)
6111                     {
6112                         event_explanation = "<user interrupt>";
6113                         break;
6114                     }
6115                     else
6116                     {
6117                         const Process::ProcessEventData *event_data = Process::ProcessEventData::GetEventDataFromEvent (event_sp.get());
6118 
6119                         if (!event_data)
6120                         {
6121                             event_explanation = "<no event data>";
6122                             break;
6123                         }
6124 
6125                         Process *process = event_data->GetProcessSP().get();
6126 
6127                         if (!process)
6128                         {
6129                             event_explanation = "<no process>";
6130                             break;
6131                         }
6132 
6133                         ThreadList &thread_list = process->GetThreadList();
6134 
6135                         uint32_t num_threads = thread_list.GetSize();
6136                         uint32_t thread_index;
6137 
6138                         ts.Printf("<%u threads> ", num_threads);
6139 
6140                         for (thread_index = 0;
6141                              thread_index < num_threads;
6142                              ++thread_index)
6143                         {
6144                             Thread *thread = thread_list.GetThreadAtIndex(thread_index).get();
6145 
6146                             if (!thread)
6147                             {
6148                                 ts.Printf("<?> ");
6149                                 continue;
6150                             }
6151 
6152                             ts.Printf("<0x%4.4" PRIx64 " ", thread->GetID());
6153                             RegisterContext *register_context = thread->GetRegisterContext().get();
6154 
6155                             if (register_context)
6156                                 ts.Printf("[ip 0x%" PRIx64 "] ", register_context->GetPC());
6157                             else
6158                                 ts.Printf("[ip unknown] ");
6159 
6160                             lldb::StopInfoSP stop_info_sp = thread->GetStopInfo();
6161                             if (stop_info_sp)
6162                             {
6163                                 const char *stop_desc = stop_info_sp->GetDescription();
6164                                 if (stop_desc)
6165                                     ts.PutCString (stop_desc);
6166                             }
6167                             ts.Printf(">");
6168                         }
6169 
6170                         event_explanation = ts.GetData();
6171                     }
6172                 } while (0);
6173 
6174                 if (event_explanation)
6175                     log->Printf("Process::RunThreadPlan(): execution interrupted: %s %s", s.GetData(), event_explanation);
6176                 else
6177                     log->Printf("Process::RunThreadPlan(): execution interrupted: %s", s.GetData());
6178             }
6179 
6180             if (should_unwind)
6181             {
6182                 if (log)
6183                     log->Printf ("Process::RunThreadPlan: ExecutionInterrupted - discarding thread plans up to %p.",
6184                                  static_cast<void*>(thread_plan_sp.get()));
6185                 thread->DiscardThreadPlansUpToPlan (thread_plan_sp);
6186                 thread_plan_sp->SetPrivate (orig_plan_private);
6187             }
6188             else
6189             {
6190                 if (log)
6191                     log->Printf ("Process::RunThreadPlan: ExecutionInterrupted - for plan: %p not discarding.",
6192                                  static_cast<void*>(thread_plan_sp.get()));
6193             }
6194         }
6195         else if (return_value == eExpressionSetupError)
6196         {
6197             if (log)
6198                 log->PutCString("Process::RunThreadPlan(): execution set up error.");
6199 
6200             if (options.DoesUnwindOnError())
6201             {
6202                 thread->DiscardThreadPlansUpToPlan (thread_plan_sp);
6203                 thread_plan_sp->SetPrivate (orig_plan_private);
6204             }
6205         }
6206         else
6207         {
6208             if (thread->IsThreadPlanDone (thread_plan_sp.get()))
6209             {
6210                 if (log)
6211                     log->PutCString("Process::RunThreadPlan(): thread plan is done");
6212                 return_value = eExpressionCompleted;
6213             }
6214             else if (thread->WasThreadPlanDiscarded (thread_plan_sp.get()))
6215             {
6216                 if (log)
6217                     log->PutCString("Process::RunThreadPlan(): thread plan was discarded");
6218                 return_value = eExpressionDiscarded;
6219             }
6220             else
6221             {
6222                 if (log)
6223                     log->PutCString("Process::RunThreadPlan(): thread plan stopped in mid course");
6224                 if (options.DoesUnwindOnError() && thread_plan_sp)
6225                 {
6226                     if (log)
6227                         log->PutCString("Process::RunThreadPlan(): discarding thread plan 'cause unwind_on_error is set.");
6228                     thread->DiscardThreadPlansUpToPlan (thread_plan_sp);
6229                     thread_plan_sp->SetPrivate (orig_plan_private);
6230                 }
6231             }
6232         }
6233 
6234         // Thread we ran the function in may have gone away because we ran the target
6235         // Check that it's still there, and if it is put it back in the context.  Also restore the
6236         // frame in the context if it is still present.
6237         thread = GetThreadList().FindThreadByIndexID(thread_idx_id, true).get();
6238         if (thread)
6239         {
6240             exe_ctx.SetFrameSP (thread->GetFrameWithStackID (ctx_frame_id));
6241         }
6242 
6243         // Also restore the current process'es selected frame & thread, since this function calling may
6244         // be done behind the user's back.
6245 
6246         if (selected_tid != LLDB_INVALID_THREAD_ID)
6247         {
6248             if (GetThreadList().SetSelectedThreadByIndexID (selected_tid) && selected_stack_id.IsValid())
6249             {
6250                 // We were able to restore the selected thread, now restore the frame:
6251                 Mutex::Locker lock(GetThreadList().GetMutex());
6252                 StackFrameSP old_frame_sp = GetThreadList().GetSelectedThread()->GetFrameWithStackID(selected_stack_id);
6253                 if (old_frame_sp)
6254                     GetThreadList().GetSelectedThread()->SetSelectedFrame(old_frame_sp.get());
6255             }
6256         }
6257     }
6258 
6259     // If the process exited during the run of the thread plan, notify everyone.
6260 
6261     if (event_to_broadcast_sp)
6262     {
6263         if (log)
6264             log->PutCString("Process::RunThreadPlan(): rebroadcasting event.");
6265         BroadcastEvent(event_to_broadcast_sp);
6266     }
6267 
6268     return return_value;
6269 }
6270 
6271 const char *
6272 Process::ExecutionResultAsCString (ExpressionResults result)
6273 {
6274     const char *result_name;
6275 
6276     switch (result)
6277     {
6278         case eExpressionCompleted:
6279             result_name = "eExpressionCompleted";
6280             break;
6281         case eExpressionDiscarded:
6282             result_name = "eExpressionDiscarded";
6283             break;
6284         case eExpressionInterrupted:
6285             result_name = "eExpressionInterrupted";
6286             break;
6287         case eExpressionHitBreakpoint:
6288             result_name = "eExpressionHitBreakpoint";
6289             break;
6290         case eExpressionSetupError:
6291             result_name = "eExpressionSetupError";
6292             break;
6293         case eExpressionParseError:
6294             result_name = "eExpressionParseError";
6295             break;
6296         case eExpressionResultUnavailable:
6297             result_name = "eExpressionResultUnavailable";
6298             break;
6299         case eExpressionTimedOut:
6300             result_name = "eExpressionTimedOut";
6301             break;
6302         case eExpressionStoppedForDebug:
6303             result_name = "eExpressionStoppedForDebug";
6304             break;
6305     }
6306     return result_name;
6307 }
6308 
6309 void
6310 Process::GetStatus (Stream &strm)
6311 {
6312     const StateType state = GetState();
6313     if (StateIsStoppedState(state, false))
6314     {
6315         if (state == eStateExited)
6316         {
6317             int exit_status = GetExitStatus();
6318             const char *exit_description = GetExitDescription();
6319             strm.Printf ("Process %" PRIu64 " exited with status = %i (0x%8.8x) %s\n",
6320                           GetID(),
6321                           exit_status,
6322                           exit_status,
6323                           exit_description ? exit_description : "");
6324         }
6325         else
6326         {
6327             if (state == eStateConnected)
6328                 strm.Printf ("Connected to remote target.\n");
6329             else
6330                 strm.Printf ("Process %" PRIu64 " %s\n", GetID(), StateAsCString (state));
6331         }
6332     }
6333     else
6334     {
6335         strm.Printf ("Process %" PRIu64 " is running.\n", GetID());
6336     }
6337 }
6338 
6339 size_t
6340 Process::GetThreadStatus (Stream &strm,
6341                           bool only_threads_with_stop_reason,
6342                           uint32_t start_frame,
6343                           uint32_t num_frames,
6344                           uint32_t num_frames_with_source)
6345 {
6346     size_t num_thread_infos_dumped = 0;
6347 
6348     // You can't hold the thread list lock while calling Thread::GetStatus.  That very well might run code (e.g. if we need it
6349     // to get return values or arguments.)  For that to work the process has to be able to acquire it.  So instead copy the thread
6350     // ID's, and look them up one by one:
6351 
6352     uint32_t num_threads;
6353     std::vector<lldb::tid_t> thread_id_array;
6354     //Scope for thread list locker;
6355     {
6356         Mutex::Locker locker (GetThreadList().GetMutex());
6357         ThreadList &curr_thread_list = GetThreadList();
6358         num_threads = curr_thread_list.GetSize();
6359         uint32_t idx;
6360         thread_id_array.resize(num_threads);
6361         for (idx = 0; idx < num_threads; ++idx)
6362             thread_id_array[idx] = curr_thread_list.GetThreadAtIndex(idx)->GetID();
6363     }
6364 
6365     for (uint32_t i = 0; i < num_threads; i++)
6366     {
6367         ThreadSP thread_sp(GetThreadList().FindThreadByID(thread_id_array[i]));
6368         if (thread_sp)
6369         {
6370             if (only_threads_with_stop_reason)
6371             {
6372                 StopInfoSP stop_info_sp = thread_sp->GetStopInfo();
6373                 if (stop_info_sp.get() == NULL || !stop_info_sp->IsValid())
6374                     continue;
6375             }
6376             thread_sp->GetStatus (strm,
6377                                start_frame,
6378                                num_frames,
6379                                num_frames_with_source);
6380             ++num_thread_infos_dumped;
6381         }
6382         else
6383         {
6384             Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS));
6385             if (log)
6386                 log->Printf("Process::GetThreadStatus - thread 0x" PRIu64 " vanished while running Thread::GetStatus.");
6387 
6388         }
6389     }
6390     return num_thread_infos_dumped;
6391 }
6392 
6393 void
6394 Process::AddInvalidMemoryRegion (const LoadRange &region)
6395 {
6396     m_memory_cache.AddInvalidRange(region.GetRangeBase(), region.GetByteSize());
6397 }
6398 
6399 bool
6400 Process::RemoveInvalidMemoryRange (const LoadRange &region)
6401 {
6402     return m_memory_cache.RemoveInvalidRange(region.GetRangeBase(), region.GetByteSize());
6403 }
6404 
6405 void
6406 Process::AddPreResumeAction (PreResumeActionCallback callback, void *baton)
6407 {
6408     m_pre_resume_actions.push_back(PreResumeCallbackAndBaton (callback, baton));
6409 }
6410 
6411 bool
6412 Process::RunPreResumeActions ()
6413 {
6414     bool result = true;
6415     while (!m_pre_resume_actions.empty())
6416     {
6417         struct PreResumeCallbackAndBaton action = m_pre_resume_actions.back();
6418         m_pre_resume_actions.pop_back();
6419         bool this_result = action.callback (action.baton);
6420         if (result == true)
6421             result = this_result;
6422     }
6423     return result;
6424 }
6425 
6426 void
6427 Process::ClearPreResumeActions ()
6428 {
6429     m_pre_resume_actions.clear();
6430 }
6431 
6432 ProcessRunLock &
6433 Process::GetRunLock()
6434 {
6435     if (m_private_state_thread.EqualsThread(Host::GetCurrentThread()))
6436         return m_private_run_lock;
6437     else
6438         return m_public_run_lock;
6439 }
6440 
6441 void
6442 Process::Flush ()
6443 {
6444     m_thread_list.Flush();
6445     m_extended_thread_list.Flush();
6446     m_extended_thread_stop_id =  0;
6447     m_queue_list.Clear();
6448     m_queue_list_stop_id = 0;
6449 }
6450 
6451 void
6452 Process::DidExec ()
6453 {
6454     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
6455     if (log)
6456         log->Printf ("Process::%s()", __FUNCTION__);
6457 
6458     Target &target = GetTarget();
6459     target.CleanupProcess ();
6460     target.ClearModules(false);
6461     m_dynamic_checkers_ap.reset();
6462     m_abi_sp.reset();
6463     m_system_runtime_ap.reset();
6464     m_os_ap.reset();
6465     m_dyld_ap.reset();
6466     m_jit_loaders_ap.reset();
6467     m_image_tokens.clear();
6468     m_allocated_memory_cache.Clear();
6469     m_language_runtimes.clear();
6470     m_instrumentation_runtimes.clear();
6471     m_thread_list.DiscardThreadPlans();
6472     m_memory_cache.Clear(true);
6473     m_stop_info_override_callback = NULL;
6474     DoDidExec();
6475     CompleteAttach ();
6476     // Flush the process (threads and all stack frames) after running CompleteAttach()
6477     // in case the dynamic loader loaded things in new locations.
6478     Flush();
6479 
6480     // After we figure out what was loaded/unloaded in CompleteAttach,
6481     // we need to let the target know so it can do any cleanup it needs to.
6482     target.DidExec();
6483 }
6484 
6485 addr_t
6486 Process::ResolveIndirectFunction(const Address *address, Error &error)
6487 {
6488     if (address == nullptr)
6489     {
6490         error.SetErrorString("Invalid address argument");
6491         return LLDB_INVALID_ADDRESS;
6492     }
6493 
6494     addr_t function_addr = LLDB_INVALID_ADDRESS;
6495 
6496     addr_t addr = address->GetLoadAddress(&GetTarget());
6497     std::map<addr_t,addr_t>::const_iterator iter = m_resolved_indirect_addresses.find(addr);
6498     if (iter != m_resolved_indirect_addresses.end())
6499     {
6500         function_addr = (*iter).second;
6501     }
6502     else
6503     {
6504         if (!InferiorCall(this, address, function_addr))
6505         {
6506             Symbol *symbol = address->CalculateSymbolContextSymbol();
6507             error.SetErrorStringWithFormat ("Unable to call resolver for indirect function %s",
6508                                           symbol ? symbol->GetName().AsCString() : "<UNKNOWN>");
6509             function_addr = LLDB_INVALID_ADDRESS;
6510         }
6511         else
6512         {
6513             m_resolved_indirect_addresses.insert(std::pair<addr_t, addr_t>(addr, function_addr));
6514         }
6515     }
6516     return function_addr;
6517 }
6518 
6519 void
6520 Process::ModulesDidLoad (ModuleList &module_list)
6521 {
6522     SystemRuntime *sys_runtime = GetSystemRuntime();
6523     if (sys_runtime)
6524     {
6525         sys_runtime->ModulesDidLoad (module_list);
6526     }
6527 
6528     GetJITLoaders().ModulesDidLoad (module_list);
6529 
6530     // Give runtimes a chance to be created.
6531     InstrumentationRuntime::ModulesDidLoad(module_list, this, m_instrumentation_runtimes);
6532 
6533     // Tell runtimes about new modules.
6534     for (auto pos = m_instrumentation_runtimes.begin(); pos != m_instrumentation_runtimes.end(); ++pos)
6535     {
6536         InstrumentationRuntimeSP runtime = pos->second;
6537         runtime->ModulesDidLoad(module_list);
6538     }
6539 
6540     // Let any language runtimes we have already created know
6541     // about the modules that loaded.
6542 
6543     // Iterate over a copy of this language runtime list in case
6544     // the language runtime ModulesDidLoad somehow causes the language
6545     // riuntime to be unloaded.
6546     LanguageRuntimeCollection language_runtimes(m_language_runtimes);
6547     for (const auto &pair: language_runtimes)
6548     {
6549         // We must check language_runtime_sp to make sure it is not
6550         // NULL as we might cache the fact that we didn't have a
6551         // language runtime for a language.
6552         LanguageRuntimeSP language_runtime_sp = pair.second;
6553         if (language_runtime_sp)
6554             language_runtime_sp->ModulesDidLoad(module_list);
6555     }
6556 
6557     LoadOperatingSystemPlugin(false);
6558 }
6559 
6560 void
6561 Process::PrintWarning (uint64_t warning_type, void *repeat_key, const char *fmt, ...)
6562 {
6563     bool print_warning = true;
6564 
6565     StreamSP stream_sp = GetTarget().GetDebugger().GetAsyncOutputStream();
6566     if (stream_sp.get() == nullptr)
6567         return;
6568     if (warning_type == eWarningsOptimization
6569         && GetWarningsOptimization() == false)
6570     {
6571         return;
6572     }
6573 
6574     if (repeat_key != nullptr)
6575     {
6576         WarningsCollection::iterator it = m_warnings_issued.find (warning_type);
6577         if (it == m_warnings_issued.end())
6578         {
6579             m_warnings_issued[warning_type] = WarningsPointerSet();
6580             m_warnings_issued[warning_type].insert (repeat_key);
6581         }
6582         else
6583         {
6584             if (it->second.find (repeat_key) != it->second.end())
6585             {
6586                 print_warning = false;
6587             }
6588             else
6589             {
6590                 it->second.insert (repeat_key);
6591             }
6592         }
6593     }
6594 
6595     if (print_warning)
6596     {
6597         va_list args;
6598         va_start (args, fmt);
6599         stream_sp->PrintfVarArg (fmt, args);
6600         va_end (args);
6601     }
6602 }
6603 
6604 void
6605 Process::PrintWarningOptimization (const SymbolContext &sc)
6606 {
6607     if (GetWarningsOptimization() == true
6608         && sc.module_sp.get()
6609         && sc.module_sp->GetFileSpec().GetFilename().IsEmpty() == false
6610         && sc.function
6611         && sc.function->GetIsOptimized() == true)
6612     {
6613         PrintWarning (Process::Warnings::eWarningsOptimization, sc.module_sp.get(), "%s was compiled with optimization - stepping may behave oddly; variables may not be available.\n", sc.module_sp->GetFileSpec().GetFilename().GetCString());
6614     }
6615 }
6616 
6617 ThreadCollectionSP
6618 Process::GetHistoryThreads(lldb::addr_t addr)
6619 {
6620     ThreadCollectionSP threads;
6621 
6622     const MemoryHistorySP &memory_history = MemoryHistory::FindPlugin(shared_from_this());
6623 
6624     if (! memory_history.get()) {
6625         return threads;
6626     }
6627 
6628     threads.reset(new ThreadCollection(memory_history->GetHistoryThreads(addr)));
6629 
6630     return threads;
6631 }
6632 
6633 InstrumentationRuntimeSP
6634 Process::GetInstrumentationRuntime(lldb::InstrumentationRuntimeType type)
6635 {
6636     InstrumentationRuntimeCollection::iterator pos;
6637     pos = m_instrumentation_runtimes.find (type);
6638     if (pos == m_instrumentation_runtimes.end())
6639     {
6640         return InstrumentationRuntimeSP();
6641     }
6642     else
6643         return (*pos).second;
6644 }
6645 
6646 bool
6647 Process::GetModuleSpec(const FileSpec& module_file_spec,
6648                        const ArchSpec& arch,
6649                        ModuleSpec& module_spec)
6650 {
6651     module_spec.Clear();
6652     return false;
6653 }
6654