TypeSynthetic.cpp

Go to the documentation of this file.

//===-- TypeSynthetic.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 "lldb/Utility/Log.h"
#include "lldb/ValueObject/ValueObject.h"
#include "lldb/lldb-enumerations.h"
#include "lldb/lldb-forward.h"
#include "lldb/lldb-public.h"
 
#include "lldb/Core/Debugger.h"
#include "lldb/DataFormatters/FormatterBytecode.h"
#include "lldb/DataFormatters/TypeSynthetic.h"
#include "lldb/Interpreter/CommandInterpreter.h"
#include "lldb/Interpreter/ScriptInterpreter.h"
#include "lldb/Symbol/CompilerType.h"
#include "lldb/Target/Target.h"
#include "lldb/Utility/StreamString.h"
#include "llvm/Support/Error.h"
#include "llvm/Support/ErrorExtras.h"
#include <cstdint>
 
using namespace lldb;
using namespace lldb_private;
 
void TypeFilterImpl::AddExpressionPath(const std::string &path) {
  bool need_add_dot = true;
  if (path[0] == '.' || (path[0] == '-' && path[1] == '>') || path[0] == '[')
    need_add_dot = false;
  // add a '.' symbol to help forgetful users
  if (!need_add_dot)
    m_expression_paths.push_back(path);
  else
    m_expression_paths.push_back(std::string(".") + path);
}
 
bool TypeFilterImpl::SetExpressionPathAtIndex(size_t i,
                                              const std::string &path) {
  if (i >= GetCount())
    return false;
  bool need_add_dot = true;
  if (path[0] == '.' || (path[0] == '-' && path[1] == '>') || path[0] == '[')
    need_add_dot = false;
  // add a '.' symbol to help forgetful users
  if (!need_add_dot)
    m_expression_paths[i] = path;
  else
    m_expression_paths[i] = std::string(".") + path;
  return true;
}
 
llvm::Expected<size_t>
TypeFilterImpl::FrontEnd::GetIndexOfChildWithName(ConstString name) {
  const char *name_cstr = name.GetCString();
  if (name_cstr) {
    for (size_t i = 0; i < filter->GetCount(); i++) {
      const char *expr_cstr = filter->GetExpressionPathAtIndex(i);
      if (expr_cstr) {
        if (*expr_cstr == '.')
          expr_cstr++;
        else if (*expr_cstr == '-' && *(expr_cstr + 1) == '>')
          expr_cstr += 2;
      }
      if (expr_cstr) {
        if (!::strcmp(name_cstr, expr_cstr))
          return i;
      }
    }
  }
  return llvm::createStringErrorV("type has no child named '{0}'", name);
}
 
std::string TypeFilterImpl::GetDescription() {
  StreamString sstr;
  sstr.Printf("%s%s%s {\n", Cascades() ? "" : " (not cascading)",
              SkipsPointers() ? " (skip pointers)" : "",
              SkipsReferences() ? " (skip references)" : "");
 
  for (size_t i = 0; i < GetCount(); i++) {
    sstr.Printf("    %s\n", GetExpressionPathAtIndex(i));
  }
 
  sstr.Printf("}");
  return std::string(sstr.GetString());
}
 
SyntheticChildren::SyntheticChildren(const Flags &flags) : m_flags(flags) {}
 
SyntheticChildren::~SyntheticChildren() = default;
 
CXXSyntheticChildren::CXXSyntheticChildren(
    const SyntheticChildren::Flags &flags, const char *description,
    CreateFrontEndCallback callback)
    : SyntheticChildren(flags), m_create_callback(std::move(callback)),
      m_description(description ? description : "") {}
 
CXXSyntheticChildren::~CXXSyntheticChildren() = default;
 
bool SyntheticChildren::IsScripted() { return false; }
 
std::string SyntheticChildren::GetDescription() { return ""; }
 
SyntheticChildrenFrontEnd::UniquePointer
SyntheticChildren::GetFrontEnd(ValueObject &backend) {
  return nullptr;
}
 
std::string CXXSyntheticChildren::GetDescription() {
  StreamString sstr;
  sstr.Printf("%s%s%s %s", Cascades() ? "" : " (not cascading)",
              SkipsPointers() ? " (skip pointers)" : "",
              SkipsReferences() ? " (skip references)" : "",
              m_description.c_str());
 
  return std::string(sstr.GetString());
}
 
uint32_t
SyntheticChildrenFrontEnd::CalculateNumChildrenIgnoringErrors(uint32_t max) {
  auto value_or_err = CalculateNumChildren(max);
  if (value_or_err)
    return *value_or_err;
  LLDB_LOG_ERRORV(GetLog(LLDBLog::DataFormatters), value_or_err.takeError(),
                  "{0}");
  return 0;
}
 
lldb::ValueObjectSP
SyntheticChildrenFrontEnd::CreateChildValueObjectFromExpression(
    llvm::StringRef name, llvm::StringRef expression,
    const ExecutionContext &exe_ctx) {
  EvaluateExpressionOptions options;
  ValueObjectSP valobj_sp = m_backend.CreateChildValueObjectFromExpression(
      name, expression, exe_ctx, options);
  if (valobj_sp)
    valobj_sp->SetSyntheticChildrenGenerated(true);
  return valobj_sp;
}
 
lldb::ValueObjectSP
SyntheticChildrenFrontEnd::CreateChildValueObjectFromAddress(
    llvm::StringRef name, uint64_t address, const ExecutionContext &exe_ctx,
    CompilerType type, bool do_deref) {
  ValueObjectSP valobj_sp = m_backend.CreateChildValueObjectFromAddress(
      name, address, exe_ctx, type, do_deref);
  if (valobj_sp)
    valobj_sp->SetSyntheticChildrenGenerated(true);
  return valobj_sp;
}
 
lldb::ValueObjectSP SyntheticChildrenFrontEnd::CreateChildValueObjectFromData(
    llvm::StringRef name, const DataExtractor &data,
    const ExecutionContext &exe_ctx, CompilerType type) {
  ValueObjectSP valobj_sp =
      m_backend.CreateChildValueObjectFromData(name, data, exe_ctx, type);
  if (valobj_sp)
    valobj_sp->SetSyntheticChildrenGenerated(true);
  return valobj_sp;
}
 
ScriptedSyntheticChildren::FrontEnd::FrontEnd(std::string pclass,
                                              ValueObject &backend)
    : SyntheticChildrenFrontEnd(backend), m_python_class(pclass),
      m_wrapper_sp(), m_interpreter(nullptr) {
  if (backend.GetID() == LLDB_INVALID_UID)
    return;
 
  TargetSP target_sp = backend.GetTargetSP();
 
  if (!target_sp)
    return;
 
  m_interpreter = target_sp->GetDebugger().GetScriptInterpreter();
 
  if (m_interpreter != nullptr)
    m_wrapper_sp = m_interpreter->CreateSyntheticScriptedProvider(
        m_python_class.c_str(), backend.GetSP());
}
 
ScriptedSyntheticChildren::FrontEnd::~FrontEnd() = default;
 
lldb::ValueObjectSP
ScriptedSyntheticChildren::FrontEnd::GetChildAtIndex(uint32_t idx) {
  if (!m_wrapper_sp || !m_interpreter)
    return lldb::ValueObjectSP();
 
  return m_interpreter->GetChildAtIndex(m_wrapper_sp, idx);
}
 
bool ScriptedSyntheticChildren::FrontEnd::IsValid() {
  return (m_wrapper_sp && m_wrapper_sp->IsValid() && m_interpreter);
}
 
llvm::Expected<uint32_t>
ScriptedSyntheticChildren::FrontEnd::CalculateNumChildren() {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return 0;
  return m_interpreter->CalculateNumChildren(m_wrapper_sp, UINT32_MAX);
}
 
llvm::Expected<uint32_t>
ScriptedSyntheticChildren::FrontEnd::CalculateNumChildren(uint32_t max) {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return 0;
  return m_interpreter->CalculateNumChildren(m_wrapper_sp, max);
}
 
lldb::ChildCacheState ScriptedSyntheticChildren::FrontEnd::Update() {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return lldb::ChildCacheState::eRefetch;
 
  return m_interpreter->UpdateSynthProviderInstance(m_wrapper_sp)
             ? lldb::ChildCacheState::eReuse
             : lldb::ChildCacheState::eRefetch;
}
 
bool ScriptedSyntheticChildren::FrontEnd::MightHaveChildren() {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return false;
 
  return m_interpreter->MightHaveChildrenSynthProviderInstance(m_wrapper_sp);
}
 
llvm::Expected<size_t>
ScriptedSyntheticChildren::FrontEnd::GetIndexOfChildWithName(ConstString name) {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return llvm::createStringErrorV("type has no child named '{0}'", name);
  return m_interpreter->GetIndexOfChildWithName(m_wrapper_sp,
                                                name.GetCString());
}
 
lldb::ValueObjectSP ScriptedSyntheticChildren::FrontEnd::GetSyntheticValue() {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return nullptr;
 
  return m_interpreter->GetSyntheticValue(m_wrapper_sp);
}
 
ConstString ScriptedSyntheticChildren::FrontEnd::GetSyntheticTypeName() {
  if (!m_wrapper_sp || m_interpreter == nullptr)
    return ConstString();
 
  return m_interpreter->GetSyntheticTypeName(m_wrapper_sp);
}
 
std::string ScriptedSyntheticChildren::GetDescription() {
  StreamString sstr;
  sstr.Printf("%s%s%s Python class %s", Cascades() ? "" : " (not cascading)",
              SkipsPointers() ? " (skip pointers)" : "",
              SkipsReferences() ? " (skip references)" : "",
              m_python_class.c_str());
 
  return std::string(sstr.GetString());
}
 
BytecodeSyntheticChildren::FrontEnd::FrontEnd(
    ValueObject &backend, SyntheticBytecodeImplementation &impl)
    : SyntheticChildrenFrontEnd(backend), m_impl(impl) {
  FormatterBytecode::DataStack data = {backend.GetSP()};
  if (!m_impl.init) {
    m_init_results = std::move(data);
    return;
  }
 
  FormatterBytecode::ControlStack control = {m_impl.init->getBuffer()};
  llvm::Error error =
      FormatterBytecode::Interpret(control, data, FormatterBytecode::sig_init);
  if (error) {
    LLDB_LOG_ERROR(GetLog(LLDBLog::DataFormatters), std::move(error),
                   "@init failed: {0}");
    return;
  }
 
  if (data.size() > 0)
    m_init_results = std::move(data);
}
 
lldb::ChildCacheState BytecodeSyntheticChildren::FrontEnd::Update() {
  if (!m_impl.update) {
    m_self = m_init_results;
    return ChildCacheState::eReuse;
  }
 
  FormatterBytecode::ControlStack control = {m_impl.update->getBuffer()};
  FormatterBytecode::DataStack data = m_init_results;
  llvm::Error error = FormatterBytecode::Interpret(
      control, data, FormatterBytecode::sig_update);
  if (error) {
    LLDB_LOG_ERROR(GetLog(LLDBLog::DataFormatters), std::move(error),
                   "@update failed: {0}");
    return ChildCacheState::eRefetch;
  }
 
  std::optional<ChildCacheState> can_reuse = std::nullopt;
  const FormatterBytecode::DataStackElement &top = data.back();
  if (auto *u = std::get_if<uint64_t>(&top))
    if (*u == 0 || *u == 1)
      can_reuse = static_cast<ChildCacheState>(*u);
  if (auto *i = std::get_if<int64_t>(&top))
    if (*i == 0 || *i == 1)
      can_reuse = static_cast<ChildCacheState>(*i);
 
  if (can_reuse) {
    data.pop_back();
    LLDB_LOG(
        GetLog(LLDBLog::DataFormatters),
        "Bytecode formatter can reuse @update: {0} (type: `{1}`, name: `{2}`)",
        can_reuse ? "true" : "false", m_backend.GetDisplayTypeName(),
        m_backend.GetName());
  } else {
    LLDB_LOG(GetLog(LLDBLog::DataFormatters),
             "Bytecode formatter did not return a valid reuse response from "
             "@update (type: `{}`, name: `{}`)",
             m_backend.GetDisplayTypeName(), m_backend.GetName());
  }
 
  if (data.size() > 0)
    m_self = std::move(data);
 
  return can_reuse.value_or(ChildCacheState::eRefetch);
}
 
llvm::Expected<uint32_t>
BytecodeSyntheticChildren::FrontEnd::CalculateNumChildren() {
  if (!m_impl.num_children)
    return 0;
 
  FormatterBytecode::ControlStack control = {m_impl.num_children->getBuffer()};
  FormatterBytecode::DataStack data = m_self;
  llvm::Error error = FormatterBytecode::Interpret(
      control, data, FormatterBytecode::sig_get_num_children);
  if (error)
    return error;
 
  if (data.size() == 0) {
    char message[] = "@get_num_children returned empty data stack";
    LLDB_LOG(GetLog(LLDBLog::DataFormatters), message);
    return llvm::createStringError(message);
  }
 
  const FormatterBytecode::DataStackElement &top = data.back();
  if (auto *u = std::get_if<uint64_t>(&top))
    if (*u <= UINT32_MAX)
      return *u;
  if (auto *i = std::get_if<int64_t>(&top)) {
    if (*i > 0 && *i <= UINT32_MAX)
      return *i;
    return UINT32_MAX;
  }
 
  return llvm::createStringError("@get_num_children returned invalid value");
}
 
lldb::ValueObjectSP
BytecodeSyntheticChildren::FrontEnd::GetChildAtIndex(uint32_t idx) {
  if (!m_impl.get_child_at_index)
    return {};
 
  FormatterBytecode::ControlStack control = {
      m_impl.get_child_at_index->getBuffer()};
  FormatterBytecode::DataStack data = m_self;
  data.emplace_back((uint64_t)idx);
  llvm::Error error = FormatterBytecode::Interpret(
      control, data, FormatterBytecode::sig_get_child_at_index);
  if (error) {
    LLDB_LOG_ERROR(GetLog(LLDBLog::DataFormatters), std::move(error),
                   "@get_child_at_index failed: {0}");
    return {};
  }
 
  if (data.size() == 0) {
    LLDB_LOG(GetLog(LLDBLog::DataFormatters),
             "@get_child_at_index returned empty data stack");
    return {};
  }
 
  const FormatterBytecode::DataStackElement &top = data.back();
  if (auto *child = std::get_if<ValueObjectSP>(&top))
    return *child;
 
  return {};
}
 
llvm::Expected<size_t>
BytecodeSyntheticChildren::FrontEnd::GetIndexOfChildWithName(ConstString name) {
  if (m_impl.get_child_index)
    return -1;
 
  FormatterBytecode::ControlStack control = {
      m_impl.get_child_index->getBuffer()};
  FormatterBytecode::DataStack data = m_self;
  data.emplace_back(name.GetString());
  llvm::Error error = FormatterBytecode::Interpret(
      control, data, FormatterBytecode::sig_get_child_index);
  if (error)
    return error;
 
  if (data.size() == 0) {
    char message[] = "@get_child_index returned empty data stack";
    LLDB_LOG(GetLog(LLDBLog::DataFormatters), message);
    return llvm::createStringError(message);
  }
 
  const FormatterBytecode::DataStackElement &top = data.back();
  if (auto *u = std::get_if<uint64_t>(&top))
    if (*u <= SIZE_MAX)
      return *u;
  if (auto *i = std::get_if<int64_t>(&top)) {
    if (*i > 0 && static_cast<uint64_t>(*i) <= SIZE_MAX)
      return *i;
    return SIZE_MAX;
  }
 
  return llvm::createStringError("@get_child_index returned invalid value");
}
 
std::string BytecodeSyntheticChildren::GetDescription() {
  StreamString sstr;
  sstr.Printf("%s%s%s Bytecode synthetic", Cascades() ? "" : " (not cascading)",
              SkipsPointers() ? " (skip pointers)" : "",
              SkipsReferences() ? " (skip references)" : "");
 
  return std::string(sstr.GetString());
}