CPPLanguageRuntime.h

Go to the documentation of this file.

//===-- CPPLanguageRuntime.h
//
// 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
//
//===----------------------------------------------------------------------===//
 
#ifndef LLDB_SOURCE_PLUGINS_LANGUAGERUNTIME_CPLUSPLUS_CPPLANGUAGERUNTIME_H
#define LLDB_SOURCE_PLUGINS_LANGUAGERUNTIME_CPLUSPLUS_CPPLANGUAGERUNTIME_H
 
#include <vector>
 
#include "llvm/ADT/StringMap.h"
 
#include "CommonABIRuntime.h"
#include "lldb/Core/PluginInterface.h"
#include "lldb/Target/LanguageRuntime.h"
#include "lldb/Utility/Locked.h"
#include "lldb/lldb-private.h"
 
namespace lldb_private {
 
class CPPLanguageRuntime : public LanguageRuntime {
public:
  enum class LibCppStdFunctionCallableCase {
    Lambda = 0,
    CallableObject,
    FreeOrMemberFunction,
    Invalid
  };
 
  struct LibCppStdFunctionCallableInfo {
    Symbol callable_symbol;
    Address callable_address;
    LineEntry callable_line_entry;
    lldb::addr_t member_f_pointer_value = 0u;
    LibCppStdFunctionCallableCase callable_case =
        LibCppStdFunctionCallableCase::Invalid;
  };
 
  LibCppStdFunctionCallableInfo
  FindLibCppStdFunctionCallableInfo(lldb::ValueObjectSP &valobj_sp);
 
  static char ID;
 
  static void Initialize();
 
  static void Terminate();
 
  static lldb_private::LanguageRuntime *
  CreateInstance(Process *process, lldb::LanguageType language);
 
  static llvm::StringRef GetPluginNameStatic() {
    return "cpp-language-runtime";
  }
 
  llvm::StringRef GetPluginName() override { return GetPluginNameStatic(); }
 
  bool isA(const void *ClassID) const override {
    return ClassID == &ID || LanguageRuntime::isA(ClassID);
  }
 
  static bool classof(const LanguageRuntime *runtime) {
    return runtime->isA(&ID);
  }
 
  lldb::LanguageType GetLanguageType() const override {
    return lldb::eLanguageTypeC_plus_plus;
  }
 
  static CPPLanguageRuntime *Get(Process &process) {
    return llvm::cast_or_null<CPPLanguageRuntime>(
        process.GetLanguageRuntime(lldb::eLanguageTypeC_plus_plus));
  }
 
  llvm::Error GetObjectDescription(Stream &str, ValueObject &object) override;
 
  llvm::Error GetObjectDescription(Stream &str, Value &value,
                                   ExecutionContextScope *exe_scope) override;
 
  /// Obtain a ThreadPlan to get us into C++ constructs such as std::function.
  ///
  /// \param[in] thread
  ///     Current thrad of execution.
  ///
  /// \param[in] stop_others
  ///     True if other threads should pause during execution.
  ///
  /// \return
  ///      A ThreadPlan Shared pointer
  lldb::ThreadPlanSP GetStepThroughTrampolinePlan(Thread &thread,
                                                  bool stop_others) override;
 
  bool IsAllowedRuntimeValue(ConstString name) override;
 
  bool IsSymbolARuntimeThunk(const Symbol &symbol) override;
 
  llvm::Expected<LanguageRuntime::VTableInfo>
  GetVTableInfo(ValueObject &in_value, bool check_type) override;
 
  bool GetDynamicTypeAndAddress(ValueObject &in_value,
                                lldb::DynamicValueType use_dynamic,
                                TypeAndOrName &class_type_or_name,
                                Address &address, Value::ValueType &value_type,
                                llvm::ArrayRef<uint8_t> &local_buffer) override;
 
  TypeAndOrName FixUpDynamicType(const TypeAndOrName &type_and_or_name,
                                 ValueObject &static_value) override;
 
  bool CouldHaveDynamicValue(ValueObject &in_value) override;
 
  void SetExceptionBreakpoints() override;
 
  void ClearExceptionBreakpoints() override;
 
  bool ExceptionBreakpointsAreSet() override;
 
  bool ExceptionBreakpointsExplainStop(lldb::StopInfoSP stop_reason) override;
 
  lldb::BreakpointResolverSP
  CreateExceptionResolver(const lldb::BreakpointSP &bkpt, bool catch_bp,
                          bool throw_bp) override;
 
  lldb::SearchFilterSP CreateExceptionSearchFilter() override;
 
  lldb::ValueObjectSP
  GetExceptionObjectForThread(lldb::ThreadSP thread_sp) override;
 
private:
  CPPLanguageRuntime(Process *process);
 
  lldb::BreakpointResolverSP
  CreateExceptionResolver(const lldb::BreakpointSP &bkpt, bool catch_bp,
                          bool throw_bp, bool for_expressions);
 
  lldb::BreakpointSP CreateExceptionBreakpoint(bool catch_bp, bool throw_bp,
                                               bool for_expressions,
                                               bool is_internal);
 
  using OperatorStringToCallableInfoMap =
    llvm::StringMap<CPPLanguageRuntime::LibCppStdFunctionCallableInfo>;
 
  OperatorStringToCallableInfoMap CallableLookupCache;
 
  lldb::BreakpointSP m_cxx_exception_bp_sp;
  std::vector<std::unique_ptr<CommonABIRuntime>> m_abi_runtimes;
 
  struct VTableInfoEntry {
    VTableInfo info;
    CommonABIRuntime *runtime;
  };
 
  llvm::Expected<VTableInfoEntry> GetVTableInfoEntry(ValueObject &in_value,
                                                     bool check_type);
 
  using VTableInfoMap = std::map<Address, VTableInfoEntry>;
  Guarded<VTableInfoMap, std::mutex> m_vtable_info_map;
};
 
} // namespace lldb_private
 
#endif // LLDB_SOURCE_PLUGINS_LANGUAGERUNTIME_CPLUSPLUS_CPPLANGUAGERUNTIME_H