1 //===-- SBTarget.cpp ------------------------------------------------------===//
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
7 //===----------------------------------------------------------------------===//
9 #include "lldb/API/SBTarget.h"
10 #include "lldb/Utility/Instrumentation.h"
11 #include "lldb/Utility/LLDBLog.h"
12 #include "lldb/lldb-public.h"
14 #include "lldb/API/SBBreakpoint.h"
15 #include "lldb/API/SBDebugger.h"
16 #include "lldb/API/SBEnvironment.h"
17 #include "lldb/API/SBEvent.h"
18 #include "lldb/API/SBExpressionOptions.h"
19 #include "lldb/API/SBFileSpec.h"
20 #include "lldb/API/SBListener.h"
21 #include "lldb/API/SBModule.h"
22 #include "lldb/API/SBModuleSpec.h"
23 #include "lldb/API/SBProcess.h"
24 #include "lldb/API/SBSourceManager.h"
25 #include "lldb/API/SBStream.h"
26 #include "lldb/API/SBStringList.h"
27 #include "lldb/API/SBStructuredData.h"
28 #include "lldb/API/SBSymbolContextList.h"
29 #include "lldb/API/SBTrace.h"
30 #include "lldb/Breakpoint/BreakpointID.h"
31 #include "lldb/Breakpoint/BreakpointIDList.h"
32 #include "lldb/Breakpoint/BreakpointList.h"
33 #include "lldb/Breakpoint/BreakpointLocation.h"
34 #include "lldb/Core/Address.h"
35 #include "lldb/Core/AddressResolver.h"
36 #include "lldb/Core/Debugger.h"
37 #include "lldb/Core/Disassembler.h"
38 #include "lldb/Core/Module.h"
39 #include "lldb/Core/ModuleSpec.h"
40 #include "lldb/Core/PluginManager.h"
41 #include "lldb/Core/SearchFilter.h"
42 #include "lldb/Core/Section.h"
43 #include "lldb/Core/StructuredDataImpl.h"
44 #include "lldb/Core/ValueObjectConstResult.h"
45 #include "lldb/Core/ValueObjectList.h"
46 #include "lldb/Core/ValueObjectVariable.h"
47 #include "lldb/Host/Host.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/TypeSystem.h"
53 #include "lldb/Symbol/VariableList.h"
54 #include "lldb/Target/ABI.h"
55 #include "lldb/Target/Language.h"
56 #include "lldb/Target/LanguageRuntime.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/ProcessInfo.h"
65 #include "lldb/Utility/RegularExpression.h"
67 #include "Commands/CommandObjectBreakpoint.h"
68 #include "lldb/Interpreter/CommandReturnObject.h"
69 #include "llvm/Support/PrettyStackTrace.h"
70 #include "llvm/Support/Regex.h"
73 using namespace lldb_private
;
75 #define DEFAULT_DISASM_BYTE_SIZE 32
77 static Status
AttachToProcess(ProcessAttachInfo
&attach_info
, Target
&target
) {
78 std::lock_guard
<std::recursive_mutex
> guard(target
.GetAPIMutex());
80 auto process_sp
= target
.GetProcessSP();
82 const auto state
= process_sp
->GetState();
83 if (process_sp
->IsAlive() && state
== eStateConnected
) {
84 // If we are already connected, then we have already specified the
85 // listener, so if a valid listener is supplied, we need to error out to
86 // let the client know.
87 if (attach_info
.GetListener())
88 return Status("process is connected and already has a listener, pass "
93 return target
.Attach(attach_info
, nullptr);
96 // SBTarget constructor
97 SBTarget::SBTarget() { LLDB_INSTRUMENT_VA(this); }
99 SBTarget::SBTarget(const SBTarget
&rhs
) : m_opaque_sp(rhs
.m_opaque_sp
) {
100 LLDB_INSTRUMENT_VA(this, rhs
);
103 SBTarget::SBTarget(const TargetSP
&target_sp
) : m_opaque_sp(target_sp
) {
104 LLDB_INSTRUMENT_VA(this, target_sp
);
107 const SBTarget
&SBTarget::operator=(const SBTarget
&rhs
) {
108 LLDB_INSTRUMENT_VA(this, rhs
);
111 m_opaque_sp
= rhs
.m_opaque_sp
;
116 SBTarget::~SBTarget() = default;
118 bool SBTarget::EventIsTargetEvent(const SBEvent
&event
) {
119 LLDB_INSTRUMENT_VA(event
);
121 return Target::TargetEventData::GetEventDataFromEvent(event
.get()) != nullptr;
124 SBTarget
SBTarget::GetTargetFromEvent(const SBEvent
&event
) {
125 LLDB_INSTRUMENT_VA(event
);
127 return Target::TargetEventData::GetTargetFromEvent(event
.get());
130 uint32_t SBTarget::GetNumModulesFromEvent(const SBEvent
&event
) {
131 LLDB_INSTRUMENT_VA(event
);
133 const ModuleList module_list
=
134 Target::TargetEventData::GetModuleListFromEvent(event
.get());
135 return module_list
.GetSize();
138 SBModule
SBTarget::GetModuleAtIndexFromEvent(const uint32_t idx
,
139 const SBEvent
&event
) {
140 LLDB_INSTRUMENT_VA(idx
, event
);
142 const ModuleList module_list
=
143 Target::TargetEventData::GetModuleListFromEvent(event
.get());
144 return SBModule(module_list
.GetModuleAtIndex(idx
));
147 const char *SBTarget::GetBroadcasterClassName() {
150 return Target::GetStaticBroadcasterClass().AsCString();
153 bool SBTarget::IsValid() const {
154 LLDB_INSTRUMENT_VA(this);
155 return this->operator bool();
157 SBTarget::operator bool() const {
158 LLDB_INSTRUMENT_VA(this);
160 return m_opaque_sp
.get() != nullptr && m_opaque_sp
->IsValid();
163 SBProcess
SBTarget::GetProcess() {
164 LLDB_INSTRUMENT_VA(this);
166 SBProcess sb_process
;
167 ProcessSP process_sp
;
168 TargetSP
target_sp(GetSP());
170 process_sp
= target_sp
->GetProcessSP();
171 sb_process
.SetSP(process_sp
);
177 SBPlatform
SBTarget::GetPlatform() {
178 LLDB_INSTRUMENT_VA(this);
180 TargetSP
target_sp(GetSP());
185 platform
.m_opaque_sp
= target_sp
->GetPlatform();
190 SBDebugger
SBTarget::GetDebugger() const {
191 LLDB_INSTRUMENT_VA(this);
194 TargetSP
target_sp(GetSP());
196 debugger
.reset(target_sp
->GetDebugger().shared_from_this());
200 SBStructuredData
SBTarget::GetStatistics() {
201 LLDB_INSTRUMENT_VA(this);
203 SBStructuredData data
;
204 TargetSP
target_sp(GetSP());
207 std::string json_str
=
208 llvm::formatv("{0:2}",
209 DebuggerStats::ReportStatistics(target_sp
->GetDebugger(),
210 target_sp
.get())).str();
211 data
.m_impl_up
->SetObjectSP(StructuredData::ParseJSON(json_str
));
215 void SBTarget::SetCollectingStats(bool v
) {
216 LLDB_INSTRUMENT_VA(this, v
);
218 TargetSP
target_sp(GetSP());
221 return DebuggerStats::SetCollectingStats(v
);
224 bool SBTarget::GetCollectingStats() {
225 LLDB_INSTRUMENT_VA(this);
227 TargetSP
target_sp(GetSP());
230 return DebuggerStats::GetCollectingStats();
233 SBProcess
SBTarget::LoadCore(const char *core_file
) {
234 LLDB_INSTRUMENT_VA(this, core_file
);
236 lldb::SBError error
; // Ignored
237 return LoadCore(core_file
, error
);
240 SBProcess
SBTarget::LoadCore(const char *core_file
, lldb::SBError
&error
) {
241 LLDB_INSTRUMENT_VA(this, core_file
, error
);
243 SBProcess sb_process
;
244 TargetSP
target_sp(GetSP());
246 FileSpec
filespec(core_file
);
247 FileSystem::Instance().Resolve(filespec
);
248 ProcessSP
process_sp(target_sp
->CreateProcess(
249 target_sp
->GetDebugger().GetListener(), "", &filespec
, false));
251 error
.SetError(process_sp
->LoadCore());
253 sb_process
.SetSP(process_sp
);
255 error
.SetErrorString("Failed to create the process");
258 error
.SetErrorString("SBTarget is invalid");
263 SBProcess
SBTarget::LaunchSimple(char const **argv
, char const **envp
,
264 const char *working_directory
) {
265 LLDB_INSTRUMENT_VA(this, argv
, envp
, working_directory
);
267 TargetSP target_sp
= GetSP();
271 SBLaunchInfo launch_info
= GetLaunchInfo();
273 if (Module
*exe_module
= target_sp
->GetExecutableModulePointer())
274 launch_info
.SetExecutableFile(exe_module
->GetPlatformFileSpec(),
275 /*add_as_first_arg*/ true);
277 launch_info
.SetArguments(argv
, /*append*/ true);
279 launch_info
.SetEnvironmentEntries(envp
, /*append*/ false);
280 if (working_directory
)
281 launch_info
.SetWorkingDirectory(working_directory
);
284 return Launch(launch_info
, error
);
287 SBError
SBTarget::Install() {
288 LLDB_INSTRUMENT_VA(this);
291 TargetSP
target_sp(GetSP());
293 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
294 sb_error
.ref() = target_sp
->Install(nullptr);
299 SBProcess
SBTarget::Launch(SBListener
&listener
, char const **argv
,
300 char const **envp
, const char *stdin_path
,
301 const char *stdout_path
, const char *stderr_path
,
302 const char *working_directory
,
303 uint32_t launch_flags
, // See LaunchFlags
304 bool stop_at_entry
, lldb::SBError
&error
) {
305 LLDB_INSTRUMENT_VA(this, listener
, argv
, envp
, stdin_path
, stdout_path
,
306 stderr_path
, working_directory
, launch_flags
,
307 stop_at_entry
, error
);
309 SBProcess sb_process
;
310 ProcessSP process_sp
;
311 TargetSP
target_sp(GetSP());
314 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
317 launch_flags
|= eLaunchFlagStopAtEntry
;
319 if (getenv("LLDB_LAUNCH_FLAG_DISABLE_ASLR"))
320 launch_flags
|= eLaunchFlagDisableASLR
;
322 StateType state
= eStateInvalid
;
323 process_sp
= target_sp
->GetProcessSP();
325 state
= process_sp
->GetState();
327 if (process_sp
->IsAlive() && state
!= eStateConnected
) {
328 if (state
== eStateAttaching
)
329 error
.SetErrorString("process attach is in progress");
331 error
.SetErrorString("a process is already being debugged");
336 if (state
== eStateConnected
) {
337 // If we are already connected, then we have already specified the
338 // listener, so if a valid listener is supplied, we need to error out to
339 // let the client know.
340 if (listener
.IsValid()) {
341 error
.SetErrorString("process is connected and already has a listener, "
342 "pass empty listener");
347 if (getenv("LLDB_LAUNCH_FLAG_DISABLE_STDIO"))
348 launch_flags
|= eLaunchFlagDisableSTDIO
;
350 ProcessLaunchInfo
launch_info(FileSpec(stdin_path
), FileSpec(stdout_path
),
351 FileSpec(stderr_path
),
352 FileSpec(working_directory
), launch_flags
);
354 Module
*exe_module
= target_sp
->GetExecutableModulePointer();
356 launch_info
.SetExecutableFile(exe_module
->GetPlatformFileSpec(), true);
358 launch_info
.GetArguments().AppendArguments(argv
);
360 auto default_launch_info
= target_sp
->GetProcessLaunchInfo();
361 launch_info
.GetArguments().AppendArguments(
362 default_launch_info
.GetArguments());
365 launch_info
.GetEnvironment() = Environment(envp
);
367 auto default_launch_info
= target_sp
->GetProcessLaunchInfo();
368 launch_info
.GetEnvironment() = default_launch_info
.GetEnvironment();
371 if (listener
.IsValid())
372 launch_info
.SetListener(listener
.GetSP());
374 error
.SetError(target_sp
->Launch(launch_info
, nullptr));
376 sb_process
.SetSP(target_sp
->GetProcessSP());
378 error
.SetErrorString("SBTarget is invalid");
384 SBProcess
SBTarget::Launch(SBLaunchInfo
&sb_launch_info
, SBError
&error
) {
385 LLDB_INSTRUMENT_VA(this, sb_launch_info
, error
);
387 SBProcess sb_process
;
388 TargetSP
target_sp(GetSP());
391 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
392 StateType state
= eStateInvalid
;
394 ProcessSP process_sp
= target_sp
->GetProcessSP();
396 state
= process_sp
->GetState();
398 if (process_sp
->IsAlive() && state
!= eStateConnected
) {
399 if (state
== eStateAttaching
)
400 error
.SetErrorString("process attach is in progress");
402 error
.SetErrorString("a process is already being debugged");
408 lldb_private::ProcessLaunchInfo launch_info
= sb_launch_info
.ref();
410 if (!launch_info
.GetExecutableFile()) {
411 Module
*exe_module
= target_sp
->GetExecutableModulePointer();
413 launch_info
.SetExecutableFile(exe_module
->GetPlatformFileSpec(), true);
416 const ArchSpec
&arch_spec
= target_sp
->GetArchitecture();
417 if (arch_spec
.IsValid())
418 launch_info
.GetArchitecture() = arch_spec
;
420 error
.SetError(target_sp
->Launch(launch_info
, nullptr));
421 sb_launch_info
.set_ref(launch_info
);
422 sb_process
.SetSP(target_sp
->GetProcessSP());
424 error
.SetErrorString("SBTarget is invalid");
430 lldb::SBProcess
SBTarget::Attach(SBAttachInfo
&sb_attach_info
, SBError
&error
) {
431 LLDB_INSTRUMENT_VA(this, sb_attach_info
, error
);
433 SBProcess sb_process
;
434 TargetSP
target_sp(GetSP());
437 ProcessAttachInfo
&attach_info
= sb_attach_info
.ref();
438 if (attach_info
.ProcessIDIsValid() && !attach_info
.UserIDIsValid() &&
439 !attach_info
.IsScriptedProcess()) {
440 PlatformSP platform_sp
= target_sp
->GetPlatform();
441 // See if we can pre-verify if a process exists or not
442 if (platform_sp
&& platform_sp
->IsConnected()) {
443 lldb::pid_t attach_pid
= attach_info
.GetProcessID();
444 ProcessInstanceInfo instance_info
;
445 if (platform_sp
->GetProcessInfo(attach_pid
, instance_info
)) {
446 attach_info
.SetUserID(instance_info
.GetEffectiveUserID());
448 error
.ref().SetErrorStringWithFormat(
449 "no process found with process ID %" PRIu64
, attach_pid
);
454 error
.SetError(AttachToProcess(attach_info
, *target_sp
));
456 sb_process
.SetSP(target_sp
->GetProcessSP());
458 error
.SetErrorString("SBTarget is invalid");
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
469 LLDB_INSTRUMENT_VA(this, listener
, pid
, error
);
471 SBProcess sb_process
;
472 TargetSP
target_sp(GetSP());
475 ProcessAttachInfo attach_info
;
476 attach_info
.SetProcessID(pid
);
477 if (listener
.IsValid())
478 attach_info
.SetListener(listener
.GetSP());
480 ProcessInstanceInfo instance_info
;
481 if (target_sp
->GetPlatform()->GetProcessInfo(pid
, instance_info
))
482 attach_info
.SetUserID(instance_info
.GetEffectiveUserID());
484 error
.SetError(AttachToProcess(attach_info
, *target_sp
));
486 sb_process
.SetSP(target_sp
->GetProcessSP());
488 error
.SetErrorString("SBTarget is invalid");
493 lldb::SBProcess
SBTarget::AttachToProcessWithName(
494 SBListener
&listener
,
495 const char *name
, // basename of process to attach to
496 bool wait_for
, // if true wait for a new instance of "name" to be launched
497 SBError
&error
// An error explaining what went wrong if attach fails
499 LLDB_INSTRUMENT_VA(this, listener
, name
, wait_for
, error
);
501 SBProcess sb_process
;
502 TargetSP
target_sp(GetSP());
504 if (name
&& target_sp
) {
505 ProcessAttachInfo attach_info
;
506 attach_info
.GetExecutableFile().SetFile(name
, FileSpec::Style::native
);
507 attach_info
.SetWaitForLaunch(wait_for
);
508 if (listener
.IsValid())
509 attach_info
.SetListener(listener
.GetSP());
511 error
.SetError(AttachToProcess(attach_info
, *target_sp
));
513 sb_process
.SetSP(target_sp
->GetProcessSP());
515 error
.SetErrorString("SBTarget is invalid");
520 lldb::SBProcess
SBTarget::ConnectRemote(SBListener
&listener
, const char *url
,
521 const char *plugin_name
,
523 LLDB_INSTRUMENT_VA(this, listener
, url
, plugin_name
, error
);
525 SBProcess sb_process
;
526 ProcessSP process_sp
;
527 TargetSP
target_sp(GetSP());
530 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
531 if (listener
.IsValid())
533 target_sp
->CreateProcess(listener
.m_opaque_sp
, plugin_name
, nullptr,
536 process_sp
= target_sp
->CreateProcess(
537 target_sp
->GetDebugger().GetListener(), plugin_name
, nullptr, true);
540 sb_process
.SetSP(process_sp
);
541 error
.SetError(process_sp
->ConnectRemote(url
));
543 error
.SetErrorString("unable to create lldb_private::Process");
546 error
.SetErrorString("SBTarget is invalid");
552 SBFileSpec
SBTarget::GetExecutable() {
553 LLDB_INSTRUMENT_VA(this);
555 SBFileSpec exe_file_spec
;
556 TargetSP
target_sp(GetSP());
558 Module
*exe_module
= target_sp
->GetExecutableModulePointer();
560 exe_file_spec
.SetFileSpec(exe_module
->GetFileSpec());
563 return exe_file_spec
;
566 bool SBTarget::operator==(const SBTarget
&rhs
) const {
567 LLDB_INSTRUMENT_VA(this, rhs
);
569 return m_opaque_sp
.get() == rhs
.m_opaque_sp
.get();
572 bool SBTarget::operator!=(const SBTarget
&rhs
) const {
573 LLDB_INSTRUMENT_VA(this, rhs
);
575 return m_opaque_sp
.get() != rhs
.m_opaque_sp
.get();
578 lldb::TargetSP
SBTarget::GetSP() const { return m_opaque_sp
; }
580 void SBTarget::SetSP(const lldb::TargetSP
&target_sp
) {
581 m_opaque_sp
= target_sp
;
584 lldb::SBAddress
SBTarget::ResolveLoadAddress(lldb::addr_t vm_addr
) {
585 LLDB_INSTRUMENT_VA(this, vm_addr
);
587 lldb::SBAddress sb_addr
;
588 Address
&addr
= sb_addr
.ref();
589 TargetSP
target_sp(GetSP());
591 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
592 if (target_sp
->ResolveLoadAddress(vm_addr
, addr
))
596 // We have a load address that isn't in a section, just return an address
597 // with the offset filled in (the address) and the section set to NULL
598 addr
.SetRawAddress(vm_addr
);
602 lldb::SBAddress
SBTarget::ResolveFileAddress(lldb::addr_t file_addr
) {
603 LLDB_INSTRUMENT_VA(this, file_addr
);
605 lldb::SBAddress sb_addr
;
606 Address
&addr
= sb_addr
.ref();
607 TargetSP
target_sp(GetSP());
609 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
610 if (target_sp
->ResolveFileAddress(file_addr
, addr
))
614 addr
.SetRawAddress(file_addr
);
618 lldb::SBAddress
SBTarget::ResolvePastLoadAddress(uint32_t stop_id
,
619 lldb::addr_t vm_addr
) {
620 LLDB_INSTRUMENT_VA(this, stop_id
, vm_addr
);
622 lldb::SBAddress sb_addr
;
623 Address
&addr
= sb_addr
.ref();
624 TargetSP
target_sp(GetSP());
626 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
627 if (target_sp
->ResolveLoadAddress(vm_addr
, addr
))
631 // We have a load address that isn't in a section, just return an address
632 // with the offset filled in (the address) and the section set to NULL
633 addr
.SetRawAddress(vm_addr
);
638 SBTarget::ResolveSymbolContextForAddress(const SBAddress
&addr
,
639 uint32_t resolve_scope
) {
640 LLDB_INSTRUMENT_VA(this, addr
, resolve_scope
);
643 SymbolContextItem scope
= static_cast<SymbolContextItem
>(resolve_scope
);
644 if (addr
.IsValid()) {
645 TargetSP
target_sp(GetSP());
647 target_sp
->GetImages().ResolveSymbolContextForAddress(addr
.ref(), scope
,
653 size_t SBTarget::ReadMemory(const SBAddress addr
, void *buf
, size_t size
,
654 lldb::SBError
&error
) {
655 LLDB_INSTRUMENT_VA(this, addr
, buf
, size
, error
);
658 size_t bytes_read
= 0;
659 TargetSP
target_sp(GetSP());
661 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
663 target_sp
->ReadMemory(addr
.ref(), buf
, size
, sb_error
.ref(), true);
665 sb_error
.SetErrorString("invalid target");
671 SBBreakpoint
SBTarget::BreakpointCreateByLocation(const char *file
,
673 LLDB_INSTRUMENT_VA(this, file
, line
);
676 BreakpointCreateByLocation(SBFileSpec(file
, false), line
));
680 SBTarget::BreakpointCreateByLocation(const SBFileSpec
&sb_file_spec
,
682 LLDB_INSTRUMENT_VA(this, sb_file_spec
, line
);
684 return BreakpointCreateByLocation(sb_file_spec
, line
, 0);
688 SBTarget::BreakpointCreateByLocation(const SBFileSpec
&sb_file_spec
,
689 uint32_t line
, lldb::addr_t offset
) {
690 LLDB_INSTRUMENT_VA(this, sb_file_spec
, line
, offset
);
692 SBFileSpecList empty_list
;
693 return BreakpointCreateByLocation(sb_file_spec
, line
, offset
, empty_list
);
697 SBTarget::BreakpointCreateByLocation(const SBFileSpec
&sb_file_spec
,
698 uint32_t line
, lldb::addr_t offset
,
699 SBFileSpecList
&sb_module_list
) {
700 LLDB_INSTRUMENT_VA(this, sb_file_spec
, line
, offset
, sb_module_list
);
702 return BreakpointCreateByLocation(sb_file_spec
, line
, 0, offset
,
706 SBBreakpoint
SBTarget::BreakpointCreateByLocation(
707 const SBFileSpec
&sb_file_spec
, uint32_t line
, uint32_t column
,
708 lldb::addr_t offset
, SBFileSpecList
&sb_module_list
) {
709 LLDB_INSTRUMENT_VA(this, sb_file_spec
, line
, column
, offset
, sb_module_list
);
712 TargetSP
target_sp(GetSP());
713 if (target_sp
&& line
!= 0) {
714 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
716 const LazyBool check_inlines
= eLazyBoolCalculate
;
717 const LazyBool skip_prologue
= eLazyBoolCalculate
;
718 const bool internal
= false;
719 const bool hardware
= false;
720 const LazyBool move_to_nearest_code
= eLazyBoolCalculate
;
721 const FileSpecList
*module_list
= nullptr;
722 if (sb_module_list
.GetSize() > 0) {
723 module_list
= sb_module_list
.get();
725 sb_bp
= target_sp
->CreateBreakpoint(
726 module_list
, *sb_file_spec
, line
, column
, offset
, check_inlines
,
727 skip_prologue
, internal
, hardware
, move_to_nearest_code
);
733 SBBreakpoint
SBTarget::BreakpointCreateByLocation(
734 const SBFileSpec
&sb_file_spec
, uint32_t line
, uint32_t column
,
735 lldb::addr_t offset
, SBFileSpecList
&sb_module_list
,
736 bool move_to_nearest_code
) {
737 LLDB_INSTRUMENT_VA(this, sb_file_spec
, line
, column
, offset
, sb_module_list
,
738 move_to_nearest_code
);
741 TargetSP
target_sp(GetSP());
742 if (target_sp
&& line
!= 0) {
743 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
745 const LazyBool check_inlines
= eLazyBoolCalculate
;
746 const LazyBool skip_prologue
= eLazyBoolCalculate
;
747 const bool internal
= false;
748 const bool hardware
= false;
749 const FileSpecList
*module_list
= nullptr;
750 if (sb_module_list
.GetSize() > 0) {
751 module_list
= sb_module_list
.get();
753 sb_bp
= target_sp
->CreateBreakpoint(
754 module_list
, *sb_file_spec
, line
, column
, offset
, check_inlines
,
755 skip_prologue
, internal
, hardware
,
756 move_to_nearest_code
? eLazyBoolYes
: eLazyBoolNo
);
762 SBBreakpoint
SBTarget::BreakpointCreateByName(const char *symbol_name
,
763 const char *module_name
) {
764 LLDB_INSTRUMENT_VA(this, symbol_name
, module_name
);
767 TargetSP
target_sp(GetSP());
768 if (target_sp
.get()) {
769 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
771 const bool internal
= false;
772 const bool hardware
= false;
773 const LazyBool skip_prologue
= eLazyBoolCalculate
;
774 const lldb::addr_t offset
= 0;
775 if (module_name
&& module_name
[0]) {
776 FileSpecList module_spec_list
;
777 module_spec_list
.Append(FileSpec(module_name
));
778 sb_bp
= target_sp
->CreateBreakpoint(
779 &module_spec_list
, nullptr, symbol_name
, eFunctionNameTypeAuto
,
780 eLanguageTypeUnknown
, offset
, skip_prologue
, internal
, hardware
);
782 sb_bp
= target_sp
->CreateBreakpoint(
783 nullptr, nullptr, symbol_name
, eFunctionNameTypeAuto
,
784 eLanguageTypeUnknown
, offset
, skip_prologue
, internal
, hardware
);
792 SBTarget::BreakpointCreateByName(const char *symbol_name
,
793 const SBFileSpecList
&module_list
,
794 const SBFileSpecList
&comp_unit_list
) {
795 LLDB_INSTRUMENT_VA(this, symbol_name
, module_list
, comp_unit_list
);
797 lldb::FunctionNameType name_type_mask
= eFunctionNameTypeAuto
;
798 return BreakpointCreateByName(symbol_name
, name_type_mask
,
799 eLanguageTypeUnknown
, module_list
,
803 lldb::SBBreakpoint
SBTarget::BreakpointCreateByName(
804 const char *symbol_name
, uint32_t name_type_mask
,
805 const SBFileSpecList
&module_list
, const SBFileSpecList
&comp_unit_list
) {
806 LLDB_INSTRUMENT_VA(this, symbol_name
, name_type_mask
, module_list
,
809 return BreakpointCreateByName(symbol_name
, name_type_mask
,
810 eLanguageTypeUnknown
, module_list
,
814 lldb::SBBreakpoint
SBTarget::BreakpointCreateByName(
815 const char *symbol_name
, uint32_t name_type_mask
,
816 LanguageType symbol_language
, const SBFileSpecList
&module_list
,
817 const SBFileSpecList
&comp_unit_list
) {
818 LLDB_INSTRUMENT_VA(this, symbol_name
, name_type_mask
, symbol_language
,
819 module_list
, comp_unit_list
);
822 TargetSP
target_sp(GetSP());
823 if (target_sp
&& symbol_name
&& symbol_name
[0]) {
824 const bool internal
= false;
825 const bool hardware
= false;
826 const LazyBool skip_prologue
= eLazyBoolCalculate
;
827 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
828 FunctionNameType mask
= static_cast<FunctionNameType
>(name_type_mask
);
829 sb_bp
= target_sp
->CreateBreakpoint(module_list
.get(), comp_unit_list
.get(),
830 symbol_name
, mask
, symbol_language
, 0,
831 skip_prologue
, internal
, hardware
);
837 lldb::SBBreakpoint
SBTarget::BreakpointCreateByNames(
838 const char *symbol_names
[], uint32_t num_names
, uint32_t name_type_mask
,
839 const SBFileSpecList
&module_list
, const SBFileSpecList
&comp_unit_list
) {
840 LLDB_INSTRUMENT_VA(this, symbol_names
, num_names
, name_type_mask
, module_list
,
843 return BreakpointCreateByNames(symbol_names
, num_names
, name_type_mask
,
844 eLanguageTypeUnknown
, module_list
,
848 lldb::SBBreakpoint
SBTarget::BreakpointCreateByNames(
849 const char *symbol_names
[], uint32_t num_names
, uint32_t name_type_mask
,
850 LanguageType symbol_language
, const SBFileSpecList
&module_list
,
851 const SBFileSpecList
&comp_unit_list
) {
852 LLDB_INSTRUMENT_VA(this, symbol_names
, num_names
, name_type_mask
,
853 symbol_language
, module_list
, comp_unit_list
);
855 return BreakpointCreateByNames(symbol_names
, num_names
, name_type_mask
,
856 eLanguageTypeUnknown
, 0, module_list
,
860 lldb::SBBreakpoint
SBTarget::BreakpointCreateByNames(
861 const char *symbol_names
[], uint32_t num_names
, uint32_t name_type_mask
,
862 LanguageType symbol_language
, lldb::addr_t offset
,
863 const SBFileSpecList
&module_list
, const SBFileSpecList
&comp_unit_list
) {
864 LLDB_INSTRUMENT_VA(this, symbol_names
, num_names
, name_type_mask
,
865 symbol_language
, offset
, module_list
, comp_unit_list
);
868 TargetSP
target_sp(GetSP());
869 if (target_sp
&& num_names
> 0) {
870 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
871 const bool internal
= false;
872 const bool hardware
= false;
873 FunctionNameType mask
= static_cast<FunctionNameType
>(name_type_mask
);
874 const LazyBool skip_prologue
= eLazyBoolCalculate
;
875 sb_bp
= target_sp
->CreateBreakpoint(
876 module_list
.get(), comp_unit_list
.get(), symbol_names
, num_names
, mask
,
877 symbol_language
, offset
, skip_prologue
, internal
, hardware
);
883 SBBreakpoint
SBTarget::BreakpointCreateByRegex(const char *symbol_name_regex
,
884 const char *module_name
) {
885 LLDB_INSTRUMENT_VA(this, symbol_name_regex
, module_name
);
887 SBFileSpecList module_spec_list
;
888 SBFileSpecList comp_unit_list
;
889 if (module_name
&& module_name
[0]) {
890 module_spec_list
.Append(FileSpec(module_name
));
892 return BreakpointCreateByRegex(symbol_name_regex
, eLanguageTypeUnknown
,
893 module_spec_list
, comp_unit_list
);
897 SBTarget::BreakpointCreateByRegex(const char *symbol_name_regex
,
898 const SBFileSpecList
&module_list
,
899 const SBFileSpecList
&comp_unit_list
) {
900 LLDB_INSTRUMENT_VA(this, symbol_name_regex
, module_list
, comp_unit_list
);
902 return BreakpointCreateByRegex(symbol_name_regex
, eLanguageTypeUnknown
,
903 module_list
, comp_unit_list
);
906 lldb::SBBreakpoint
SBTarget::BreakpointCreateByRegex(
907 const char *symbol_name_regex
, LanguageType symbol_language
,
908 const SBFileSpecList
&module_list
, const SBFileSpecList
&comp_unit_list
) {
909 LLDB_INSTRUMENT_VA(this, symbol_name_regex
, symbol_language
, module_list
,
913 TargetSP
target_sp(GetSP());
914 if (target_sp
&& symbol_name_regex
&& symbol_name_regex
[0]) {
915 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
916 RegularExpression
regexp((llvm::StringRef(symbol_name_regex
)));
917 const bool internal
= false;
918 const bool hardware
= false;
919 const LazyBool skip_prologue
= eLazyBoolCalculate
;
921 sb_bp
= target_sp
->CreateFuncRegexBreakpoint(
922 module_list
.get(), comp_unit_list
.get(), std::move(regexp
),
923 symbol_language
, skip_prologue
, internal
, hardware
);
929 SBBreakpoint
SBTarget::BreakpointCreateByAddress(addr_t address
) {
930 LLDB_INSTRUMENT_VA(this, address
);
933 TargetSP
target_sp(GetSP());
935 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
936 const bool hardware
= false;
937 sb_bp
= target_sp
->CreateBreakpoint(address
, false, hardware
);
943 SBBreakpoint
SBTarget::BreakpointCreateBySBAddress(SBAddress
&sb_address
) {
944 LLDB_INSTRUMENT_VA(this, sb_address
);
947 TargetSP
target_sp(GetSP());
948 if (!sb_address
.IsValid()) {
953 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
954 const bool hardware
= false;
955 sb_bp
= target_sp
->CreateBreakpoint(sb_address
.ref(), false, hardware
);
962 SBTarget::BreakpointCreateBySourceRegex(const char *source_regex
,
963 const lldb::SBFileSpec
&source_file
,
964 const char *module_name
) {
965 LLDB_INSTRUMENT_VA(this, source_regex
, source_file
, module_name
);
967 SBFileSpecList module_spec_list
;
969 if (module_name
&& module_name
[0]) {
970 module_spec_list
.Append(FileSpec(module_name
));
973 SBFileSpecList source_file_list
;
974 if (source_file
.IsValid()) {
975 source_file_list
.Append(source_file
);
978 return BreakpointCreateBySourceRegex(source_regex
, module_spec_list
,
982 lldb::SBBreakpoint
SBTarget::BreakpointCreateBySourceRegex(
983 const char *source_regex
, const SBFileSpecList
&module_list
,
984 const lldb::SBFileSpecList
&source_file_list
) {
985 LLDB_INSTRUMENT_VA(this, source_regex
, module_list
, source_file_list
);
987 return BreakpointCreateBySourceRegex(source_regex
, module_list
,
988 source_file_list
, SBStringList());
991 lldb::SBBreakpoint
SBTarget::BreakpointCreateBySourceRegex(
992 const char *source_regex
, const SBFileSpecList
&module_list
,
993 const lldb::SBFileSpecList
&source_file_list
,
994 const SBStringList
&func_names
) {
995 LLDB_INSTRUMENT_VA(this, source_regex
, module_list
, source_file_list
,
999 TargetSP
target_sp(GetSP());
1000 if (target_sp
&& source_regex
&& source_regex
[0]) {
1001 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1002 const bool hardware
= false;
1003 const LazyBool move_to_nearest_code
= eLazyBoolCalculate
;
1004 RegularExpression
regexp((llvm::StringRef(source_regex
)));
1005 std::unordered_set
<std::string
> func_names_set
;
1006 for (size_t i
= 0; i
< func_names
.GetSize(); i
++) {
1007 func_names_set
.insert(func_names
.GetStringAtIndex(i
));
1010 sb_bp
= target_sp
->CreateSourceRegexBreakpoint(
1011 module_list
.get(), source_file_list
.get(), func_names_set
,
1012 std::move(regexp
), false, hardware
, move_to_nearest_code
);
1019 SBTarget::BreakpointCreateForException(lldb::LanguageType language
,
1020 bool catch_bp
, bool throw_bp
) {
1021 LLDB_INSTRUMENT_VA(this, language
, catch_bp
, throw_bp
);
1024 TargetSP
target_sp(GetSP());
1026 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1027 const bool hardware
= false;
1028 sb_bp
= target_sp
->CreateExceptionBreakpoint(language
, catch_bp
, throw_bp
,
1035 lldb::SBBreakpoint
SBTarget::BreakpointCreateFromScript(
1036 const char *class_name
, SBStructuredData
&extra_args
,
1037 const SBFileSpecList
&module_list
, const SBFileSpecList
&file_list
,
1038 bool request_hardware
) {
1039 LLDB_INSTRUMENT_VA(this, class_name
, extra_args
, module_list
, file_list
,
1043 TargetSP
target_sp(GetSP());
1045 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1048 StructuredData::ObjectSP obj_sp
= extra_args
.m_impl_up
->GetObjectSP();
1050 target_sp
->CreateScriptedBreakpoint(class_name
,
1053 false, /* internal */
1062 uint32_t SBTarget::GetNumBreakpoints() const {
1063 LLDB_INSTRUMENT_VA(this);
1065 TargetSP
target_sp(GetSP());
1067 // The breakpoint list is thread safe, no need to lock
1068 return target_sp
->GetBreakpointList().GetSize();
1073 SBBreakpoint
SBTarget::GetBreakpointAtIndex(uint32_t idx
) const {
1074 LLDB_INSTRUMENT_VA(this, idx
);
1076 SBBreakpoint sb_breakpoint
;
1077 TargetSP
target_sp(GetSP());
1079 // The breakpoint list is thread safe, no need to lock
1080 sb_breakpoint
= target_sp
->GetBreakpointList().GetBreakpointAtIndex(idx
);
1082 return sb_breakpoint
;
1085 bool SBTarget::BreakpointDelete(break_id_t bp_id
) {
1086 LLDB_INSTRUMENT_VA(this, bp_id
);
1088 bool result
= false;
1089 TargetSP
target_sp(GetSP());
1091 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1092 result
= target_sp
->RemoveBreakpointByID(bp_id
);
1098 SBBreakpoint
SBTarget::FindBreakpointByID(break_id_t bp_id
) {
1099 LLDB_INSTRUMENT_VA(this, bp_id
);
1101 SBBreakpoint sb_breakpoint
;
1102 TargetSP
target_sp(GetSP());
1103 if (target_sp
&& bp_id
!= LLDB_INVALID_BREAK_ID
) {
1104 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1105 sb_breakpoint
= target_sp
->GetBreakpointByID(bp_id
);
1108 return sb_breakpoint
;
1111 bool SBTarget::FindBreakpointsByName(const char *name
,
1112 SBBreakpointList
&bkpts
) {
1113 LLDB_INSTRUMENT_VA(this, name
, bkpts
);
1115 TargetSP
target_sp(GetSP());
1117 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1118 llvm::Expected
<std::vector
<BreakpointSP
>> expected_vector
=
1119 target_sp
->GetBreakpointList().FindBreakpointsByName(name
);
1120 if (!expected_vector
) {
1121 LLDB_LOG_ERROR(GetLog(LLDBLog::Breakpoints
), expected_vector
.takeError(),
1122 "invalid breakpoint name: {0}");
1125 for (BreakpointSP bkpt_sp
: *expected_vector
) {
1126 bkpts
.AppendByID(bkpt_sp
->GetID());
1132 void SBTarget::GetBreakpointNames(SBStringList
&names
) {
1133 LLDB_INSTRUMENT_VA(this, names
);
1137 TargetSP
target_sp(GetSP());
1139 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1141 std::vector
<std::string
> name_vec
;
1142 target_sp
->GetBreakpointNames(name_vec
);
1143 for (auto name
: name_vec
)
1144 names
.AppendString(name
.c_str());
1148 void SBTarget::DeleteBreakpointName(const char *name
) {
1149 LLDB_INSTRUMENT_VA(this, name
);
1151 TargetSP
target_sp(GetSP());
1153 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1154 target_sp
->DeleteBreakpointName(ConstString(name
));
1158 bool SBTarget::EnableAllBreakpoints() {
1159 LLDB_INSTRUMENT_VA(this);
1161 TargetSP
target_sp(GetSP());
1163 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1164 target_sp
->EnableAllowedBreakpoints();
1170 bool SBTarget::DisableAllBreakpoints() {
1171 LLDB_INSTRUMENT_VA(this);
1173 TargetSP
target_sp(GetSP());
1175 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1176 target_sp
->DisableAllowedBreakpoints();
1182 bool SBTarget::DeleteAllBreakpoints() {
1183 LLDB_INSTRUMENT_VA(this);
1185 TargetSP
target_sp(GetSP());
1187 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1188 target_sp
->RemoveAllowedBreakpoints();
1194 lldb::SBError
SBTarget::BreakpointsCreateFromFile(SBFileSpec
&source_file
,
1195 SBBreakpointList
&new_bps
) {
1196 LLDB_INSTRUMENT_VA(this, source_file
, new_bps
);
1198 SBStringList empty_name_list
;
1199 return BreakpointsCreateFromFile(source_file
, empty_name_list
, new_bps
);
1202 lldb::SBError
SBTarget::BreakpointsCreateFromFile(SBFileSpec
&source_file
,
1203 SBStringList
&matching_names
,
1204 SBBreakpointList
&new_bps
) {
1205 LLDB_INSTRUMENT_VA(this, source_file
, matching_names
, new_bps
);
1208 TargetSP
target_sp(GetSP());
1210 sberr
.SetErrorString(
1211 "BreakpointCreateFromFile called with invalid target.");
1214 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1216 BreakpointIDList bp_ids
;
1218 std::vector
<std::string
> name_vector
;
1219 size_t num_names
= matching_names
.GetSize();
1220 for (size_t i
= 0; i
< num_names
; i
++)
1221 name_vector
.push_back(matching_names
.GetStringAtIndex(i
));
1223 sberr
.ref() = target_sp
->CreateBreakpointsFromFile(source_file
.ref(),
1224 name_vector
, bp_ids
);
1228 size_t num_bkpts
= bp_ids
.GetSize();
1229 for (size_t i
= 0; i
< num_bkpts
; i
++) {
1230 BreakpointID bp_id
= bp_ids
.GetBreakpointIDAtIndex(i
);
1231 new_bps
.AppendByID(bp_id
.GetBreakpointID());
1236 lldb::SBError
SBTarget::BreakpointsWriteToFile(SBFileSpec
&dest_file
) {
1237 LLDB_INSTRUMENT_VA(this, dest_file
);
1240 TargetSP
target_sp(GetSP());
1242 sberr
.SetErrorString("BreakpointWriteToFile called with invalid target.");
1245 SBBreakpointList
bkpt_list(*this);
1246 return BreakpointsWriteToFile(dest_file
, bkpt_list
);
1249 lldb::SBError
SBTarget::BreakpointsWriteToFile(SBFileSpec
&dest_file
,
1250 SBBreakpointList
&bkpt_list
,
1252 LLDB_INSTRUMENT_VA(this, dest_file
, bkpt_list
, append
);
1255 TargetSP
target_sp(GetSP());
1257 sberr
.SetErrorString("BreakpointWriteToFile called with invalid target.");
1261 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1262 BreakpointIDList bp_id_list
;
1263 bkpt_list
.CopyToBreakpointIDList(bp_id_list
);
1264 sberr
.ref() = target_sp
->SerializeBreakpointsToFile(dest_file
.ref(),
1265 bp_id_list
, append
);
1269 uint32_t SBTarget::GetNumWatchpoints() const {
1270 LLDB_INSTRUMENT_VA(this);
1272 TargetSP
target_sp(GetSP());
1274 // The watchpoint list is thread safe, no need to lock
1275 return target_sp
->GetWatchpointList().GetSize();
1280 SBWatchpoint
SBTarget::GetWatchpointAtIndex(uint32_t idx
) const {
1281 LLDB_INSTRUMENT_VA(this, idx
);
1283 SBWatchpoint sb_watchpoint
;
1284 TargetSP
target_sp(GetSP());
1286 // The watchpoint list is thread safe, no need to lock
1287 sb_watchpoint
.SetSP(target_sp
->GetWatchpointList().GetByIndex(idx
));
1289 return sb_watchpoint
;
1292 bool SBTarget::DeleteWatchpoint(watch_id_t wp_id
) {
1293 LLDB_INSTRUMENT_VA(this, wp_id
);
1295 bool result
= false;
1296 TargetSP
target_sp(GetSP());
1298 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1299 std::unique_lock
<std::recursive_mutex
> lock
;
1300 target_sp
->GetWatchpointList().GetListMutex(lock
);
1301 result
= target_sp
->RemoveWatchpointByID(wp_id
);
1307 SBWatchpoint
SBTarget::FindWatchpointByID(lldb::watch_id_t wp_id
) {
1308 LLDB_INSTRUMENT_VA(this, wp_id
);
1310 SBWatchpoint sb_watchpoint
;
1311 lldb::WatchpointSP watchpoint_sp
;
1312 TargetSP
target_sp(GetSP());
1313 if (target_sp
&& wp_id
!= LLDB_INVALID_WATCH_ID
) {
1314 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1315 std::unique_lock
<std::recursive_mutex
> lock
;
1316 target_sp
->GetWatchpointList().GetListMutex(lock
);
1317 watchpoint_sp
= target_sp
->GetWatchpointList().FindByID(wp_id
);
1318 sb_watchpoint
.SetSP(watchpoint_sp
);
1321 return sb_watchpoint
;
1324 lldb::SBWatchpoint
SBTarget::WatchAddress(lldb::addr_t addr
, size_t size
,
1325 bool read
, bool modify
,
1327 LLDB_INSTRUMENT_VA(this, addr
, size
, read
, write
, error
);
1329 SBWatchpointOptions options
;
1330 options
.SetWatchpointTypeRead(read
);
1331 options
.SetWatchpointTypeWrite(eWatchpointWriteTypeOnModify
);
1332 return WatchpointCreateByAddress(addr
, size
, options
, error
);
1336 SBTarget::WatchpointCreateByAddress(lldb::addr_t addr
, size_t size
,
1337 SBWatchpointOptions options
,
1339 LLDB_INSTRUMENT_VA(this, addr
, size
, options
, error
);
1341 SBWatchpoint sb_watchpoint
;
1342 lldb::WatchpointSP watchpoint_sp
;
1343 TargetSP
target_sp(GetSP());
1344 uint32_t watch_type
= 0;
1345 if (options
.GetWatchpointTypeRead())
1346 watch_type
|= LLDB_WATCH_TYPE_READ
;
1347 if (options
.GetWatchpointTypeWrite() == eWatchpointWriteTypeAlways
)
1348 watch_type
|= LLDB_WATCH_TYPE_WRITE
;
1349 if (options
.GetWatchpointTypeWrite() == eWatchpointWriteTypeOnModify
)
1350 watch_type
|= LLDB_WATCH_TYPE_MODIFY
;
1351 if (watch_type
== 0) {
1352 error
.SetErrorString("Can't create a watchpoint that is neither read nor "
1353 "write nor modify.");
1354 return sb_watchpoint
;
1356 if (target_sp
&& addr
!= LLDB_INVALID_ADDRESS
&& size
> 0) {
1357 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1358 // Target::CreateWatchpoint() is thread safe.
1360 // This API doesn't take in a type, so we can't figure out what it is.
1361 CompilerType
*type
= nullptr;
1363 target_sp
->CreateWatchpoint(addr
, size
, type
, watch_type
, cw_error
);
1364 error
.SetError(cw_error
);
1365 sb_watchpoint
.SetSP(watchpoint_sp
);
1368 return sb_watchpoint
;
1371 bool SBTarget::EnableAllWatchpoints() {
1372 LLDB_INSTRUMENT_VA(this);
1374 TargetSP
target_sp(GetSP());
1376 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1377 std::unique_lock
<std::recursive_mutex
> lock
;
1378 target_sp
->GetWatchpointList().GetListMutex(lock
);
1379 target_sp
->EnableAllWatchpoints();
1385 bool SBTarget::DisableAllWatchpoints() {
1386 LLDB_INSTRUMENT_VA(this);
1388 TargetSP
target_sp(GetSP());
1390 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1391 std::unique_lock
<std::recursive_mutex
> lock
;
1392 target_sp
->GetWatchpointList().GetListMutex(lock
);
1393 target_sp
->DisableAllWatchpoints();
1399 SBValue
SBTarget::CreateValueFromAddress(const char *name
, SBAddress addr
,
1401 LLDB_INSTRUMENT_VA(this, name
, addr
, type
);
1404 lldb::ValueObjectSP new_value_sp
;
1405 if (IsValid() && name
&& *name
&& addr
.IsValid() && type
.IsValid()) {
1406 lldb::addr_t
load_addr(addr
.GetLoadAddress(*this));
1407 ExecutionContext
exe_ctx(
1408 ExecutionContextRef(ExecutionContext(m_opaque_sp
.get(), false)));
1409 CompilerType
ast_type(type
.GetSP()->GetCompilerType(true));
1410 new_value_sp
= ValueObject::CreateValueObjectFromAddress(name
, load_addr
,
1413 sb_value
.SetSP(new_value_sp
);
1417 lldb::SBValue
SBTarget::CreateValueFromData(const char *name
, lldb::SBData data
,
1418 lldb::SBType type
) {
1419 LLDB_INSTRUMENT_VA(this, name
, data
, type
);
1422 lldb::ValueObjectSP new_value_sp
;
1423 if (IsValid() && name
&& *name
&& data
.IsValid() && type
.IsValid()) {
1424 DataExtractorSP
extractor(*data
);
1425 ExecutionContext
exe_ctx(
1426 ExecutionContextRef(ExecutionContext(m_opaque_sp
.get(), false)));
1427 CompilerType
ast_type(type
.GetSP()->GetCompilerType(true));
1428 new_value_sp
= ValueObject::CreateValueObjectFromData(name
, *extractor
,
1431 sb_value
.SetSP(new_value_sp
);
1435 lldb::SBValue
SBTarget::CreateValueFromExpression(const char *name
,
1437 LLDB_INSTRUMENT_VA(this, name
, expr
);
1440 lldb::ValueObjectSP new_value_sp
;
1441 if (IsValid() && name
&& *name
&& expr
&& *expr
) {
1442 ExecutionContext
exe_ctx(
1443 ExecutionContextRef(ExecutionContext(m_opaque_sp
.get(), false)));
1445 ValueObject::CreateValueObjectFromExpression(name
, expr
, exe_ctx
);
1447 sb_value
.SetSP(new_value_sp
);
1451 bool SBTarget::DeleteAllWatchpoints() {
1452 LLDB_INSTRUMENT_VA(this);
1454 TargetSP
target_sp(GetSP());
1456 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
1457 std::unique_lock
<std::recursive_mutex
> lock
;
1458 target_sp
->GetWatchpointList().GetListMutex(lock
);
1459 target_sp
->RemoveAllWatchpoints();
1465 void SBTarget::AppendImageSearchPath(const char *from
, const char *to
,
1466 lldb::SBError
&error
) {
1467 LLDB_INSTRUMENT_VA(this, from
, to
, error
);
1469 TargetSP
target_sp(GetSP());
1471 return error
.SetErrorString("invalid target");
1473 llvm::StringRef srFrom
= from
, srTo
= to
;
1475 return error
.SetErrorString("<from> path can't be empty");
1477 return error
.SetErrorString("<to> path can't be empty");
1479 target_sp
->GetImageSearchPathList().Append(srFrom
, srTo
, true);
1482 lldb::SBModule
SBTarget::AddModule(const char *path
, const char *triple
,
1483 const char *uuid_cstr
) {
1484 LLDB_INSTRUMENT_VA(this, path
, triple
, uuid_cstr
);
1486 return AddModule(path
, triple
, uuid_cstr
, nullptr);
1489 lldb::SBModule
SBTarget::AddModule(const char *path
, const char *triple
,
1490 const char *uuid_cstr
, const char *symfile
) {
1491 LLDB_INSTRUMENT_VA(this, path
, triple
, uuid_cstr
, symfile
);
1493 TargetSP
target_sp(GetSP());
1497 ModuleSpec module_spec
;
1499 module_spec
.GetFileSpec().SetFile(path
, FileSpec::Style::native
);
1502 module_spec
.GetUUID().SetFromStringRef(uuid_cstr
);
1505 module_spec
.GetArchitecture() =
1506 Platform::GetAugmentedArchSpec(target_sp
->GetPlatform().get(), triple
);
1508 module_spec
.GetArchitecture() = target_sp
->GetArchitecture();
1511 module_spec
.GetSymbolFileSpec().SetFile(symfile
, FileSpec::Style::native
);
1513 SBModuleSpec
sb_modulespec(module_spec
);
1515 return AddModule(sb_modulespec
);
1518 lldb::SBModule
SBTarget::AddModule(const SBModuleSpec
&module_spec
) {
1519 LLDB_INSTRUMENT_VA(this, module_spec
);
1521 lldb::SBModule sb_module
;
1522 TargetSP
target_sp(GetSP());
1524 sb_module
.SetSP(target_sp
->GetOrCreateModule(*module_spec
.m_opaque_up
,
1525 true /* notify */));
1526 if (!sb_module
.IsValid() && module_spec
.m_opaque_up
->GetUUID().IsValid()) {
1528 if (PluginManager::DownloadObjectAndSymbolFile(*module_spec
.m_opaque_up
,
1530 /* force_lookup */ true)) {
1531 if (FileSystem::Instance().Exists(
1532 module_spec
.m_opaque_up
->GetFileSpec())) {
1533 sb_module
.SetSP(target_sp
->GetOrCreateModule(*module_spec
.m_opaque_up
,
1534 true /* notify */));
1539 // If the target hasn't initialized any architecture yet, use the
1540 // binary's architecture.
1541 if (sb_module
.IsValid() && !target_sp
->GetArchitecture().IsValid() &&
1542 sb_module
.GetSP()->GetArchitecture().IsValid())
1543 target_sp
->SetArchitecture(sb_module
.GetSP()->GetArchitecture());
1547 bool SBTarget::AddModule(lldb::SBModule
&module
) {
1548 LLDB_INSTRUMENT_VA(this, module
);
1550 TargetSP
target_sp(GetSP());
1552 target_sp
->GetImages().AppendIfNeeded(module
.GetSP());
1558 uint32_t SBTarget::GetNumModules() const {
1559 LLDB_INSTRUMENT_VA(this);
1562 TargetSP
target_sp(GetSP());
1564 // The module list is thread safe, no need to lock
1565 num
= target_sp
->GetImages().GetSize();
1571 void SBTarget::Clear() {
1572 LLDB_INSTRUMENT_VA(this);
1574 m_opaque_sp
.reset();
1577 SBModule
SBTarget::FindModule(const SBFileSpec
&sb_file_spec
) {
1578 LLDB_INSTRUMENT_VA(this, sb_file_spec
);
1581 TargetSP
target_sp(GetSP());
1582 if (target_sp
&& sb_file_spec
.IsValid()) {
1583 ModuleSpec
module_spec(*sb_file_spec
);
1584 // The module list is thread safe, no need to lock
1585 sb_module
.SetSP(target_sp
->GetImages().FindFirstModule(module_spec
));
1590 SBSymbolContextList
SBTarget::FindCompileUnits(const SBFileSpec
&sb_file_spec
) {
1591 LLDB_INSTRUMENT_VA(this, sb_file_spec
);
1593 SBSymbolContextList sb_sc_list
;
1594 const TargetSP
target_sp(GetSP());
1595 if (target_sp
&& sb_file_spec
.IsValid())
1596 target_sp
->GetImages().FindCompileUnits(*sb_file_spec
, *sb_sc_list
);
1600 lldb::ByteOrder
SBTarget::GetByteOrder() {
1601 LLDB_INSTRUMENT_VA(this);
1603 TargetSP
target_sp(GetSP());
1605 return target_sp
->GetArchitecture().GetByteOrder();
1606 return eByteOrderInvalid
;
1609 const char *SBTarget::GetTriple() {
1610 LLDB_INSTRUMENT_VA(this);
1612 TargetSP
target_sp(GetSP());
1616 std::string
triple(target_sp
->GetArchitecture().GetTriple().str());
1617 // Unique the string so we don't run into ownership issues since the const
1618 // strings put the string into the string pool once and the strings never
1620 ConstString
const_triple(triple
.c_str());
1621 return const_triple
.GetCString();
1624 const char *SBTarget::GetABIName() {
1625 LLDB_INSTRUMENT_VA(this);
1627 TargetSP
target_sp(GetSP());
1631 std::string
abi_name(target_sp
->GetABIName().str());
1632 ConstString
const_name(abi_name
.c_str());
1633 return const_name
.GetCString();
1636 const char *SBTarget::GetLabel() const {
1637 LLDB_INSTRUMENT_VA(this);
1639 TargetSP
target_sp(GetSP());
1643 return ConstString(target_sp
->GetLabel().data()).AsCString();
1646 SBError
SBTarget::SetLabel(const char *label
) {
1647 LLDB_INSTRUMENT_VA(this, label
);
1649 TargetSP
target_sp(GetSP());
1651 return Status("Couldn't get internal target object.");
1653 return Status(target_sp
->SetLabel(label
));
1656 uint32_t SBTarget::GetDataByteSize() {
1657 LLDB_INSTRUMENT_VA(this);
1659 TargetSP
target_sp(GetSP());
1661 return target_sp
->GetArchitecture().GetDataByteSize();
1666 uint32_t SBTarget::GetCodeByteSize() {
1667 LLDB_INSTRUMENT_VA(this);
1669 TargetSP
target_sp(GetSP());
1671 return target_sp
->GetArchitecture().GetCodeByteSize();
1676 uint32_t SBTarget::GetMaximumNumberOfChildrenToDisplay() const {
1677 LLDB_INSTRUMENT_VA(this);
1679 TargetSP
target_sp(GetSP());
1681 return target_sp
->GetMaximumNumberOfChildrenToDisplay();
1686 uint32_t SBTarget::GetAddressByteSize() {
1687 LLDB_INSTRUMENT_VA(this);
1689 TargetSP
target_sp(GetSP());
1691 return target_sp
->GetArchitecture().GetAddressByteSize();
1692 return sizeof(void *);
1695 SBModule
SBTarget::GetModuleAtIndex(uint32_t idx
) {
1696 LLDB_INSTRUMENT_VA(this, idx
);
1700 TargetSP
target_sp(GetSP());
1702 // The module list is thread safe, no need to lock
1703 module_sp
= target_sp
->GetImages().GetModuleAtIndex(idx
);
1704 sb_module
.SetSP(module_sp
);
1710 bool SBTarget::RemoveModule(lldb::SBModule module
) {
1711 LLDB_INSTRUMENT_VA(this, module
);
1713 TargetSP
target_sp(GetSP());
1715 return target_sp
->GetImages().Remove(module
.GetSP());
1719 SBBroadcaster
SBTarget::GetBroadcaster() const {
1720 LLDB_INSTRUMENT_VA(this);
1722 TargetSP
target_sp(GetSP());
1723 SBBroadcaster
broadcaster(target_sp
.get(), false);
1728 bool SBTarget::GetDescription(SBStream
&description
,
1729 lldb::DescriptionLevel description_level
) {
1730 LLDB_INSTRUMENT_VA(this, description
, description_level
);
1732 Stream
&strm
= description
.ref();
1734 TargetSP
target_sp(GetSP());
1736 target_sp
->Dump(&strm
, description_level
);
1738 strm
.PutCString("No value");
1743 lldb::SBSymbolContextList
SBTarget::FindFunctions(const char *name
,
1744 uint32_t name_type_mask
) {
1745 LLDB_INSTRUMENT_VA(this, name
, name_type_mask
);
1747 lldb::SBSymbolContextList sb_sc_list
;
1748 if (!name
|| !name
[0])
1751 TargetSP
target_sp(GetSP());
1755 ModuleFunctionSearchOptions function_options
;
1756 function_options
.include_symbols
= true;
1757 function_options
.include_inlines
= true;
1759 FunctionNameType mask
= static_cast<FunctionNameType
>(name_type_mask
);
1760 target_sp
->GetImages().FindFunctions(ConstString(name
), mask
,
1761 function_options
, *sb_sc_list
);
1765 lldb::SBSymbolContextList
SBTarget::FindGlobalFunctions(const char *name
,
1766 uint32_t max_matches
,
1767 MatchType matchtype
) {
1768 LLDB_INSTRUMENT_VA(this, name
, max_matches
, matchtype
);
1770 lldb::SBSymbolContextList sb_sc_list
;
1771 if (name
&& name
[0]) {
1772 llvm::StringRef
name_ref(name
);
1773 TargetSP
target_sp(GetSP());
1775 ModuleFunctionSearchOptions function_options
;
1776 function_options
.include_symbols
= true;
1777 function_options
.include_inlines
= true;
1779 std::string regexstr
;
1780 switch (matchtype
) {
1781 case eMatchTypeRegex
:
1782 target_sp
->GetImages().FindFunctions(RegularExpression(name_ref
),
1783 function_options
, *sb_sc_list
);
1785 case eMatchTypeStartsWith
:
1786 regexstr
= llvm::Regex::escape(name
) + ".*";
1787 target_sp
->GetImages().FindFunctions(RegularExpression(regexstr
),
1788 function_options
, *sb_sc_list
);
1791 target_sp
->GetImages().FindFunctions(ConstString(name
),
1792 eFunctionNameTypeAny
,
1793 function_options
, *sb_sc_list
);
1801 lldb::SBType
SBTarget::FindFirstType(const char *typename_cstr
) {
1802 LLDB_INSTRUMENT_VA(this, typename_cstr
);
1804 TargetSP
target_sp(GetSP());
1805 if (typename_cstr
&& typename_cstr
[0] && target_sp
) {
1806 ConstString
const_typename(typename_cstr
);
1807 TypeQuery
query(const_typename
.GetStringRef(),
1808 TypeQueryOptions::e_find_one
);
1809 TypeResults results
;
1810 target_sp
->GetImages().FindTypes(/*search_first=*/nullptr, query
, results
);
1811 TypeSP type_sp
= results
.GetFirstType();
1813 return SBType(type_sp
);
1814 // Didn't find the type in the symbols; Try the loaded language runtimes.
1815 if (auto process_sp
= target_sp
->GetProcessSP()) {
1816 for (auto *runtime
: process_sp
->GetLanguageRuntimes()) {
1817 if (auto vendor
= runtime
->GetDeclVendor()) {
1818 auto types
= vendor
->FindTypes(const_typename
, /*max_matches*/ 1);
1820 return SBType(types
.front());
1825 // No matches, search for basic typename matches.
1826 for (auto type_system_sp
: target_sp
->GetScratchTypeSystems())
1827 if (auto type
= type_system_sp
->GetBuiltinTypeByName(const_typename
))
1828 return SBType(type
);
1834 SBType
SBTarget::GetBasicType(lldb::BasicType type
) {
1835 LLDB_INSTRUMENT_VA(this, type
);
1837 TargetSP
target_sp(GetSP());
1839 for (auto type_system_sp
: target_sp
->GetScratchTypeSystems())
1840 if (auto compiler_type
= type_system_sp
->GetBasicTypeFromAST(type
))
1841 return SBType(compiler_type
);
1846 lldb::SBTypeList
SBTarget::FindTypes(const char *typename_cstr
) {
1847 LLDB_INSTRUMENT_VA(this, typename_cstr
);
1849 SBTypeList sb_type_list
;
1850 TargetSP
target_sp(GetSP());
1851 if (typename_cstr
&& typename_cstr
[0] && target_sp
) {
1852 ModuleList
&images
= target_sp
->GetImages();
1853 ConstString
const_typename(typename_cstr
);
1854 TypeQuery
query(typename_cstr
);
1855 TypeResults results
;
1856 images
.FindTypes(nullptr, query
, results
);
1857 for (const TypeSP
&type_sp
: results
.GetTypeMap().Types())
1858 sb_type_list
.Append(SBType(type_sp
));
1860 // Try the loaded language runtimes
1861 if (auto process_sp
= target_sp
->GetProcessSP()) {
1862 for (auto *runtime
: process_sp
->GetLanguageRuntimes()) {
1863 if (auto *vendor
= runtime
->GetDeclVendor()) {
1865 vendor
->FindTypes(const_typename
, /*max_matches*/ UINT32_MAX
);
1866 for (auto type
: types
)
1867 sb_type_list
.Append(SBType(type
));
1872 if (sb_type_list
.GetSize() == 0) {
1873 // No matches, search for basic typename matches
1874 for (auto type_system_sp
: target_sp
->GetScratchTypeSystems())
1875 if (auto compiler_type
=
1876 type_system_sp
->GetBuiltinTypeByName(const_typename
))
1877 sb_type_list
.Append(SBType(compiler_type
));
1880 return sb_type_list
;
1883 SBValueList
SBTarget::FindGlobalVariables(const char *name
,
1884 uint32_t max_matches
) {
1885 LLDB_INSTRUMENT_VA(this, name
, max_matches
);
1887 SBValueList sb_value_list
;
1889 TargetSP
target_sp(GetSP());
1890 if (name
&& target_sp
) {
1891 VariableList variable_list
;
1892 target_sp
->GetImages().FindGlobalVariables(ConstString(name
), max_matches
,
1894 if (!variable_list
.Empty()) {
1895 ExecutionContextScope
*exe_scope
= target_sp
->GetProcessSP().get();
1896 if (exe_scope
== nullptr)
1897 exe_scope
= target_sp
.get();
1898 for (const VariableSP
&var_sp
: variable_list
) {
1899 lldb::ValueObjectSP
valobj_sp(
1900 ValueObjectVariable::Create(exe_scope
, var_sp
));
1902 sb_value_list
.Append(SBValue(valobj_sp
));
1907 return sb_value_list
;
1910 SBValueList
SBTarget::FindGlobalVariables(const char *name
,
1911 uint32_t max_matches
,
1912 MatchType matchtype
) {
1913 LLDB_INSTRUMENT_VA(this, name
, max_matches
, matchtype
);
1915 SBValueList sb_value_list
;
1917 TargetSP
target_sp(GetSP());
1918 if (name
&& target_sp
) {
1919 llvm::StringRef
name_ref(name
);
1920 VariableList variable_list
;
1922 std::string regexstr
;
1923 switch (matchtype
) {
1924 case eMatchTypeNormal
:
1925 target_sp
->GetImages().FindGlobalVariables(ConstString(name
), max_matches
,
1928 case eMatchTypeRegex
:
1929 target_sp
->GetImages().FindGlobalVariables(RegularExpression(name_ref
),
1930 max_matches
, variable_list
);
1932 case eMatchTypeStartsWith
:
1933 regexstr
= "^" + llvm::Regex::escape(name
) + ".*";
1934 target_sp
->GetImages().FindGlobalVariables(RegularExpression(regexstr
),
1935 max_matches
, variable_list
);
1938 if (!variable_list
.Empty()) {
1939 ExecutionContextScope
*exe_scope
= target_sp
->GetProcessSP().get();
1940 if (exe_scope
== nullptr)
1941 exe_scope
= target_sp
.get();
1942 for (const VariableSP
&var_sp
: variable_list
) {
1943 lldb::ValueObjectSP
valobj_sp(
1944 ValueObjectVariable::Create(exe_scope
, var_sp
));
1946 sb_value_list
.Append(SBValue(valobj_sp
));
1951 return sb_value_list
;
1954 lldb::SBValue
SBTarget::FindFirstGlobalVariable(const char *name
) {
1955 LLDB_INSTRUMENT_VA(this, name
);
1957 SBValueList
sb_value_list(FindGlobalVariables(name
, 1));
1958 if (sb_value_list
.IsValid() && sb_value_list
.GetSize() > 0)
1959 return sb_value_list
.GetValueAtIndex(0);
1963 SBSourceManager
SBTarget::GetSourceManager() {
1964 LLDB_INSTRUMENT_VA(this);
1966 SBSourceManager
source_manager(*this);
1967 return source_manager
;
1970 lldb::SBInstructionList
SBTarget::ReadInstructions(lldb::SBAddress base_addr
,
1972 LLDB_INSTRUMENT_VA(this, base_addr
, count
);
1974 return ReadInstructions(base_addr
, count
, nullptr);
1977 lldb::SBInstructionList
SBTarget::ReadInstructions(lldb::SBAddress base_addr
,
1979 const char *flavor_string
) {
1980 LLDB_INSTRUMENT_VA(this, base_addr
, count
, flavor_string
);
1982 SBInstructionList sb_instructions
;
1984 TargetSP
target_sp(GetSP());
1986 Address
*addr_ptr
= base_addr
.get();
1989 DataBufferHeap
data(
1990 target_sp
->GetArchitecture().GetMaximumOpcodeByteSize() * count
, 0);
1991 bool force_live_memory
= true;
1992 lldb_private::Status error
;
1993 lldb::addr_t load_addr
= LLDB_INVALID_ADDRESS
;
1994 const size_t bytes_read
=
1995 target_sp
->ReadMemory(*addr_ptr
, data
.GetBytes(), data
.GetByteSize(),
1996 error
, force_live_memory
, &load_addr
);
1997 const bool data_from_file
= load_addr
== LLDB_INVALID_ADDRESS
;
1998 sb_instructions
.SetDisassembler(Disassembler::DisassembleBytes(
1999 target_sp
->GetArchitecture(), nullptr, flavor_string
, *addr_ptr
,
2000 data
.GetBytes(), bytes_read
, count
, data_from_file
));
2004 return sb_instructions
;
2007 lldb::SBInstructionList
SBTarget::GetInstructions(lldb::SBAddress base_addr
,
2010 LLDB_INSTRUMENT_VA(this, base_addr
, buf
, size
);
2012 return GetInstructionsWithFlavor(base_addr
, nullptr, buf
, size
);
2015 lldb::SBInstructionList
2016 SBTarget::GetInstructionsWithFlavor(lldb::SBAddress base_addr
,
2017 const char *flavor_string
, const void *buf
,
2019 LLDB_INSTRUMENT_VA(this, base_addr
, flavor_string
, buf
, size
);
2021 SBInstructionList sb_instructions
;
2023 TargetSP
target_sp(GetSP());
2027 if (base_addr
.get())
2028 addr
= *base_addr
.get();
2030 const bool data_from_file
= true;
2032 sb_instructions
.SetDisassembler(Disassembler::DisassembleBytes(
2033 target_sp
->GetArchitecture(), nullptr, flavor_string
, addr
, buf
, size
,
2034 UINT32_MAX
, data_from_file
));
2037 return sb_instructions
;
2040 lldb::SBInstructionList
SBTarget::GetInstructions(lldb::addr_t base_addr
,
2043 LLDB_INSTRUMENT_VA(this, base_addr
, buf
, size
);
2045 return GetInstructionsWithFlavor(ResolveLoadAddress(base_addr
), nullptr, buf
,
2049 lldb::SBInstructionList
2050 SBTarget::GetInstructionsWithFlavor(lldb::addr_t base_addr
,
2051 const char *flavor_string
, const void *buf
,
2053 LLDB_INSTRUMENT_VA(this, base_addr
, flavor_string
, buf
, size
);
2055 return GetInstructionsWithFlavor(ResolveLoadAddress(base_addr
), flavor_string
,
2059 SBError
SBTarget::SetSectionLoadAddress(lldb::SBSection section
,
2060 lldb::addr_t section_base_addr
) {
2061 LLDB_INSTRUMENT_VA(this, section
, section_base_addr
);
2064 TargetSP
target_sp(GetSP());
2066 if (!section
.IsValid()) {
2067 sb_error
.SetErrorStringWithFormat("invalid section");
2069 SectionSP
section_sp(section
.GetSP());
2071 if (section_sp
->IsThreadSpecific()) {
2072 sb_error
.SetErrorString(
2073 "thread specific sections are not yet supported");
2075 ProcessSP
process_sp(target_sp
->GetProcessSP());
2076 if (target_sp
->SetSectionLoadAddress(section_sp
, section_base_addr
)) {
2077 ModuleSP
module_sp(section_sp
->GetModule());
2079 ModuleList module_list
;
2080 module_list
.Append(module_sp
);
2081 target_sp
->ModulesDidLoad(module_list
);
2083 // Flush info in the process (stack frames, etc)
2085 process_sp
->Flush();
2091 sb_error
.SetErrorString("invalid target");
2096 SBError
SBTarget::ClearSectionLoadAddress(lldb::SBSection section
) {
2097 LLDB_INSTRUMENT_VA(this, section
);
2101 TargetSP
target_sp(GetSP());
2103 if (!section
.IsValid()) {
2104 sb_error
.SetErrorStringWithFormat("invalid section");
2106 SectionSP
section_sp(section
.GetSP());
2108 ProcessSP
process_sp(target_sp
->GetProcessSP());
2109 if (target_sp
->SetSectionUnloaded(section_sp
)) {
2110 ModuleSP
module_sp(section_sp
->GetModule());
2112 ModuleList module_list
;
2113 module_list
.Append(module_sp
);
2114 target_sp
->ModulesDidUnload(module_list
, false);
2116 // Flush info in the process (stack frames, etc)
2118 process_sp
->Flush();
2121 sb_error
.SetErrorStringWithFormat("invalid section");
2125 sb_error
.SetErrorStringWithFormat("invalid target");
2130 SBError
SBTarget::SetModuleLoadAddress(lldb::SBModule module
,
2131 int64_t slide_offset
) {
2132 LLDB_INSTRUMENT_VA(this, module
, slide_offset
);
2134 if (slide_offset
< 0) {
2136 sb_error
.SetErrorStringWithFormat("slide must be positive");
2140 return SetModuleLoadAddress(module
, static_cast<uint64_t>(slide_offset
));
2143 SBError
SBTarget::SetModuleLoadAddress(lldb::SBModule module
,
2144 uint64_t slide_offset
) {
2148 TargetSP
target_sp(GetSP());
2150 ModuleSP
module_sp(module
.GetSP());
2152 bool changed
= false;
2153 if (module_sp
->SetLoadAddress(*target_sp
, slide_offset
, true, changed
)) {
2154 // The load was successful, make sure that at least some sections
2155 // changed before we notify that our module was loaded.
2157 ModuleList module_list
;
2158 module_list
.Append(module_sp
);
2159 target_sp
->ModulesDidLoad(module_list
);
2160 // Flush info in the process (stack frames, etc)
2161 ProcessSP
process_sp(target_sp
->GetProcessSP());
2163 process_sp
->Flush();
2167 sb_error
.SetErrorStringWithFormat("invalid module");
2171 sb_error
.SetErrorStringWithFormat("invalid target");
2176 SBError
SBTarget::ClearModuleLoadAddress(lldb::SBModule module
) {
2177 LLDB_INSTRUMENT_VA(this, module
);
2181 char path
[PATH_MAX
];
2182 TargetSP
target_sp(GetSP());
2184 ModuleSP
module_sp(module
.GetSP());
2186 ObjectFile
*objfile
= module_sp
->GetObjectFile();
2188 SectionList
*section_list
= objfile
->GetSectionList();
2190 ProcessSP
process_sp(target_sp
->GetProcessSP());
2192 bool changed
= false;
2193 const size_t num_sections
= section_list
->GetSize();
2194 for (size_t sect_idx
= 0; sect_idx
< num_sections
; ++sect_idx
) {
2195 SectionSP
section_sp(section_list
->GetSectionAtIndex(sect_idx
));
2197 changed
|= target_sp
->SetSectionUnloaded(section_sp
);
2200 ModuleList module_list
;
2201 module_list
.Append(module_sp
);
2202 target_sp
->ModulesDidUnload(module_list
, false);
2203 // Flush info in the process (stack frames, etc)
2204 ProcessSP
process_sp(target_sp
->GetProcessSP());
2206 process_sp
->Flush();
2209 module_sp
->GetFileSpec().GetPath(path
, sizeof(path
));
2210 sb_error
.SetErrorStringWithFormat("no sections in object file '%s'",
2214 module_sp
->GetFileSpec().GetPath(path
, sizeof(path
));
2215 sb_error
.SetErrorStringWithFormat("no object file for module '%s'",
2219 sb_error
.SetErrorStringWithFormat("invalid module");
2222 sb_error
.SetErrorStringWithFormat("invalid target");
2227 lldb::SBSymbolContextList
SBTarget::FindSymbols(const char *name
,
2228 lldb::SymbolType symbol_type
) {
2229 LLDB_INSTRUMENT_VA(this, name
, symbol_type
);
2231 SBSymbolContextList sb_sc_list
;
2232 if (name
&& name
[0]) {
2233 TargetSP
target_sp(GetSP());
2235 target_sp
->GetImages().FindSymbolsWithNameAndType(
2236 ConstString(name
), symbol_type
, *sb_sc_list
);
2241 lldb::SBValue
SBTarget::EvaluateExpression(const char *expr
) {
2242 LLDB_INSTRUMENT_VA(this, expr
);
2244 TargetSP
target_sp(GetSP());
2248 SBExpressionOptions options
;
2249 lldb::DynamicValueType fetch_dynamic_value
=
2250 target_sp
->GetPreferDynamicValue();
2251 options
.SetFetchDynamicValue(fetch_dynamic_value
);
2252 options
.SetUnwindOnError(true);
2253 return EvaluateExpression(expr
, options
);
2256 lldb::SBValue
SBTarget::EvaluateExpression(const char *expr
,
2257 const SBExpressionOptions
&options
) {
2258 LLDB_INSTRUMENT_VA(this, expr
, options
);
2260 Log
*expr_log
= GetLog(LLDBLog::Expressions
);
2261 SBValue expr_result
;
2262 ValueObjectSP expr_value_sp
;
2263 TargetSP
target_sp(GetSP());
2264 StackFrame
*frame
= nullptr;
2266 if (expr
== nullptr || expr
[0] == '\0') {
2270 std::lock_guard
<std::recursive_mutex
> guard(target_sp
->GetAPIMutex());
2271 ExecutionContext
exe_ctx(m_opaque_sp
.get());
2273 frame
= exe_ctx
.GetFramePtr();
2274 Target
*target
= exe_ctx
.GetTargetPtr();
2275 Process
*process
= exe_ctx
.GetProcessPtr();
2278 // If we have a process, make sure to lock the runlock:
2280 Process::StopLocker stop_locker
;
2281 if (stop_locker
.TryLock(&process
->GetRunLock())) {
2282 target
->EvaluateExpression(expr
, frame
, expr_value_sp
, options
.ref());
2285 error
.SetErrorString("can't evaluate expressions when the "
2286 "process is running.");
2287 expr_value_sp
= ValueObjectConstResult::Create(nullptr, error
);
2290 target
->EvaluateExpression(expr
, frame
, expr_value_sp
, options
.ref());
2293 expr_result
.SetSP(expr_value_sp
, options
.GetFetchDynamicValue());
2297 "** [SBTarget::EvaluateExpression] Expression result is "
2298 "%s, summary %s **",
2299 expr_result
.GetValue(), expr_result
.GetSummary());
2303 lldb::addr_t
SBTarget::GetStackRedZoneSize() {
2304 LLDB_INSTRUMENT_VA(this);
2306 TargetSP
target_sp(GetSP());
2309 ProcessSP
process_sp(target_sp
->GetProcessSP());
2311 abi_sp
= process_sp
->GetABI();
2313 abi_sp
= ABI::FindPlugin(ProcessSP(), target_sp
->GetArchitecture());
2315 return abi_sp
->GetRedZoneSize();
2320 bool SBTarget::IsLoaded(const SBModule
&module
) const {
2321 LLDB_INSTRUMENT_VA(this, module
);
2323 TargetSP
target_sp(GetSP());
2327 ModuleSP
module_sp(module
.GetSP());
2331 return module_sp
->IsLoadedInTarget(target_sp
.get());
2334 lldb::SBLaunchInfo
SBTarget::GetLaunchInfo() const {
2335 LLDB_INSTRUMENT_VA(this);
2337 lldb::SBLaunchInfo
launch_info(nullptr);
2338 TargetSP
target_sp(GetSP());
2340 launch_info
.set_ref(m_opaque_sp
->GetProcessLaunchInfo());
2344 void SBTarget::SetLaunchInfo(const lldb::SBLaunchInfo
&launch_info
) {
2345 LLDB_INSTRUMENT_VA(this, launch_info
);
2347 TargetSP
target_sp(GetSP());
2349 m_opaque_sp
->SetProcessLaunchInfo(launch_info
.ref());
2352 SBEnvironment
SBTarget::GetEnvironment() {
2353 LLDB_INSTRUMENT_VA(this);
2354 TargetSP
target_sp(GetSP());
2357 return SBEnvironment(target_sp
->GetEnvironment());
2360 return SBEnvironment();
2363 lldb::SBTrace
SBTarget::GetTrace() {
2364 LLDB_INSTRUMENT_VA(this);
2365 TargetSP
target_sp(GetSP());
2368 return SBTrace(target_sp
->GetTrace());
2373 lldb::SBTrace
SBTarget::CreateTrace(lldb::SBError
&error
) {
2374 LLDB_INSTRUMENT_VA(this, error
);
2375 TargetSP
target_sp(GetSP());
2379 if (llvm::Expected
<lldb::TraceSP
> trace_sp
= target_sp
->CreateTrace()) {
2380 return SBTrace(*trace_sp
);
2382 error
.SetErrorString(llvm::toString(trace_sp
.takeError()).c_str());
2385 error
.SetErrorString("missing target");