AppleObjCDeclVendor.cpp

Go to the documentation of this file.

//===-- AppleObjCDeclVendor.cpp -------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
 
#include "AppleObjCDeclVendor.h"
 
#include "Plugins/ExpressionParser/Clang/ClangASTMetadata.h"
#include "Plugins/ExpressionParser/Clang/ClangUtil.h"
#include "Plugins/LanguageRuntime/ObjC/ObjCLanguageRuntime.h"
#include "lldb/Core/Module.h"
#include "lldb/Target/Process.h"
#include "lldb/Target/Target.h"
#include "lldb/Utility/LLDBLog.h"
#include "lldb/Utility/Log.h"
 
#include "clang/AST/ASTContext.h"
#include "clang/AST/DeclObjC.h"
#include "clang/AST/ExternalASTSource.h"
 
using namespace lldb_private;
 
class lldb_private::AppleObjCExternalASTSource
    : public clang::ExternalASTSource {
public:
  AppleObjCExternalASTSource(AppleObjCDeclVendor &decl_vendor)
      : m_decl_vendor(decl_vendor) {}
 
  bool FindExternalVisibleDeclsByName(
      const clang::DeclContext *decl_ctx, clang::DeclarationName name,
      const clang::DeclContext *original_dc) override {
 
    Log *log(GetLog(
        LLDBLog::Expressions)); // FIXME - a more appropriate log channel?
 
    LLDB_LOGF(log,
              "AppleObjCExternalASTSource::FindExternalVisibleDeclsByName"
              " on (ASTContext*)%p Looking for %s in (%sDecl*)%p",
              static_cast<void *>(&decl_ctx->getParentASTContext()),
              name.getAsString().c_str(), decl_ctx->getDeclKindName(),
              static_cast<const void *>(decl_ctx));
 
    do {
      const clang::ObjCInterfaceDecl *interface_decl =
          llvm::dyn_cast<clang::ObjCInterfaceDecl>(decl_ctx);
 
      if (!interface_decl)
        break;
 
      clang::ObjCInterfaceDecl *non_const_interface_decl =
          const_cast<clang::ObjCInterfaceDecl *>(interface_decl);
 
      if (!m_decl_vendor.FinishDecl(non_const_interface_decl))
        break;
 
      clang::DeclContext::lookup_result result =
          non_const_interface_decl->lookup(name);
 
      return (!result.empty());
    } while (false);
 
    SetNoExternalVisibleDeclsForName(decl_ctx, name);
    return false;
  }
 
  void CompleteType(clang::TagDecl *tag_decl) override {
 
    Log *log(GetLog(
        LLDBLog::Expressions)); // FIXME - a more appropriate log channel?
 
    LLDB_LOGF(log,
              "AppleObjCExternalASTSource::CompleteType on "
              "(ASTContext*)%p Completing (TagDecl*)%p named %s",
              static_cast<void *>(&tag_decl->getASTContext()),
              static_cast<void *>(tag_decl), tag_decl->getName().str().c_str());
 
    LLDB_LOG(log, "  AOEAS::CT Before:\n{0}", ClangUtil::DumpDecl(tag_decl));
 
    LLDB_LOG(log, "  AOEAS::CT After:{0}", ClangUtil::DumpDecl(tag_decl));
  }
 
  void CompleteType(clang::ObjCInterfaceDecl *interface_decl) override {
 
    Log *log(GetLog(
        LLDBLog::Expressions)); // FIXME - a more appropriate log channel?
 
    LLDB_LOGF(log,
              "AppleObjCExternalASTSource::CompleteType on "
              "(ASTContext*)%p Completing (ObjCInterfaceDecl*)%p named %s",
              static_cast<void *>(&interface_decl->getASTContext()),
              static_cast<void *>(interface_decl),
              interface_decl->getName().str().c_str());
 
    LLDB_LOGF(log, "  AOEAS::CT Before:");
    LLDB_LOG(log, "    [CT] {0}", ClangUtil::DumpDecl(interface_decl));
 
    m_decl_vendor.FinishDecl(interface_decl);
 
    LLDB_LOGF(log, "  [CT] After:");
    LLDB_LOG(log, "    [CT] {0}", ClangUtil::DumpDecl(interface_decl));
  }
 
  bool layoutRecordType(
      const clang::RecordDecl *Record, uint64_t &Size, uint64_t &Alignment,
      llvm::DenseMap<const clang::FieldDecl *, uint64_t> &FieldOffsets,
      llvm::DenseMap<const clang::CXXRecordDecl *, clang::CharUnits>
          &BaseOffsets,
      llvm::DenseMap<const clang::CXXRecordDecl *, clang::CharUnits>
          &VirtualBaseOffsets) override {
    return false;
  }
 
  void StartTranslationUnit(clang::ASTConsumer *Consumer) override {
    clang::TranslationUnitDecl *translation_unit_decl =
        m_decl_vendor.m_ast_ctx->getASTContext().getTranslationUnitDecl();
    translation_unit_decl->setHasExternalVisibleStorage();
    translation_unit_decl->setHasExternalLexicalStorage();
  }
 
private:
  AppleObjCDeclVendor &m_decl_vendor;
};
 
AppleObjCDeclVendor::AppleObjCDeclVendor(ObjCLanguageRuntime &runtime)
    : DeclVendor(eAppleObjCDeclVendor), m_runtime(runtime),
      m_type_realizer_sp(m_runtime.GetEncodingToType()) {
  m_ast_ctx = std::make_shared<TypeSystemClang>(
      "AppleObjCDeclVendor AST",
      runtime.GetProcess()->GetTarget().GetArchitecture().GetTriple());
  auto external_source_owning_ptr =
      llvm::makeIntrusiveRefCnt<AppleObjCExternalASTSource>(*this);
  m_external_source = external_source_owning_ptr.get();
  m_ast_ctx->getASTContext().setExternalSource(external_source_owning_ptr);
}
 
clang::ObjCInterfaceDecl *
AppleObjCDeclVendor::GetDeclForISA(ObjCLanguageRuntime::ObjCISA isa) {
  ISAToInterfaceMap::const_iterator iter = m_isa_to_interface.find(isa);
 
  if (iter != m_isa_to_interface.end())
    return iter->second;
 
  clang::ASTContext &ast_ctx = m_ast_ctx->getASTContext();
 
  ObjCLanguageRuntime::ClassDescriptorSP descriptor =
      m_runtime.GetClassDescriptorFromISA(isa);
 
  if (!descriptor)
    return nullptr;
 
  ConstString name(descriptor->GetClassName());
 
  clang::IdentifierInfo &identifier_info =
      ast_ctx.Idents.get(name.GetStringRef());
 
  clang::ObjCInterfaceDecl *new_iface_decl = clang::ObjCInterfaceDecl::Create(
      ast_ctx, ast_ctx.getTranslationUnitDecl(), clang::SourceLocation(),
      &identifier_info, nullptr, nullptr);
 
  ClangASTMetadata meta_data;
  meta_data.SetISAPtr(isa);
  m_ast_ctx->SetMetadata(new_iface_decl, meta_data);
 
  new_iface_decl->setHasExternalVisibleStorage();
  new_iface_decl->setHasExternalLexicalStorage();
 
  ast_ctx.getTranslationUnitDecl()->addDecl(new_iface_decl);
 
  m_isa_to_interface[isa] = new_iface_decl;
 
  return new_iface_decl;
}
 
class ObjCRuntimeMethodType {
public:
  ObjCRuntimeMethodType(const char *types) {
    const char *cursor = types;
    enum ParserState { Start = 0, InType, InPos } state = Start;
    const char *type = nullptr;
    int brace_depth = 0;
 
    uint32_t stepsLeft = 256;
 
    while (true) {
      if (--stepsLeft == 0) {
        m_is_valid = false;
        return;
      }
 
      switch (state) {
      case Start: {
        switch (*cursor) {
        default:
          state = InType;
          type = cursor;
          break;
        case '\0':
          m_is_valid = true;
          return;
        case '0':
        case '1':
        case '2':
        case '3':
        case '4':
        case '5':
        case '6':
        case '7':
        case '8':
        case '9':
          m_is_valid = false;
          return;
        }
      } break;
      case InType: {
        switch (*cursor) {
        default:
          ++cursor;
          break;
        case '0':
        case '1':
        case '2':
        case '3':
        case '4':
        case '5':
        case '6':
        case '7':
        case '8':
        case '9':
          if (!brace_depth) {
            state = InPos;
            if (type) {
              m_type_vector.push_back(std::string(type, (cursor - type)));
            } else {
              m_is_valid = false;
              return;
            }
            type = nullptr;
          } else {
            ++cursor;
          }
          break;
        case '[':
        case '{':
        case '(':
          ++brace_depth;
          ++cursor;
          break;
        case ']':
        case '}':
        case ')':
          if (!brace_depth) {
            m_is_valid = false;
            return;
          }
          --brace_depth;
          ++cursor;
          break;
        case '\0':
          m_is_valid = false;
          return;
        }
      } break;
      case InPos: {
        switch (*cursor) {
        default:
          state = InType;
          type = cursor;
          break;
        case '0':
        case '1':
        case '2':
        case '3':
        case '4':
        case '5':
        case '6':
        case '7':
        case '8':
        case '9':
          ++cursor;
          break;
        case '\0':
          m_is_valid = true;
          return;
        }
      } break;
      }
    }
  }
 
  clang::ObjCMethodDecl *
  BuildMethod(TypeSystemClang &clang_ast_ctxt,
              clang::ObjCInterfaceDecl *interface_decl, const char *name,
              bool instance,
              ObjCLanguageRuntime::EncodingToTypeSP type_realizer_sp) {
    if (!m_is_valid || m_type_vector.size() < 3)
      return nullptr;
 
    clang::ASTContext &ast_ctx(interface_decl->getASTContext());
 
    const bool isInstance = instance;
    const bool isVariadic = false;
    const bool isPropertyAccessor = false;
    const bool isSynthesizedAccessorStub = false;
    const bool isImplicitlyDeclared = true;
    const bool isDefined = false;
    const clang::ObjCImplementationControl impControl =
        clang::ObjCImplementationControl::None;
    const bool HasRelatedResultType = false;
    const bool for_expression = true;
 
    std::vector<const clang::IdentifierInfo *> selector_components;
 
    const char *name_cursor = name;
    bool is_zero_argument = true;
 
    while (*name_cursor != '\0') {
      const char *colon_loc = strchr(name_cursor, ':');
      if (!colon_loc) {
        selector_components.push_back(
            &ast_ctx.Idents.get(llvm::StringRef(name_cursor)));
        break;
      } else {
        is_zero_argument = false;
        selector_components.push_back(&ast_ctx.Idents.get(
            llvm::StringRef(name_cursor, colon_loc - name_cursor)));
        name_cursor = colon_loc + 1;
      }
    }
 
    const clang::IdentifierInfo **identifier_infos = selector_components.data();
    if (!identifier_infos) {
      return nullptr;
    }
 
    clang::Selector sel = ast_ctx.Selectors.getSelector(
        is_zero_argument ? 0 : selector_components.size(),
        identifier_infos);
 
    clang::QualType ret_type =
        ClangUtil::GetQualType(type_realizer_sp->RealizeType(
            clang_ast_ctxt, m_type_vector[0].c_str(), for_expression));
 
    if (ret_type.isNull())
      return nullptr;
 
    clang::ObjCMethodDecl *ret = clang::ObjCMethodDecl::Create(
        ast_ctx, clang::SourceLocation(), clang::SourceLocation(), sel,
        ret_type, nullptr, interface_decl, isInstance, isVariadic,
        isPropertyAccessor, isSynthesizedAccessorStub, isImplicitlyDeclared,
        isDefined, impControl, HasRelatedResultType);
 
    std::vector<clang::ParmVarDecl *> parm_vars;
 
    for (size_t ai = 3, ae = m_type_vector.size(); ai != ae; ++ai) {
      const bool for_expression = true;
      clang::QualType arg_type =
          ClangUtil::GetQualType(type_realizer_sp->RealizeType(
              clang_ast_ctxt, m_type_vector[ai].c_str(), for_expression));
 
      if (arg_type.isNull())
        return nullptr; // well, we just wasted a bunch of time.  Wish we could
                        // delete the stuff we'd just made!
 
      parm_vars.push_back(clang::ParmVarDecl::Create(
          ast_ctx, ret, clang::SourceLocation(), clang::SourceLocation(),
          nullptr, arg_type, nullptr, clang::SC_None, nullptr));
    }
 
    ret->setMethodParams(ast_ctx,
                         llvm::ArrayRef<clang::ParmVarDecl *>(parm_vars),
                         llvm::ArrayRef<clang::SourceLocation>());
 
    return ret;
  }
 
  explicit operator bool() { return m_is_valid; }
 
  size_t GetNumTypes() { return m_type_vector.size(); }
 
  const char *GetTypeAtIndex(size_t idx) { return m_type_vector[idx].c_str(); }
 
private:
  typedef std::vector<std::string> TypeVector;
 
  TypeVector m_type_vector;
  bool m_is_valid = false;
};
 
bool AppleObjCDeclVendor::FinishDecl(clang::ObjCInterfaceDecl *interface_decl) {
  Log *log(
      GetLog(LLDBLog::Expressions)); // FIXME - a more appropriate log channel?
 
  ObjCLanguageRuntime::ObjCISA objc_isa = 0;
  if (std::optional<ClangASTMetadata> metadata =
          m_ast_ctx->GetMetadata(interface_decl))
    objc_isa = metadata->GetISAPtr();
 
  if (!objc_isa)
    return false;
 
  if (!interface_decl->hasExternalVisibleStorage())
    return true;
 
  interface_decl->startDefinition();
 
  interface_decl->setHasExternalVisibleStorage(false);
  interface_decl->setHasExternalLexicalStorage(false);
 
  ObjCLanguageRuntime::ClassDescriptorSP descriptor =
      m_runtime.GetClassDescriptorFromISA(objc_isa);
 
  if (!descriptor)
    return false;
 
  auto superclass_func = [interface_decl,
                          this](ObjCLanguageRuntime::ObjCISA isa) {
    clang::ObjCInterfaceDecl *superclass_decl = GetDeclForISA(isa);
 
    if (!superclass_decl)
      return;
 
    FinishDecl(superclass_decl);
    clang::ASTContext &context = m_ast_ctx->getASTContext();
    interface_decl->setSuperClass(context.getTrivialTypeSourceInfo(
        context.getObjCInterfaceType(superclass_decl)));
  };
 
  auto instance_method_func =
      [log, interface_decl, this](const char *name, const char *types) -> bool {
    if (!name || !types)
      return false; // skip this one
 
    ObjCRuntimeMethodType method_type(types);
 
    clang::ObjCMethodDecl *method_decl = method_type.BuildMethod(
        *m_ast_ctx, interface_decl, name, true, m_type_realizer_sp);
 
    LLDB_LOGF(log, "[  AOTV::FD] Instance method [%s] [%s]", name, types);
 
    if (method_decl)
      interface_decl->addDecl(method_decl);
 
    return false;
  };
 
  auto class_method_func = [log, interface_decl,
                            this](const char *name, const char *types) -> bool {
    if (!name || !types)
      return false; // skip this one
 
    ObjCRuntimeMethodType method_type(types);
 
    clang::ObjCMethodDecl *method_decl = method_type.BuildMethod(
        *m_ast_ctx, interface_decl, name, false, m_type_realizer_sp);
 
    LLDB_LOGF(log, "[  AOTV::FD] Class method [%s] [%s]", name, types);
 
    if (method_decl)
      interface_decl->addDecl(method_decl);
 
    return false;
  };
 
  auto ivar_func = [log, interface_decl,
                    this](const char *name, const char *type,
                          lldb::addr_t offset_ptr, uint64_t size) -> bool {
    if (!name || !type)
      return false;
 
    const bool for_expression = false;
 
    LLDB_LOGF(log,
              "[  AOTV::FD] Instance variable [%s] [%s], offset at %" PRIx64,
              name, type, offset_ptr);
 
    CompilerType ivar_type = m_runtime.GetEncodingToType()->RealizeType(
        *m_ast_ctx, type, for_expression);
 
    if (ivar_type.IsValid()) {
      clang::TypeSourceInfo *const type_source_info = nullptr;
      const bool is_synthesized = false;
      clang::ObjCIvarDecl *ivar_decl = clang::ObjCIvarDecl::Create(
          m_ast_ctx->getASTContext(), interface_decl, clang::SourceLocation(),
          clang::SourceLocation(), &m_ast_ctx->getASTContext().Idents.get(name),
          ClangUtil::GetQualType(ivar_type),
          type_source_info, // TypeSourceInfo *
          clang::ObjCIvarDecl::Public, nullptr, is_synthesized);
 
      if (ivar_decl) {
        interface_decl->addDecl(ivar_decl);
      }
    }
 
    return false;
  };
 
  LLDB_LOGF(log,
            "[AppleObjCDeclVendor::FinishDecl] Finishing Objective-C "
            "interface for %s",
            descriptor->GetClassName().AsCString());
 
  if (!descriptor->Describe(superclass_func, instance_method_func,
                            class_method_func, ivar_func))
    return false;
 
  LLDB_LOGF(log,
            "[AppleObjCDeclVendor::FinishDecl] Finished Objective-C interface");
 
  LLDB_LOG(log, "  [AOTV::FD] {0}", ClangUtil::DumpDecl(interface_decl));
 
  return true;
}
 
uint32_t AppleObjCDeclVendor::FindDecls(ConstString name, bool append,
                                        uint32_t max_matches,
                                        std::vector<CompilerDecl> &decls) {
 
  Log *log(
      GetLog(LLDBLog::Expressions)); // FIXME - a more appropriate log channel?
 
  LLDB_LOGF(log, "AppleObjCDeclVendor::FindDecls ('%s', %s, %u, )",
            (const char *)name.AsCString(), append ? "true" : "false",
            max_matches);
 
  if (!append)
    decls.clear();
 
  // See if the type is already in our ASTContext.
 
  clang::ASTContext &ast_ctx = m_ast_ctx->getASTContext();
 
  clang::IdentifierInfo &identifier_info =
      ast_ctx.Idents.get(name.GetStringRef());
  clang::DeclarationName decl_name =
      ast_ctx.DeclarationNames.getIdentifier(&identifier_info);
 
  clang::DeclContext::lookup_result lookup_result =
      ast_ctx.getTranslationUnitDecl()->lookup(decl_name);
 
  if (!lookup_result.empty()) {
    if (clang::ObjCInterfaceDecl *result_iface_decl =
            llvm::dyn_cast<clang::ObjCInterfaceDecl>(*lookup_result.begin())) {
      if (log) {
        clang::QualType result_iface_type =
            ast_ctx.getObjCInterfaceType(result_iface_decl);
 
        uint64_t isa_value = LLDB_INVALID_ADDRESS;
        if (std::optional<ClangASTMetadata> metadata =
                m_ast_ctx->GetMetadata(result_iface_decl))
          isa_value = metadata->GetISAPtr();
 
        LLDB_LOGF(log,
                  "AOCTV::FT Found %s (isa 0x%" PRIx64 ") in the ASTContext",
                  result_iface_type.getAsString().data(), isa_value);
      }
 
      decls.push_back(m_ast_ctx->GetCompilerDecl(result_iface_decl));
      return 1;
    }
 
    LLDB_LOGF(log, "AOCTV::FT There's something in the ASTContext, but "
                   "it's not something we know about");
    return 0;
  }
 
  LLDB_LOGF(log, "AOCTV::FT Couldn't find %s in the ASTContext",
            name.AsCString());
 
  // It's not.  If it exists, we have to put it into our ASTContext.
 
  ObjCLanguageRuntime::ObjCISA isa = m_runtime.GetISA(name);
 
  if (!isa) {
    LLDB_LOGF(log, "AOCTV::FT Couldn't find the isa");
 
    return 0;
  }
 
  clang::ObjCInterfaceDecl *iface_decl = GetDeclForISA(isa);
 
  if (!iface_decl) {
    LLDB_LOGF(log,
              "AOCTV::FT Couldn't get the Objective-C interface for "
              "isa 0x%" PRIx64,
              (uint64_t)isa);
 
    return 0;
  }
 
  if (log) {
    clang::QualType new_iface_type = ast_ctx.getObjCInterfaceType(iface_decl);
 
    LLDB_LOG(log, "AOCTV::FT Created {0} (isa 0x{1:x})",
             new_iface_type.getAsString(), (uint64_t)isa);
  }
 
  decls.push_back(m_ast_ctx->GetCompilerDecl(iface_decl));
  return 1;
}