lldb/source/Plugins/Language/ObjC/NSException.cpp

   1 //===-- NSException.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 "clang/AST/DeclCXX.h"
  10
  11 #include "Cocoa.h"
  12
  13 #include "lldb/Core/ValueObject.h"
  14 #include "lldb/Core/ValueObjectConstResult.h"
  15 #include "lldb/DataFormatters/FormattersHelpers.h"
  16 #include "lldb/Target/Target.h"
  17 #include "lldb/Utility/DataBufferHeap.h"
  18 #include "lldb/Utility/Endian.h"
  19 #include "lldb/Utility/Status.h"
  20 #include "lldb/Utility/Stream.h"
  21
  22 #include "Plugins/Language/ObjC/NSString.h"
  23 #include "Plugins/LanguageRuntime/ObjC/ObjCLanguageRuntime.h"
  24 #include "Plugins/TypeSystem/Clang/TypeSystemClang.h"
  25
  26 using namespace lldb;
  27 using namespace lldb_private;
  28 using namespace lldb_private::formatters;
  29
  30 static bool ExtractFields(ValueObject &valobj, ValueObjectSP *name_sp,
  31                           ValueObjectSP *reason_sp, ValueObjectSP *userinfo_sp,
  32                           ValueObjectSP *reserved_sp) {
  33   ProcessSP process_sp(valobj.GetProcessSP());
  34   if (!process_sp)
  35     return false;
  36
  37   lldb::addr_t ptr = LLDB_INVALID_ADDRESS;
  38
  39   CompilerType valobj_type(valobj.GetCompilerType());
  40   Flags type_flags(valobj_type.GetTypeInfo());
  41   if (type_flags.AllClear(eTypeHasValue)) {
  42     if (valobj.IsBaseClass() && valobj.GetParent())
  43       ptr = valobj.GetParent()->GetValueAsUnsigned(LLDB_INVALID_ADDRESS);
  44   } else {
  45     ptr = valobj.GetValueAsUnsigned(LLDB_INVALID_ADDRESS);
  46   }
  47
  48   if (ptr == LLDB_INVALID_ADDRESS)
  49     return false;
  50   size_t ptr_size = process_sp->GetAddressByteSize();
  51
  52   Status error;
  53   auto name = process_sp->ReadPointerFromMemory(ptr + 1 * ptr_size, error);
  54   if (error.Fail() || name == LLDB_INVALID_ADDRESS)
  55     return false;
  56   auto reason = process_sp->ReadPointerFromMemory(ptr + 2 * ptr_size, error);
  57   if (error.Fail() || reason == LLDB_INVALID_ADDRESS)
  58     return false;
  59   auto userinfo = process_sp->ReadPointerFromMemory(ptr + 3 * ptr_size, error);
  60   if (error.Fail() || userinfo == LLDB_INVALID_ADDRESS)
  61     return false;
  62   auto reserved = process_sp->ReadPointerFromMemory(ptr + 4 * ptr_size, error);
  63   if (error.Fail() || reserved == LLDB_INVALID_ADDRESS)
  64     return false;
  65
  66   InferiorSizedWord name_isw(name, *process_sp);
  67   InferiorSizedWord reason_isw(reason, *process_sp);
  68   InferiorSizedWord userinfo_isw(userinfo, *process_sp);
  69   InferiorSizedWord reserved_isw(reserved, *process_sp);
  70
  71   TypeSystemClangSP scratch_ts_sp =
  72       ScratchTypeSystemClang::GetForTarget(process_sp->GetTarget());
  73   if (!scratch_ts_sp)
  74     return false;
  75
  76   CompilerType voidstar =
  77       scratch_ts_sp->GetBasicType(lldb::eBasicTypeVoid).GetPointerType();
  78
  79   if (name_sp)
  80     *name_sp = ValueObject::CreateValueObjectFromData(
  81         "name", name_isw.GetAsData(process_sp->GetByteOrder()),
  82         valobj.GetExecutionContextRef(), voidstar);
  83   if (reason_sp)
  84     *reason_sp = ValueObject::CreateValueObjectFromData(
  85         "reason", reason_isw.GetAsData(process_sp->GetByteOrder()),
  86         valobj.GetExecutionContextRef(), voidstar);
  87   if (userinfo_sp)
  88     *userinfo_sp = ValueObject::CreateValueObjectFromData(
  89         "userInfo", userinfo_isw.GetAsData(process_sp->GetByteOrder()),
  90         valobj.GetExecutionContextRef(), voidstar);
  91   if (reserved_sp)
  92     *reserved_sp = ValueObject::CreateValueObjectFromData(
  93         "reserved", reserved_isw.GetAsData(process_sp->GetByteOrder()),
  94         valobj.GetExecutionContextRef(), voidstar);
  95
  96   return true;
  97 }
  98
  99 bool lldb_private::formatters::NSException_SummaryProvider(
 100     ValueObject &valobj, Stream &stream, const TypeSummaryOptions &options) {
 101   lldb::ValueObjectSP reason_sp;
 102   if (!ExtractFields(valobj, nullptr, &reason_sp, nullptr, nullptr))
 103     return false;
 104
 105   if (!reason_sp) {
 106     stream.Printf("No reason");
 107     return false;
 108   }
 109
 110   StreamString reason_str_summary;
 111   if (NSStringSummaryProvider(*reason_sp, reason_str_summary, options) &&
 112       !reason_str_summary.Empty()) {
 113     stream.Printf("%s", reason_str_summary.GetData());
 114     return true;
 115   } else
 116     return false;
 117 }
 118
 119 class NSExceptionSyntheticFrontEnd : public SyntheticChildrenFrontEnd {
 120 public:
 121   NSExceptionSyntheticFrontEnd(lldb::ValueObjectSP valobj_sp)
 122       : SyntheticChildrenFrontEnd(*valobj_sp) {}
 123
 124   ~NSExceptionSyntheticFrontEnd() override = default;
 125
 126   size_t CalculateNumChildren() override {
 127     return 4;
 128   }
 129
 130   lldb::ValueObjectSP GetChildAtIndex(size_t idx) override {
 131     switch (idx) {
 132       case 0: return m_name_sp;
 133       case 1: return m_reason_sp;
 134       case 2: return m_userinfo_sp;
 135       case 3: return m_reserved_sp;
 136     }
 137     return lldb::ValueObjectSP();
 138   }
 139
 140   bool Update() override {
 141     m_name_sp.reset();
 142     m_reason_sp.reset();
 143     m_userinfo_sp.reset();
 144     m_reserved_sp.reset();
 145
 146     return ExtractFields(m_backend, &m_name_sp, &m_reason_sp, &m_userinfo_sp,
 147                          &m_reserved_sp);
 148   }
 149
 150   bool MightHaveChildren() override { return true; }
 151
 152   size_t GetIndexOfChildWithName(ConstString name) override {
 153     // NSException has 4 members:
 154     //   NSString *name;
 155     //   NSString *reason;
 156     //   NSDictionary *userInfo;
 157     //   id reserved;
 158     static ConstString g_name("name");
 159     static ConstString g_reason("reason");
 160     static ConstString g_userInfo("userInfo");
 161     static ConstString g_reserved("reserved");
 162     if (name == g_name) return 0;
 163     if (name == g_reason) return 1;
 164     if (name == g_userInfo) return 2;
 165     if (name == g_reserved) return 3;
 166     return UINT32_MAX;
 167   }
 168
 169 private:
 170   ValueObjectSP m_name_sp;
 171   ValueObjectSP m_reason_sp;
 172   ValueObjectSP m_userinfo_sp;
 173   ValueObjectSP m_reserved_sp;
 174 };
 175
 176 SyntheticChildrenFrontEnd *
 177 lldb_private::formatters::NSExceptionSyntheticFrontEndCreator(
 178     CXXSyntheticChildren *, lldb::ValueObjectSP valobj_sp) {
 179   lldb::ProcessSP process_sp(valobj_sp->GetProcessSP());
 180   if (!process_sp)
 181     return nullptr;
 182   ObjCLanguageRuntime *runtime = ObjCLanguageRuntime::Get(*process_sp);
 183   if (!runtime)
 184     return nullptr;
 185
 186   ObjCLanguageRuntime::ClassDescriptorSP descriptor(
 187       runtime->GetClassDescriptor(*valobj_sp.get()));
 188
 189   if (!descriptor.get() || !descriptor->IsValid())
 190     return nullptr;
 191
 192   const char *class_name = descriptor->GetClassName().GetCString();
 193
 194   if (!class_name || !*class_name)
 195     return nullptr;
 196
 197   if (!strcmp(class_name, "NSException"))
 198     return (new NSExceptionSyntheticFrontEnd(valobj_sp));
 199   else if (!strcmp(class_name, "NSCFException"))
 200     return (new NSExceptionSyntheticFrontEnd(valobj_sp));
 201   else if (!strcmp(class_name, "__NSCFException"))
 202     return (new NSExceptionSyntheticFrontEnd(valobj_sp));
 203
 204   return nullptr;
 205 }