1 //===-- SBTarget.cpp --------------------------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "lldb/API/SBTarget.h"
11 
12 #include "lldb/lldb-public.h"
13 
14 #include "lldb/API/SBBreakpoint.h"
15 #include "lldb/API/SBDebugger.h"
16 #include "lldb/API/SBEvent.h"
17 #include "lldb/API/SBExpressionOptions.h"
18 #include "lldb/API/SBFileSpec.h"
19 #include "lldb/API/SBListener.h"
20 #include "lldb/API/SBModule.h"
21 #include "lldb/API/SBModuleSpec.h"
22 #include "lldb/API/SBProcess.h"
23 #include "lldb/API/SBSourceManager.h"
24 #include "lldb/API/SBStream.h"
25 #include "lldb/API/SBStringList.h"
26 #include "lldb/API/SBStructuredData.h"
27 #include "lldb/API/SBSymbolContextList.h"
28 #include "lldb/Breakpoint/BreakpointID.h"
29 #include "lldb/Breakpoint/BreakpointIDList.h"
30 #include "lldb/Breakpoint/BreakpointList.h"
31 #include "lldb/Breakpoint/BreakpointLocation.h"
32 #include "lldb/Core/Address.h"
33 #include "lldb/Core/AddressResolver.h"
34 #include "lldb/Core/AddressResolverName.h"
35 #include "lldb/Core/Debugger.h"
36 #include "lldb/Core/Disassembler.h"
37 #include "lldb/Core/Module.h"
38 #include "lldb/Core/ModuleSpec.h"
39 #include "lldb/Core/STLUtils.h"
40 #include "lldb/Core/SearchFilter.h"
41 #include "lldb/Core/Section.h"
42 #include "lldb/Core/StructuredDataImpl.h"
43 #include "lldb/Core/ValueObjectConstResult.h"
44 #include "lldb/Core/ValueObjectList.h"
45 #include "lldb/Core/ValueObjectVariable.h"
46 #include "lldb/Host/Host.h"
47 #include "lldb/Symbol/ClangASTContext.h"
48 #include "lldb/Symbol/DeclVendor.h"
49 #include "lldb/Symbol/ObjectFile.h"
50 #include "lldb/Symbol/SymbolFile.h"
51 #include "lldb/Symbol/SymbolVendor.h"
52 #include "lldb/Symbol/VariableList.h"
53 #include "lldb/Target/ABI.h"
54 #include "lldb/Target/Language.h"
55 #include "lldb/Target/LanguageRuntime.h"
56 #include "lldb/Target/ObjCLanguageRuntime.h"
57 #include "lldb/Target/Process.h"
58 #include "lldb/Target/StackFrame.h"
59 #include "lldb/Target/Target.h"
60 #include "lldb/Target/TargetList.h"
61 #include "lldb/Utility/ArchSpec.h"
62 #include "lldb/Utility/Args.h"
63 #include "lldb/Utility/FileSpec.h"
64 #include "lldb/Utility/Log.h"
65 #include "lldb/Utility/RegularExpression.h"
66 
67 #include "Commands/CommandObjectBreakpoint.h"
68 #include "lldb/Interpreter/CommandReturnObject.h"
69 #include "llvm/Support/PrettyStackTrace.h"
70 #include "llvm/Support/Regex.h"
71 
72 using namespace lldb;
73 using namespace lldb_private;
74 
75 #define DEFAULT_DISASM_BYTE_SIZE 32
76 
77 namespace {
78 
79 Status AttachToProcess(ProcessAttachInfo &attach_info, Target &target) {
80   std::lock_guard<std::recursive_mutex> guard(target.GetAPIMutex());
81 
82   auto process_sp = target.GetProcessSP();
83   if (process_sp) {
84     const auto state = process_sp->GetState();
85     if (process_sp->IsAlive() && state == eStateConnected) {
86       // If we are already connected, then we have already specified the
87       // listener, so if a valid listener is supplied, we need to error out to
88       // let the client know.
89       if (attach_info.GetListener())
90         return Status("process is connected and already has a listener, pass "
91                       "empty listener");
92     }
93   }
94 
95   return target.Attach(attach_info, nullptr);
96 }
97 
98 } // namespace
99 
100 //----------------------------------------------------------------------
101 // SBTarget constructor
102 //----------------------------------------------------------------------
103 SBTarget::SBTarget() : m_opaque_sp() {}
104 
105 SBTarget::SBTarget(const SBTarget &rhs) : m_opaque_sp(rhs.m_opaque_sp) {}
106 
107 SBTarget::SBTarget(const TargetSP &target_sp) : m_opaque_sp(target_sp) {}
108 
109 const SBTarget &SBTarget::operator=(const SBTarget &rhs) {
110   if (this != &rhs)
111     m_opaque_sp = rhs.m_opaque_sp;
112   return *this;
113 }
114 
115 //----------------------------------------------------------------------
116 // Destructor
117 //----------------------------------------------------------------------
118 SBTarget::~SBTarget() {}
119 
120 bool SBTarget::EventIsTargetEvent(const SBEvent &event) {
121   return Target::TargetEventData::GetEventDataFromEvent(event.get()) != NULL;
122 }
123 
124 SBTarget SBTarget::GetTargetFromEvent(const SBEvent &event) {
125   return Target::TargetEventData::GetTargetFromEvent(event.get());
126 }
127 
128 uint32_t SBTarget::GetNumModulesFromEvent(const SBEvent &event) {
129   const ModuleList module_list =
130       Target::TargetEventData::GetModuleListFromEvent(event.get());
131   return module_list.GetSize();
132 }
133 
134 SBModule SBTarget::GetModuleAtIndexFromEvent(const uint32_t idx,
135                                              const SBEvent &event) {
136   const ModuleList module_list =
137       Target::TargetEventData::GetModuleListFromEvent(event.get());
138   return SBModule(module_list.GetModuleAtIndex(idx));
139 }
140 
141 const char *SBTarget::GetBroadcasterClassName() {
142   return Target::GetStaticBroadcasterClass().AsCString();
143 }
144 
145 bool SBTarget::IsValid() const {
146   return m_opaque_sp.get() != NULL && m_opaque_sp->IsValid();
147 }
148 
149 SBProcess SBTarget::GetProcess() {
150   SBProcess sb_process;
151   ProcessSP process_sp;
152   TargetSP target_sp(GetSP());
153   if (target_sp) {
154     process_sp = target_sp->GetProcessSP();
155     sb_process.SetSP(process_sp);
156   }
157 
158   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
159   if (log)
160     log->Printf("SBTarget(%p)::GetProcess () => SBProcess(%p)",
161                 static_cast<void *>(target_sp.get()),
162                 static_cast<void *>(process_sp.get()));
163 
164   return sb_process;
165 }
166 
167 SBPlatform SBTarget::GetPlatform() {
168   TargetSP target_sp(GetSP());
169   if (!target_sp)
170     return SBPlatform();
171 
172   SBPlatform platform;
173   platform.m_opaque_sp = target_sp->GetPlatform();
174 
175   return platform;
176 }
177 
178 SBDebugger SBTarget::GetDebugger() const {
179   SBDebugger debugger;
180   TargetSP target_sp(GetSP());
181   if (target_sp)
182     debugger.reset(target_sp->GetDebugger().shared_from_this());
183   return debugger;
184 }
185 
186 SBStructuredData SBTarget::GetStatistics() {
187   SBStructuredData data;
188   TargetSP target_sp(GetSP());
189   if (!target_sp)
190     return data;
191 
192   auto stats_up = llvm::make_unique<StructuredData::Dictionary>();
193   int i = 0;
194   for (auto &Entry : target_sp->GetStatistics()) {
195     std::string Desc = lldb_private::GetStatDescription(
196         static_cast<lldb_private::StatisticKind>(i));
197     stats_up->AddIntegerItem(Desc, Entry);
198     i += 1;
199   }
200 
201   data.m_impl_up->SetObjectSP(std::move(stats_up));
202   return data;
203 }
204 
205 void SBTarget::SetCollectingStats(bool v) {
206   TargetSP target_sp(GetSP());
207   if (!target_sp)
208     return;
209   return target_sp->SetCollectingStats(v);
210 }
211 
212 bool SBTarget::GetCollectingStats() {
213   TargetSP target_sp(GetSP());
214   if (!target_sp)
215     return false;
216   return target_sp->GetCollectingStats();
217 }
218 
219 
220 SBProcess SBTarget::LoadCore(const char *core_file) {
221   lldb::SBError error; // Ignored
222   return LoadCore(core_file, error);
223 }
224 
225 SBProcess SBTarget::LoadCore(const char *core_file, lldb::SBError &error) {
226   SBProcess sb_process;
227   TargetSP target_sp(GetSP());
228   if (target_sp) {
229     FileSpec filespec(core_file, true);
230     ProcessSP process_sp(target_sp->CreateProcess(
231         target_sp->GetDebugger().GetListener(), "", &filespec));
232     if (process_sp) {
233       error.SetError(process_sp->LoadCore());
234       if (error.Success())
235         sb_process.SetSP(process_sp);
236     } else {
237       error.SetErrorString("Failed to create the process");
238     }
239   } else {
240     error.SetErrorString("SBTarget is invalid");
241   }
242   return sb_process;
243 }
244 
245 SBProcess SBTarget::LaunchSimple(char const **argv, char const **envp,
246                                  const char *working_directory) {
247   char *stdin_path = NULL;
248   char *stdout_path = NULL;
249   char *stderr_path = NULL;
250   uint32_t launch_flags = 0;
251   bool stop_at_entry = false;
252   SBError error;
253   SBListener listener = GetDebugger().GetListener();
254   return Launch(listener, argv, envp, stdin_path, stdout_path, stderr_path,
255                 working_directory, launch_flags, stop_at_entry, error);
256 }
257 
258 SBError SBTarget::Install() {
259   SBError sb_error;
260   TargetSP target_sp(GetSP());
261   if (target_sp) {
262     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
263     sb_error.ref() = target_sp->Install(NULL);
264   }
265   return sb_error;
266 }
267 
268 SBProcess SBTarget::Launch(SBListener &listener, char const **argv,
269                            char const **envp, const char *stdin_path,
270                            const char *stdout_path, const char *stderr_path,
271                            const char *working_directory,
272                            uint32_t launch_flags, // See LaunchFlags
273                            bool stop_at_entry, lldb::SBError &error) {
274   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
275 
276   SBProcess sb_process;
277   ProcessSP process_sp;
278   TargetSP target_sp(GetSP());
279 
280   if (log)
281     log->Printf("SBTarget(%p)::Launch (argv=%p, envp=%p, stdin=%s, stdout=%s, "
282                 "stderr=%s, working-dir=%s, launch_flags=0x%x, "
283                 "stop_at_entry=%i, &error (%p))...",
284                 static_cast<void *>(target_sp.get()), static_cast<void *>(argv),
285                 static_cast<void *>(envp), stdin_path ? stdin_path : "NULL",
286                 stdout_path ? stdout_path : "NULL",
287                 stderr_path ? stderr_path : "NULL",
288                 working_directory ? working_directory : "NULL", launch_flags,
289                 stop_at_entry, static_cast<void *>(error.get()));
290 
291   if (target_sp) {
292     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
293 
294     if (stop_at_entry)
295       launch_flags |= eLaunchFlagStopAtEntry;
296 
297     if (getenv("LLDB_LAUNCH_FLAG_DISABLE_ASLR"))
298       launch_flags |= eLaunchFlagDisableASLR;
299 
300     StateType state = eStateInvalid;
301     process_sp = target_sp->GetProcessSP();
302     if (process_sp) {
303       state = process_sp->GetState();
304 
305       if (process_sp->IsAlive() && state != eStateConnected) {
306         if (state == eStateAttaching)
307           error.SetErrorString("process attach is in progress");
308         else
309           error.SetErrorString("a process is already being debugged");
310         return sb_process;
311       }
312     }
313 
314     if (state == eStateConnected) {
315       // If we are already connected, then we have already specified the
316       // listener, so if a valid listener is supplied, we need to error out to
317       // let the client know.
318       if (listener.IsValid()) {
319         error.SetErrorString("process is connected and already has a listener, "
320                              "pass empty listener");
321         return sb_process;
322       }
323     }
324 
325     if (getenv("LLDB_LAUNCH_FLAG_DISABLE_STDIO"))
326       launch_flags |= eLaunchFlagDisableSTDIO;
327 
328     ProcessLaunchInfo launch_info(
329         FileSpec{stdin_path, false}, FileSpec{stdout_path, false},
330         FileSpec{stderr_path, false}, FileSpec{working_directory, false},
331         launch_flags);
332 
333     Module *exe_module = target_sp->GetExecutableModulePointer();
334     if (exe_module)
335       launch_info.SetExecutableFile(exe_module->GetPlatformFileSpec(), true);
336     if (argv)
337       launch_info.GetArguments().AppendArguments(argv);
338     if (envp)
339       launch_info.GetEnvironment() = Environment(envp);
340 
341     if (listener.IsValid())
342       launch_info.SetListener(listener.GetSP());
343 
344     error.SetError(target_sp->Launch(launch_info, NULL));
345 
346     sb_process.SetSP(target_sp->GetProcessSP());
347   } else {
348     error.SetErrorString("SBTarget is invalid");
349   }
350 
351   log = lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API);
352   if (log)
353     log->Printf("SBTarget(%p)::Launch (...) => SBProcess(%p), SBError(%s)",
354                 static_cast<void *>(target_sp.get()),
355                 static_cast<void *>(sb_process.GetSP().get()),
356                 error.GetCString());
357 
358   return sb_process;
359 }
360 
361 SBProcess SBTarget::Launch(SBLaunchInfo &sb_launch_info, SBError &error) {
362   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
363 
364   SBProcess sb_process;
365   TargetSP target_sp(GetSP());
366 
367   if (log)
368     log->Printf("SBTarget(%p)::Launch (launch_info, error)...",
369                 static_cast<void *>(target_sp.get()));
370 
371   if (target_sp) {
372     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
373     StateType state = eStateInvalid;
374     {
375       ProcessSP process_sp = target_sp->GetProcessSP();
376       if (process_sp) {
377         state = process_sp->GetState();
378 
379         if (process_sp->IsAlive() && state != eStateConnected) {
380           if (state == eStateAttaching)
381             error.SetErrorString("process attach is in progress");
382           else
383             error.SetErrorString("a process is already being debugged");
384           return sb_process;
385         }
386       }
387     }
388 
389     lldb_private::ProcessLaunchInfo launch_info = sb_launch_info.ref();
390 
391     if (!launch_info.GetExecutableFile()) {
392       Module *exe_module = target_sp->GetExecutableModulePointer();
393       if (exe_module)
394         launch_info.SetExecutableFile(exe_module->GetPlatformFileSpec(), true);
395     }
396 
397     const ArchSpec &arch_spec = target_sp->GetArchitecture();
398     if (arch_spec.IsValid())
399       launch_info.GetArchitecture() = arch_spec;
400 
401     error.SetError(target_sp->Launch(launch_info, NULL));
402     sb_launch_info.set_ref(launch_info);
403     sb_process.SetSP(target_sp->GetProcessSP());
404   } else {
405     error.SetErrorString("SBTarget is invalid");
406   }
407 
408   log = lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API);
409   if (log)
410     log->Printf("SBTarget(%p)::Launch (...) => SBProcess(%p)",
411                 static_cast<void *>(target_sp.get()),
412                 static_cast<void *>(sb_process.GetSP().get()));
413 
414   return sb_process;
415 }
416 
417 lldb::SBProcess SBTarget::Attach(SBAttachInfo &sb_attach_info, SBError &error) {
418   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
419 
420   SBProcess sb_process;
421   TargetSP target_sp(GetSP());
422 
423   if (log)
424     log->Printf("SBTarget(%p)::Attach (sb_attach_info, error)...",
425                 static_cast<void *>(target_sp.get()));
426 
427   if (target_sp) {
428     ProcessAttachInfo &attach_info = sb_attach_info.ref();
429     if (attach_info.ProcessIDIsValid() && !attach_info.UserIDIsValid()) {
430       PlatformSP platform_sp = target_sp->GetPlatform();
431       // See if we can pre-verify if a process exists or not
432       if (platform_sp && platform_sp->IsConnected()) {
433         lldb::pid_t attach_pid = attach_info.GetProcessID();
434         ProcessInstanceInfo instance_info;
435         if (platform_sp->GetProcessInfo(attach_pid, instance_info)) {
436           attach_info.SetUserID(instance_info.GetEffectiveUserID());
437         } else {
438           error.ref().SetErrorStringWithFormat(
439               "no process found with process ID %" PRIu64, attach_pid);
440           if (log) {
441             log->Printf("SBTarget(%p)::Attach (...) => error %s",
442                         static_cast<void *>(target_sp.get()),
443                         error.GetCString());
444           }
445           return sb_process;
446         }
447       }
448     }
449     error.SetError(AttachToProcess(attach_info, *target_sp));
450     if (error.Success())
451       sb_process.SetSP(target_sp->GetProcessSP());
452   } else {
453     error.SetErrorString("SBTarget is invalid");
454   }
455 
456   if (log)
457     log->Printf("SBTarget(%p)::Attach (...) => SBProcess(%p)",
458                 static_cast<void *>(target_sp.get()),
459                 static_cast<void *>(sb_process.GetSP().get()));
460 
461   return sb_process;
462 }
463 
464 lldb::SBProcess SBTarget::AttachToProcessWithID(
465     SBListener &listener,
466     lldb::pid_t pid, // The process ID to attach to
467     SBError &error   // An error explaining what went wrong if attach fails
468     ) {
469   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
470 
471   SBProcess sb_process;
472   TargetSP target_sp(GetSP());
473 
474   if (log)
475     log->Printf("SBTarget(%p)::%s (listener, pid=%" PRId64 ", error)...",
476                 static_cast<void *>(target_sp.get()), __FUNCTION__, pid);
477 
478   if (target_sp) {
479     ProcessAttachInfo attach_info;
480     attach_info.SetProcessID(pid);
481     if (listener.IsValid())
482       attach_info.SetListener(listener.GetSP());
483 
484     ProcessInstanceInfo instance_info;
485     if (target_sp->GetPlatform()->GetProcessInfo(pid, instance_info))
486       attach_info.SetUserID(instance_info.GetEffectiveUserID());
487 
488     error.SetError(AttachToProcess(attach_info, *target_sp));
489     if (error.Success())
490       sb_process.SetSP(target_sp->GetProcessSP());
491   } else
492     error.SetErrorString("SBTarget is invalid");
493 
494   if (log)
495     log->Printf("SBTarget(%p)::%s (...) => SBProcess(%p)",
496                 static_cast<void *>(target_sp.get()), __FUNCTION__,
497                 static_cast<void *>(sb_process.GetSP().get()));
498   return sb_process;
499 }
500 
501 lldb::SBProcess SBTarget::AttachToProcessWithName(
502     SBListener &listener,
503     const char *name, // basename of process to attach to
504     bool wait_for, // if true wait for a new instance of "name" to be launched
505     SBError &error // An error explaining what went wrong if attach fails
506     ) {
507   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
508 
509   SBProcess sb_process;
510   TargetSP target_sp(GetSP());
511 
512   if (log)
513     log->Printf("SBTarget(%p)::%s (listener, name=%s, wait_for=%s, error)...",
514                 static_cast<void *>(target_sp.get()), __FUNCTION__, name,
515                 wait_for ? "true" : "false");
516 
517   if (name && target_sp) {
518     ProcessAttachInfo attach_info;
519     attach_info.GetExecutableFile().SetFile(name, false,
520                                             FileSpec::Style::native);
521     attach_info.SetWaitForLaunch(wait_for);
522     if (listener.IsValid())
523       attach_info.SetListener(listener.GetSP());
524 
525     error.SetError(AttachToProcess(attach_info, *target_sp));
526     if (error.Success())
527       sb_process.SetSP(target_sp->GetProcessSP());
528   } else
529     error.SetErrorString("SBTarget is invalid");
530 
531   if (log)
532     log->Printf("SBTarget(%p)::%s (...) => SBProcess(%p)",
533                 static_cast<void *>(target_sp.get()), __FUNCTION__,
534                 static_cast<void *>(sb_process.GetSP().get()));
535   return sb_process;
536 }
537 
538 lldb::SBProcess SBTarget::ConnectRemote(SBListener &listener, const char *url,
539                                         const char *plugin_name,
540                                         SBError &error) {
541   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
542 
543   SBProcess sb_process;
544   ProcessSP process_sp;
545   TargetSP target_sp(GetSP());
546 
547   if (log)
548     log->Printf("SBTarget(%p)::ConnectRemote (listener, url=%s, "
549                 "plugin_name=%s, error)...",
550                 static_cast<void *>(target_sp.get()), url, plugin_name);
551 
552   if (target_sp) {
553     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
554     if (listener.IsValid())
555       process_sp =
556           target_sp->CreateProcess(listener.m_opaque_sp, plugin_name, NULL);
557     else
558       process_sp = target_sp->CreateProcess(
559           target_sp->GetDebugger().GetListener(), plugin_name, NULL);
560 
561     if (process_sp) {
562       sb_process.SetSP(process_sp);
563       error.SetError(process_sp->ConnectRemote(NULL, url));
564     } else {
565       error.SetErrorString("unable to create lldb_private::Process");
566     }
567   } else {
568     error.SetErrorString("SBTarget is invalid");
569   }
570 
571   if (log)
572     log->Printf("SBTarget(%p)::ConnectRemote (...) => SBProcess(%p)",
573                 static_cast<void *>(target_sp.get()),
574                 static_cast<void *>(process_sp.get()));
575   return sb_process;
576 }
577 
578 SBFileSpec SBTarget::GetExecutable() {
579 
580   SBFileSpec exe_file_spec;
581   TargetSP target_sp(GetSP());
582   if (target_sp) {
583     Module *exe_module = target_sp->GetExecutableModulePointer();
584     if (exe_module)
585       exe_file_spec.SetFileSpec(exe_module->GetFileSpec());
586   }
587 
588   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
589   if (log) {
590     log->Printf("SBTarget(%p)::GetExecutable () => SBFileSpec(%p)",
591                 static_cast<void *>(target_sp.get()),
592                 static_cast<const void *>(exe_file_spec.get()));
593   }
594 
595   return exe_file_spec;
596 }
597 
598 bool SBTarget::operator==(const SBTarget &rhs) const {
599   return m_opaque_sp.get() == rhs.m_opaque_sp.get();
600 }
601 
602 bool SBTarget::operator!=(const SBTarget &rhs) const {
603   return m_opaque_sp.get() != rhs.m_opaque_sp.get();
604 }
605 
606 lldb::TargetSP SBTarget::GetSP() const { return m_opaque_sp; }
607 
608 void SBTarget::SetSP(const lldb::TargetSP &target_sp) {
609   m_opaque_sp = target_sp;
610 }
611 
612 lldb::SBAddress SBTarget::ResolveLoadAddress(lldb::addr_t vm_addr) {
613   lldb::SBAddress sb_addr;
614   Address &addr = sb_addr.ref();
615   TargetSP target_sp(GetSP());
616   if (target_sp) {
617     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
618     if (target_sp->ResolveLoadAddress(vm_addr, addr))
619       return sb_addr;
620   }
621 
622   // We have a load address that isn't in a section, just return an address
623   // with the offset filled in (the address) and the section set to NULL
624   addr.SetRawAddress(vm_addr);
625   return sb_addr;
626 }
627 
628 lldb::SBAddress SBTarget::ResolveFileAddress(lldb::addr_t file_addr) {
629   lldb::SBAddress sb_addr;
630   Address &addr = sb_addr.ref();
631   TargetSP target_sp(GetSP());
632   if (target_sp) {
633     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
634     if (target_sp->ResolveFileAddress(file_addr, addr))
635       return sb_addr;
636   }
637 
638   addr.SetRawAddress(file_addr);
639   return sb_addr;
640 }
641 
642 lldb::SBAddress SBTarget::ResolvePastLoadAddress(uint32_t stop_id,
643                                                  lldb::addr_t vm_addr) {
644   lldb::SBAddress sb_addr;
645   Address &addr = sb_addr.ref();
646   TargetSP target_sp(GetSP());
647   if (target_sp) {
648     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
649     if (target_sp->ResolveLoadAddress(vm_addr, addr))
650       return sb_addr;
651   }
652 
653   // We have a load address that isn't in a section, just return an address
654   // with the offset filled in (the address) and the section set to NULL
655   addr.SetRawAddress(vm_addr);
656   return sb_addr;
657 }
658 
659 SBSymbolContext
660 SBTarget::ResolveSymbolContextForAddress(const SBAddress &addr,
661                                          uint32_t resolve_scope) {
662   SBSymbolContext sc;
663   if (addr.IsValid()) {
664     TargetSP target_sp(GetSP());
665     if (target_sp)
666       target_sp->GetImages().ResolveSymbolContextForAddress(
667           addr.ref(), resolve_scope, sc.ref());
668   }
669   return sc;
670 }
671 
672 size_t SBTarget::ReadMemory(const SBAddress addr, void *buf, size_t size,
673                             lldb::SBError &error) {
674   SBError sb_error;
675   size_t bytes_read = 0;
676   TargetSP target_sp(GetSP());
677   if (target_sp) {
678     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
679     bytes_read =
680         target_sp->ReadMemory(addr.ref(), false, buf, size, sb_error.ref());
681   } else {
682     sb_error.SetErrorString("invalid target");
683   }
684 
685   return bytes_read;
686 }
687 
688 SBBreakpoint SBTarget::BreakpointCreateByLocation(const char *file,
689                                                   uint32_t line) {
690   return SBBreakpoint(
691       BreakpointCreateByLocation(SBFileSpec(file, false), line));
692 }
693 
694 SBBreakpoint
695 SBTarget::BreakpointCreateByLocation(const SBFileSpec &sb_file_spec,
696                                      uint32_t line) {
697   return BreakpointCreateByLocation(sb_file_spec, line, 0);
698 }
699 
700 SBBreakpoint
701 SBTarget::BreakpointCreateByLocation(const SBFileSpec &sb_file_spec,
702                                      uint32_t line, lldb::addr_t offset) {
703   SBFileSpecList empty_list;
704   return BreakpointCreateByLocation(sb_file_spec, line, offset, empty_list);
705 }
706 
707 SBBreakpoint
708 SBTarget::BreakpointCreateByLocation(const SBFileSpec &sb_file_spec,
709                                      uint32_t line, lldb::addr_t offset,
710                                      SBFileSpecList &sb_module_list) {
711   return BreakpointCreateByLocation(sb_file_spec, line, 0, offset,
712                                     sb_module_list);
713 }
714 
715 SBBreakpoint SBTarget::BreakpointCreateByLocation(
716     const SBFileSpec &sb_file_spec, uint32_t line, uint32_t column,
717     lldb::addr_t offset, SBFileSpecList &sb_module_list) {
718   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
719 
720   SBBreakpoint sb_bp;
721   TargetSP target_sp(GetSP());
722   if (target_sp && line != 0) {
723     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
724 
725     const LazyBool check_inlines = eLazyBoolCalculate;
726     const LazyBool skip_prologue = eLazyBoolCalculate;
727     const bool internal = false;
728     const bool hardware = false;
729     const LazyBool move_to_nearest_code = eLazyBoolCalculate;
730     const FileSpecList *module_list = nullptr;
731     if (sb_module_list.GetSize() > 0) {
732       module_list = sb_module_list.get();
733     }
734     sb_bp = target_sp->CreateBreakpoint(
735         module_list, *sb_file_spec, line, column, offset, check_inlines,
736         skip_prologue, internal, hardware, move_to_nearest_code);
737   }
738 
739   if (log) {
740     SBStream sstr;
741     sb_bp.GetDescription(sstr);
742     char path[PATH_MAX];
743     sb_file_spec->GetPath(path, sizeof(path));
744     log->Printf("SBTarget(%p)::BreakpointCreateByLocation ( %s:%u ) => "
745                 "SBBreakpoint(%p): %s",
746                 static_cast<void *>(target_sp.get()), path, line,
747                 static_cast<void *>(sb_bp.GetSP().get()), sstr.GetData());
748   }
749 
750   return sb_bp;
751 }
752 
753 SBBreakpoint SBTarget::BreakpointCreateByName(const char *symbol_name,
754                                               const char *module_name) {
755   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
756 
757   SBBreakpoint sb_bp;
758   TargetSP target_sp(GetSP());
759   if (target_sp.get()) {
760     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
761 
762     const bool internal = false;
763     const bool hardware = false;
764     const LazyBool skip_prologue = eLazyBoolCalculate;
765     const lldb::addr_t offset = 0;
766     if (module_name && module_name[0]) {
767       FileSpecList module_spec_list;
768       module_spec_list.Append(FileSpec(module_name, false));
769       sb_bp = target_sp->CreateBreakpoint(
770           &module_spec_list, NULL, symbol_name, eFunctionNameTypeAuto,
771           eLanguageTypeUnknown, offset, skip_prologue, internal, hardware);
772     } else {
773       sb_bp = target_sp->CreateBreakpoint(
774           NULL, NULL, symbol_name, eFunctionNameTypeAuto, eLanguageTypeUnknown,
775           offset, skip_prologue, internal, hardware);
776     }
777   }
778 
779   if (log)
780     log->Printf("SBTarget(%p)::BreakpointCreateByName (symbol=\"%s\", "
781                 "module=\"%s\") => SBBreakpoint(%p)",
782                 static_cast<void *>(target_sp.get()), symbol_name, module_name,
783                 static_cast<void *>(sb_bp.GetSP().get()));
784 
785   return sb_bp;
786 }
787 
788 lldb::SBBreakpoint
789 SBTarget::BreakpointCreateByName(const char *symbol_name,
790                                  const SBFileSpecList &module_list,
791                                  const SBFileSpecList &comp_unit_list) {
792   uint32_t name_type_mask = eFunctionNameTypeAuto;
793   return BreakpointCreateByName(symbol_name, name_type_mask,
794                                 eLanguageTypeUnknown, module_list,
795                                 comp_unit_list);
796 }
797 
798 lldb::SBBreakpoint SBTarget::BreakpointCreateByName(
799     const char *symbol_name, uint32_t name_type_mask,
800     const SBFileSpecList &module_list, const SBFileSpecList &comp_unit_list) {
801   return BreakpointCreateByName(symbol_name, name_type_mask,
802                                 eLanguageTypeUnknown, module_list,
803                                 comp_unit_list);
804 }
805 
806 lldb::SBBreakpoint SBTarget::BreakpointCreateByName(
807     const char *symbol_name, uint32_t name_type_mask,
808     LanguageType symbol_language, const SBFileSpecList &module_list,
809     const SBFileSpecList &comp_unit_list) {
810   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
811 
812   SBBreakpoint sb_bp;
813   TargetSP target_sp(GetSP());
814   if (target_sp && symbol_name && symbol_name[0]) {
815     const bool internal = false;
816     const bool hardware = false;
817     const LazyBool skip_prologue = eLazyBoolCalculate;
818     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
819     sb_bp = target_sp->CreateBreakpoint(
820         module_list.get(), comp_unit_list.get(), symbol_name, name_type_mask,
821         symbol_language, 0, skip_prologue, internal, hardware);
822   }
823 
824   if (log)
825     log->Printf("SBTarget(%p)::BreakpointCreateByName (symbol=\"%s\", "
826                 "name_type: %d) => SBBreakpoint(%p)",
827                 static_cast<void *>(target_sp.get()), symbol_name,
828                 name_type_mask, static_cast<void *>(sb_bp.GetSP().get()));
829 
830   return sb_bp;
831 }
832 
833 lldb::SBBreakpoint SBTarget::BreakpointCreateByNames(
834     const char *symbol_names[], uint32_t num_names, uint32_t name_type_mask,
835     const SBFileSpecList &module_list, const SBFileSpecList &comp_unit_list) {
836   return BreakpointCreateByNames(symbol_names, num_names, name_type_mask,
837                                  eLanguageTypeUnknown, module_list,
838                                  comp_unit_list);
839 }
840 
841 lldb::SBBreakpoint SBTarget::BreakpointCreateByNames(
842     const char *symbol_names[], uint32_t num_names, uint32_t name_type_mask,
843     LanguageType symbol_language, const SBFileSpecList &module_list,
844     const SBFileSpecList &comp_unit_list) {
845   return BreakpointCreateByNames(symbol_names, num_names, name_type_mask,
846                                  eLanguageTypeUnknown, 0, module_list,
847                                  comp_unit_list);
848 }
849 
850 lldb::SBBreakpoint SBTarget::BreakpointCreateByNames(
851     const char *symbol_names[], uint32_t num_names, uint32_t name_type_mask,
852     LanguageType symbol_language, lldb::addr_t offset,
853     const SBFileSpecList &module_list, const SBFileSpecList &comp_unit_list) {
854   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
855 
856   SBBreakpoint sb_bp;
857   TargetSP target_sp(GetSP());
858   if (target_sp && num_names > 0) {
859     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
860     const bool internal = false;
861     const bool hardware = false;
862     const LazyBool skip_prologue = eLazyBoolCalculate;
863     sb_bp = target_sp->CreateBreakpoint(
864         module_list.get(), comp_unit_list.get(), symbol_names, num_names,
865         name_type_mask, symbol_language, offset, skip_prologue, internal,
866         hardware);
867   }
868 
869   if (log) {
870     log->Printf("SBTarget(%p)::BreakpointCreateByName (symbols={",
871                 static_cast<void *>(target_sp.get()));
872     for (uint32_t i = 0; i < num_names; i++) {
873       char sep;
874       if (i < num_names - 1)
875         sep = ',';
876       else
877         sep = '}';
878       if (symbol_names[i] != NULL)
879         log->Printf("\"%s\"%c ", symbol_names[i], sep);
880       else
881         log->Printf("\"<NULL>\"%c ", sep);
882     }
883     log->Printf("name_type: %d) => SBBreakpoint(%p)", name_type_mask,
884                 static_cast<void *>(sb_bp.GetSP().get()));
885   }
886 
887   return sb_bp;
888 }
889 
890 SBBreakpoint SBTarget::BreakpointCreateByRegex(const char *symbol_name_regex,
891                                                const char *module_name) {
892   SBFileSpecList module_spec_list;
893   SBFileSpecList comp_unit_list;
894   if (module_name && module_name[0]) {
895     module_spec_list.Append(FileSpec(module_name, false));
896   }
897   return BreakpointCreateByRegex(symbol_name_regex, eLanguageTypeUnknown,
898                                  module_spec_list, comp_unit_list);
899 }
900 
901 lldb::SBBreakpoint
902 SBTarget::BreakpointCreateByRegex(const char *symbol_name_regex,
903                                   const SBFileSpecList &module_list,
904                                   const SBFileSpecList &comp_unit_list) {
905   return BreakpointCreateByRegex(symbol_name_regex, eLanguageTypeUnknown,
906                                  module_list, comp_unit_list);
907 }
908 
909 lldb::SBBreakpoint SBTarget::BreakpointCreateByRegex(
910     const char *symbol_name_regex, LanguageType symbol_language,
911     const SBFileSpecList &module_list, const SBFileSpecList &comp_unit_list) {
912   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
913 
914   SBBreakpoint sb_bp;
915   TargetSP target_sp(GetSP());
916   if (target_sp && symbol_name_regex && symbol_name_regex[0]) {
917     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
918     RegularExpression regexp((llvm::StringRef(symbol_name_regex)));
919     const bool internal = false;
920     const bool hardware = false;
921     const LazyBool skip_prologue = eLazyBoolCalculate;
922 
923     sb_bp = target_sp->CreateFuncRegexBreakpoint(
924         module_list.get(), comp_unit_list.get(), regexp, symbol_language,
925         skip_prologue, internal, hardware);
926   }
927 
928   if (log)
929     log->Printf("SBTarget(%p)::BreakpointCreateByRegex (symbol_regex=\"%s\") "
930                 "=> SBBreakpoint(%p)",
931                 static_cast<void *>(target_sp.get()), symbol_name_regex,
932                 static_cast<void *>(sb_bp.GetSP().get()));
933 
934   return sb_bp;
935 }
936 
937 SBBreakpoint SBTarget::BreakpointCreateByAddress(addr_t address) {
938   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
939 
940   SBBreakpoint sb_bp;
941   TargetSP target_sp(GetSP());
942   if (target_sp) {
943     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
944     const bool hardware = false;
945     sb_bp = target_sp->CreateBreakpoint(address, false, hardware);
946   }
947 
948   if (log)
949     log->Printf("SBTarget(%p)::BreakpointCreateByAddress (address=%" PRIu64
950                 ") => SBBreakpoint(%p)",
951                 static_cast<void *>(target_sp.get()),
952                 static_cast<uint64_t>(address),
953                 static_cast<void *>(sb_bp.GetSP().get()));
954 
955   return sb_bp;
956 }
957 
958 SBBreakpoint SBTarget::BreakpointCreateBySBAddress(SBAddress &sb_address) {
959   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
960 
961   SBBreakpoint sb_bp;
962   TargetSP target_sp(GetSP());
963   if (!sb_address.IsValid()) {
964     if (log)
965       log->Printf("SBTarget(%p)::BreakpointCreateBySBAddress called with "
966                   "invalid address",
967                   static_cast<void *>(target_sp.get()));
968     return sb_bp;
969   }
970 
971   if (target_sp) {
972     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
973     const bool hardware = false;
974     sb_bp = target_sp->CreateBreakpoint(sb_address.ref(), false, hardware);
975   }
976 
977   if (log) {
978     SBStream s;
979     sb_address.GetDescription(s);
980     log->Printf("SBTarget(%p)::BreakpointCreateBySBAddress (address=%s) => "
981                 "SBBreakpoint(%p)",
982                 static_cast<void *>(target_sp.get()), s.GetData(),
983                 static_cast<void *>(sb_bp.GetSP().get()));
984   }
985 
986   return sb_bp;
987 }
988 
989 lldb::SBBreakpoint
990 SBTarget::BreakpointCreateBySourceRegex(const char *source_regex,
991                                         const lldb::SBFileSpec &source_file,
992                                         const char *module_name) {
993   SBFileSpecList module_spec_list;
994 
995   if (module_name && module_name[0]) {
996     module_spec_list.Append(FileSpec(module_name, false));
997   }
998 
999   SBFileSpecList source_file_list;
1000   if (source_file.IsValid()) {
1001     source_file_list.Append(source_file);
1002   }
1003 
1004   return BreakpointCreateBySourceRegex(source_regex, module_spec_list,
1005                                        source_file_list);
1006 }
1007 
1008 lldb::SBBreakpoint SBTarget::BreakpointCreateBySourceRegex(
1009     const char *source_regex, const SBFileSpecList &module_list,
1010     const lldb::SBFileSpecList &source_file_list) {
1011   return BreakpointCreateBySourceRegex(source_regex, module_list,
1012                                        source_file_list, SBStringList());
1013 }
1014 
1015 lldb::SBBreakpoint SBTarget::BreakpointCreateBySourceRegex(
1016     const char *source_regex, const SBFileSpecList &module_list,
1017     const lldb::SBFileSpecList &source_file_list,
1018     const SBStringList &func_names) {
1019   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1020 
1021   SBBreakpoint sb_bp;
1022   TargetSP target_sp(GetSP());
1023   if (target_sp && source_regex && source_regex[0]) {
1024     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1025     const bool hardware = false;
1026     const LazyBool move_to_nearest_code = eLazyBoolCalculate;
1027     RegularExpression regexp((llvm::StringRef(source_regex)));
1028     std::unordered_set<std::string> func_names_set;
1029     for (size_t i = 0; i < func_names.GetSize(); i++) {
1030       func_names_set.insert(func_names.GetStringAtIndex(i));
1031     }
1032 
1033     sb_bp = target_sp->CreateSourceRegexBreakpoint(
1034         module_list.get(), source_file_list.get(), func_names_set, regexp,
1035         false, hardware, move_to_nearest_code);
1036   }
1037 
1038   if (log)
1039     log->Printf("SBTarget(%p)::BreakpointCreateByRegex (source_regex=\"%s\") "
1040                 "=> SBBreakpoint(%p)",
1041                 static_cast<void *>(target_sp.get()), source_regex,
1042                 static_cast<void *>(sb_bp.GetSP().get()));
1043 
1044   return sb_bp;
1045 }
1046 
1047 lldb::SBBreakpoint
1048 SBTarget::BreakpointCreateForException(lldb::LanguageType language,
1049                                        bool catch_bp, bool throw_bp) {
1050   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1051 
1052   SBBreakpoint sb_bp;
1053   TargetSP target_sp(GetSP());
1054   if (target_sp) {
1055     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1056     const bool hardware = false;
1057     sb_bp = target_sp->CreateExceptionBreakpoint(language, catch_bp, throw_bp,
1058                                                   hardware);
1059   }
1060 
1061   if (log)
1062     log->Printf("SBTarget(%p)::BreakpointCreateForException (Language: %s, catch: "
1063                 "%s throw: %s) => SBBreakpoint(%p)",
1064                 static_cast<void *>(target_sp.get()),
1065                 Language::GetNameForLanguageType(language),
1066                 catch_bp ? "on" : "off", throw_bp ? "on" : "off",
1067                 static_cast<void *>(sb_bp.GetSP().get()));
1068 
1069   return sb_bp;
1070 }
1071 
1072 lldb::SBBreakpoint
1073 SBTarget::BreakpointCreateFromScript(const char *class_name,
1074                                      SBStructuredData &extra_args,
1075                                      const SBFileSpecList &module_list,
1076                                      const SBFileSpecList &file_list,
1077                                      bool request_hardware)
1078 {
1079   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1080 
1081   SBBreakpoint sb_bp;
1082   TargetSP target_sp(GetSP());
1083   if (target_sp) {
1084     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1085     Status error;
1086 
1087     StructuredData::ObjectSP obj_sp = extra_args.m_impl_up->GetObjectSP();
1088     sb_bp =
1089         target_sp->CreateScriptedBreakpoint(class_name,
1090                                             module_list.get(),
1091                                             file_list.get(),
1092                                             false, /* internal */
1093                                             request_hardware,
1094                                             obj_sp,
1095                                             &error);
1096   }
1097   if (log)
1098     log->Printf("SBTarget(%p)::BreakpointCreateFromScript (class name: %s) "
1099                 " => SBBreakpoint(%p)",
1100                 static_cast<void *>(target_sp.get()),
1101                 class_name,
1102                 static_cast<void *>(sb_bp.GetSP().get()));
1103 
1104   return sb_bp;
1105 }
1106 
1107 
1108 uint32_t SBTarget::GetNumBreakpoints() const {
1109   TargetSP target_sp(GetSP());
1110   if (target_sp) {
1111     // The breakpoint list is thread safe, no need to lock
1112     return target_sp->GetBreakpointList().GetSize();
1113   }
1114   return 0;
1115 }
1116 
1117 SBBreakpoint SBTarget::GetBreakpointAtIndex(uint32_t idx) const {
1118   SBBreakpoint sb_breakpoint;
1119   TargetSP target_sp(GetSP());
1120   if (target_sp) {
1121     // The breakpoint list is thread safe, no need to lock
1122     sb_breakpoint = target_sp->GetBreakpointList().GetBreakpointAtIndex(idx);
1123   }
1124   return sb_breakpoint;
1125 }
1126 
1127 bool SBTarget::BreakpointDelete(break_id_t bp_id) {
1128   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1129 
1130   bool result = false;
1131   TargetSP target_sp(GetSP());
1132   if (target_sp) {
1133     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1134     result = target_sp->RemoveBreakpointByID(bp_id);
1135   }
1136 
1137   if (log)
1138     log->Printf("SBTarget(%p)::BreakpointDelete (bp_id=%d) => %i",
1139                 static_cast<void *>(target_sp.get()),
1140                 static_cast<uint32_t>(bp_id), result);
1141 
1142   return result;
1143 }
1144 
1145 SBBreakpoint SBTarget::FindBreakpointByID(break_id_t bp_id) {
1146   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1147 
1148   SBBreakpoint sb_breakpoint;
1149   TargetSP target_sp(GetSP());
1150   if (target_sp && bp_id != LLDB_INVALID_BREAK_ID) {
1151     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1152     sb_breakpoint = target_sp->GetBreakpointByID(bp_id);
1153   }
1154 
1155   if (log)
1156     log->Printf(
1157         "SBTarget(%p)::FindBreakpointByID (bp_id=%d) => SBBreakpoint(%p)",
1158         static_cast<void *>(target_sp.get()), static_cast<uint32_t>(bp_id),
1159         static_cast<void *>(sb_breakpoint.GetSP().get()));
1160 
1161   return sb_breakpoint;
1162 }
1163 
1164 bool SBTarget::FindBreakpointsByName(const char *name,
1165                                      SBBreakpointList &bkpts) {
1166   TargetSP target_sp(GetSP());
1167   if (target_sp) {
1168     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1169     BreakpointList bkpt_list(false);
1170     bool is_valid =
1171         target_sp->GetBreakpointList().FindBreakpointsByName(name, bkpt_list);
1172     if (!is_valid)
1173       return false;
1174     for (BreakpointSP bkpt_sp : bkpt_list.Breakpoints()) {
1175       bkpts.AppendByID(bkpt_sp->GetID());
1176     }
1177   }
1178   return true;
1179 }
1180 
1181 void SBTarget::GetBreakpointNames(SBStringList &names)
1182 {
1183   names.Clear();
1184 
1185   TargetSP target_sp(GetSP());
1186   if (target_sp) {
1187     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1188 
1189     std::vector<std::string> name_vec;
1190     target_sp->GetBreakpointNames(name_vec);
1191     for (auto name : name_vec)
1192       names.AppendString(name.c_str());
1193   }
1194 }
1195 
1196 void SBTarget::DeleteBreakpointName(const char *name)
1197 {
1198   TargetSP target_sp(GetSP());
1199   if (target_sp) {
1200     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1201     target_sp->DeleteBreakpointName(ConstString(name));
1202   }
1203 }
1204 
1205 bool SBTarget::EnableAllBreakpoints() {
1206   TargetSP target_sp(GetSP());
1207   if (target_sp) {
1208     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1209     target_sp->EnableAllowedBreakpoints();
1210     return true;
1211   }
1212   return false;
1213 }
1214 
1215 bool SBTarget::DisableAllBreakpoints() {
1216   TargetSP target_sp(GetSP());
1217   if (target_sp) {
1218     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1219     target_sp->DisableAllowedBreakpoints();
1220     return true;
1221   }
1222   return false;
1223 }
1224 
1225 bool SBTarget::DeleteAllBreakpoints() {
1226   TargetSP target_sp(GetSP());
1227   if (target_sp) {
1228     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1229     target_sp->RemoveAllowedBreakpoints();
1230     return true;
1231   }
1232   return false;
1233 }
1234 
1235 lldb::SBError SBTarget::BreakpointsCreateFromFile(SBFileSpec &source_file,
1236                                                   SBBreakpointList &new_bps) {
1237   SBStringList empty_name_list;
1238   return BreakpointsCreateFromFile(source_file, empty_name_list, new_bps);
1239 }
1240 
1241 lldb::SBError SBTarget::BreakpointsCreateFromFile(SBFileSpec &source_file,
1242                                                   SBStringList &matching_names,
1243                                                   SBBreakpointList &new_bps) {
1244   SBError sberr;
1245   TargetSP target_sp(GetSP());
1246   if (!target_sp) {
1247     sberr.SetErrorString(
1248         "BreakpointCreateFromFile called with invalid target.");
1249     return sberr;
1250   }
1251   std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1252 
1253   BreakpointIDList bp_ids;
1254 
1255   std::vector<std::string> name_vector;
1256   size_t num_names = matching_names.GetSize();
1257   for (size_t i = 0; i < num_names; i++)
1258     name_vector.push_back(matching_names.GetStringAtIndex(i));
1259 
1260   sberr.ref() = target_sp->CreateBreakpointsFromFile(source_file.ref(),
1261                                                      name_vector, bp_ids);
1262   if (sberr.Fail())
1263     return sberr;
1264 
1265   size_t num_bkpts = bp_ids.GetSize();
1266   for (size_t i = 0; i < num_bkpts; i++) {
1267     BreakpointID bp_id = bp_ids.GetBreakpointIDAtIndex(i);
1268     new_bps.AppendByID(bp_id.GetBreakpointID());
1269   }
1270   return sberr;
1271 }
1272 
1273 lldb::SBError SBTarget::BreakpointsWriteToFile(SBFileSpec &dest_file) {
1274   SBError sberr;
1275   TargetSP target_sp(GetSP());
1276   if (!target_sp) {
1277     sberr.SetErrorString("BreakpointWriteToFile called with invalid target.");
1278     return sberr;
1279   }
1280   SBBreakpointList bkpt_list(*this);
1281   return BreakpointsWriteToFile(dest_file, bkpt_list);
1282 }
1283 
1284 lldb::SBError SBTarget::BreakpointsWriteToFile(SBFileSpec &dest_file,
1285                                                SBBreakpointList &bkpt_list,
1286                                                bool append) {
1287   SBError sberr;
1288   TargetSP target_sp(GetSP());
1289   if (!target_sp) {
1290     sberr.SetErrorString("BreakpointWriteToFile called with invalid target.");
1291     return sberr;
1292   }
1293 
1294   std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1295   BreakpointIDList bp_id_list;
1296   bkpt_list.CopyToBreakpointIDList(bp_id_list);
1297   sberr.ref() = target_sp->SerializeBreakpointsToFile(dest_file.ref(),
1298                                                       bp_id_list, append);
1299   return sberr;
1300 }
1301 
1302 uint32_t SBTarget::GetNumWatchpoints() const {
1303   TargetSP target_sp(GetSP());
1304   if (target_sp) {
1305     // The watchpoint list is thread safe, no need to lock
1306     return target_sp->GetWatchpointList().GetSize();
1307   }
1308   return 0;
1309 }
1310 
1311 SBWatchpoint SBTarget::GetWatchpointAtIndex(uint32_t idx) const {
1312   SBWatchpoint sb_watchpoint;
1313   TargetSP target_sp(GetSP());
1314   if (target_sp) {
1315     // The watchpoint list is thread safe, no need to lock
1316     sb_watchpoint.SetSP(target_sp->GetWatchpointList().GetByIndex(idx));
1317   }
1318   return sb_watchpoint;
1319 }
1320 
1321 bool SBTarget::DeleteWatchpoint(watch_id_t wp_id) {
1322   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1323 
1324   bool result = false;
1325   TargetSP target_sp(GetSP());
1326   if (target_sp) {
1327     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1328     std::unique_lock<std::recursive_mutex> lock;
1329     target_sp->GetWatchpointList().GetListMutex(lock);
1330     result = target_sp->RemoveWatchpointByID(wp_id);
1331   }
1332 
1333   if (log)
1334     log->Printf("SBTarget(%p)::WatchpointDelete (wp_id=%d) => %i",
1335                 static_cast<void *>(target_sp.get()),
1336                 static_cast<uint32_t>(wp_id), result);
1337 
1338   return result;
1339 }
1340 
1341 SBWatchpoint SBTarget::FindWatchpointByID(lldb::watch_id_t wp_id) {
1342   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1343 
1344   SBWatchpoint sb_watchpoint;
1345   lldb::WatchpointSP watchpoint_sp;
1346   TargetSP target_sp(GetSP());
1347   if (target_sp && wp_id != LLDB_INVALID_WATCH_ID) {
1348     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1349     std::unique_lock<std::recursive_mutex> lock;
1350     target_sp->GetWatchpointList().GetListMutex(lock);
1351     watchpoint_sp = target_sp->GetWatchpointList().FindByID(wp_id);
1352     sb_watchpoint.SetSP(watchpoint_sp);
1353   }
1354 
1355   if (log)
1356     log->Printf(
1357         "SBTarget(%p)::FindWatchpointByID (bp_id=%d) => SBWatchpoint(%p)",
1358         static_cast<void *>(target_sp.get()), static_cast<uint32_t>(wp_id),
1359         static_cast<void *>(watchpoint_sp.get()));
1360 
1361   return sb_watchpoint;
1362 }
1363 
1364 lldb::SBWatchpoint SBTarget::WatchAddress(lldb::addr_t addr, size_t size,
1365                                           bool read, bool write,
1366                                           SBError &error) {
1367   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1368 
1369   SBWatchpoint sb_watchpoint;
1370   lldb::WatchpointSP watchpoint_sp;
1371   TargetSP target_sp(GetSP());
1372   if (target_sp && (read || write) && addr != LLDB_INVALID_ADDRESS &&
1373       size > 0) {
1374     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1375     uint32_t watch_type = 0;
1376     if (read)
1377       watch_type |= LLDB_WATCH_TYPE_READ;
1378     if (write)
1379       watch_type |= LLDB_WATCH_TYPE_WRITE;
1380     if (watch_type == 0) {
1381       error.SetErrorString(
1382           "Can't create a watchpoint that is neither read nor write.");
1383       return sb_watchpoint;
1384     }
1385 
1386     // Target::CreateWatchpoint() is thread safe.
1387     Status cw_error;
1388     // This API doesn't take in a type, so we can't figure out what it is.
1389     CompilerType *type = NULL;
1390     watchpoint_sp =
1391         target_sp->CreateWatchpoint(addr, size, type, watch_type, cw_error);
1392     error.SetError(cw_error);
1393     sb_watchpoint.SetSP(watchpoint_sp);
1394   }
1395 
1396   if (log)
1397     log->Printf("SBTarget(%p)::WatchAddress (addr=0x%" PRIx64
1398                 ", 0x%u) => SBWatchpoint(%p)",
1399                 static_cast<void *>(target_sp.get()), addr,
1400                 static_cast<uint32_t>(size),
1401                 static_cast<void *>(watchpoint_sp.get()));
1402 
1403   return sb_watchpoint;
1404 }
1405 
1406 bool SBTarget::EnableAllWatchpoints() {
1407   TargetSP target_sp(GetSP());
1408   if (target_sp) {
1409     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1410     std::unique_lock<std::recursive_mutex> lock;
1411     target_sp->GetWatchpointList().GetListMutex(lock);
1412     target_sp->EnableAllWatchpoints();
1413     return true;
1414   }
1415   return false;
1416 }
1417 
1418 bool SBTarget::DisableAllWatchpoints() {
1419   TargetSP target_sp(GetSP());
1420   if (target_sp) {
1421     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1422     std::unique_lock<std::recursive_mutex> lock;
1423     target_sp->GetWatchpointList().GetListMutex(lock);
1424     target_sp->DisableAllWatchpoints();
1425     return true;
1426   }
1427   return false;
1428 }
1429 
1430 SBValue SBTarget::CreateValueFromAddress(const char *name, SBAddress addr,
1431                                          SBType type) {
1432   SBValue sb_value;
1433   lldb::ValueObjectSP new_value_sp;
1434   if (IsValid() && name && *name && addr.IsValid() && type.IsValid()) {
1435     lldb::addr_t load_addr(addr.GetLoadAddress(*this));
1436     ExecutionContext exe_ctx(
1437         ExecutionContextRef(ExecutionContext(m_opaque_sp.get(), false)));
1438     CompilerType ast_type(type.GetSP()->GetCompilerType(true));
1439     new_value_sp = ValueObject::CreateValueObjectFromAddress(name, load_addr,
1440                                                              exe_ctx, ast_type);
1441   }
1442   sb_value.SetSP(new_value_sp);
1443   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1444   if (log) {
1445     if (new_value_sp)
1446       log->Printf("SBTarget(%p)::CreateValueFromAddress => \"%s\"",
1447                   static_cast<void *>(m_opaque_sp.get()),
1448                   new_value_sp->GetName().AsCString());
1449     else
1450       log->Printf("SBTarget(%p)::CreateValueFromAddress => NULL",
1451                   static_cast<void *>(m_opaque_sp.get()));
1452   }
1453   return sb_value;
1454 }
1455 
1456 lldb::SBValue SBTarget::CreateValueFromData(const char *name, lldb::SBData data,
1457                                             lldb::SBType type) {
1458   SBValue sb_value;
1459   lldb::ValueObjectSP new_value_sp;
1460   if (IsValid() && name && *name && data.IsValid() && type.IsValid()) {
1461     DataExtractorSP extractor(*data);
1462     ExecutionContext exe_ctx(
1463         ExecutionContextRef(ExecutionContext(m_opaque_sp.get(), false)));
1464     CompilerType ast_type(type.GetSP()->GetCompilerType(true));
1465     new_value_sp = ValueObject::CreateValueObjectFromData(name, *extractor,
1466                                                           exe_ctx, ast_type);
1467   }
1468   sb_value.SetSP(new_value_sp);
1469   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1470   if (log) {
1471     if (new_value_sp)
1472       log->Printf("SBTarget(%p)::CreateValueFromData => \"%s\"",
1473                   static_cast<void *>(m_opaque_sp.get()),
1474                   new_value_sp->GetName().AsCString());
1475     else
1476       log->Printf("SBTarget(%p)::CreateValueFromData => NULL",
1477                   static_cast<void *>(m_opaque_sp.get()));
1478   }
1479   return sb_value;
1480 }
1481 
1482 lldb::SBValue SBTarget::CreateValueFromExpression(const char *name,
1483                                                   const char *expr) {
1484   SBValue sb_value;
1485   lldb::ValueObjectSP new_value_sp;
1486   if (IsValid() && name && *name && expr && *expr) {
1487     ExecutionContext exe_ctx(
1488         ExecutionContextRef(ExecutionContext(m_opaque_sp.get(), false)));
1489     new_value_sp =
1490         ValueObject::CreateValueObjectFromExpression(name, expr, exe_ctx);
1491   }
1492   sb_value.SetSP(new_value_sp);
1493   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1494   if (log) {
1495     if (new_value_sp)
1496       log->Printf("SBTarget(%p)::CreateValueFromExpression => \"%s\"",
1497                   static_cast<void *>(m_opaque_sp.get()),
1498                   new_value_sp->GetName().AsCString());
1499     else
1500       log->Printf("SBTarget(%p)::CreateValueFromExpression => NULL",
1501                   static_cast<void *>(m_opaque_sp.get()));
1502   }
1503   return sb_value;
1504 }
1505 
1506 bool SBTarget::DeleteAllWatchpoints() {
1507   TargetSP target_sp(GetSP());
1508   if (target_sp) {
1509     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
1510     std::unique_lock<std::recursive_mutex> lock;
1511     target_sp->GetWatchpointList().GetListMutex(lock);
1512     target_sp->RemoveAllWatchpoints();
1513     return true;
1514   }
1515   return false;
1516 }
1517 
1518 void SBTarget::AppendImageSearchPath(const char *from, const char *to,
1519                                      lldb::SBError &error) {
1520   TargetSP target_sp(GetSP());
1521   if (!target_sp)
1522     return error.SetErrorString("invalid target");
1523 
1524   const ConstString csFrom(from), csTo(to);
1525   if (!csFrom)
1526     return error.SetErrorString("<from> path can't be empty");
1527   if (!csTo)
1528     return error.SetErrorString("<to> path can't be empty");
1529 
1530   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1531   if (log)
1532     log->Printf("SBTarget(%p)::%s: '%s' -> '%s'",
1533                 static_cast<void *>(target_sp.get()),  __FUNCTION__,
1534                 from, to);
1535   target_sp->GetImageSearchPathList().Append(csFrom, csTo, true);
1536 }
1537 
1538 lldb::SBModule SBTarget::AddModule(const char *path, const char *triple,
1539                                    const char *uuid_cstr) {
1540   return AddModule(path, triple, uuid_cstr, NULL);
1541 }
1542 
1543 lldb::SBModule SBTarget::AddModule(const char *path, const char *triple,
1544                                    const char *uuid_cstr, const char *symfile) {
1545   lldb::SBModule sb_module;
1546   TargetSP target_sp(GetSP());
1547   if (target_sp) {
1548     ModuleSpec module_spec;
1549     if (path)
1550       module_spec.GetFileSpec().SetFile(path, false, FileSpec::Style::native);
1551 
1552     if (uuid_cstr)
1553       module_spec.GetUUID().SetFromStringRef(uuid_cstr);
1554 
1555     if (triple)
1556       module_spec.GetArchitecture() = Platform::GetAugmentedArchSpec(
1557           target_sp->GetPlatform().get(), triple);
1558     else
1559       module_spec.GetArchitecture() = target_sp->GetArchitecture();
1560 
1561     if (symfile)
1562       module_spec.GetSymbolFileSpec().SetFile(symfile, false,
1563                                               FileSpec::Style::native);
1564 
1565     sb_module.SetSP(target_sp->GetSharedModule(module_spec));
1566   }
1567   return sb_module;
1568 }
1569 
1570 lldb::SBModule SBTarget::AddModule(const SBModuleSpec &module_spec) {
1571   lldb::SBModule sb_module;
1572   TargetSP target_sp(GetSP());
1573   if (target_sp)
1574     sb_module.SetSP(target_sp->GetSharedModule(*module_spec.m_opaque_ap));
1575   return sb_module;
1576 }
1577 
1578 bool SBTarget::AddModule(lldb::SBModule &module) {
1579   TargetSP target_sp(GetSP());
1580   if (target_sp) {
1581     target_sp->GetImages().AppendIfNeeded(module.GetSP());
1582     return true;
1583   }
1584   return false;
1585 }
1586 
1587 uint32_t SBTarget::GetNumModules() const {
1588   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1589 
1590   uint32_t num = 0;
1591   TargetSP target_sp(GetSP());
1592   if (target_sp) {
1593     // The module list is thread safe, no need to lock
1594     num = target_sp->GetImages().GetSize();
1595   }
1596 
1597   if (log)
1598     log->Printf("SBTarget(%p)::GetNumModules () => %d",
1599                 static_cast<void *>(target_sp.get()), num);
1600 
1601   return num;
1602 }
1603 
1604 void SBTarget::Clear() {
1605   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1606 
1607   if (log)
1608     log->Printf("SBTarget(%p)::Clear ()",
1609                 static_cast<void *>(m_opaque_sp.get()));
1610 
1611   m_opaque_sp.reset();
1612 }
1613 
1614 SBModule SBTarget::FindModule(const SBFileSpec &sb_file_spec) {
1615   SBModule sb_module;
1616   TargetSP target_sp(GetSP());
1617   if (target_sp && sb_file_spec.IsValid()) {
1618     ModuleSpec module_spec(*sb_file_spec);
1619     // The module list is thread safe, no need to lock
1620     sb_module.SetSP(target_sp->GetImages().FindFirstModule(module_spec));
1621   }
1622   return sb_module;
1623 }
1624 
1625 SBSymbolContextList
1626 SBTarget::FindCompileUnits(const SBFileSpec &sb_file_spec) {
1627   SBSymbolContextList sb_sc_list;
1628   const TargetSP target_sp(GetSP());
1629   if (target_sp && sb_file_spec.IsValid()) {
1630     const bool append = true;
1631     target_sp->GetImages().FindCompileUnits(*sb_file_spec,
1632                                             append, *sb_sc_list);
1633   }
1634   return sb_sc_list;
1635 }
1636 
1637 lldb::ByteOrder SBTarget::GetByteOrder() {
1638   TargetSP target_sp(GetSP());
1639   if (target_sp)
1640     return target_sp->GetArchitecture().GetByteOrder();
1641   return eByteOrderInvalid;
1642 }
1643 
1644 const char *SBTarget::GetTriple() {
1645   TargetSP target_sp(GetSP());
1646   if (target_sp) {
1647     std::string triple(target_sp->GetArchitecture().GetTriple().str());
1648     // Unique the string so we don't run into ownership issues since the const
1649     // strings put the string into the string pool once and the strings never
1650     // comes out
1651     ConstString const_triple(triple.c_str());
1652     return const_triple.GetCString();
1653   }
1654   return NULL;
1655 }
1656 
1657 uint32_t SBTarget::GetDataByteSize() {
1658   TargetSP target_sp(GetSP());
1659   if (target_sp) {
1660     return target_sp->GetArchitecture().GetDataByteSize();
1661   }
1662   return 0;
1663 }
1664 
1665 uint32_t SBTarget::GetCodeByteSize() {
1666   TargetSP target_sp(GetSP());
1667   if (target_sp) {
1668     return target_sp->GetArchitecture().GetCodeByteSize();
1669   }
1670   return 0;
1671 }
1672 
1673 uint32_t SBTarget::GetAddressByteSize() {
1674   TargetSP target_sp(GetSP());
1675   if (target_sp)
1676     return target_sp->GetArchitecture().GetAddressByteSize();
1677   return sizeof(void *);
1678 }
1679 
1680 SBModule SBTarget::GetModuleAtIndex(uint32_t idx) {
1681   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1682 
1683   SBModule sb_module;
1684   ModuleSP module_sp;
1685   TargetSP target_sp(GetSP());
1686   if (target_sp) {
1687     // The module list is thread safe, no need to lock
1688     module_sp = target_sp->GetImages().GetModuleAtIndex(idx);
1689     sb_module.SetSP(module_sp);
1690   }
1691 
1692   if (log)
1693     log->Printf("SBTarget(%p)::GetModuleAtIndex (idx=%d) => SBModule(%p)",
1694                 static_cast<void *>(target_sp.get()), idx,
1695                 static_cast<void *>(module_sp.get()));
1696 
1697   return sb_module;
1698 }
1699 
1700 bool SBTarget::RemoveModule(lldb::SBModule module) {
1701   TargetSP target_sp(GetSP());
1702   if (target_sp)
1703     return target_sp->GetImages().Remove(module.GetSP());
1704   return false;
1705 }
1706 
1707 SBBroadcaster SBTarget::GetBroadcaster() const {
1708   Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
1709 
1710   TargetSP target_sp(GetSP());
1711   SBBroadcaster broadcaster(target_sp.get(), false);
1712 
1713   if (log)
1714     log->Printf("SBTarget(%p)::GetBroadcaster () => SBBroadcaster(%p)",
1715                 static_cast<void *>(target_sp.get()),
1716                 static_cast<void *>(broadcaster.get()));
1717 
1718   return broadcaster;
1719 }
1720 
1721 bool SBTarget::GetDescription(SBStream &description,
1722                               lldb::DescriptionLevel description_level) {
1723   Stream &strm = description.ref();
1724 
1725   TargetSP target_sp(GetSP());
1726   if (target_sp) {
1727     target_sp->Dump(&strm, description_level);
1728   } else
1729     strm.PutCString("No value");
1730 
1731   return true;
1732 }
1733 
1734 lldb::SBSymbolContextList SBTarget::FindFunctions(const char *name,
1735                                                   uint32_t name_type_mask) {
1736   lldb::SBSymbolContextList sb_sc_list;
1737   if (name && name[0]) {
1738     TargetSP target_sp(GetSP());
1739     if (target_sp) {
1740       const bool symbols_ok = true;
1741       const bool inlines_ok = true;
1742       const bool append = true;
1743       target_sp->GetImages().FindFunctions(ConstString(name), name_type_mask,
1744                                            symbols_ok, inlines_ok, append,
1745                                            *sb_sc_list);
1746     }
1747   }
1748   return sb_sc_list;
1749 }
1750 
1751 lldb::SBSymbolContextList SBTarget::FindGlobalFunctions(const char *name,
1752                                                         uint32_t max_matches,
1753                                                         MatchType matchtype) {
1754   lldb::SBSymbolContextList sb_sc_list;
1755   if (name && name[0]) {
1756     llvm::StringRef name_ref(name);
1757     TargetSP target_sp(GetSP());
1758     if (target_sp) {
1759       std::string regexstr;
1760       switch (matchtype) {
1761       case eMatchTypeRegex:
1762         target_sp->GetImages().FindFunctions(RegularExpression(name_ref), true,
1763                                              true, true, *sb_sc_list);
1764         break;
1765       case eMatchTypeStartsWith:
1766         regexstr = llvm::Regex::escape(name) + ".*";
1767         target_sp->GetImages().FindFunctions(RegularExpression(regexstr), true,
1768                                              true, true, *sb_sc_list);
1769         break;
1770       default:
1771         target_sp->GetImages().FindFunctions(ConstString(name),
1772                                              eFunctionNameTypeAny, true, true,
1773                                              true, *sb_sc_list);
1774         break;
1775       }
1776     }
1777   }
1778   return sb_sc_list;
1779 }
1780 
1781 lldb::SBType SBTarget::FindFirstType(const char *typename_cstr) {
1782   TargetSP target_sp(GetSP());
1783   if (typename_cstr && typename_cstr[0] && target_sp) {
1784     ConstString const_typename(typename_cstr);
1785     SymbolContext sc;
1786     const bool exact_match = false;
1787 
1788     const ModuleList &module_list = target_sp->GetImages();
1789     size_t count = module_list.GetSize();
1790     for (size_t idx = 0; idx < count; idx++) {
1791       ModuleSP module_sp(module_list.GetModuleAtIndex(idx));
1792       if (module_sp) {
1793         TypeSP type_sp(
1794             module_sp->FindFirstType(sc, const_typename, exact_match));
1795         if (type_sp)
1796           return SBType(type_sp);
1797       }
1798     }
1799 
1800     // Didn't find the type in the symbols; try the Objective-C runtime if one
1801     // is installed
1802 
1803     ProcessSP process_sp(target_sp->GetProcessSP());
1804 
1805     if (process_sp) {
1806       ObjCLanguageRuntime *objc_language_runtime =
1807           process_sp->GetObjCLanguageRuntime();
1808 
1809       if (objc_language_runtime) {
1810         DeclVendor *objc_decl_vendor = objc_language_runtime->GetDeclVendor();
1811 
1812         if (objc_decl_vendor) {
1813           std::vector<clang::NamedDecl *> decls;
1814 
1815           if (objc_decl_vendor->FindDecls(const_typename, true, 1, decls) > 0) {
1816             if (CompilerType type = ClangASTContext::GetTypeForDecl(decls[0])) {
1817               return SBType(type);
1818             }
1819           }
1820         }
1821       }
1822     }
1823 
1824     // No matches, search for basic typename matches
1825     ClangASTContext *clang_ast = target_sp->GetScratchClangASTContext();
1826     if (clang_ast)
1827       return SBType(ClangASTContext::GetBasicType(clang_ast->getASTContext(),
1828                                                   const_typename));
1829   }
1830   return SBType();
1831 }
1832 
1833 SBType SBTarget::GetBasicType(lldb::BasicType type) {
1834   TargetSP target_sp(GetSP());
1835   if (target_sp) {
1836     ClangASTContext *clang_ast = target_sp->GetScratchClangASTContext();
1837     if (clang_ast)
1838       return SBType(
1839           ClangASTContext::GetBasicType(clang_ast->getASTContext(), type));
1840   }
1841   return SBType();
1842 }
1843 
1844 lldb::SBTypeList SBTarget::FindTypes(const char *typename_cstr) {
1845   SBTypeList sb_type_list;
1846   TargetSP target_sp(GetSP());
1847   if (typename_cstr && typename_cstr[0] && target_sp) {
1848     ModuleList &images = target_sp->GetImages();
1849     ConstString const_typename(typename_cstr);
1850     bool exact_match = false;
1851     SymbolContext sc;
1852     TypeList type_list;
1853     llvm::DenseSet<SymbolFile *> searched_symbol_files;
1854     uint32_t num_matches =
1855         images.FindTypes(sc, const_typename, exact_match, UINT32_MAX,
1856                          searched_symbol_files, type_list);
1857 
1858     if (num_matches > 0) {
1859       for (size_t idx = 0; idx < num_matches; idx++) {
1860         TypeSP type_sp(type_list.GetTypeAtIndex(idx));
1861         if (type_sp)
1862           sb_type_list.Append(SBType(type_sp));
1863       }
1864     }
1865 
1866     // Try the Objective-C runtime if one is installed
1867 
1868     ProcessSP process_sp(target_sp->GetProcessSP());
1869 
1870     if (process_sp) {
1871       ObjCLanguageRuntime *objc_language_runtime =
1872           process_sp->GetObjCLanguageRuntime();
1873 
1874       if (objc_language_runtime) {
1875         DeclVendor *objc_decl_vendor = objc_language_runtime->GetDeclVendor();
1876 
1877         if (objc_decl_vendor) {
1878           std::vector<clang::NamedDecl *> decls;
1879 
1880           if (objc_decl_vendor->FindDecls(const_typename, true, 1, decls) > 0) {
1881             for (clang::NamedDecl *decl : decls) {
1882               if (CompilerType type = ClangASTContext::GetTypeForDecl(decl)) {
1883                 sb_type_list.Append(SBType(type));
1884               }
1885             }
1886           }
1887         }
1888       }
1889     }
1890 
1891     if (sb_type_list.GetSize() == 0) {
1892       // No matches, search for basic typename matches
1893       ClangASTContext *clang_ast = target_sp->GetScratchClangASTContext();
1894       if (clang_ast)
1895         sb_type_list.Append(SBType(ClangASTContext::GetBasicType(
1896             clang_ast->getASTContext(), const_typename)));
1897     }
1898   }
1899   return sb_type_list;
1900 }
1901 
1902 SBValueList SBTarget::FindGlobalVariables(const char *name,
1903                                           uint32_t max_matches) {
1904   SBValueList sb_value_list;
1905 
1906   TargetSP target_sp(GetSP());
1907   if (name && target_sp) {
1908     VariableList variable_list;
1909     const uint32_t match_count = target_sp->GetImages().FindGlobalVariables(
1910         ConstString(name), max_matches, variable_list);
1911 
1912     if (match_count > 0) {
1913       ExecutionContextScope *exe_scope = target_sp->GetProcessSP().get();
1914       if (exe_scope == NULL)
1915         exe_scope = target_sp.get();
1916       for (uint32_t i = 0; i < match_count; ++i) {
1917         lldb::ValueObjectSP valobj_sp(ValueObjectVariable::Create(
1918             exe_scope, variable_list.GetVariableAtIndex(i)));
1919         if (valobj_sp)
1920           sb_value_list.Append(SBValue(valobj_sp));
1921       }
1922     }
1923   }
1924 
1925   return sb_value_list;
1926 }
1927 
1928 SBValueList SBTarget::FindGlobalVariables(const char *name,
1929                                           uint32_t max_matches,
1930                                           MatchType matchtype) {
1931   SBValueList sb_value_list;
1932 
1933   TargetSP target_sp(GetSP());
1934   if (name && target_sp) {
1935     llvm::StringRef name_ref(name);
1936     VariableList variable_list;
1937 
1938     std::string regexstr;
1939     uint32_t match_count;
1940     switch (matchtype) {
1941     case eMatchTypeNormal:
1942       match_count = target_sp->GetImages().FindGlobalVariables(
1943           ConstString(name), max_matches, variable_list);
1944       break;
1945     case eMatchTypeRegex:
1946       match_count = target_sp->GetImages().FindGlobalVariables(
1947           RegularExpression(name_ref), max_matches, variable_list);
1948       break;
1949     case eMatchTypeStartsWith:
1950       regexstr = llvm::Regex::escape(name) + ".*";
1951       match_count = target_sp->GetImages().FindGlobalVariables(
1952           RegularExpression(regexstr), max_matches, variable_list);
1953       break;
1954     }
1955 
1956     if (match_count > 0) {
1957       ExecutionContextScope *exe_scope = target_sp->GetProcessSP().get();
1958       if (exe_scope == NULL)
1959         exe_scope = target_sp.get();
1960       for (uint32_t i = 0; i < match_count; ++i) {
1961         lldb::ValueObjectSP valobj_sp(ValueObjectVariable::Create(
1962             exe_scope, variable_list.GetVariableAtIndex(i)));
1963         if (valobj_sp)
1964           sb_value_list.Append(SBValue(valobj_sp));
1965       }
1966     }
1967   }
1968 
1969   return sb_value_list;
1970 }
1971 
1972 lldb::SBValue SBTarget::FindFirstGlobalVariable(const char *name) {
1973   SBValueList sb_value_list(FindGlobalVariables(name, 1));
1974   if (sb_value_list.IsValid() && sb_value_list.GetSize() > 0)
1975     return sb_value_list.GetValueAtIndex(0);
1976   return SBValue();
1977 }
1978 
1979 SBSourceManager SBTarget::GetSourceManager() {
1980   SBSourceManager source_manager(*this);
1981   return source_manager;
1982 }
1983 
1984 lldb::SBInstructionList SBTarget::ReadInstructions(lldb::SBAddress base_addr,
1985                                                    uint32_t count) {
1986   return ReadInstructions(base_addr, count, NULL);
1987 }
1988 
1989 lldb::SBInstructionList SBTarget::ReadInstructions(lldb::SBAddress base_addr,
1990                                                    uint32_t count,
1991                                                    const char *flavor_string) {
1992   SBInstructionList sb_instructions;
1993 
1994   TargetSP target_sp(GetSP());
1995   if (target_sp) {
1996     Address *addr_ptr = base_addr.get();
1997 
1998     if (addr_ptr) {
1999       DataBufferHeap data(
2000           target_sp->GetArchitecture().GetMaximumOpcodeByteSize() * count, 0);
2001       bool prefer_file_cache = false;
2002       lldb_private::Status error;
2003       lldb::addr_t load_addr = LLDB_INVALID_ADDRESS;
2004       const size_t bytes_read =
2005           target_sp->ReadMemory(*addr_ptr, prefer_file_cache, data.GetBytes(),
2006                                 data.GetByteSize(), error, &load_addr);
2007       const bool data_from_file = load_addr == LLDB_INVALID_ADDRESS;
2008       sb_instructions.SetDisassembler(Disassembler::DisassembleBytes(
2009           target_sp->GetArchitecture(), NULL, flavor_string, *addr_ptr,
2010           data.GetBytes(), bytes_read, count, data_from_file));
2011     }
2012   }
2013 
2014   return sb_instructions;
2015 }
2016 
2017 lldb::SBInstructionList SBTarget::GetInstructions(lldb::SBAddress base_addr,
2018                                                   const void *buf,
2019                                                   size_t size) {
2020   return GetInstructionsWithFlavor(base_addr, NULL, buf, size);
2021 }
2022 
2023 lldb::SBInstructionList
2024 SBTarget::GetInstructionsWithFlavor(lldb::SBAddress base_addr,
2025                                     const char *flavor_string, const void *buf,
2026                                     size_t size) {
2027   SBInstructionList sb_instructions;
2028 
2029   TargetSP target_sp(GetSP());
2030   if (target_sp) {
2031     Address addr;
2032 
2033     if (base_addr.get())
2034       addr = *base_addr.get();
2035 
2036     const bool data_from_file = true;
2037 
2038     sb_instructions.SetDisassembler(Disassembler::DisassembleBytes(
2039         target_sp->GetArchitecture(), NULL, flavor_string, addr, buf, size,
2040         UINT32_MAX, data_from_file));
2041   }
2042 
2043   return sb_instructions;
2044 }
2045 
2046 lldb::SBInstructionList SBTarget::GetInstructions(lldb::addr_t base_addr,
2047                                                   const void *buf,
2048                                                   size_t size) {
2049   return GetInstructionsWithFlavor(ResolveLoadAddress(base_addr), NULL, buf,
2050                                    size);
2051 }
2052 
2053 lldb::SBInstructionList
2054 SBTarget::GetInstructionsWithFlavor(lldb::addr_t base_addr,
2055                                     const char *flavor_string, const void *buf,
2056                                     size_t size) {
2057   return GetInstructionsWithFlavor(ResolveLoadAddress(base_addr), flavor_string,
2058                                    buf, size);
2059 }
2060 
2061 SBError SBTarget::SetSectionLoadAddress(lldb::SBSection section,
2062                                         lldb::addr_t section_base_addr) {
2063   SBError sb_error;
2064   TargetSP target_sp(GetSP());
2065   if (target_sp) {
2066     if (!section.IsValid()) {
2067       sb_error.SetErrorStringWithFormat("invalid section");
2068     } else {
2069       SectionSP section_sp(section.GetSP());
2070       if (section_sp) {
2071         if (section_sp->IsThreadSpecific()) {
2072           sb_error.SetErrorString(
2073               "thread specific sections are not yet supported");
2074         } else {
2075           ProcessSP process_sp(target_sp->GetProcessSP());
2076           if (target_sp->SetSectionLoadAddress(section_sp, section_base_addr)) {
2077             ModuleSP module_sp(section_sp->GetModule());
2078             if (module_sp) {
2079               ModuleList module_list;
2080               module_list.Append(module_sp);
2081               target_sp->ModulesDidLoad(module_list);
2082             }
2083             // Flush info in the process (stack frames, etc)
2084             if (process_sp)
2085               process_sp->Flush();
2086           }
2087         }
2088       }
2089     }
2090   } else {
2091     sb_error.SetErrorString("invalid target");
2092   }
2093   return sb_error;
2094 }
2095 
2096 SBError SBTarget::ClearSectionLoadAddress(lldb::SBSection section) {
2097   SBError sb_error;
2098 
2099   TargetSP target_sp(GetSP());
2100   if (target_sp) {
2101     if (!section.IsValid()) {
2102       sb_error.SetErrorStringWithFormat("invalid section");
2103     } else {
2104       SectionSP section_sp(section.GetSP());
2105       if (section_sp) {
2106         ProcessSP process_sp(target_sp->GetProcessSP());
2107         if (target_sp->SetSectionUnloaded(section_sp)) {
2108           ModuleSP module_sp(section_sp->GetModule());
2109           if (module_sp) {
2110             ModuleList module_list;
2111             module_list.Append(module_sp);
2112             target_sp->ModulesDidUnload(module_list, false);
2113           }
2114           // Flush info in the process (stack frames, etc)
2115           if (process_sp)
2116             process_sp->Flush();
2117         }
2118       } else {
2119         sb_error.SetErrorStringWithFormat("invalid section");
2120       }
2121     }
2122   } else {
2123     sb_error.SetErrorStringWithFormat("invalid target");
2124   }
2125   return sb_error;
2126 }
2127 
2128 SBError SBTarget::SetModuleLoadAddress(lldb::SBModule module,
2129                                        int64_t slide_offset) {
2130   SBError sb_error;
2131 
2132   TargetSP target_sp(GetSP());
2133   if (target_sp) {
2134     ModuleSP module_sp(module.GetSP());
2135     if (module_sp) {
2136       bool changed = false;
2137       if (module_sp->SetLoadAddress(*target_sp, slide_offset, true, changed)) {
2138         // The load was successful, make sure that at least some sections
2139         // changed before we notify that our module was loaded.
2140         if (changed) {
2141           ModuleList module_list;
2142           module_list.Append(module_sp);
2143           target_sp->ModulesDidLoad(module_list);
2144           // Flush info in the process (stack frames, etc)
2145           ProcessSP process_sp(target_sp->GetProcessSP());
2146           if (process_sp)
2147             process_sp->Flush();
2148         }
2149       }
2150     } else {
2151       sb_error.SetErrorStringWithFormat("invalid module");
2152     }
2153 
2154   } else {
2155     sb_error.SetErrorStringWithFormat("invalid target");
2156   }
2157   return sb_error;
2158 }
2159 
2160 SBError SBTarget::ClearModuleLoadAddress(lldb::SBModule module) {
2161   SBError sb_error;
2162 
2163   char path[PATH_MAX];
2164   TargetSP target_sp(GetSP());
2165   if (target_sp) {
2166     ModuleSP module_sp(module.GetSP());
2167     if (module_sp) {
2168       ObjectFile *objfile = module_sp->GetObjectFile();
2169       if (objfile) {
2170         SectionList *section_list = objfile->GetSectionList();
2171         if (section_list) {
2172           ProcessSP process_sp(target_sp->GetProcessSP());
2173 
2174           bool changed = false;
2175           const size_t num_sections = section_list->GetSize();
2176           for (size_t sect_idx = 0; sect_idx < num_sections; ++sect_idx) {
2177             SectionSP section_sp(section_list->GetSectionAtIndex(sect_idx));
2178             if (section_sp)
2179               changed |= target_sp->SetSectionUnloaded(section_sp);
2180           }
2181           if (changed) {
2182             ModuleList module_list;
2183             module_list.Append(module_sp);
2184             target_sp->ModulesDidUnload(module_list, false);
2185             // Flush info in the process (stack frames, etc)
2186             ProcessSP process_sp(target_sp->GetProcessSP());
2187             if (process_sp)
2188               process_sp->Flush();
2189           }
2190         } else {
2191           module_sp->GetFileSpec().GetPath(path, sizeof(path));
2192           sb_error.SetErrorStringWithFormat("no sections in object file '%s'",
2193                                             path);
2194         }
2195       } else {
2196         module_sp->GetFileSpec().GetPath(path, sizeof(path));
2197         sb_error.SetErrorStringWithFormat("no object file for module '%s'",
2198                                           path);
2199       }
2200     } else {
2201       sb_error.SetErrorStringWithFormat("invalid module");
2202     }
2203   } else {
2204     sb_error.SetErrorStringWithFormat("invalid target");
2205   }
2206   return sb_error;
2207 }
2208 
2209 lldb::SBSymbolContextList SBTarget::FindSymbols(const char *name,
2210                                                 lldb::SymbolType symbol_type) {
2211   SBSymbolContextList sb_sc_list;
2212   if (name && name[0]) {
2213     TargetSP target_sp(GetSP());
2214     if (target_sp) {
2215       bool append = true;
2216       target_sp->GetImages().FindSymbolsWithNameAndType(
2217           ConstString(name), symbol_type, *sb_sc_list, append);
2218     }
2219   }
2220   return sb_sc_list;
2221 }
2222 
2223 lldb::SBValue SBTarget::EvaluateExpression(const char *expr) {
2224   TargetSP target_sp(GetSP());
2225   if (!target_sp)
2226     return SBValue();
2227 
2228   SBExpressionOptions options;
2229   lldb::DynamicValueType fetch_dynamic_value =
2230       target_sp->GetPreferDynamicValue();
2231   options.SetFetchDynamicValue(fetch_dynamic_value);
2232   options.SetUnwindOnError(true);
2233   return EvaluateExpression(expr, options);
2234 }
2235 
2236 lldb::SBValue SBTarget::EvaluateExpression(const char *expr,
2237                                            const SBExpressionOptions &options) {
2238   Log *log(GetLogIfAllCategoriesSet(LIBLLDB_LOG_API));
2239 #if !defined(LLDB_DISABLE_PYTHON)
2240   Log *expr_log(GetLogIfAllCategoriesSet(LIBLLDB_LOG_EXPRESSIONS));
2241 #endif
2242   SBValue expr_result;
2243   ExpressionResults exe_results = eExpressionSetupError;
2244   ValueObjectSP expr_value_sp;
2245   TargetSP target_sp(GetSP());
2246   StackFrame *frame = NULL;
2247   if (target_sp) {
2248     if (expr == NULL || expr[0] == '\0') {
2249       if (log)
2250         log->Printf(
2251             "SBTarget::EvaluateExpression called with an empty expression");
2252       return expr_result;
2253     }
2254 
2255     std::lock_guard<std::recursive_mutex> guard(target_sp->GetAPIMutex());
2256     ExecutionContext exe_ctx(m_opaque_sp.get());
2257 
2258     if (log)
2259       log->Printf("SBTarget()::EvaluateExpression (expr=\"%s\")...", expr);
2260 
2261     frame = exe_ctx.GetFramePtr();
2262     Target *target = exe_ctx.GetTargetPtr();
2263 
2264     if (target) {
2265 #ifdef LLDB_CONFIGURATION_DEBUG
2266       StreamString frame_description;
2267       if (frame)
2268         frame->DumpUsingSettingsFormat(&frame_description);
2269       llvm::PrettyStackTraceFormat stack_trace(
2270           "SBTarget::EvaluateExpression (expr = \"%s\", fetch_dynamic_value = "
2271           "%u) %s",
2272           expr, options.GetFetchDynamicValue(),
2273           frame_description.GetString().str().c_str());
2274 #endif
2275       exe_results =
2276           target->EvaluateExpression(expr, frame, expr_value_sp, options.ref());
2277 
2278       expr_result.SetSP(expr_value_sp, options.GetFetchDynamicValue());
2279     } else {
2280       if (log)
2281         log->Printf("SBTarget::EvaluateExpression () => error: could not "
2282                     "reconstruct frame object for this SBTarget.");
2283     }
2284   }
2285 #ifndef LLDB_DISABLE_PYTHON
2286   if (expr_log)
2287     expr_log->Printf("** [SBTarget::EvaluateExpression] Expression result is "
2288                      "%s, summary %s **",
2289                      expr_result.GetValue(), expr_result.GetSummary());
2290 
2291   if (log)
2292     log->Printf("SBTarget(%p)::EvaluateExpression (expr=\"%s\") => SBValue(%p) "
2293                 "(execution result=%d)",
2294                 static_cast<void *>(frame), expr,
2295                 static_cast<void *>(expr_value_sp.get()), exe_results);
2296 #endif
2297 
2298   return expr_result;
2299 }
2300 
2301 lldb::addr_t SBTarget::GetStackRedZoneSize() {
2302   TargetSP target_sp(GetSP());
2303   if (target_sp) {
2304     ABISP abi_sp;
2305     ProcessSP process_sp(target_sp->GetProcessSP());
2306     if (process_sp)
2307       abi_sp = process_sp->GetABI();
2308     else
2309       abi_sp = ABI::FindPlugin(ProcessSP(), target_sp->GetArchitecture());
2310     if (abi_sp)
2311       return abi_sp->GetRedZoneSize();
2312   }
2313   return 0;
2314 }
2315 
2316 lldb::SBLaunchInfo SBTarget::GetLaunchInfo() const {
2317   lldb::SBLaunchInfo launch_info(NULL);
2318   TargetSP target_sp(GetSP());
2319   if (target_sp)
2320     launch_info.set_ref(m_opaque_sp->GetProcessLaunchInfo());
2321   return launch_info;
2322 }
2323 
2324 void SBTarget::SetLaunchInfo(const lldb::SBLaunchInfo &launch_info) {
2325   TargetSP target_sp(GetSP());
2326   if (target_sp)
2327     m_opaque_sp->SetProcessLaunchInfo(launch_info.ref());
2328 }
2329