1 //===-- Process.cpp ---------------------------------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
15 // Other libraries and framework includes
17 #include "Plugins/Process/Utility/InferiorCallPOSIX.h"
18 #include "lldb/Breakpoint/BreakpointLocation.h"
19 #include "lldb/Breakpoint/StoppointCallbackContext.h"
20 #include "lldb/Core/Debugger.h"
21 #include "lldb/Core/Event.h"
22 #include "lldb/Core/Log.h"
23 #include "lldb/Core/Module.h"
24 #include "lldb/Core/ModuleSpec.h"
25 #include "lldb/Core/PluginManager.h"
26 #include "lldb/Core/State.h"
27 #include "lldb/Core/StreamFile.h"
28 #include "lldb/Expression/DiagnosticManager.h"
29 #include "lldb/Expression/IRDynamicChecks.h"
30 #include "lldb/Expression/UserExpression.h"
31 #include "lldb/Host/ConnectionFileDescriptor.h"
32 #include "lldb/Host/FileSystem.h"
33 #include "lldb/Host/Host.h"
34 #include "lldb/Host/HostInfo.h"
35 #include "lldb/Host/Pipe.h"
36 #include "lldb/Host/Terminal.h"
37 #include "lldb/Host/ThreadLauncher.h"
38 #include "lldb/Interpreter/CommandInterpreter.h"
39 #include "lldb/Interpreter/OptionValueProperties.h"
40 #include "lldb/Symbol/Function.h"
41 #include "lldb/Symbol/Symbol.h"
42 #include "lldb/Target/ABI.h"
43 #include "lldb/Target/CPPLanguageRuntime.h"
44 #include "lldb/Target/DynamicLoader.h"
45 #include "lldb/Target/InstrumentationRuntime.h"
46 #include "lldb/Target/JITLoader.h"
47 #include "lldb/Target/JITLoaderList.h"
48 #include "lldb/Target/LanguageRuntime.h"
49 #include "lldb/Target/MemoryHistory.h"
50 #include "lldb/Target/MemoryRegionInfo.h"
51 #include "lldb/Target/ObjCLanguageRuntime.h"
52 #include "lldb/Target/OperatingSystem.h"
53 #include "lldb/Target/Platform.h"
54 #include "lldb/Target/Process.h"
55 #include "lldb/Target/RegisterContext.h"
56 #include "lldb/Target/StopInfo.h"
57 #include "lldb/Target/SystemRuntime.h"
58 #include "lldb/Target/Target.h"
59 #include "lldb/Target/TargetList.h"
60 #include "lldb/Target/Thread.h"
61 #include "lldb/Target/ThreadPlan.h"
62 #include "lldb/Target/ThreadPlanBase.h"
63 #include "lldb/Target/UnixSignals.h"
64 #include "lldb/Utility/NameMatches.h"
67 using namespace lldb_private;
69 // Comment out line below to disable memory caching, overriding the process setting
70 // target.process.disable-memory-cache
71 #define ENABLE_MEMORY_CACHING
73 #ifdef ENABLE_MEMORY_CACHING
74 #define DISABLE_MEM_CACHE_DEFAULT false
76 #define DISABLE_MEM_CACHE_DEFAULT true
79 class ProcessOptionValueProperties : public OptionValueProperties
82 ProcessOptionValueProperties (const ConstString &name) :
83 OptionValueProperties (name)
87 // This constructor is used when creating ProcessOptionValueProperties when it
88 // is part of a new lldb_private::Process instance. It will copy all current
89 // global property values as needed
90 ProcessOptionValueProperties (ProcessProperties *global_properties) :
91 OptionValueProperties(*global_properties->GetValueProperties())
96 GetPropertyAtIndex(const ExecutionContext *exe_ctx, bool will_modify, uint32_t idx) const override
98 // When getting the value for a key from the process options, we will always
99 // try and grab the setting from the current process if there is one. Else we just
100 // use the one from this instance.
103 Process *process = exe_ctx->GetProcessPtr();
106 ProcessOptionValueProperties *instance_properties = static_cast<ProcessOptionValueProperties *>(process->GetValueProperties().get());
107 if (this != instance_properties)
108 return instance_properties->ProtectedGetPropertyAtIndex (idx);
111 return ProtectedGetPropertyAtIndex (idx);
115 static PropertyDefinition
118 { "disable-memory-cache" , OptionValue::eTypeBoolean, false, DISABLE_MEM_CACHE_DEFAULT, nullptr, nullptr, "Disable reading and caching of memory in fixed-size units." },
119 { "extra-startup-command", OptionValue::eTypeArray , false, OptionValue::eTypeString, nullptr, nullptr, "A list containing extra commands understood by the particular process plugin used. "
120 "For instance, to turn on debugserver logging set this to \"QSetLogging:bitmask=LOG_DEFAULT;\"" },
121 { "ignore-breakpoints-in-expressions", OptionValue::eTypeBoolean, true, true, nullptr, nullptr, "If true, breakpoints will be ignored during expression evaluation." },
122 { "unwind-on-error-in-expressions", OptionValue::eTypeBoolean, true, true, nullptr, nullptr, "If true, errors in expression evaluation will unwind the stack back to the state before the call." },
123 { "python-os-plugin-path", OptionValue::eTypeFileSpec, false, true, nullptr, nullptr, "A path to a python OS plug-in module file that contains a OperatingSystemPlugIn class." },
124 { "stop-on-sharedlibrary-events" , OptionValue::eTypeBoolean, true, false, nullptr, nullptr, "If true, stop when a shared library is loaded or unloaded." },
125 { "detach-keeps-stopped" , OptionValue::eTypeBoolean, true, false, nullptr, nullptr, "If true, detach will attempt to keep the process stopped." },
126 { "memory-cache-line-size" , OptionValue::eTypeUInt64, false, 512, nullptr, nullptr, "The memory cache line size" },
127 { "optimization-warnings" , OptionValue::eTypeBoolean, false, true, nullptr, nullptr, "If true, warn when stopped in code that is optimized where stepping and variable availability may not behave as expected." },
128 { nullptr , OptionValue::eTypeInvalid, false, 0, nullptr, nullptr, nullptr }
132 ePropertyDisableMemCache,
133 ePropertyExtraStartCommand,
134 ePropertyIgnoreBreakpointsInExpressions,
135 ePropertyUnwindOnErrorInExpressions,
136 ePropertyPythonOSPluginPath,
137 ePropertyStopOnSharedLibraryEvents,
138 ePropertyDetachKeepsStopped,
139 ePropertyMemCacheLineSize,
140 ePropertyWarningOptimization
143 ProcessProperties::ProcessProperties (lldb_private::Process *process) :
145 m_process(process) // Can be nullptr for global ProcessProperties
147 if (process == nullptr)
149 // Global process properties, set them up one time
150 m_collection_sp.reset (new ProcessOptionValueProperties(ConstString("process")));
151 m_collection_sp->Initialize(g_properties);
152 m_collection_sp->AppendProperty(ConstString("thread"),
153 ConstString("Settings specific to threads."),
155 Thread::GetGlobalProperties()->GetValueProperties());
159 m_collection_sp.reset (new ProcessOptionValueProperties(Process::GetGlobalProperties().get()));
160 m_collection_sp->SetValueChangedCallback(ePropertyPythonOSPluginPath, ProcessProperties::OptionValueChangedCallback, this);
164 ProcessProperties::~ProcessProperties() = default;
167 ProcessProperties::OptionValueChangedCallback (void *baton, OptionValue *option_value)
169 ProcessProperties *properties = (ProcessProperties *)baton;
170 if (properties->m_process)
171 properties->m_process->LoadOperatingSystemPlugin(true);
175 ProcessProperties::GetDisableMemoryCache() const
177 const uint32_t idx = ePropertyDisableMemCache;
178 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, g_properties[idx].default_uint_value != 0);
182 ProcessProperties::GetMemoryCacheLineSize() const
184 const uint32_t idx = ePropertyMemCacheLineSize;
185 return m_collection_sp->GetPropertyAtIndexAsUInt64(nullptr, idx, g_properties[idx].default_uint_value);
189 ProcessProperties::GetExtraStartupCommands () const
192 const uint32_t idx = ePropertyExtraStartCommand;
193 m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, args);
198 ProcessProperties::SetExtraStartupCommands (const Args &args)
200 const uint32_t idx = ePropertyExtraStartCommand;
201 m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, args);
205 ProcessProperties::GetPythonOSPluginPath () const
207 const uint32_t idx = ePropertyPythonOSPluginPath;
208 return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx);
212 ProcessProperties::SetPythonOSPluginPath (const FileSpec &file)
214 const uint32_t idx = ePropertyPythonOSPluginPath;
215 m_collection_sp->SetPropertyAtIndexAsFileSpec(nullptr, idx, file);
219 ProcessProperties::GetIgnoreBreakpointsInExpressions () const
221 const uint32_t idx = ePropertyIgnoreBreakpointsInExpressions;
222 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, g_properties[idx].default_uint_value != 0);
226 ProcessProperties::SetIgnoreBreakpointsInExpressions (bool ignore)
228 const uint32_t idx = ePropertyIgnoreBreakpointsInExpressions;
229 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, ignore);
233 ProcessProperties::GetUnwindOnErrorInExpressions () const
235 const uint32_t idx = ePropertyUnwindOnErrorInExpressions;
236 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, g_properties[idx].default_uint_value != 0);
240 ProcessProperties::SetUnwindOnErrorInExpressions (bool ignore)
242 const uint32_t idx = ePropertyUnwindOnErrorInExpressions;
243 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, ignore);
247 ProcessProperties::GetStopOnSharedLibraryEvents () const
249 const uint32_t idx = ePropertyStopOnSharedLibraryEvents;
250 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, g_properties[idx].default_uint_value != 0);
254 ProcessProperties::SetStopOnSharedLibraryEvents (bool stop)
256 const uint32_t idx = ePropertyStopOnSharedLibraryEvents;
257 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, stop);
261 ProcessProperties::GetDetachKeepsStopped () const
263 const uint32_t idx = ePropertyDetachKeepsStopped;
264 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, g_properties[idx].default_uint_value != 0);
268 ProcessProperties::SetDetachKeepsStopped (bool stop)
270 const uint32_t idx = ePropertyDetachKeepsStopped;
271 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, stop);
275 ProcessProperties::GetWarningsOptimization () const
277 const uint32_t idx = ePropertyWarningOptimization;
278 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, g_properties[idx].default_uint_value != 0);
282 ProcessInstanceInfo::Dump (Stream &s, Platform *platform) const
285 if (m_pid != LLDB_INVALID_PROCESS_ID)
286 s.Printf (" pid = %" PRIu64 "\n", m_pid);
288 if (m_parent_pid != LLDB_INVALID_PROCESS_ID)
289 s.Printf (" parent = %" PRIu64 "\n", m_parent_pid);
293 s.Printf (" name = %s\n", m_executable.GetFilename().GetCString());
294 s.PutCString (" file = ");
295 m_executable.Dump(&s);
298 const uint32_t argc = m_arguments.GetArgumentCount();
301 for (uint32_t i = 0; i < argc; i++)
303 const char *arg = m_arguments.GetArgumentAtIndex(i);
305 s.Printf (" arg[%u] = %s\n", i, arg);
307 s.Printf ("arg[%u] = %s\n", i, arg);
311 const uint32_t envc = m_environment.GetArgumentCount();
314 for (uint32_t i = 0; i < envc; i++)
316 const char *env = m_environment.GetArgumentAtIndex(i);
318 s.Printf (" env[%u] = %s\n", i, env);
320 s.Printf ("env[%u] = %s\n", i, env);
324 if (m_arch.IsValid())
326 s.Printf (" arch = ");
327 m_arch.DumpTriple(s);
331 if (m_uid != UINT32_MAX)
333 cstr = platform->GetUserName (m_uid);
334 s.Printf (" uid = %-5u (%s)\n", m_uid, cstr ? cstr : "");
336 if (m_gid != UINT32_MAX)
338 cstr = platform->GetGroupName (m_gid);
339 s.Printf (" gid = %-5u (%s)\n", m_gid, cstr ? cstr : "");
341 if (m_euid != UINT32_MAX)
343 cstr = platform->GetUserName (m_euid);
344 s.Printf (" euid = %-5u (%s)\n", m_euid, cstr ? cstr : "");
346 if (m_egid != UINT32_MAX)
348 cstr = platform->GetGroupName (m_egid);
349 s.Printf (" egid = %-5u (%s)\n", m_egid, cstr ? cstr : "");
354 ProcessInstanceInfo::DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose)
357 if (show_args || verbose)
364 s.Printf ("PID PARENT USER GROUP EFF USER EFF GROUP TRIPLE %s\n", label);
365 s.PutCString ("====== ====== ========== ========== ========== ========== ======================== ============================\n");
369 s.Printf ("PID PARENT USER TRIPLE %s\n", label);
370 s.PutCString ("====== ====== ========== ======================== ============================\n");
375 ProcessInstanceInfo::DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const
377 if (m_pid != LLDB_INVALID_PROCESS_ID)
380 s.Printf ("%-6" PRIu64 " %-6" PRIu64 " ", m_pid, m_parent_pid);
382 StreamString arch_strm;
383 if (m_arch.IsValid())
384 m_arch.DumpTriple(arch_strm);
388 cstr = platform->GetUserName (m_uid);
389 if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
390 s.Printf ("%-10s ", cstr);
392 s.Printf ("%-10u ", m_uid);
394 cstr = platform->GetGroupName (m_gid);
395 if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
396 s.Printf ("%-10s ", cstr);
398 s.Printf ("%-10u ", m_gid);
400 cstr = platform->GetUserName (m_euid);
401 if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
402 s.Printf ("%-10s ", cstr);
404 s.Printf ("%-10u ", m_euid);
406 cstr = platform->GetGroupName (m_egid);
407 if (cstr && cstr[0]) // Watch for empty string that indicates lookup failed
408 s.Printf ("%-10s ", cstr);
410 s.Printf ("%-10u ", m_egid);
412 s.Printf ("%-24s ", arch_strm.GetString().c_str());
416 s.Printf ("%-10s %-24s ",
417 platform->GetUserName (m_euid),
418 arch_strm.GetString().c_str());
421 if (verbose || show_args)
423 const uint32_t argc = m_arguments.GetArgumentCount();
426 for (uint32_t i = 0; i < argc; i++)
430 s.PutCString (m_arguments.GetArgumentAtIndex(i));
436 s.PutCString (GetName());
444 ProcessLaunchCommandOptions::SetOptionValue (uint32_t option_idx, const char *option_arg)
447 const int short_option = m_getopt_table[option_idx].val;
449 switch (short_option)
451 case 's': // Stop at program entry point
452 launch_info.GetFlags().Set (eLaunchFlagStopAtEntry);
455 case 'i': // STDIN for read only
458 if (action.Open(STDIN_FILENO, FileSpec{option_arg, false}, true, false))
459 launch_info.AppendFileAction (action);
463 case 'o': // Open STDOUT for write only
466 if (action.Open(STDOUT_FILENO, FileSpec{option_arg, false}, false, true))
467 launch_info.AppendFileAction (action);
471 case 'e': // STDERR for write only
474 if (action.Open(STDERR_FILENO, FileSpec{option_arg, false}, false, true))
475 launch_info.AppendFileAction (action);
479 case 'p': // Process plug-in name
480 launch_info.SetProcessPluginName (option_arg);
483 case 'n': // Disable STDIO
486 const FileSpec dev_null{FileSystem::DEV_NULL, false};
487 if (action.Open(STDIN_FILENO, dev_null, true, false))
488 launch_info.AppendFileAction (action);
489 if (action.Open(STDOUT_FILENO, dev_null, false, true))
490 launch_info.AppendFileAction (action);
491 if (action.Open(STDERR_FILENO, dev_null, false, true))
492 launch_info.AppendFileAction (action);
497 launch_info.SetWorkingDirectory(FileSpec{option_arg, false});
500 case 't': // Open process in new terminal window
501 launch_info.GetFlags().Set (eLaunchFlagLaunchInTTY);
505 if (!launch_info.GetArchitecture().SetTriple (option_arg, m_interpreter.GetPlatform(true).get()))
506 launch_info.GetArchitecture().SetTriple (option_arg);
509 case 'A': // Disable ASLR.
512 const bool disable_aslr_arg = Args::StringToBoolean (option_arg, true, &success);
514 disable_aslr = disable_aslr_arg ? eLazyBoolYes : eLazyBoolNo;
516 error.SetErrorStringWithFormat ("Invalid boolean value for disable-aslr option: '%s'", option_arg ? option_arg : "<null>");
520 case 'X': // shell expand args.
523 const bool expand_args = Args::StringToBoolean (option_arg, true, &success);
525 launch_info.SetShellExpandArguments(expand_args);
527 error.SetErrorStringWithFormat ("Invalid boolean value for shell-expand-args option: '%s'", option_arg ? option_arg : "<null>");
532 if (option_arg && option_arg[0])
533 launch_info.SetShell (FileSpec(option_arg, false));
535 launch_info.SetShell (HostInfo::GetDefaultShell());
539 launch_info.GetEnvironmentEntries().AppendArgument(option_arg);
543 error.SetErrorStringWithFormat("unrecognized short option character '%c'", short_option);
550 ProcessLaunchCommandOptions::g_option_table[] =
552 { LLDB_OPT_SET_ALL, false, "stop-at-entry", 's', OptionParser::eNoArgument, nullptr, nullptr, 0, eArgTypeNone, "Stop at the entry point of the program when launching a process." },
553 { LLDB_OPT_SET_ALL, false, "disable-aslr", 'A', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeBoolean, "Set whether to disable address space layout randomization when launching a process." },
554 { LLDB_OPT_SET_ALL, false, "plugin", 'p', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypePlugin, "Name of the process plugin you want to use." },
555 { LLDB_OPT_SET_ALL, false, "working-dir", 'w', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeDirectoryName, "Set the current working directory to <path> when running the inferior." },
556 { LLDB_OPT_SET_ALL, false, "arch", 'a', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeArchitecture, "Set the architecture for the process to launch when ambiguous." },
557 { LLDB_OPT_SET_ALL, false, "environment", 'v', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeNone, "Specify an environment variable name/value string (--environment NAME=VALUE). Can be specified multiple times for subsequent environment entries." },
558 { LLDB_OPT_SET_1|LLDB_OPT_SET_2|LLDB_OPT_SET_3, false, "shell", 'c', OptionParser::eOptionalArgument, nullptr, nullptr, 0, eArgTypeFilename, "Run the process in a shell (not supported on all platforms)." },
560 { LLDB_OPT_SET_1 , false, "stdin", 'i', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeFilename, "Redirect stdin for the process to <filename>." },
561 { LLDB_OPT_SET_1 , false, "stdout", 'o', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeFilename, "Redirect stdout for the process to <filename>." },
562 { LLDB_OPT_SET_1 , false, "stderr", 'e', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeFilename, "Redirect stderr for the process to <filename>." },
564 { LLDB_OPT_SET_2 , false, "tty", 't', OptionParser::eNoArgument, nullptr, nullptr, 0, eArgTypeNone, "Start the process in a terminal (not supported on all platforms)." },
566 { LLDB_OPT_SET_3 , false, "no-stdio", 'n', OptionParser::eNoArgument, nullptr, nullptr, 0, eArgTypeNone, "Do not set up for terminal I/O to go to running process." },
567 { LLDB_OPT_SET_4, false, "shell-expand-args", 'X', OptionParser::eRequiredArgument, nullptr, nullptr, 0, eArgTypeBoolean, "Set whether to shell expand arguments to the process when launching." },
568 { 0 , false, nullptr, 0, 0, nullptr, nullptr, 0, eArgTypeNone, nullptr }
572 ProcessInstanceInfoMatch::NameMatches (const char *process_name) const
574 if (m_name_match_type == eNameMatchIgnore || process_name == nullptr)
576 const char *match_name = m_match_info.GetName();
580 return lldb_private::NameMatches (process_name, m_name_match_type, match_name);
584 ProcessInstanceInfoMatch::Matches (const ProcessInstanceInfo &proc_info) const
586 if (!NameMatches (proc_info.GetName()))
589 if (m_match_info.ProcessIDIsValid() &&
590 m_match_info.GetProcessID() != proc_info.GetProcessID())
593 if (m_match_info.ParentProcessIDIsValid() &&
594 m_match_info.GetParentProcessID() != proc_info.GetParentProcessID())
597 if (m_match_info.UserIDIsValid () &&
598 m_match_info.GetUserID() != proc_info.GetUserID())
601 if (m_match_info.GroupIDIsValid () &&
602 m_match_info.GetGroupID() != proc_info.GetGroupID())
605 if (m_match_info.EffectiveUserIDIsValid () &&
606 m_match_info.GetEffectiveUserID() != proc_info.GetEffectiveUserID())
609 if (m_match_info.EffectiveGroupIDIsValid () &&
610 m_match_info.GetEffectiveGroupID() != proc_info.GetEffectiveGroupID())
613 if (m_match_info.GetArchitecture().IsValid() &&
614 !m_match_info.GetArchitecture().IsCompatibleMatch(proc_info.GetArchitecture()))
620 ProcessInstanceInfoMatch::MatchAllProcesses () const
622 if (m_name_match_type != eNameMatchIgnore)
625 if (m_match_info.ProcessIDIsValid())
628 if (m_match_info.ParentProcessIDIsValid())
631 if (m_match_info.UserIDIsValid ())
634 if (m_match_info.GroupIDIsValid ())
637 if (m_match_info.EffectiveUserIDIsValid ())
640 if (m_match_info.EffectiveGroupIDIsValid ())
643 if (m_match_info.GetArchitecture().IsValid())
646 if (m_match_all_users)
653 ProcessInstanceInfoMatch::Clear()
655 m_match_info.Clear();
656 m_name_match_type = eNameMatchIgnore;
657 m_match_all_users = false;
661 Process::FindPlugin (lldb::TargetSP target_sp, const char *plugin_name, ListenerSP listener_sp, const FileSpec *crash_file_path)
663 static uint32_t g_process_unique_id = 0;
665 ProcessSP process_sp;
666 ProcessCreateInstance create_callback = nullptr;
669 ConstString const_plugin_name(plugin_name);
670 create_callback = PluginManager::GetProcessCreateCallbackForPluginName (const_plugin_name);
673 process_sp = create_callback(target_sp, listener_sp, crash_file_path);
676 if (process_sp->CanDebug(target_sp, true))
678 process_sp->m_process_unique_id = ++g_process_unique_id;
687 for (uint32_t idx = 0; (create_callback = PluginManager::GetProcessCreateCallbackAtIndex(idx)) != nullptr; ++idx)
689 process_sp = create_callback(target_sp, listener_sp, crash_file_path);
692 if (process_sp->CanDebug(target_sp, false))
694 process_sp->m_process_unique_id = ++g_process_unique_id;
706 Process::GetStaticBroadcasterClass ()
708 static ConstString class_name ("lldb.process");
712 Process::Process(lldb::TargetSP target_sp, ListenerSP listener_sp) :
713 Process(target_sp, listener_sp, UnixSignals::Create(HostInfo::GetArchitecture()))
715 // This constructor just delegates to the full Process constructor,
716 // defaulting to using the Host's UnixSignals.
719 Process::Process(lldb::TargetSP target_sp, ListenerSP listener_sp, const UnixSignalsSP &unix_signals_sp)
720 : ProcessProperties(this),
721 UserID(LLDB_INVALID_PROCESS_ID),
722 Broadcaster((target_sp->GetDebugger().GetBroadcasterManager()), Process::GetStaticBroadcasterClass().AsCString()),
723 m_target_sp(target_sp),
724 m_public_state(eStateUnloaded),
725 m_private_state(eStateUnloaded),
726 m_private_state_broadcaster(nullptr, "lldb.process.internal_state_broadcaster"),
727 m_private_state_control_broadcaster(nullptr, "lldb.process.internal_state_control_broadcaster"),
728 m_private_state_listener_sp(Listener::MakeListener("lldb.process.internal_state_listener")),
730 m_process_unique_id(0),
731 m_thread_index_id(0),
732 m_thread_id_to_index_id_map(),
735 m_exit_status_mutex(),
737 m_thread_list_real(this),
739 m_extended_thread_list(this),
740 m_extended_thread_stop_id(0),
742 m_queue_list_stop_id(0),
745 m_listener_sp(listener_sp),
746 m_breakpoint_site_list(),
747 m_dynamic_checkers_ap(),
748 m_unix_signals_sp(unix_signals_sp),
750 m_process_input_reader(),
751 m_stdio_communication("process.stdio"),
752 m_stdio_communication_mutex(),
753 m_stdin_forward(false),
756 m_profile_data_comm_mutex(),
759 m_memory_cache(*this),
760 m_allocated_memory_cache(*this),
761 m_should_detach(false),
762 m_next_event_action_ap(),
764 m_private_run_lock(),
765 m_stop_info_override_callback(nullptr),
767 m_finalize_called(false),
768 m_clear_thread_plans_on_stop(false),
769 m_force_next_event_delivery(false),
770 m_last_broadcast_state(eStateInvalid),
771 m_destroy_in_process(false),
772 m_can_interpret_function_calls(false),
774 m_run_thread_plan_lock(),
775 m_can_jit(eCanJITDontKnow)
777 CheckInWithManager();
779 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
781 log->Printf("%p Process::Process()", static_cast<void *>(this));
783 if (!m_unix_signals_sp)
784 m_unix_signals_sp = std::make_shared<UnixSignals>();
786 SetEventName(eBroadcastBitStateChanged, "state-changed");
787 SetEventName(eBroadcastBitInterrupt, "interrupt");
788 SetEventName(eBroadcastBitSTDOUT, "stdout-available");
789 SetEventName(eBroadcastBitSTDERR, "stderr-available");
790 SetEventName(eBroadcastBitProfileData, "profile-data-available");
792 m_private_state_control_broadcaster.SetEventName(eBroadcastInternalStateControlStop, "control-stop");
793 m_private_state_control_broadcaster.SetEventName(eBroadcastInternalStateControlPause, "control-pause");
794 m_private_state_control_broadcaster.SetEventName(eBroadcastInternalStateControlResume, "control-resume");
796 m_listener_sp->StartListeningForEvents(this, eBroadcastBitStateChanged | eBroadcastBitInterrupt |
797 eBroadcastBitSTDOUT | eBroadcastBitSTDERR |
798 eBroadcastBitProfileData);
800 m_private_state_listener_sp->StartListeningForEvents(&m_private_state_broadcaster,
801 eBroadcastBitStateChanged | eBroadcastBitInterrupt);
803 m_private_state_listener_sp->StartListeningForEvents(
804 &m_private_state_control_broadcaster, eBroadcastInternalStateControlStop | eBroadcastInternalStateControlPause |
805 eBroadcastInternalStateControlResume);
806 // We need something valid here, even if just the default UnixSignalsSP.
807 assert(m_unix_signals_sp && "null m_unix_signals_sp after initialization");
809 // Allow the platform to override the default cache line size
810 OptionValueSP value_sp = m_collection_sp->GetPropertyAtIndex(nullptr, true, ePropertyMemCacheLineSize)->GetValue();
811 uint32_t platform_cache_line_size = target_sp->GetPlatform()->GetDefaultMemoryCacheLineSize();
812 if (!value_sp->OptionWasSet() && platform_cache_line_size != 0)
813 value_sp->SetUInt64Value(platform_cache_line_size);
818 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
820 log->Printf ("%p Process::~Process()", static_cast<void*>(this));
821 StopPrivateStateThread();
823 // ThreadList::Clear() will try to acquire this process's mutex, so
824 // explicitly clear the thread list here to ensure that the mutex
825 // is not destroyed before the thread list.
826 m_thread_list.Clear();
829 const ProcessPropertiesSP &
830 Process::GetGlobalProperties()
832 // NOTE: intentional leak so we don't crash if global destructor chain gets
833 // called as other threads still use the result of this function
834 static ProcessPropertiesSP *g_settings_sp_ptr = nullptr;
835 static std::once_flag g_once_flag;
836 std::call_once(g_once_flag, []() {
837 g_settings_sp_ptr = new ProcessPropertiesSP(new ProcessProperties(nullptr));
839 return *g_settings_sp_ptr;
847 // Destroy this process if needed
848 switch (GetPrivateState())
850 case eStateConnected:
851 case eStateAttaching:
852 case eStateLaunching:
857 case eStateSuspended:
868 // Clear our broadcaster before we proceed with destroying
869 Broadcaster::Clear();
871 // Do any cleanup needed prior to being destructed... Subclasses
872 // that override this method should call this superclass method as well.
874 // We need to destroy the loader before the derived Process class gets destroyed
875 // since it is very likely that undoing the loader will require access to the real process.
876 m_dynamic_checkers_ap.reset();
879 m_system_runtime_ap.reset();
881 m_jit_loaders_ap.reset();
882 m_thread_list_real.Destroy();
883 m_thread_list.Destroy();
884 m_extended_thread_list.Destroy();
885 m_queue_list.Clear();
886 m_queue_list_stop_id = 0;
887 std::vector<Notifications> empty_notifications;
888 m_notifications.swap(empty_notifications);
889 m_image_tokens.clear();
890 m_memory_cache.Clear();
891 m_allocated_memory_cache.Clear();
892 m_language_runtimes.clear();
893 m_instrumentation_runtimes.clear();
894 m_next_event_action_ap.reset();
895 m_stop_info_override_callback = nullptr;
896 // Clear the last natural stop ID since it has a strong
897 // reference to this process
898 m_mod_id.SetStopEventForLastNaturalStopID(EventSP());
899 //#ifdef LLDB_CONFIGURATION_DEBUG
900 // StreamFile s(stdout, false);
902 // while (m_private_state_listener_sp->GetNextEvent(event_sp))
904 // event_sp->Dump (&s);
908 // We have to be very careful here as the m_private_state_listener might
909 // contain events that have ProcessSP values in them which can keep this
910 // process around forever. These events need to be cleared out.
911 m_private_state_listener_sp->Clear();
912 m_public_run_lock.TrySetRunning(); // This will do nothing if already locked
913 m_public_run_lock.SetStopped();
914 m_private_run_lock.TrySetRunning(); // This will do nothing if already locked
915 m_private_run_lock.SetStopped();
916 m_finalize_called = true;
920 Process::RegisterNotificationCallbacks (const Notifications& callbacks)
922 m_notifications.push_back(callbacks);
923 if (callbacks.initialize != nullptr)
924 callbacks.initialize (callbacks.baton, this);
928 Process::UnregisterNotificationCallbacks(const Notifications& callbacks)
930 std::vector<Notifications>::iterator pos, end = m_notifications.end();
931 for (pos = m_notifications.begin(); pos != end; ++pos)
933 if (pos->baton == callbacks.baton &&
934 pos->initialize == callbacks.initialize &&
935 pos->process_state_changed == callbacks.process_state_changed)
937 m_notifications.erase(pos);
945 Process::SynchronouslyNotifyStateChanged (StateType state)
947 std::vector<Notifications>::iterator notification_pos, notification_end = m_notifications.end();
948 for (notification_pos = m_notifications.begin(); notification_pos != notification_end; ++notification_pos)
950 if (notification_pos->process_state_changed)
951 notification_pos->process_state_changed (notification_pos->baton, this, state);
955 // FIXME: We need to do some work on events before the general Listener sees them.
956 // For instance if we are continuing from a breakpoint, we need to ensure that we do
957 // the little "insert real insn, step & stop" trick. But we can't do that when the
958 // event is delivered by the broadcaster - since that is done on the thread that is
959 // waiting for new events, so if we needed more than one event for our handling, we would
960 // stall. So instead we do it when we fetch the event off of the queue.
964 Process::GetNextEvent (EventSP &event_sp)
966 StateType state = eStateInvalid;
968 if (m_listener_sp->GetNextEventForBroadcaster (this, event_sp) && event_sp)
969 state = Process::ProcessEventData::GetStateFromEvent (event_sp.get());
975 Process::SyncIOHandler (uint32_t iohandler_id, uint64_t timeout_msec)
977 // don't sync (potentially context switch) in case where there is no process IO
978 if (!m_process_input_reader)
981 TimeValue timeout = TimeValue::Now();
982 timeout.OffsetWithMicroSeconds(timeout_msec*1000);
983 uint32_t new_iohandler_id = 0;
984 m_iohandler_sync.WaitForValueNotEqualTo(iohandler_id, new_iohandler_id, &timeout);
986 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
988 log->Printf("Process::%s waited for m_iohandler_sync to change from %u, new value is %u", __FUNCTION__, iohandler_id, new_iohandler_id);
992 Process::WaitForProcessToStop (const TimeValue *timeout,
993 EventSP *event_sp_ptr,
995 ListenerSP hijack_listener_sp,
999 // We can't just wait for a "stopped" event, because the stopped event may have restarted the target.
1000 // We have to actually check each event, and in the case of a stopped event check the restarted flag
1003 event_sp_ptr->reset();
1004 StateType state = GetState();
1005 // If we are exited or detached, we won't ever get back to any
1006 // other valid state...
1007 if (state == eStateDetached || state == eStateExited)
1010 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1012 log->Printf ("Process::%s (timeout = %p)", __FUNCTION__,
1013 static_cast<const void*>(timeout));
1016 StateIsStoppedState(state, true) &&
1017 StateIsStoppedState(GetPrivateState(), true))
1020 log->Printf("Process::%s returning without waiting for events; process private and public states are already 'stopped'.",
1022 // We need to toggle the run lock as this won't get done in
1023 // SetPublicState() if the process is hijacked.
1024 if (hijack_listener_sp && use_run_lock)
1025 m_public_run_lock.SetStopped();
1029 while (state != eStateInvalid)
1032 state = WaitForStateChangedEvents (timeout, event_sp, hijack_listener_sp);
1033 if (event_sp_ptr && event_sp)
1034 *event_sp_ptr = event_sp;
1036 bool pop_process_io_handler = (hijack_listener_sp.get() != nullptr);
1037 Process::HandleProcessStateChangedEvent (event_sp, stream, pop_process_io_handler);
1042 case eStateDetached:
1044 case eStateUnloaded:
1045 // We need to toggle the run lock as this won't get done in
1046 // SetPublicState() if the process is hijacked.
1047 if (hijack_listener_sp && use_run_lock)
1048 m_public_run_lock.SetStopped();
1051 if (Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
1055 // We need to toggle the run lock as this won't get done in
1056 // SetPublicState() if the process is hijacked.
1057 if (hijack_listener_sp && use_run_lock)
1058 m_public_run_lock.SetStopped();
1069 Process::HandleProcessStateChangedEvent (const EventSP &event_sp,
1071 bool &pop_process_io_handler)
1073 const bool handle_pop = pop_process_io_handler;
1075 pop_process_io_handler = false;
1076 ProcessSP process_sp = Process::ProcessEventData::GetProcessFromEvent(event_sp.get());
1081 StateType event_state = Process::ProcessEventData::GetStateFromEvent (event_sp.get());
1082 if (event_state == eStateInvalid)
1085 switch (event_state)
1088 case eStateUnloaded:
1089 case eStateAttaching:
1090 case eStateLaunching:
1091 case eStateStepping:
1092 case eStateDetached:
1094 stream->Printf("Process %" PRIu64 " %s\n",
1095 process_sp->GetID(),
1096 StateAsCString (event_state));
1097 if (event_state == eStateDetached)
1098 pop_process_io_handler = true;
1101 case eStateConnected:
1103 // Don't be chatty when we run...
1108 process_sp->GetStatus(*stream);
1109 pop_process_io_handler = true;
1114 case eStateSuspended:
1115 // Make sure the program hasn't been auto-restarted:
1116 if (Process::ProcessEventData::GetRestartedFromEvent (event_sp.get()))
1120 size_t num_reasons = Process::ProcessEventData::GetNumRestartedReasons(event_sp.get());
1121 if (num_reasons > 0)
1123 // FIXME: Do we want to report this, or would that just be annoyingly chatty?
1124 if (num_reasons == 1)
1126 const char *reason = Process::ProcessEventData::GetRestartedReasonAtIndex (event_sp.get(), 0);
1127 stream->Printf ("Process %" PRIu64 " stopped and restarted: %s\n",
1128 process_sp->GetID(),
1129 reason ? reason : "<UNKNOWN REASON>");
1133 stream->Printf ("Process %" PRIu64 " stopped and restarted, reasons:\n",
1134 process_sp->GetID());
1137 for (size_t i = 0; i < num_reasons; i++)
1139 const char *reason = Process::ProcessEventData::GetRestartedReasonAtIndex (event_sp.get(), i);
1140 stream->Printf("\t%s\n", reason ? reason : "<UNKNOWN REASON>");
1148 // Lock the thread list so it doesn't change on us, this is the scope for the locker:
1150 ThreadList &thread_list = process_sp->GetThreadList();
1151 std::lock_guard<std::recursive_mutex> guard(thread_list.GetMutex());
1153 ThreadSP curr_thread (thread_list.GetSelectedThread());
1155 StopReason curr_thread_stop_reason = eStopReasonInvalid;
1157 curr_thread_stop_reason = curr_thread->GetStopReason();
1159 !curr_thread->IsValid() ||
1160 curr_thread_stop_reason == eStopReasonInvalid ||
1161 curr_thread_stop_reason == eStopReasonNone)
1163 // Prefer a thread that has just completed its plan over another thread as current thread.
1164 ThreadSP plan_thread;
1165 ThreadSP other_thread;
1167 const size_t num_threads = thread_list.GetSize();
1169 for (i = 0; i < num_threads; ++i)
1171 thread = thread_list.GetThreadAtIndex(i);
1172 StopReason thread_stop_reason = thread->GetStopReason();
1173 switch (thread_stop_reason)
1175 case eStopReasonInvalid:
1176 case eStopReasonNone:
1179 case eStopReasonSignal:
1181 // Don't select a signal thread if we weren't going to stop at that
1182 // signal. We have to have had another reason for stopping here, and
1183 // the user doesn't want to see this thread.
1184 uint64_t signo = thread->GetStopInfo()->GetValue();
1185 if (process_sp->GetUnixSignals()->GetShouldStop(signo))
1188 other_thread = thread;
1192 case eStopReasonTrace:
1193 case eStopReasonBreakpoint:
1194 case eStopReasonWatchpoint:
1195 case eStopReasonException:
1196 case eStopReasonExec:
1197 case eStopReasonThreadExiting:
1198 case eStopReasonInstrumentation:
1200 other_thread = thread;
1202 case eStopReasonPlanComplete:
1204 plan_thread = thread;
1209 thread_list.SetSelectedThreadByID (plan_thread->GetID());
1210 else if (other_thread)
1211 thread_list.SetSelectedThreadByID (other_thread->GetID());
1214 if (curr_thread && curr_thread->IsValid())
1215 thread = curr_thread;
1217 thread = thread_list.GetThreadAtIndex(0);
1220 thread_list.SetSelectedThreadByID (thread->GetID());
1224 // Drop the ThreadList mutex by here, since GetThreadStatus below might have to run code,
1225 // e.g. for Data formatters, and if we hold the ThreadList mutex, then the process is going to
1226 // have a hard time restarting the process.
1229 Debugger &debugger = process_sp->GetTarget().GetDebugger();
1230 if (debugger.GetTargetList().GetSelectedTarget().get() == &process_sp->GetTarget())
1232 const bool only_threads_with_stop_reason = true;
1233 const uint32_t start_frame = 0;
1234 const uint32_t num_frames = 1;
1235 const uint32_t num_frames_with_source = 1;
1236 process_sp->GetStatus(*stream);
1237 process_sp->GetThreadStatus (*stream,
1238 only_threads_with_stop_reason,
1241 num_frames_with_source);
1245 uint32_t target_idx = debugger.GetTargetList().GetIndexOfTarget(process_sp->GetTarget().shared_from_this());
1246 if (target_idx != UINT32_MAX)
1247 stream->Printf ("Target %d: (", target_idx);
1249 stream->Printf ("Target <unknown index>: (");
1250 process_sp->GetTarget().Dump (stream, eDescriptionLevelBrief);
1251 stream->Printf (") stopped.\n");
1255 // Pop the process IO handler
1256 pop_process_io_handler = true;
1261 if (handle_pop && pop_process_io_handler)
1262 process_sp->PopProcessIOHandler();
1268 Process::WaitForState(const TimeValue *timeout,
1269 const StateType *match_states,
1270 const uint32_t num_match_states)
1273 StateType state = GetState();
1274 while (state != eStateInvalid)
1276 // If we are exited or detached, we won't ever get back to any
1277 // other valid state...
1278 if (state == eStateDetached || state == eStateExited)
1281 state = WaitForStateChangedEvents(timeout, event_sp, nullptr);
1283 for (uint32_t i = 0; i < num_match_states; ++i)
1285 if (match_states[i] == state)
1293 Process::HijackProcessEvents (ListenerSP listener_sp)
1297 return HijackBroadcaster(listener_sp, eBroadcastBitStateChanged | eBroadcastBitInterrupt);
1304 Process::RestoreProcessEvents ()
1306 RestoreBroadcaster();
1310 Process::WaitForStateChangedEvents (const TimeValue *timeout, EventSP &event_sp, ListenerSP hijack_listener_sp)
1312 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1315 log->Printf ("Process::%s (timeout = %p, event_sp)...", __FUNCTION__,
1316 static_cast<const void*>(timeout));
1318 ListenerSP listener_sp = hijack_listener_sp;
1320 listener_sp = m_listener_sp;
1322 StateType state = eStateInvalid;
1323 if (listener_sp->WaitForEventForBroadcasterWithType (timeout,
1325 eBroadcastBitStateChanged | eBroadcastBitInterrupt,
1328 if (event_sp && event_sp->GetType() == eBroadcastBitStateChanged)
1329 state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
1331 log->Printf ("Process::%s got no event or was interrupted.", __FUNCTION__);
1335 log->Printf ("Process::%s (timeout = %p, event_sp) => %s",
1336 __FUNCTION__, static_cast<const void*>(timeout),
1337 StateAsCString(state));
1342 Process::PeekAtStateChangedEvents ()
1344 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1347 log->Printf ("Process::%s...", __FUNCTION__);
1350 event_ptr = m_listener_sp->PeekAtNextEventForBroadcasterWithType (this,
1351 eBroadcastBitStateChanged);
1356 log->Printf ("Process::%s (event_ptr) => %s",
1358 StateAsCString(ProcessEventData::GetStateFromEvent (event_ptr)));
1362 log->Printf ("Process::%s no events found",
1370 Process::WaitForStateChangedEventsPrivate (const TimeValue *timeout, EventSP &event_sp)
1372 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1375 log->Printf ("Process::%s (timeout = %p, event_sp)...", __FUNCTION__,
1376 static_cast<const void*>(timeout));
1378 StateType state = eStateInvalid;
1379 if (m_private_state_listener_sp->WaitForEventForBroadcasterWithType (timeout,
1380 &m_private_state_broadcaster,
1381 eBroadcastBitStateChanged | eBroadcastBitInterrupt,
1383 if (event_sp && event_sp->GetType() == eBroadcastBitStateChanged)
1384 state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
1386 // This is a bit of a hack, but when we wait here we could very well return
1387 // to the command-line, and that could disable the log, which would render the
1388 // log we got above invalid.
1390 log->Printf ("Process::%s (timeout = %p, event_sp) => %s",
1391 __FUNCTION__, static_cast<const void *>(timeout),
1392 state == eStateInvalid ? "TIMEOUT" : StateAsCString(state));
1397 Process::WaitForEventsPrivate (const TimeValue *timeout, EventSP &event_sp, bool control_only)
1399 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1402 log->Printf ("Process::%s (timeout = %p, event_sp)...", __FUNCTION__,
1403 static_cast<const void*>(timeout));
1406 return m_private_state_listener_sp->WaitForEventForBroadcaster(timeout, &m_private_state_control_broadcaster, event_sp);
1408 return m_private_state_listener_sp->WaitForEvent(timeout, event_sp);
1412 Process::IsRunning () const
1414 return StateIsRunningState (m_public_state.GetValue());
1418 Process::GetExitStatus ()
1420 std::lock_guard<std::mutex> guard(m_exit_status_mutex);
1422 if (m_public_state.GetValue() == eStateExited)
1423 return m_exit_status;
1428 Process::GetExitDescription ()
1430 std::lock_guard<std::mutex> guard(m_exit_status_mutex);
1432 if (m_public_state.GetValue() == eStateExited && !m_exit_string.empty())
1433 return m_exit_string.c_str();
1438 Process::SetExitStatus (int status, const char *cstr)
1440 // Use a mutex to protect setting the exit status.
1441 std::lock_guard<std::mutex> guard(m_exit_status_mutex);
1443 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1445 log->Printf("Process::SetExitStatus (status=%i (0x%8.8x), description=%s%s%s)",
1448 cstr ? cstr : "NULL",
1451 // We were already in the exited state
1452 if (m_private_state.GetValue() == eStateExited)
1455 log->Printf("Process::SetExitStatus () ignoring exit status because state was already set to eStateExited");
1459 m_exit_status = status;
1461 m_exit_string = cstr;
1463 m_exit_string.clear();
1465 // Clear the last natural stop ID since it has a strong
1466 // reference to this process
1467 m_mod_id.SetStopEventForLastNaturalStopID(EventSP());
1469 SetPrivateState (eStateExited);
1471 // Allow subclasses to do some cleanup
1480 switch (m_private_state.GetValue())
1482 case eStateConnected:
1483 case eStateAttaching:
1484 case eStateLaunching:
1487 case eStateStepping:
1489 case eStateSuspended:
1496 // This static callback can be used to watch for local child processes on
1497 // the current host. The child process exits, the process will be
1498 // found in the global target list (we want to be completely sure that the
1499 // lldb_private::Process doesn't go away before we can deliver the signal.
1501 Process::SetProcessExitStatus(lldb::pid_t pid, bool exited,
1502 int signo, // Zero for no signal
1503 int exit_status // Exit value of process if signal is zero
1506 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS));
1508 log->Printf("Process::SetProcessExitStatus (pid=%" PRIu64 ", exited=%i, signal=%i, exit_status=%i)\n", pid,
1509 exited, signo, exit_status);
1513 TargetSP target_sp(Debugger::FindTargetWithProcessID (pid));
1516 ProcessSP process_sp (target_sp->GetProcessSP());
1519 const char *signal_cstr = nullptr;
1521 signal_cstr = process_sp->GetUnixSignals()->GetSignalAsCString(signo);
1523 process_sp->SetExitStatus (exit_status, signal_cstr);
1532 Process::UpdateThreadListIfNeeded ()
1534 const uint32_t stop_id = GetStopID();
1535 if (m_thread_list.GetSize(false) == 0 || stop_id != m_thread_list.GetStopID())
1537 const StateType state = GetPrivateState();
1538 if (StateIsStoppedState (state, true))
1540 std::lock_guard<std::recursive_mutex> guard(m_thread_list.GetMutex());
1541 // m_thread_list does have its own mutex, but we need to
1542 // hold onto the mutex between the call to UpdateThreadList(...)
1543 // and the os->UpdateThreadList(...) so it doesn't change on us
1544 ThreadList &old_thread_list = m_thread_list;
1545 ThreadList real_thread_list(this);
1546 ThreadList new_thread_list(this);
1547 // Always update the thread list with the protocol specific
1548 // thread list, but only update if "true" is returned
1549 if (UpdateThreadList (m_thread_list_real, real_thread_list))
1551 // Don't call into the OperatingSystem to update the thread list if we are shutting down, since
1552 // that may call back into the SBAPI's, requiring the API lock which is already held by whoever is
1553 // shutting us down, causing a deadlock.
1554 OperatingSystem *os = GetOperatingSystem ();
1555 if (os && !m_destroy_in_process)
1557 // Clear any old backing threads where memory threads might have been
1558 // backed by actual threads from the lldb_private::Process subclass
1559 size_t num_old_threads = old_thread_list.GetSize(false);
1560 for (size_t i = 0; i < num_old_threads; ++i)
1561 old_thread_list.GetThreadAtIndex(i, false)->ClearBackingThread();
1563 // Turn off dynamic types to ensure we don't run any expressions. Objective C
1564 // can run an expression to determine if a SBValue is a dynamic type or not
1565 // and we need to avoid this. OperatingSystem plug-ins can't run expressions
1566 // that require running code...
1568 Target &target = GetTarget();
1569 const lldb::DynamicValueType saved_prefer_dynamic = target.GetPreferDynamicValue ();
1570 if (saved_prefer_dynamic != lldb::eNoDynamicValues)
1571 target.SetPreferDynamicValue(lldb::eNoDynamicValues);
1573 // Now let the OperatingSystem plug-in update the thread list
1575 os->UpdateThreadList (old_thread_list, // Old list full of threads created by OS plug-in
1576 real_thread_list, // The actual thread list full of threads created by each lldb_private::Process subclass
1577 new_thread_list); // The new thread list that we will show to the user that gets filled in
1579 if (saved_prefer_dynamic != lldb::eNoDynamicValues)
1580 target.SetPreferDynamicValue(saved_prefer_dynamic);
1584 // No OS plug-in, the new thread list is the same as the real thread list
1585 new_thread_list = real_thread_list;
1588 m_thread_list_real.Update(real_thread_list);
1589 m_thread_list.Update (new_thread_list);
1590 m_thread_list.SetStopID (stop_id);
1592 if (GetLastNaturalStopID () != m_extended_thread_stop_id)
1594 // Clear any extended threads that we may have accumulated previously
1595 m_extended_thread_list.Clear();
1596 m_extended_thread_stop_id = GetLastNaturalStopID ();
1598 m_queue_list.Clear();
1599 m_queue_list_stop_id = GetLastNaturalStopID ();
1607 Process::UpdateQueueListIfNeeded ()
1609 if (m_system_runtime_ap)
1611 if (m_queue_list.GetSize() == 0 || m_queue_list_stop_id != GetLastNaturalStopID())
1613 const StateType state = GetPrivateState();
1614 if (StateIsStoppedState (state, true))
1616 m_system_runtime_ap->PopulateQueueList (m_queue_list);
1617 m_queue_list_stop_id = GetLastNaturalStopID();
1624 Process::CreateOSPluginThread (lldb::tid_t tid, lldb::addr_t context)
1626 OperatingSystem *os = GetOperatingSystem ();
1628 return os->CreateThread(tid, context);
1633 Process::GetNextThreadIndexID (uint64_t thread_id)
1635 return AssignIndexIDToThread(thread_id);
1639 Process::HasAssignedIndexIDToThread(uint64_t thread_id)
1641 return (m_thread_id_to_index_id_map.find(thread_id) != m_thread_id_to_index_id_map.end());
1645 Process::AssignIndexIDToThread(uint64_t thread_id)
1647 uint32_t result = 0;
1648 std::map<uint64_t, uint32_t>::iterator iterator = m_thread_id_to_index_id_map.find(thread_id);
1649 if (iterator == m_thread_id_to_index_id_map.end())
1651 result = ++m_thread_index_id;
1652 m_thread_id_to_index_id_map[thread_id] = result;
1656 result = iterator->second;
1665 // If any other threads access this we will need a mutex for it
1666 return m_public_state.GetValue ();
1670 Process::StateChangedIsExternallyHijacked()
1672 if (IsHijackedForEvent(eBroadcastBitStateChanged))
1674 const char *hijacking_name = GetHijackingListenerName();
1675 if (hijacking_name && strcmp(hijacking_name, "lldb.Process.ResumeSynchronous.hijack"))
1682 Process::SetPublicState (StateType new_state, bool restarted)
1684 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1686 log->Printf("Process::SetPublicState (state = %s, restarted = %i)", StateAsCString(new_state), restarted);
1687 const StateType old_state = m_public_state.GetValue();
1688 m_public_state.SetValue (new_state);
1690 // On the transition from Run to Stopped, we unlock the writer end of the
1691 // run lock. The lock gets locked in Resume, which is the public API
1692 // to tell the program to run.
1693 if (!StateChangedIsExternallyHijacked())
1695 if (new_state == eStateDetached)
1698 log->Printf("Process::SetPublicState (%s) -- unlocking run lock for detach", StateAsCString(new_state));
1699 m_public_run_lock.SetStopped();
1703 const bool old_state_is_stopped = StateIsStoppedState(old_state, false);
1704 const bool new_state_is_stopped = StateIsStoppedState(new_state, false);
1705 if ((old_state_is_stopped != new_state_is_stopped))
1707 if (new_state_is_stopped && !restarted)
1710 log->Printf("Process::SetPublicState (%s) -- unlocking run lock", StateAsCString(new_state));
1711 m_public_run_lock.SetStopped();
1721 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1723 log->Printf("Process::Resume -- locking run lock");
1724 if (!m_public_run_lock.TrySetRunning())
1726 Error error("Resume request failed - process still running.");
1728 log->Printf ("Process::Resume: -- TrySetRunning failed, not resuming.");
1731 return PrivateResume();
1735 Process::ResumeSynchronous (Stream *stream)
1737 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1739 log->Printf("Process::ResumeSynchronous -- locking run lock");
1740 if (!m_public_run_lock.TrySetRunning())
1742 Error error("Resume request failed - process still running.");
1744 log->Printf ("Process::Resume: -- TrySetRunning failed, not resuming.");
1748 ListenerSP listener_sp (Listener::MakeListener("lldb.Process.ResumeSynchronous.hijack"));
1749 HijackProcessEvents(listener_sp);
1751 Error error = PrivateResume();
1752 if (error.Success())
1754 StateType state = WaitForProcessToStop (NULL, NULL, true, listener_sp, stream);
1755 const bool must_be_alive = false; // eStateExited is ok, so this must be false
1756 if (!StateIsStoppedState(state, must_be_alive))
1757 error.SetErrorStringWithFormat("process not in stopped state after synchronous resume: %s", StateAsCString(state));
1760 // Undo the hijacking of process events...
1761 RestoreProcessEvents();
1767 Process::GetPrivateState ()
1769 return m_private_state.GetValue();
1773 Process::SetPrivateState (StateType new_state)
1775 if (m_finalize_called)
1778 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STATE | LIBLLDB_LOG_PROCESS));
1779 bool state_changed = false;
1782 log->Printf("Process::SetPrivateState (%s)", StateAsCString(new_state));
1784 std::lock_guard<std::recursive_mutex> thread_guard(m_thread_list.GetMutex());
1785 std::lock_guard<std::recursive_mutex> guard(m_private_state.GetMutex());
1787 const StateType old_state = m_private_state.GetValueNoLock ();
1788 state_changed = old_state != new_state;
1790 const bool old_state_is_stopped = StateIsStoppedState(old_state, false);
1791 const bool new_state_is_stopped = StateIsStoppedState(new_state, false);
1792 if (old_state_is_stopped != new_state_is_stopped)
1794 if (new_state_is_stopped)
1795 m_private_run_lock.SetStopped();
1797 m_private_run_lock.SetRunning();
1802 m_private_state.SetValueNoLock (new_state);
1803 EventSP event_sp (new Event (eBroadcastBitStateChanged, new ProcessEventData (shared_from_this(), new_state)));
1804 if (StateIsStoppedState(new_state, false))
1806 // Note, this currently assumes that all threads in the list
1807 // stop when the process stops. In the future we will want to
1808 // support a debugging model where some threads continue to run
1809 // while others are stopped. When that happens we will either need
1810 // a way for the thread list to identify which threads are stopping
1811 // or create a special thread list containing only threads which
1812 // actually stopped.
1814 // The process plugin is responsible for managing the actual
1815 // behavior of the threads and should have stopped any threads
1816 // that are going to stop before we get here.
1817 m_thread_list.DidStop();
1819 m_mod_id.BumpStopID();
1820 if (!m_mod_id.IsLastResumeForUserExpression())
1821 m_mod_id.SetStopEventForLastNaturalStopID(event_sp);
1822 m_memory_cache.Clear();
1824 log->Printf("Process::SetPrivateState (%s) stop_id = %u", StateAsCString(new_state), m_mod_id.GetStopID());
1827 // Use our target to get a shared pointer to ourselves...
1828 if (m_finalize_called && !PrivateStateThreadIsValid())
1829 BroadcastEvent (event_sp);
1831 m_private_state_broadcaster.BroadcastEvent (event_sp);
1836 log->Printf("Process::SetPrivateState (%s) state didn't change. Ignoring...", StateAsCString(new_state));
1841 Process::SetRunningUserExpression (bool on)
1843 m_mod_id.SetRunningUserExpression (on);
1847 Process::GetImageInfoAddress()
1849 return LLDB_INVALID_ADDRESS;
1856 m_abi_sp = ABI::FindPlugin(GetTarget().GetArchitecture());
1861 Process::GetLanguageRuntime(lldb::LanguageType language, bool retry_if_null)
1866 LanguageRuntimeCollection::iterator pos;
1867 pos = m_language_runtimes.find (language);
1868 if (pos == m_language_runtimes.end() || (retry_if_null && !(*pos).second))
1870 lldb::LanguageRuntimeSP runtime_sp(LanguageRuntime::FindPlugin(this, language));
1872 m_language_runtimes[language] = runtime_sp;
1873 return runtime_sp.get();
1876 return (*pos).second.get();
1879 CPPLanguageRuntime *
1880 Process::GetCPPLanguageRuntime (bool retry_if_null)
1882 LanguageRuntime *runtime = GetLanguageRuntime(eLanguageTypeC_plus_plus, retry_if_null);
1883 if (runtime != nullptr && runtime->GetLanguageType() == eLanguageTypeC_plus_plus)
1884 return static_cast<CPPLanguageRuntime *> (runtime);
1888 ObjCLanguageRuntime *
1889 Process::GetObjCLanguageRuntime (bool retry_if_null)
1891 LanguageRuntime *runtime = GetLanguageRuntime(eLanguageTypeObjC, retry_if_null);
1892 if (runtime != nullptr && runtime->GetLanguageType() == eLanguageTypeObjC)
1893 return static_cast<ObjCLanguageRuntime *> (runtime);
1898 Process::IsPossibleDynamicValue (ValueObject& in_value)
1903 if (in_value.IsDynamic())
1905 LanguageType known_type = in_value.GetObjectRuntimeLanguage();
1907 if (known_type != eLanguageTypeUnknown && known_type != eLanguageTypeC)
1909 LanguageRuntime *runtime = GetLanguageRuntime (known_type);
1910 return runtime ? runtime->CouldHaveDynamicValue(in_value) : false;
1913 LanguageRuntime *cpp_runtime = GetLanguageRuntime (eLanguageTypeC_plus_plus);
1914 if (cpp_runtime && cpp_runtime->CouldHaveDynamicValue(in_value))
1917 LanguageRuntime *objc_runtime = GetLanguageRuntime (eLanguageTypeObjC);
1918 return objc_runtime ? objc_runtime->CouldHaveDynamicValue(in_value) : false;
1922 Process::SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers)
1924 m_dynamic_checkers_ap.reset(dynamic_checkers);
1927 BreakpointSiteList &
1928 Process::GetBreakpointSiteList()
1930 return m_breakpoint_site_list;
1933 const BreakpointSiteList &
1934 Process::GetBreakpointSiteList() const
1936 return m_breakpoint_site_list;
1940 Process::DisableAllBreakpointSites ()
1942 m_breakpoint_site_list.ForEach([this](BreakpointSite *bp_site) -> void {
1943 // bp_site->SetEnabled(true);
1944 DisableBreakpointSite(bp_site);
1949 Process::ClearBreakpointSiteByID (lldb::user_id_t break_id)
1951 Error error (DisableBreakpointSiteByID (break_id));
1953 if (error.Success())
1954 m_breakpoint_site_list.Remove(break_id);
1960 Process::DisableBreakpointSiteByID (lldb::user_id_t break_id)
1963 BreakpointSiteSP bp_site_sp = m_breakpoint_site_list.FindByID (break_id);
1966 if (bp_site_sp->IsEnabled())
1967 error = DisableBreakpointSite (bp_site_sp.get());
1971 error.SetErrorStringWithFormat("invalid breakpoint site ID: %" PRIu64, break_id);
1978 Process::EnableBreakpointSiteByID (lldb::user_id_t break_id)
1981 BreakpointSiteSP bp_site_sp = m_breakpoint_site_list.FindByID (break_id);
1984 if (!bp_site_sp->IsEnabled())
1985 error = EnableBreakpointSite (bp_site_sp.get());
1989 error.SetErrorStringWithFormat("invalid breakpoint site ID: %" PRIu64, break_id);
1995 Process::CreateBreakpointSite (const BreakpointLocationSP &owner, bool use_hardware)
1997 addr_t load_addr = LLDB_INVALID_ADDRESS;
1999 bool show_error = true;
2003 case eStateUnloaded:
2004 case eStateConnected:
2005 case eStateAttaching:
2006 case eStateLaunching:
2007 case eStateDetached:
2014 case eStateStepping:
2016 case eStateSuspended:
2017 show_error = IsAlive();
2021 // Reset the IsIndirect flag here, in case the location changes from
2022 // pointing to a indirect symbol to a regular symbol.
2023 owner->SetIsIndirect (false);
2025 if (owner->ShouldResolveIndirectFunctions())
2027 Symbol *symbol = owner->GetAddress().CalculateSymbolContextSymbol();
2028 if (symbol && symbol->IsIndirect())
2031 Address symbol_address = symbol->GetAddress();
2032 load_addr = ResolveIndirectFunction (&symbol_address, error);
2033 if (!error.Success() && show_error)
2035 GetTarget().GetDebugger().GetErrorFile()->Printf ("warning: failed to resolve indirect function at 0x%" PRIx64 " for breakpoint %i.%i: %s\n",
2036 symbol->GetLoadAddress(&GetTarget()),
2037 owner->GetBreakpoint().GetID(),
2039 error.AsCString() ? error.AsCString() : "unknown error");
2040 return LLDB_INVALID_BREAK_ID;
2042 Address resolved_address(load_addr);
2043 load_addr = resolved_address.GetOpcodeLoadAddress (&GetTarget());
2044 owner->SetIsIndirect(true);
2047 load_addr = owner->GetAddress().GetOpcodeLoadAddress (&GetTarget());
2050 load_addr = owner->GetAddress().GetOpcodeLoadAddress (&GetTarget());
2052 if (load_addr != LLDB_INVALID_ADDRESS)
2054 BreakpointSiteSP bp_site_sp;
2056 // Look up this breakpoint site. If it exists, then add this new owner, otherwise
2057 // create a new breakpoint site and add it.
2059 bp_site_sp = m_breakpoint_site_list.FindByAddress (load_addr);
2063 bp_site_sp->AddOwner (owner);
2064 owner->SetBreakpointSite (bp_site_sp);
2065 return bp_site_sp->GetID();
2069 bp_site_sp.reset (new BreakpointSite (&m_breakpoint_site_list, owner, load_addr, use_hardware));
2072 Error error = EnableBreakpointSite (bp_site_sp.get());
2073 if (error.Success())
2075 owner->SetBreakpointSite (bp_site_sp);
2076 return m_breakpoint_site_list.Add (bp_site_sp);
2082 // Report error for setting breakpoint...
2083 GetTarget().GetDebugger().GetErrorFile()->Printf ("warning: failed to set breakpoint site at 0x%" PRIx64 " for breakpoint %i.%i: %s\n",
2085 owner->GetBreakpoint().GetID(),
2087 error.AsCString() ? error.AsCString() : "unknown error");
2093 // We failed to enable the breakpoint
2094 return LLDB_INVALID_BREAK_ID;
2098 Process::RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, lldb::user_id_t owner_loc_id, BreakpointSiteSP &bp_site_sp)
2100 uint32_t num_owners = bp_site_sp->RemoveOwner (owner_id, owner_loc_id);
2101 if (num_owners == 0)
2103 // Don't try to disable the site if we don't have a live process anymore.
2105 DisableBreakpointSite (bp_site_sp.get());
2106 m_breakpoint_site_list.RemoveByAddress(bp_site_sp->GetLoadAddress());
2111 Process::RemoveBreakpointOpcodesFromBuffer (addr_t bp_addr, size_t size, uint8_t *buf) const
2113 size_t bytes_removed = 0;
2114 BreakpointSiteList bp_sites_in_range;
2116 if (m_breakpoint_site_list.FindInRange (bp_addr, bp_addr + size, bp_sites_in_range))
2118 bp_sites_in_range.ForEach([bp_addr, size, buf, &bytes_removed](BreakpointSite *bp_site) -> void {
2119 if (bp_site->GetType() == BreakpointSite::eSoftware)
2121 addr_t intersect_addr;
2122 size_t intersect_size;
2123 size_t opcode_offset;
2124 if (bp_site->IntersectsRange(bp_addr, size, &intersect_addr, &intersect_size, &opcode_offset))
2126 assert(bp_addr <= intersect_addr && intersect_addr < bp_addr + size);
2127 assert(bp_addr < intersect_addr + intersect_size && intersect_addr + intersect_size <= bp_addr + size);
2128 assert(opcode_offset + intersect_size <= bp_site->GetByteSize());
2129 size_t buf_offset = intersect_addr - bp_addr;
2130 ::memcpy(buf + buf_offset, bp_site->GetSavedOpcodeBytes() + opcode_offset, intersect_size);
2135 return bytes_removed;
2139 Process::GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site)
2141 PlatformSP platform_sp (GetTarget().GetPlatform());
2143 return platform_sp->GetSoftwareBreakpointTrapOpcode (GetTarget(), bp_site);
2148 Process::EnableSoftwareBreakpoint (BreakpointSite *bp_site)
2151 assert(bp_site != nullptr);
2152 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
2153 const addr_t bp_addr = bp_site->GetLoadAddress();
2155 log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64, bp_site->GetID(), (uint64_t)bp_addr);
2156 if (bp_site->IsEnabled())
2159 log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- already enabled", bp_site->GetID(), (uint64_t)bp_addr);
2163 if (bp_addr == LLDB_INVALID_ADDRESS)
2165 error.SetErrorString("BreakpointSite contains an invalid load address.");
2168 // Ask the lldb::Process subclass to fill in the correct software breakpoint
2169 // trap for the breakpoint site
2170 const size_t bp_opcode_size = GetSoftwareBreakpointTrapOpcode(bp_site);
2172 if (bp_opcode_size == 0)
2174 error.SetErrorStringWithFormat ("Process::GetSoftwareBreakpointTrapOpcode() returned zero, unable to get breakpoint trap for address 0x%" PRIx64, bp_addr);
2178 const uint8_t * const bp_opcode_bytes = bp_site->GetTrapOpcodeBytes();
2180 if (bp_opcode_bytes == nullptr)
2182 error.SetErrorString ("BreakpointSite doesn't contain a valid breakpoint trap opcode.");
2186 // Save the original opcode by reading it
2187 if (DoReadMemory(bp_addr, bp_site->GetSavedOpcodeBytes(), bp_opcode_size, error) == bp_opcode_size)
2189 // Write a software breakpoint in place of the original opcode
2190 if (DoWriteMemory(bp_addr, bp_opcode_bytes, bp_opcode_size, error) == bp_opcode_size)
2192 uint8_t verify_bp_opcode_bytes[64];
2193 if (DoReadMemory(bp_addr, verify_bp_opcode_bytes, bp_opcode_size, error) == bp_opcode_size)
2195 if (::memcmp(bp_opcode_bytes, verify_bp_opcode_bytes, bp_opcode_size) == 0)
2197 bp_site->SetEnabled(true);
2198 bp_site->SetType (BreakpointSite::eSoftware);
2200 log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- SUCCESS",
2205 error.SetErrorString("failed to verify the breakpoint trap in memory.");
2208 error.SetErrorString("Unable to read memory to verify breakpoint trap.");
2211 error.SetErrorString("Unable to write breakpoint trap to memory.");
2214 error.SetErrorString("Unable to read memory at breakpoint address.");
2216 if (log && error.Fail())
2217 log->Printf ("Process::EnableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- FAILED: %s",
2225 Process::DisableSoftwareBreakpoint (BreakpointSite *bp_site)
2228 assert(bp_site != nullptr);
2229 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
2230 addr_t bp_addr = bp_site->GetLoadAddress();
2231 lldb::user_id_t breakID = bp_site->GetID();
2233 log->Printf ("Process::DisableSoftwareBreakpoint (breakID = %" PRIu64 ") addr = 0x%" PRIx64, breakID, (uint64_t)bp_addr);
2235 if (bp_site->IsHardware())
2237 error.SetErrorString("Breakpoint site is a hardware breakpoint.");
2239 else if (bp_site->IsEnabled())
2241 const size_t break_op_size = bp_site->GetByteSize();
2242 const uint8_t * const break_op = bp_site->GetTrapOpcodeBytes();
2243 if (break_op_size > 0)
2245 // Clear a software breakpoint instruction
2246 uint8_t curr_break_op[8];
2247 assert (break_op_size <= sizeof(curr_break_op));
2248 bool break_op_found = false;
2250 // Read the breakpoint opcode
2251 if (DoReadMemory (bp_addr, curr_break_op, break_op_size, error) == break_op_size)
2253 bool verify = false;
2254 // Make sure the breakpoint opcode exists at this address
2255 if (::memcmp (curr_break_op, break_op, break_op_size) == 0)
2257 break_op_found = true;
2258 // We found a valid breakpoint opcode at this address, now restore
2259 // the saved opcode.
2260 if (DoWriteMemory (bp_addr, bp_site->GetSavedOpcodeBytes(), break_op_size, error) == break_op_size)
2265 error.SetErrorString("Memory write failed when restoring original opcode.");
2269 error.SetErrorString("Original breakpoint trap is no longer in memory.");
2270 // Set verify to true and so we can check if the original opcode has already been restored
2276 uint8_t verify_opcode[8];
2277 assert (break_op_size < sizeof(verify_opcode));
2278 // Verify that our original opcode made it back to the inferior
2279 if (DoReadMemory (bp_addr, verify_opcode, break_op_size, error) == break_op_size)
2281 // compare the memory we just read with the original opcode
2282 if (::memcmp (bp_site->GetSavedOpcodeBytes(), verify_opcode, break_op_size) == 0)
2285 bp_site->SetEnabled(false);
2287 log->Printf ("Process::DisableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- SUCCESS", bp_site->GetID(), (uint64_t)bp_addr);
2293 error.SetErrorString("Failed to restore original opcode.");
2297 error.SetErrorString("Failed to read memory to verify that breakpoint trap was restored.");
2301 error.SetErrorString("Unable to read memory that should contain the breakpoint trap.");
2307 log->Printf ("Process::DisableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- already disabled", bp_site->GetID(), (uint64_t)bp_addr);
2312 log->Printf ("Process::DisableSoftwareBreakpoint (site_id = %d) addr = 0x%" PRIx64 " -- FAILED: %s",
2319 // Uncomment to verify memory caching works after making changes to caching code
2320 //#define VERIFY_MEMORY_READS
2323 Process::ReadMemory (addr_t addr, void *buf, size_t size, Error &error)
2326 if (!GetDisableMemoryCache())
2328 #if defined (VERIFY_MEMORY_READS)
2329 // Memory caching is enabled, with debug verification
2333 // Uncomment the line below to make sure memory caching is working.
2334 // I ran this through the test suite and got no assertions, so I am
2335 // pretty confident this is working well. If any changes are made to
2336 // memory caching, uncomment the line below and test your changes!
2338 // Verify all memory reads by using the cache first, then redundantly
2339 // reading the same memory from the inferior and comparing to make sure
2340 // everything is exactly the same.
2341 std::string verify_buf (size, '\0');
2342 assert (verify_buf.size() == size);
2343 const size_t cache_bytes_read = m_memory_cache.Read (this, addr, buf, size, error);
2345 const size_t verify_bytes_read = ReadMemoryFromInferior (addr, const_cast<char *>(verify_buf.data()), verify_buf.size(), verify_error);
2346 assert (cache_bytes_read == verify_bytes_read);
2347 assert (memcmp(buf, verify_buf.data(), verify_buf.size()) == 0);
2348 assert (verify_error.Success() == error.Success());
2349 return cache_bytes_read;
2352 #else // !defined(VERIFY_MEMORY_READS)
2353 // Memory caching is enabled, without debug verification
2355 return m_memory_cache.Read (addr, buf, size, error);
2356 #endif // defined (VERIFY_MEMORY_READS)
2360 // Memory caching is disabled
2362 return ReadMemoryFromInferior (addr, buf, size, error);
2367 Process::ReadCStringFromMemory (addr_t addr, std::string &out_str, Error &error)
2371 addr_t curr_addr = addr;
2374 size_t length = ReadCStringFromMemory (curr_addr, buf, sizeof(buf), error);
2377 out_str.append(buf, length);
2378 // If we got "length - 1" bytes, we didn't get the whole C string, we
2379 // need to read some more characters
2380 if (length == sizeof(buf) - 1)
2381 curr_addr += length;
2385 return out_str.size();
2389 Process::ReadStringFromMemory (addr_t addr, char *dst, size_t max_bytes, Error &error,
2392 size_t total_bytes_read = 0;
2393 if (dst && max_bytes && type_width && max_bytes >= type_width)
2395 // Ensure a null terminator independent of the number of bytes that is read.
2396 memset (dst, 0, max_bytes);
2397 size_t bytes_left = max_bytes - type_width;
2399 const char terminator[4] = {'\0', '\0', '\0', '\0'};
2400 assert(sizeof(terminator) >= type_width &&
2401 "Attempting to validate a string with more than 4 bytes per character!");
2403 addr_t curr_addr = addr;
2404 const size_t cache_line_size = m_memory_cache.GetMemoryCacheLineSize();
2405 char *curr_dst = dst;
2408 while (bytes_left > 0 && error.Success())
2410 addr_t cache_line_bytes_left = cache_line_size - (curr_addr % cache_line_size);
2411 addr_t bytes_to_read = std::min<addr_t>(bytes_left, cache_line_bytes_left);
2412 size_t bytes_read = ReadMemory (curr_addr, curr_dst, bytes_to_read, error);
2414 if (bytes_read == 0)
2417 // Search for a null terminator of correct size and alignment in bytes_read
2418 size_t aligned_start = total_bytes_read - total_bytes_read % type_width;
2419 for (size_t i = aligned_start; i + type_width <= total_bytes_read + bytes_read; i += type_width)
2420 if (::memcmp(&dst[i], terminator, type_width) == 0)
2426 total_bytes_read += bytes_read;
2427 curr_dst += bytes_read;
2428 curr_addr += bytes_read;
2429 bytes_left -= bytes_read;
2435 error.SetErrorString("invalid arguments");
2437 return total_bytes_read;
2440 // Deprecated in favor of ReadStringFromMemory which has wchar support and correct code to find
2441 // null terminators.
2443 Process::ReadCStringFromMemory (addr_t addr, char *dst, size_t dst_max_len, Error &result_error)
2445 size_t total_cstr_len = 0;
2446 if (dst && dst_max_len)
2448 result_error.Clear();
2449 // NULL out everything just to be safe
2450 memset (dst, 0, dst_max_len);
2452 addr_t curr_addr = addr;
2453 const size_t cache_line_size = m_memory_cache.GetMemoryCacheLineSize();
2454 size_t bytes_left = dst_max_len - 1;
2455 char *curr_dst = dst;
2457 while (bytes_left > 0)
2459 addr_t cache_line_bytes_left = cache_line_size - (curr_addr % cache_line_size);
2460 addr_t bytes_to_read = std::min<addr_t>(bytes_left, cache_line_bytes_left);
2461 size_t bytes_read = ReadMemory (curr_addr, curr_dst, bytes_to_read, error);
2463 if (bytes_read == 0)
2465 result_error = error;
2466 dst[total_cstr_len] = '\0';
2469 const size_t len = strlen(curr_dst);
2471 total_cstr_len += len;
2473 if (len < bytes_to_read)
2476 curr_dst += bytes_read;
2477 curr_addr += bytes_read;
2478 bytes_left -= bytes_read;
2484 result_error.SetErrorString("invalid arguments");
2486 result_error.Clear();
2488 return total_cstr_len;
2492 Process::ReadMemoryFromInferior (addr_t addr, void *buf, size_t size, Error &error)
2494 if (buf == nullptr || size == 0)
2497 size_t bytes_read = 0;
2498 uint8_t *bytes = (uint8_t *)buf;
2500 while (bytes_read < size)
2502 const size_t curr_size = size - bytes_read;
2503 const size_t curr_bytes_read = DoReadMemory (addr + bytes_read,
2507 bytes_read += curr_bytes_read;
2508 if (curr_bytes_read == curr_size || curr_bytes_read == 0)
2512 // Replace any software breakpoint opcodes that fall into this range back
2513 // into "buf" before we return
2515 RemoveBreakpointOpcodesFromBuffer (addr, bytes_read, (uint8_t *)buf);
2520 Process::ReadUnsignedIntegerFromMemory(lldb::addr_t vm_addr, size_t integer_byte_size, uint64_t fail_value,
2524 if (ReadScalarIntegerFromMemory(vm_addr, integer_byte_size, false, scalar, error))
2525 return scalar.ULongLong(fail_value);
2530 Process::ReadSignedIntegerFromMemory(lldb::addr_t vm_addr, size_t integer_byte_size, int64_t fail_value, Error &error)
2533 if (ReadScalarIntegerFromMemory(vm_addr, integer_byte_size, true, scalar, error))
2534 return scalar.SLongLong(fail_value);
2539 Process::ReadPointerFromMemory (lldb::addr_t vm_addr, Error &error)
2542 if (ReadScalarIntegerFromMemory(vm_addr, GetAddressByteSize(), false, scalar, error))
2543 return scalar.ULongLong(LLDB_INVALID_ADDRESS);
2544 return LLDB_INVALID_ADDRESS;
2548 Process::WritePointerToMemory (lldb::addr_t vm_addr,
2549 lldb::addr_t ptr_value,
2553 const uint32_t addr_byte_size = GetAddressByteSize();
2554 if (addr_byte_size <= 4)
2555 scalar = (uint32_t)ptr_value;
2558 return WriteScalarToMemory(vm_addr, scalar, addr_byte_size, error) == addr_byte_size;
2562 Process::WriteMemoryPrivate (addr_t addr, const void *buf, size_t size, Error &error)
2564 size_t bytes_written = 0;
2565 const uint8_t *bytes = (const uint8_t *)buf;
2567 while (bytes_written < size)
2569 const size_t curr_size = size - bytes_written;
2570 const size_t curr_bytes_written = DoWriteMemory (addr + bytes_written,
2571 bytes + bytes_written,
2574 bytes_written += curr_bytes_written;
2575 if (curr_bytes_written == curr_size || curr_bytes_written == 0)
2578 return bytes_written;
2582 Process::WriteMemory (addr_t addr, const void *buf, size_t size, Error &error)
2584 #if defined (ENABLE_MEMORY_CACHING)
2585 m_memory_cache.Flush (addr, size);
2588 if (buf == nullptr || size == 0)
2591 m_mod_id.BumpMemoryID();
2593 // We need to write any data that would go where any current software traps
2594 // (enabled software breakpoints) any software traps (breakpoints) that we
2595 // may have placed in our tasks memory.
2597 BreakpointSiteList bp_sites_in_range;
2599 if (m_breakpoint_site_list.FindInRange (addr, addr + size, bp_sites_in_range))
2601 // No breakpoint sites overlap
2602 if (bp_sites_in_range.IsEmpty())
2603 return WriteMemoryPrivate (addr, buf, size, error);
2606 const uint8_t *ubuf = (const uint8_t *)buf;
2607 uint64_t bytes_written = 0;
2609 bp_sites_in_range.ForEach([this, addr, size, &bytes_written, &ubuf, &error](BreakpointSite *bp) -> void {
2611 if (error.Success())
2613 addr_t intersect_addr;
2614 size_t intersect_size;
2615 size_t opcode_offset;
2616 const bool intersects = bp->IntersectsRange(addr, size, &intersect_addr, &intersect_size, &opcode_offset);
2617 UNUSED_IF_ASSERT_DISABLED(intersects);
2619 assert(addr <= intersect_addr && intersect_addr < addr + size);
2620 assert(addr < intersect_addr + intersect_size && intersect_addr + intersect_size <= addr + size);
2621 assert(opcode_offset + intersect_size <= bp->GetByteSize());
2623 // Check for bytes before this breakpoint
2624 const addr_t curr_addr = addr + bytes_written;
2625 if (intersect_addr > curr_addr)
2627 // There are some bytes before this breakpoint that we need to
2628 // just write to memory
2629 size_t curr_size = intersect_addr - curr_addr;
2630 size_t curr_bytes_written = WriteMemoryPrivate (curr_addr,
2631 ubuf + bytes_written,
2634 bytes_written += curr_bytes_written;
2635 if (curr_bytes_written != curr_size)
2637 // We weren't able to write all of the requested bytes, we
2638 // are done looping and will return the number of bytes that
2639 // we have written so far.
2640 if (error.Success())
2641 error.SetErrorToGenericError();
2644 // Now write any bytes that would cover up any software breakpoints
2645 // directly into the breakpoint opcode buffer
2646 ::memcpy(bp->GetSavedOpcodeBytes() + opcode_offset, ubuf + bytes_written, intersect_size);
2647 bytes_written += intersect_size;
2651 if (bytes_written < size)
2652 WriteMemoryPrivate (addr + bytes_written,
2653 ubuf + bytes_written,
2654 size - bytes_written,
2660 return WriteMemoryPrivate (addr, buf, size, error);
2663 // Write any remaining bytes after the last breakpoint if we have any left
2664 return 0; //bytes_written;
2668 Process::WriteScalarToMemory (addr_t addr, const Scalar &scalar, size_t byte_size, Error &error)
2670 if (byte_size == UINT32_MAX)
2671 byte_size = scalar.GetByteSize();
2675 const size_t mem_size = scalar.GetAsMemoryData (buf, byte_size, GetByteOrder(), error);
2677 return WriteMemory(addr, buf, mem_size, error);
2679 error.SetErrorString ("failed to get scalar as memory data");
2683 error.SetErrorString ("invalid scalar value");
2689 Process::ReadScalarIntegerFromMemory (addr_t addr,
2698 error.SetErrorString ("byte size is zero");
2700 else if (byte_size & (byte_size - 1))
2702 error.SetErrorStringWithFormat ("byte size %u is not a power of 2", byte_size);
2704 else if (byte_size <= sizeof(uval))
2706 const size_t bytes_read = ReadMemory (addr, &uval, byte_size, error);
2707 if (bytes_read == byte_size)
2709 DataExtractor data (&uval, sizeof(uval), GetByteOrder(), GetAddressByteSize());
2710 lldb::offset_t offset = 0;
2712 scalar = data.GetMaxU32 (&offset, byte_size);
2714 scalar = data.GetMaxU64 (&offset, byte_size);
2716 scalar.SignExtend(byte_size * 8);
2722 error.SetErrorStringWithFormat ("byte size of %u is too large for integer scalar type", byte_size);
2727 #define USE_ALLOCATE_MEMORY_CACHE 1
2729 Process::AllocateMemory(size_t size, uint32_t permissions, Error &error)
2731 if (GetPrivateState() != eStateStopped)
2732 return LLDB_INVALID_ADDRESS;
2734 #if defined (USE_ALLOCATE_MEMORY_CACHE)
2735 return m_allocated_memory_cache.AllocateMemory(size, permissions, error);
2737 addr_t allocated_addr = DoAllocateMemory (size, permissions, error);
2738 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2740 log->Printf("Process::AllocateMemory(size=%" PRIu64 ", permissions=%s) => 0x%16.16" PRIx64 " (m_stop_id = %u m_memory_id = %u)",
2742 GetPermissionsAsCString (permissions),
2743 (uint64_t)allocated_addr,
2744 m_mod_id.GetStopID(),
2745 m_mod_id.GetMemoryID());
2746 return allocated_addr;
2751 Process::CallocateMemory(size_t size, uint32_t permissions, Error &error)
2753 addr_t return_addr = AllocateMemory(size, permissions, error);
2754 if (error.Success())
2756 std::string buffer(size, 0);
2757 WriteMemory(return_addr, buffer.c_str(), size, error);
2765 if (m_can_jit == eCanJITDontKnow)
2767 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2770 uint64_t allocated_memory = AllocateMemory(8,
2771 ePermissionsReadable | ePermissionsWritable | ePermissionsExecutable,
2776 m_can_jit = eCanJITYes;
2778 log->Printf ("Process::%s pid %" PRIu64 " allocation test passed, CanJIT () is true", __FUNCTION__, GetID ());
2782 m_can_jit = eCanJITNo;
2784 log->Printf ("Process::%s pid %" PRIu64 " allocation test failed, CanJIT () is false: %s", __FUNCTION__, GetID (), err.AsCString ());
2787 DeallocateMemory (allocated_memory);
2790 return m_can_jit == eCanJITYes;
2794 Process::SetCanJIT (bool can_jit)
2796 m_can_jit = (can_jit ? eCanJITYes : eCanJITNo);
2800 Process::SetCanRunCode (bool can_run_code)
2802 SetCanJIT(can_run_code);
2803 m_can_interpret_function_calls = can_run_code;
2807 Process::DeallocateMemory (addr_t ptr)
2810 #if defined (USE_ALLOCATE_MEMORY_CACHE)
2811 if (!m_allocated_memory_cache.DeallocateMemory(ptr))
2813 error.SetErrorStringWithFormat ("deallocation of memory at 0x%" PRIx64 " failed.", (uint64_t)ptr);
2816 error = DoDeallocateMemory (ptr);
2818 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2820 log->Printf("Process::DeallocateMemory(addr=0x%16.16" PRIx64 ") => err = %s (m_stop_id = %u, m_memory_id = %u)",
2822 error.AsCString("SUCCESS"),
2823 m_mod_id.GetStopID(),
2824 m_mod_id.GetMemoryID());
2830 Process::ReadModuleFromMemory (const FileSpec& file_spec,
2831 lldb::addr_t header_addr,
2832 size_t size_to_read)
2834 Log *log = lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_HOST);
2837 log->Printf ("Process::ReadModuleFromMemory reading %s binary from memory", file_spec.GetPath().c_str());
2839 ModuleSP module_sp (new Module (file_spec, ArchSpec()));
2843 ObjectFile *objfile = module_sp->GetMemoryObjectFile (shared_from_this(), header_addr, error, size_to_read);
2851 Process::GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions)
2853 MemoryRegionInfo range_info;
2855 Error error (GetMemoryRegionInfo (load_addr, range_info));
2856 if (!error.Success())
2858 if (range_info.GetReadable() == MemoryRegionInfo::eDontKnow
2859 || range_info.GetWritable() == MemoryRegionInfo::eDontKnow
2860 || range_info.GetExecutable() == MemoryRegionInfo::eDontKnow)
2865 if (range_info.GetReadable() == MemoryRegionInfo::eYes)
2866 permissions |= lldb::ePermissionsReadable;
2868 if (range_info.GetWritable() == MemoryRegionInfo::eYes)
2869 permissions |= lldb::ePermissionsWritable;
2871 if (range_info.GetExecutable() == MemoryRegionInfo::eYes)
2872 permissions |= lldb::ePermissionsExecutable;
2878 Process::EnableWatchpoint (Watchpoint *watchpoint, bool notify)
2881 error.SetErrorString("watchpoints are not supported");
2886 Process::DisableWatchpoint (Watchpoint *watchpoint, bool notify)
2889 error.SetErrorString("watchpoints are not supported");
2894 Process::WaitForProcessStopPrivate (const TimeValue *timeout, EventSP &event_sp)
2897 // Now wait for the process to launch and return control to us, and then
2902 state = WaitForStateChangedEventsPrivate (timeout, event_sp);
2904 if (StateIsStoppedState(state, false))
2907 // If state is invalid, then we timed out
2908 if (state == eStateInvalid)
2912 HandlePrivateEvent (event_sp);
2918 Process::LoadOperatingSystemPlugin(bool flush)
2921 m_thread_list.Clear();
2922 m_os_ap.reset(OperatingSystem::FindPlugin(this, nullptr));
2928 Process::Launch (ProcessLaunchInfo &launch_info)
2933 m_jit_loaders_ap.reset();
2934 m_system_runtime_ap.reset();
2936 m_process_input_reader.reset();
2937 m_stop_info_override_callback = nullptr;
2939 Module *exe_module = GetTarget().GetExecutableModulePointer();
2942 char local_exec_file_path[PATH_MAX];
2943 char platform_exec_file_path[PATH_MAX];
2944 exe_module->GetFileSpec().GetPath(local_exec_file_path, sizeof(local_exec_file_path));
2945 exe_module->GetPlatformFileSpec().GetPath(platform_exec_file_path, sizeof(platform_exec_file_path));
2946 if (exe_module->GetFileSpec().Exists())
2948 // Install anything that might need to be installed prior to launching.
2949 // For host systems, this will do nothing, but if we are connected to a
2950 // remote platform it will install any needed binaries
2951 error = GetTarget().Install(&launch_info);
2955 if (PrivateStateThreadIsValid ())
2956 PausePrivateStateThread ();
2958 error = WillLaunch (exe_module);
2959 if (error.Success())
2961 const bool restarted = false;
2962 SetPublicState (eStateLaunching, restarted);
2963 m_should_detach = false;
2965 if (m_public_run_lock.TrySetRunning())
2967 // Now launch using these arguments.
2968 error = DoLaunch (exe_module, launch_info);
2972 // This shouldn't happen
2973 error.SetErrorString("failed to acquire process run lock");
2978 if (GetID() != LLDB_INVALID_PROCESS_ID)
2980 SetID (LLDB_INVALID_PROCESS_ID);
2981 const char *error_string = error.AsCString();
2982 if (error_string == nullptr)
2983 error_string = "launch failed";
2984 SetExitStatus (-1, error_string);
2990 TimeValue timeout_time;
2991 timeout_time = TimeValue::Now();
2992 timeout_time.OffsetWithSeconds(10);
2993 StateType state = WaitForProcessStopPrivate(&timeout_time, event_sp);
2995 if (state == eStateInvalid || !event_sp)
2997 // We were able to launch the process, but we failed to
2998 // catch the initial stop.
2999 error.SetErrorString ("failed to catch stop after launch");
3000 SetExitStatus (0, "failed to catch stop after launch");
3003 else if (state == eStateStopped || state == eStateCrashed)
3007 DynamicLoader *dyld = GetDynamicLoader ();
3011 GetJITLoaders().DidLaunch();
3013 SystemRuntime *system_runtime = GetSystemRuntime ();
3015 system_runtime->DidLaunch();
3017 LoadOperatingSystemPlugin(false);
3019 // Note, the stop event was consumed above, but not handled. This was done
3020 // to give DidLaunch a chance to run. The target is either stopped or crashed.
3021 // Directly set the state. This is done to prevent a stop message with a bunch
3022 // of spurious output on thread status, as well as not pop a ProcessIOHandler.
3023 SetPublicState(state, false);
3025 if (PrivateStateThreadIsValid ())
3026 ResumePrivateStateThread ();
3028 StartPrivateStateThread ();
3030 m_stop_info_override_callback = GetTarget().GetArchitecture().GetStopInfoOverrideCallback();
3032 // Target was stopped at entry as was intended. Need to notify the listeners
3034 if (state == eStateStopped && launch_info.GetFlags().Test(eLaunchFlagStopAtEntry))
3035 HandlePrivateEvent(event_sp);
3037 else if (state == eStateExited)
3039 // We exited while trying to launch somehow. Don't call DidLaunch as that's
3040 // not likely to work, and return an invalid pid.
3041 HandlePrivateEvent (event_sp);
3048 error.SetErrorStringWithFormat("file doesn't exist: '%s'", local_exec_file_path);
3055 Process::LoadCore ()
3057 Error error = DoLoadCore();
3058 if (error.Success())
3060 ListenerSP listener_sp (Listener::MakeListener("lldb.process.load_core_listener"));
3061 HijackProcessEvents(listener_sp);
3063 if (PrivateStateThreadIsValid ())
3064 ResumePrivateStateThread ();
3066 StartPrivateStateThread ();
3068 DynamicLoader *dyld = GetDynamicLoader ();
3072 GetJITLoaders().DidAttach();
3074 SystemRuntime *system_runtime = GetSystemRuntime ();
3076 system_runtime->DidAttach();
3078 m_os_ap.reset(OperatingSystem::FindPlugin(this, nullptr));
3079 // We successfully loaded a core file, now pretend we stopped so we can
3080 // show all of the threads in the core file and explore the crashed
3082 SetPrivateState (eStateStopped);
3084 // Wait indefinitely for a stopped event since we just posted one above...
3085 lldb::EventSP event_sp;
3086 listener_sp->WaitForEvent (nullptr, event_sp);
3087 StateType state = ProcessEventData::GetStateFromEvent(event_sp.get());
3089 if (!StateIsStoppedState (state, false))
3091 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3093 log->Printf("Process::Halt() failed to stop, state is: %s", StateAsCString(state));
3094 error.SetErrorString ("Did not get stopped event after loading the core file.");
3096 RestoreProcessEvents ();
3102 Process::GetDynamicLoader ()
3105 m_dyld_ap.reset(DynamicLoader::FindPlugin(this, nullptr));
3106 return m_dyld_ap.get();
3109 const lldb::DataBufferSP
3110 Process::GetAuxvData()
3112 return DataBufferSP ();
3116 Process::GetJITLoaders ()
3118 if (!m_jit_loaders_ap)
3120 m_jit_loaders_ap.reset(new JITLoaderList());
3121 JITLoader::LoadPlugins(this, *m_jit_loaders_ap);
3123 return *m_jit_loaders_ap;
3127 Process::GetSystemRuntime ()
3129 if (!m_system_runtime_ap)
3130 m_system_runtime_ap.reset(SystemRuntime::FindPlugin(this));
3131 return m_system_runtime_ap.get();
3134 Process::AttachCompletionHandler::AttachCompletionHandler (Process *process, uint32_t exec_count) :
3135 NextEventAction (process),
3136 m_exec_count (exec_count)
3138 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3140 log->Printf ("Process::AttachCompletionHandler::%s process=%p, exec_count=%" PRIu32, __FUNCTION__, static_cast<void*>(process), exec_count);
3143 Process::NextEventAction::EventActionResult
3144 Process::AttachCompletionHandler::PerformAction (lldb::EventSP &event_sp)
3146 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3148 StateType state = ProcessEventData::GetStateFromEvent (event_sp.get());
3150 log->Printf ("Process::AttachCompletionHandler::%s called with state %s (%d)", __FUNCTION__, StateAsCString(state), static_cast<int> (state));
3154 case eStateAttaching:
3155 return eEventActionSuccess;
3158 case eStateConnected:
3159 return eEventActionRetry;
3163 // During attach, prior to sending the eStateStopped event,
3164 // lldb_private::Process subclasses must set the new process ID.
3165 assert (m_process->GetID() != LLDB_INVALID_PROCESS_ID);
3166 // We don't want these events to be reported, so go set the ShouldReportStop here:
3167 m_process->GetThreadList().SetShouldReportStop (eVoteNo);
3169 if (m_exec_count > 0)
3174 log->Printf ("Process::AttachCompletionHandler::%s state %s: reduced remaining exec count to %" PRIu32 ", requesting resume", __FUNCTION__, StateAsCString(state), m_exec_count);
3177 return eEventActionRetry;
3182 log->Printf ("Process::AttachCompletionHandler::%s state %s: no more execs expected to start, continuing with attach", __FUNCTION__, StateAsCString(state));
3184 m_process->CompleteAttach ();
3185 return eEventActionSuccess;
3195 m_exit_string.assign ("No valid Process");
3196 return eEventActionExit;
3199 Process::NextEventAction::EventActionResult
3200 Process::AttachCompletionHandler::HandleBeingInterrupted()
3202 return eEventActionSuccess;
3206 Process::AttachCompletionHandler::GetExitString ()
3208 return m_exit_string.c_str();
3212 ProcessAttachInfo::GetListenerForProcess (Debugger &debugger)
3215 return m_listener_sp;
3217 return debugger.GetListener();
3221 Process::Attach (ProcessAttachInfo &attach_info)
3224 m_process_input_reader.reset();
3226 m_jit_loaders_ap.reset();
3227 m_system_runtime_ap.reset();
3229 m_stop_info_override_callback = nullptr;
3231 lldb::pid_t attach_pid = attach_info.GetProcessID();
3233 if (attach_pid == LLDB_INVALID_PROCESS_ID)
3235 char process_name[PATH_MAX];
3237 if (attach_info.GetExecutableFile().GetPath (process_name, sizeof(process_name)))
3239 const bool wait_for_launch = attach_info.GetWaitForLaunch();
3241 if (wait_for_launch)
3243 error = WillAttachToProcessWithName(process_name, wait_for_launch);
3244 if (error.Success())
3246 if (m_public_run_lock.TrySetRunning())
3248 m_should_detach = true;
3249 const bool restarted = false;
3250 SetPublicState (eStateAttaching, restarted);
3251 // Now attach using these arguments.
3252 error = DoAttachToProcessWithName (process_name, attach_info);
3256 // This shouldn't happen
3257 error.SetErrorString("failed to acquire process run lock");
3262 if (GetID() != LLDB_INVALID_PROCESS_ID)
3264 SetID (LLDB_INVALID_PROCESS_ID);
3265 if (error.AsCString() == nullptr)
3266 error.SetErrorString("attach failed");
3268 SetExitStatus(-1, error.AsCString());
3273 SetNextEventAction(new Process::AttachCompletionHandler(this, attach_info.GetResumeCount()));
3274 StartPrivateStateThread();
3281 ProcessInstanceInfoList process_infos;
3282 PlatformSP platform_sp (GetTarget().GetPlatform ());
3286 ProcessInstanceInfoMatch match_info;
3287 match_info.GetProcessInfo() = attach_info;
3288 match_info.SetNameMatchType (eNameMatchEquals);
3289 platform_sp->FindProcesses (match_info, process_infos);
3290 const uint32_t num_matches = process_infos.GetSize();
3291 if (num_matches == 1)
3293 attach_pid = process_infos.GetProcessIDAtIndex(0);
3294 // Fall through and attach using the above process ID
3298 match_info.GetProcessInfo().GetExecutableFile().GetPath (process_name, sizeof(process_name));
3299 if (num_matches > 1)
3302 ProcessInstanceInfo::DumpTableHeader (s, platform_sp.get(), true, false);
3303 for (size_t i = 0; i < num_matches; i++)
3305 process_infos.GetProcessInfoAtIndex(i).DumpAsTableRow(s, platform_sp.get(), true, false);
3307 error.SetErrorStringWithFormat ("more than one process named %s:\n%s",
3312 error.SetErrorStringWithFormat ("could not find a process named %s", process_name);
3317 error.SetErrorString ("invalid platform, can't find processes by name");
3324 error.SetErrorString ("invalid process name");
3328 if (attach_pid != LLDB_INVALID_PROCESS_ID)
3330 error = WillAttachToProcessWithID(attach_pid);
3331 if (error.Success())
3334 if (m_public_run_lock.TrySetRunning())
3336 // Now attach using these arguments.
3337 m_should_detach = true;
3338 const bool restarted = false;
3339 SetPublicState (eStateAttaching, restarted);
3340 error = DoAttachToProcessWithID (attach_pid, attach_info);
3344 // This shouldn't happen
3345 error.SetErrorString("failed to acquire process run lock");
3348 if (error.Success())
3350 SetNextEventAction(new Process::AttachCompletionHandler(this, attach_info.GetResumeCount()));
3351 StartPrivateStateThread();
3355 if (GetID() != LLDB_INVALID_PROCESS_ID)
3356 SetID (LLDB_INVALID_PROCESS_ID);
3358 const char *error_string = error.AsCString();
3359 if (error_string == nullptr)
3360 error_string = "attach failed";
3362 SetExitStatus(-1, error_string);
3370 Process::CompleteAttach ()
3372 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS | LIBLLDB_LOG_TARGET));
3374 log->Printf ("Process::%s()", __FUNCTION__);
3376 // Let the process subclass figure out at much as it can about the process
3377 // before we go looking for a dynamic loader plug-in.
3378 ArchSpec process_arch;
3379 DidAttach(process_arch);
3381 if (process_arch.IsValid())
3383 GetTarget().SetArchitecture(process_arch);
3386 const char *triple_str = process_arch.GetTriple().getTriple().c_str ();
3387 log->Printf ("Process::%s replacing process architecture with DidAttach() architecture: %s",
3389 triple_str ? triple_str : "<null>");
3393 // We just attached. If we have a platform, ask it for the process architecture, and if it isn't
3394 // the same as the one we've already set, switch architectures.
3395 PlatformSP platform_sp (GetTarget().GetPlatform ());
3396 assert(platform_sp);
3399 const ArchSpec &target_arch = GetTarget().GetArchitecture();
3400 if (target_arch.IsValid() && !platform_sp->IsCompatibleArchitecture(target_arch, false, nullptr))
3402 ArchSpec platform_arch;
3403 platform_sp = platform_sp->GetPlatformForArchitecture (target_arch, &platform_arch);
3406 GetTarget().SetPlatform (platform_sp);
3407 GetTarget().SetArchitecture(platform_arch);
3409 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 ());
3412 else if (!process_arch.IsValid())
3414 ProcessInstanceInfo process_info;
3415 GetProcessInfo(process_info);
3416 const ArchSpec &process_arch = process_info.GetArchitecture();
3417 if (process_arch.IsValid() && !GetTarget().GetArchitecture().IsExactMatch(process_arch))
3419 GetTarget().SetArchitecture (process_arch);
3421 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 ());
3426 // We have completed the attach, now it is time to find the dynamic loader
3428 DynamicLoader *dyld = GetDynamicLoader ();
3434 ModuleSP exe_module_sp = GetTarget().GetExecutableModule ();
3435 log->Printf ("Process::%s after DynamicLoader::DidAttach(), target executable is %s (using %s plugin)",
3437 exe_module_sp ? exe_module_sp->GetFileSpec().GetPath().c_str () : "<none>",
3438 dyld->GetPluginName().AsCString ("<unnamed>"));
3442 GetJITLoaders().DidAttach();
3444 SystemRuntime *system_runtime = GetSystemRuntime ();
3447 system_runtime->DidAttach();
3450 ModuleSP exe_module_sp = GetTarget().GetExecutableModule ();
3451 log->Printf ("Process::%s after SystemRuntime::DidAttach(), target executable is %s (using %s plugin)",
3453 exe_module_sp ? exe_module_sp->GetFileSpec().GetPath().c_str () : "<none>",
3454 system_runtime->GetPluginName().AsCString("<unnamed>"));
3458 m_os_ap.reset(OperatingSystem::FindPlugin(this, nullptr));
3459 // Figure out which one is the executable, and set that in our target:
3460 const ModuleList &target_modules = GetTarget().GetImages();
3461 std::lock_guard<std::recursive_mutex> guard(target_modules.GetMutex());
3462 size_t num_modules = target_modules.GetSize();
3463 ModuleSP new_executable_module_sp;
3465 for (size_t i = 0; i < num_modules; i++)
3467 ModuleSP module_sp (target_modules.GetModuleAtIndexUnlocked (i));
3468 if (module_sp && module_sp->IsExecutable())
3470 if (GetTarget().GetExecutableModulePointer() != module_sp.get())
3471 new_executable_module_sp = module_sp;
3475 if (new_executable_module_sp)
3477 GetTarget().SetExecutableModule (new_executable_module_sp, false);
3480 ModuleSP exe_module_sp = GetTarget().GetExecutableModule ();
3481 log->Printf ("Process::%s after looping through modules, target executable is %s",
3483 exe_module_sp ? exe_module_sp->GetFileSpec().GetPath().c_str () : "<none>");
3487 m_stop_info_override_callback = process_arch.GetStopInfoOverrideCallback();
3491 Process::ConnectRemote (Stream *strm, const char *remote_url)
3494 m_process_input_reader.reset();
3496 // Find the process and its architecture. Make sure it matches the architecture
3497 // of the current Target, and if not adjust it.
3499 Error error (DoConnectRemote (strm, remote_url));
3500 if (error.Success())
3502 if (GetID() != LLDB_INVALID_PROCESS_ID)
3505 StateType state = WaitForProcessStopPrivate(nullptr, event_sp);
3507 if (state == eStateStopped || state == eStateCrashed)
3509 // If we attached and actually have a process on the other end, then
3510 // this ended up being the equivalent of an attach.
3513 // This delays passing the stopped event to listeners till
3514 // CompleteAttach gets a chance to complete...
3515 HandlePrivateEvent (event_sp);
3519 if (PrivateStateThreadIsValid ())
3520 ResumePrivateStateThread ();
3522 StartPrivateStateThread ();
3528 Process::PrivateResume ()
3530 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS|LIBLLDB_LOG_STEP));
3532 log->Printf("Process::PrivateResume() m_stop_id = %u, public state: %s private state: %s",
3533 m_mod_id.GetStopID(),
3534 StateAsCString(m_public_state.GetValue()),
3535 StateAsCString(m_private_state.GetValue()));
3537 Error error (WillResume());
3538 // Tell the process it is about to resume before the thread list
3539 if (error.Success())
3541 // Now let the thread list know we are about to resume so it
3542 // can let all of our threads know that they are about to be
3543 // resumed. Threads will each be called with
3544 // Thread::WillResume(StateType) where StateType contains the state
3545 // that they are supposed to have when the process is resumed
3546 // (suspended/running/stepping). Threads should also check
3547 // their resume signal in lldb::Thread::GetResumeSignal()
3548 // to see if they are supposed to start back up with a signal.
3549 if (m_thread_list.WillResume())
3551 // Last thing, do the PreResumeActions.
3552 if (!RunPreResumeActions())
3554 error.SetErrorStringWithFormat ("Process::PrivateResume PreResumeActions failed, not resuming.");
3558 m_mod_id.BumpResumeID();
3560 if (error.Success())
3563 m_thread_list.DidResume();
3565 log->Printf ("Process thinks the process has resumed.");
3571 // Somebody wanted to run without running (e.g. we were faking a step from one frame of a set of inlined
3572 // frames that share the same PC to another.) So generate a continue & a stopped event,
3573 // and let the world handle them.
3575 log->Printf ("Process::PrivateResume() asked to simulate a start & stop.");
3577 SetPrivateState(eStateRunning);
3578 SetPrivateState(eStateStopped);
3582 log->Printf ("Process::PrivateResume() got an error \"%s\".", error.AsCString("<unknown error>"));
3587 Process::Halt (bool clear_thread_plans, bool use_run_lock)
3589 if (! StateIsRunningState(m_public_state.GetValue()))
3590 return Error("Process is not running.");
3592 // Don't clear the m_clear_thread_plans_on_stop, only set it to true if
3593 // in case it was already set and some thread plan logic calls halt on its
3595 m_clear_thread_plans_on_stop |= clear_thread_plans;
3597 ListenerSP halt_listener_sp (Listener::MakeListener("lldb.process.halt_listener"));
3598 HijackProcessEvents(halt_listener_sp);
3602 SendAsyncInterrupt();
3604 if (m_public_state.GetValue() == eStateAttaching)
3606 // Don't hijack and eat the eStateExited as the code that was doing
3607 // the attach will be waiting for this event...
3608 RestoreProcessEvents();
3609 SetExitStatus(SIGKILL, "Cancelled async attach.");
3614 // Wait for 10 second for the process to stop.
3615 TimeValue timeout_time;
3616 timeout_time = TimeValue::Now();
3617 timeout_time.OffsetWithSeconds(10);
3618 StateType state = WaitForProcessToStop(&timeout_time, &event_sp, true, halt_listener_sp,
3619 nullptr, use_run_lock);
3620 RestoreProcessEvents();
3622 if (state == eStateInvalid || ! event_sp)
3624 // We timed out and didn't get a stop event...
3625 return Error("Halt timed out. State = %s", StateAsCString(GetState()));
3628 BroadcastEvent(event_sp);
3634 Process::StopForDestroyOrDetach(lldb::EventSP &exit_event_sp)
3637 if (m_public_state.GetValue() == eStateRunning)
3639 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
3641 log->Printf("Process::%s() About to stop.", __FUNCTION__);
3643 ListenerSP listener_sp (Listener::MakeListener("lldb.Process.StopForDestroyOrDetach.hijack"));
3644 HijackProcessEvents(listener_sp);
3646 SendAsyncInterrupt();
3648 // Consume the interrupt event.
3649 TimeValue timeout (TimeValue::Now());
3650 timeout.OffsetWithSeconds(10);
3652 StateType state = WaitForProcessToStop (&timeout, &exit_event_sp, true, listener_sp);
3654 RestoreProcessEvents();
3656 // If the process exited while we were waiting for it to stop, put the exited event into
3657 // the shared pointer passed in and return. Our caller doesn't need to do anything else, since
3658 // they don't have a process anymore...
3660 if (state == eStateExited || m_private_state.GetValue() == eStateExited)
3663 log->Printf("Process::%s() Process exited while waiting to stop.", __FUNCTION__);
3667 exit_event_sp.reset(); // It is ok to consume any non-exit stop events
3669 if (state != eStateStopped)
3672 log->Printf("Process::%s() failed to stop, state is: %s", __FUNCTION__, StateAsCString(state));
3673 // If we really couldn't stop the process then we should just error out here, but if the
3674 // lower levels just bobbled sending the event and we really are stopped, then continue on.
3675 StateType private_state = m_private_state.GetValue();
3676 if (private_state != eStateStopped)
3678 return Error("Attempt to stop the target in order to detach timed out. State = %s", StateAsCString(GetState()));
3686 Process::Detach (bool keep_stopped)
3688 EventSP exit_event_sp;
3690 m_destroy_in_process = true;
3692 error = WillDetach();
3694 if (error.Success())
3696 if (DetachRequiresHalt())
3698 error = StopForDestroyOrDetach (exit_event_sp);
3699 if (!error.Success())
3701 m_destroy_in_process = false;
3704 else if (exit_event_sp)
3706 // We shouldn't need to do anything else here. There's no process left to detach from...
3707 StopPrivateStateThread();
3708 m_destroy_in_process = false;
3713 m_thread_list.DiscardThreadPlans();
3714 DisableAllBreakpointSites();
3716 error = DoDetach(keep_stopped);
3717 if (error.Success())
3720 StopPrivateStateThread();
3727 m_destroy_in_process = false;
3729 // If we exited when we were waiting for a process to stop, then
3730 // forward the event here so we don't lose the event
3733 // Directly broadcast our exited event because we shut down our
3734 // private state thread above
3735 BroadcastEvent(exit_event_sp);
3738 // If we have been interrupted (to kill us) in the middle of running, we may not end up propagating
3739 // the last events through the event system, in which case we might strand the write lock. Unlock
3740 // it here so when we do to tear down the process we don't get an error destroying the lock.
3742 m_public_run_lock.SetStopped();
3747 Process::Destroy (bool force_kill)
3750 // Tell ourselves we are in the process of destroying the process, so that we don't do any unnecessary work
3751 // that might hinder the destruction. Remember to set this back to false when we are done. That way if the attempt
3752 // failed and the process stays around for some reason it won't be in a confused state.
3755 m_should_detach = false;
3757 if (GetShouldDetach())
3759 // FIXME: This will have to be a process setting:
3760 bool keep_stopped = false;
3761 Detach(keep_stopped);
3764 m_destroy_in_process = true;
3766 Error error (WillDestroy());
3767 if (error.Success())
3769 EventSP exit_event_sp;
3770 if (DestroyRequiresHalt())
3772 error = StopForDestroyOrDetach(exit_event_sp);
3775 if (m_public_state.GetValue() != eStateRunning)
3777 // Ditch all thread plans, and remove all our breakpoints: in case we have to restart the target to
3778 // kill it, we don't want it hitting a breakpoint...
3779 // Only do this if we've stopped, however, since if we didn't manage to halt it above, then
3780 // we're not going to have much luck doing this now.
3781 m_thread_list.DiscardThreadPlans();
3782 DisableAllBreakpointSites();
3785 error = DoDestroy();
3786 if (error.Success())
3789 StopPrivateStateThread();
3791 m_stdio_communication.Disconnect();
3792 m_stdio_communication.StopReadThread();
3793 m_stdin_forward = false;
3795 if (m_process_input_reader)
3797 m_process_input_reader->SetIsDone(true);
3798 m_process_input_reader->Cancel();
3799 m_process_input_reader.reset();
3802 // If we exited when we were waiting for a process to stop, then
3803 // forward the event here so we don't lose the event
3806 // Directly broadcast our exited event because we shut down our
3807 // private state thread above
3808 BroadcastEvent(exit_event_sp);
3811 // If we have been interrupted (to kill us) in the middle of running, we may not end up propagating
3812 // the last events through the event system, in which case we might strand the write lock. Unlock
3813 // it here so when we do to tear down the process we don't get an error destroying the lock.
3814 m_public_run_lock.SetStopped();
3817 m_destroy_in_process = false;
3823 Process::Signal (int signal)
3825 Error error (WillSignal());
3826 if (error.Success())
3828 error = DoSignal(signal);
3829 if (error.Success())
3836 Process::SetUnixSignals(UnixSignalsSP &&signals_sp)
3838 assert (signals_sp && "null signals_sp");
3839 m_unix_signals_sp = signals_sp;
3842 const lldb::UnixSignalsSP &
3843 Process::GetUnixSignals ()
3845 assert (m_unix_signals_sp && "null m_unix_signals_sp");
3846 return m_unix_signals_sp;
3850 Process::GetByteOrder () const
3852 return GetTarget().GetArchitecture().GetByteOrder();
3856 Process::GetAddressByteSize () const
3858 return GetTarget().GetArchitecture().GetAddressByteSize();
3862 Process::ShouldBroadcastEvent (Event *event_ptr)
3864 const StateType state = Process::ProcessEventData::GetStateFromEvent (event_ptr);
3865 bool return_value = true;
3866 Log *log(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_EVENTS | LIBLLDB_LOG_PROCESS));
3870 case eStateDetached:
3872 case eStateUnloaded:
3873 m_stdio_communication.SynchronizeWithReadThread();
3874 m_stdio_communication.Disconnect();
3875 m_stdio_communication.StopReadThread();
3876 m_stdin_forward = false;
3879 case eStateConnected:
3880 case eStateAttaching:
3881 case eStateLaunching:
3882 // These events indicate changes in the state of the debugging session, always report them.
3883 return_value = true;
3886 // We stopped for no apparent reason, don't report it.
3887 return_value = false;
3890 case eStateStepping:
3891 // If we've started the target running, we handle the cases where we
3892 // are already running and where there is a transition from stopped to
3893 // running differently.
3894 // running -> running: Automatically suppress extra running events
3895 // stopped -> running: Report except when there is one or more no votes
3896 // and no yes votes.
3897 SynchronouslyNotifyStateChanged (state);
3898 if (m_force_next_event_delivery)
3899 return_value = true;
3902 switch (m_last_broadcast_state)
3905 case eStateStepping:
3906 // We always suppress multiple runnings with no PUBLIC stop in between.
3907 return_value = false;
3910 // TODO: make this work correctly. For now always report
3911 // run if we aren't running so we don't miss any running
3912 // events. If I run the lldb/test/thread/a.out file and
3913 // break at main.cpp:58, run and hit the breakpoints on
3914 // multiple threads, then somehow during the stepping over
3915 // of all breakpoints no run gets reported.
3917 // This is a transition from stop to run.
3918 switch (m_thread_list.ShouldReportRun (event_ptr))
3921 case eVoteNoOpinion:
3922 return_value = true;
3925 return_value = false;
3934 case eStateSuspended:
3935 // We've stopped. First see if we're going to restart the target.
3936 // If we are going to stop, then we always broadcast the event.
3937 // If we aren't going to stop, let the thread plans decide if we're going to report this event.
3938 // If no thread has an opinion, we don't report it.
3940 m_stdio_communication.SynchronizeWithReadThread();
3941 RefreshStateAfterStop ();
3942 if (ProcessEventData::GetInterruptedFromEvent (event_ptr))
3945 log->Printf ("Process::ShouldBroadcastEvent (%p) stopped due to an interrupt, state: %s",
3946 static_cast<void*>(event_ptr),
3947 StateAsCString(state));
3948 // Even though we know we are going to stop, we should let the threads have a look at the stop,
3949 // so they can properly set their state.
3950 m_thread_list.ShouldStop (event_ptr);
3951 return_value = true;
3955 bool was_restarted = ProcessEventData::GetRestartedFromEvent (event_ptr);
3956 bool should_resume = false;
3958 // It makes no sense to ask "ShouldStop" if we've already been restarted...
3959 // Asking the thread list is also not likely to go well, since we are running again.
3960 // So in that case just report the event.
3963 should_resume = !m_thread_list.ShouldStop(event_ptr);
3965 if (was_restarted || should_resume || m_resume_requested)
3967 Vote stop_vote = m_thread_list.ShouldReportStop (event_ptr);
3969 log->Printf ("Process::ShouldBroadcastEvent: should_resume: %i state: %s was_restarted: %i stop_vote: %d.",
3970 should_resume, StateAsCString(state),
3971 was_restarted, stop_vote);
3976 return_value = true;
3978 case eVoteNoOpinion:
3980 return_value = false;
3987 log->Printf ("Process::ShouldBroadcastEvent (%p) Restarting process from state: %s",
3988 static_cast<void*>(event_ptr),
3989 StateAsCString(state));
3990 ProcessEventData::SetRestartedInEvent(event_ptr, true);
3996 return_value = true;
3997 SynchronouslyNotifyStateChanged (state);
4003 // Forcing the next event delivery is a one shot deal. So reset it here.
4004 m_force_next_event_delivery = false;
4006 // We do some coalescing of events (for instance two consecutive running events get coalesced.)
4007 // But we only coalesce against events we actually broadcast. So we use m_last_broadcast_state
4008 // to track that. NB - you can't use "m_public_state.GetValue()" for that purpose, as was originally done,
4009 // because the PublicState reflects the last event pulled off the queue, and there may be several
4010 // events stacked up on the queue unserviced. So the PublicState may not reflect the last broadcasted event
4011 // yet. m_last_broadcast_state gets updated here.
4014 m_last_broadcast_state = state;
4017 log->Printf ("Process::ShouldBroadcastEvent (%p) => new state: %s, last broadcast state: %s - %s",
4018 static_cast<void*>(event_ptr), StateAsCString(state),
4019 StateAsCString(m_last_broadcast_state),
4020 return_value ? "YES" : "NO");
4021 return return_value;
4025 Process::StartPrivateStateThread (bool is_secondary_thread)
4027 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_EVENTS));
4029 bool already_running = PrivateStateThreadIsValid ();
4031 log->Printf ("Process::%s()%s ", __FUNCTION__, already_running ? " already running" : " starting private state thread");
4033 if (!is_secondary_thread && already_running)
4036 // Create a thread that watches our internal state and controls which
4037 // events make it to clients (into the DCProcess event queue).
4038 char thread_name[1024];
4040 if (HostInfo::GetMaxThreadNameLength() <= 30)
4042 // On platforms with abbreviated thread name lengths, choose thread names that fit within the limit.
4043 if (already_running)
4044 snprintf(thread_name, sizeof(thread_name), "intern-state-OV");
4046 snprintf(thread_name, sizeof(thread_name), "intern-state");
4050 if (already_running)
4051 snprintf(thread_name, sizeof(thread_name), "<lldb.process.internal-state-override(pid=%" PRIu64 ")>", GetID());
4053 snprintf(thread_name, sizeof(thread_name), "<lldb.process.internal-state(pid=%" PRIu64 ")>", GetID());
4056 // Create the private state thread, and start it running.
4057 PrivateStateThreadArgs *args_ptr = new PrivateStateThreadArgs(this, is_secondary_thread);
4058 m_private_state_thread = ThreadLauncher::LaunchThread(thread_name, Process::PrivateStateThread, (void *) args_ptr, nullptr, 8 * 1024 * 1024);
4059 if (m_private_state_thread.IsJoinable())
4061 ResumePrivateStateThread();
4069 Process::PausePrivateStateThread ()
4071 ControlPrivateStateThread (eBroadcastInternalStateControlPause);
4075 Process::ResumePrivateStateThread ()
4077 ControlPrivateStateThread (eBroadcastInternalStateControlResume);
4081 Process::StopPrivateStateThread ()
4083 if (m_private_state_thread.IsJoinable ())
4084 ControlPrivateStateThread (eBroadcastInternalStateControlStop);
4087 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
4089 log->Printf ("Went to stop the private state thread, but it was already invalid.");
4094 Process::ControlPrivateStateThread (uint32_t signal)
4096 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
4098 assert (signal == eBroadcastInternalStateControlStop ||
4099 signal == eBroadcastInternalStateControlPause ||
4100 signal == eBroadcastInternalStateControlResume);
4103 log->Printf ("Process::%s (signal = %d)", __FUNCTION__, signal);
4105 // Signal the private state thread
4106 if (m_private_state_thread.IsJoinable())
4108 // Broadcast the event.
4109 // It is important to do this outside of the if below, because
4110 // it's possible that the thread state is invalid but that the
4111 // thread is waiting on a control event instead of simply being
4112 // on its way out (this should not happen, but it apparently can).
4114 log->Printf ("Sending control event of type: %d.", signal);
4115 std::shared_ptr<EventDataReceipt> event_receipt_sp(new EventDataReceipt());
4116 m_private_state_control_broadcaster.BroadcastEvent(signal, event_receipt_sp);
4118 // Wait for the event receipt or for the private state thread to exit
4119 bool receipt_received = false;
4120 if (PrivateStateThreadIsValid())
4122 while (!receipt_received)
4124 bool timed_out = false;
4125 TimeValue timeout_time;
4126 timeout_time = TimeValue::Now();
4127 timeout_time.OffsetWithSeconds(2);
4128 // Check for a receipt for 2 seconds and then check if the private state
4129 // thread is still around.
4130 receipt_received = event_receipt_sp->WaitForEventReceived (&timeout_time, &timed_out);
4131 if (!receipt_received)
4133 // Check if the private state thread is still around. If it isn't then we are done waiting
4134 if (!PrivateStateThreadIsValid())
4135 break; // Private state thread exited or is exiting, we are done
4140 if (signal == eBroadcastInternalStateControlStop)
4142 thread_result_t result = NULL;
4143 m_private_state_thread.Join(&result);
4144 m_private_state_thread.Reset();
4150 log->Printf("Private state thread already dead, no need to signal it to stop.");
4155 Process::SendAsyncInterrupt ()
4157 if (PrivateStateThreadIsValid())
4158 m_private_state_broadcaster.BroadcastEvent(Process::eBroadcastBitInterrupt, nullptr);
4160 BroadcastEvent(Process::eBroadcastBitInterrupt, nullptr);
4164 Process::HandlePrivateEvent (EventSP &event_sp)
4166 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4167 m_resume_requested = false;
4169 const StateType new_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
4171 // First check to see if anybody wants a shot at this event:
4172 if (m_next_event_action_ap)
4174 NextEventAction::EventActionResult action_result = m_next_event_action_ap->PerformAction(event_sp);
4176 log->Printf ("Ran next event action, result was %d.", action_result);
4178 switch (action_result)
4180 case NextEventAction::eEventActionSuccess:
4181 SetNextEventAction(nullptr);
4184 case NextEventAction::eEventActionRetry:
4187 case NextEventAction::eEventActionExit:
4188 // Handle Exiting Here. If we already got an exited event,
4189 // we should just propagate it. Otherwise, swallow this event,
4190 // and set our state to exit so the next event will kill us.
4191 if (new_state != eStateExited)
4193 // FIXME: should cons up an exited event, and discard this one.
4194 SetExitStatus(0, m_next_event_action_ap->GetExitString());
4195 SetNextEventAction(nullptr);
4198 SetNextEventAction(nullptr);
4203 // See if we should broadcast this state to external clients?
4204 const bool should_broadcast = ShouldBroadcastEvent (event_sp.get());
4206 if (should_broadcast)
4208 const bool is_hijacked = IsHijackedForEvent(eBroadcastBitStateChanged);
4211 log->Printf ("Process::%s (pid = %" PRIu64 ") broadcasting new state %s (old state %s) to %s",
4214 StateAsCString(new_state),
4215 StateAsCString (GetState ()),
4216 is_hijacked ? "hijacked" : "public");
4218 Process::ProcessEventData::SetUpdateStateOnRemoval(event_sp.get());
4219 if (StateIsRunningState (new_state))
4221 // Only push the input handler if we aren't fowarding events,
4222 // as this means the curses GUI is in use...
4223 // Or don't push it if we are launching since it will come up stopped.
4224 if (!GetTarget().GetDebugger().IsForwardingEvents() && new_state != eStateLaunching &&
4225 new_state != eStateAttaching)
4227 PushProcessIOHandler ();
4228 m_iohandler_sync.SetValue(m_iohandler_sync.GetValue()+1, eBroadcastAlways);
4230 log->Printf("Process::%s updated m_iohandler_sync to %d", __FUNCTION__, m_iohandler_sync.GetValue());
4233 else if (StateIsStoppedState(new_state, false))
4235 if (!Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
4237 // If the lldb_private::Debugger is handling the events, we don't
4238 // want to pop the process IOHandler here, we want to do it when
4239 // we receive the stopped event so we can carefully control when
4240 // the process IOHandler is popped because when we stop we want to
4241 // display some text stating how and why we stopped, then maybe some
4242 // process/thread/frame info, and then we want the "(lldb) " prompt
4243 // to show up. If we pop the process IOHandler here, then we will
4244 // cause the command interpreter to become the top IOHandler after
4245 // the process pops off and it will update its prompt right away...
4246 // See the Debugger.cpp file where it calls the function as
4247 // "process_sp->PopProcessIOHandler()" to see where I am talking about.
4248 // Otherwise we end up getting overlapping "(lldb) " prompts and
4251 // If we aren't handling the events in the debugger (which is indicated
4252 // by "m_target.GetDebugger().IsHandlingEvents()" returning false) or we
4253 // are hijacked, then we always pop the process IO handler manually.
4254 // Hijacking happens when the internal process state thread is running
4255 // thread plans, or when commands want to run in synchronous mode
4256 // and they call "process->WaitForProcessToStop()". An example of something
4257 // that will hijack the events is a simple expression:
4259 // (lldb) expr (int)puts("hello")
4261 // This will cause the internal process state thread to resume and halt
4262 // the process (and _it_ will hijack the eBroadcastBitStateChanged
4263 // events) and we do need the IO handler to be pushed and popped
4266 if (is_hijacked || !GetTarget().GetDebugger().IsHandlingEvents())
4267 PopProcessIOHandler ();
4271 BroadcastEvent (event_sp);
4277 log->Printf ("Process::%s (pid = %" PRIu64 ") suppressing state %s (old state %s): should_broadcast == false",
4280 StateAsCString(new_state),
4281 StateAsCString (GetState ()));
4287 Process::HaltPrivate()
4290 Error error (WillHalt());
4294 // Ask the process subclass to actually halt our process
4296 error = DoHalt(caused_stop);
4303 Process::PrivateStateThread (void *arg)
4305 PrivateStateThreadArgs real_args = *static_cast<PrivateStateThreadArgs *> (arg);
4307 thread_result_t result = real_args.process->RunPrivateStateThread(real_args.is_secondary_thread);
4312 Process::RunPrivateStateThread (bool is_secondary_thread)
4314 bool control_only = true;
4316 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4318 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") thread starting...",
4319 __FUNCTION__, static_cast<void*>(this), GetID());
4321 bool exit_now = false;
4322 bool interrupt_requested = false;
4326 WaitForEventsPrivate(nullptr, event_sp, control_only);
4327 if (event_sp->BroadcasterIs(&m_private_state_control_broadcaster))
4330 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") got a control event: %d",
4331 __FUNCTION__, static_cast<void*>(this), GetID(),
4332 event_sp->GetType());
4334 switch (event_sp->GetType())
4336 case eBroadcastInternalStateControlStop:
4338 break; // doing any internal state management below
4340 case eBroadcastInternalStateControlPause:
4341 control_only = true;
4344 case eBroadcastInternalStateControlResume:
4345 control_only = false;
4351 else if (event_sp->GetType() == eBroadcastBitInterrupt)
4353 if (m_public_state.GetValue() == eStateAttaching)
4356 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") woke up with an interrupt while attaching - forwarding interrupt.",
4357 __FUNCTION__, static_cast<void*>(this),
4359 BroadcastEvent(eBroadcastBitInterrupt, nullptr);
4361 else if(StateIsRunningState(m_last_broadcast_state))
4364 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") woke up with an interrupt - Halting.",
4365 __FUNCTION__, static_cast<void*>(this),
4367 Error error = HaltPrivate();
4368 if (error.Fail() && log)
4369 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") failed to halt the process: %s",
4370 __FUNCTION__, static_cast<void*>(this),
4371 GetID(), error.AsCString());
4372 // Halt should generate a stopped event. Make a note of the fact that we were
4373 // doing the interrupt, so we can set the interrupted flag after we receive the
4374 // event. We deliberately set this to true even if HaltPrivate failed, so that we
4375 // can interrupt on the next natural stop.
4376 interrupt_requested = true;
4380 // This can happen when someone (e.g. Process::Halt) sees that we are running and
4381 // sends an interrupt request, but the process actually stops before we receive
4382 // it. In that case, we can just ignore the request. We use
4383 // m_last_broadcast_state, because the Stopped event may not have been popped of
4384 // the event queue yet, which is when the public state gets updated.
4386 log->Printf("Process::%s ignoring interrupt as we have already stopped.", __FUNCTION__);
4391 const StateType internal_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
4393 if (internal_state != eStateInvalid)
4395 if (m_clear_thread_plans_on_stop &&
4396 StateIsStoppedState(internal_state, true))
4398 m_clear_thread_plans_on_stop = false;
4399 m_thread_list.DiscardThreadPlans();
4402 if (interrupt_requested)
4404 if (StateIsStoppedState (internal_state, true))
4406 // We requested the interrupt, so mark this as such in the stop event so
4407 // clients can tell an interrupted process from a natural stop
4408 ProcessEventData::SetInterruptedInEvent (event_sp.get(), true);
4409 interrupt_requested = false;
4413 log->Printf("Process::%s interrupt_requested, but a non-stopped state '%s' received.",
4414 __FUNCTION__, StateAsCString(internal_state));
4418 HandlePrivateEvent (event_sp);
4421 if (internal_state == eStateInvalid ||
4422 internal_state == eStateExited ||
4423 internal_state == eStateDetached )
4426 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") about to exit with internal state %s...",
4427 __FUNCTION__, static_cast<void*>(this), GetID(),
4428 StateAsCString(internal_state));
4434 // Verify log is still enabled before attempting to write to it...
4436 log->Printf ("Process::%s (arg = %p, pid = %" PRIu64 ") thread exiting...",
4437 __FUNCTION__, static_cast<void*>(this), GetID());
4439 // If we are a secondary thread, then the primary thread we are working for will have already
4440 // acquired the public_run_lock, and isn't done with what it was doing yet, so don't
4441 // try to change it on the way out.
4442 if (!is_secondary_thread)
4443 m_public_run_lock.SetStopped();
4447 //------------------------------------------------------------------
4448 // Process Event Data
4449 //------------------------------------------------------------------
4451 Process::ProcessEventData::ProcessEventData () :
4454 m_state (eStateInvalid),
4455 m_restarted (false),
4457 m_interrupted (false)
4461 Process::ProcessEventData::ProcessEventData (const ProcessSP &process_sp, StateType state) :
4465 m_restarted (false),
4467 m_interrupted (false)
4470 m_process_wp = process_sp;
4473 Process::ProcessEventData::~ProcessEventData() = default;
4476 Process::ProcessEventData::GetFlavorString ()
4478 static ConstString g_flavor ("Process::ProcessEventData");
4483 Process::ProcessEventData::GetFlavor () const
4485 return ProcessEventData::GetFlavorString ();
4489 Process::ProcessEventData::DoOnRemoval (Event *event_ptr)
4491 ProcessSP process_sp(m_process_wp.lock());
4496 // This function gets called twice for each event, once when the event gets pulled
4497 // off of the private process event queue, and then any number of times, first when it gets pulled off of
4498 // the public event queue, then other times when we're pretending that this is where we stopped at the
4499 // end of expression evaluation. m_update_state is used to distinguish these
4500 // three cases; it is 0 when we're just pulling it off for private handling,
4501 // and > 1 for expression evaluation, and we don't want to do the breakpoint command handling then.
4502 if (m_update_state != 1)
4505 process_sp->SetPublicState (m_state, Process::ProcessEventData::GetRestartedFromEvent(event_ptr));
4507 // If this is a halt event, even if the halt stopped with some reason other than a plain interrupt (e.g. we had
4508 // already stopped for a breakpoint when the halt request came through) don't do the StopInfo actions, as they may
4509 // end up restarting the process.
4513 // If we're stopped and haven't restarted, then do the StopInfo actions here:
4514 if (m_state == eStateStopped && ! m_restarted)
4516 // Let process subclasses know we are about to do a public stop and
4517 // do anything they might need to in order to speed up register and
4519 process_sp->WillPublicStop();
4521 ThreadList &curr_thread_list = process_sp->GetThreadList();
4522 uint32_t num_threads = curr_thread_list.GetSize();
4525 // The actions might change one of the thread's stop_info's opinions about whether we should
4526 // stop the process, so we need to query that as we go.
4528 // One other complication here, is that we try to catch any case where the target has run (except for expressions)
4529 // and immediately exit, but if we get that wrong (which is possible) then the thread list might have changed, and
4530 // that would cause our iteration here to crash. We could make a copy of the thread list, but we'd really like
4531 // 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
4532 // against this list & bag out if anything differs.
4533 std::vector<uint32_t> thread_index_array(num_threads);
4534 for (idx = 0; idx < num_threads; ++idx)
4535 thread_index_array[idx] = curr_thread_list.GetThreadAtIndex(idx)->GetIndexID();
4537 // Use this to track whether we should continue from here. We will only continue the target running if
4538 // no thread says we should stop. Of course if some thread's PerformAction actually sets the target running,
4539 // then it doesn't matter what the other threads say...
4541 bool still_should_stop = false;
4543 // Sometimes - for instance if we have a bug in the stub we are talking to, we stop but no thread has a
4544 // valid stop reason. In that case we should just stop, because we have no way of telling what the right
4545 // thing to do is, and it's better to let the user decide than continue behind their backs.
4547 bool does_anybody_have_an_opinion = false;
4549 for (idx = 0; idx < num_threads; ++idx)
4551 curr_thread_list = process_sp->GetThreadList();
4552 if (curr_thread_list.GetSize() != num_threads)
4554 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STEP | LIBLLDB_LOG_PROCESS));
4556 log->Printf("Number of threads changed from %u to %u while processing event.", num_threads, curr_thread_list.GetSize());
4560 lldb::ThreadSP thread_sp = curr_thread_list.GetThreadAtIndex(idx);
4562 if (thread_sp->GetIndexID() != thread_index_array[idx])
4564 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STEP | LIBLLDB_LOG_PROCESS));
4566 log->Printf("The thread at position %u changed from %u to %u while processing event.",
4568 thread_index_array[idx],
4569 thread_sp->GetIndexID());
4573 StopInfoSP stop_info_sp = thread_sp->GetStopInfo ();
4574 if (stop_info_sp && stop_info_sp->IsValid())
4576 does_anybody_have_an_opinion = true;
4577 bool this_thread_wants_to_stop;
4578 if (stop_info_sp->GetOverrideShouldStop())
4580 this_thread_wants_to_stop = stop_info_sp->GetOverriddenShouldStopValue();
4584 stop_info_sp->PerformAction(event_ptr);
4585 // The stop action might restart the target. If it does, then we want to mark that in the
4586 // event so that whoever is receiving it will know to wait for the running event and reflect
4587 // that state appropriately.
4588 // We also need to stop processing actions, since they aren't expecting the target to be running.
4590 // FIXME: we might have run.
4591 if (stop_info_sp->HasTargetRunSinceMe())
4593 SetRestarted (true);
4597 this_thread_wants_to_stop = stop_info_sp->ShouldStop(event_ptr);
4600 if (!still_should_stop)
4601 still_should_stop = this_thread_wants_to_stop;
4605 if (!GetRestarted())
4607 if (!still_should_stop && does_anybody_have_an_opinion)
4609 // We've been asked to continue, so do that here.
4611 // Use the public resume method here, since this is just
4612 // extending a public resume.
4613 process_sp->PrivateResume();
4617 // If we didn't restart, run the Stop Hooks here:
4618 // They might also restart the target, so watch for that.
4619 process_sp->GetTarget().RunStopHooks();
4620 if (process_sp->GetPrivateState() == eStateRunning)
4628 Process::ProcessEventData::Dump (Stream *s) const
4630 ProcessSP process_sp(m_process_wp.lock());
4633 s->Printf(" process = %p (pid = %" PRIu64 "), ",
4634 static_cast<void*>(process_sp.get()), process_sp->GetID());
4636 s->PutCString(" process = NULL, ");
4638 s->Printf("state = %s", StateAsCString(GetState()));
4641 const Process::ProcessEventData *
4642 Process::ProcessEventData::GetEventDataFromEvent (const Event *event_ptr)
4646 const EventData *event_data = event_ptr->GetData();
4647 if (event_data && event_data->GetFlavor() == ProcessEventData::GetFlavorString())
4648 return static_cast <const ProcessEventData *> (event_ptr->GetData());
4654 Process::ProcessEventData::GetProcessFromEvent (const Event *event_ptr)
4656 ProcessSP process_sp;
4657 const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4659 process_sp = data->GetProcessSP();
4664 Process::ProcessEventData::GetStateFromEvent (const Event *event_ptr)
4666 const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4667 if (data == nullptr)
4668 return eStateInvalid;
4670 return data->GetState();
4674 Process::ProcessEventData::GetRestartedFromEvent (const Event *event_ptr)
4676 const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4677 if (data == nullptr)
4680 return data->GetRestarted();
4684 Process::ProcessEventData::SetRestartedInEvent (Event *event_ptr, bool new_value)
4686 ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4687 if (data != nullptr)
4688 data->SetRestarted(new_value);
4692 Process::ProcessEventData::GetNumRestartedReasons(const Event *event_ptr)
4694 ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4695 if (data != nullptr)
4696 return data->GetNumRestartedReasons();
4702 Process::ProcessEventData::GetRestartedReasonAtIndex(const Event *event_ptr, size_t idx)
4704 ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4705 if (data != nullptr)
4706 return data->GetRestartedReasonAtIndex(idx);
4712 Process::ProcessEventData::AddRestartedReason (Event *event_ptr, const char *reason)
4714 ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4715 if (data != nullptr)
4716 data->AddRestartedReason(reason);
4720 Process::ProcessEventData::GetInterruptedFromEvent (const Event *event_ptr)
4722 const ProcessEventData *data = GetEventDataFromEvent (event_ptr);
4723 if (data == nullptr)
4726 return data->GetInterrupted ();
4730 Process::ProcessEventData::SetInterruptedInEvent (Event *event_ptr, bool new_value)
4732 ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4733 if (data != nullptr)
4734 data->SetInterrupted(new_value);
4738 Process::ProcessEventData::SetUpdateStateOnRemoval (Event *event_ptr)
4740 ProcessEventData *data = const_cast<ProcessEventData *>(GetEventDataFromEvent (event_ptr));
4743 data->SetUpdateStateOnRemoval();
4750 Process::CalculateTarget ()
4752 return m_target_sp.lock();
4756 Process::CalculateExecutionContext (ExecutionContext &exe_ctx)
4758 exe_ctx.SetTargetPtr (&GetTarget());
4759 exe_ctx.SetProcessPtr (this);
4760 exe_ctx.SetThreadPtr(nullptr);
4761 exe_ctx.SetFramePtr(nullptr);
4765 //Process::ListProcessesMatchingName (const char *name, StringList &matches, std::vector<lldb::pid_t> &pids)
4771 //Process::GetArchSpecForExistingProcess (lldb::pid_t pid)
4773 // return Host::GetArchSpecForExistingProcess (pid);
4777 //Process::GetArchSpecForExistingProcess (const char *process_name)
4779 // return Host::GetArchSpecForExistingProcess (process_name);
4783 Process::AppendSTDOUT (const char * s, size_t len)
4785 std::lock_guard<std::recursive_mutex> guard(m_stdio_communication_mutex);
4786 m_stdout_data.append (s, len);
4787 BroadcastEventIfUnique (eBroadcastBitSTDOUT, new ProcessEventData (shared_from_this(), GetState()));
4791 Process::AppendSTDERR (const char * s, size_t len)
4793 std::lock_guard<std::recursive_mutex> guard(m_stdio_communication_mutex);
4794 m_stderr_data.append (s, len);
4795 BroadcastEventIfUnique (eBroadcastBitSTDERR, new ProcessEventData (shared_from_this(), GetState()));
4799 Process::BroadcastAsyncProfileData(const std::string &one_profile_data)
4801 std::lock_guard<std::recursive_mutex> guard(m_profile_data_comm_mutex);
4802 m_profile_data.push_back(one_profile_data);
4803 BroadcastEventIfUnique (eBroadcastBitProfileData, new ProcessEventData (shared_from_this(), GetState()));
4807 Process::GetAsyncProfileData (char *buf, size_t buf_size, Error &error)
4809 std::lock_guard<std::recursive_mutex> guard(m_profile_data_comm_mutex);
4810 if (m_profile_data.empty())
4813 std::string &one_profile_data = m_profile_data.front();
4814 size_t bytes_available = one_profile_data.size();
4815 if (bytes_available > 0)
4817 Log *log (lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4819 log->Printf ("Process::GetProfileData (buf = %p, size = %" PRIu64 ")",
4820 static_cast<void*>(buf),
4821 static_cast<uint64_t>(buf_size));
4822 if (bytes_available > buf_size)
4824 memcpy(buf, one_profile_data.c_str(), buf_size);
4825 one_profile_data.erase(0, buf_size);
4826 bytes_available = buf_size;
4830 memcpy(buf, one_profile_data.c_str(), bytes_available);
4831 m_profile_data.erase(m_profile_data.begin());
4834 return bytes_available;
4837 //------------------------------------------------------------------
4839 //------------------------------------------------------------------
4842 Process::GetSTDOUT (char *buf, size_t buf_size, Error &error)
4844 std::lock_guard<std::recursive_mutex> guard(m_stdio_communication_mutex);
4845 size_t bytes_available = m_stdout_data.size();
4846 if (bytes_available > 0)
4848 Log *log (lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4850 log->Printf ("Process::GetSTDOUT (buf = %p, size = %" PRIu64 ")",
4851 static_cast<void*>(buf),
4852 static_cast<uint64_t>(buf_size));
4853 if (bytes_available > buf_size)
4855 memcpy(buf, m_stdout_data.c_str(), buf_size);
4856 m_stdout_data.erase(0, buf_size);
4857 bytes_available = buf_size;
4861 memcpy(buf, m_stdout_data.c_str(), bytes_available);
4862 m_stdout_data.clear();
4865 return bytes_available;
4869 Process::GetSTDERR (char *buf, size_t buf_size, Error &error)
4871 std::lock_guard<std::recursive_mutex> gaurd(m_stdio_communication_mutex);
4872 size_t bytes_available = m_stderr_data.size();
4873 if (bytes_available > 0)
4875 Log *log (lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
4877 log->Printf ("Process::GetSTDERR (buf = %p, size = %" PRIu64 ")",
4878 static_cast<void*>(buf),
4879 static_cast<uint64_t>(buf_size));
4880 if (bytes_available > buf_size)
4882 memcpy(buf, m_stderr_data.c_str(), buf_size);
4883 m_stderr_data.erase(0, buf_size);
4884 bytes_available = buf_size;
4888 memcpy(buf, m_stderr_data.c_str(), bytes_available);
4889 m_stderr_data.clear();
4892 return bytes_available;
4896 Process::STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len)
4898 Process *process = (Process *) baton;
4899 process->AppendSTDOUT (static_cast<const char *>(src), src_len);
4902 class IOHandlerProcessSTDIO :
4906 IOHandlerProcessSTDIO (Process *process,
4908 IOHandler(process->GetTarget().GetDebugger(), IOHandler::Type::ProcessIO),
4909 m_process (process),
4911 m_write_file (write_fd, false),
4914 m_pipe.CreateNew(false);
4915 m_read_file.SetDescriptor(GetInputFD(), false);
4918 ~IOHandlerProcessSTDIO() override = default;
4920 // Each IOHandler gets to run until it is done. It should read data
4921 // from the "in" and place output into "out" and "err and return
4926 if (!m_read_file.IsValid() || !m_write_file.IsValid() || !m_pipe.CanRead() || !m_pipe.CanWrite())
4933 const int read_fd = m_read_file.GetDescriptor();
4934 TerminalState terminal_state;
4935 terminal_state.Save (read_fd, false);
4936 Terminal terminal(read_fd);
4937 terminal.SetCanonical(false);
4938 terminal.SetEcho(false);
4939 // FD_ZERO, FD_SET are not supported on windows
4941 const int pipe_read_fd = m_pipe.GetReadFileDescriptor();
4942 m_is_running = true;
4943 while (!GetIsDone())
4946 FD_ZERO (&read_fdset);
4947 FD_SET (read_fd, &read_fdset);
4948 FD_SET (pipe_read_fd, &read_fdset);
4949 const int nfds = std::max<int>(read_fd, pipe_read_fd) + 1;
4950 int num_set_fds = select(nfds, &read_fdset, nullptr, nullptr, nullptr);
4952 if (num_set_fds < 0)
4954 const int select_errno = errno;
4956 if (select_errno != EINTR)
4959 else if (num_set_fds > 0)
4963 if (FD_ISSET (read_fd, &read_fdset))
4966 if (m_read_file.Read(&ch, n).Success() && n == 1)
4968 if (m_write_file.Write(&ch, n).Fail() || n != 1)
4974 if (FD_ISSET (pipe_read_fd, &read_fdset))
4977 // Consume the interrupt byte
4978 Error error = m_pipe.Read(&ch, 1, bytes_read);
4979 if (error.Success())
4987 if (StateIsRunningState(m_process->GetState()))
4988 m_process->SendAsyncInterrupt();
4995 m_is_running = false;
4997 terminal_state.Restore();
5004 // Only write to our pipe to cancel if we are in IOHandlerProcessSTDIO::Run().
5005 // We can end up with a python command that is being run from the command
5008 // (lldb) step_process_thousands_of_times
5010 // In this case the command interpreter will be in the middle of handling
5011 // the command and if the process pushes and pops the IOHandler thousands
5012 // of times, we can end up writing to m_pipe without ever consuming the
5013 // bytes from the pipe in IOHandlerProcessSTDIO::Run() and end up
5014 // deadlocking when the pipe gets fed up and blocks until data is consumed.
5017 char ch = 'q'; // Send 'q' for quit
5018 size_t bytes_written = 0;
5019 m_pipe.Write(&ch, 1, bytes_written);
5024 Interrupt () override
5026 // Do only things that are safe to do in an interrupt context (like in
5027 // a SIGINT handler), like write 1 byte to a file descriptor. This will
5028 // interrupt the IOHandlerProcessSTDIO::Run() and we can look at the byte
5029 // that was written to the pipe and then call m_process->SendAsyncInterrupt()
5030 // from a much safer location in code.
5033 char ch = 'i'; // Send 'i' for interrupt
5034 size_t bytes_written = 0;
5035 Error result = m_pipe.Write(&ch, 1, bytes_written);
5036 return result.Success();
5040 // This IOHandler might be pushed on the stack, but not being run currently
5041 // so do the right thing if we aren't actively watching for STDIN by sending
5042 // the interrupt to the process. Otherwise the write to the pipe above would
5043 // do nothing. This can happen when the command interpreter is running and
5044 // gets a "expression ...". It will be on the IOHandler thread and sending
5045 // the input is complete to the delegate which will cause the expression to
5046 // run, which will push the process IO handler, but not run it.
5048 if (StateIsRunningState(m_process->GetState()))
5050 m_process->SendAsyncInterrupt();
5064 File m_read_file; // Read from this file (usually actual STDIN for LLDB
5065 File m_write_file; // Write to this file (usually the master pty for getting io to debuggee)
5067 std::atomic<bool> m_is_running;
5071 Process::SetSTDIOFileDescriptor (int fd)
5073 // First set up the Read Thread for reading/handling process I/O
5075 std::unique_ptr<ConnectionFileDescriptor> conn_ap (new ConnectionFileDescriptor (fd, true));
5079 m_stdio_communication.SetConnection (conn_ap.release());
5080 if (m_stdio_communication.IsConnected())
5082 m_stdio_communication.SetReadThreadBytesReceivedCallback (STDIOReadThreadBytesReceived, this);
5083 m_stdio_communication.StartReadThread();
5085 // Now read thread is set up, set up input reader.
5087 if (!m_process_input_reader)
5088 m_process_input_reader.reset (new IOHandlerProcessSTDIO (this, fd));
5094 Process::ProcessIOHandlerIsActive ()
5096 IOHandlerSP io_handler_sp (m_process_input_reader);
5098 return GetTarget().GetDebugger().IsTopIOHandler (io_handler_sp);
5102 Process::PushProcessIOHandler ()
5104 IOHandlerSP io_handler_sp (m_process_input_reader);
5107 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
5109 log->Printf("Process::%s pushing IO handler", __FUNCTION__);
5111 io_handler_sp->SetIsDone(false);
5112 GetTarget().GetDebugger().PushIOHandler (io_handler_sp);
5119 Process::PopProcessIOHandler ()
5121 IOHandlerSP io_handler_sp (m_process_input_reader);
5123 return GetTarget().GetDebugger().PopIOHandler (io_handler_sp);
5127 // The process needs to know about installed plug-ins
5129 Process::SettingsInitialize ()
5131 Thread::SettingsInitialize ();
5135 Process::SettingsTerminate ()
5137 Thread::SettingsTerminate ();
5142 // RestorePlanState is used to record the "is private", "is master" and "okay to discard" fields of
5143 // the plan we are running, and reset it on Clean or on destruction.
5144 // It will only reset the state once, so you can call Clean and then monkey with the state and it
5145 // won't get reset on you again.
5147 class RestorePlanState
5150 RestorePlanState (lldb::ThreadPlanSP thread_plan_sp) :
5151 m_thread_plan_sp(thread_plan_sp),
5152 m_already_reset(false)
5154 if (m_thread_plan_sp)
5156 m_private = m_thread_plan_sp->GetPrivate();
5157 m_is_master = m_thread_plan_sp->IsMasterPlan();
5158 m_okay_to_discard = m_thread_plan_sp->OkayToDiscard();
5170 if (!m_already_reset && m_thread_plan_sp)
5172 m_already_reset = true;
5173 m_thread_plan_sp->SetPrivate(m_private);
5174 m_thread_plan_sp->SetIsMasterPlan (m_is_master);
5175 m_thread_plan_sp->SetOkayToDiscard(m_okay_to_discard);
5180 lldb::ThreadPlanSP m_thread_plan_sp;
5181 bool m_already_reset;
5184 bool m_okay_to_discard;
5186 } // anonymous namespace
5189 Process::RunThreadPlan(ExecutionContext &exe_ctx, lldb::ThreadPlanSP &thread_plan_sp,
5190 const EvaluateExpressionOptions &options, DiagnosticManager &diagnostic_manager)
5192 ExpressionResults return_value = eExpressionSetupError;
5194 std::lock_guard<std::mutex> run_thread_plan_locker(m_run_thread_plan_lock);
5196 if (!thread_plan_sp)
5198 diagnostic_manager.PutCString(eDiagnosticSeverityError, "RunThreadPlan called with empty thread plan.");
5199 return eExpressionSetupError;
5202 if (!thread_plan_sp->ValidatePlan(nullptr))
5204 diagnostic_manager.PutCString(eDiagnosticSeverityError, "RunThreadPlan called with an invalid thread plan.");
5205 return eExpressionSetupError;
5208 if (exe_ctx.GetProcessPtr() != this)
5210 diagnostic_manager.PutCString(eDiagnosticSeverityError, "RunThreadPlan called on wrong process.");
5211 return eExpressionSetupError;
5214 Thread *thread = exe_ctx.GetThreadPtr();
5215 if (thread == nullptr)
5217 diagnostic_manager.PutCString(eDiagnosticSeverityError, "RunThreadPlan called with invalid thread.");
5218 return eExpressionSetupError;
5221 // We need to change some of the thread plan attributes for the thread plan runner. This will restore them
5222 // when we are done:
5224 RestorePlanState thread_plan_restorer(thread_plan_sp);
5226 // We rely on the thread plan we are running returning "PlanCompleted" if when it successfully completes.
5227 // For that to be true the plan can't be private - since private plans suppress themselves in the
5228 // GetCompletedPlan call.
5230 thread_plan_sp->SetPrivate(false);
5232 // The plans run with RunThreadPlan also need to be terminal master plans or when they are done we will end
5233 // up asking the plan above us whether we should stop, which may give the wrong answer.
5235 thread_plan_sp->SetIsMasterPlan (true);
5236 thread_plan_sp->SetOkayToDiscard(false);
5238 if (m_private_state.GetValue() != eStateStopped)
5240 diagnostic_manager.PutCString(eDiagnosticSeverityError,
5241 "RunThreadPlan called while the private state was not stopped.");
5242 return eExpressionSetupError;
5245 // Save the thread & frame from the exe_ctx for restoration after we run
5246 const uint32_t thread_idx_id = thread->GetIndexID();
5247 StackFrameSP selected_frame_sp = thread->GetSelectedFrame();
5248 if (!selected_frame_sp)
5250 thread->SetSelectedFrame(nullptr);
5251 selected_frame_sp = thread->GetSelectedFrame();
5252 if (!selected_frame_sp)
5254 diagnostic_manager.Printf(eDiagnosticSeverityError,
5255 "RunThreadPlan called without a selected frame on thread %d", thread_idx_id);
5256 return eExpressionSetupError;
5260 StackID ctx_frame_id = selected_frame_sp->GetStackID();
5262 // N.B. Running the target may unset the currently selected thread and frame. We don't want to do that either,
5263 // so we should arrange to reset them as well.
5265 lldb::ThreadSP selected_thread_sp = GetThreadList().GetSelectedThread();
5267 uint32_t selected_tid;
5268 StackID selected_stack_id;
5269 if (selected_thread_sp)
5271 selected_tid = selected_thread_sp->GetIndexID();
5272 selected_stack_id = selected_thread_sp->GetSelectedFrame()->GetStackID();
5276 selected_tid = LLDB_INVALID_THREAD_ID;
5279 HostThread backup_private_state_thread;
5280 lldb::StateType old_state = eStateInvalid;
5281 lldb::ThreadPlanSP stopper_base_plan_sp;
5283 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_STEP | LIBLLDB_LOG_PROCESS));
5284 if (m_private_state_thread.EqualsThread(Host::GetCurrentThread()))
5286 // Yikes, we are running on the private state thread! So we can't wait for public events on this thread, since
5287 // we are the thread that is generating public events.
5288 // The simplest thing to do is to spin up a temporary thread to handle private state thread events while
5289 // we are fielding public events here.
5291 log->Printf ("Running thread plan on private state thread, spinning up another state thread to handle the events.");
5293 backup_private_state_thread = m_private_state_thread;
5295 // One other bit of business: we want to run just this thread plan and anything it pushes, and then stop,
5296 // returning control here.
5297 // But in the normal course of things, the plan above us on the stack would be given a shot at the stop
5298 // event before deciding to stop, and we don't want that. So we insert a "stopper" base plan on the stack
5299 // before the plan we want to run. Since base plans always stop and return control to the user, that will
5300 // do just what we want.
5301 stopper_base_plan_sp.reset(new ThreadPlanBase (*thread));
5302 thread->QueueThreadPlan (stopper_base_plan_sp, false);
5303 // Have to make sure our public state is stopped, since otherwise the reporting logic below doesn't work correctly.
5304 old_state = m_public_state.GetValue();
5305 m_public_state.SetValueNoLock(eStateStopped);
5307 // Now spin up the private state thread:
5308 StartPrivateStateThread(true);
5311 thread->QueueThreadPlan(thread_plan_sp, false); // This used to pass "true" does that make sense?
5313 if (options.GetDebug())
5315 // In this case, we aren't actually going to run, we just want to stop right away.
5316 // Flush this thread so we will refetch the stacks and show the correct backtrace.
5317 // FIXME: To make this prettier we should invent some stop reason for this, but that
5318 // is only cosmetic, and this functionality is only of use to lldb developers who can
5319 // live with not pretty...
5321 return eExpressionStoppedForDebug;
5324 ListenerSP listener_sp(Listener::MakeListener("lldb.process.listener.run-thread-plan"));
5326 lldb::EventSP event_to_broadcast_sp;
5329 // This process event hijacker Hijacks the Public events and its destructor makes sure that the process events get
5330 // restored on exit to the function.
5332 // If the event needs to propagate beyond the hijacker (e.g., the process exits during execution), then the event
5333 // is put into event_to_broadcast_sp for rebroadcasting.
5335 ProcessEventHijacker run_thread_plan_hijacker (*this, listener_sp);
5340 thread_plan_sp->GetDescription(&s, lldb::eDescriptionLevelVerbose);
5341 log->Printf ("Process::RunThreadPlan(): Resuming thread %u - 0x%4.4" PRIx64 " to run thread plan \"%s\".",
5342 thread->GetIndexID(),
5348 lldb::EventSP event_sp;
5349 lldb::StateType stop_state = lldb::eStateInvalid;
5351 TimeValue* timeout_ptr = nullptr;
5352 TimeValue real_timeout;
5354 bool before_first_timeout = true; // This is set to false the first time that we have to halt the target.
5355 bool do_resume = true;
5356 bool handle_running_event = true;
5357 const uint64_t default_one_thread_timeout_usec = 250000;
5359 // This is just for accounting:
5360 uint32_t num_resumes = 0;
5362 uint32_t timeout_usec = options.GetTimeoutUsec();
5363 uint32_t one_thread_timeout_usec;
5364 uint32_t all_threads_timeout_usec = 0;
5366 // If we are going to run all threads the whole time, or if we are only going to run one thread,
5367 // then we don't need the first timeout. So we set the final timeout, and pretend we are after the
5368 // first timeout already.
5370 if (!options.GetStopOthers() || !options.GetTryAllThreads())
5372 before_first_timeout = false;
5373 one_thread_timeout_usec = 0;
5374 all_threads_timeout_usec = timeout_usec;
5378 uint32_t option_one_thread_timeout = options.GetOneThreadTimeoutUsec();
5380 // If the overall wait is forever, then we only need to set the one thread timeout:
5381 if (timeout_usec == 0)
5383 if (option_one_thread_timeout != 0)
5384 one_thread_timeout_usec = option_one_thread_timeout;
5386 one_thread_timeout_usec = default_one_thread_timeout_usec;
5390 // Otherwise, if the one thread timeout is set, make sure it isn't longer than the overall timeout,
5391 // and use it, otherwise use half the total timeout, bounded by the default_one_thread_timeout_usec.
5392 uint64_t computed_one_thread_timeout;
5393 if (option_one_thread_timeout != 0)
5395 if (timeout_usec < option_one_thread_timeout)
5397 diagnostic_manager.PutCString(
5398 eDiagnosticSeverityError,
5399 "RunThreadPlan called without one thread timeout greater than total timeout");
5400 return eExpressionSetupError;
5402 computed_one_thread_timeout = option_one_thread_timeout;
5406 computed_one_thread_timeout = timeout_usec / 2;
5407 if (computed_one_thread_timeout > default_one_thread_timeout_usec)
5408 computed_one_thread_timeout = default_one_thread_timeout_usec;
5410 one_thread_timeout_usec = computed_one_thread_timeout;
5411 all_threads_timeout_usec = timeout_usec - one_thread_timeout_usec;
5416 log->Printf ("Stop others: %u, try all: %u, before_first: %u, one thread: %" PRIu32 " - all threads: %" PRIu32 ".\n",
5417 options.GetStopOthers(),
5418 options.GetTryAllThreads(),
5419 before_first_timeout,
5420 one_thread_timeout_usec,
5421 all_threads_timeout_usec);
5423 // This isn't going to work if there are unfetched events on the queue.
5424 // Are there cases where we might want to run the remaining events here, and then try to
5425 // call the function? That's probably being too tricky for our own good.
5427 Event *other_events = listener_sp->PeekAtNextEvent();
5428 if (other_events != nullptr)
5430 diagnostic_manager.PutCString(eDiagnosticSeverityError,
5431 "RunThreadPlan called with pending events on the queue.");
5432 return eExpressionSetupError;
5435 // We also need to make sure that the next event is delivered. We might be calling a function as part of
5436 // a thread plan, in which case the last delivered event could be the running event, and we don't want
5437 // event coalescing to cause us to lose OUR running event...
5438 ForceNextEventDelivery();
5440 // This while loop must exit out the bottom, there's cleanup that we need to do when we are done.
5441 // So don't call return anywhere within it.
5443 #ifdef LLDB_RUN_THREAD_HALT_WITH_EVENT
5444 // It's pretty much impossible to write test cases for things like:
5445 // One thread timeout expires, I go to halt, but the process already stopped
5446 // on the function call stop breakpoint. Turning on this define will make us not
5447 // fetch the first event till after the halt. So if you run a quick function, it will have
5448 // completed, and the completion event will be waiting, when you interrupt for halt.
5449 // The expression evaluation should still succeed.
5450 bool miss_first_event = true;
5452 TimeValue one_thread_timeout;
5453 TimeValue final_timeout;
5457 // We usually want to resume the process if we get to the top of the loop.
5458 // The only exception is if we get two running events with no intervening
5459 // stop, which can happen, we will just wait for then next stop event.
5461 log->Printf ("Top of while loop: do_resume: %i handle_running_event: %i before_first_timeout: %i.",
5463 handle_running_event,
5464 before_first_timeout);
5466 if (do_resume || handle_running_event)
5468 // Do the initial resume and wait for the running event before going further.
5473 Error resume_error = PrivateResume();
5474 if (!resume_error.Success())
5476 diagnostic_manager.Printf(eDiagnosticSeverityError,
5477 "couldn't resume inferior the %d time: \"%s\".", num_resumes,
5478 resume_error.AsCString());
5479 return_value = eExpressionSetupError;
5484 TimeValue resume_timeout = TimeValue::Now();
5485 resume_timeout.OffsetWithMicroSeconds(500000);
5487 got_event = listener_sp->WaitForEvent(&resume_timeout, event_sp);
5491 log->Printf("Process::RunThreadPlan(): didn't get any event after resume %" PRIu32 ", exiting.",
5494 diagnostic_manager.Printf(eDiagnosticSeverityError,
5495 "didn't get any event after resume %" PRIu32 ", exiting.", num_resumes);
5496 return_value = eExpressionSetupError;
5500 stop_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
5502 if (stop_state != eStateRunning)
5504 bool restarted = false;
5506 if (stop_state == eStateStopped)
5508 restarted = Process::ProcessEventData::GetRestartedFromEvent(event_sp.get());
5510 log->Printf("Process::RunThreadPlan(): didn't get running event after "
5511 "resume %d, got %s instead (restarted: %i, do_resume: %i, handle_running_event: %i).",
5513 StateAsCString(stop_state),
5516 handle_running_event);
5521 // This is probably an overabundance of caution, I don't think I should ever get a stopped & restarted
5522 // event here. But if I do, the best thing is to Halt and then get out of here.
5523 const bool clear_thread_plans = false;
5524 const bool use_run_lock = false;
5525 Halt(clear_thread_plans, use_run_lock);
5528 diagnostic_manager.Printf(eDiagnosticSeverityError,
5529 "didn't get running event after initial resume, got %s instead.",
5530 StateAsCString(stop_state));
5531 return_value = eExpressionSetupError;
5536 log->PutCString ("Process::RunThreadPlan(): resuming succeeded.");
5537 // We need to call the function synchronously, so spin waiting for it to return.
5538 // If we get interrupted while executing, we're going to lose our context, and
5539 // won't be able to gather the result at this point.
5540 // We set the timeout AFTER the resume, since the resume takes some time and we
5541 // don't want to charge that to the timeout.
5546 log->PutCString ("Process::RunThreadPlan(): waiting for next event.");
5549 if (before_first_timeout)
5551 if (options.GetTryAllThreads())
5553 one_thread_timeout = TimeValue::Now();
5554 one_thread_timeout.OffsetWithMicroSeconds(one_thread_timeout_usec);
5555 timeout_ptr = &one_thread_timeout;
5559 if (timeout_usec == 0)
5560 timeout_ptr = nullptr;
5563 final_timeout = TimeValue::Now();
5564 final_timeout.OffsetWithMicroSeconds (timeout_usec);
5565 timeout_ptr = &final_timeout;
5571 if (timeout_usec == 0)
5572 timeout_ptr = nullptr;
5575 final_timeout = TimeValue::Now();
5576 final_timeout.OffsetWithMicroSeconds (all_threads_timeout_usec);
5577 timeout_ptr = &final_timeout;
5582 handle_running_event = true;
5584 // Now wait for the process to stop again:
5591 log->Printf ("Process::RunThreadPlan(): about to wait - now is %" PRIu64 " - endpoint is %" PRIu64,
5592 TimeValue::Now().GetAsMicroSecondsSinceJan1_1970(),
5593 timeout_ptr->GetAsMicroSecondsSinceJan1_1970());
5597 log->Printf ("Process::RunThreadPlan(): about to wait forever.");
5601 #ifdef LLDB_RUN_THREAD_HALT_WITH_EVENT
5602 // See comment above...
5603 if (miss_first_event)
5606 miss_first_event = false;
5611 got_event = listener_sp->WaitForEvent (timeout_ptr, event_sp);
5617 bool keep_going = false;
5618 if (event_sp->GetType() == eBroadcastBitInterrupt)
5620 const bool clear_thread_plans = false;
5621 const bool use_run_lock = false;
5622 Halt(clear_thread_plans, use_run_lock);
5623 return_value = eExpressionInterrupted;
5624 diagnostic_manager.PutCString(eDiagnosticSeverityRemark, "execution halted by user interrupt.");
5627 "Process::RunThreadPlan(): Got interrupted by eBroadcastBitInterrupted, exiting.");
5632 stop_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
5634 log->Printf("Process::RunThreadPlan(): in while loop, got event: %s.", StateAsCString(stop_state));
5638 case lldb::eStateStopped:
5640 // We stopped, figure out what we are going to do now.
5641 ThreadSP thread_sp = GetThreadList().FindThreadByIndexID (thread_idx_id);
5644 // Ooh, our thread has vanished. Unlikely that this was successful execution...
5646 log->Printf ("Process::RunThreadPlan(): execution completed but our thread (index-id=%u) has vanished.", thread_idx_id);
5647 return_value = eExpressionInterrupted;
5651 // If we were restarted, we just need to go back up to fetch another event.
5652 if (Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
5656 log->Printf ("Process::RunThreadPlan(): Got a stop and restart, so we'll continue waiting.");
5660 handle_running_event = true;
5664 StopInfoSP stop_info_sp (thread_sp->GetStopInfo ());
5665 StopReason stop_reason = eStopReasonInvalid;
5667 stop_reason = stop_info_sp->GetStopReason();
5669 // FIXME: We only check if the stop reason is plan complete, should we make sure that
5670 // it is OUR plan that is complete?
5671 if (stop_reason == eStopReasonPlanComplete)
5674 log->PutCString ("Process::RunThreadPlan(): execution completed successfully.");
5676 // Restore the plan state so it will get reported as intended when we are done.
5677 thread_plan_restorer.Clean();
5679 return_value = eExpressionCompleted;
5683 // Something restarted the target, so just wait for it to stop for real.
5684 if (stop_reason == eStopReasonBreakpoint)
5687 log->Printf ("Process::RunThreadPlan() stopped for breakpoint: %s.", stop_info_sp->GetDescription());
5688 return_value = eExpressionHitBreakpoint;
5689 if (!options.DoesIgnoreBreakpoints())
5691 // Restore the plan state and then force Private to false. We are
5692 // going to stop because of this plan so we need it to become a public
5693 // plan or it won't report correctly when we continue to its termination
5695 thread_plan_restorer.Clean();
5697 thread_plan_sp->SetPrivate(false);
5698 event_to_broadcast_sp = event_sp;
5704 log->PutCString ("Process::RunThreadPlan(): thread plan didn't successfully complete.");
5705 if (!options.DoesUnwindOnError())
5706 event_to_broadcast_sp = event_sp;
5707 return_value = eExpressionInterrupted;
5715 case lldb::eStateRunning:
5716 // This shouldn't really happen, but sometimes we do get two running events without an
5717 // intervening stop, and in that case we should just go back to waiting for the stop.
5720 handle_running_event = false;
5725 log->Printf("Process::RunThreadPlan(): execution stopped with unexpected state: %s.", StateAsCString(stop_state));
5727 if (stop_state == eStateExited)
5728 event_to_broadcast_sp = event_sp;
5730 diagnostic_manager.PutCString(eDiagnosticSeverityError,
5731 "execution stopped with unexpected state.");
5732 return_value = eExpressionInterrupted;
5745 log->PutCString ("Process::RunThreadPlan(): got_event was true, but the event pointer was null. How odd...");
5746 return_value = eExpressionInterrupted;
5752 // If we didn't get an event that means we've timed out...
5753 // We will interrupt the process here. Depending on what we were asked to do we will
5754 // either exit, or try with all threads running for the same timeout.
5757 if (options.GetTryAllThreads())
5759 if (before_first_timeout)
5761 if (timeout_usec != 0)
5763 log->Printf ("Process::RunThreadPlan(): Running function with one thread timeout timed out, "
5764 "running for %" PRIu32 " usec with all threads enabled.",
5765 all_threads_timeout_usec);
5769 log->Printf ("Process::RunThreadPlan(): Running function with one thread timeout timed out, "
5770 "running forever with all threads enabled.");
5774 log->Printf ("Process::RunThreadPlan(): Restarting function with all threads enabled "
5775 "and timeout: %u timed out, abandoning execution.",
5779 log->Printf ("Process::RunThreadPlan(): Running function with timeout: %u timed out, "
5780 "abandoning execution.",
5784 // It is possible that between the time we issued the Halt, and we get around to calling Halt the target
5785 // could have stopped. That's fine, Halt will figure that out and send the appropriate Stopped event.
5786 // BUT it is also possible that we stopped & restarted (e.g. hit a signal with "stop" set to false.) In
5787 // that case, we'll get the stopped & restarted event, and we should go back to waiting for the Halt's
5788 // stopped event. That's what this while loop does.
5790 bool back_to_top = true;
5791 uint32_t try_halt_again = 0;
5792 bool do_halt = true;
5793 const uint32_t num_retries = 5;
5794 while (try_halt_again < num_retries)
5800 log->Printf ("Process::RunThreadPlan(): Running Halt.");
5801 const bool clear_thread_plans = false;
5802 const bool use_run_lock = false;
5803 Halt(clear_thread_plans, use_run_lock);
5805 if (halt_error.Success())
5808 log->PutCString ("Process::RunThreadPlan(): Halt succeeded.");
5810 real_timeout = TimeValue::Now();
5811 real_timeout.OffsetWithMicroSeconds(500000);
5813 got_event = listener_sp->WaitForEvent(&real_timeout, event_sp);
5817 stop_state = Process::ProcessEventData::GetStateFromEvent(event_sp.get());
5820 log->Printf ("Process::RunThreadPlan(): Stopped with event: %s", StateAsCString(stop_state));
5821 if (stop_state == lldb::eStateStopped
5822 && Process::ProcessEventData::GetInterruptedFromEvent(event_sp.get()))
5823 log->PutCString (" Event was the Halt interruption event.");
5826 if (stop_state == lldb::eStateStopped)
5828 // Between the time we initiated the Halt and the time we delivered it, the process could have
5829 // already finished its job. Check that here:
5831 if (thread->IsThreadPlanDone (thread_plan_sp.get()))
5834 log->PutCString ("Process::RunThreadPlan(): Even though we timed out, the call plan was done. "
5835 "Exiting wait loop.");
5836 return_value = eExpressionCompleted;
5837 back_to_top = false;
5841 if (Process::ProcessEventData::GetRestartedFromEvent(event_sp.get()))
5844 log->PutCString ("Process::RunThreadPlan(): Went to halt but got a restarted event, there must be an un-restarted stopped event so try again... "
5845 "Exiting wait loop.");
5851 if (!options.GetTryAllThreads())
5854 log->PutCString ("Process::RunThreadPlan(): try_all_threads was false, we stopped so now we're quitting.");
5855 return_value = eExpressionInterrupted;
5856 back_to_top = false;
5860 if (before_first_timeout)
5862 // Set all the other threads to run, and return to the top of the loop, which will continue;
5863 before_first_timeout = false;
5864 thread_plan_sp->SetStopOthers (false);
5866 log->PutCString ("Process::RunThreadPlan(): about to resume.");
5873 // Running all threads failed, so return Interrupted.
5875 log->PutCString("Process::RunThreadPlan(): running all threads timed out.");
5876 return_value = eExpressionInterrupted;
5877 back_to_top = false;
5884 log->PutCString("Process::RunThreadPlan(): halt said it succeeded, but I got no event. "
5885 "I'm getting out of here passing Interrupted.");
5886 return_value = eExpressionInterrupted;
5887 back_to_top = false;
5898 if (!back_to_top || try_halt_again > num_retries)
5905 // If we had to start up a temporary private state thread to run this thread plan, shut it down now.
5906 if (backup_private_state_thread.IsJoinable())
5908 StopPrivateStateThread();
5910 m_private_state_thread = backup_private_state_thread;
5911 if (stopper_base_plan_sp)
5913 thread->DiscardThreadPlansUpToPlan(stopper_base_plan_sp);
5915 if (old_state != eStateInvalid)
5916 m_public_state.SetValueNoLock(old_state);
5919 if (return_value != eExpressionCompleted && log)
5921 // Print a backtrace into the log so we can figure out where we are:
5923 s.PutCString("Thread state after unsuccessful completion: \n");
5924 thread->GetStackFrameStatus (s,
5929 log->PutCString(s.GetData());
5932 // Restore the thread state if we are going to discard the plan execution. There are three cases where this
5934 // 1) The execution successfully completed
5935 // 2) We hit a breakpoint, and ignore_breakpoints was true
5936 // 3) We got some other error, and discard_on_error was true
5937 bool should_unwind = (return_value == eExpressionInterrupted && options.DoesUnwindOnError())
5938 || (return_value == eExpressionHitBreakpoint && options.DoesIgnoreBreakpoints());
5940 if (return_value == eExpressionCompleted
5943 thread_plan_sp->RestoreThreadState();
5946 // Now do some processing on the results of the run:
5947 if (return_value == eExpressionInterrupted || return_value == eExpressionHitBreakpoint)
5953 event_sp->Dump (&s);
5956 log->PutCString ("Process::RunThreadPlan(): Stop event that interrupted us is NULL.");
5961 const char *event_explanation = nullptr;
5967 event_explanation = "<no event>";
5970 else if (event_sp->GetType() == eBroadcastBitInterrupt)
5972 event_explanation = "<user interrupt>";
5977 const Process::ProcessEventData *event_data = Process::ProcessEventData::GetEventDataFromEvent (event_sp.get());
5981 event_explanation = "<no event data>";
5985 Process *process = event_data->GetProcessSP().get();
5989 event_explanation = "<no process>";
5993 ThreadList &thread_list = process->GetThreadList();
5995 uint32_t num_threads = thread_list.GetSize();
5996 uint32_t thread_index;
5998 ts.Printf("<%u threads> ", num_threads);
6000 for (thread_index = 0;
6001 thread_index < num_threads;
6004 Thread *thread = thread_list.GetThreadAtIndex(thread_index).get();
6012 ts.Printf("<0x%4.4" PRIx64 " ", thread->GetID());
6013 RegisterContext *register_context = thread->GetRegisterContext().get();
6015 if (register_context)
6016 ts.Printf("[ip 0x%" PRIx64 "] ", register_context->GetPC());
6018 ts.Printf("[ip unknown] ");
6020 // Show the private stop info here, the public stop info will be from the last natural stop.
6021 lldb::StopInfoSP stop_info_sp = thread->GetPrivateStopInfo();
6024 const char *stop_desc = stop_info_sp->GetDescription();
6026 ts.PutCString (stop_desc);
6031 event_explanation = ts.GetData();
6035 if (event_explanation)
6036 log->Printf("Process::RunThreadPlan(): execution interrupted: %s %s", s.GetData(), event_explanation);
6038 log->Printf("Process::RunThreadPlan(): execution interrupted: %s", s.GetData());
6044 log->Printf ("Process::RunThreadPlan: ExecutionInterrupted - discarding thread plans up to %p.",
6045 static_cast<void*>(thread_plan_sp.get()));
6046 thread->DiscardThreadPlansUpToPlan (thread_plan_sp);
6051 log->Printf ("Process::RunThreadPlan: ExecutionInterrupted - for plan: %p not discarding.",
6052 static_cast<void*>(thread_plan_sp.get()));
6055 else if (return_value == eExpressionSetupError)
6058 log->PutCString("Process::RunThreadPlan(): execution set up error.");
6060 if (options.DoesUnwindOnError())
6062 thread->DiscardThreadPlansUpToPlan (thread_plan_sp);
6067 if (thread->IsThreadPlanDone (thread_plan_sp.get()))
6070 log->PutCString("Process::RunThreadPlan(): thread plan is done");
6071 return_value = eExpressionCompleted;
6073 else if (thread->WasThreadPlanDiscarded (thread_plan_sp.get()))
6076 log->PutCString("Process::RunThreadPlan(): thread plan was discarded");
6077 return_value = eExpressionDiscarded;
6082 log->PutCString("Process::RunThreadPlan(): thread plan stopped in mid course");
6083 if (options.DoesUnwindOnError() && thread_plan_sp)
6086 log->PutCString("Process::RunThreadPlan(): discarding thread plan 'cause unwind_on_error is set.");
6087 thread->DiscardThreadPlansUpToPlan (thread_plan_sp);
6092 // Thread we ran the function in may have gone away because we ran the target
6093 // Check that it's still there, and if it is put it back in the context. Also restore the
6094 // frame in the context if it is still present.
6095 thread = GetThreadList().FindThreadByIndexID(thread_idx_id, true).get();
6098 exe_ctx.SetFrameSP (thread->GetFrameWithStackID (ctx_frame_id));
6101 // Also restore the current process'es selected frame & thread, since this function calling may
6102 // be done behind the user's back.
6104 if (selected_tid != LLDB_INVALID_THREAD_ID)
6106 if (GetThreadList().SetSelectedThreadByIndexID (selected_tid) && selected_stack_id.IsValid())
6108 // We were able to restore the selected thread, now restore the frame:
6109 std::lock_guard<std::recursive_mutex> guard(GetThreadList().GetMutex());
6110 StackFrameSP old_frame_sp = GetThreadList().GetSelectedThread()->GetFrameWithStackID(selected_stack_id);
6112 GetThreadList().GetSelectedThread()->SetSelectedFrame(old_frame_sp.get());
6117 // If the process exited during the run of the thread plan, notify everyone.
6119 if (event_to_broadcast_sp)
6122 log->PutCString("Process::RunThreadPlan(): rebroadcasting event.");
6123 BroadcastEvent(event_to_broadcast_sp);
6126 return return_value;
6130 Process::ExecutionResultAsCString (ExpressionResults result)
6132 const char *result_name;
6136 case eExpressionCompleted:
6137 result_name = "eExpressionCompleted";
6139 case eExpressionDiscarded:
6140 result_name = "eExpressionDiscarded";
6142 case eExpressionInterrupted:
6143 result_name = "eExpressionInterrupted";
6145 case eExpressionHitBreakpoint:
6146 result_name = "eExpressionHitBreakpoint";
6148 case eExpressionSetupError:
6149 result_name = "eExpressionSetupError";
6151 case eExpressionParseError:
6152 result_name = "eExpressionParseError";
6154 case eExpressionResultUnavailable:
6155 result_name = "eExpressionResultUnavailable";
6157 case eExpressionTimedOut:
6158 result_name = "eExpressionTimedOut";
6160 case eExpressionStoppedForDebug:
6161 result_name = "eExpressionStoppedForDebug";
6168 Process::GetStatus (Stream &strm)
6170 const StateType state = GetState();
6171 if (StateIsStoppedState(state, false))
6173 if (state == eStateExited)
6175 int exit_status = GetExitStatus();
6176 const char *exit_description = GetExitDescription();
6177 strm.Printf ("Process %" PRIu64 " exited with status = %i (0x%8.8x) %s\n",
6181 exit_description ? exit_description : "");
6185 if (state == eStateConnected)
6186 strm.Printf ("Connected to remote target.\n");
6188 strm.Printf ("Process %" PRIu64 " %s\n", GetID(), StateAsCString (state));
6193 strm.Printf ("Process %" PRIu64 " is running.\n", GetID());
6198 Process::GetThreadStatus (Stream &strm,
6199 bool only_threads_with_stop_reason,
6200 uint32_t start_frame,
6201 uint32_t num_frames,
6202 uint32_t num_frames_with_source)
6204 size_t num_thread_infos_dumped = 0;
6206 // You can't hold the thread list lock while calling Thread::GetStatus. That very well might run code (e.g. if we need it
6207 // to get return values or arguments.) For that to work the process has to be able to acquire it. So instead copy the thread
6208 // ID's, and look them up one by one:
6210 uint32_t num_threads;
6211 std::vector<lldb::tid_t> thread_id_array;
6212 //Scope for thread list locker;
6214 std::lock_guard<std::recursive_mutex> guard(GetThreadList().GetMutex());
6215 ThreadList &curr_thread_list = GetThreadList();
6216 num_threads = curr_thread_list.GetSize();
6218 thread_id_array.resize(num_threads);
6219 for (idx = 0; idx < num_threads; ++idx)
6220 thread_id_array[idx] = curr_thread_list.GetThreadAtIndex(idx)->GetID();
6223 for (uint32_t i = 0; i < num_threads; i++)
6225 ThreadSP thread_sp(GetThreadList().FindThreadByID(thread_id_array[i]));
6228 if (only_threads_with_stop_reason)
6230 StopInfoSP stop_info_sp = thread_sp->GetStopInfo();
6231 if (!stop_info_sp || !stop_info_sp->IsValid())
6234 thread_sp->GetStatus (strm,
6237 num_frames_with_source);
6238 ++num_thread_infos_dumped;
6242 Log *log(lldb_private::GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS));
6244 log->Printf("Process::GetThreadStatus - thread 0x" PRIu64 " vanished while running Thread::GetStatus.");
6247 return num_thread_infos_dumped;
6251 Process::AddInvalidMemoryRegion (const LoadRange ®ion)
6253 m_memory_cache.AddInvalidRange(region.GetRangeBase(), region.GetByteSize());
6257 Process::RemoveInvalidMemoryRange (const LoadRange ®ion)
6259 return m_memory_cache.RemoveInvalidRange(region.GetRangeBase(), region.GetByteSize());
6263 Process::AddPreResumeAction (PreResumeActionCallback callback, void *baton)
6265 m_pre_resume_actions.push_back(PreResumeCallbackAndBaton (callback, baton));
6269 Process::RunPreResumeActions ()
6272 while (!m_pre_resume_actions.empty())
6274 struct PreResumeCallbackAndBaton action = m_pre_resume_actions.back();
6275 m_pre_resume_actions.pop_back();
6276 bool this_result = action.callback (action.baton);
6278 result = this_result;
6284 Process::ClearPreResumeActions ()
6286 m_pre_resume_actions.clear();
6290 Process::GetRunLock()
6292 if (m_private_state_thread.EqualsThread(Host::GetCurrentThread()))
6293 return m_private_run_lock;
6295 return m_public_run_lock;
6301 m_thread_list.Flush();
6302 m_extended_thread_list.Flush();
6303 m_extended_thread_stop_id = 0;
6304 m_queue_list.Clear();
6305 m_queue_list_stop_id = 0;
6311 Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
6313 log->Printf ("Process::%s()", __FUNCTION__);
6315 Target &target = GetTarget();
6316 target.CleanupProcess ();
6317 target.ClearModules(false);
6318 m_dynamic_checkers_ap.reset();
6320 m_system_runtime_ap.reset();
6323 m_jit_loaders_ap.reset();
6324 m_image_tokens.clear();
6325 m_allocated_memory_cache.Clear();
6326 m_language_runtimes.clear();
6327 m_instrumentation_runtimes.clear();
6328 m_thread_list.DiscardThreadPlans();
6329 m_memory_cache.Clear(true);
6330 m_stop_info_override_callback = nullptr;
6333 // Flush the process (threads and all stack frames) after running CompleteAttach()
6334 // in case the dynamic loader loaded things in new locations.
6337 // After we figure out what was loaded/unloaded in CompleteAttach,
6338 // we need to let the target know so it can do any cleanup it needs to.
6343 Process::ResolveIndirectFunction(const Address *address, Error &error)
6345 if (address == nullptr)
6347 error.SetErrorString("Invalid address argument");
6348 return LLDB_INVALID_ADDRESS;
6351 addr_t function_addr = LLDB_INVALID_ADDRESS;
6353 addr_t addr = address->GetLoadAddress(&GetTarget());
6354 std::map<addr_t,addr_t>::const_iterator iter = m_resolved_indirect_addresses.find(addr);
6355 if (iter != m_resolved_indirect_addresses.end())
6357 function_addr = (*iter).second;
6361 if (!InferiorCall(this, address, function_addr))
6363 Symbol *symbol = address->CalculateSymbolContextSymbol();
6364 error.SetErrorStringWithFormat ("Unable to call resolver for indirect function %s",
6365 symbol ? symbol->GetName().AsCString() : "<UNKNOWN>");
6366 function_addr = LLDB_INVALID_ADDRESS;
6370 m_resolved_indirect_addresses.insert(std::pair<addr_t, addr_t>(addr, function_addr));
6373 return function_addr;
6377 Process::ModulesDidLoad (ModuleList &module_list)
6379 SystemRuntime *sys_runtime = GetSystemRuntime();
6382 sys_runtime->ModulesDidLoad (module_list);
6385 GetJITLoaders().ModulesDidLoad (module_list);
6387 // Give runtimes a chance to be created.
6388 InstrumentationRuntime::ModulesDidLoad(module_list, this, m_instrumentation_runtimes);
6390 // Tell runtimes about new modules.
6391 for (auto pos = m_instrumentation_runtimes.begin(); pos != m_instrumentation_runtimes.end(); ++pos)
6393 InstrumentationRuntimeSP runtime = pos->second;
6394 runtime->ModulesDidLoad(module_list);
6397 // Let any language runtimes we have already created know
6398 // about the modules that loaded.
6400 // Iterate over a copy of this language runtime list in case
6401 // the language runtime ModulesDidLoad somehow causes the language
6402 // riuntime to be unloaded.
6403 LanguageRuntimeCollection language_runtimes(m_language_runtimes);
6404 for (const auto &pair: language_runtimes)
6406 // We must check language_runtime_sp to make sure it is not
6407 // nullptr as we might cache the fact that we didn't have a
6408 // language runtime for a language.
6409 LanguageRuntimeSP language_runtime_sp = pair.second;
6410 if (language_runtime_sp)
6411 language_runtime_sp->ModulesDidLoad(module_list);
6414 // If we don't have an operating system plug-in, try to load one since
6415 // loading shared libraries might cause a new one to try and load
6417 LoadOperatingSystemPlugin(false);
6421 Process::PrintWarning (uint64_t warning_type, const void *repeat_key, const char *fmt, ...)
6423 bool print_warning = true;
6425 StreamSP stream_sp = GetTarget().GetDebugger().GetAsyncOutputStream();
6428 if (warning_type == eWarningsOptimization
6429 && !GetWarningsOptimization())
6434 if (repeat_key != nullptr)
6436 WarningsCollection::iterator it = m_warnings_issued.find (warning_type);
6437 if (it == m_warnings_issued.end())
6439 m_warnings_issued[warning_type] = WarningsPointerSet();
6440 m_warnings_issued[warning_type].insert (repeat_key);
6444 if (it->second.find (repeat_key) != it->second.end())
6446 print_warning = false;
6450 it->second.insert (repeat_key);
6458 va_start (args, fmt);
6459 stream_sp->PrintfVarArg (fmt, args);
6465 Process::PrintWarningOptimization (const SymbolContext &sc)
6467 if (GetWarningsOptimization()
6469 && !sc.module_sp->GetFileSpec().GetFilename().IsEmpty()
6471 && sc.function->GetIsOptimized())
6473 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());
6478 Process::GetProcessInfo(ProcessInstanceInfo &info)
6482 PlatformSP platform_sp = GetTarget().GetPlatform();
6486 return platform_sp->GetProcessInfo(GetID(), info);
6490 Process::GetHistoryThreads(lldb::addr_t addr)
6492 ThreadCollectionSP threads;
6494 const MemoryHistorySP &memory_history = MemoryHistory::FindPlugin(shared_from_this());
6496 if (!memory_history) {
6500 threads.reset(new ThreadCollection(memory_history->GetHistoryThreads(addr)));
6505 InstrumentationRuntimeSP
6506 Process::GetInstrumentationRuntime(lldb::InstrumentationRuntimeType type)
6508 InstrumentationRuntimeCollection::iterator pos;
6509 pos = m_instrumentation_runtimes.find (type);
6510 if (pos == m_instrumentation_runtimes.end())
6512 return InstrumentationRuntimeSP();
6515 return (*pos).second;
6519 Process::GetModuleSpec(const FileSpec& module_file_spec,
6520 const ArchSpec& arch,
6521 ModuleSpec& module_spec)
6523 module_spec.Clear();
6528 Process::AddImageToken(lldb::addr_t image_ptr)
6530 m_image_tokens.push_back(image_ptr);
6531 return m_image_tokens.size() - 1;
6535 Process::GetImagePtrFromToken(size_t token) const
6537 if (token < m_image_tokens.size())
6538 return m_image_tokens[token];
6539 return LLDB_INVALID_IMAGE_TOKEN;
6543 Process::ResetImageToken(size_t token)
6545 if (token < m_image_tokens.size())
6546 m_image_tokens[token] = LLDB_INVALID_IMAGE_TOKEN;
6550 Process::AdvanceAddressToNextBranchInstruction (Address default_stop_addr, AddressRange range_bounds)
6552 Target &target = GetTarget();
6553 DisassemblerSP disassembler_sp;
6554 InstructionList *insn_list = nullptr;
6556 Address retval = default_stop_addr;
6558 if (!target.GetUseFastStepping())
6560 if (!default_stop_addr.IsValid())
6563 ExecutionContext exe_ctx (this);
6564 const char *plugin_name = nullptr;
6565 const char *flavor = nullptr;
6566 const bool prefer_file_cache = true;
6567 disassembler_sp = Disassembler::DisassembleRange(target.GetArchitecture(),
6573 if (disassembler_sp)
6574 insn_list = &disassembler_sp->GetInstructionList();
6576 if (insn_list == nullptr)
6581 size_t insn_offset = insn_list->GetIndexOfInstructionAtAddress (default_stop_addr);
6582 if (insn_offset == UINT32_MAX)
6587 uint32_t branch_index = insn_list->GetIndexOfNextBranchInstruction (insn_offset, target);
6588 if (branch_index == UINT32_MAX)
6593 if (branch_index > insn_offset)
6595 Address next_branch_insn_address = insn_list->GetInstructionAtIndex (branch_index)->GetAddress();
6596 if (next_branch_insn_address.IsValid() && range_bounds.ContainsFileAddress (next_branch_insn_address))
6598 retval = next_branch_insn_address;
6606 Process::GetMemoryRegions (std::vector<lldb::MemoryRegionInfoSP>& region_list)
6611 lldb::addr_t range_base = 0;
6612 lldb::addr_t range_end = 0;
6614 region_list.clear();
6617 lldb::MemoryRegionInfoSP region_info( new lldb_private::MemoryRegionInfo() );
6618 error = GetMemoryRegionInfo (range_end, *region_info);
6619 // GetMemoryRegionInfo should only return an error if it is unimplemented.
6622 region_list.clear();
6626 range_base = region_info->GetRange().GetRangeBase();
6627 range_end = region_info->GetRange().GetRangeEnd();
6628 if( region_info->GetMapped() == MemoryRegionInfo::eYes )
6630 region_list.push_back(region_info);
6632 } while (range_end != LLDB_INVALID_ADDRESS);