IntelPTProcessTrace.h

Go to the documentation of this file.

//===-- IntelPTProcessTrace.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 liblldb_IntelPTProcessTrace_H_
#define liblldb_IntelPTProcessTrace_H_
 
#include "lldb/Utility/TraceIntelPTGDBRemotePackets.h"
 
#include <memory>
#include <optional>
 
namespace lldb_private {
namespace process_linux {
 
/// Interface to be implemented by each 'process trace' strategy (per cpu, per
/// thread, etc).
class IntelPTProcessTrace {
public:
  virtual ~IntelPTProcessTrace() = default;
 
  virtual void ProcessDidStop() {}
 
  virtual void ProcessWillResume() {}
 
  /// Construct a minimal jLLDBTraceGetState response for this process trace.
  virtual TraceIntelPTGetStateResponse GetState() = 0;
 
  virtual bool TracesThread(lldb::tid_t tid) const = 0;
 
  /// \copydoc IntelPTThreadTraceCollection::TraceStart()
  virtual llvm::Error TraceStart(lldb::tid_t tid) = 0;
 
  /// \copydoc IntelPTThreadTraceCollection::TraceStop()
  virtual llvm::Error TraceStop(lldb::tid_t tid) = 0;
 
  /// \return
  ///   \b std::nullopt if this instance doesn't support the requested data, an
  ///   \a llvm::Error if this isntance supports it but fails at fetching it,
  ///   and \b Error::success() otherwise.
  virtual llvm::Expected<std::optional<std::vector<uint8_t>>>
  TryGetBinaryData(const TraceGetBinaryDataRequest &request) = 0;
};
 
using IntelPTProcessTraceUP = std::unique_ptr<IntelPTProcessTrace>;
 
} // namespace process_linux
} // namespace lldb_private
 
#endif // liblldb_IntelPTProcessTrace_H_