1 //===-- Target.cpp ----------------------------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "lldb/Target/Target.h"
10 #include "Plugins/ExpressionParser/Clang/ClangASTSource.h"
11 #include "Plugins/ExpressionParser/Clang/ClangModulesDeclVendor.h"
12 #include "Plugins/ExpressionParser/Clang/ClangPersistentVariables.h"
13 #include "lldb/Breakpoint/BreakpointIDList.h"
14 #include "lldb/Breakpoint/BreakpointResolver.h"
15 #include "lldb/Breakpoint/BreakpointResolverAddress.h"
16 #include "lldb/Breakpoint/BreakpointResolverFileLine.h"
17 #include "lldb/Breakpoint/BreakpointResolverFileRegex.h"
18 #include "lldb/Breakpoint/BreakpointResolverName.h"
19 #include "lldb/Breakpoint/BreakpointResolverScripted.h"
20 #include "lldb/Breakpoint/Watchpoint.h"
21 #include "lldb/Core/Debugger.h"
22 #include "lldb/Core/Module.h"
23 #include "lldb/Core/ModuleSpec.h"
24 #include "lldb/Core/PluginManager.h"
25 #include "lldb/Core/SearchFilter.h"
26 #include "lldb/Core/Section.h"
27 #include "lldb/Core/SourceManager.h"
28 #include "lldb/Core/StreamFile.h"
29 #include "lldb/Core/StructuredDataImpl.h"
30 #include "lldb/Core/ValueObject.h"
31 #include "lldb/Expression/REPL.h"
32 #include "lldb/Expression/UserExpression.h"
33 #include "lldb/Host/Host.h"
34 #include "lldb/Host/PosixApi.h"
35 #include "lldb/Interpreter/CommandInterpreter.h"
36 #include "lldb/Interpreter/CommandReturnObject.h"
37 #include "lldb/Interpreter/OptionGroupWatchpoint.h"
38 #include "lldb/Interpreter/OptionValues.h"
39 #include "lldb/Interpreter/Property.h"
40 #include "lldb/Symbol/ClangASTContext.h"
41 #include "lldb/Symbol/Function.h"
42 #include "lldb/Symbol/ObjectFile.h"
43 #include "lldb/Symbol/Symbol.h"
44 #include "lldb/Target/Language.h"
45 #include "lldb/Target/LanguageRuntime.h"
46 #include "lldb/Target/ObjCLanguageRuntime.h"
47 #include "lldb/Target/Process.h"
48 #include "lldb/Target/SectionLoadList.h"
49 #include "lldb/Target/StackFrame.h"
50 #include "lldb/Target/SystemRuntime.h"
51 #include "lldb/Target/Thread.h"
52 #include "lldb/Target/ThreadSpec.h"
53 #include "lldb/Utility/Event.h"
54 #include "lldb/Utility/FileSpec.h"
55 #include "lldb/Utility/LLDBAssert.h"
56 #include "lldb/Utility/Log.h"
57 #include "lldb/Utility/State.h"
58 #include "lldb/Utility/StreamString.h"
59 #include "lldb/Utility/Timer.h"
60 
61 #include <memory>
62 #include <mutex>
63 
64 using namespace lldb;
65 using namespace lldb_private;
66 
67 constexpr std::chrono::milliseconds EvaluateExpressionOptions::default_timeout;
68 
69 Target::Arch::Arch(const ArchSpec &spec)
70     : m_spec(spec),
71       m_plugin_up(PluginManager::CreateArchitectureInstance(spec)) {}
72 
73 const Target::Arch& Target::Arch::operator=(const ArchSpec &spec) {
74   m_spec = spec;
75   m_plugin_up = PluginManager::CreateArchitectureInstance(spec);
76   return *this;
77 }
78 
79 ConstString &Target::GetStaticBroadcasterClass() {
80   static ConstString class_name("lldb.target");
81   return class_name;
82 }
83 
84 Target::Target(Debugger &debugger, const ArchSpec &target_arch,
85                const lldb::PlatformSP &platform_sp, bool is_dummy_target)
86     : TargetProperties(this),
87       Broadcaster(debugger.GetBroadcasterManager(),
88                   Target::GetStaticBroadcasterClass().AsCString()),
89       ExecutionContextScope(), m_debugger(debugger), m_platform_sp(platform_sp),
90       m_mutex(), m_arch(target_arch), m_images(this), m_section_load_history(),
91       m_breakpoint_list(false), m_internal_breakpoint_list(true),
92       m_watchpoint_list(), m_process_sp(), m_search_filter_sp(),
93       m_image_search_paths(ImageSearchPathsChanged, this), m_ast_importer_sp(),
94       m_source_manager_up(), m_stop_hooks(), m_stop_hook_next_id(0),
95       m_valid(true), m_suppress_stop_hooks(false),
96       m_is_dummy_target(is_dummy_target),
97       m_stats_storage(static_cast<int>(StatisticKind::StatisticMax))
98 
99 {
100   SetEventName(eBroadcastBitBreakpointChanged, "breakpoint-changed");
101   SetEventName(eBroadcastBitModulesLoaded, "modules-loaded");
102   SetEventName(eBroadcastBitModulesUnloaded, "modules-unloaded");
103   SetEventName(eBroadcastBitWatchpointChanged, "watchpoint-changed");
104   SetEventName(eBroadcastBitSymbolsLoaded, "symbols-loaded");
105 
106   CheckInWithManager();
107 
108   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
109   if (log)
110     log->Printf("%p Target::Target()", static_cast<void *>(this));
111   if (target_arch.IsValid()) {
112     LogIfAnyCategoriesSet(LIBLLDB_LOG_TARGET,
113                           "Target::Target created with architecture %s (%s)",
114                           target_arch.GetArchitectureName(),
115                           target_arch.GetTriple().getTriple().c_str());
116   }
117 }
118 
119 Target::~Target() {
120   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT));
121   if (log)
122     log->Printf("%p Target::~Target()", static_cast<void *>(this));
123   DeleteCurrentProcess();
124 }
125 
126 void Target::PrimeFromDummyTarget(Target *target) {
127   if (!target)
128     return;
129 
130   m_stop_hooks = target->m_stop_hooks;
131 
132   for (BreakpointSP breakpoint_sp : target->m_breakpoint_list.Breakpoints()) {
133     if (breakpoint_sp->IsInternal())
134       continue;
135 
136     BreakpointSP new_bp(new Breakpoint(*this, *breakpoint_sp.get()));
137     AddBreakpoint(new_bp, false);
138   }
139 
140   for (auto bp_name_entry : target->m_breakpoint_names)
141   {
142 
143     BreakpointName *new_bp_name = new BreakpointName(*bp_name_entry.second);
144     AddBreakpointName(new_bp_name);
145   }
146 }
147 
148 void Target::Dump(Stream *s, lldb::DescriptionLevel description_level) {
149   //    s->Printf("%.*p: ", (int)sizeof(void*) * 2, this);
150   if (description_level != lldb::eDescriptionLevelBrief) {
151     s->Indent();
152     s->PutCString("Target\n");
153     s->IndentMore();
154     m_images.Dump(s);
155     m_breakpoint_list.Dump(s);
156     m_internal_breakpoint_list.Dump(s);
157     s->IndentLess();
158   } else {
159     Module *exe_module = GetExecutableModulePointer();
160     if (exe_module)
161       s->PutCString(exe_module->GetFileSpec().GetFilename().GetCString());
162     else
163       s->PutCString("No executable module.");
164   }
165 }
166 
167 void Target::CleanupProcess() {
168   // Do any cleanup of the target we need to do between process instances.
169   // NB It is better to do this before destroying the process in case the
170   // clean up needs some help from the process.
171   m_breakpoint_list.ClearAllBreakpointSites();
172   m_internal_breakpoint_list.ClearAllBreakpointSites();
173   // Disable watchpoints just on the debugger side.
174   std::unique_lock<std::recursive_mutex> lock;
175   this->GetWatchpointList().GetListMutex(lock);
176   DisableAllWatchpoints(false);
177   ClearAllWatchpointHitCounts();
178   ClearAllWatchpointHistoricValues();
179 }
180 
181 void Target::DeleteCurrentProcess() {
182   if (m_process_sp) {
183     m_section_load_history.Clear();
184     if (m_process_sp->IsAlive())
185       m_process_sp->Destroy(false);
186 
187     m_process_sp->Finalize();
188 
189     CleanupProcess();
190 
191     m_process_sp.reset();
192   }
193 }
194 
195 const lldb::ProcessSP &Target::CreateProcess(ListenerSP listener_sp,
196                                              llvm::StringRef plugin_name,
197                                              const FileSpec *crash_file) {
198   if (!listener_sp)
199     listener_sp = GetDebugger().GetListener();
200   DeleteCurrentProcess();
201   m_process_sp = Process::FindPlugin(shared_from_this(), plugin_name,
202                                      listener_sp, crash_file);
203   return m_process_sp;
204 }
205 
206 const lldb::ProcessSP &Target::GetProcessSP() const { return m_process_sp; }
207 
208 lldb::REPLSP Target::GetREPL(Status &err, lldb::LanguageType language,
209                              const char *repl_options, bool can_create) {
210   if (language == eLanguageTypeUnknown) {
211     std::set<LanguageType> repl_languages;
212 
213     Language::GetLanguagesSupportingREPLs(repl_languages);
214 
215     if (repl_languages.size() == 1) {
216       language = *repl_languages.begin();
217     } else if (repl_languages.size() == 0) {
218       err.SetErrorStringWithFormat(
219           "LLDB isn't configured with REPL support for any languages.");
220       return REPLSP();
221     } else {
222       err.SetErrorStringWithFormat(
223           "Multiple possible REPL languages.  Please specify a language.");
224       return REPLSP();
225     }
226   }
227 
228   REPLMap::iterator pos = m_repl_map.find(language);
229 
230   if (pos != m_repl_map.end()) {
231     return pos->second;
232   }
233 
234   if (!can_create) {
235     err.SetErrorStringWithFormat(
236         "Couldn't find an existing REPL for %s, and can't create a new one",
237         Language::GetNameForLanguageType(language));
238     return lldb::REPLSP();
239   }
240 
241   Debugger *const debugger = nullptr;
242   lldb::REPLSP ret = REPL::Create(err, language, debugger, this, repl_options);
243 
244   if (ret) {
245     m_repl_map[language] = ret;
246     return m_repl_map[language];
247   }
248 
249   if (err.Success()) {
250     err.SetErrorStringWithFormat("Couldn't create a REPL for %s",
251                                  Language::GetNameForLanguageType(language));
252   }
253 
254   return lldb::REPLSP();
255 }
256 
257 void Target::SetREPL(lldb::LanguageType language, lldb::REPLSP repl_sp) {
258   lldbassert(!m_repl_map.count(language));
259 
260   m_repl_map[language] = repl_sp;
261 }
262 
263 void Target::Destroy() {
264   std::lock_guard<std::recursive_mutex> guard(m_mutex);
265   m_valid = false;
266   DeleteCurrentProcess();
267   m_platform_sp.reset();
268   m_arch = ArchSpec();
269   ClearModules(true);
270   m_section_load_history.Clear();
271   const bool notify = false;
272   m_breakpoint_list.RemoveAll(notify);
273   m_internal_breakpoint_list.RemoveAll(notify);
274   m_last_created_breakpoint.reset();
275   m_last_created_watchpoint.reset();
276   m_search_filter_sp.reset();
277   m_image_search_paths.Clear(notify);
278   m_stop_hooks.clear();
279   m_stop_hook_next_id = 0;
280   m_suppress_stop_hooks = false;
281 }
282 
283 BreakpointList &Target::GetBreakpointList(bool internal) {
284   if (internal)
285     return m_internal_breakpoint_list;
286   else
287     return m_breakpoint_list;
288 }
289 
290 const BreakpointList &Target::GetBreakpointList(bool internal) const {
291   if (internal)
292     return m_internal_breakpoint_list;
293   else
294     return m_breakpoint_list;
295 }
296 
297 BreakpointSP Target::GetBreakpointByID(break_id_t break_id) {
298   BreakpointSP bp_sp;
299 
300   if (LLDB_BREAK_ID_IS_INTERNAL(break_id))
301     bp_sp = m_internal_breakpoint_list.FindBreakpointByID(break_id);
302   else
303     bp_sp = m_breakpoint_list.FindBreakpointByID(break_id);
304 
305   return bp_sp;
306 }
307 
308 BreakpointSP Target::CreateSourceRegexBreakpoint(
309     const FileSpecList *containingModules,
310     const FileSpecList *source_file_spec_list,
311     const std::unordered_set<std::string> &function_names,
312     RegularExpression &source_regex, bool internal, bool hardware,
313     LazyBool move_to_nearest_code) {
314   SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList(
315       containingModules, source_file_spec_list));
316   if (move_to_nearest_code == eLazyBoolCalculate)
317     move_to_nearest_code = GetMoveToNearestCode() ? eLazyBoolYes : eLazyBoolNo;
318   BreakpointResolverSP resolver_sp(new BreakpointResolverFileRegex(
319       nullptr, source_regex, function_names,
320       !static_cast<bool>(move_to_nearest_code)));
321 
322   return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true);
323 }
324 
325 BreakpointSP Target::CreateBreakpoint(const FileSpecList *containingModules,
326                                       const FileSpec &file, uint32_t line_no,
327                                       uint32_t column, lldb::addr_t offset,
328                                       LazyBool check_inlines,
329                                       LazyBool skip_prologue, bool internal,
330                                       bool hardware,
331                                       LazyBool move_to_nearest_code) {
332   FileSpec remapped_file;
333   if (!GetSourcePathMap().ReverseRemapPath(file, remapped_file))
334     remapped_file = file;
335 
336   if (check_inlines == eLazyBoolCalculate) {
337     const InlineStrategy inline_strategy = GetInlineStrategy();
338     switch (inline_strategy) {
339     case eInlineBreakpointsNever:
340       check_inlines = eLazyBoolNo;
341       break;
342 
343     case eInlineBreakpointsHeaders:
344       if (remapped_file.IsSourceImplementationFile())
345         check_inlines = eLazyBoolNo;
346       else
347         check_inlines = eLazyBoolYes;
348       break;
349 
350     case eInlineBreakpointsAlways:
351       check_inlines = eLazyBoolYes;
352       break;
353     }
354   }
355   SearchFilterSP filter_sp;
356   if (check_inlines == eLazyBoolNo) {
357     // Not checking for inlines, we are looking only for matching compile units
358     FileSpecList compile_unit_list;
359     compile_unit_list.Append(remapped_file);
360     filter_sp = GetSearchFilterForModuleAndCUList(containingModules,
361                                                   &compile_unit_list);
362   } else {
363     filter_sp = GetSearchFilterForModuleList(containingModules);
364   }
365   if (skip_prologue == eLazyBoolCalculate)
366     skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo;
367   if (move_to_nearest_code == eLazyBoolCalculate)
368     move_to_nearest_code = GetMoveToNearestCode() ? eLazyBoolYes : eLazyBoolNo;
369 
370   BreakpointResolverSP resolver_sp(new BreakpointResolverFileLine(
371       nullptr, remapped_file, line_no, column, offset, check_inlines,
372       skip_prologue, !static_cast<bool>(move_to_nearest_code)));
373   return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true);
374 }
375 
376 BreakpointSP Target::CreateBreakpoint(lldb::addr_t addr, bool internal,
377                                       bool hardware) {
378   Address so_addr;
379 
380   // Check for any reason we want to move this breakpoint to other address.
381   addr = GetBreakableLoadAddress(addr);
382 
383   // Attempt to resolve our load address if possible, though it is ok if it
384   // doesn't resolve to section/offset.
385 
386   // Try and resolve as a load address if possible
387   GetSectionLoadList().ResolveLoadAddress(addr, so_addr);
388   if (!so_addr.IsValid()) {
389     // The address didn't resolve, so just set this as an absolute address
390     so_addr.SetOffset(addr);
391   }
392   BreakpointSP bp_sp(CreateBreakpoint(so_addr, internal, hardware));
393   return bp_sp;
394 }
395 
396 BreakpointSP Target::CreateBreakpoint(const Address &addr, bool internal,
397                                       bool hardware) {
398   SearchFilterSP filter_sp(
399       new SearchFilterForUnconstrainedSearches(shared_from_this()));
400   BreakpointResolverSP resolver_sp(
401       new BreakpointResolverAddress(nullptr, addr));
402   return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, false);
403 }
404 
405 lldb::BreakpointSP
406 Target::CreateAddressInModuleBreakpoint(lldb::addr_t file_addr, bool internal,
407                                         const FileSpec *file_spec,
408                                         bool request_hardware) {
409   SearchFilterSP filter_sp(
410       new SearchFilterForUnconstrainedSearches(shared_from_this()));
411   BreakpointResolverSP resolver_sp(
412       new BreakpointResolverAddress(nullptr, file_addr, file_spec));
413   return CreateBreakpoint(filter_sp, resolver_sp, internal, request_hardware,
414                           false);
415 }
416 
417 BreakpointSP Target::CreateBreakpoint(
418     const FileSpecList *containingModules,
419     const FileSpecList *containingSourceFiles, const char *func_name,
420     FunctionNameType func_name_type_mask, LanguageType language,
421     lldb::addr_t offset, LazyBool skip_prologue, bool internal, bool hardware) {
422   BreakpointSP bp_sp;
423   if (func_name) {
424     SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList(
425         containingModules, containingSourceFiles));
426 
427     if (skip_prologue == eLazyBoolCalculate)
428       skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo;
429     if (language == lldb::eLanguageTypeUnknown)
430       language = GetLanguage();
431 
432     BreakpointResolverSP resolver_sp(new BreakpointResolverName(
433         nullptr, func_name, func_name_type_mask, language, Breakpoint::Exact,
434         offset, skip_prologue));
435     bp_sp = CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true);
436   }
437   return bp_sp;
438 }
439 
440 lldb::BreakpointSP
441 Target::CreateBreakpoint(const FileSpecList *containingModules,
442                          const FileSpecList *containingSourceFiles,
443                          const std::vector<std::string> &func_names,
444                          FunctionNameType func_name_type_mask,
445                          LanguageType language, lldb::addr_t offset,
446                          LazyBool skip_prologue, bool internal, bool hardware) {
447   BreakpointSP bp_sp;
448   size_t num_names = func_names.size();
449   if (num_names > 0) {
450     SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList(
451         containingModules, containingSourceFiles));
452 
453     if (skip_prologue == eLazyBoolCalculate)
454       skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo;
455     if (language == lldb::eLanguageTypeUnknown)
456       language = GetLanguage();
457 
458     BreakpointResolverSP resolver_sp(
459         new BreakpointResolverName(nullptr, func_names, func_name_type_mask,
460                                    language, offset, skip_prologue));
461     bp_sp = CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true);
462   }
463   return bp_sp;
464 }
465 
466 BreakpointSP
467 Target::CreateBreakpoint(const FileSpecList *containingModules,
468                          const FileSpecList *containingSourceFiles,
469                          const char *func_names[], size_t num_names,
470                          FunctionNameType func_name_type_mask,
471                          LanguageType language, lldb::addr_t offset,
472                          LazyBool skip_prologue, bool internal, bool hardware) {
473   BreakpointSP bp_sp;
474   if (num_names > 0) {
475     SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList(
476         containingModules, containingSourceFiles));
477 
478     if (skip_prologue == eLazyBoolCalculate) {
479       if (offset == 0)
480         skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo;
481       else
482         skip_prologue = eLazyBoolNo;
483     }
484     if (language == lldb::eLanguageTypeUnknown)
485       language = GetLanguage();
486 
487     BreakpointResolverSP resolver_sp(new BreakpointResolverName(
488         nullptr, func_names, num_names, func_name_type_mask, language, offset,
489         skip_prologue));
490     resolver_sp->SetOffset(offset);
491     bp_sp = CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true);
492   }
493   return bp_sp;
494 }
495 
496 SearchFilterSP
497 Target::GetSearchFilterForModule(const FileSpec *containingModule) {
498   SearchFilterSP filter_sp;
499   if (containingModule != nullptr) {
500     // TODO: We should look into sharing module based search filters
501     // across many breakpoints like we do for the simple target based one
502     filter_sp = std::make_shared<SearchFilterByModule>(shared_from_this(),
503                                                        *containingModule);
504   } else {
505     if (!m_search_filter_sp)
506       m_search_filter_sp =
507           std::make_shared<SearchFilterForUnconstrainedSearches>(
508               shared_from_this());
509     filter_sp = m_search_filter_sp;
510   }
511   return filter_sp;
512 }
513 
514 SearchFilterSP
515 Target::GetSearchFilterForModuleList(const FileSpecList *containingModules) {
516   SearchFilterSP filter_sp;
517   if (containingModules && containingModules->GetSize() != 0) {
518     // TODO: We should look into sharing module based search filters
519     // across many breakpoints like we do for the simple target based one
520     filter_sp = std::make_shared<SearchFilterByModuleList>(shared_from_this(),
521                                                            *containingModules);
522   } else {
523     if (!m_search_filter_sp)
524       m_search_filter_sp =
525           std::make_shared<SearchFilterForUnconstrainedSearches>(
526               shared_from_this());
527     filter_sp = m_search_filter_sp;
528   }
529   return filter_sp;
530 }
531 
532 SearchFilterSP Target::GetSearchFilterForModuleAndCUList(
533     const FileSpecList *containingModules,
534     const FileSpecList *containingSourceFiles) {
535   if (containingSourceFiles == nullptr || containingSourceFiles->GetSize() == 0)
536     return GetSearchFilterForModuleList(containingModules);
537 
538   SearchFilterSP filter_sp;
539   if (containingModules == nullptr) {
540     // We could make a special "CU List only SearchFilter".  Better yet was if
541     // these could be composable, but that will take a little reworking.
542 
543     filter_sp = std::make_shared<SearchFilterByModuleListAndCU>(
544         shared_from_this(), FileSpecList(), *containingSourceFiles);
545   } else {
546     filter_sp = std::make_shared<SearchFilterByModuleListAndCU>(
547         shared_from_this(), *containingModules, *containingSourceFiles);
548   }
549   return filter_sp;
550 }
551 
552 BreakpointSP Target::CreateFuncRegexBreakpoint(
553     const FileSpecList *containingModules,
554     const FileSpecList *containingSourceFiles, RegularExpression &func_regex,
555     lldb::LanguageType requested_language, LazyBool skip_prologue,
556     bool internal, bool hardware) {
557   SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList(
558       containingModules, containingSourceFiles));
559   bool skip = (skip_prologue == eLazyBoolCalculate)
560                   ? GetSkipPrologue()
561                   : static_cast<bool>(skip_prologue);
562   BreakpointResolverSP resolver_sp(new BreakpointResolverName(
563       nullptr, func_regex, requested_language, 0, skip));
564 
565   return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true);
566 }
567 
568 lldb::BreakpointSP
569 Target::CreateExceptionBreakpoint(enum lldb::LanguageType language,
570                                   bool catch_bp, bool throw_bp, bool internal,
571                                   Args *additional_args, Status *error) {
572   BreakpointSP exc_bkpt_sp = LanguageRuntime::CreateExceptionBreakpoint(
573       *this, language, catch_bp, throw_bp, internal);
574   if (exc_bkpt_sp && additional_args) {
575     Breakpoint::BreakpointPreconditionSP precondition_sp =
576         exc_bkpt_sp->GetPrecondition();
577     if (precondition_sp && additional_args) {
578       if (error)
579         *error = precondition_sp->ConfigurePrecondition(*additional_args);
580       else
581         precondition_sp->ConfigurePrecondition(*additional_args);
582     }
583   }
584   return exc_bkpt_sp;
585 }
586 
587 lldb::BreakpointSP
588 Target::CreateScriptedBreakpoint(const llvm::StringRef class_name,
589                                  const FileSpecList *containingModules,
590                                  const FileSpecList *containingSourceFiles,
591                                  bool internal,
592                                  bool request_hardware,
593                                  StructuredData::ObjectSP extra_args_sp,
594                                  Status *creation_error)
595 {
596   SearchFilterSP filter_sp;
597 
598   lldb::SearchDepth depth = lldb::eSearchDepthTarget;
599   bool has_files = containingSourceFiles && containingSourceFiles->GetSize() > 0;
600   bool has_modules = containingModules && containingModules->GetSize() > 0;
601 
602   if (has_files && has_modules) {
603     filter_sp = GetSearchFilterForModuleAndCUList(
604       containingModules, containingSourceFiles);
605   } else if (has_files) {
606     filter_sp = GetSearchFilterForModuleAndCUList(
607       nullptr, containingSourceFiles);
608   } else if (has_modules) {
609     filter_sp = GetSearchFilterForModuleList(containingModules);
610   } else {
611     filter_sp = std::make_shared<SearchFilterForUnconstrainedSearches>(
612         shared_from_this());
613   }
614 
615   StructuredDataImpl *extra_args_impl = new StructuredDataImpl();
616   if (extra_args_sp)
617     extra_args_impl->SetObjectSP(extra_args_sp);
618 
619   BreakpointResolverSP resolver_sp(new
620                                    BreakpointResolverScripted(nullptr, class_name,
621                                    depth,
622                                    extra_args_impl,
623                                    *GetDebugger().GetCommandInterpreter()
624                                        .GetScriptInterpreter()));
625   return CreateBreakpoint(filter_sp, resolver_sp, internal, false, true);
626 
627 }
628 
629 
630 BreakpointSP Target::CreateBreakpoint(SearchFilterSP &filter_sp,
631                                       BreakpointResolverSP &resolver_sp,
632                                       bool internal, bool request_hardware,
633                                       bool resolve_indirect_symbols) {
634   BreakpointSP bp_sp;
635   if (filter_sp && resolver_sp) {
636     const bool hardware = request_hardware || GetRequireHardwareBreakpoints();
637     bp_sp.reset(new Breakpoint(*this, filter_sp, resolver_sp, hardware,
638                                resolve_indirect_symbols));
639     resolver_sp->SetBreakpoint(bp_sp.get());
640     AddBreakpoint(bp_sp, internal);
641   }
642   return bp_sp;
643 }
644 
645 void Target::AddBreakpoint(lldb::BreakpointSP bp_sp, bool internal) {
646   if (!bp_sp)
647     return;
648   if (internal)
649     m_internal_breakpoint_list.Add(bp_sp, false);
650   else
651     m_breakpoint_list.Add(bp_sp, true);
652 
653   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
654   if (log) {
655     StreamString s;
656     bp_sp->GetDescription(&s, lldb::eDescriptionLevelVerbose);
657     log->Printf("Target::%s (internal = %s) => break_id = %s\n", __FUNCTION__,
658                 bp_sp->IsInternal() ? "yes" : "no", s.GetData());
659   }
660 
661   bp_sp->ResolveBreakpoint();
662 
663   if (!internal) {
664     m_last_created_breakpoint = bp_sp;
665   }
666 }
667 
668 void Target::AddNameToBreakpoint(BreakpointID &id,
669                                  const char *name,
670                                  Status &error)
671  {
672    BreakpointSP bp_sp
673        = m_breakpoint_list.FindBreakpointByID(id.GetBreakpointID());
674    if (!bp_sp)
675    {
676      StreamString s;
677      id.GetDescription(&s, eDescriptionLevelBrief);
678      error.SetErrorStringWithFormat("Could not find breakpoint %s",
679                                     s.GetData());
680      return;
681    }
682    AddNameToBreakpoint(bp_sp, name, error);
683  }
684 
685 void Target::AddNameToBreakpoint(BreakpointSP &bp_sp,
686                                  const char *name,
687                                  Status &error)
688  {
689    if (!bp_sp)
690      return;
691 
692    BreakpointName *bp_name = FindBreakpointName(ConstString(name), true, error);
693    if (!bp_name)
694      return;
695 
696    bp_name->ConfigureBreakpoint(bp_sp);
697    bp_sp->AddName(name);
698  }
699 
700 void Target::AddBreakpointName(BreakpointName *bp_name) {
701   m_breakpoint_names.insert(std::make_pair(bp_name->GetName(), bp_name));
702 }
703 
704 BreakpointName *Target::FindBreakpointName(const ConstString &name,
705                                            bool can_create,
706                                            Status &error)
707 {
708   BreakpointID::StringIsBreakpointName(name.GetStringRef(), error);
709   if (!error.Success())
710     return nullptr;
711 
712   BreakpointNameList::iterator iter = m_breakpoint_names.find(name);
713   if (iter == m_breakpoint_names.end()) {
714     if (!can_create)
715     {
716       error.SetErrorStringWithFormat("Breakpoint name \"%s\" doesn't exist and "
717                                      "can_create is false.", name.AsCString());
718       return nullptr;
719     }
720 
721     iter = m_breakpoint_names.insert(std::make_pair(name,
722                                                     new BreakpointName(name)))
723                                                         .first;
724   }
725   return (iter->second);
726 }
727 
728 void
729 Target::DeleteBreakpointName(const ConstString &name)
730 {
731   BreakpointNameList::iterator iter = m_breakpoint_names.find(name);
732 
733   if (iter != m_breakpoint_names.end()) {
734     const char *name_cstr = name.AsCString();
735     m_breakpoint_names.erase(iter);
736     for (auto bp_sp : m_breakpoint_list.Breakpoints())
737       bp_sp->RemoveName(name_cstr);
738   }
739 }
740 
741 void Target::RemoveNameFromBreakpoint(lldb::BreakpointSP &bp_sp,
742                                 const ConstString &name)
743 {
744   bp_sp->RemoveName(name.AsCString());
745 }
746 
747 void Target::ConfigureBreakpointName(BreakpointName &bp_name,
748                                const BreakpointOptions &new_options,
749                                const BreakpointName::Permissions &new_permissions)
750 {
751   bp_name.GetOptions().CopyOverSetOptions(new_options);
752   bp_name.GetPermissions().MergeInto(new_permissions);
753   ApplyNameToBreakpoints(bp_name);
754 }
755 
756 void Target::ApplyNameToBreakpoints(BreakpointName &bp_name) {
757   BreakpointList bkpts_with_name(false);
758   m_breakpoint_list.FindBreakpointsByName(bp_name.GetName().AsCString(),
759                                           bkpts_with_name);
760 
761   for (auto bp_sp : bkpts_with_name.Breakpoints())
762     bp_name.ConfigureBreakpoint(bp_sp);
763 }
764 
765 void Target::GetBreakpointNames(std::vector<std::string> &names)
766 {
767   names.clear();
768   for (auto bp_name : m_breakpoint_names) {
769     names.push_back(bp_name.first.AsCString());
770   }
771   llvm::sort(names.begin(), names.end());
772 }
773 
774 bool Target::ProcessIsValid() {
775   return (m_process_sp && m_process_sp->IsAlive());
776 }
777 
778 static bool CheckIfWatchpointsSupported(Target *target, Status &error) {
779   uint32_t num_supported_hardware_watchpoints;
780   Status rc = target->GetProcessSP()->GetWatchpointSupportInfo(
781       num_supported_hardware_watchpoints);
782 
783   // If unable to determine the # of watchpoints available,
784   // assume they are supported.
785   if (rc.Fail())
786     return true;
787 
788   if (num_supported_hardware_watchpoints == 0) {
789     error.SetErrorStringWithFormat(
790         "Target supports (%u) hardware watchpoint slots.\n",
791         num_supported_hardware_watchpoints);
792     return false;
793   }
794   return true;
795 }
796 
797 // See also Watchpoint::SetWatchpointType(uint32_t type) and the
798 // OptionGroupWatchpoint::WatchType enum type.
799 WatchpointSP Target::CreateWatchpoint(lldb::addr_t addr, size_t size,
800                                       const CompilerType *type, uint32_t kind,
801                                       Status &error) {
802   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
803   if (log)
804     log->Printf("Target::%s (addr = 0x%8.8" PRIx64 " size = %" PRIu64
805                 " type = %u)\n",
806                 __FUNCTION__, addr, (uint64_t)size, kind);
807 
808   WatchpointSP wp_sp;
809   if (!ProcessIsValid()) {
810     error.SetErrorString("process is not alive");
811     return wp_sp;
812   }
813 
814   if (addr == LLDB_INVALID_ADDRESS || size == 0) {
815     if (size == 0)
816       error.SetErrorString("cannot set a watchpoint with watch_size of 0");
817     else
818       error.SetErrorStringWithFormat("invalid watch address: %" PRIu64, addr);
819     return wp_sp;
820   }
821 
822   if (!LLDB_WATCH_TYPE_IS_VALID(kind)) {
823     error.SetErrorStringWithFormat("invalid watchpoint type: %d", kind);
824   }
825 
826   if (!CheckIfWatchpointsSupported(this, error))
827     return wp_sp;
828 
829   // Currently we only support one watchpoint per address, with total number of
830   // watchpoints limited by the hardware which the inferior is running on.
831 
832   // Grab the list mutex while doing operations.
833   const bool notify = false; // Don't notify about all the state changes we do
834                              // on creating the watchpoint.
835   std::unique_lock<std::recursive_mutex> lock;
836   this->GetWatchpointList().GetListMutex(lock);
837   WatchpointSP matched_sp = m_watchpoint_list.FindByAddress(addr);
838   if (matched_sp) {
839     size_t old_size = matched_sp->GetByteSize();
840     uint32_t old_type =
841         (matched_sp->WatchpointRead() ? LLDB_WATCH_TYPE_READ : 0) |
842         (matched_sp->WatchpointWrite() ? LLDB_WATCH_TYPE_WRITE : 0);
843     // Return the existing watchpoint if both size and type match.
844     if (size == old_size && kind == old_type) {
845       wp_sp = matched_sp;
846       wp_sp->SetEnabled(false, notify);
847     } else {
848       // Nil the matched watchpoint; we will be creating a new one.
849       m_process_sp->DisableWatchpoint(matched_sp.get(), notify);
850       m_watchpoint_list.Remove(matched_sp->GetID(), true);
851     }
852   }
853 
854   if (!wp_sp) {
855     wp_sp = std::make_shared<Watchpoint>(*this, addr, size, type);
856     wp_sp->SetWatchpointType(kind, notify);
857     m_watchpoint_list.Add(wp_sp, true);
858   }
859 
860   error = m_process_sp->EnableWatchpoint(wp_sp.get(), notify);
861   if (log)
862     log->Printf("Target::%s (creation of watchpoint %s with id = %u)\n",
863                 __FUNCTION__, error.Success() ? "succeeded" : "failed",
864                 wp_sp->GetID());
865 
866   if (error.Fail()) {
867     // Enabling the watchpoint on the device side failed. Remove the said
868     // watchpoint from the list maintained by the target instance.
869     m_watchpoint_list.Remove(wp_sp->GetID(), true);
870     // See if we could provide more helpful error message.
871     if (!OptionGroupWatchpoint::IsWatchSizeSupported(size))
872       error.SetErrorStringWithFormat(
873           "watch size of %" PRIu64 " is not supported", (uint64_t)size);
874 
875     wp_sp.reset();
876   } else
877     m_last_created_watchpoint = wp_sp;
878   return wp_sp;
879 }
880 
881 void Target::RemoveAllowedBreakpoints ()
882 {
883   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
884   if (log)
885     log->Printf("Target::%s \n", __FUNCTION__);
886 
887   m_breakpoint_list.RemoveAllowed(true);
888 
889   m_last_created_breakpoint.reset();
890 }
891 
892 void Target::RemoveAllBreakpoints(bool internal_also) {
893   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
894   if (log)
895     log->Printf("Target::%s (internal_also = %s)\n", __FUNCTION__,
896                 internal_also ? "yes" : "no");
897 
898   m_breakpoint_list.RemoveAll(true);
899   if (internal_also)
900     m_internal_breakpoint_list.RemoveAll(false);
901 
902   m_last_created_breakpoint.reset();
903 }
904 
905 void Target::DisableAllBreakpoints(bool internal_also) {
906   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
907   if (log)
908     log->Printf("Target::%s (internal_also = %s)\n", __FUNCTION__,
909                 internal_also ? "yes" : "no");
910 
911   m_breakpoint_list.SetEnabledAll(false);
912   if (internal_also)
913     m_internal_breakpoint_list.SetEnabledAll(false);
914 }
915 
916 void Target::DisableAllowedBreakpoints() {
917   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
918   if (log)
919     log->Printf("Target::%s", __FUNCTION__);
920 
921   m_breakpoint_list.SetEnabledAllowed(false);
922 }
923 
924 void Target::EnableAllBreakpoints(bool internal_also) {
925   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
926   if (log)
927     log->Printf("Target::%s (internal_also = %s)\n", __FUNCTION__,
928                 internal_also ? "yes" : "no");
929 
930   m_breakpoint_list.SetEnabledAll(true);
931   if (internal_also)
932     m_internal_breakpoint_list.SetEnabledAll(true);
933 }
934 
935 void Target::EnableAllowedBreakpoints() {
936   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
937   if (log)
938     log->Printf("Target::%s", __FUNCTION__);
939 
940   m_breakpoint_list.SetEnabledAllowed(true);
941 }
942 
943 bool Target::RemoveBreakpointByID(break_id_t break_id) {
944   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
945   if (log)
946     log->Printf("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__,
947                 break_id, LLDB_BREAK_ID_IS_INTERNAL(break_id) ? "yes" : "no");
948 
949   if (DisableBreakpointByID(break_id)) {
950     if (LLDB_BREAK_ID_IS_INTERNAL(break_id))
951       m_internal_breakpoint_list.Remove(break_id, false);
952     else {
953       if (m_last_created_breakpoint) {
954         if (m_last_created_breakpoint->GetID() == break_id)
955           m_last_created_breakpoint.reset();
956       }
957       m_breakpoint_list.Remove(break_id, true);
958     }
959     return true;
960   }
961   return false;
962 }
963 
964 bool Target::DisableBreakpointByID(break_id_t break_id) {
965   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
966   if (log)
967     log->Printf("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__,
968                 break_id, LLDB_BREAK_ID_IS_INTERNAL(break_id) ? "yes" : "no");
969 
970   BreakpointSP bp_sp;
971 
972   if (LLDB_BREAK_ID_IS_INTERNAL(break_id))
973     bp_sp = m_internal_breakpoint_list.FindBreakpointByID(break_id);
974   else
975     bp_sp = m_breakpoint_list.FindBreakpointByID(break_id);
976   if (bp_sp) {
977     bp_sp->SetEnabled(false);
978     return true;
979   }
980   return false;
981 }
982 
983 bool Target::EnableBreakpointByID(break_id_t break_id) {
984   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS));
985   if (log)
986     log->Printf("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__,
987                 break_id, LLDB_BREAK_ID_IS_INTERNAL(break_id) ? "yes" : "no");
988 
989   BreakpointSP bp_sp;
990 
991   if (LLDB_BREAK_ID_IS_INTERNAL(break_id))
992     bp_sp = m_internal_breakpoint_list.FindBreakpointByID(break_id);
993   else
994     bp_sp = m_breakpoint_list.FindBreakpointByID(break_id);
995 
996   if (bp_sp) {
997     bp_sp->SetEnabled(true);
998     return true;
999   }
1000   return false;
1001 }
1002 
1003 Status Target::SerializeBreakpointsToFile(const FileSpec &file,
1004                                           const BreakpointIDList &bp_ids,
1005                                           bool append) {
1006   Status error;
1007 
1008   if (!file) {
1009     error.SetErrorString("Invalid FileSpec.");
1010     return error;
1011   }
1012 
1013   std::string path(file.GetPath());
1014   StructuredData::ObjectSP input_data_sp;
1015 
1016   StructuredData::ArraySP break_store_sp;
1017   StructuredData::Array *break_store_ptr = nullptr;
1018 
1019   if (append) {
1020     input_data_sp = StructuredData::ParseJSONFromFile(file, error);
1021     if (error.Success()) {
1022       break_store_ptr = input_data_sp->GetAsArray();
1023       if (!break_store_ptr) {
1024         error.SetErrorStringWithFormat(
1025             "Tried to append to invalid input file %s", path.c_str());
1026         return error;
1027       }
1028     }
1029   }
1030 
1031   if (!break_store_ptr) {
1032     break_store_sp = std::make_shared<StructuredData::Array>();
1033     break_store_ptr = break_store_sp.get();
1034   }
1035 
1036   StreamFile out_file(path.c_str(),
1037                       File::OpenOptions::eOpenOptionTruncate |
1038                           File::OpenOptions::eOpenOptionWrite |
1039                           File::OpenOptions::eOpenOptionCanCreate |
1040                           File::OpenOptions::eOpenOptionCloseOnExec,
1041                       lldb::eFilePermissionsFileDefault);
1042   if (!out_file.GetFile().IsValid()) {
1043     error.SetErrorStringWithFormat("Unable to open output file: %s.",
1044                                    path.c_str());
1045     return error;
1046   }
1047 
1048   std::unique_lock<std::recursive_mutex> lock;
1049   GetBreakpointList().GetListMutex(lock);
1050 
1051   if (bp_ids.GetSize() == 0) {
1052     const BreakpointList &breakpoints = GetBreakpointList();
1053 
1054     size_t num_breakpoints = breakpoints.GetSize();
1055     for (size_t i = 0; i < num_breakpoints; i++) {
1056       Breakpoint *bp = breakpoints.GetBreakpointAtIndex(i).get();
1057       StructuredData::ObjectSP bkpt_save_sp = bp->SerializeToStructuredData();
1058       // If a breakpoint can't serialize it, just ignore it for now:
1059       if (bkpt_save_sp)
1060         break_store_ptr->AddItem(bkpt_save_sp);
1061     }
1062   } else {
1063 
1064     std::unordered_set<lldb::break_id_t> processed_bkpts;
1065     const size_t count = bp_ids.GetSize();
1066     for (size_t i = 0; i < count; ++i) {
1067       BreakpointID cur_bp_id = bp_ids.GetBreakpointIDAtIndex(i);
1068       lldb::break_id_t bp_id = cur_bp_id.GetBreakpointID();
1069 
1070       if (bp_id != LLDB_INVALID_BREAK_ID) {
1071         // Only do each breakpoint once:
1072         std::pair<std::unordered_set<lldb::break_id_t>::iterator, bool>
1073             insert_result = processed_bkpts.insert(bp_id);
1074         if (!insert_result.second)
1075           continue;
1076 
1077         Breakpoint *bp = GetBreakpointByID(bp_id).get();
1078         StructuredData::ObjectSP bkpt_save_sp = bp->SerializeToStructuredData();
1079         // If the user explicitly asked to serialize a breakpoint, and we
1080         // can't, then raise an error:
1081         if (!bkpt_save_sp) {
1082           error.SetErrorStringWithFormat("Unable to serialize breakpoint %d",
1083                                          bp_id);
1084           return error;
1085         }
1086         break_store_ptr->AddItem(bkpt_save_sp);
1087       }
1088     }
1089   }
1090 
1091   break_store_ptr->Dump(out_file, false);
1092   out_file.PutChar('\n');
1093   return error;
1094 }
1095 
1096 Status Target::CreateBreakpointsFromFile(const FileSpec &file,
1097                                          BreakpointIDList &new_bps) {
1098   std::vector<std::string> no_names;
1099   return CreateBreakpointsFromFile(file, no_names, new_bps);
1100 }
1101 
1102 Status Target::CreateBreakpointsFromFile(const FileSpec &file,
1103                                          std::vector<std::string> &names,
1104                                          BreakpointIDList &new_bps) {
1105   std::unique_lock<std::recursive_mutex> lock;
1106   GetBreakpointList().GetListMutex(lock);
1107 
1108   Status error;
1109   StructuredData::ObjectSP input_data_sp =
1110       StructuredData::ParseJSONFromFile(file, error);
1111   if (!error.Success()) {
1112     return error;
1113   } else if (!input_data_sp || !input_data_sp->IsValid()) {
1114     error.SetErrorStringWithFormat("Invalid JSON from input file: %s.",
1115                                    file.GetPath().c_str());
1116     return error;
1117   }
1118 
1119   StructuredData::Array *bkpt_array = input_data_sp->GetAsArray();
1120   if (!bkpt_array) {
1121     error.SetErrorStringWithFormat(
1122         "Invalid breakpoint data from input file: %s.", file.GetPath().c_str());
1123     return error;
1124   }
1125 
1126   size_t num_bkpts = bkpt_array->GetSize();
1127   size_t num_names = names.size();
1128 
1129   for (size_t i = 0; i < num_bkpts; i++) {
1130     StructuredData::ObjectSP bkpt_object_sp = bkpt_array->GetItemAtIndex(i);
1131     // Peel off the breakpoint key, and feed the rest to the Breakpoint:
1132     StructuredData::Dictionary *bkpt_dict = bkpt_object_sp->GetAsDictionary();
1133     if (!bkpt_dict) {
1134       error.SetErrorStringWithFormat(
1135           "Invalid breakpoint data for element %zu from input file: %s.", i,
1136           file.GetPath().c_str());
1137       return error;
1138     }
1139     StructuredData::ObjectSP bkpt_data_sp =
1140         bkpt_dict->GetValueForKey(Breakpoint::GetSerializationKey());
1141     if (num_names &&
1142         !Breakpoint::SerializedBreakpointMatchesNames(bkpt_data_sp, names))
1143       continue;
1144 
1145     BreakpointSP bkpt_sp =
1146         Breakpoint::CreateFromStructuredData(*this, bkpt_data_sp, error);
1147     if (!error.Success()) {
1148       error.SetErrorStringWithFormat(
1149           "Error restoring breakpoint %zu from %s: %s.", i,
1150           file.GetPath().c_str(), error.AsCString());
1151       return error;
1152     }
1153     new_bps.AddBreakpointID(BreakpointID(bkpt_sp->GetID()));
1154   }
1155   return error;
1156 }
1157 
1158 // The flag 'end_to_end', default to true, signifies that the operation is
1159 // performed end to end, for both the debugger and the debuggee.
1160 
1161 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end
1162 // to end operations.
1163 bool Target::RemoveAllWatchpoints(bool end_to_end) {
1164   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1165   if (log)
1166     log->Printf("Target::%s\n", __FUNCTION__);
1167 
1168   if (!end_to_end) {
1169     m_watchpoint_list.RemoveAll(true);
1170     return true;
1171   }
1172 
1173   // Otherwise, it's an end to end operation.
1174 
1175   if (!ProcessIsValid())
1176     return false;
1177 
1178   size_t num_watchpoints = m_watchpoint_list.GetSize();
1179   for (size_t i = 0; i < num_watchpoints; ++i) {
1180     WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
1181     if (!wp_sp)
1182       return false;
1183 
1184     Status rc = m_process_sp->DisableWatchpoint(wp_sp.get());
1185     if (rc.Fail())
1186       return false;
1187   }
1188   m_watchpoint_list.RemoveAll(true);
1189   m_last_created_watchpoint.reset();
1190   return true; // Success!
1191 }
1192 
1193 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end
1194 // to end operations.
1195 bool Target::DisableAllWatchpoints(bool end_to_end) {
1196   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1197   if (log)
1198     log->Printf("Target::%s\n", __FUNCTION__);
1199 
1200   if (!end_to_end) {
1201     m_watchpoint_list.SetEnabledAll(false);
1202     return true;
1203   }
1204 
1205   // Otherwise, it's an end to end operation.
1206 
1207   if (!ProcessIsValid())
1208     return false;
1209 
1210   size_t num_watchpoints = m_watchpoint_list.GetSize();
1211   for (size_t i = 0; i < num_watchpoints; ++i) {
1212     WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
1213     if (!wp_sp)
1214       return false;
1215 
1216     Status rc = m_process_sp->DisableWatchpoint(wp_sp.get());
1217     if (rc.Fail())
1218       return false;
1219   }
1220   return true; // Success!
1221 }
1222 
1223 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end
1224 // to end operations.
1225 bool Target::EnableAllWatchpoints(bool end_to_end) {
1226   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1227   if (log)
1228     log->Printf("Target::%s\n", __FUNCTION__);
1229 
1230   if (!end_to_end) {
1231     m_watchpoint_list.SetEnabledAll(true);
1232     return true;
1233   }
1234 
1235   // Otherwise, it's an end to end operation.
1236 
1237   if (!ProcessIsValid())
1238     return false;
1239 
1240   size_t num_watchpoints = m_watchpoint_list.GetSize();
1241   for (size_t i = 0; i < num_watchpoints; ++i) {
1242     WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
1243     if (!wp_sp)
1244       return false;
1245 
1246     Status rc = m_process_sp->EnableWatchpoint(wp_sp.get());
1247     if (rc.Fail())
1248       return false;
1249   }
1250   return true; // Success!
1251 }
1252 
1253 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
1254 bool Target::ClearAllWatchpointHitCounts() {
1255   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1256   if (log)
1257     log->Printf("Target::%s\n", __FUNCTION__);
1258 
1259   size_t num_watchpoints = m_watchpoint_list.GetSize();
1260   for (size_t i = 0; i < num_watchpoints; ++i) {
1261     WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
1262     if (!wp_sp)
1263       return false;
1264 
1265     wp_sp->ResetHitCount();
1266   }
1267   return true; // Success!
1268 }
1269 
1270 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
1271 bool Target::ClearAllWatchpointHistoricValues() {
1272   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1273   if (log)
1274     log->Printf("Target::%s\n", __FUNCTION__);
1275 
1276   size_t num_watchpoints = m_watchpoint_list.GetSize();
1277   for (size_t i = 0; i < num_watchpoints; ++i) {
1278     WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
1279     if (!wp_sp)
1280       return false;
1281 
1282     wp_sp->ResetHistoricValues();
1283   }
1284   return true; // Success!
1285 }
1286 
1287 // Assumption: Caller holds the list mutex lock for m_watchpoint_list during
1288 // these operations.
1289 bool Target::IgnoreAllWatchpoints(uint32_t ignore_count) {
1290   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1291   if (log)
1292     log->Printf("Target::%s\n", __FUNCTION__);
1293 
1294   if (!ProcessIsValid())
1295     return false;
1296 
1297   size_t num_watchpoints = m_watchpoint_list.GetSize();
1298   for (size_t i = 0; i < num_watchpoints; ++i) {
1299     WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
1300     if (!wp_sp)
1301       return false;
1302 
1303     wp_sp->SetIgnoreCount(ignore_count);
1304   }
1305   return true; // Success!
1306 }
1307 
1308 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
1309 bool Target::DisableWatchpointByID(lldb::watch_id_t watch_id) {
1310   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1311   if (log)
1312     log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
1313 
1314   if (!ProcessIsValid())
1315     return false;
1316 
1317   WatchpointSP wp_sp = m_watchpoint_list.FindByID(watch_id);
1318   if (wp_sp) {
1319     Status rc = m_process_sp->DisableWatchpoint(wp_sp.get());
1320     if (rc.Success())
1321       return true;
1322 
1323     // Else, fallthrough.
1324   }
1325   return false;
1326 }
1327 
1328 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
1329 bool Target::EnableWatchpointByID(lldb::watch_id_t watch_id) {
1330   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1331   if (log)
1332     log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
1333 
1334   if (!ProcessIsValid())
1335     return false;
1336 
1337   WatchpointSP wp_sp = m_watchpoint_list.FindByID(watch_id);
1338   if (wp_sp) {
1339     Status rc = m_process_sp->EnableWatchpoint(wp_sp.get());
1340     if (rc.Success())
1341       return true;
1342 
1343     // Else, fallthrough.
1344   }
1345   return false;
1346 }
1347 
1348 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
1349 bool Target::RemoveWatchpointByID(lldb::watch_id_t watch_id) {
1350   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1351   if (log)
1352     log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
1353 
1354   WatchpointSP watch_to_remove_sp = m_watchpoint_list.FindByID(watch_id);
1355   if (watch_to_remove_sp == m_last_created_watchpoint)
1356     m_last_created_watchpoint.reset();
1357 
1358   if (DisableWatchpointByID(watch_id)) {
1359     m_watchpoint_list.Remove(watch_id, true);
1360     return true;
1361   }
1362   return false;
1363 }
1364 
1365 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
1366 bool Target::IgnoreWatchpointByID(lldb::watch_id_t watch_id,
1367                                   uint32_t ignore_count) {
1368   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS));
1369   if (log)
1370     log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
1371 
1372   if (!ProcessIsValid())
1373     return false;
1374 
1375   WatchpointSP wp_sp = m_watchpoint_list.FindByID(watch_id);
1376   if (wp_sp) {
1377     wp_sp->SetIgnoreCount(ignore_count);
1378     return true;
1379   }
1380   return false;
1381 }
1382 
1383 ModuleSP Target::GetExecutableModule() {
1384   // search for the first executable in the module list
1385   for (size_t i = 0; i < m_images.GetSize(); ++i) {
1386     ModuleSP module_sp = m_images.GetModuleAtIndex(i);
1387     lldb_private::ObjectFile *obj = module_sp->GetObjectFile();
1388     if (obj == nullptr)
1389       continue;
1390     if (obj->GetType() == ObjectFile::Type::eTypeExecutable)
1391       return module_sp;
1392   }
1393   // as fall back return the first module loaded
1394   return m_images.GetModuleAtIndex(0);
1395 }
1396 
1397 Module *Target::GetExecutableModulePointer() {
1398   return GetExecutableModule().get();
1399 }
1400 
1401 static void LoadScriptingResourceForModule(const ModuleSP &module_sp,
1402                                            Target *target) {
1403   Status error;
1404   StreamString feedback_stream;
1405   if (module_sp &&
1406       !module_sp->LoadScriptingResourceInTarget(target, error,
1407                                                 &feedback_stream)) {
1408     if (error.AsCString())
1409       target->GetDebugger().GetErrorFile()->Printf(
1410           "unable to load scripting data for module %s - error reported was "
1411           "%s\n",
1412           module_sp->GetFileSpec().GetFileNameStrippingExtension().GetCString(),
1413           error.AsCString());
1414   }
1415   if (feedback_stream.GetSize())
1416     target->GetDebugger().GetErrorFile()->Printf("%s\n",
1417                                                  feedback_stream.GetData());
1418 }
1419 
1420 void Target::ClearModules(bool delete_locations) {
1421   ModulesDidUnload(m_images, delete_locations);
1422   m_section_load_history.Clear();
1423   m_images.Clear();
1424   m_scratch_type_system_map.Clear();
1425   m_ast_importer_sp.reset();
1426 }
1427 
1428 void Target::DidExec() {
1429   // When a process exec's we need to know about it so we can do some cleanup.
1430   m_breakpoint_list.RemoveInvalidLocations(m_arch.GetSpec());
1431   m_internal_breakpoint_list.RemoveInvalidLocations(m_arch.GetSpec());
1432 }
1433 
1434 void Target::SetExecutableModule(ModuleSP &executable_sp,
1435                                  LoadDependentFiles load_dependent_files) {
1436   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET));
1437   ClearModules(false);
1438 
1439   if (executable_sp) {
1440     static Timer::Category func_cat(LLVM_PRETTY_FUNCTION);
1441     Timer scoped_timer(func_cat,
1442                        "Target::SetExecutableModule (executable = '%s')",
1443                        executable_sp->GetFileSpec().GetPath().c_str());
1444 
1445     m_images.Append(executable_sp); // The first image is our executable file
1446 
1447     // If we haven't set an architecture yet, reset our architecture based on
1448     // what we found in the executable module.
1449     if (!m_arch.GetSpec().IsValid()) {
1450       m_arch = executable_sp->GetArchitecture();
1451       LLDB_LOG(log,
1452                "setting architecture to {0} ({1}) based on executable file",
1453                m_arch.GetSpec().GetArchitectureName(),
1454                m_arch.GetSpec().GetTriple().getTriple());
1455     }
1456 
1457     FileSpecList dependent_files;
1458     ObjectFile *executable_objfile = executable_sp->GetObjectFile();
1459     bool load_dependents = true;
1460     switch (load_dependent_files) {
1461     case eLoadDependentsDefault:
1462       load_dependents = executable_sp->IsExecutable();
1463       break;
1464     case eLoadDependentsYes:
1465       load_dependents = true;
1466       break;
1467     case eLoadDependentsNo:
1468       load_dependents = false;
1469       break;
1470     }
1471 
1472     if (executable_objfile && load_dependents) {
1473       executable_objfile->GetDependentModules(dependent_files);
1474       for (uint32_t i = 0; i < dependent_files.GetSize(); i++) {
1475         FileSpec dependent_file_spec(
1476             dependent_files.GetFileSpecPointerAtIndex(i));
1477         FileSpec platform_dependent_file_spec;
1478         if (m_platform_sp)
1479           m_platform_sp->GetFileWithUUID(dependent_file_spec, nullptr,
1480                                          platform_dependent_file_spec);
1481         else
1482           platform_dependent_file_spec = dependent_file_spec;
1483 
1484         ModuleSpec module_spec(platform_dependent_file_spec, m_arch.GetSpec());
1485         ModuleSP image_module_sp(GetSharedModule(module_spec));
1486         if (image_module_sp) {
1487           ObjectFile *objfile = image_module_sp->GetObjectFile();
1488           if (objfile)
1489             objfile->GetDependentModules(dependent_files);
1490         }
1491       }
1492     }
1493   }
1494 }
1495 
1496 bool Target::SetArchitecture(const ArchSpec &arch_spec, bool set_platform) {
1497   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET));
1498   bool missing_local_arch = !m_arch.GetSpec().IsValid();
1499   bool replace_local_arch = true;
1500   bool compatible_local_arch = false;
1501   ArchSpec other(arch_spec);
1502 
1503   // Changing the architecture might mean that the currently selected platform
1504   // isn't compatible. Set the platform correctly if we are asked to do so,
1505   // otherwise assume the user will set the platform manually.
1506   if (set_platform) {
1507     if (other.IsValid()) {
1508       auto platform_sp = GetPlatform();
1509       if (!platform_sp ||
1510           !platform_sp->IsCompatibleArchitecture(other, false, nullptr)) {
1511         ArchSpec platform_arch;
1512         auto arch_platform_sp =
1513             Platform::GetPlatformForArchitecture(other, &platform_arch);
1514         if (arch_platform_sp) {
1515           SetPlatform(arch_platform_sp);
1516           if (platform_arch.IsValid())
1517             other = platform_arch;
1518         }
1519       }
1520     }
1521   }
1522 
1523   if (!missing_local_arch) {
1524     if (m_arch.GetSpec().IsCompatibleMatch(arch_spec)) {
1525       other.MergeFrom(m_arch.GetSpec());
1526 
1527       if (m_arch.GetSpec().IsCompatibleMatch(other)) {
1528         compatible_local_arch = true;
1529         bool arch_changed, vendor_changed, os_changed, os_ver_changed,
1530             env_changed;
1531 
1532         m_arch.GetSpec().PiecewiseTripleCompare(other, arch_changed, vendor_changed,
1533                                       os_changed, os_ver_changed, env_changed);
1534 
1535         if (!arch_changed && !vendor_changed && !os_changed && !env_changed)
1536           replace_local_arch = false;
1537       }
1538     }
1539   }
1540 
1541   if (compatible_local_arch || missing_local_arch) {
1542     // If we haven't got a valid arch spec, or the architectures are compatible
1543     // update the architecture, unless the one we already have is more
1544     // specified
1545     if (replace_local_arch)
1546       m_arch = other;
1547     LLDB_LOG(log, "set architecture to {0} ({1})",
1548              m_arch.GetSpec().GetArchitectureName(),
1549              m_arch.GetSpec().GetTriple().getTriple());
1550     return true;
1551   }
1552 
1553   // If we have an executable file, try to reset the executable to the desired
1554   // architecture
1555   if (log)
1556     log->Printf("Target::SetArchitecture changing architecture to %s (%s)",
1557                 arch_spec.GetArchitectureName(),
1558                 arch_spec.GetTriple().getTriple().c_str());
1559   m_arch = other;
1560   ModuleSP executable_sp = GetExecutableModule();
1561 
1562   ClearModules(true);
1563   // Need to do something about unsetting breakpoints.
1564 
1565   if (executable_sp) {
1566     if (log)
1567       log->Printf("Target::SetArchitecture Trying to select executable file "
1568                   "architecture %s (%s)",
1569                   arch_spec.GetArchitectureName(),
1570                   arch_spec.GetTriple().getTriple().c_str());
1571     ModuleSpec module_spec(executable_sp->GetFileSpec(), other);
1572     Status error = ModuleList::GetSharedModule(module_spec, executable_sp,
1573                                                &GetExecutableSearchPaths(),
1574                                                nullptr, nullptr);
1575 
1576     if (!error.Fail() && executable_sp) {
1577       SetExecutableModule(executable_sp, eLoadDependentsYes);
1578       return true;
1579     }
1580   }
1581   return false;
1582 }
1583 
1584 bool Target::MergeArchitecture(const ArchSpec &arch_spec) {
1585   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET));
1586   if (arch_spec.IsValid()) {
1587     if (m_arch.GetSpec().IsCompatibleMatch(arch_spec)) {
1588       // The current target arch is compatible with "arch_spec", see if we can
1589       // improve our current architecture using bits from "arch_spec"
1590 
1591       if (log)
1592         log->Printf("Target::MergeArchitecture target has arch %s, merging with "
1593                     "arch %s",
1594                     m_arch.GetSpec().GetTriple().getTriple().c_str(),
1595                     arch_spec.GetTriple().getTriple().c_str());
1596 
1597       // Merge bits from arch_spec into "merged_arch" and set our architecture
1598       ArchSpec merged_arch(m_arch.GetSpec());
1599       merged_arch.MergeFrom(arch_spec);
1600       return SetArchitecture(merged_arch);
1601     } else {
1602       // The new architecture is different, we just need to replace it
1603       return SetArchitecture(arch_spec);
1604     }
1605   }
1606   return false;
1607 }
1608 
1609 void Target::WillClearList(const ModuleList &module_list) {}
1610 
1611 void Target::ModuleAdded(const ModuleList &module_list,
1612                          const ModuleSP &module_sp) {
1613   // A module is being added to this target for the first time
1614   if (m_valid) {
1615     ModuleList my_module_list;
1616     my_module_list.Append(module_sp);
1617     LoadScriptingResourceForModule(module_sp, this);
1618     ModulesDidLoad(my_module_list);
1619   }
1620 }
1621 
1622 void Target::ModuleRemoved(const ModuleList &module_list,
1623                            const ModuleSP &module_sp) {
1624   // A module is being removed from this target.
1625   if (m_valid) {
1626     ModuleList my_module_list;
1627     my_module_list.Append(module_sp);
1628     ModulesDidUnload(my_module_list, false);
1629   }
1630 }
1631 
1632 void Target::ModuleUpdated(const ModuleList &module_list,
1633                            const ModuleSP &old_module_sp,
1634                            const ModuleSP &new_module_sp) {
1635   // A module is replacing an already added module
1636   if (m_valid) {
1637     m_breakpoint_list.UpdateBreakpointsWhenModuleIsReplaced(old_module_sp,
1638                                                             new_module_sp);
1639     m_internal_breakpoint_list.UpdateBreakpointsWhenModuleIsReplaced(
1640         old_module_sp, new_module_sp);
1641   }
1642 }
1643 
1644 void Target::ModulesDidLoad(ModuleList &module_list) {
1645   if (m_valid && module_list.GetSize()) {
1646     m_breakpoint_list.UpdateBreakpoints(module_list, true, false);
1647     m_internal_breakpoint_list.UpdateBreakpoints(module_list, true, false);
1648     if (m_process_sp) {
1649       m_process_sp->ModulesDidLoad(module_list);
1650     }
1651     BroadcastEvent(eBroadcastBitModulesLoaded,
1652                    new TargetEventData(this->shared_from_this(), module_list));
1653   }
1654 }
1655 
1656 void Target::SymbolsDidLoad(ModuleList &module_list) {
1657   if (m_valid && module_list.GetSize()) {
1658     if (m_process_sp) {
1659       LanguageRuntime *runtime =
1660           m_process_sp->GetLanguageRuntime(lldb::eLanguageTypeObjC);
1661       if (runtime) {
1662         ObjCLanguageRuntime *objc_runtime = (ObjCLanguageRuntime *)runtime;
1663         objc_runtime->SymbolsDidLoad(module_list);
1664       }
1665     }
1666 
1667     m_breakpoint_list.UpdateBreakpoints(module_list, true, false);
1668     m_internal_breakpoint_list.UpdateBreakpoints(module_list, true, false);
1669     BroadcastEvent(eBroadcastBitSymbolsLoaded,
1670                    new TargetEventData(this->shared_from_this(), module_list));
1671   }
1672 }
1673 
1674 void Target::ModulesDidUnload(ModuleList &module_list, bool delete_locations) {
1675   if (m_valid && module_list.GetSize()) {
1676     UnloadModuleSections(module_list);
1677     m_breakpoint_list.UpdateBreakpoints(module_list, false, delete_locations);
1678     m_internal_breakpoint_list.UpdateBreakpoints(module_list, false,
1679                                                  delete_locations);
1680     BroadcastEvent(eBroadcastBitModulesUnloaded,
1681                    new TargetEventData(this->shared_from_this(), module_list));
1682   }
1683 }
1684 
1685 bool Target::ModuleIsExcludedForUnconstrainedSearches(
1686     const FileSpec &module_file_spec) {
1687   if (GetBreakpointsConsultPlatformAvoidList()) {
1688     ModuleList matchingModules;
1689     ModuleSpec module_spec(module_file_spec);
1690     size_t num_modules = GetImages().FindModules(module_spec, matchingModules);
1691 
1692     // If there is more than one module for this file spec, only return true if
1693     // ALL the modules are on the
1694     // black list.
1695     if (num_modules > 0) {
1696       for (size_t i = 0; i < num_modules; i++) {
1697         if (!ModuleIsExcludedForUnconstrainedSearches(
1698                 matchingModules.GetModuleAtIndex(i)))
1699           return false;
1700       }
1701       return true;
1702     }
1703   }
1704   return false;
1705 }
1706 
1707 bool Target::ModuleIsExcludedForUnconstrainedSearches(
1708     const lldb::ModuleSP &module_sp) {
1709   if (GetBreakpointsConsultPlatformAvoidList()) {
1710     if (m_platform_sp)
1711       return m_platform_sp->ModuleIsExcludedForUnconstrainedSearches(*this,
1712                                                                      module_sp);
1713   }
1714   return false;
1715 }
1716 
1717 size_t Target::ReadMemoryFromFileCache(const Address &addr, void *dst,
1718                                        size_t dst_len, Status &error) {
1719   SectionSP section_sp(addr.GetSection());
1720   if (section_sp) {
1721     // If the contents of this section are encrypted, the on-disk file is
1722     // unusable.  Read only from live memory.
1723     if (section_sp->IsEncrypted()) {
1724       error.SetErrorString("section is encrypted");
1725       return 0;
1726     }
1727     ModuleSP module_sp(section_sp->GetModule());
1728     if (module_sp) {
1729       ObjectFile *objfile = section_sp->GetModule()->GetObjectFile();
1730       if (objfile) {
1731         size_t bytes_read = objfile->ReadSectionData(
1732             section_sp.get(), addr.GetOffset(), dst, dst_len);
1733         if (bytes_read > 0)
1734           return bytes_read;
1735         else
1736           error.SetErrorStringWithFormat("error reading data from section %s",
1737                                          section_sp->GetName().GetCString());
1738       } else
1739         error.SetErrorString("address isn't from a object file");
1740     } else
1741       error.SetErrorString("address isn't in a module");
1742   } else
1743     error.SetErrorString("address doesn't contain a section that points to a "
1744                          "section in a object file");
1745 
1746   return 0;
1747 }
1748 
1749 size_t Target::ReadMemory(const Address &addr, bool prefer_file_cache,
1750                           void *dst, size_t dst_len, Status &error,
1751                           lldb::addr_t *load_addr_ptr) {
1752   error.Clear();
1753 
1754   // if we end up reading this from process memory, we will fill this with the
1755   // actual load address
1756   if (load_addr_ptr)
1757     *load_addr_ptr = LLDB_INVALID_ADDRESS;
1758 
1759   size_t bytes_read = 0;
1760 
1761   addr_t load_addr = LLDB_INVALID_ADDRESS;
1762   addr_t file_addr = LLDB_INVALID_ADDRESS;
1763   Address resolved_addr;
1764   if (!addr.IsSectionOffset()) {
1765     SectionLoadList &section_load_list = GetSectionLoadList();
1766     if (section_load_list.IsEmpty()) {
1767       // No sections are loaded, so we must assume we are not running yet and
1768       // anything we are given is a file address.
1769       file_addr = addr.GetOffset(); // "addr" doesn't have a section, so its
1770                                     // offset is the file address
1771       m_images.ResolveFileAddress(file_addr, resolved_addr);
1772     } else {
1773       // We have at least one section loaded. This can be because we have
1774       // manually loaded some sections with "target modules load ..." or
1775       // because we have have a live process that has sections loaded through
1776       // the dynamic loader
1777       load_addr = addr.GetOffset(); // "addr" doesn't have a section, so its
1778                                     // offset is the load address
1779       section_load_list.ResolveLoadAddress(load_addr, resolved_addr);
1780     }
1781   }
1782   if (!resolved_addr.IsValid())
1783     resolved_addr = addr;
1784 
1785   if (prefer_file_cache) {
1786     bytes_read = ReadMemoryFromFileCache(resolved_addr, dst, dst_len, error);
1787     if (bytes_read > 0)
1788       return bytes_read;
1789   }
1790 
1791   if (ProcessIsValid()) {
1792     if (load_addr == LLDB_INVALID_ADDRESS)
1793       load_addr = resolved_addr.GetLoadAddress(this);
1794 
1795     if (load_addr == LLDB_INVALID_ADDRESS) {
1796       ModuleSP addr_module_sp(resolved_addr.GetModule());
1797       if (addr_module_sp && addr_module_sp->GetFileSpec())
1798         error.SetErrorStringWithFormatv(
1799             "{0:F}[{1:x+}] can't be resolved, {0:F} is not currently loaded",
1800             addr_module_sp->GetFileSpec(), resolved_addr.GetFileAddress());
1801       else
1802         error.SetErrorStringWithFormat("0x%" PRIx64 " can't be resolved",
1803                                        resolved_addr.GetFileAddress());
1804     } else {
1805       bytes_read = m_process_sp->ReadMemory(load_addr, dst, dst_len, error);
1806       if (bytes_read != dst_len) {
1807         if (error.Success()) {
1808           if (bytes_read == 0)
1809             error.SetErrorStringWithFormat(
1810                 "read memory from 0x%" PRIx64 " failed", load_addr);
1811           else
1812             error.SetErrorStringWithFormat(
1813                 "only %" PRIu64 " of %" PRIu64
1814                 " bytes were read from memory at 0x%" PRIx64,
1815                 (uint64_t)bytes_read, (uint64_t)dst_len, load_addr);
1816         }
1817       }
1818       if (bytes_read) {
1819         if (load_addr_ptr)
1820           *load_addr_ptr = load_addr;
1821         return bytes_read;
1822       }
1823       // If the address is not section offset we have an address that doesn't
1824       // resolve to any address in any currently loaded shared libraries and we
1825       // failed to read memory so there isn't anything more we can do. If it is
1826       // section offset, we might be able to read cached memory from the object
1827       // file.
1828       if (!resolved_addr.IsSectionOffset())
1829         return 0;
1830     }
1831   }
1832 
1833   if (!prefer_file_cache && resolved_addr.IsSectionOffset()) {
1834     // If we didn't already try and read from the object file cache, then try
1835     // it after failing to read from the process.
1836     return ReadMemoryFromFileCache(resolved_addr, dst, dst_len, error);
1837   }
1838   return 0;
1839 }
1840 
1841 size_t Target::ReadCStringFromMemory(const Address &addr, std::string &out_str,
1842                                      Status &error) {
1843   char buf[256];
1844   out_str.clear();
1845   addr_t curr_addr = addr.GetLoadAddress(this);
1846   Address address(addr);
1847   while (1) {
1848     size_t length = ReadCStringFromMemory(address, buf, sizeof(buf), error);
1849     if (length == 0)
1850       break;
1851     out_str.append(buf, length);
1852     // If we got "length - 1" bytes, we didn't get the whole C string, we need
1853     // to read some more characters
1854     if (length == sizeof(buf) - 1)
1855       curr_addr += length;
1856     else
1857       break;
1858     address = Address(curr_addr);
1859   }
1860   return out_str.size();
1861 }
1862 
1863 size_t Target::ReadCStringFromMemory(const Address &addr, char *dst,
1864                                      size_t dst_max_len, Status &result_error) {
1865   size_t total_cstr_len = 0;
1866   if (dst && dst_max_len) {
1867     result_error.Clear();
1868     // NULL out everything just to be safe
1869     memset(dst, 0, dst_max_len);
1870     Status error;
1871     addr_t curr_addr = addr.GetLoadAddress(this);
1872     Address address(addr);
1873 
1874     // We could call m_process_sp->GetMemoryCacheLineSize() but I don't think
1875     // this really needs to be tied to the memory cache subsystem's cache line
1876     // size, so leave this as a fixed constant.
1877     const size_t cache_line_size = 512;
1878 
1879     size_t bytes_left = dst_max_len - 1;
1880     char *curr_dst = dst;
1881 
1882     while (bytes_left > 0) {
1883       addr_t cache_line_bytes_left =
1884           cache_line_size - (curr_addr % cache_line_size);
1885       addr_t bytes_to_read =
1886           std::min<addr_t>(bytes_left, cache_line_bytes_left);
1887       size_t bytes_read =
1888           ReadMemory(address, false, curr_dst, bytes_to_read, error);
1889 
1890       if (bytes_read == 0) {
1891         result_error = error;
1892         dst[total_cstr_len] = '\0';
1893         break;
1894       }
1895       const size_t len = strlen(curr_dst);
1896 
1897       total_cstr_len += len;
1898 
1899       if (len < bytes_to_read)
1900         break;
1901 
1902       curr_dst += bytes_read;
1903       curr_addr += bytes_read;
1904       bytes_left -= bytes_read;
1905       address = Address(curr_addr);
1906     }
1907   } else {
1908     if (dst == nullptr)
1909       result_error.SetErrorString("invalid arguments");
1910     else
1911       result_error.Clear();
1912   }
1913   return total_cstr_len;
1914 }
1915 
1916 size_t Target::ReadScalarIntegerFromMemory(const Address &addr,
1917                                            bool prefer_file_cache,
1918                                            uint32_t byte_size, bool is_signed,
1919                                            Scalar &scalar, Status &error) {
1920   uint64_t uval;
1921 
1922   if (byte_size <= sizeof(uval)) {
1923     size_t bytes_read =
1924         ReadMemory(addr, prefer_file_cache, &uval, byte_size, error);
1925     if (bytes_read == byte_size) {
1926       DataExtractor data(&uval, sizeof(uval), m_arch.GetSpec().GetByteOrder(),
1927                          m_arch.GetSpec().GetAddressByteSize());
1928       lldb::offset_t offset = 0;
1929       if (byte_size <= 4)
1930         scalar = data.GetMaxU32(&offset, byte_size);
1931       else
1932         scalar = data.GetMaxU64(&offset, byte_size);
1933 
1934       if (is_signed)
1935         scalar.SignExtend(byte_size * 8);
1936       return bytes_read;
1937     }
1938   } else {
1939     error.SetErrorStringWithFormat(
1940         "byte size of %u is too large for integer scalar type", byte_size);
1941   }
1942   return 0;
1943 }
1944 
1945 uint64_t Target::ReadUnsignedIntegerFromMemory(const Address &addr,
1946                                                bool prefer_file_cache,
1947                                                size_t integer_byte_size,
1948                                                uint64_t fail_value,
1949                                                Status &error) {
1950   Scalar scalar;
1951   if (ReadScalarIntegerFromMemory(addr, prefer_file_cache, integer_byte_size,
1952                                   false, scalar, error))
1953     return scalar.ULongLong(fail_value);
1954   return fail_value;
1955 }
1956 
1957 bool Target::ReadPointerFromMemory(const Address &addr, bool prefer_file_cache,
1958                                    Status &error, Address &pointer_addr) {
1959   Scalar scalar;
1960   if (ReadScalarIntegerFromMemory(addr, prefer_file_cache,
1961                                   m_arch.GetSpec().GetAddressByteSize(), false, scalar,
1962                                   error)) {
1963     addr_t pointer_vm_addr = scalar.ULongLong(LLDB_INVALID_ADDRESS);
1964     if (pointer_vm_addr != LLDB_INVALID_ADDRESS) {
1965       SectionLoadList &section_load_list = GetSectionLoadList();
1966       if (section_load_list.IsEmpty()) {
1967         // No sections are loaded, so we must assume we are not running yet and
1968         // anything we are given is a file address.
1969         m_images.ResolveFileAddress(pointer_vm_addr, pointer_addr);
1970       } else {
1971         // We have at least one section loaded. This can be because we have
1972         // manually loaded some sections with "target modules load ..." or
1973         // because we have have a live process that has sections loaded through
1974         // the dynamic loader
1975         section_load_list.ResolveLoadAddress(pointer_vm_addr, pointer_addr);
1976       }
1977       // We weren't able to resolve the pointer value, so just return an
1978       // address with no section
1979       if (!pointer_addr.IsValid())
1980         pointer_addr.SetOffset(pointer_vm_addr);
1981       return true;
1982     }
1983   }
1984   return false;
1985 }
1986 
1987 ModuleSP Target::GetSharedModule(const ModuleSpec &module_spec,
1988                                  Status *error_ptr) {
1989   ModuleSP module_sp;
1990 
1991   Status error;
1992 
1993   // First see if we already have this module in our module list.  If we do,
1994   // then we're done, we don't need to consult the shared modules list.  But
1995   // only do this if we are passed a UUID.
1996 
1997   if (module_spec.GetUUID().IsValid())
1998     module_sp = m_images.FindFirstModule(module_spec);
1999 
2000   if (!module_sp) {
2001     ModuleSP old_module_sp; // This will get filled in if we have a new version
2002                             // of the library
2003     bool did_create_module = false;
2004 
2005     // If there are image search path entries, try to use them first to acquire
2006     // a suitable image.
2007     if (m_image_search_paths.GetSize()) {
2008       ModuleSpec transformed_spec(module_spec);
2009       if (m_image_search_paths.RemapPath(
2010               module_spec.GetFileSpec().GetDirectory(),
2011               transformed_spec.GetFileSpec().GetDirectory())) {
2012         transformed_spec.GetFileSpec().GetFilename() =
2013             module_spec.GetFileSpec().GetFilename();
2014         error = ModuleList::GetSharedModule(transformed_spec, module_sp,
2015                                             &GetExecutableSearchPaths(),
2016                                             &old_module_sp, &did_create_module);
2017       }
2018     }
2019 
2020     if (!module_sp) {
2021       // If we have a UUID, we can check our global shared module list in case
2022       // we already have it. If we don't have a valid UUID, then we can't since
2023       // the path in "module_spec" will be a platform path, and we will need to
2024       // let the platform find that file. For example, we could be asking for
2025       // "/usr/lib/dyld" and if we do not have a UUID, we don't want to pick
2026       // the local copy of "/usr/lib/dyld" since our platform could be a remote
2027       // platform that has its own "/usr/lib/dyld" in an SDK or in a local file
2028       // cache.
2029       if (module_spec.GetUUID().IsValid()) {
2030         // We have a UUID, it is OK to check the global module list...
2031         error = ModuleList::GetSharedModule(module_spec, module_sp,
2032                                             &GetExecutableSearchPaths(),
2033                                             &old_module_sp, &did_create_module);
2034       }
2035 
2036       if (!module_sp) {
2037         // The platform is responsible for finding and caching an appropriate
2038         // module in the shared module cache.
2039         if (m_platform_sp) {
2040           error = m_platform_sp->GetSharedModule(
2041               module_spec, m_process_sp.get(), module_sp,
2042               &GetExecutableSearchPaths(), &old_module_sp, &did_create_module);
2043         } else {
2044           error.SetErrorString("no platform is currently set");
2045         }
2046       }
2047     }
2048 
2049     // We found a module that wasn't in our target list.  Let's make sure that
2050     // there wasn't an equivalent module in the list already, and if there was,
2051     // let's remove it.
2052     if (module_sp) {
2053       ObjectFile *objfile = module_sp->GetObjectFile();
2054       if (objfile) {
2055         switch (objfile->GetType()) {
2056         case ObjectFile::eTypeCoreFile: /// A core file that has a checkpoint of
2057                                         /// a program's execution state
2058         case ObjectFile::eTypeExecutable:    /// A normal executable
2059         case ObjectFile::eTypeDynamicLinker: /// The platform's dynamic linker
2060                                              /// executable
2061         case ObjectFile::eTypeObjectFile:    /// An intermediate object file
2062         case ObjectFile::eTypeSharedLibrary: /// A shared library that can be
2063                                              /// used during execution
2064           break;
2065         case ObjectFile::eTypeDebugInfo: /// An object file that contains only
2066                                          /// debug information
2067           if (error_ptr)
2068             error_ptr->SetErrorString("debug info files aren't valid target "
2069                                       "modules, please specify an executable");
2070           return ModuleSP();
2071         case ObjectFile::eTypeStubLibrary: /// A library that can be linked
2072                                            /// against but not used for
2073                                            /// execution
2074           if (error_ptr)
2075             error_ptr->SetErrorString("stub libraries aren't valid target "
2076                                       "modules, please specify an executable");
2077           return ModuleSP();
2078         default:
2079           if (error_ptr)
2080             error_ptr->SetErrorString(
2081                 "unsupported file type, please specify an executable");
2082           return ModuleSP();
2083         }
2084         // GetSharedModule is not guaranteed to find the old shared module, for
2085         // instance in the common case where you pass in the UUID, it is only
2086         // going to find the one module matching the UUID.  In fact, it has no
2087         // good way to know what the "old module" relevant to this target is,
2088         // since there might be many copies of a module with this file spec in
2089         // various running debug sessions, but only one of them will belong to
2090         // this target. So let's remove the UUID from the module list, and look
2091         // in the target's module list. Only do this if there is SOMETHING else
2092         // in the module spec...
2093         if (!old_module_sp) {
2094           if (module_spec.GetUUID().IsValid() &&
2095               !module_spec.GetFileSpec().GetFilename().IsEmpty() &&
2096               !module_spec.GetFileSpec().GetDirectory().IsEmpty()) {
2097             ModuleSpec module_spec_copy(module_spec.GetFileSpec());
2098             module_spec_copy.GetUUID().Clear();
2099 
2100             ModuleList found_modules;
2101             size_t num_found =
2102                 m_images.FindModules(module_spec_copy, found_modules);
2103             if (num_found == 1) {
2104               old_module_sp = found_modules.GetModuleAtIndex(0);
2105             }
2106           }
2107         }
2108 
2109         // Preload symbols outside of any lock, so hopefully we can do this for
2110         // each library in parallel.
2111         if (GetPreloadSymbols())
2112           module_sp->PreloadSymbols();
2113 
2114         if (old_module_sp &&
2115             m_images.GetIndexForModule(old_module_sp.get()) !=
2116                 LLDB_INVALID_INDEX32) {
2117           m_images.ReplaceModule(old_module_sp, module_sp);
2118           Module *old_module_ptr = old_module_sp.get();
2119           old_module_sp.reset();
2120           ModuleList::RemoveSharedModuleIfOrphaned(old_module_ptr);
2121         } else
2122           m_images.Append(module_sp);
2123       } else
2124         module_sp.reset();
2125     }
2126   }
2127   if (error_ptr)
2128     *error_ptr = error;
2129   return module_sp;
2130 }
2131 
2132 TargetSP Target::CalculateTarget() { return shared_from_this(); }
2133 
2134 ProcessSP Target::CalculateProcess() { return m_process_sp; }
2135 
2136 ThreadSP Target::CalculateThread() { return ThreadSP(); }
2137 
2138 StackFrameSP Target::CalculateStackFrame() { return StackFrameSP(); }
2139 
2140 void Target::CalculateExecutionContext(ExecutionContext &exe_ctx) {
2141   exe_ctx.Clear();
2142   exe_ctx.SetTargetPtr(this);
2143 }
2144 
2145 PathMappingList &Target::GetImageSearchPathList() {
2146   return m_image_search_paths;
2147 }
2148 
2149 void Target::ImageSearchPathsChanged(const PathMappingList &path_list,
2150                                      void *baton) {
2151   Target *target = (Target *)baton;
2152   ModuleSP exe_module_sp(target->GetExecutableModule());
2153   if (exe_module_sp)
2154     target->SetExecutableModule(exe_module_sp, eLoadDependentsYes);
2155 }
2156 
2157 TypeSystem *Target::GetScratchTypeSystemForLanguage(Status *error,
2158                                                     lldb::LanguageType language,
2159                                                     bool create_on_demand) {
2160   if (!m_valid)
2161     return nullptr;
2162 
2163   if (error) {
2164     error->Clear();
2165   }
2166 
2167   if (language == eLanguageTypeMipsAssembler // GNU AS and LLVM use it for all
2168                                              // assembly code
2169       || language == eLanguageTypeUnknown) {
2170     std::set<lldb::LanguageType> languages_for_types;
2171     std::set<lldb::LanguageType> languages_for_expressions;
2172 
2173     Language::GetLanguagesSupportingTypeSystems(languages_for_types,
2174                                                 languages_for_expressions);
2175 
2176     if (languages_for_expressions.count(eLanguageTypeC)) {
2177       language = eLanguageTypeC; // LLDB's default.  Override by setting the
2178                                  // target language.
2179     } else {
2180       if (languages_for_expressions.empty()) {
2181         return nullptr;
2182       } else {
2183         language = *languages_for_expressions.begin();
2184       }
2185     }
2186   }
2187 
2188   return m_scratch_type_system_map.GetTypeSystemForLanguage(language, this,
2189                                                             create_on_demand);
2190 }
2191 
2192 PersistentExpressionState *
2193 Target::GetPersistentExpressionStateForLanguage(lldb::LanguageType language) {
2194   TypeSystem *type_system =
2195       GetScratchTypeSystemForLanguage(nullptr, language, true);
2196 
2197   if (type_system) {
2198     return type_system->GetPersistentExpressionState();
2199   } else {
2200     return nullptr;
2201   }
2202 }
2203 
2204 UserExpression *Target::GetUserExpressionForLanguage(
2205     llvm::StringRef expr, llvm::StringRef prefix, lldb::LanguageType language,
2206     Expression::ResultType desired_type,
2207     const EvaluateExpressionOptions &options,
2208     ValueObject *ctx_obj, Status &error) {
2209   Status type_system_error;
2210 
2211   TypeSystem *type_system =
2212       GetScratchTypeSystemForLanguage(&type_system_error, language);
2213   UserExpression *user_expr = nullptr;
2214 
2215   if (!type_system) {
2216     error.SetErrorStringWithFormat(
2217         "Could not find type system for language %s: %s",
2218         Language::GetNameForLanguageType(language),
2219         type_system_error.AsCString());
2220     return nullptr;
2221   }
2222 
2223   user_expr = type_system->GetUserExpression(expr, prefix, language,
2224                                              desired_type, options, ctx_obj);
2225   if (!user_expr)
2226     error.SetErrorStringWithFormat(
2227         "Could not create an expression for language %s",
2228         Language::GetNameForLanguageType(language));
2229 
2230   return user_expr;
2231 }
2232 
2233 FunctionCaller *Target::GetFunctionCallerForLanguage(
2234     lldb::LanguageType language, const CompilerType &return_type,
2235     const Address &function_address, const ValueList &arg_value_list,
2236     const char *name, Status &error) {
2237   Status type_system_error;
2238   TypeSystem *type_system =
2239       GetScratchTypeSystemForLanguage(&type_system_error, language);
2240   FunctionCaller *persistent_fn = nullptr;
2241 
2242   if (!type_system) {
2243     error.SetErrorStringWithFormat(
2244         "Could not find type system for language %s: %s",
2245         Language::GetNameForLanguageType(language),
2246         type_system_error.AsCString());
2247     return persistent_fn;
2248   }
2249 
2250   persistent_fn = type_system->GetFunctionCaller(return_type, function_address,
2251                                                  arg_value_list, name);
2252   if (!persistent_fn)
2253     error.SetErrorStringWithFormat(
2254         "Could not create an expression for language %s",
2255         Language::GetNameForLanguageType(language));
2256 
2257   return persistent_fn;
2258 }
2259 
2260 UtilityFunction *
2261 Target::GetUtilityFunctionForLanguage(const char *text,
2262                                       lldb::LanguageType language,
2263                                       const char *name, Status &error) {
2264   Status type_system_error;
2265   TypeSystem *type_system =
2266       GetScratchTypeSystemForLanguage(&type_system_error, language);
2267   UtilityFunction *utility_fn = nullptr;
2268 
2269   if (!type_system) {
2270     error.SetErrorStringWithFormat(
2271         "Could not find type system for language %s: %s",
2272         Language::GetNameForLanguageType(language),
2273         type_system_error.AsCString());
2274     return utility_fn;
2275   }
2276 
2277   utility_fn = type_system->GetUtilityFunction(text, name);
2278   if (!utility_fn)
2279     error.SetErrorStringWithFormat(
2280         "Could not create an expression for language %s",
2281         Language::GetNameForLanguageType(language));
2282 
2283   return utility_fn;
2284 }
2285 
2286 ClangASTContext *Target::GetScratchClangASTContext(bool create_on_demand) {
2287   if (m_valid) {
2288     if (TypeSystem *type_system = GetScratchTypeSystemForLanguage(
2289             nullptr, eLanguageTypeC, create_on_demand))
2290       return llvm::dyn_cast<ClangASTContext>(type_system);
2291   }
2292   return nullptr;
2293 }
2294 
2295 ClangASTImporterSP Target::GetClangASTImporter() {
2296   if (m_valid) {
2297     if (!m_ast_importer_sp) {
2298       m_ast_importer_sp = std::make_shared<ClangASTImporter>();
2299     }
2300     return m_ast_importer_sp;
2301   }
2302   return ClangASTImporterSP();
2303 }
2304 
2305 void Target::SettingsInitialize() { Process::SettingsInitialize(); }
2306 
2307 void Target::SettingsTerminate() { Process::SettingsTerminate(); }
2308 
2309 FileSpecList Target::GetDefaultExecutableSearchPaths() {
2310   TargetPropertiesSP properties_sp(Target::GetGlobalProperties());
2311   if (properties_sp)
2312     return properties_sp->GetExecutableSearchPaths();
2313   return FileSpecList();
2314 }
2315 
2316 FileSpecList Target::GetDefaultDebugFileSearchPaths() {
2317   TargetPropertiesSP properties_sp(Target::GetGlobalProperties());
2318   if (properties_sp)
2319     return properties_sp->GetDebugFileSearchPaths();
2320   return FileSpecList();
2321 }
2322 
2323 FileSpecList Target::GetDefaultClangModuleSearchPaths() {
2324   TargetPropertiesSP properties_sp(Target::GetGlobalProperties());
2325   if (properties_sp)
2326     return properties_sp->GetClangModuleSearchPaths();
2327   return FileSpecList();
2328 }
2329 
2330 ArchSpec Target::GetDefaultArchitecture() {
2331   TargetPropertiesSP properties_sp(Target::GetGlobalProperties());
2332   if (properties_sp)
2333     return properties_sp->GetDefaultArchitecture();
2334   return ArchSpec();
2335 }
2336 
2337 void Target::SetDefaultArchitecture(const ArchSpec &arch) {
2338   TargetPropertiesSP properties_sp(Target::GetGlobalProperties());
2339   if (properties_sp) {
2340     LogIfAnyCategoriesSet(
2341         LIBLLDB_LOG_TARGET, "Target::SetDefaultArchitecture setting target's "
2342                             "default architecture to  %s (%s)",
2343         arch.GetArchitectureName(), arch.GetTriple().getTriple().c_str());
2344     return properties_sp->SetDefaultArchitecture(arch);
2345   }
2346 }
2347 
2348 Target *Target::GetTargetFromContexts(const ExecutionContext *exe_ctx_ptr,
2349                                       const SymbolContext *sc_ptr) {
2350   // The target can either exist in the "process" of ExecutionContext, or in
2351   // the "target_sp" member of SymbolContext. This accessor helper function
2352   // will get the target from one of these locations.
2353 
2354   Target *target = nullptr;
2355   if (sc_ptr != nullptr)
2356     target = sc_ptr->target_sp.get();
2357   if (target == nullptr && exe_ctx_ptr)
2358     target = exe_ctx_ptr->GetTargetPtr();
2359   return target;
2360 }
2361 
2362 ExpressionResults Target::EvaluateExpression(
2363     llvm::StringRef expr, ExecutionContextScope *exe_scope,
2364     lldb::ValueObjectSP &result_valobj_sp,
2365     const EvaluateExpressionOptions &options, std::string *fixed_expression,
2366     ValueObject *ctx_obj) {
2367   result_valobj_sp.reset();
2368 
2369   ExpressionResults execution_results = eExpressionSetupError;
2370 
2371   if (expr.empty())
2372     return execution_results;
2373 
2374   // We shouldn't run stop hooks in expressions. Be sure to reset this if you
2375   // return anywhere within this function.
2376   bool old_suppress_value = m_suppress_stop_hooks;
2377   m_suppress_stop_hooks = true;
2378 
2379   ExecutionContext exe_ctx;
2380 
2381   if (exe_scope) {
2382     exe_scope->CalculateExecutionContext(exe_ctx);
2383   } else if (m_process_sp) {
2384     m_process_sp->CalculateExecutionContext(exe_ctx);
2385   } else {
2386     CalculateExecutionContext(exe_ctx);
2387   }
2388 
2389   // Make sure we aren't just trying to see the value of a persistent variable
2390   // (something like "$0")
2391   lldb::ExpressionVariableSP persistent_var_sp;
2392   // Only check for persistent variables the expression starts with a '$'
2393   if (expr[0] == '$')
2394     persistent_var_sp = GetScratchTypeSystemForLanguage(nullptr, eLanguageTypeC)
2395                             ->GetPersistentExpressionState()
2396                             ->GetVariable(expr);
2397 
2398   if (persistent_var_sp) {
2399     result_valobj_sp = persistent_var_sp->GetValueObject();
2400     execution_results = eExpressionCompleted;
2401   } else {
2402     llvm::StringRef prefix = GetExpressionPrefixContents();
2403     Status error;
2404     execution_results = UserExpression::Evaluate(exe_ctx, options, expr, prefix,
2405                                                  result_valobj_sp, error,
2406                                                  0, // Line Number
2407                                                  fixed_expression,
2408                                                  nullptr, // Module
2409                                                  ctx_obj);
2410   }
2411 
2412   m_suppress_stop_hooks = old_suppress_value;
2413 
2414   return execution_results;
2415 }
2416 
2417 lldb::ExpressionVariableSP
2418 Target::GetPersistentVariable(const ConstString &name) {
2419   lldb::ExpressionVariableSP variable_sp;
2420   m_scratch_type_system_map.ForEach(
2421       [name, &variable_sp](TypeSystem *type_system) -> bool {
2422         if (PersistentExpressionState *persistent_state =
2423                 type_system->GetPersistentExpressionState()) {
2424           variable_sp = persistent_state->GetVariable(name);
2425 
2426           if (variable_sp)
2427             return false; // Stop iterating the ForEach
2428         }
2429         return true; // Keep iterating the ForEach
2430       });
2431   return variable_sp;
2432 }
2433 
2434 lldb::addr_t Target::GetPersistentSymbol(const ConstString &name) {
2435   lldb::addr_t address = LLDB_INVALID_ADDRESS;
2436 
2437   m_scratch_type_system_map.ForEach(
2438       [name, &address](TypeSystem *type_system) -> bool {
2439         if (PersistentExpressionState *persistent_state =
2440                 type_system->GetPersistentExpressionState()) {
2441           address = persistent_state->LookupSymbol(name);
2442           if (address != LLDB_INVALID_ADDRESS)
2443             return false; // Stop iterating the ForEach
2444         }
2445         return true; // Keep iterating the ForEach
2446       });
2447   return address;
2448 }
2449 
2450 lldb::addr_t Target::GetCallableLoadAddress(lldb::addr_t load_addr,
2451                                             AddressClass addr_class) const {
2452   auto arch_plugin = GetArchitecturePlugin();
2453   return arch_plugin ?
2454       arch_plugin->GetCallableLoadAddress(load_addr, addr_class) : load_addr;
2455 }
2456 
2457 lldb::addr_t Target::GetOpcodeLoadAddress(lldb::addr_t load_addr,
2458                                           AddressClass addr_class) const {
2459   auto arch_plugin = GetArchitecturePlugin();
2460   return arch_plugin ?
2461       arch_plugin->GetOpcodeLoadAddress(load_addr, addr_class) : load_addr;
2462 }
2463 
2464 lldb::addr_t Target::GetBreakableLoadAddress(lldb::addr_t addr) {
2465   auto arch_plugin = GetArchitecturePlugin();
2466   return arch_plugin ?
2467       arch_plugin->GetBreakableLoadAddress(addr, *this) : addr;
2468 }
2469 
2470 SourceManager &Target::GetSourceManager() {
2471   if (!m_source_manager_up)
2472     m_source_manager_up.reset(new SourceManager(shared_from_this()));
2473   return *m_source_manager_up;
2474 }
2475 
2476 ClangModulesDeclVendor *Target::GetClangModulesDeclVendor() {
2477   static std::mutex s_clang_modules_decl_vendor_mutex; // If this is contended
2478                                                        // we can make it
2479                                                        // per-target
2480 
2481   {
2482     std::lock_guard<std::mutex> guard(s_clang_modules_decl_vendor_mutex);
2483 
2484     if (!m_clang_modules_decl_vendor_up) {
2485       m_clang_modules_decl_vendor_up.reset(
2486           ClangModulesDeclVendor::Create(*this));
2487     }
2488   }
2489 
2490   return m_clang_modules_decl_vendor_up.get();
2491 }
2492 
2493 Target::StopHookSP Target::CreateStopHook() {
2494   lldb::user_id_t new_uid = ++m_stop_hook_next_id;
2495   Target::StopHookSP stop_hook_sp(new StopHook(shared_from_this(), new_uid));
2496   m_stop_hooks[new_uid] = stop_hook_sp;
2497   return stop_hook_sp;
2498 }
2499 
2500 bool Target::RemoveStopHookByID(lldb::user_id_t user_id) {
2501   size_t num_removed = m_stop_hooks.erase(user_id);
2502   return (num_removed != 0);
2503 }
2504 
2505 void Target::RemoveAllStopHooks() { m_stop_hooks.clear(); }
2506 
2507 Target::StopHookSP Target::GetStopHookByID(lldb::user_id_t user_id) {
2508   StopHookSP found_hook;
2509 
2510   StopHookCollection::iterator specified_hook_iter;
2511   specified_hook_iter = m_stop_hooks.find(user_id);
2512   if (specified_hook_iter != m_stop_hooks.end())
2513     found_hook = (*specified_hook_iter).second;
2514   return found_hook;
2515 }
2516 
2517 bool Target::SetStopHookActiveStateByID(lldb::user_id_t user_id,
2518                                         bool active_state) {
2519   StopHookCollection::iterator specified_hook_iter;
2520   specified_hook_iter = m_stop_hooks.find(user_id);
2521   if (specified_hook_iter == m_stop_hooks.end())
2522     return false;
2523 
2524   (*specified_hook_iter).second->SetIsActive(active_state);
2525   return true;
2526 }
2527 
2528 void Target::SetAllStopHooksActiveState(bool active_state) {
2529   StopHookCollection::iterator pos, end = m_stop_hooks.end();
2530   for (pos = m_stop_hooks.begin(); pos != end; pos++) {
2531     (*pos).second->SetIsActive(active_state);
2532   }
2533 }
2534 
2535 void Target::RunStopHooks() {
2536   if (m_suppress_stop_hooks)
2537     return;
2538 
2539   if (!m_process_sp)
2540     return;
2541 
2542   // Somebody might have restarted the process:
2543   if (m_process_sp->GetState() != eStateStopped)
2544     return;
2545 
2546   // <rdar://problem/12027563> make sure we check that we are not stopped
2547   // because of us running a user expression since in that case we do not want
2548   // to run the stop-hooks
2549   if (m_process_sp->GetModIDRef().IsLastResumeForUserExpression())
2550     return;
2551 
2552   if (m_stop_hooks.empty())
2553     return;
2554 
2555   StopHookCollection::iterator pos, end = m_stop_hooks.end();
2556 
2557   // If there aren't any active stop hooks, don't bother either:
2558   bool any_active_hooks = false;
2559   for (pos = m_stop_hooks.begin(); pos != end; pos++) {
2560     if ((*pos).second->IsActive()) {
2561       any_active_hooks = true;
2562       break;
2563     }
2564   }
2565   if (!any_active_hooks)
2566     return;
2567 
2568   CommandReturnObject result;
2569 
2570   std::vector<ExecutionContext> exc_ctx_with_reasons;
2571   std::vector<SymbolContext> sym_ctx_with_reasons;
2572 
2573   ThreadList &cur_threadlist = m_process_sp->GetThreadList();
2574   size_t num_threads = cur_threadlist.GetSize();
2575   for (size_t i = 0; i < num_threads; i++) {
2576     lldb::ThreadSP cur_thread_sp = cur_threadlist.GetThreadAtIndex(i);
2577     if (cur_thread_sp->ThreadStoppedForAReason()) {
2578       lldb::StackFrameSP cur_frame_sp = cur_thread_sp->GetStackFrameAtIndex(0);
2579       exc_ctx_with_reasons.push_back(ExecutionContext(
2580           m_process_sp.get(), cur_thread_sp.get(), cur_frame_sp.get()));
2581       sym_ctx_with_reasons.push_back(
2582           cur_frame_sp->GetSymbolContext(eSymbolContextEverything));
2583     }
2584   }
2585 
2586   // If no threads stopped for a reason, don't run the stop-hooks.
2587   size_t num_exe_ctx = exc_ctx_with_reasons.size();
2588   if (num_exe_ctx == 0)
2589     return;
2590 
2591   result.SetImmediateOutputStream(m_debugger.GetAsyncOutputStream());
2592   result.SetImmediateErrorStream(m_debugger.GetAsyncErrorStream());
2593 
2594   bool keep_going = true;
2595   bool hooks_ran = false;
2596   bool print_hook_header = (m_stop_hooks.size() != 1);
2597   bool print_thread_header = (num_exe_ctx != 1);
2598 
2599   for (pos = m_stop_hooks.begin(); keep_going && pos != end; pos++) {
2600     // result.Clear();
2601     StopHookSP cur_hook_sp = (*pos).second;
2602     if (!cur_hook_sp->IsActive())
2603       continue;
2604 
2605     bool any_thread_matched = false;
2606     for (size_t i = 0; keep_going && i < num_exe_ctx; i++) {
2607       if ((cur_hook_sp->GetSpecifier() == nullptr ||
2608            cur_hook_sp->GetSpecifier()->SymbolContextMatches(
2609                sym_ctx_with_reasons[i])) &&
2610           (cur_hook_sp->GetThreadSpecifier() == nullptr ||
2611            cur_hook_sp->GetThreadSpecifier()->ThreadPassesBasicTests(
2612                exc_ctx_with_reasons[i].GetThreadRef()))) {
2613         if (!hooks_ran) {
2614           hooks_ran = true;
2615         }
2616         if (print_hook_header && !any_thread_matched) {
2617           const char *cmd =
2618               (cur_hook_sp->GetCommands().GetSize() == 1
2619                    ? cur_hook_sp->GetCommands().GetStringAtIndex(0)
2620                    : nullptr);
2621           if (cmd)
2622             result.AppendMessageWithFormat("\n- Hook %" PRIu64 " (%s)\n",
2623                                            cur_hook_sp->GetID(), cmd);
2624           else
2625             result.AppendMessageWithFormat("\n- Hook %" PRIu64 "\n",
2626                                            cur_hook_sp->GetID());
2627           any_thread_matched = true;
2628         }
2629 
2630         if (print_thread_header)
2631           result.AppendMessageWithFormat(
2632               "-- Thread %d\n",
2633               exc_ctx_with_reasons[i].GetThreadPtr()->GetIndexID());
2634 
2635         CommandInterpreterRunOptions options;
2636         options.SetStopOnContinue(true);
2637         options.SetStopOnError(true);
2638         options.SetEchoCommands(false);
2639         options.SetPrintResults(true);
2640         options.SetAddToHistory(false);
2641 
2642         GetDebugger().GetCommandInterpreter().HandleCommands(
2643             cur_hook_sp->GetCommands(), &exc_ctx_with_reasons[i], options,
2644             result);
2645 
2646         // If the command started the target going again, we should bag out of
2647         // running the stop hooks.
2648         if ((result.GetStatus() == eReturnStatusSuccessContinuingNoResult) ||
2649             (result.GetStatus() == eReturnStatusSuccessContinuingResult)) {
2650           // But only complain if there were more stop hooks to do:
2651           StopHookCollection::iterator tmp = pos;
2652           if (++tmp != end)
2653             result.AppendMessageWithFormat("\nAborting stop hooks, hook %" PRIu64
2654                                            " set the program running.\n",
2655                                            cur_hook_sp->GetID());
2656           keep_going = false;
2657         }
2658       }
2659     }
2660   }
2661 
2662   result.GetImmediateOutputStream()->Flush();
2663   result.GetImmediateErrorStream()->Flush();
2664 }
2665 
2666 const TargetPropertiesSP &Target::GetGlobalProperties() {
2667   // NOTE: intentional leak so we don't crash if global destructor chain gets
2668   // called as other threads still use the result of this function
2669   static TargetPropertiesSP *g_settings_sp_ptr =
2670       new TargetPropertiesSP(new TargetProperties(nullptr));
2671   return *g_settings_sp_ptr;
2672 }
2673 
2674 Status Target::Install(ProcessLaunchInfo *launch_info) {
2675   Status error;
2676   PlatformSP platform_sp(GetPlatform());
2677   if (platform_sp) {
2678     if (platform_sp->IsRemote()) {
2679       if (platform_sp->IsConnected()) {
2680         // Install all files that have an install path, and always install the
2681         // main executable when connected to a remote platform
2682         const ModuleList &modules = GetImages();
2683         const size_t num_images = modules.GetSize();
2684         for (size_t idx = 0; idx < num_images; ++idx) {
2685           ModuleSP module_sp(modules.GetModuleAtIndex(idx));
2686           if (module_sp) {
2687             const bool is_main_executable = module_sp == GetExecutableModule();
2688             FileSpec local_file(module_sp->GetFileSpec());
2689             if (local_file) {
2690               FileSpec remote_file(module_sp->GetRemoteInstallFileSpec());
2691               if (!remote_file) {
2692                 if (is_main_executable) // TODO: add setting for always
2693                                         // installing main executable???
2694                 {
2695                   // Always install the main executable
2696                   remote_file = platform_sp->GetRemoteWorkingDirectory();
2697                   remote_file.AppendPathComponent(
2698                       module_sp->GetFileSpec().GetFilename().GetCString());
2699                 }
2700               }
2701               if (remote_file) {
2702                 error = platform_sp->Install(local_file, remote_file);
2703                 if (error.Success()) {
2704                   module_sp->SetPlatformFileSpec(remote_file);
2705                   if (is_main_executable) {
2706                     platform_sp->SetFilePermissions(remote_file, 0700);
2707                     if (launch_info)
2708                       launch_info->SetExecutableFile(remote_file, false);
2709                   }
2710                 } else
2711                   break;
2712               }
2713             }
2714           }
2715         }
2716       }
2717     }
2718   }
2719   return error;
2720 }
2721 
2722 bool Target::ResolveLoadAddress(addr_t load_addr, Address &so_addr,
2723                                 uint32_t stop_id) {
2724   return m_section_load_history.ResolveLoadAddress(stop_id, load_addr, so_addr);
2725 }
2726 
2727 bool Target::ResolveFileAddress(lldb::addr_t file_addr,
2728                                 Address &resolved_addr) {
2729   return m_images.ResolveFileAddress(file_addr, resolved_addr);
2730 }
2731 
2732 bool Target::SetSectionLoadAddress(const SectionSP &section_sp,
2733                                    addr_t new_section_load_addr,
2734                                    bool warn_multiple) {
2735   const addr_t old_section_load_addr =
2736       m_section_load_history.GetSectionLoadAddress(
2737           SectionLoadHistory::eStopIDNow, section_sp);
2738   if (old_section_load_addr != new_section_load_addr) {
2739     uint32_t stop_id = 0;
2740     ProcessSP process_sp(GetProcessSP());
2741     if (process_sp)
2742       stop_id = process_sp->GetStopID();
2743     else
2744       stop_id = m_section_load_history.GetLastStopID();
2745     if (m_section_load_history.SetSectionLoadAddress(
2746             stop_id, section_sp, new_section_load_addr, warn_multiple))
2747       return true; // Return true if the section load address was changed...
2748   }
2749   return false; // Return false to indicate nothing changed
2750 }
2751 
2752 size_t Target::UnloadModuleSections(const ModuleList &module_list) {
2753   size_t section_unload_count = 0;
2754   size_t num_modules = module_list.GetSize();
2755   for (size_t i = 0; i < num_modules; ++i) {
2756     section_unload_count +=
2757         UnloadModuleSections(module_list.GetModuleAtIndex(i));
2758   }
2759   return section_unload_count;
2760 }
2761 
2762 size_t Target::UnloadModuleSections(const lldb::ModuleSP &module_sp) {
2763   uint32_t stop_id = 0;
2764   ProcessSP process_sp(GetProcessSP());
2765   if (process_sp)
2766     stop_id = process_sp->GetStopID();
2767   else
2768     stop_id = m_section_load_history.GetLastStopID();
2769   SectionList *sections = module_sp->GetSectionList();
2770   size_t section_unload_count = 0;
2771   if (sections) {
2772     const uint32_t num_sections = sections->GetNumSections(0);
2773     for (uint32_t i = 0; i < num_sections; ++i) {
2774       section_unload_count += m_section_load_history.SetSectionUnloaded(
2775           stop_id, sections->GetSectionAtIndex(i));
2776     }
2777   }
2778   return section_unload_count;
2779 }
2780 
2781 bool Target::SetSectionUnloaded(const lldb::SectionSP &section_sp) {
2782   uint32_t stop_id = 0;
2783   ProcessSP process_sp(GetProcessSP());
2784   if (process_sp)
2785     stop_id = process_sp->GetStopID();
2786   else
2787     stop_id = m_section_load_history.GetLastStopID();
2788   return m_section_load_history.SetSectionUnloaded(stop_id, section_sp);
2789 }
2790 
2791 bool Target::SetSectionUnloaded(const lldb::SectionSP &section_sp,
2792                                 addr_t load_addr) {
2793   uint32_t stop_id = 0;
2794   ProcessSP process_sp(GetProcessSP());
2795   if (process_sp)
2796     stop_id = process_sp->GetStopID();
2797   else
2798     stop_id = m_section_load_history.GetLastStopID();
2799   return m_section_load_history.SetSectionUnloaded(stop_id, section_sp,
2800                                                    load_addr);
2801 }
2802 
2803 void Target::ClearAllLoadedSections() { m_section_load_history.Clear(); }
2804 
2805 Status Target::Launch(ProcessLaunchInfo &launch_info, Stream *stream) {
2806   Status error;
2807   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET));
2808 
2809   if (log)
2810     log->Printf("Target::%s() called for %s", __FUNCTION__,
2811                 launch_info.GetExecutableFile().GetPath().c_str());
2812 
2813   StateType state = eStateInvalid;
2814 
2815   // Scope to temporarily get the process state in case someone has manually
2816   // remotely connected already to a process and we can skip the platform
2817   // launching.
2818   {
2819     ProcessSP process_sp(GetProcessSP());
2820 
2821     if (process_sp) {
2822       state = process_sp->GetState();
2823       if (log)
2824         log->Printf(
2825             "Target::%s the process exists, and its current state is %s",
2826             __FUNCTION__, StateAsCString(state));
2827     } else {
2828       if (log)
2829         log->Printf("Target::%s the process instance doesn't currently exist.",
2830                     __FUNCTION__);
2831     }
2832   }
2833 
2834   launch_info.GetFlags().Set(eLaunchFlagDebug);
2835 
2836   // Get the value of synchronous execution here.  If you wait till after you
2837   // have started to run, then you could have hit a breakpoint, whose command
2838   // might switch the value, and then you'll pick up that incorrect value.
2839   Debugger &debugger = GetDebugger();
2840   const bool synchronous_execution =
2841       debugger.GetCommandInterpreter().GetSynchronous();
2842 
2843   PlatformSP platform_sp(GetPlatform());
2844 
2845   FinalizeFileActions(launch_info);
2846 
2847   if (state == eStateConnected) {
2848     if (launch_info.GetFlags().Test(eLaunchFlagLaunchInTTY)) {
2849       error.SetErrorString(
2850           "can't launch in tty when launching through a remote connection");
2851       return error;
2852     }
2853   }
2854 
2855   if (!launch_info.GetArchitecture().IsValid())
2856     launch_info.GetArchitecture() = GetArchitecture();
2857 
2858   // If we're not already connected to the process, and if we have a platform
2859   // that can launch a process for debugging, go ahead and do that here.
2860   if (state != eStateConnected && platform_sp &&
2861       platform_sp->CanDebugProcess()) {
2862     if (log)
2863       log->Printf("Target::%s asking the platform to debug the process",
2864                   __FUNCTION__);
2865 
2866     // If there was a previous process, delete it before we make the new one.
2867     // One subtle point, we delete the process before we release the reference
2868     // to m_process_sp.  That way even if we are the last owner, the process
2869     // will get Finalized before it gets destroyed.
2870     DeleteCurrentProcess();
2871 
2872     m_process_sp =
2873         GetPlatform()->DebugProcess(launch_info, debugger, this, error);
2874 
2875   } else {
2876     if (log)
2877       log->Printf("Target::%s the platform doesn't know how to debug a "
2878                   "process, getting a process plugin to do this for us.",
2879                   __FUNCTION__);
2880 
2881     if (state == eStateConnected) {
2882       assert(m_process_sp);
2883     } else {
2884       // Use a Process plugin to construct the process.
2885       const char *plugin_name = launch_info.GetProcessPluginName();
2886       CreateProcess(launch_info.GetListener(), plugin_name, nullptr);
2887     }
2888 
2889     // Since we didn't have a platform launch the process, launch it here.
2890     if (m_process_sp)
2891       error = m_process_sp->Launch(launch_info);
2892   }
2893 
2894   if (!m_process_sp) {
2895     if (error.Success())
2896       error.SetErrorString("failed to launch or debug process");
2897     return error;
2898   }
2899 
2900   if (error.Success()) {
2901     if (synchronous_execution ||
2902         !launch_info.GetFlags().Test(eLaunchFlagStopAtEntry)) {
2903       ListenerSP hijack_listener_sp(launch_info.GetHijackListener());
2904       if (!hijack_listener_sp) {
2905         hijack_listener_sp =
2906             Listener::MakeListener("lldb.Target.Launch.hijack");
2907         launch_info.SetHijackListener(hijack_listener_sp);
2908         m_process_sp->HijackProcessEvents(hijack_listener_sp);
2909       }
2910 
2911       StateType state = m_process_sp->WaitForProcessToStop(
2912           llvm::None, nullptr, false, hijack_listener_sp, nullptr);
2913 
2914       if (state == eStateStopped) {
2915         if (!launch_info.GetFlags().Test(eLaunchFlagStopAtEntry)) {
2916           if (synchronous_execution) {
2917             error = m_process_sp->PrivateResume();
2918             if (error.Success()) {
2919               state = m_process_sp->WaitForProcessToStop(
2920                   llvm::None, nullptr, true, hijack_listener_sp, stream);
2921               const bool must_be_alive =
2922                   false; // eStateExited is ok, so this must be false
2923               if (!StateIsStoppedState(state, must_be_alive)) {
2924                 error.SetErrorStringWithFormat("process isn't stopped: %s",
2925                                                StateAsCString(state));
2926               }
2927             }
2928           } else {
2929             m_process_sp->RestoreProcessEvents();
2930             error = m_process_sp->PrivateResume();
2931           }
2932           if (!error.Success()) {
2933             Status error2;
2934             error2.SetErrorStringWithFormat(
2935                 "process resume at entry point failed: %s", error.AsCString());
2936             error = error2;
2937           }
2938         }
2939       } else if (state == eStateExited) {
2940         bool with_shell = !!launch_info.GetShell();
2941         const int exit_status = m_process_sp->GetExitStatus();
2942         const char *exit_desc = m_process_sp->GetExitDescription();
2943 #define LAUNCH_SHELL_MESSAGE                                                   \
2944   "\n'r' and 'run' are aliases that default to launching through a "           \
2945   "shell.\nTry launching without going through a shell by using 'process "     \
2946   "launch'."
2947         if (exit_desc && exit_desc[0]) {
2948           if (with_shell)
2949             error.SetErrorStringWithFormat(
2950                 "process exited with status %i (%s)" LAUNCH_SHELL_MESSAGE,
2951                 exit_status, exit_desc);
2952           else
2953             error.SetErrorStringWithFormat("process exited with status %i (%s)",
2954                                            exit_status, exit_desc);
2955         } else {
2956           if (with_shell)
2957             error.SetErrorStringWithFormat(
2958                 "process exited with status %i" LAUNCH_SHELL_MESSAGE,
2959                 exit_status);
2960           else
2961             error.SetErrorStringWithFormat("process exited with status %i",
2962                                            exit_status);
2963         }
2964       } else {
2965         error.SetErrorStringWithFormat(
2966             "initial process state wasn't stopped: %s", StateAsCString(state));
2967       }
2968     }
2969     m_process_sp->RestoreProcessEvents();
2970   } else {
2971     Status error2;
2972     error2.SetErrorStringWithFormat("process launch failed: %s",
2973                                     error.AsCString());
2974     error = error2;
2975   }
2976   return error;
2977 }
2978 
2979 Status Target::Attach(ProcessAttachInfo &attach_info, Stream *stream) {
2980   auto state = eStateInvalid;
2981   auto process_sp = GetProcessSP();
2982   if (process_sp) {
2983     state = process_sp->GetState();
2984     if (process_sp->IsAlive() && state != eStateConnected) {
2985       if (state == eStateAttaching)
2986         return Status("process attach is in progress");
2987       return Status("a process is already being debugged");
2988     }
2989   }
2990 
2991   const ModuleSP old_exec_module_sp = GetExecutableModule();
2992 
2993   // If no process info was specified, then use the target executable name as
2994   // the process to attach to by default
2995   if (!attach_info.ProcessInfoSpecified()) {
2996     if (old_exec_module_sp)
2997       attach_info.GetExecutableFile().GetFilename() =
2998           old_exec_module_sp->GetPlatformFileSpec().GetFilename();
2999 
3000     if (!attach_info.ProcessInfoSpecified()) {
3001       return Status("no process specified, create a target with a file, or "
3002                     "specify the --pid or --name");
3003     }
3004   }
3005 
3006   const auto platform_sp =
3007       GetDebugger().GetPlatformList().GetSelectedPlatform();
3008   ListenerSP hijack_listener_sp;
3009   const bool async = attach_info.GetAsync();
3010   if (!async) {
3011     hijack_listener_sp =
3012         Listener::MakeListener("lldb.Target.Attach.attach.hijack");
3013     attach_info.SetHijackListener(hijack_listener_sp);
3014   }
3015 
3016   Status error;
3017   if (state != eStateConnected && platform_sp != nullptr &&
3018       platform_sp->CanDebugProcess()) {
3019     SetPlatform(platform_sp);
3020     process_sp = platform_sp->Attach(attach_info, GetDebugger(), this, error);
3021   } else {
3022     if (state != eStateConnected) {
3023       const char *plugin_name = attach_info.GetProcessPluginName();
3024       process_sp =
3025           CreateProcess(attach_info.GetListenerForProcess(GetDebugger()),
3026                         plugin_name, nullptr);
3027       if (process_sp == nullptr) {
3028         error.SetErrorStringWithFormat(
3029             "failed to create process using plugin %s",
3030             (plugin_name) ? plugin_name : "null");
3031         return error;
3032       }
3033     }
3034     if (hijack_listener_sp)
3035       process_sp->HijackProcessEvents(hijack_listener_sp);
3036     error = process_sp->Attach(attach_info);
3037   }
3038 
3039   if (error.Success() && process_sp) {
3040     if (async) {
3041       process_sp->RestoreProcessEvents();
3042     } else {
3043       state = process_sp->WaitForProcessToStop(
3044           llvm::None, nullptr, false, attach_info.GetHijackListener(), stream);
3045       process_sp->RestoreProcessEvents();
3046 
3047       if (state != eStateStopped) {
3048         const char *exit_desc = process_sp->GetExitDescription();
3049         if (exit_desc)
3050           error.SetErrorStringWithFormat("%s", exit_desc);
3051         else
3052           error.SetErrorString(
3053               "process did not stop (no such process or permission problem?)");
3054         process_sp->Destroy(false);
3055       }
3056     }
3057   }
3058   return error;
3059 }
3060 
3061 void Target::FinalizeFileActions(ProcessLaunchInfo &info) {
3062   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
3063 
3064   // Finalize the file actions, and if none were given, default to opening up a
3065   // pseudo terminal
3066   PlatformSP platform_sp = GetPlatform();
3067   const bool default_to_use_pty =
3068       m_platform_sp ? m_platform_sp->IsHost() : false;
3069   LLDB_LOG(
3070       log,
3071       "have platform={0}, platform_sp->IsHost()={1}, default_to_use_pty={2}",
3072       bool(platform_sp),
3073       platform_sp ? (platform_sp->IsHost() ? "true" : "false") : "n/a",
3074       default_to_use_pty);
3075 
3076   // If nothing for stdin or stdout or stderr was specified, then check the
3077   // process for any default settings that were set with "settings set"
3078   if (info.GetFileActionForFD(STDIN_FILENO) == nullptr ||
3079       info.GetFileActionForFD(STDOUT_FILENO) == nullptr ||
3080       info.GetFileActionForFD(STDERR_FILENO) == nullptr) {
3081     LLDB_LOG(log, "at least one of stdin/stdout/stderr was not set, evaluating "
3082                   "default handling");
3083 
3084     if (info.GetFlags().Test(eLaunchFlagLaunchInTTY)) {
3085       // Do nothing, if we are launching in a remote terminal no file actions
3086       // should be done at all.
3087       return;
3088     }
3089 
3090     if (info.GetFlags().Test(eLaunchFlagDisableSTDIO)) {
3091       LLDB_LOG(log, "eLaunchFlagDisableSTDIO set, adding suppression action "
3092                     "for stdin, stdout and stderr");
3093       info.AppendSuppressFileAction(STDIN_FILENO, true, false);
3094       info.AppendSuppressFileAction(STDOUT_FILENO, false, true);
3095       info.AppendSuppressFileAction(STDERR_FILENO, false, true);
3096     } else {
3097       // Check for any values that might have gotten set with any of: (lldb)
3098       // settings set target.input-path (lldb) settings set target.output-path
3099       // (lldb) settings set target.error-path
3100       FileSpec in_file_spec;
3101       FileSpec out_file_spec;
3102       FileSpec err_file_spec;
3103       // Only override with the target settings if we don't already have an
3104       // action for in, out or error
3105       if (info.GetFileActionForFD(STDIN_FILENO) == nullptr)
3106         in_file_spec = GetStandardInputPath();
3107       if (info.GetFileActionForFD(STDOUT_FILENO) == nullptr)
3108         out_file_spec = GetStandardOutputPath();
3109       if (info.GetFileActionForFD(STDERR_FILENO) == nullptr)
3110         err_file_spec = GetStandardErrorPath();
3111 
3112       LLDB_LOG(log, "target stdin='{0}', target stdout='{1}', stderr='{1}'",
3113                in_file_spec, out_file_spec, err_file_spec);
3114 
3115       if (in_file_spec) {
3116         info.AppendOpenFileAction(STDIN_FILENO, in_file_spec, true, false);
3117         LLDB_LOG(log, "appended stdin open file action for {0}", in_file_spec);
3118       }
3119 
3120       if (out_file_spec) {
3121         info.AppendOpenFileAction(STDOUT_FILENO, out_file_spec, false, true);
3122         LLDB_LOG(log, "appended stdout open file action for {0}",
3123                  out_file_spec);
3124       }
3125 
3126       if (err_file_spec) {
3127         info.AppendOpenFileAction(STDERR_FILENO, err_file_spec, false, true);
3128         LLDB_LOG(log, "appended stderr open file action for {0}",
3129                  err_file_spec);
3130       }
3131 
3132       if (default_to_use_pty &&
3133           (!in_file_spec || !out_file_spec || !err_file_spec)) {
3134         llvm::Error Err = info.SetUpPtyRedirection();
3135         LLDB_LOG_ERROR(log, std::move(Err), "SetUpPtyRedirection failed: {0}");
3136       }
3137     }
3138   }
3139 }
3140 
3141 //--------------------------------------------------------------
3142 // Target::StopHook
3143 //--------------------------------------------------------------
3144 Target::StopHook::StopHook(lldb::TargetSP target_sp, lldb::user_id_t uid)
3145     : UserID(uid), m_target_sp(target_sp), m_commands(), m_specifier_sp(),
3146       m_thread_spec_up(), m_active(true) {}
3147 
3148 Target::StopHook::StopHook(const StopHook &rhs)
3149     : UserID(rhs.GetID()), m_target_sp(rhs.m_target_sp),
3150       m_commands(rhs.m_commands), m_specifier_sp(rhs.m_specifier_sp),
3151       m_thread_spec_up(), m_active(rhs.m_active) {
3152   if (rhs.m_thread_spec_up)
3153     m_thread_spec_up.reset(new ThreadSpec(*rhs.m_thread_spec_up));
3154 }
3155 
3156 Target::StopHook::~StopHook() = default;
3157 
3158 void Target::StopHook::SetSpecifier(SymbolContextSpecifier *specifier) {
3159   m_specifier_sp.reset(specifier);
3160 }
3161 
3162 void Target::StopHook::SetThreadSpecifier(ThreadSpec *specifier) {
3163   m_thread_spec_up.reset(specifier);
3164 }
3165 
3166 void Target::StopHook::GetDescription(Stream *s,
3167                                       lldb::DescriptionLevel level) const {
3168   int indent_level = s->GetIndentLevel();
3169 
3170   s->SetIndentLevel(indent_level + 2);
3171 
3172   s->Printf("Hook: %" PRIu64 "\n", GetID());
3173   if (m_active)
3174     s->Indent("State: enabled\n");
3175   else
3176     s->Indent("State: disabled\n");
3177 
3178   if (m_specifier_sp) {
3179     s->Indent();
3180     s->PutCString("Specifier:\n");
3181     s->SetIndentLevel(indent_level + 4);
3182     m_specifier_sp->GetDescription(s, level);
3183     s->SetIndentLevel(indent_level + 2);
3184   }
3185 
3186   if (m_thread_spec_up) {
3187     StreamString tmp;
3188     s->Indent("Thread:\n");
3189     m_thread_spec_up->GetDescription(&tmp, level);
3190     s->SetIndentLevel(indent_level + 4);
3191     s->Indent(tmp.GetString());
3192     s->PutCString("\n");
3193     s->SetIndentLevel(indent_level + 2);
3194   }
3195 
3196   s->Indent("Commands: \n");
3197   s->SetIndentLevel(indent_level + 4);
3198   uint32_t num_commands = m_commands.GetSize();
3199   for (uint32_t i = 0; i < num_commands; i++) {
3200     s->Indent(m_commands.GetStringAtIndex(i));
3201     s->PutCString("\n");
3202   }
3203   s->SetIndentLevel(indent_level);
3204 }
3205 
3206 //--------------------------------------------------------------
3207 // class TargetProperties
3208 //--------------------------------------------------------------
3209 
3210 // clang-format off
3211 static constexpr OptionEnumValueElement g_dynamic_value_types[] = {
3212     {eNoDynamicValues, "no-dynamic-values",
3213      "Don't calculate the dynamic type of values"},
3214     {eDynamicCanRunTarget, "run-target", "Calculate the dynamic type of values "
3215                                          "even if you have to run the target."},
3216     {eDynamicDontRunTarget, "no-run-target",
3217      "Calculate the dynamic type of values, but don't run the target."} };
3218 
3219 OptionEnumValues lldb_private::GetDynamicValueTypes() {
3220   return OptionEnumValues(g_dynamic_value_types);
3221 }
3222 
3223 static constexpr OptionEnumValueElement g_inline_breakpoint_enums[] = {
3224     {eInlineBreakpointsNever, "never", "Never look for inline breakpoint "
3225                                        "locations (fastest). This setting "
3226                                        "should only be used if you know that "
3227                                        "no inlining occurs in your programs."},
3228     {eInlineBreakpointsHeaders, "headers",
3229      "Only check for inline breakpoint locations when setting breakpoints in "
3230      "header files, but not when setting breakpoint in implementation source "
3231      "files (default)."},
3232     {eInlineBreakpointsAlways, "always",
3233      "Always look for inline breakpoint locations when setting file and line "
3234      "breakpoints (slower but most accurate)."} };
3235 
3236 typedef enum x86DisassemblyFlavor {
3237   eX86DisFlavorDefault,
3238   eX86DisFlavorIntel,
3239   eX86DisFlavorATT
3240 } x86DisassemblyFlavor;
3241 
3242 static constexpr OptionEnumValueElement g_x86_dis_flavor_value_types[] = {
3243     {eX86DisFlavorDefault, "default", "Disassembler default (currently att)."},
3244     {eX86DisFlavorIntel, "intel", "Intel disassembler flavor."},
3245     {eX86DisFlavorATT, "att", "AT&T disassembler flavor."} };
3246 
3247 static constexpr OptionEnumValueElement g_hex_immediate_style_values[] = {
3248     {Disassembler::eHexStyleC, "c", "C-style (0xffff)."},
3249     {Disassembler::eHexStyleAsm, "asm", "Asm-style (0ffffh)."} };
3250 
3251 static constexpr OptionEnumValueElement g_load_script_from_sym_file_values[] = {
3252     {eLoadScriptFromSymFileTrue, "true",
3253      "Load debug scripts inside symbol files"},
3254     {eLoadScriptFromSymFileFalse, "false",
3255      "Do not load debug scripts inside symbol files."},
3256     {eLoadScriptFromSymFileWarn, "warn",
3257      "Warn about debug scripts inside symbol files but do not load them."} };
3258 
3259 static constexpr
3260 OptionEnumValueElement g_load_current_working_dir_lldbinit_values[] = {
3261     {eLoadCWDlldbinitTrue, "true",
3262      "Load .lldbinit files from current directory"},
3263     {eLoadCWDlldbinitFalse, "false",
3264      "Do not load .lldbinit files from current directory"},
3265     {eLoadCWDlldbinitWarn, "warn",
3266      "Warn about loading .lldbinit files from current directory"} };
3267 
3268 static constexpr OptionEnumValueElement g_memory_module_load_level_values[] = {
3269     {eMemoryModuleLoadLevelMinimal, "minimal",
3270      "Load minimal information when loading modules from memory. Currently "
3271      "this setting loads sections only."},
3272     {eMemoryModuleLoadLevelPartial, "partial",
3273      "Load partial information when loading modules from memory. Currently "
3274      "this setting loads sections and function bounds."},
3275     {eMemoryModuleLoadLevelComplete, "complete",
3276      "Load complete information when loading modules from memory. Currently "
3277      "this setting loads sections and all symbols."} };
3278 
3279 static constexpr PropertyDefinition g_properties[] = {
3280     {"default-arch", OptionValue::eTypeArch, true, 0, nullptr, {},
3281      "Default architecture to choose, when there's a choice."},
3282     {"move-to-nearest-code", OptionValue::eTypeBoolean, false, true, nullptr,
3283      {}, "Move breakpoints to nearest code."},
3284     {"language", OptionValue::eTypeLanguage, false, eLanguageTypeUnknown,
3285      nullptr, {},
3286      "The language to use when interpreting expressions entered in commands."},
3287     {"expr-prefix", OptionValue::eTypeFileSpec, false, 0, nullptr, {},
3288      "Path to a file containing expressions to be prepended to all "
3289      "expressions."},
3290     {"prefer-dynamic-value", OptionValue::eTypeEnum, false,
3291      eDynamicDontRunTarget, nullptr, OptionEnumValues(g_dynamic_value_types),
3292      "Should printed values be shown as their dynamic value."},
3293     {"enable-synthetic-value", OptionValue::eTypeBoolean, false, true, nullptr,
3294      {}, "Should synthetic values be used by default whenever available."},
3295     {"skip-prologue", OptionValue::eTypeBoolean, false, true, nullptr, {},
3296      "Skip function prologues when setting breakpoints by name."},
3297     {"source-map", OptionValue::eTypePathMap, false, 0, nullptr, {},
3298      "Source path remappings are used to track the change of location between "
3299      "a source file when built, and "
3300      "where it exists on the current system.  It consists of an array of "
3301      "duples, the first element of each duple is "
3302      "some part (starting at the root) of the path to the file when it was "
3303      "built, "
3304      "and the second is where the remainder of the original build hierarchy is "
3305      "rooted on the local system.  "
3306      "Each element of the array is checked in order and the first one that "
3307      "results in a match wins."},
3308     {"exec-search-paths", OptionValue::eTypeFileSpecList, false, 0, nullptr,
3309      {}, "Executable search paths to use when locating executable files "
3310          "whose paths don't match the local file system."},
3311     {"debug-file-search-paths", OptionValue::eTypeFileSpecList, false, 0,
3312      nullptr, {},
3313      "List of directories to be searched when locating debug symbol files. "
3314      "See also symbols.enable-external-lookup."},
3315     {"clang-module-search-paths", OptionValue::eTypeFileSpecList, false, 0,
3316      nullptr, {},
3317      "List of directories to be searched when locating modules for Clang."},
3318     {"auto-import-clang-modules", OptionValue::eTypeBoolean, false, true,
3319      nullptr, {},
3320      "Automatically load Clang modules referred to by the program."},
3321     {"auto-apply-fixits", OptionValue::eTypeBoolean, false, true, nullptr,
3322      {}, "Automatically apply fix-it hints to expressions."},
3323     {"notify-about-fixits", OptionValue::eTypeBoolean, false, true, nullptr,
3324      {}, "Print the fixed expression text."},
3325     {"save-jit-objects", OptionValue::eTypeBoolean, false, false, nullptr,
3326      {}, "Save intermediate object files generated by the LLVM JIT"},
3327     {"max-children-count", OptionValue::eTypeSInt64, false, 256, nullptr,
3328      {}, "Maximum number of children to expand in any level of depth."},
3329     {"max-string-summary-length", OptionValue::eTypeSInt64, false, 1024,
3330      nullptr, {},
3331      "Maximum number of characters to show when using %s in summary strings."},
3332     {"max-memory-read-size", OptionValue::eTypeSInt64, false, 1024, nullptr,
3333      {}, "Maximum number of bytes that 'memory read' will fetch before "
3334          "--force must be specified."},
3335     {"breakpoints-use-platform-avoid-list", OptionValue::eTypeBoolean, false,
3336      true, nullptr, {}, "Consult the platform module avoid list when "
3337                         "setting non-module specific breakpoints."},
3338     {"arg0", OptionValue::eTypeString, false, 0, nullptr, {},
3339      "The first argument passed to the program in the argument array which can "
3340      "be different from the executable itself."},
3341     {"run-args", OptionValue::eTypeArgs, false, 0, nullptr, {},
3342      "A list containing all the arguments to be passed to the executable when "
3343      "it is run. Note that this does NOT include the argv[0] which is in "
3344      "target.arg0."},
3345     {"env-vars", OptionValue::eTypeDictionary, false, OptionValue::eTypeString,
3346      nullptr, {}, "A list of all the environment variables to be passed "
3347                   "to the executable's environment, and their values."},
3348     {"inherit-env", OptionValue::eTypeBoolean, false, true, nullptr, {},
3349      "Inherit the environment from the process that is running LLDB."},
3350     {"input-path", OptionValue::eTypeFileSpec, false, 0, nullptr, {},
3351      "The file/path to be used by the executable program for reading its "
3352      "standard input."},
3353     {"output-path", OptionValue::eTypeFileSpec, false, 0, nullptr, {},
3354      "The file/path to be used by the executable program for writing its "
3355      "standard output."},
3356     {"error-path", OptionValue::eTypeFileSpec, false, 0, nullptr, {},
3357      "The file/path to be used by the executable program for writing its "
3358      "standard error."},
3359     {"detach-on-error", OptionValue::eTypeBoolean, false, true, nullptr,
3360      {}, "debugserver will detach (rather than killing) a process if it "
3361               "loses connection with lldb."},
3362     {"preload-symbols", OptionValue::eTypeBoolean, false, true, nullptr, {},
3363      "Enable loading of symbol tables before they are needed."},
3364     {"disable-aslr", OptionValue::eTypeBoolean, false, true, nullptr, {},
3365      "Disable Address Space Layout Randomization (ASLR)"},
3366     {"disable-stdio", OptionValue::eTypeBoolean, false, false, nullptr, {},
3367      "Disable stdin/stdout for process (e.g. for a GUI application)"},
3368     {"inline-breakpoint-strategy", OptionValue::eTypeEnum, false,
3369      eInlineBreakpointsAlways, nullptr,
3370      OptionEnumValues(g_inline_breakpoint_enums),
3371      "The strategy to use when settings breakpoints by file and line. "
3372      "Breakpoint locations can end up being inlined by the compiler, so that a "
3373      "compile unit 'a.c' might contain an inlined function from another source "
3374      "file. "
3375      "Usually this is limited to breakpoint locations from inlined functions "
3376      "from header or other include files, or more accurately "
3377      "non-implementation source files. "
3378      "Sometimes code might #include implementation files and cause inlined "
3379      "breakpoint locations in inlined implementation files. "
3380      "Always checking for inlined breakpoint locations can be expensive "
3381      "(memory and time), so if you have a project with many headers "
3382      "and find that setting breakpoints is slow, then you can change this "
3383      "setting to headers. "
3384      "This setting allows you to control exactly which strategy is used when "
3385      "setting "
3386      "file and line breakpoints."},
3387     // FIXME: This is the wrong way to do per-architecture settings, but we
3388     // don't have a general per architecture settings system in place yet.
3389     {"x86-disassembly-flavor", OptionValue::eTypeEnum, false,
3390      eX86DisFlavorDefault, nullptr,
3391      OptionEnumValues(g_x86_dis_flavor_value_types),
3392      "The default disassembly flavor to use for x86 or x86-64 targets."},
3393     {"use-hex-immediates", OptionValue::eTypeBoolean, false, true, nullptr,
3394      {}, "Show immediates in disassembly as hexadecimal."},
3395     {"hex-immediate-style", OptionValue::eTypeEnum, false,
3396      Disassembler::eHexStyleC, nullptr,
3397      OptionEnumValues(g_hex_immediate_style_values),
3398      "Which style to use for printing hexadecimal disassembly values."},
3399     {"use-fast-stepping", OptionValue::eTypeBoolean, false, true, nullptr,
3400      {}, "Use a fast stepping algorithm based on running from branch to "
3401          "branch rather than instruction single-stepping."},
3402     {"load-script-from-symbol-file", OptionValue::eTypeEnum, false,
3403      eLoadScriptFromSymFileWarn, nullptr,
3404      OptionEnumValues(g_load_script_from_sym_file_values),
3405      "Allow LLDB to load scripting resources embedded in symbol files when "
3406      "available."},
3407     {"load-cwd-lldbinit", OptionValue::eTypeEnum, false, eLoadCWDlldbinitWarn,
3408      nullptr, OptionEnumValues(g_load_current_working_dir_lldbinit_values),
3409      "Allow LLDB to .lldbinit files from the current directory automatically."},
3410     {"memory-module-load-level", OptionValue::eTypeEnum, false,
3411      eMemoryModuleLoadLevelComplete, nullptr,
3412      OptionEnumValues(g_memory_module_load_level_values),
3413      "Loading modules from memory can be slow as reading the symbol tables and "
3414      "other data can take a long time depending on your connection to the "
3415      "debug target. "
3416      "This setting helps users control how much information gets loaded when "
3417      "loading modules from memory."
3418      "'complete' is the default value for this setting which will load all "
3419      "sections and symbols by reading them from memory (slowest, most "
3420      "accurate). "
3421      "'partial' will load sections and attempt to find function bounds without "
3422      "downloading the symbol table (faster, still accurate, missing symbol "
3423      "names). "
3424      "'minimal' is the fastest setting and will load section data with no "
3425      "symbols, but should rarely be used as stack frames in these memory "
3426      "regions will be inaccurate and not provide any context (fastest). "},
3427     {"display-expression-in-crashlogs", OptionValue::eTypeBoolean, false, false,
3428      nullptr, {}, "Expressions that crash will show up in crash logs if "
3429                   "the host system supports executable specific crash log "
3430                   "strings and this setting is set to true."},
3431     {"trap-handler-names", OptionValue::eTypeArray, true,
3432      OptionValue::eTypeString, nullptr, {},
3433      "A list of trap handler function names, e.g. a common Unix user process "
3434      "one is _sigtramp."},
3435     {"display-runtime-support-values", OptionValue::eTypeBoolean, false, false,
3436      nullptr, {}, "If true, LLDB will show variables that are meant to "
3437                   "support the operation of a language's runtime support."},
3438     {"display-recognized-arguments", OptionValue::eTypeBoolean, false, false,
3439      nullptr, {}, "Show recognized arguments in variable listings by default."},
3440     {"non-stop-mode", OptionValue::eTypeBoolean, false, 0, nullptr, {},
3441      "Disable lock-step debugging, instead control threads independently."},
3442     {"require-hardware-breakpoint", OptionValue::eTypeBoolean, false, 0,
3443      nullptr, {}, "Require all breakpoints to be hardware breakpoints."}};
3444 // clang-format on
3445 
3446 enum {
3447   ePropertyDefaultArch,
3448   ePropertyMoveToNearestCode,
3449   ePropertyLanguage,
3450   ePropertyExprPrefix,
3451   ePropertyPreferDynamic,
3452   ePropertyEnableSynthetic,
3453   ePropertySkipPrologue,
3454   ePropertySourceMap,
3455   ePropertyExecutableSearchPaths,
3456   ePropertyDebugFileSearchPaths,
3457   ePropertyClangModuleSearchPaths,
3458   ePropertyAutoImportClangModules,
3459   ePropertyAutoApplyFixIts,
3460   ePropertyNotifyAboutFixIts,
3461   ePropertySaveObjects,
3462   ePropertyMaxChildrenCount,
3463   ePropertyMaxSummaryLength,
3464   ePropertyMaxMemReadSize,
3465   ePropertyBreakpointUseAvoidList,
3466   ePropertyArg0,
3467   ePropertyRunArgs,
3468   ePropertyEnvVars,
3469   ePropertyInheritEnv,
3470   ePropertyInputPath,
3471   ePropertyOutputPath,
3472   ePropertyErrorPath,
3473   ePropertyDetachOnError,
3474   ePropertyPreloadSymbols,
3475   ePropertyDisableASLR,
3476   ePropertyDisableSTDIO,
3477   ePropertyInlineStrategy,
3478   ePropertyDisassemblyFlavor,
3479   ePropertyUseHexImmediates,
3480   ePropertyHexImmediateStyle,
3481   ePropertyUseFastStepping,
3482   ePropertyLoadScriptFromSymbolFile,
3483   ePropertyLoadCWDlldbinitFile,
3484   ePropertyMemoryModuleLoadLevel,
3485   ePropertyDisplayExpressionsInCrashlogs,
3486   ePropertyTrapHandlerNames,
3487   ePropertyDisplayRuntimeSupportValues,
3488   ePropertyDisplayRecognizedArguments,
3489   ePropertyNonStopModeEnabled,
3490   ePropertyRequireHardwareBreakpoints,
3491   ePropertyExperimental,
3492 };
3493 
3494 class TargetOptionValueProperties : public OptionValueProperties {
3495 public:
3496   TargetOptionValueProperties(const ConstString &name)
3497       : OptionValueProperties(name), m_target(nullptr), m_got_host_env(false) {}
3498 
3499   // This constructor is used when creating TargetOptionValueProperties when it
3500   // is part of a new lldb_private::Target instance. It will copy all current
3501   // global property values as needed
3502   TargetOptionValueProperties(Target *target,
3503                               const TargetPropertiesSP &target_properties_sp)
3504       : OptionValueProperties(*target_properties_sp->GetValueProperties()),
3505         m_target(target), m_got_host_env(false) {}
3506 
3507   const Property *GetPropertyAtIndex(const ExecutionContext *exe_ctx,
3508                                      bool will_modify,
3509                                      uint32_t idx) const override {
3510     // When getting the value for a key from the target options, we will always
3511     // try and grab the setting from the current target if there is one. Else
3512     // we just use the one from this instance.
3513     if (idx == ePropertyEnvVars)
3514       GetHostEnvironmentIfNeeded();
3515 
3516     if (exe_ctx) {
3517       Target *target = exe_ctx->GetTargetPtr();
3518       if (target) {
3519         TargetOptionValueProperties *target_properties =
3520             static_cast<TargetOptionValueProperties *>(
3521                 target->GetValueProperties().get());
3522         if (this != target_properties)
3523           return target_properties->ProtectedGetPropertyAtIndex(idx);
3524       }
3525     }
3526     return ProtectedGetPropertyAtIndex(idx);
3527   }
3528 
3529   lldb::TargetSP GetTargetSP() { return m_target->shared_from_this(); }
3530 
3531 protected:
3532   void GetHostEnvironmentIfNeeded() const {
3533     if (!m_got_host_env) {
3534       if (m_target) {
3535         m_got_host_env = true;
3536         const uint32_t idx = ePropertyInheritEnv;
3537         if (GetPropertyAtIndexAsBoolean(
3538                 nullptr, idx, g_properties[idx].default_uint_value != 0)) {
3539           PlatformSP platform_sp(m_target->GetPlatform());
3540           if (platform_sp) {
3541             Environment env = platform_sp->GetEnvironment();
3542             OptionValueDictionary *env_dict =
3543                 GetPropertyAtIndexAsOptionValueDictionary(nullptr,
3544                                                           ePropertyEnvVars);
3545             if (env_dict) {
3546               const bool can_replace = false;
3547               for (const auto &KV : env) {
3548                 // Don't allow existing keys to be replaced with ones we get
3549                 // from the platform environment
3550                 env_dict->SetValueForKey(
3551                     ConstString(KV.first()),
3552                     OptionValueSP(new OptionValueString(KV.second.c_str())),
3553                     can_replace);
3554               }
3555             }
3556           }
3557         }
3558       }
3559     }
3560   }
3561   Target *m_target;
3562   mutable bool m_got_host_env;
3563 };
3564 
3565 //----------------------------------------------------------------------
3566 // TargetProperties
3567 //----------------------------------------------------------------------
3568 static constexpr PropertyDefinition g_experimental_properties[]{
3569     {"inject-local-vars", OptionValue::eTypeBoolean, true, true, nullptr,
3570      {},
3571      "If true, inject local variables explicitly into the expression text.  "
3572      "This will fix symbol resolution when there are name collisions between "
3573      "ivars and local variables.  "
3574      "But it can make expressions run much more slowly."},
3575     {"use-modern-type-lookup", OptionValue::eTypeBoolean, true, false, nullptr,
3576      {}, "If true, use Clang's modern type lookup infrastructure."}};
3577 
3578 enum { ePropertyInjectLocalVars = 0, ePropertyUseModernTypeLookup };
3579 
3580 class TargetExperimentalOptionValueProperties : public OptionValueProperties {
3581 public:
3582   TargetExperimentalOptionValueProperties()
3583       : OptionValueProperties(
3584             ConstString(Properties::GetExperimentalSettingsName())) {}
3585 };
3586 
3587 TargetExperimentalProperties::TargetExperimentalProperties()
3588     : Properties(OptionValuePropertiesSP(
3589           new TargetExperimentalOptionValueProperties())) {
3590   m_collection_sp->Initialize(g_experimental_properties);
3591 }
3592 
3593 //----------------------------------------------------------------------
3594 // TargetProperties
3595 //----------------------------------------------------------------------
3596 TargetProperties::TargetProperties(Target *target)
3597     : Properties(), m_launch_info() {
3598   if (target) {
3599     m_collection_sp = std::make_shared<TargetOptionValueProperties>(
3600         target, Target::GetGlobalProperties());
3601 
3602     // Set callbacks to update launch_info whenever "settins set" updated any
3603     // of these properties
3604     m_collection_sp->SetValueChangedCallback(
3605         ePropertyArg0, TargetProperties::Arg0ValueChangedCallback, this);
3606     m_collection_sp->SetValueChangedCallback(
3607         ePropertyRunArgs, TargetProperties::RunArgsValueChangedCallback, this);
3608     m_collection_sp->SetValueChangedCallback(
3609         ePropertyEnvVars, TargetProperties::EnvVarsValueChangedCallback, this);
3610     m_collection_sp->SetValueChangedCallback(
3611         ePropertyInputPath, TargetProperties::InputPathValueChangedCallback,
3612         this);
3613     m_collection_sp->SetValueChangedCallback(
3614         ePropertyOutputPath, TargetProperties::OutputPathValueChangedCallback,
3615         this);
3616     m_collection_sp->SetValueChangedCallback(
3617         ePropertyErrorPath, TargetProperties::ErrorPathValueChangedCallback,
3618         this);
3619     m_collection_sp->SetValueChangedCallback(
3620         ePropertyDetachOnError,
3621         TargetProperties::DetachOnErrorValueChangedCallback, this);
3622     m_collection_sp->SetValueChangedCallback(
3623         ePropertyDisableASLR, TargetProperties::DisableASLRValueChangedCallback,
3624         this);
3625     m_collection_sp->SetValueChangedCallback(
3626         ePropertyDisableSTDIO,
3627         TargetProperties::DisableSTDIOValueChangedCallback, this);
3628 
3629     m_experimental_properties_up.reset(new TargetExperimentalProperties());
3630     m_collection_sp->AppendProperty(
3631         ConstString(Properties::GetExperimentalSettingsName()),
3632         ConstString("Experimental settings - setting these won't produce "
3633                     "errors if the setting is not present."),
3634         true, m_experimental_properties_up->GetValueProperties());
3635 
3636     // Update m_launch_info once it was created
3637     Arg0ValueChangedCallback(this, nullptr);
3638     RunArgsValueChangedCallback(this, nullptr);
3639     // EnvVarsValueChangedCallback(this, nullptr); // FIXME: cause segfault in
3640     // Target::GetPlatform()
3641     InputPathValueChangedCallback(this, nullptr);
3642     OutputPathValueChangedCallback(this, nullptr);
3643     ErrorPathValueChangedCallback(this, nullptr);
3644     DetachOnErrorValueChangedCallback(this, nullptr);
3645     DisableASLRValueChangedCallback(this, nullptr);
3646     DisableSTDIOValueChangedCallback(this, nullptr);
3647   } else {
3648     m_collection_sp =
3649         std::make_shared<TargetOptionValueProperties>(ConstString("target"));
3650     m_collection_sp->Initialize(g_properties);
3651     m_experimental_properties_up.reset(new TargetExperimentalProperties());
3652     m_collection_sp->AppendProperty(
3653         ConstString(Properties::GetExperimentalSettingsName()),
3654         ConstString("Experimental settings - setting these won't produce "
3655                     "errors if the setting is not present."),
3656         true, m_experimental_properties_up->GetValueProperties());
3657     m_collection_sp->AppendProperty(
3658         ConstString("process"), ConstString("Settings specific to processes."),
3659         true, Process::GetGlobalProperties()->GetValueProperties());
3660   }
3661 }
3662 
3663 TargetProperties::~TargetProperties() = default;
3664 
3665 bool TargetProperties::GetInjectLocalVariables(
3666     ExecutionContext *exe_ctx) const {
3667   const Property *exp_property = m_collection_sp->GetPropertyAtIndex(
3668       exe_ctx, false, ePropertyExperimental);
3669   OptionValueProperties *exp_values =
3670       exp_property->GetValue()->GetAsProperties();
3671   if (exp_values)
3672     return exp_values->GetPropertyAtIndexAsBoolean(
3673         exe_ctx, ePropertyInjectLocalVars, true);
3674   else
3675     return true;
3676 }
3677 
3678 void TargetProperties::SetInjectLocalVariables(ExecutionContext *exe_ctx,
3679                                                bool b) {
3680   const Property *exp_property =
3681       m_collection_sp->GetPropertyAtIndex(exe_ctx, true, ePropertyExperimental);
3682   OptionValueProperties *exp_values =
3683       exp_property->GetValue()->GetAsProperties();
3684   if (exp_values)
3685     exp_values->SetPropertyAtIndexAsBoolean(exe_ctx, ePropertyInjectLocalVars,
3686                                             true);
3687 }
3688 
3689 bool TargetProperties::GetUseModernTypeLookup() const {
3690   const Property *exp_property = m_collection_sp->GetPropertyAtIndex(
3691       nullptr, false, ePropertyExperimental);
3692   OptionValueProperties *exp_values =
3693       exp_property->GetValue()->GetAsProperties();
3694   if (exp_values)
3695     return exp_values->GetPropertyAtIndexAsBoolean(
3696         nullptr, ePropertyUseModernTypeLookup, true);
3697   else
3698     return true;
3699 }
3700 
3701 ArchSpec TargetProperties::GetDefaultArchitecture() const {
3702   OptionValueArch *value = m_collection_sp->GetPropertyAtIndexAsOptionValueArch(
3703       nullptr, ePropertyDefaultArch);
3704   if (value)
3705     return value->GetCurrentValue();
3706   return ArchSpec();
3707 }
3708 
3709 void TargetProperties::SetDefaultArchitecture(const ArchSpec &arch) {
3710   OptionValueArch *value = m_collection_sp->GetPropertyAtIndexAsOptionValueArch(
3711       nullptr, ePropertyDefaultArch);
3712   if (value)
3713     return value->SetCurrentValue(arch, true);
3714 }
3715 
3716 bool TargetProperties::GetMoveToNearestCode() const {
3717   const uint32_t idx = ePropertyMoveToNearestCode;
3718   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3719       nullptr, idx, g_properties[idx].default_uint_value != 0);
3720 }
3721 
3722 lldb::DynamicValueType TargetProperties::GetPreferDynamicValue() const {
3723   const uint32_t idx = ePropertyPreferDynamic;
3724   return (lldb::DynamicValueType)
3725       m_collection_sp->GetPropertyAtIndexAsEnumeration(
3726           nullptr, idx, g_properties[idx].default_uint_value);
3727 }
3728 
3729 bool TargetProperties::SetPreferDynamicValue(lldb::DynamicValueType d) {
3730   const uint32_t idx = ePropertyPreferDynamic;
3731   return m_collection_sp->SetPropertyAtIndexAsEnumeration(nullptr, idx, d);
3732 }
3733 
3734 bool TargetProperties::GetPreloadSymbols() const {
3735   const uint32_t idx = ePropertyPreloadSymbols;
3736   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3737       nullptr, idx, g_properties[idx].default_uint_value != 0);
3738 }
3739 
3740 void TargetProperties::SetPreloadSymbols(bool b) {
3741   const uint32_t idx = ePropertyPreloadSymbols;
3742   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
3743 }
3744 
3745 bool TargetProperties::GetDisableASLR() const {
3746   const uint32_t idx = ePropertyDisableASLR;
3747   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3748       nullptr, idx, g_properties[idx].default_uint_value != 0);
3749 }
3750 
3751 void TargetProperties::SetDisableASLR(bool b) {
3752   const uint32_t idx = ePropertyDisableASLR;
3753   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
3754 }
3755 
3756 bool TargetProperties::GetDetachOnError() const {
3757   const uint32_t idx = ePropertyDetachOnError;
3758   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3759       nullptr, idx, g_properties[idx].default_uint_value != 0);
3760 }
3761 
3762 void TargetProperties::SetDetachOnError(bool b) {
3763   const uint32_t idx = ePropertyDetachOnError;
3764   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
3765 }
3766 
3767 bool TargetProperties::GetDisableSTDIO() const {
3768   const uint32_t idx = ePropertyDisableSTDIO;
3769   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3770       nullptr, idx, g_properties[idx].default_uint_value != 0);
3771 }
3772 
3773 void TargetProperties::SetDisableSTDIO(bool b) {
3774   const uint32_t idx = ePropertyDisableSTDIO;
3775   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
3776 }
3777 
3778 const char *TargetProperties::GetDisassemblyFlavor() const {
3779   const uint32_t idx = ePropertyDisassemblyFlavor;
3780   const char *return_value;
3781 
3782   x86DisassemblyFlavor flavor_value =
3783       (x86DisassemblyFlavor)m_collection_sp->GetPropertyAtIndexAsEnumeration(
3784           nullptr, idx, g_properties[idx].default_uint_value);
3785   return_value = g_x86_dis_flavor_value_types[flavor_value].string_value;
3786   return return_value;
3787 }
3788 
3789 InlineStrategy TargetProperties::GetInlineStrategy() const {
3790   const uint32_t idx = ePropertyInlineStrategy;
3791   return (InlineStrategy)m_collection_sp->GetPropertyAtIndexAsEnumeration(
3792       nullptr, idx, g_properties[idx].default_uint_value);
3793 }
3794 
3795 llvm::StringRef TargetProperties::GetArg0() const {
3796   const uint32_t idx = ePropertyArg0;
3797   return m_collection_sp->GetPropertyAtIndexAsString(nullptr, idx, llvm::StringRef());
3798 }
3799 
3800 void TargetProperties::SetArg0(llvm::StringRef arg) {
3801   const uint32_t idx = ePropertyArg0;
3802   m_collection_sp->SetPropertyAtIndexAsString(
3803       nullptr, idx, arg);
3804   m_launch_info.SetArg0(arg);
3805 }
3806 
3807 bool TargetProperties::GetRunArguments(Args &args) const {
3808   const uint32_t idx = ePropertyRunArgs;
3809   return m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, args);
3810 }
3811 
3812 void TargetProperties::SetRunArguments(const Args &args) {
3813   const uint32_t idx = ePropertyRunArgs;
3814   m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, args);
3815   m_launch_info.GetArguments() = args;
3816 }
3817 
3818 Environment TargetProperties::GetEnvironment() const {
3819   // TODO: Get rid of the Args intermediate step
3820   Args env;
3821   const uint32_t idx = ePropertyEnvVars;
3822   m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, env);
3823   return Environment(env);
3824 }
3825 
3826 void TargetProperties::SetEnvironment(Environment env) {
3827   // TODO: Get rid of the Args intermediate step
3828   const uint32_t idx = ePropertyEnvVars;
3829   m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, Args(env));
3830   m_launch_info.GetEnvironment() = std::move(env);
3831 }
3832 
3833 bool TargetProperties::GetSkipPrologue() const {
3834   const uint32_t idx = ePropertySkipPrologue;
3835   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3836       nullptr, idx, g_properties[idx].default_uint_value != 0);
3837 }
3838 
3839 PathMappingList &TargetProperties::GetSourcePathMap() const {
3840   const uint32_t idx = ePropertySourceMap;
3841   OptionValuePathMappings *option_value =
3842       m_collection_sp->GetPropertyAtIndexAsOptionValuePathMappings(nullptr,
3843                                                                    false, idx);
3844   assert(option_value);
3845   return option_value->GetCurrentValue();
3846 }
3847 
3848 FileSpecList &TargetProperties::GetExecutableSearchPaths() {
3849   const uint32_t idx = ePropertyExecutableSearchPaths;
3850   OptionValueFileSpecList *option_value =
3851       m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr,
3852                                                                    false, idx);
3853   assert(option_value);
3854   return option_value->GetCurrentValue();
3855 }
3856 
3857 FileSpecList &TargetProperties::GetDebugFileSearchPaths() {
3858   const uint32_t idx = ePropertyDebugFileSearchPaths;
3859   OptionValueFileSpecList *option_value =
3860       m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr,
3861                                                                    false, idx);
3862   assert(option_value);
3863   return option_value->GetCurrentValue();
3864 }
3865 
3866 FileSpecList &TargetProperties::GetClangModuleSearchPaths() {
3867   const uint32_t idx = ePropertyClangModuleSearchPaths;
3868   OptionValueFileSpecList *option_value =
3869       m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr,
3870                                                                    false, idx);
3871   assert(option_value);
3872   return option_value->GetCurrentValue();
3873 }
3874 
3875 bool TargetProperties::GetEnableAutoImportClangModules() const {
3876   const uint32_t idx = ePropertyAutoImportClangModules;
3877   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3878       nullptr, idx, g_properties[idx].default_uint_value != 0);
3879 }
3880 
3881 bool TargetProperties::GetEnableAutoApplyFixIts() const {
3882   const uint32_t idx = ePropertyAutoApplyFixIts;
3883   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3884       nullptr, idx, g_properties[idx].default_uint_value != 0);
3885 }
3886 
3887 bool TargetProperties::GetEnableNotifyAboutFixIts() const {
3888   const uint32_t idx = ePropertyNotifyAboutFixIts;
3889   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3890       nullptr, idx, g_properties[idx].default_uint_value != 0);
3891 }
3892 
3893 bool TargetProperties::GetEnableSaveObjects() const {
3894   const uint32_t idx = ePropertySaveObjects;
3895   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3896       nullptr, idx, g_properties[idx].default_uint_value != 0);
3897 }
3898 
3899 bool TargetProperties::GetEnableSyntheticValue() const {
3900   const uint32_t idx = ePropertyEnableSynthetic;
3901   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3902       nullptr, idx, g_properties[idx].default_uint_value != 0);
3903 }
3904 
3905 uint32_t TargetProperties::GetMaximumNumberOfChildrenToDisplay() const {
3906   const uint32_t idx = ePropertyMaxChildrenCount;
3907   return m_collection_sp->GetPropertyAtIndexAsSInt64(
3908       nullptr, idx, g_properties[idx].default_uint_value);
3909 }
3910 
3911 uint32_t TargetProperties::GetMaximumSizeOfStringSummary() const {
3912   const uint32_t idx = ePropertyMaxSummaryLength;
3913   return m_collection_sp->GetPropertyAtIndexAsSInt64(
3914       nullptr, idx, g_properties[idx].default_uint_value);
3915 }
3916 
3917 uint32_t TargetProperties::GetMaximumMemReadSize() const {
3918   const uint32_t idx = ePropertyMaxMemReadSize;
3919   return m_collection_sp->GetPropertyAtIndexAsSInt64(
3920       nullptr, idx, g_properties[idx].default_uint_value);
3921 }
3922 
3923 FileSpec TargetProperties::GetStandardInputPath() const {
3924   const uint32_t idx = ePropertyInputPath;
3925   return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx);
3926 }
3927 
3928 void TargetProperties::SetStandardInputPath(llvm::StringRef path) {
3929   const uint32_t idx = ePropertyInputPath;
3930   m_collection_sp->SetPropertyAtIndexAsString(nullptr, idx, path);
3931 }
3932 
3933 FileSpec TargetProperties::GetStandardOutputPath() const {
3934   const uint32_t idx = ePropertyOutputPath;
3935   return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx);
3936 }
3937 
3938 void TargetProperties::SetStandardOutputPath(llvm::StringRef path) {
3939   const uint32_t idx = ePropertyOutputPath;
3940   m_collection_sp->SetPropertyAtIndexAsString(nullptr, idx, path);
3941 }
3942 
3943 FileSpec TargetProperties::GetStandardErrorPath() const {
3944   const uint32_t idx = ePropertyErrorPath;
3945   return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx);
3946 }
3947 
3948 void TargetProperties::SetStandardErrorPath(llvm::StringRef path) {
3949   const uint32_t idx = ePropertyErrorPath;
3950   m_collection_sp->SetPropertyAtIndexAsString(nullptr, idx, path);
3951 }
3952 
3953 LanguageType TargetProperties::GetLanguage() const {
3954   OptionValueLanguage *value =
3955       m_collection_sp->GetPropertyAtIndexAsOptionValueLanguage(
3956           nullptr, ePropertyLanguage);
3957   if (value)
3958     return value->GetCurrentValue();
3959   return LanguageType();
3960 }
3961 
3962 llvm::StringRef TargetProperties::GetExpressionPrefixContents() {
3963   const uint32_t idx = ePropertyExprPrefix;
3964   OptionValueFileSpec *file =
3965       m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpec(nullptr, false,
3966                                                                idx);
3967   if (file) {
3968     DataBufferSP data_sp(file->GetFileContents());
3969     if (data_sp)
3970       return llvm::StringRef(
3971           reinterpret_cast<const char *>(data_sp->GetBytes()),
3972           data_sp->GetByteSize());
3973   }
3974   return "";
3975 }
3976 
3977 bool TargetProperties::GetBreakpointsConsultPlatformAvoidList() {
3978   const uint32_t idx = ePropertyBreakpointUseAvoidList;
3979   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3980       nullptr, idx, g_properties[idx].default_uint_value != 0);
3981 }
3982 
3983 bool TargetProperties::GetUseHexImmediates() const {
3984   const uint32_t idx = ePropertyUseHexImmediates;
3985   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3986       nullptr, idx, g_properties[idx].default_uint_value != 0);
3987 }
3988 
3989 bool TargetProperties::GetUseFastStepping() const {
3990   const uint32_t idx = ePropertyUseFastStepping;
3991   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3992       nullptr, idx, g_properties[idx].default_uint_value != 0);
3993 }
3994 
3995 bool TargetProperties::GetDisplayExpressionsInCrashlogs() const {
3996   const uint32_t idx = ePropertyDisplayExpressionsInCrashlogs;
3997   return m_collection_sp->GetPropertyAtIndexAsBoolean(
3998       nullptr, idx, g_properties[idx].default_uint_value != 0);
3999 }
4000 
4001 LoadScriptFromSymFile TargetProperties::GetLoadScriptFromSymbolFile() const {
4002   const uint32_t idx = ePropertyLoadScriptFromSymbolFile;
4003   return (LoadScriptFromSymFile)
4004       m_collection_sp->GetPropertyAtIndexAsEnumeration(
4005           nullptr, idx, g_properties[idx].default_uint_value);
4006 }
4007 
4008 LoadCWDlldbinitFile TargetProperties::GetLoadCWDlldbinitFile() const {
4009   const uint32_t idx = ePropertyLoadCWDlldbinitFile;
4010   return (LoadCWDlldbinitFile)m_collection_sp->GetPropertyAtIndexAsEnumeration(
4011       nullptr, idx, g_properties[idx].default_uint_value);
4012 }
4013 
4014 Disassembler::HexImmediateStyle TargetProperties::GetHexImmediateStyle() const {
4015   const uint32_t idx = ePropertyHexImmediateStyle;
4016   return (Disassembler::HexImmediateStyle)
4017       m_collection_sp->GetPropertyAtIndexAsEnumeration(
4018           nullptr, idx, g_properties[idx].default_uint_value);
4019 }
4020 
4021 MemoryModuleLoadLevel TargetProperties::GetMemoryModuleLoadLevel() const {
4022   const uint32_t idx = ePropertyMemoryModuleLoadLevel;
4023   return (MemoryModuleLoadLevel)
4024       m_collection_sp->GetPropertyAtIndexAsEnumeration(
4025           nullptr, idx, g_properties[idx].default_uint_value);
4026 }
4027 
4028 bool TargetProperties::GetUserSpecifiedTrapHandlerNames(Args &args) const {
4029   const uint32_t idx = ePropertyTrapHandlerNames;
4030   return m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, args);
4031 }
4032 
4033 void TargetProperties::SetUserSpecifiedTrapHandlerNames(const Args &args) {
4034   const uint32_t idx = ePropertyTrapHandlerNames;
4035   m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, args);
4036 }
4037 
4038 bool TargetProperties::GetDisplayRuntimeSupportValues() const {
4039   const uint32_t idx = ePropertyDisplayRuntimeSupportValues;
4040   return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, false);
4041 }
4042 
4043 void TargetProperties::SetDisplayRuntimeSupportValues(bool b) {
4044   const uint32_t idx = ePropertyDisplayRuntimeSupportValues;
4045   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
4046 }
4047 
4048 bool TargetProperties::GetDisplayRecognizedArguments() const {
4049   const uint32_t idx = ePropertyDisplayRecognizedArguments;
4050   return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, false);
4051 }
4052 
4053 void TargetProperties::SetDisplayRecognizedArguments(bool b) {
4054   const uint32_t idx = ePropertyDisplayRecognizedArguments;
4055   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
4056 }
4057 
4058 bool TargetProperties::GetNonStopModeEnabled() const {
4059   const uint32_t idx = ePropertyNonStopModeEnabled;
4060   return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, false);
4061 }
4062 
4063 void TargetProperties::SetNonStopModeEnabled(bool b) {
4064   const uint32_t idx = ePropertyNonStopModeEnabled;
4065   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
4066 }
4067 
4068 const ProcessLaunchInfo &TargetProperties::GetProcessLaunchInfo() {
4069   m_launch_info.SetArg0(GetArg0()); // FIXME: Arg0 callback doesn't work
4070   return m_launch_info;
4071 }
4072 
4073 void TargetProperties::SetProcessLaunchInfo(
4074     const ProcessLaunchInfo &launch_info) {
4075   m_launch_info = launch_info;
4076   SetArg0(launch_info.GetArg0());
4077   SetRunArguments(launch_info.GetArguments());
4078   SetEnvironment(launch_info.GetEnvironment());
4079   const FileAction *input_file_action =
4080       launch_info.GetFileActionForFD(STDIN_FILENO);
4081   if (input_file_action) {
4082     SetStandardInputPath(input_file_action->GetPath());
4083   }
4084   const FileAction *output_file_action =
4085       launch_info.GetFileActionForFD(STDOUT_FILENO);
4086   if (output_file_action) {
4087     SetStandardOutputPath(output_file_action->GetPath());
4088   }
4089   const FileAction *error_file_action =
4090       launch_info.GetFileActionForFD(STDERR_FILENO);
4091   if (error_file_action) {
4092     SetStandardErrorPath(error_file_action->GetPath());
4093   }
4094   SetDetachOnError(launch_info.GetFlags().Test(lldb::eLaunchFlagDetachOnError));
4095   SetDisableASLR(launch_info.GetFlags().Test(lldb::eLaunchFlagDisableASLR));
4096   SetDisableSTDIO(launch_info.GetFlags().Test(lldb::eLaunchFlagDisableSTDIO));
4097 }
4098 
4099 bool TargetProperties::GetRequireHardwareBreakpoints() const {
4100   const uint32_t idx = ePropertyRequireHardwareBreakpoints;
4101   return m_collection_sp->GetPropertyAtIndexAsBoolean(
4102       nullptr, idx, g_properties[idx].default_uint_value != 0);
4103 }
4104 
4105 void TargetProperties::SetRequireHardwareBreakpoints(bool b) {
4106   const uint32_t idx = ePropertyRequireHardwareBreakpoints;
4107   m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b);
4108 }
4109 
4110 void TargetProperties::Arg0ValueChangedCallback(void *target_property_ptr,
4111                                                 OptionValue *) {
4112   TargetProperties *this_ =
4113       reinterpret_cast<TargetProperties *>(target_property_ptr);
4114   this_->m_launch_info.SetArg0(this_->GetArg0());
4115 }
4116 
4117 void TargetProperties::RunArgsValueChangedCallback(void *target_property_ptr,
4118                                                    OptionValue *) {
4119   TargetProperties *this_ =
4120       reinterpret_cast<TargetProperties *>(target_property_ptr);
4121   Args args;
4122   if (this_->GetRunArguments(args))
4123     this_->m_launch_info.GetArguments() = args;
4124 }
4125 
4126 void TargetProperties::EnvVarsValueChangedCallback(void *target_property_ptr,
4127                                                    OptionValue *) {
4128   TargetProperties *this_ =
4129       reinterpret_cast<TargetProperties *>(target_property_ptr);
4130   this_->m_launch_info.GetEnvironment() = this_->GetEnvironment();
4131 }
4132 
4133 void TargetProperties::InputPathValueChangedCallback(void *target_property_ptr,
4134                                                      OptionValue *) {
4135   TargetProperties *this_ =
4136       reinterpret_cast<TargetProperties *>(target_property_ptr);
4137   this_->m_launch_info.AppendOpenFileAction(
4138       STDIN_FILENO, this_->GetStandardInputPath(), true, false);
4139 }
4140 
4141 void TargetProperties::OutputPathValueChangedCallback(void *target_property_ptr,
4142                                                       OptionValue *) {
4143   TargetProperties *this_ =
4144       reinterpret_cast<TargetProperties *>(target_property_ptr);
4145   this_->m_launch_info.AppendOpenFileAction(
4146       STDOUT_FILENO, this_->GetStandardOutputPath(), false, true);
4147 }
4148 
4149 void TargetProperties::ErrorPathValueChangedCallback(void *target_property_ptr,
4150                                                      OptionValue *) {
4151   TargetProperties *this_ =
4152       reinterpret_cast<TargetProperties *>(target_property_ptr);
4153   this_->m_launch_info.AppendOpenFileAction(
4154       STDERR_FILENO, this_->GetStandardErrorPath(), false, true);
4155 }
4156 
4157 void TargetProperties::DetachOnErrorValueChangedCallback(
4158     void *target_property_ptr, OptionValue *) {
4159   TargetProperties *this_ =
4160       reinterpret_cast<TargetProperties *>(target_property_ptr);
4161   if (this_->GetDetachOnError())
4162     this_->m_launch_info.GetFlags().Set(lldb::eLaunchFlagDetachOnError);
4163   else
4164     this_->m_launch_info.GetFlags().Clear(lldb::eLaunchFlagDetachOnError);
4165 }
4166 
4167 void TargetProperties::DisableASLRValueChangedCallback(
4168     void *target_property_ptr, OptionValue *) {
4169   TargetProperties *this_ =
4170       reinterpret_cast<TargetProperties *>(target_property_ptr);
4171   if (this_->GetDisableASLR())
4172     this_->m_launch_info.GetFlags().Set(lldb::eLaunchFlagDisableASLR);
4173   else
4174     this_->m_launch_info.GetFlags().Clear(lldb::eLaunchFlagDisableASLR);
4175 }
4176 
4177 void TargetProperties::DisableSTDIOValueChangedCallback(
4178     void *target_property_ptr, OptionValue *) {
4179   TargetProperties *this_ =
4180       reinterpret_cast<TargetProperties *>(target_property_ptr);
4181   if (this_->GetDisableSTDIO())
4182     this_->m_launch_info.GetFlags().Set(lldb::eLaunchFlagDisableSTDIO);
4183   else
4184     this_->m_launch_info.GetFlags().Clear(lldb::eLaunchFlagDisableSTDIO);
4185 }
4186 
4187 //----------------------------------------------------------------------
4188 // Target::TargetEventData
4189 //----------------------------------------------------------------------
4190 
4191 Target::TargetEventData::TargetEventData(const lldb::TargetSP &target_sp)
4192     : EventData(), m_target_sp(target_sp), m_module_list() {}
4193 
4194 Target::TargetEventData::TargetEventData(const lldb::TargetSP &target_sp,
4195                                          const ModuleList &module_list)
4196     : EventData(), m_target_sp(target_sp), m_module_list(module_list) {}
4197 
4198 Target::TargetEventData::~TargetEventData() = default;
4199 
4200 const ConstString &Target::TargetEventData::GetFlavorString() {
4201   static ConstString g_flavor("Target::TargetEventData");
4202   return g_flavor;
4203 }
4204 
4205 void Target::TargetEventData::Dump(Stream *s) const {
4206   for (size_t i = 0; i < m_module_list.GetSize(); ++i) {
4207     if (i != 0)
4208       *s << ", ";
4209     m_module_list.GetModuleAtIndex(i)->GetDescription(
4210         s, lldb::eDescriptionLevelBrief);
4211   }
4212 }
4213 
4214 const Target::TargetEventData *
4215 Target::TargetEventData::GetEventDataFromEvent(const Event *event_ptr) {
4216   if (event_ptr) {
4217     const EventData *event_data = event_ptr->GetData();
4218     if (event_data &&
4219         event_data->GetFlavor() == TargetEventData::GetFlavorString())
4220       return static_cast<const TargetEventData *>(event_ptr->GetData());
4221   }
4222   return nullptr;
4223 }
4224 
4225 TargetSP Target::TargetEventData::GetTargetFromEvent(const Event *event_ptr) {
4226   TargetSP target_sp;
4227   const TargetEventData *event_data = GetEventDataFromEvent(event_ptr);
4228   if (event_data)
4229     target_sp = event_data->m_target_sp;
4230   return target_sp;
4231 }
4232 
4233 ModuleList
4234 Target::TargetEventData::GetModuleListFromEvent(const Event *event_ptr) {
4235   ModuleList module_list;
4236   const TargetEventData *event_data = GetEventDataFromEvent(event_ptr);
4237   if (event_data)
4238     module_list = event_data->m_module_list;
4239   return module_list;
4240 }
4241