Introduce a unified target hook command system for LLDB that handles
multiple target lifecycle events (module load, module unload, process
stop) through a single Hook class.
The existing target stop-hook commands remain unchanged for now, meaning
stop-hooks can now be created through either target stop-hook add or
target hook add -S.
A future follow-up can alias target stop-hook to the unified system to
consolidate the two paths.
New commands:
- target hook add [-o cmd] [-P class] [-u] [-S] - create a hook (fires
on module load by default, optionally on unload/stop)
- target hook add-filter [filter-opts] <hook-id> - attach stop-event
filters (shlib, function, file/line, thread) to an existing hook
- target hook list / delete / enable / disable - manage hooks
- target hook {enable,disable} {module-loaded|module-unloaded|stop-hook}
<id> - per-event toggling
top-event filter options live on a separate add-filter command rather
than on target hook add, keeping the add command clean and making the
system safe for filters on other event types.
Ran the tests + Made sure stop tests are passing as well.
---------
Co-authored-by: Bar Soloveychik <barsolo@fb.com>
55 lines
2.1 KiB
C++
55 lines
2.1 KiB
C++
//===-- ScriptedHookPythonInterface.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_SOURCE_PLUGINS_SCRIPTINTERPRETER_PYTHON_INTERFACES_SCRIPTEDHOOKPYTHONINTERFACE_H
|
|
#define LLDB_SOURCE_PLUGINS_SCRIPTINTERPRETER_PYTHON_INTERFACES_SCRIPTEDHOOKPYTHONINTERFACE_H
|
|
|
|
#include "lldb/Interpreter/Interfaces/ScriptedHookInterface.h"
|
|
|
|
#include "ScriptedPythonInterface.h"
|
|
|
|
namespace lldb_private {
|
|
class ScriptedHookPythonInterface : public ScriptedHookInterface,
|
|
public ScriptedPythonInterface,
|
|
public PluginInterface {
|
|
public:
|
|
ScriptedHookPythonInterface(ScriptInterpreterPythonImpl &interpreter);
|
|
|
|
llvm::Expected<StructuredData::GenericSP>
|
|
CreatePluginObject(llvm::StringRef class_name, lldb::TargetSP target_sp,
|
|
const StructuredDataImpl &args_sp) override;
|
|
|
|
/// A hook class must implement at least one callback. All three are
|
|
/// individually optional; hooks that implement none will be rejected
|
|
/// at creation time.
|
|
llvm::SmallVector<AbstractMethodRequirement>
|
|
GetAbstractMethodRequirements() const override {
|
|
return {};
|
|
}
|
|
|
|
/// Check which of the three hook methods the Python class implements.
|
|
SupportedHookMethods GetSupportedMethods() override;
|
|
|
|
void HandleModuleLoaded(lldb::StreamSP &output_sp) override;
|
|
void HandleModuleUnloaded(lldb::StreamSP &output_sp) override;
|
|
llvm::Expected<bool> HandleStop(ExecutionContext &exe_ctx,
|
|
lldb::StreamSP &output_sp) override;
|
|
|
|
static void Initialize();
|
|
static void Terminate();
|
|
|
|
static llvm::StringRef GetPluginNameStatic() {
|
|
return "ScriptedHookPythonInterface";
|
|
}
|
|
|
|
llvm::StringRef GetPluginName() override { return GetPluginNameStatic(); }
|
|
};
|
|
} // namespace lldb_private
|
|
|
|
#endif // LLDB_SOURCE_PLUGINS_SCRIPTINTERPRETER_PYTHON_INTERFACES_SCRIPTEDHOOKPYTHONINTERFACE_H
|