llvm-project/lldb/source/Plugins/Process/Linux/IntelPTThreadTraceCollection.h
Walter Erquinigo fc5ef57c7d [trace][intelpt] Support system-wide tracing [12] - Support multi-core trace load and save
:q!
This diff is massive, but it's because it connects the client with lldb-server
and also ensures that the postmortem case works.

- Flatten the postmortem trace schema. The reason is that the schema has become quite complex due to the new multicore case, which defeats the original purpose of having a schema that could work for every trace plug-in. At this point, it's better that each trace plug-in defines it's own full schema. This means that the only common field is "type".
-- Because of this new approach, I merged the "common" trace load and saving functionalities into the IntelPT one. This simplified the code quite a bit. If we eventually implement another trace plug-in, we can see then what we could reuse.
-- The new schema, which is flattened, has now better comments and is parsed better. A change I did was to disallow hex addresses, because they are a bit error prone. I'm asking now to print the address in decimal.
-- Renamed "intel" to "GenuineIntel" in the schema because that's what you see in /proc/cpuinfo.
- Implemented reading the context switch trace data buffer. I had to do
some refactors to do that cleanly.
-- A major change that I did here was to simplify the perf_event circular buffer reading logic. It was too complex. Maybe the original Intel author had something different in mind.
- Implemented all the necessary bits to read trace.json files with per-core data.
- Implemented all the necessary bits to save to disk per-core trace session.
- Added a test that ensures that parsing and saving to disk works.

Differential Revision: https://reviews.llvm.org/D126015
2022-06-15 13:28:36 -07:00

76 lines
2.4 KiB
C++

//===-- IntelPTThreadTraceCollection.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_IntelPTPerThreadTraceCollection_H_
#define liblldb_IntelPTPerThreadTraceCollection_H_
#include "IntelPTSingleBufferTrace.h"
namespace lldb_private {
namespace process_linux {
/// Manages a list of thread traces.
class IntelPTThreadTraceCollection {
public:
IntelPTThreadTraceCollection() {}
/// Dispose of all traces
void Clear();
/// \return
/// \b true if and only if this instance of tracing the provided \p tid.
bool TracesThread(lldb::tid_t tid) const;
/// \return
/// The total sum of the trace buffer sizes used by this collection.
size_t GetTotalBufferSize() const;
/// Execute the provided callback on each thread that is being traced.
///
/// \param[in] callback.tid
/// The id of the thread that is being traced.
///
/// \param[in] callback.core_trace
/// The single-buffer trace instance for the given core.
void ForEachThread(std::function<void(lldb::tid_t tid,
IntelPTSingleBufferTrace &thread_trace)>
callback);
llvm::Expected<IntelPTSingleBufferTrace &> GetTracedThread(lldb::tid_t tid);
/// Start tracing the thread given by its \p tid.
///
/// \return
/// An error if the operation failed.
llvm::Error TraceStart(lldb::tid_t tid,
const TraceIntelPTStartRequest &request);
/// Stop tracing the thread given by its \p tid.
///
/// \return
/// An error if the given thread is not being traced or tracing couldn't be
/// stopped.
llvm::Error TraceStop(lldb::tid_t tid);
size_t GetTracedThreadsCount() const;
/// \copydoc IntelPTProcessTrace::TryGetBinaryData()
llvm::Expected<llvm::Optional<std::vector<uint8_t>>>
TryGetBinaryData(const TraceGetBinaryDataRequest &request);
private:
llvm::DenseMap<lldb::tid_t, IntelPTSingleBufferTrace> m_thread_traces;
/// Total actual thread buffer size in bytes
size_t m_total_buffer_size = 0;
};
} // namespace process_linux
} // namespace lldb_private
#endif // liblldb_IntelPTPerThreadTraceCollection_H_