84b56202fb
This patch introduces a new scripting affordance in lldb: `ScriptedFrame`. This allows user to produce mock stackframes in scripted threads and scripted processes from a python script. With this change, StackFrame can be synthetized from different sources: - Either from a dictionary containing a load address, and a frame index, which is the legacy way. - Or by creating a ScriptedFrame python object. One particularity of synthezising stackframes from the ScriptedFrame python object, is that these frame have an optional PC, meaning that they don't have a report a valid PC and they can act as shells that just contain static information, like the frame function name, the list of variables or registers, etc. It can also provide a symbol context. rdar://157260006 Signed-off-by: Med Ismail Bennani <ismail@bennani.ma> Signed-off-by: Med Ismail Bennani <ismail@bennani.ma>
64 lines
2.2 KiB
C++
64 lines
2.2 KiB
C++
//===-- ScriptedThreadPythonInterface.h ------------------------*- C++ -*-===//
|
|
//
|
|
// 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_PLUGINS_SCRIPTINTERPRETER_PYTHON_INTERFACES_SCRIPTEDTHREADPYTHONINTERFACE_H
|
|
#define LLDB_PLUGINS_SCRIPTINTERPRETER_PYTHON_INTERFACES_SCRIPTEDTHREADPYTHONINTERFACE_H
|
|
|
|
#include "lldb/Host/Config.h"
|
|
|
|
#if LLDB_ENABLE_PYTHON
|
|
|
|
#include "ScriptedPythonInterface.h"
|
|
#include "lldb/Interpreter/Interfaces/ScriptedThreadInterface.h"
|
|
#include <optional>
|
|
|
|
namespace lldb_private {
|
|
class ScriptedThreadPythonInterface : public ScriptedThreadInterface,
|
|
public ScriptedPythonInterface {
|
|
public:
|
|
ScriptedThreadPythonInterface(ScriptInterpreterPythonImpl &interpreter);
|
|
|
|
llvm::Expected<StructuredData::GenericSP>
|
|
CreatePluginObject(llvm::StringRef class_name, ExecutionContext &exe_ctx,
|
|
StructuredData::DictionarySP args_sp,
|
|
StructuredData::Generic *script_obj = nullptr) override;
|
|
|
|
llvm::SmallVector<AbstractMethodRequirement>
|
|
GetAbstractMethodRequirements() const override {
|
|
return llvm::SmallVector<AbstractMethodRequirement>(
|
|
{{"get_stop_reason"}, {"get_register_context"}});
|
|
}
|
|
|
|
lldb::tid_t GetThreadID() override;
|
|
|
|
std::optional<std::string> GetName() override;
|
|
|
|
lldb::StateType GetState() override;
|
|
|
|
std::optional<std::string> GetQueue() override;
|
|
|
|
StructuredData::DictionarySP GetStopReason() override;
|
|
|
|
StructuredData::ArraySP GetStackFrames() override;
|
|
|
|
StructuredData::DictionarySP GetRegisterInfo() override;
|
|
|
|
std::optional<std::string> GetRegisterContext() override;
|
|
|
|
StructuredData::ArraySP GetExtendedInfo() override;
|
|
|
|
std::optional<std::string> GetScriptedFramePluginName() override;
|
|
|
|
protected:
|
|
lldb::ScriptedFrameInterfaceSP CreateScriptedFrameInterface() override;
|
|
};
|
|
} // namespace lldb_private
|
|
|
|
#endif // LLDB_ENABLE_PYTHON
|
|
#endif // LLDB_PLUGINS_SCRIPTINTERPRETER_PYTHON_INTERFACES_SCRIPTEDTHREADPYTHONINTERFACE_H
|