a758205951
- Add collection of context switches per cpu grouped with the per-cpu intel pt traces. - Move the state handling from the interl pt trace class to the PerfEvent one. - Add support for stopping and enabling perf event groups. - Return context switch entries as part of the jLLDBTraceGetState response. - Move the triggers of whenever the process stopped or resumed. Now the will-resume notification is in a better location, which will ensure that we'll capture the instructions that will be executed. - Remove IntelPTSingleBufferTraceUP. The unique pointer was useless. - Add unit tests Differential Revision: https://reviews.llvm.org/D125897
122 lines
3.9 KiB
C++
122 lines
3.9 KiB
C++
//===-- IntelPTSingleBufferTrace.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_IntelPTSingleBufferTrace_H_
|
|
#define liblldb_IntelPTSingleBufferTrace_H_
|
|
|
|
#include "Perf.h"
|
|
|
|
#include "lldb/Utility/TraceIntelPTGDBRemotePackets.h"
|
|
#include "lldb/lldb-types.h"
|
|
|
|
#include "llvm/Support/Error.h"
|
|
|
|
#include <memory>
|
|
|
|
namespace lldb_private {
|
|
namespace process_linux {
|
|
|
|
llvm::Expected<uint32_t> GetIntelPTOSEventType();
|
|
|
|
/// This class wraps a single perf event collecting intel pt data in a single
|
|
/// buffer.
|
|
class IntelPTSingleBufferTrace {
|
|
public:
|
|
/// Start tracing using a single Intel PT trace buffer.
|
|
///
|
|
/// \param[in] request
|
|
/// Intel PT configuration parameters.
|
|
///
|
|
/// \param[in] tid
|
|
/// The tid of the thread to be traced. If \b None, then this traces all
|
|
/// threads of all processes.
|
|
///
|
|
/// \param[in] core_id
|
|
/// The CPU core id where to trace. If \b None, then this traces all CPUs.
|
|
///
|
|
/// \param[in] disabled
|
|
/// Whether to start the tracing paused.
|
|
///
|
|
/// \return
|
|
/// A \a IntelPTSingleBufferTrace instance if tracing was successful, or
|
|
/// an \a llvm::Error otherwise.
|
|
static llvm::Expected<IntelPTSingleBufferTrace>
|
|
Start(const TraceIntelPTStartRequest &request,
|
|
llvm::Optional<lldb::tid_t> tid,
|
|
llvm::Optional<lldb::core_id_t> core_id = llvm::None,
|
|
bool disabled = false);
|
|
|
|
/// \return
|
|
/// The bytes requested by a jLLDBTraceGetBinaryData packet that was routed
|
|
/// to this trace instace.
|
|
llvm::Expected<std::vector<uint8_t>>
|
|
GetBinaryData(const TraceGetBinaryDataRequest &request) const;
|
|
|
|
/// Read the trace buffer managed by this trace instance. To ensure that the
|
|
/// data is up-to-date and is not corrupted by read-write race conditions, the
|
|
/// underlying perf_event is paused during read, and later it's returned to
|
|
/// its initial state.
|
|
///
|
|
/// \param[in] offset
|
|
/// Offset of the data to read.
|
|
///
|
|
/// \param[in] size
|
|
/// Number of bytes to read.
|
|
///
|
|
/// \return
|
|
/// A vector with the requested binary data. The vector will have the
|
|
/// size of the requested \a size. Non-available positions will be
|
|
/// filled with zeroes.
|
|
llvm::Expected<std::vector<uint8_t>> GetTraceBuffer(size_t offset,
|
|
size_t size);
|
|
|
|
/// \return
|
|
/// The total the size in bytes used by the trace buffer managed by this
|
|
/// trace instance.
|
|
size_t GetTraceBufferSize() const;
|
|
|
|
/// Resume the collection of this trace.
|
|
///
|
|
/// \return
|
|
/// An error if the trace couldn't be resumed. If the trace is already
|
|
/// running, this returns \a Error::success().
|
|
llvm::Error Resume();
|
|
|
|
/// Pause the collection of this trace.
|
|
///
|
|
/// \return
|
|
/// An error if the trace couldn't be paused. If the trace is already
|
|
/// paused, this returns \a Error::success().
|
|
llvm::Error Pause();
|
|
|
|
/// \return
|
|
/// The underlying PerfEvent for this trace.
|
|
const PerfEvent &GetPerfEvent() const;
|
|
|
|
private:
|
|
/// Construct new \a IntelPTSingleBufferThreadTrace. Users are supposed to
|
|
/// create instances of this class via the \a Start() method and not invoke
|
|
/// this one directly.
|
|
///
|
|
/// \param[in] perf_event
|
|
/// perf event configured for IntelPT.
|
|
///
|
|
/// \param[in] collection_state
|
|
/// The initial collection state for the provided perf_event.
|
|
IntelPTSingleBufferTrace(PerfEvent &&perf_event)
|
|
: m_perf_event(std::move(perf_event)) {}
|
|
|
|
/// perf event configured for IntelPT.
|
|
PerfEvent m_perf_event;
|
|
};
|
|
|
|
} // namespace process_linux
|
|
} // namespace lldb_private
|
|
|
|
#endif // liblldb_IntelPTSingleBufferTrace_H_
|