File Manager

003 File Manager

Current Path: /usr/src/contrib/llvm-project/lldb/include/lldb/Target

usr / src / contrib / llvm-project / lldb / include / lldb / Target /

📁 ..
📄 ABI.h(7 KB)
📄 AssertFrameRecognizer.h(1.79 KB)
📄 DynamicLoader.h(12.8 KB)
📄 ExecutionContext.h(23.91 KB)
📄 ExecutionContextScope.h(2.07 KB)
📄 InstrumentationRuntime.h(3.06 KB)
📄 InstrumentationRuntimeStopInfo.h(1.3 KB)
📄 JITLoader.h(2.15 KB)
📄 JITLoaderList.h(1.17 KB)
📄 Language.h(9.42 KB)
📄 LanguageRuntime.h(6.71 KB)
📄 Memory.h(4.66 KB)
📄 MemoryHistory.h(998 B)
📄 MemoryRegionInfo.h(4.76 KB)
📄 ModuleCache.h(2.42 KB)
📄 OperatingSystem.h(2.66 KB)
📄 PathMappingList.h(4.09 KB)
📄 Platform.h(42.4 KB)
📄 Process.h(110.8 KB)
📄 ProcessStructReader.h(3.27 KB)
📄 Queue.h(5.04 KB)
📄 QueueItem.h(5.24 KB)
📄 QueueList.h(3.32 KB)
📄 RegisterCheckpoint.h(1.89 KB)
📄 RegisterContext.h(7.73 KB)
📄 RegisterContextUnwind.h(9.73 KB)
📄 RegisterNumber.h(1.71 KB)
📄 RemoteAwarePlatform.h(3.76 KB)
📄 SectionLoadHistory.h(2.79 KB)
📄 SectionLoadList.h(2.36 KB)
📄 StackFrame.h(20.05 KB)
📄 StackFrameList.h(5.83 KB)
📄 StackFrameRecognizer.h(5.65 KB)
📄 StackID.h(3.16 KB)
📄 StopInfo.h(6.92 KB)
📄 StructuredDataPlugin.h(7.14 KB)
📄 SystemRuntime.h(11.83 KB)
📄 Target.h(49.2 KB)
📄 TargetList.h(7.75 KB)
📄 Thread.h(49.21 KB)
📄 ThreadCollection.h(1.63 KB)
📄 ThreadList.h(4.65 KB)
📄 ThreadPlan.h(24.41 KB)
📄 ThreadPlanBase.h(1.79 KB)
📄 ThreadPlanCallFunction.h(5.55 KB)
📄 ThreadPlanCallFunctionUsingABI.h(1.98 KB)
📄 ThreadPlanCallOnFunctionExit.h(1.56 KB)
📄 ThreadPlanCallUserExpression.h(2.21 KB)
📄 ThreadPlanPython.h(2.11 KB)
📄 ThreadPlanRunToAddress.h(2.04 KB)
📄 ThreadPlanShouldStopHere.h(5.02 KB)
📄 ThreadPlanStack.h(5.48 KB)
📄 ThreadPlanStepInRange.h(4.66 KB)
📄 ThreadPlanStepInstruction.h(1.86 KB)
📄 ThreadPlanStepOut.h(3.67 KB)
📄 ThreadPlanStepOverBreakpoint.h(1.84 KB)
📄 ThreadPlanStepOverRange.h(1.83 KB)
📄 ThreadPlanStepRange.h(3.69 KB)
📄 ThreadPlanStepThrough.h(1.97 KB)
📄 ThreadPlanStepUntil.h(2.12 KB)
📄 ThreadPlanTracer.h(2.32 KB)
📄 ThreadSpec.h(3.35 KB)
📄 UnixSignals.h(4.25 KB)
📄 Unwind.h(2.4 KB)
📄 UnwindAssembly.h(1.81 KB)
📄 UnwindLLDB.h(5.69 KB)

Editing: StructuredDataPlugin.h

//===-- StructuredDataPlugin.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_TARGET_STRUCTUREDDATAPLUGIN_H
#define LLDB_TARGET_STRUCTUREDDATAPLUGIN_H

#include "lldb/Core/PluginInterface.h"
#include "lldb/Utility/StructuredData.h"

namespace lldb_private {

class CommandObjectMultiword;

/// Plugin that supports process-related structured data sent asynchronously
/// from the debug monitor (e.g. debugserver, lldb-server, etc.)
///
/// This plugin type is activated by a Process-derived instance when that
/// instance detects that a given structured data feature is available.
///
/// StructuredDataPlugin instances are inherently tied to a process.  The
/// main functionality they support is the ability to consume asynchronously-
/// delivered structured data from the process monitor, and do something
/// reasonable with it.  Something reasonable can include broadcasting a
/// StructuredData event, which other parts of the system can then do with
/// as they please.  An IDE could use this facility to retrieve CPU usage,
/// memory usage, and other run-time aspects of the process.  That data
/// can then be displayed meaningfully to the user through the IDE.

/// For command-line LLDB, the Debugger instance listens for the structured
/// data events raised by the plugin, and give the plugin both the output
/// and error streams such that the plugin can display something about the
/// event, at a time when the debugger ensures it is safe to write to the
/// output or error streams.

class StructuredDataPlugin
    : public PluginInterface,
      public std::enable_shared_from_this<StructuredDataPlugin> {
public:
  ~StructuredDataPlugin() override;

lldb::ProcessSP GetProcess() const;

// Public instance API

/// Return whether this plugin supports the given StructuredData feature.
  ///
  /// When Process is informed of a list of process-monitor-supported
  /// structured data features, Process will go through the list of plugins,
  /// one at a time, and have the first plugin that supports a given feature
  /// be the plugin instantiated to handle that feature.  There is a 1-1
  /// correspondence between a Process instance and a StructuredDataPlugin
  /// mapped to that process.  A plugin can support handling multiple
  /// features, and if that happens, there is a single plugin instance
  /// created covering all of the mapped features for a given process.
  ///
  /// \param[in] type_name
  ///     The name of the feature tag supported by a process.
  ///     e.g. "darwin-log".
  ///
  /// \return
  ///     true if the plugin supports the feature; otherwise, false.
  virtual bool SupportsStructuredDataType(ConstString type_name) = 0;

/// Handle the arrival of asynchronous structured data from the process.
  ///
  /// When asynchronous structured data arrives from the process monitor,
  /// it is immediately delivered to the plugin mapped for that feature
  /// if one exists.  The structured data that arrives from a process
  /// monitor must be a dictionary, and it must have a string field named
  /// "type" that must contain the StructuredData feature name set as the
  /// value.  This is the manner in which the data is routed to the proper
  /// plugin instance.
  ///
  /// \param[in] process
  ///     The process instance that just received the structured data.
  ///     This will always be the same process for a given instance of
  ///     a plugin.
  ///
  /// \param[in] type_name
  ///     The name of the feature tag for the asynchronous structured data.
  ///     Note this data will also be present in the \b object_sp dictionary
  ///     under the string value with key "type".
  ///
  /// \param[in] object_sp
  ///     A shared pointer to the structured data that arrived.  This must
  ///     be a dictionary.  The only key required is the aforementioned
  ///     key named "type" that must be a string value containing the
  ///     structured data type name.
  virtual void
  HandleArrivalOfStructuredData(Process &process, ConstString type_name,
                                const StructuredData::ObjectSP &object_sp) = 0;

/// Get a human-readable description of the contents of the data.
  ///
  /// In command-line LLDB, this method will be called by the Debugger
  /// instance for each structured data event generated, and the output
  /// will be printed to the LLDB console.  If nothing is added to the stream,
  /// nothing will be printed; otherwise, a newline will be added to the end
  /// when displayed.
  ///
  /// \param[in] object_sp
  ///     A shared pointer to the structured data to format.
  ///
  /// \param[in] stream
  ///     The stream where the structured data should be pretty printed.
  ///
  /// \return
  ///     The error if formatting the object contents failed; otherwise,
  ///     success.
  virtual Status GetDescription(const StructuredData::ObjectSP &object_sp,
                                lldb_private::Stream &stream) = 0;

/// Returns whether the plugin's features are enabled.
  ///
  /// This is a convenience method for plugins that can enable or disable
  /// their functionality.  It allows retrieval of this state without
  /// requiring a cast.
  ///
  /// \param[in] type_name
  ///     The name of the feature tag for the asynchronous structured data.
  ///     This is needed for plugins that support more than one feature.
  virtual bool GetEnabled(ConstString type_name) const;

/// Allow the plugin to do work related to modules that loaded in the
  /// the corresponding process.
  ///
  /// This method defaults to doing nothing.  Plugins can override it
  /// if they have any behavior they want to enable/modify based on loaded
  /// modules.
  ///
  /// \param[in] process
  ///     The process that just was notified of modules having been loaded.
  ///     This will always be the same process for a given instance of
  ///     a plugin.
  ///
  /// \param[in] module_list
  ///     The list of modules that the process registered as having just
  ///     loaded.  See \b Process::ModulesDidLoad(...).
  virtual void ModulesDidLoad(Process &process, ModuleList &module_list);

protected:
  // Derived-class API
  StructuredDataPlugin(const lldb::ProcessWP &process_wp);

/// Derived classes must call this before attempting to hook up commands
  /// to the 'plugin structured-data' tree.
  ///
  /// This ensures the relevant command and options hook points for all
  /// StructuredDataPlugin derived classes are available for this debugger.
  /// If this has already happened, this call is a no-op.
  ///
  /// \param[in] debugger
  ///     The Debugger instance for which we're creating the required shared
  ///     components for the StructuredDataPlugin derived classes.
  static void InitializeBasePluginForDebugger(Debugger &debugger);

private:
  lldb::ProcessWP m_process_wp;

StructuredDataPlugin(const StructuredDataPlugin &) = delete;
  const StructuredDataPlugin &operator=(const StructuredDataPlugin &) = delete;
};
}

#endif

003 File Manager

Editing: StructuredDataPlugin.h

Upload File

Create Folder