Files
clang-p2996/lldb/source/Plugins/Trace/intel-pt/IntelPTDecoder.h
Walter Erquinigo b0aa70761b [trace][intel pt] Implement the Intel PT cursor
D104422 added the interface for TraceCursor, which is the main way to traverse instructions in a trace. This diff implements the corresponding cursor class for Intel PT and deletes the now obsolete code.

Besides that, the logic for the "thread trace dump instructions" was adapted to use this cursor (pretty much I ended up moving code from Trace.cpp to TraceCursor.cpp). The command by default traverses the instructions backwards, and if the user passes --forwards, then it's not forwards. More information about that is in the Options.td file.

Regarding the Intel PT cursor. All Intel PT cursors for the same thread share the same DecodedThread instance. I'm not yet implementing lazy decoding because we don't need it. That'll be for later. For the time being, the entire thread trace is decoded when the first cursor for that thread is requested.

Differential Revision: https://reviews.llvm.org/D105531
2021-07-16 16:47:43 -07:00

88 lines
2.4 KiB
C++

//===-- IntelPTDecoder.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_TRACE_INTEL_PT_DECODER_H
#define LLDB_SOURCE_PLUGINS_TRACE_INTEL_PT_DECODER_H
#include "intel-pt.h"
#include "DecodedThread.h"
#include "forward-declarations.h"
#include "lldb/Target/Process.h"
#include "lldb/Utility/FileSpec.h"
namespace lldb_private {
namespace trace_intel_pt {
/// Base class that handles the decoding of a thread and caches the result.
class ThreadDecoder {
public:
virtual ~ThreadDecoder() = default;
ThreadDecoder() = default;
/// Decode the thread and store the result internally, to avoid
/// recomputations.
///
/// \return
/// A \a DecodedThread instance.
DecodedThreadSP Decode();
ThreadDecoder(const ThreadDecoder &other) = delete;
ThreadDecoder &operator=(const ThreadDecoder &other) = delete;
protected:
/// Decode the thread.
///
/// \return
/// A \a DecodedThread instance.
virtual DecodedThreadSP DoDecode() = 0;
llvm::Optional<DecodedThreadSP> m_decoded_thread;
};
/// Decoder implementation for \a lldb_private::ThreadPostMortemTrace, which are
/// non-live processes that come trace session files.
class PostMortemThreadDecoder : public ThreadDecoder {
public:
/// \param[in] trace_thread
/// The thread whose trace file will be decoded.
///
/// \param[in] trace
/// The main Trace object who owns this decoder and its data.
PostMortemThreadDecoder(const lldb::ThreadPostMortemTraceSP &trace_thread,
TraceIntelPT &trace);
private:
DecodedThreadSP DoDecode() override;
lldb::ThreadPostMortemTraceSP m_trace_thread;
TraceIntelPT &m_trace;
};
class LiveThreadDecoder : public ThreadDecoder {
public:
/// \param[in] thread
/// The thread whose traces will be decoded.
///
/// \param[in] trace
/// The main Trace object who owns this decoder and its data.
LiveThreadDecoder(Thread &thread, TraceIntelPT &trace);
private:
DecodedThreadSP DoDecode() override;
lldb::ThreadSP m_thread_sp;
TraceIntelPT &m_trace;
};
} // namespace trace_intel_pt
} // namespace lldb_private
#endif // LLDB_SOURCE_PLUGINS_TRACE_INTEL_PT_DECODER_H