LLDB  mainline
AppleObjCRuntime.cpp
Go to the documentation of this file.
1 //===-- AppleObjCRuntime.cpp ----------------------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "AppleObjCRuntime.h"
10 #include "AppleObjCRuntimeV1.h"
11 #include "AppleObjCRuntimeV2.h"
17 #include "lldb/Core/Module.h"
18 #include "lldb/Core/ModuleList.h"
20 #include "lldb/Core/Section.h"
21 #include "lldb/Core/ValueObject.h"
26 #include "lldb/Symbol/ObjectFile.h"
28 #include "lldb/Target/Process.h"
30 #include "lldb/Target/StopInfo.h"
31 #include "lldb/Target/Target.h"
32 #include "lldb/Target/Thread.h"
34 #include "lldb/Utility/Log.h"
35 #include "lldb/Utility/Scalar.h"
36 #include "lldb/Utility/Status.h"
38 #include "clang/AST/Type.h"
39 
41 
42 #include <vector>
43 
44 using namespace lldb;
45 using namespace lldb_private;
46 
48 
49 char AppleObjCRuntime::ID = 0;
50 
51 AppleObjCRuntime::~AppleObjCRuntime() {}
52 
53 AppleObjCRuntime::AppleObjCRuntime(Process *process)
54  : ObjCLanguageRuntime(process), m_read_objc_library(false),
55  m_objc_trampoline_handler_up(), m_Foundation_major() {
57 }
58 
62 }
63 
67 }
68 
70  CompilerType compiler_type(valobj.GetCompilerType());
71  bool is_signed;
72  // ObjC objects can only be pointers (or numbers that actually represents
73  // pointers but haven't been typecast, because reasons..)
74  if (!compiler_type.IsIntegerType(is_signed) && !compiler_type.IsPointerType())
75  return false;
76 
77  // Make the argument list: we pass one arg, the address of our pointer, to
78  // the print function.
79  Value val;
80 
81  if (!valobj.ResolveValue(val.GetScalar()))
82  return false;
83 
84  // Value Objects may not have a process in their ExecutionContextRef. But we
85  // need to have one in the ref we pass down to eventually call description.
86  // Get it from the target if it isn't present.
87  ExecutionContext exe_ctx;
88  if (valobj.GetProcessSP()) {
89  exe_ctx = ExecutionContext(valobj.GetExecutionContextRef());
90  } else {
91  exe_ctx.SetContext(valobj.GetTargetSP(), true);
92  if (!exe_ctx.HasProcessScope())
93  return false;
94  }
95  return GetObjectDescription(str, val, exe_ctx.GetBestExecutionContextScope());
96 }
98  ExecutionContextScope *exe_scope) {
100  return false;
101 
102  ExecutionContext exe_ctx;
103  exe_scope->CalculateExecutionContext(exe_ctx);
104  Process *process = exe_ctx.GetProcessPtr();
105  if (!process)
106  return false;
107 
108  // We need other parts of the exe_ctx, but the processes have to match.
109  assert(m_process == process);
110 
111  // Get the function address for the print function.
112  const Address *function_address = GetPrintForDebuggerAddr();
113  if (!function_address)
114  return false;
115 
116  Target *target = exe_ctx.GetTargetPtr();
117  CompilerType compiler_type = value.GetCompilerType();
118  if (compiler_type) {
119  if (!TypeSystemClang::IsObjCObjectPointerType(compiler_type)) {
120  strm.Printf("Value doesn't point to an ObjC object.\n");
121  return false;
122  }
123  } else {
124  // If it is not a pointer, see if we can make it into a pointer.
125  TypeSystemClang *ast_context =
127  if (!ast_context)
128  return false;
129 
130  CompilerType opaque_type = ast_context->GetBasicType(eBasicTypeObjCID);
131  if (!opaque_type)
132  opaque_type = ast_context->GetBasicType(eBasicTypeVoid).GetPointerType();
133  // value.SetContext(Value::eContextTypeClangType, opaque_type_ptr);
134  value.SetCompilerType(opaque_type);
135  }
136 
137  ValueList arg_value_list;
138  arg_value_list.PushValue(value);
139 
140  // This is the return value:
142  if (!ast_context)
143  return false;
144 
145  CompilerType return_compiler_type = ast_context->GetCStringType(true);
146  Value ret;
147  // ret.SetContext(Value::eContextTypeClangType, return_compiler_type);
148  ret.SetCompilerType(return_compiler_type);
149 
150  if (exe_ctx.GetFramePtr() == nullptr) {
151  Thread *thread = exe_ctx.GetThreadPtr();
152  if (thread == nullptr) {
153  exe_ctx.SetThreadSP(process->GetThreadList().GetSelectedThread());
154  thread = exe_ctx.GetThreadPtr();
155  }
156  if (thread) {
157  exe_ctx.SetFrameSP(thread->GetSelectedFrame());
158  }
159  }
160 
161  // Now we're ready to call the function:
162 
163  DiagnosticManager diagnostics;
164  lldb::addr_t wrapper_struct_addr = LLDB_INVALID_ADDRESS;
165 
167  Status error;
169  exe_scope->CalculateTarget()->GetFunctionCallerForLanguage(
170  eLanguageTypeObjC, return_compiler_type, *function_address,
171  arg_value_list, "objc-object-description", error));
172  if (error.Fail()) {
173  m_print_object_caller_up.reset();
174  strm.Printf("Could not get function runner to call print for debugger "
175  "function: %s.",
176  error.AsCString());
177  return false;
178  }
179  m_print_object_caller_up->InsertFunction(exe_ctx, wrapper_struct_addr,
180  diagnostics);
181  } else {
182  m_print_object_caller_up->WriteFunctionArguments(
183  exe_ctx, wrapper_struct_addr, arg_value_list, diagnostics);
184  }
185 
187  options.SetUnwindOnError(true);
188  options.SetTryAllThreads(true);
189  options.SetStopOthers(true);
190  options.SetIgnoreBreakpoints(true);
191  options.SetTimeout(process->GetUtilityExpressionTimeout());
192  options.SetIsForUtilityExpr(true);
193 
194  ExpressionResults results = m_print_object_caller_up->ExecuteFunction(
195  exe_ctx, &wrapper_struct_addr, options, diagnostics, ret);
196  if (results != eExpressionCompleted) {
197  strm.Printf("Error evaluating Print Object function: %d.\n", results);
198  return false;
199  }
200 
201  addr_t result_ptr = ret.GetScalar().ULongLong(LLDB_INVALID_ADDRESS);
202 
203  char buf[512];
204  size_t cstr_len = 0;
205  size_t full_buffer_len = sizeof(buf) - 1;
206  size_t curr_len = full_buffer_len;
207  while (curr_len == full_buffer_len) {
208  Status error;
209  curr_len = process->ReadCStringFromMemory(result_ptr + cstr_len, buf,
210  sizeof(buf), error);
211  strm.Write(buf, curr_len);
212  cstr_len += curr_len;
213  }
214  return cstr_len > 0;
215 }
216 
218  ModuleSP module_sp(m_objc_module_wp.lock());
219  if (module_sp)
220  return module_sp;
221 
222  Process *process = GetProcess();
223  if (process) {
224  const ModuleList &modules = process->GetTarget().GetImages();
225  for (uint32_t idx = 0; idx < modules.GetSize(); idx++) {
226  module_sp = modules.GetModuleAtIndex(idx);
228  m_objc_module_wp = module_sp;
229  return module_sp;
230  }
231  }
232  }
233  return ModuleSP();
234 }
235 
238  const ModuleList &modules = m_process->GetTarget().GetImages();
239 
240  SymbolContextList contexts;
241  SymbolContext context;
242 
243  modules.FindSymbolsWithNameAndType(ConstString("_NSPrintForDebugger"),
244  eSymbolTypeCode, contexts);
245  if (contexts.IsEmpty()) {
246  modules.FindSymbolsWithNameAndType(ConstString("_CFPrintForDebugger"),
247  eSymbolTypeCode, contexts);
248  if (contexts.IsEmpty())
249  return nullptr;
250  }
251 
252  contexts.GetContextAtIndex(0, context);
253 
255  std::make_unique<Address>(context.symbol->GetAddress());
256  }
257 
258  return m_PrintForDebugger_addr.get();
259 }
260 
262  return in_value.GetCompilerType().IsPossibleDynamicType(
263  nullptr,
264  false, // do not check C++
265  true); // check ObjC
266 }
267 
269  ValueObject &in_value, lldb::DynamicValueType use_dynamic,
270  TypeAndOrName &class_type_or_name, Address &address,
271  Value::ValueType &value_type) {
272  return false;
273 }
274 
277  ValueObject &static_value) {
278  CompilerType static_type(static_value.GetCompilerType());
279  Flags static_type_flags(static_type.GetTypeInfo());
280 
281  TypeAndOrName ret(type_and_or_name);
282  if (type_and_or_name.HasType()) {
283  // The type will always be the type of the dynamic object. If our parent's
284  // type was a pointer, then our type should be a pointer to the type of the
285  // dynamic object. If a reference, then the original type should be
286  // okay...
287  CompilerType orig_type = type_and_or_name.GetCompilerType();
288  CompilerType corrected_type = orig_type;
289  if (static_type_flags.AllSet(eTypeIsPointer))
290  corrected_type = orig_type.GetPointerType();
291  ret.SetCompilerType(corrected_type);
292  } else {
293  // If we are here we need to adjust our dynamic type name to include the
294  // correct & or * symbol
295  std::string corrected_name(type_and_or_name.GetName().GetCString());
296  if (static_type_flags.AllSet(eTypeIsPointer))
297  corrected_name.append(" *");
298  // the parent type should be a correctly pointer'ed or referenc'ed type
299  ret.SetCompilerType(static_type);
300  ret.SetName(corrected_name.c_str());
301  }
302  return ret;
303 }
304 
305 bool AppleObjCRuntime::AppleIsModuleObjCLibrary(const ModuleSP &module_sp) {
306  if (module_sp) {
307  const FileSpec &module_file_spec = module_sp->GetFileSpec();
308  static ConstString ObjCName("libobjc.A.dylib");
309 
310  if (module_file_spec) {
311  if (module_file_spec.GetFilename() == ObjCName)
312  return true;
313  }
314  }
315  return false;
316 }
317 
318 // we use the version of Foundation to make assumptions about the ObjC runtime
319 // on a target
321  if (!m_Foundation_major.hasValue()) {
322  const ModuleList &modules = m_process->GetTarget().GetImages();
323  for (uint32_t idx = 0; idx < modules.GetSize(); idx++) {
324  lldb::ModuleSP module_sp = modules.GetModuleAtIndex(idx);
325  if (!module_sp)
326  continue;
327  if (strcmp(module_sp->GetFileSpec().GetFilename().AsCString(""),
328  "Foundation") == 0) {
329  m_Foundation_major = module_sp->GetVersion().getMajor();
330  return *m_Foundation_major;
331  }
332  }
334  } else
335  return m_Foundation_major.getValue();
336 }
337 
339  lldb::addr_t &cf_false) {
340  cf_true = cf_false = LLDB_INVALID_ADDRESS;
341 }
342 
343 bool AppleObjCRuntime::IsModuleObjCLibrary(const ModuleSP &module_sp) {
344  return AppleIsModuleObjCLibrary(module_sp);
345 }
346 
347 bool AppleObjCRuntime::ReadObjCLibrary(const ModuleSP &module_sp) {
348  // Maybe check here and if we have a handler already, and the UUID of this
349  // module is the same as the one in the current module, then we don't have to
350  // reread it?
351  m_objc_trampoline_handler_up = std::make_unique<AppleObjCTrampolineHandler>(
352  m_process->shared_from_this(), module_sp);
353  if (m_objc_trampoline_handler_up != nullptr) {
354  m_read_objc_library = true;
355  return true;
356  } else
357  return false;
358 }
359 
361  bool stop_others) {
362  ThreadPlanSP thread_plan_sp;
364  thread_plan_sp = m_objc_trampoline_handler_up->GetStepThroughDispatchPlan(
365  thread, stop_others);
366  return thread_plan_sp;
367 }
368 
369 // Static Functions
371 AppleObjCRuntime::GetObjCVersion(Process *process, ModuleSP &objc_module_sp) {
372  if (!process)
374 
375  Target &target = process->GetTarget();
376  if (target.GetArchitecture().GetTriple().getVendor() !=
377  llvm::Triple::VendorType::Apple)
379 
380  for (ModuleSP module_sp : target.GetImages().Modules()) {
381  // One tricky bit here is that we might get called as part of the initial
382  // module loading, but before all the pre-run libraries get winnowed from
383  // the module list. So there might actually be an old and incorrect ObjC
384  // library sitting around in the list, and we don't want to look at that.
385  // That's why we call IsLoadedInTarget.
386 
387  if (AppleIsModuleObjCLibrary(module_sp) &&
388  module_sp->IsLoadedInTarget(&target)) {
389  objc_module_sp = module_sp;
390  ObjectFile *ofile = module_sp->GetObjectFile();
391  if (!ofile)
393 
394  SectionList *sections = module_sp->GetSectionList();
395  if (!sections)
397  SectionSP v1_telltale_section_sp =
398  sections->FindSectionByName(ConstString("__OBJC"));
399  if (v1_telltale_section_sp) {
401  }
403  }
404  }
405 
407 }
408 
410  const bool catch_bp = false;
411  const bool throw_bp = true;
412  const bool is_internal = true;
413 
414  if (!m_objc_exception_bp_sp) {
416  m_process->GetTarget(), GetLanguageType(), catch_bp, throw_bp,
417  is_internal);
419  m_objc_exception_bp_sp->SetBreakpointKind("ObjC exception");
420  } else
421  m_objc_exception_bp_sp->SetEnabled(true);
422 }
423 
425  if (!m_process)
426  return;
427 
428  if (m_objc_exception_bp_sp.get()) {
429  m_objc_exception_bp_sp->SetEnabled(false);
430  }
431 }
432 
434  return m_objc_exception_bp_sp && m_objc_exception_bp_sp->IsEnabled();
435 }
436 
438  lldb::StopInfoSP stop_reason) {
439  if (!m_process)
440  return false;
441 
442  if (!stop_reason || stop_reason->GetStopReason() != eStopReasonBreakpoint)
443  return false;
444 
445  uint64_t break_site_id = stop_reason->GetValue();
447  break_site_id, m_objc_exception_bp_sp->GetID());
448 }
449 
451  if (!m_process)
452  return false;
453 
454  Target &target(m_process->GetTarget());
455 
456  static ConstString s_method_signature(
457  "-[NSDictionary objectForKeyedSubscript:]");
458  static ConstString s_arclite_method_signature(
459  "__arclite_objectForKeyedSubscript");
460 
461  SymbolContextList sc_list;
462 
463  target.GetImages().FindSymbolsWithNameAndType(s_method_signature,
464  eSymbolTypeCode, sc_list);
465  if (sc_list.IsEmpty())
466  target.GetImages().FindSymbolsWithNameAndType(s_arclite_method_signature,
467  eSymbolTypeCode, sc_list);
468  return !sc_list.IsEmpty();
469 }
470 
472  Target &target = m_process->GetTarget();
473 
474  FileSpecList filter_modules;
475  if (target.GetArchitecture().GetTriple().getVendor() == llvm::Triple::Apple) {
476  filter_modules.Append(std::get<0>(GetExceptionThrowLocation()));
477  }
478  return target.GetSearchFilterForModuleList(&filter_modules);
479 }
480 
482  ThreadSP thread_sp) {
484  if (!cpp_runtime) return ValueObjectSP();
485  auto cpp_exception = cpp_runtime->GetExceptionObjectForThread(thread_sp);
486  if (!cpp_exception) return ValueObjectSP();
487 
488  auto descriptor = GetClassDescriptor(*cpp_exception);
489  if (!descriptor || !descriptor->IsValid()) return ValueObjectSP();
490 
491  while (descriptor) {
492  ConstString class_name(descriptor->GetClassName());
493  if (class_name == "NSException")
494  return cpp_exception;
495  descriptor = descriptor->GetSuperclass();
496  }
497 
498  return ValueObjectSP();
499 }
500 
501 /// Utility method for error handling in GetBacktraceThreadFromException.
502 /// \param msg The message to add to the log.
503 /// \return An invalid ThreadSP to be returned from
504 /// GetBacktraceThreadFromException.
505 LLVM_NODISCARD
506 static ThreadSP FailExceptionParsing(llvm::StringRef msg) {
508  LLDB_LOG(log, "Failed getting backtrace from exception: {0}", msg);
509  return ThreadSP();
510 }
511 
513  lldb::ValueObjectSP exception_sp) {
514  ValueObjectSP reserved_dict =
515  exception_sp->GetChildMemberWithName(ConstString("reserved"), true);
516  if (!reserved_dict)
517  return FailExceptionParsing("Failed to get 'reserved' member.");
518 
519  reserved_dict = reserved_dict->GetSyntheticValue();
520  if (!reserved_dict)
521  return FailExceptionParsing("Failed to get synthetic value.");
522 
523  TypeSystemClang *clang_ast_context =
524  ScratchTypeSystemClang::GetForTarget(*exception_sp->GetTargetSP());
525  if (!clang_ast_context)
526  return FailExceptionParsing("Failed to get scratch AST.");
527  CompilerType objc_id =
528  clang_ast_context->GetBasicType(lldb::eBasicTypeObjCID);
529  ValueObjectSP return_addresses;
530 
531  auto objc_object_from_address = [&exception_sp, &objc_id](uint64_t addr,
532  const char *name) {
533  Value value(addr);
534  value.SetCompilerType(objc_id);
535  auto object = ValueObjectConstResult::Create(
536  exception_sp->GetTargetSP().get(), value, ConstString(name));
537  object = object->GetDynamicValue(eDynamicDontRunTarget);
538  return object;
539  };
540 
541  for (size_t idx = 0; idx < reserved_dict->GetNumChildren(); idx++) {
542  ValueObjectSP dict_entry = reserved_dict->GetChildAtIndex(idx, true);
543 
544  DataExtractor data;
545  data.SetAddressByteSize(dict_entry->GetProcessSP()->GetAddressByteSize());
546  Status error;
547  dict_entry->GetData(data, error);
548  if (error.Fail()) return ThreadSP();
549 
550  lldb::offset_t data_offset = 0;
551  auto dict_entry_key = data.GetAddress(&data_offset);
552  auto dict_entry_value = data.GetAddress(&data_offset);
553 
554  auto key_nsstring = objc_object_from_address(dict_entry_key, "key");
555  StreamString key_summary;
557  *key_nsstring, key_summary, TypeSummaryOptions()) &&
558  !key_summary.Empty()) {
559  if (key_summary.GetString() == "\"callStackReturnAddresses\"") {
560  return_addresses = objc_object_from_address(dict_entry_value,
561  "callStackReturnAddresses");
562  break;
563  }
564  }
565  }
566 
567  if (!return_addresses)
568  return FailExceptionParsing("Failed to get return addresses.");
569  auto frames_value =
570  return_addresses->GetChildMemberWithName(ConstString("_frames"), true);
571  if (!frames_value)
572  return FailExceptionParsing("Failed to get frames_value.");
573  addr_t frames_addr = frames_value->GetValueAsUnsigned(0);
574  auto count_value =
575  return_addresses->GetChildMemberWithName(ConstString("_cnt"), true);
576  if (!count_value)
577  return FailExceptionParsing("Failed to get count_value.");
578  size_t count = count_value->GetValueAsUnsigned(0);
579  auto ignore_value =
580  return_addresses->GetChildMemberWithName(ConstString("_ignore"), true);
581  if (!ignore_value)
582  return FailExceptionParsing("Failed to get ignore_value.");
583  size_t ignore = ignore_value->GetValueAsUnsigned(0);
584 
585  size_t ptr_size = m_process->GetAddressByteSize();
586  std::vector<lldb::addr_t> pcs;
587  for (size_t idx = 0; idx < count; idx++) {
588  Status error;
590  frames_addr + (ignore + idx) * ptr_size, error);
591  pcs.push_back(pc);
592  }
593 
594  if (pcs.empty())
595  return FailExceptionParsing("Failed to get PC list.");
596 
597  ThreadSP new_thread_sp(new HistoryThread(*m_process, 0, pcs));
598  m_process->GetExtendedThreadList().AddThread(new_thread_sp);
599  return new_thread_sp;
600 }
601 
602 std::tuple<FileSpec, ConstString>
604  return std::make_tuple(
605  FileSpec("libobjc.A.dylib"), ConstString("objc_exception_throw"));
606 }
607 
609  if (!HasReadObjCLibrary()) {
610  std::lock_guard<std::recursive_mutex> guard(module_list.GetMutex());
611 
612  size_t num_modules = module_list.GetSize();
613  for (size_t i = 0; i < num_modules; i++) {
614  auto mod = module_list.GetModuleAtIndex(i);
615  if (IsModuleObjCLibrary(mod)) {
616  ReadObjCLibrary(mod);
617  break;
618  }
619  }
620  }
621 }
622 
624  ReadObjCLibraryIfNeeded(module_list);
625 }
lldb_private::AppleObjCRuntime::Terminate
static void Terminate()
Definition: AppleObjCRuntime.cpp:64
lldb_private::ExecutionContext
Definition: ExecutionContext.h:291
lldb_private::SectionList::FindSectionByName
lldb::SectionSP FindSectionByName(ConstString section_dstr) const
Definition: Section.cpp:484
Scalar.h
FailExceptionParsing
static LLVM_NODISCARD ThreadSP FailExceptionParsing(llvm::StringRef msg)
Utility method for error handling in GetBacktraceThreadFromException.
Definition: AppleObjCRuntime.cpp:506
lldb_private::DataExtractor::GetAddress
uint64_t GetAddress(lldb::offset_t *offset_ptr) const
Extract an address from *offset_ptr.
Definition: DataExtractor.cpp:652
lldb_private::TypeAndOrName::GetCompilerType
CompilerType GetCompilerType() const
Definition: Type.h:409
lldb_private::AppleObjCRuntimeV1::Terminate
static void Terminate()
Definition: AppleObjCRuntimeV1.cpp:91
lldb::eSymbolTypeCode
@ eSymbolTypeCode
Definition: lldb-enumerations.h:615
lldb_private::AppleObjCRuntime::GetPrintForDebuggerAddr
Address * GetPrintForDebuggerAddr()
Definition: AppleObjCRuntime.cpp:236
lldb_private::ModuleList::Modules
ModuleIterable Modules() const
Definition: ModuleList.h:480
FunctionCaller.h
lldb_private::EvaluateExpressionOptions::SetTimeout
void SetTimeout(const Timeout< std::micro > &timeout)
Definition: Target.h:323
lldb_private::ObjCLanguageRuntime::GetLanguageType
lldb::LanguageType GetLanguageType() const override
Definition: ObjCLanguageRuntime.h:237
lldb_private::ObjCLanguageRuntime
Definition: ObjCLanguageRuntime.h:34
lldb_private::TypeAndOrName::SetName
void SetName(ConstString type_name)
Definition: Type.cpp:772
lldb_private::Value
Definition: Value.h:38
lldb_private::ExecutionContext::GetProcessPtr
Process * GetProcessPtr() const
Returns a pointer to the process object.
Definition: ExecutionContext.cpp:208
lldb_private::AppleObjCRuntime::GetDynamicTypeAndAddress
bool GetDynamicTypeAndAddress(ValueObject &in_value, lldb::DynamicValueType use_dynamic, TypeAndOrName &class_type_or_name, Address &address, Value::ValueType &value_type) override
Definition: AppleObjCRuntime.cpp:268
lldb_private::AppleObjCRuntime::ReadObjCLibraryIfNeeded
void ReadObjCLibraryIfNeeded(const ModuleList &module_list)
Definition: AppleObjCRuntime.cpp:608
lldb::ExpressionResults
ExpressionResults
The results of expression evaluation.
Definition: lldb-enumerations.h:270
lldb_private::TypeAndOrName::SetCompilerType
void SetCompilerType(CompilerType compiler_type)
Definition: Type.cpp:788
lldb_private::LanguageRuntime::CreateExceptionBreakpoint
static lldb::BreakpointSP CreateExceptionBreakpoint(Target &target, lldb::LanguageType language, bool catch_bp, bool throw_bp, bool is_internal=false)
Definition: LanguageRuntime.cpp:239
lldb_private::AppleObjCRuntime::SetExceptionBreakpoints
void SetExceptionBreakpoints() override
Definition: AppleObjCRuntime.cpp:409
lldb_private::ProcessProperties::GetUtilityExpressionTimeout
std::chrono::seconds GetUtilityExpressionTimeout() const
Definition: Process.cpp:292
lldb_private::Process
Definition: Process.h:343
lldb_private::ModuleList::GetMutex
std::recursive_mutex & GetMutex() const
Definition: ModuleList.h:198
lldb_private::Process::GetBreakpointSiteList
BreakpointSiteList & GetBreakpointSiteList()
Definition: Process.cpp:1532
lldb_private::EvaluateExpressionOptions::SetIsForUtilityExpr
void SetIsForUtilityExpr(bool b)
Definition: Target.h:410
Module.h
lldb_private::AppleObjCRuntime::m_objc_exception_bp_sp
lldb::BreakpointSP m_objc_exception_bp_sp
Definition: AppleObjCRuntime.h:126
lldb_private::Process::GetThreadList
ThreadList & GetThreadList()
Definition: Process.h:2047
BreakpointLocation.h
lldb_private::BreakpointSiteList::BreakpointSiteContainsBreakpoint
bool BreakpointSiteContainsBreakpoint(lldb::break_id_t bp_site_id, lldb::break_id_t bp_id)
Returns whether the breakpoint site bp_site_id has bp_id.
Definition: BreakpointSiteList.cpp:141
lldb_private::Process::GetTarget
Target & GetTarget()
Get the target object pointer for this module.
Definition: Process.h:1196
lldb_private::EvaluateExpressionOptions
Definition: Target.h:255
lldb_private::Flags
Definition: Flags.h:22
lldb_private::HistoryThread
Definition: HistoryThread.h:33
lldb_private::SymbolContextList
Definition: SymbolContext.h:378
lldb_private::SymbolContextList::GetContextAtIndex
bool GetContextAtIndex(size_t idx, SymbolContext &sc) const
Get accessor for a symbol context at index idx.
Definition: SymbolContext.cpp:1267
lldb_private::ExecutionContext::GetFramePtr
StackFrame * GetFramePtr() const
Returns a pointer to the frame object.
Definition: ExecutionContext.h:407
lldb_private::SectionList
Definition: Section.h:34
lldb::offset_t
uint64_t offset_t
Definition: lldb-types.h:87
lldb_private::ValueList
Definition: Value.h:157
lldb_private::TypeSystemClang::IsObjCObjectPointerType
static bool IsObjCObjectPointerType(const CompilerType &type, CompilerType *target_type=nullptr)
Definition: TypeSystemClang.cpp:3638
HistoryThread.h
lldb_private::Stream
Definition: Stream.h:28
lldb_private::Process::ReadCStringFromMemory
size_t ReadCStringFromMemory(lldb::addr_t vm_addr, char *cstr, size_t cstr_max_len, Status &error)
Read a NULL terminated C string from memory.
Definition: Process.cpp:2006
lldb_private::ArchSpec::GetTriple
llvm::Triple & GetTriple()
Architecture triple accessor.
Definition: ArchSpec.h:444
lldb::addr_t
uint64_t addr_t
Definition: lldb-types.h:83
pc
@ pc
Definition: CompactUnwindInfo.cpp:1250
lldb_private::ObjCLanguageRuntime::ObjCRuntimeVersions::eAppleObjC_V2
@ eAppleObjC_V2
lldb_private::SymbolContext
Definition: SymbolContext.h:33
lldb_private::Target
Definition: Target.h:447
lldb_private::AppleObjCRuntime::GetExceptionObjectForThread
lldb::ValueObjectSP GetExceptionObjectForThread(lldb::ThreadSP thread_sp) override
Definition: AppleObjCRuntime.cpp:481
Section.h
lldb_private::ExecutionContext::GetThreadPtr
Thread * GetThreadPtr() const
Returns a pointer to the thread object.
Definition: ExecutionContext.h:398
lldb_private::AppleObjCRuntimeV2::Terminate
static void Terminate()
Definition: AppleObjCRuntimeV2.cpp:892
lldb_private::Target::GetImages
const ModuleList & GetImages() const
Get accessor for the images for this process.
Definition: Target.h:921
lldb_private::StreamString::GetString
llvm::StringRef GetString() const
Definition: StreamString.cpp:51
lldb_private::AppleObjCRuntime::m_Foundation_major
llvm::Optional< uint32_t > m_Foundation_major
Definition: AppleObjCRuntime.h:130
Process.h
lldb_private::AppleObjCRuntime::m_print_object_caller_up
std::unique_ptr< FunctionCaller > m_print_object_caller_up
Definition: AppleObjCRuntime.h:128
lldb_private::formatters::NSStringSummaryProvider
bool NSStringSummaryProvider(ValueObject &valobj, Stream &stream, const TypeSummaryOptions &options)
Definition: NSString.cpp:52
lldb_private::Value::SetCompilerType
void SetCompilerType(const CompilerType &compiler_type)
Definition: Value.cpp:257
lldb_private::AppleObjCRuntime::m_objc_module_wp
lldb::ModuleWP m_objc_module_wp
Definition: AppleObjCRuntime.h:127
lldb_private::ModuleList::FindSymbolsWithNameAndType
void FindSymbolsWithNameAndType(ConstString name, lldb::SymbolType symbol_type, SymbolContextList &sc_list) const
Definition: ModuleList.cpp:464
Target.h
lldb_private::AppleObjCRuntime::GetBacktraceThreadFromException
lldb::ThreadSP GetBacktraceThreadFromException(lldb::ValueObjectSP thread_sp) override
Definition: AppleObjCRuntime.cpp:512
lldb_private::ValueObject::GetProcessSP
lldb::ProcessSP GetProcessSP() const
Definition: ValueObject.h:338
lldb_private::Value::GetScalar
const Scalar & GetScalar() const
Definition: Value.h:112
lldb_private::FileSpec
Definition: FileSpec.h:56
error
static llvm::raw_ostream & error(Stream &strm)
Definition: CommandReturnObject.cpp:17
LIBLLDB_LOG_LANGUAGE
#define LIBLLDB_LOG_LANGUAGE
Definition: Logging.h:42
lldb_private::SymbolContext::symbol
Symbol * symbol
The Symbol for a given query.
Definition: SymbolContext.h:323
lldb_private::AppleObjCRuntime::GetObjectDescription
bool GetObjectDescription(Stream &str, Value &value, ExecutionContextScope *exe_scope) override
Definition: AppleObjCRuntime.cpp:97
lldb_private::ModuleList::GetSize
size_t GetSize() const
Gets the size of the module list.
Definition: ModuleList.cpp:596
lldb_private::ValueList::PushValue
void PushValue(const Value &value)
Definition: Value.cpp:678
lldb::eDynamicDontRunTarget
@ eDynamicDontRunTarget
Definition: lldb-enumerations.h:497
lldb_private::CompilerType::IsPossibleDynamicType
bool IsPossibleDynamicType(CompilerType *target_type, bool check_cplusplus, bool check_objc) const
Definition: CompilerType.cpp:214
ID
static char ID
Definition: IRDynamicChecks.cpp:32
lldb_private::TypeAndOrName::GetName
ConstString GetName() const
Definition: Type.cpp:764
ModuleList.h
object
lldb_private::DataExtractor
Definition: DataExtractor.h:48
lldb_private::ModuleList
Definition: ModuleList.h:71
lldb_private::Scalar::ULongLong
unsigned long long ULongLong(unsigned long long fail_value=0) const
Definition: Scalar.cpp:334
Log.h
lldb_private::ExecutionContextScope
Definition: ExecutionContextScope.h:32
TypeSystemClang.h
lldb_private::AppleObjCRuntime::GetObjCVersion
static ObjCRuntimeVersions GetObjCVersion(Process *process, lldb::ModuleSP &objc_module_sp)
Definition: AppleObjCRuntime.cpp:371
lldb_private::Thread
Definition: Thread.h:62
lldb_private::TypeSystemClang::GetCStringType
CompilerType GetCStringType(bool is_const)
Definition: TypeSystemClang.cpp:1173
lldb_private::Runtime::m_process
Process * m_process
Definition: Runtime.h:29
lldb::eExpressionCompleted
@ eExpressionCompleted
Definition: lldb-enumerations.h:271
lldb_private::ValueObject::ResolveValue
virtual bool ResolveValue(Scalar &scalar)
Definition: ValueObject.cpp:332
lldb_private::ExecutionContext::SetThreadSP
void SetThreadSP(const lldb::ThreadSP &thread_sp)
Set accessor to set only the thread shared pointer.
Definition: ExecutionContext.cpp:254
lldb_private::AppleObjCRuntime::CouldHaveDynamicValue
bool CouldHaveDynamicValue(ValueObject &in_value) override
Definition: AppleObjCRuntime.cpp:261
lldb_private::ObjCLanguageRuntime::GetClassDescriptor
virtual ClassDescriptorSP GetClassDescriptor(ValueObject &in_value)
Definition: ObjCLanguageRuntime.cpp:235
lldb_private::DataExtractor::SetAddressByteSize
void SetAddressByteSize(uint32_t addr_size)
Set the address byte size.
Definition: DataExtractor.h:834
StreamString.h
lldb_private::Process::GetAddressByteSize
uint32_t GetAddressByteSize() const
Definition: Process.cpp:3307
lldb_private::ConstString
Definition: ConstString.h:40
lldb_private::ExecutionContext::SetContext
void SetContext(const lldb::TargetSP &target_sp, bool get_process)
Definition: ExecutionContext.cpp:290
lldb_private::StreamString
Definition: StreamString.h:23
lldb_private::AppleObjCRuntime::GetStepThroughTrampolinePlan
lldb::ThreadPlanSP GetStepThroughTrampolinePlan(Thread &thread, bool stop_others) override
Definition: AppleObjCRuntime.cpp:360
lldb_private::EvaluateExpressionOptions::SetTryAllThreads
void SetTryAllThreads(bool try_others=true)
Definition: Target.h:335
lldb_private::GetLogIfAllCategoriesSet
Log * GetLogIfAllCategoriesSet(uint32_t mask)
Definition: Logging.cpp:58
lldb_private::AppleObjCRuntime::CalculateHasNewLiteralsAndIndexing
bool CalculateHasNewLiteralsAndIndexing() override
Definition: AppleObjCRuntime.cpp:450
lldb_private::ObjCLanguageRuntime::ObjCRuntimeVersions::eObjC_VersionUnknown
@ eObjC_VersionUnknown
lldb_private::Value::ValueType
ValueType
Type that describes Value::m_value.
Definition: Value.h:41
lldb_private::ObjCLanguageRuntime::ObjCRuntimeVersions
ObjCRuntimeVersions
Definition: ObjCLanguageRuntime.h:36
lldb_private::AppleObjCRuntime
Definition: AppleObjCRuntime.h:23
lldb_private::Flags::AllSet
bool AllSet(ValueType mask) const
Test if all bits in mask are 1 in the current flags.
Definition: Flags.h:83
lldb::eBasicTypeVoid
@ eBasicTypeVoid
Definition: lldb-enumerations.h:742
lldb_private::AppleObjCRuntime::Initialize
static void Initialize()
Definition: AppleObjCRuntime.cpp:59
lldb_private::AppleObjCRuntime::GetObjCModule
lldb::ModuleSP GetObjCModule()
Definition: AppleObjCRuntime.cpp:217
lldb::DynamicValueType
DynamicValueType
Definition: lldb-enumerations.h:494
lldb_private::ValueObject::GetExecutionContextRef
const ExecutionContextRef & GetExecutionContextRef() const
Definition: ValueObject.h:330
lldb_private::StreamString::Empty
bool Empty() const
Definition: StreamString.cpp:36
lldb_private::CompilerType::IsIntegerType
bool IsIntegerType(bool &is_signed) const
Definition: CompilerType.cpp:141
lldb::eLanguageTypeObjC
@ eLanguageTypeObjC
Objective-C.
Definition: lldb-enumerations.h:453
string
string(SUBSTRING ${p} 10 -1 pStripped) if($
Definition: Plugins/CMakeLists.txt:38
lldb_private::AppleObjCRuntime::IsModuleObjCLibrary
bool IsModuleObjCLibrary(const lldb::ModuleSP &module_sp) override
Definition: AppleObjCRuntime.cpp:343
lldb_private::EvaluateExpressionOptions::SetUnwindOnError
void SetUnwindOnError(bool unwind=false)
Definition: Target.h:302
CPPLanguageRuntime.h
Thread.h
lldb_private::ObjCLanguageRuntime::ObjCRuntimeVersions::eAppleObjC_V1
@ eAppleObjC_V1
lldb_private::AppleObjCRuntime::GetExceptionThrowLocation
static std::tuple< FileSpec, ConstString > GetExceptionThrowLocation()
Definition: AppleObjCRuntime.cpp:603
lldb_private::AppleObjCRuntime::HasReadObjCLibrary
bool HasReadObjCLibrary() override
Definition: AppleObjCRuntime.h:69
lldb_private::AppleObjCRuntime::ExceptionBreakpointsExplainStop
bool ExceptionBreakpointsExplainStop(lldb::StopInfoSP stop_reason) override
Definition: AppleObjCRuntime.cpp:437
lldb_private::AppleObjCRuntime::FixUpDynamicType
TypeAndOrName FixUpDynamicType(const TypeAndOrName &type_and_or_name, ValueObject &static_value) override
Definition: AppleObjCRuntime.cpp:276
lldb_private::AppleObjCRuntime::GetValuesForGlobalCFBooleans
virtual void GetValuesForGlobalCFBooleans(lldb::addr_t &cf_true, lldb::addr_t &cf_false)
Definition: AppleObjCRuntime.cpp:338
ValueObject.h
ObjectFile.h
ValueObjectConstResult.h
AppleObjCRuntimeV2.h
lldb::eBasicTypeObjCID
@ eBasicTypeObjCID
Definition: lldb-enumerations.h:769
lldb_private::EvaluateExpressionOptions::SetIgnoreBreakpoints
void SetIgnoreBreakpoints(bool ignore=false)
Definition: Target.h:306
lldb_private::Process::GetExtendedThreadList
ThreadList & GetExtendedThreadList()
Definition: Process.h:2053
lldb_private::Target::GetArchitecture
const ArchSpec & GetArchitecture() const
Definition: Target.h:963
lldb_private::AppleObjCRuntime::ModulesDidLoad
void ModulesDidLoad(const ModuleList &module_list) override
Called when modules have been loaded in the process.
Definition: AppleObjCRuntime.cpp:623
lldb_private::Status
Definition: Status.h:44
lldb_private::ValueObject
ValueObject:
Definition: ValueObject.h:105
lldb_private::CompilerType::GetPointerType
CompilerType GetPointerType() const
Return a new CompilerType that is a pointer to this type.
Definition: CompilerType.cpp:407
lldb_private::AppleObjCRuntime::m_PrintForDebugger_addr
std::unique_ptr< Address > m_PrintForDebugger_addr
Definition: AppleObjCRuntime.h:122
uint32_t
lldb_private::ExecutionContext::GetBestExecutionContextScope
ExecutionContextScope * GetBestExecutionContextScope() const
Definition: ExecutionContext.cpp:216
lldb_private::AppleObjCRuntime::CreateExceptionSearchFilter
lldb::SearchFilterSP CreateExceptionSearchFilter() override
Definition: AppleObjCRuntime.cpp:471
lldb_private::Runtime::GetProcess
Process * GetProcess()
Definition: Runtime.h:22
lldb_private::Address
Definition: Address.h:59
lldb_private::CompilerType::IsPointerType
bool IsPointerType(CompilerType *pointee_type=nullptr) const
Definition: CompilerType.cpp:157
lldb_private::AppleObjCRuntime::m_objc_trampoline_handler_up
std::unique_ptr< lldb_private::AppleObjCTrampolineHandler > m_objc_trampoline_handler_up
Definition: AppleObjCRuntime.h:125
lldb_private::AppleObjCRuntime::GetFoundationVersion
uint32_t GetFoundationVersion()
Definition: AppleObjCRuntime.cpp:320
lldb_private::CompilerType::GetTypeInfo
uint32_t GetTypeInfo(CompilerType *pointee_or_element_compiler_type=nullptr) const
Definition: CompilerType.cpp:290
lldb_private::DiagnosticManager
Definition: DiagnosticManager.h:93
lldb_private::Target::GetSearchFilterForModuleList
lldb::SearchFilterSP GetSearchFilterForModuleList(const FileSpecList *containingModuleList)
Definition: Target.cpp:524
lldb_private::Process::GetLanguageRuntime
LanguageRuntime * GetLanguageRuntime(lldb::LanguageType language)
Definition: Process.cpp:1479
AppleObjCRuntimeV1.h
lldb_private::ValueObject::GetCompilerType
CompilerType GetCompilerType()
Definition: ValueObject.h:352
lldb_private::Thread::GetSelectedFrame
lldb::StackFrameSP GetSelectedFrame()
Definition: Thread.cpp:264
lldb_private::TypeSummaryOptions
Definition: TypeSummary.h:26
StopInfo.h
lldb_private::ScratchTypeSystemClang::GetForTarget
static TypeSystemClang * GetForTarget(Target &target, llvm::Optional< IsolatedASTKind > ast_kind=DefaultAST, bool create_on_demand=true)
Returns the scratch TypeSystemClang for the given target.
Definition: TypeSystemClang.cpp:9670
lldb::eStopReasonBreakpoint
@ eStopReasonBreakpoint
Definition: lldb-enumerations.h:243
PluginManager.h
LLDB_INVALID_ADDRESS
#define LLDB_INVALID_ADDRESS
Invalid value definitions.
Definition: lldb-defines.h:85
lldb_private::ConstString::GetCString
const char * GetCString() const
Get the string value as a C string.
Definition: ConstString.h:216
lldb_private::AppleObjCRuntime::AppleIsModuleObjCLibrary
static bool AppleIsModuleObjCLibrary(const lldb::ModuleSP &module_sp)
Definition: AppleObjCRuntime.cpp:305
LLDB_LOG
#define LLDB_LOG(log,...)
The LLDB_LOG* macros defined below are the way to emit log messages.
Definition: Log.h:242
lldb_private::CompilerType
Generic representation of a type in a programming language.
Definition: CompilerType.h:33
lldb_private::ValueObjectConstResult::Create
static lldb::ValueObjectSP Create(ExecutionContextScope *exe_scope, lldb::ByteOrder byte_order, uint32_t addr_byte_size, lldb::addr_t address=LLDB_INVALID_ADDRESS)
Definition: ValueObjectConstResult.cpp:28
lldb_private::Stream::Printf
size_t Printf(const char *format,...) __attribute__((format(printf
Output printf formatted output to the stream.
Definition: Stream.cpp:107
lldb_private::Value::GetCompilerType
const CompilerType & GetCompilerType()
Definition: Value.cpp:228
lldb_private::SymbolContextList::IsEmpty
bool IsEmpty() const
Definition: SymbolContext.cpp:1285
DiagnosticManager.h
Status.h
NSString.h
lldb_private
A class that represents a running process on the host machine.
Definition: SBCommandInterpreterRunOptions.h:16
lldb_private::TypeAndOrName::HasType
bool HasType() const
Definition: Type.h:425
lldb_private::ExecutionContextScope::CalculateTarget
virtual lldb::TargetSP CalculateTarget()=0
lldb_private::ModuleList::GetModuleAtIndex
lldb::ModuleSP GetModuleAtIndex(size_t idx) const
Get the module shared pointer for the module at index idx.
Definition: ModuleList.cpp:354
lldb_private::TypeSystemClang::GetBasicType
CompilerType GetBasicType(lldb::BasicType type)
Definition: TypeSystemClang.cpp:940
lldb_private::Stream::Write
size_t Write(const void *src, size_t src_len)
Output character bytes to the stream.
Definition: Stream.h:101
lldb_private::TypeSystemClang
A TypeSystem implementation based on Clang.
Definition: TypeSystemClang.h:106
ConstString.h
lldb_private::ValueObject::GetTargetSP
lldb::TargetSP GetTargetSP() const
Definition: ValueObject.h:334
lldb_private::ThreadCollection::AddThread
void AddThread(const lldb::ThreadSP &thread_sp)
Definition: ThreadCollection.cpp:24
LLDB_PLUGIN_DEFINE
#define LLDB_PLUGIN_DEFINE(PluginName)
Definition: PluginManager.h:31
lldb_private::Log
Definition: Log.h:49
lldb_private::Process::ReadPointerFromMemory
lldb::addr_t ReadPointerFromMemory(lldb::addr_t vm_addr, Status &error)
Definition: Process.cpp:2098
lldb_private::EvaluateExpressionOptions::SetStopOthers
void SetStopOthers(bool stop_others=true)
Definition: Target.h:339
lldb_private::TypeAndOrName
Sometimes you can find the name of the type corresponding to an object, but we don't have debug infor...
Definition: Type.h:395
lldb_private::AppleObjCRuntime::m_read_objc_library
bool m_read_objc_library
Definition: AppleObjCRuntime.h:123
lldb_private::ExecutionContextScope::CalculateExecutionContext
virtual void CalculateExecutionContext(ExecutionContext &exe_ctx)=0
Reconstruct the object's execution context into sc.
lldb_private::ExecutionContext::SetFrameSP
void SetFrameSP(const lldb::StackFrameSP &frame_sp)
Set accessor to set only the frame shared pointer.
Definition: ExecutionContext.cpp:258
lldb_private::AppleObjCRuntime::ExceptionBreakpointsAreSet
bool ExceptionBreakpointsAreSet() override
Definition: AppleObjCRuntime.cpp:433
lldb_private::ThreadList::GetSelectedThread
lldb::ThreadSP GetSelectedThread()
Definition: ThreadList.cpp:648
FormattersHelpers.h
lldb_private::ExecutionContext::HasProcessScope
bool HasProcessScope() const
Returns true the ExecutionContext object contains a valid target and process.
Definition: ExecutionContext.cpp:385
lldb_private::AppleObjCRuntime::ClearExceptionBreakpoints
void ClearExceptionBreakpoints() override
Definition: AppleObjCRuntime.cpp:424
lldb
Definition: SBAddress.h:15
RegisterContext.h
lldb_private::FileSpec::GetFilename
ConstString & GetFilename()
Filename string get accessor.
Definition: FileSpec.cpp:341
AppleObjCRuntime.h
lldb_private::ExecutionContext::GetTargetPtr
Target * GetTargetPtr() const
Returns a pointer to the target object.
Definition: ExecutionContext.cpp:200
lldb_private::ObjectFile
Definition: ObjectFile.h:58
ExecutionContext.h
LLDB_INVALID_MODULE_VERSION
#define LLDB_INVALID_MODULE_VERSION
Definition: lldb-defines.h:89
lldb_private::AppleObjCRuntimeV1::Initialize
static void Initialize()
Definition: AppleObjCRuntimeV1.cpp:84
AppleObjCTrampolineHandler.h
lldb_private::AppleObjCRuntimeV2::Initialize
static void Initialize()
Definition: AppleObjCRuntimeV2.cpp:882
lldb::eLanguageTypeC_plus_plus
@ eLanguageTypeC_plus_plus
ISO C++:1998.
Definition: lldb-enumerations.h:441
lldb_private::Symbol::GetAddress
Address GetAddress() const
Definition: Symbol.h:73
lldb_private::AppleObjCRuntime::ReadObjCLibrary
bool ReadObjCLibrary(const lldb::ModuleSP &module_sp) override
Definition: AppleObjCRuntime.cpp:347