File: IntelPTMultiCoreTrace.h

package info (click to toggle)
llvm-toolchain-16 1%3A16.0.6-15~deb11u2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 1,634,820 kB
  • sloc: cpp: 6,179,261; ansic: 1,216,205; asm: 741,319; python: 196,614; objc: 75,325; f90: 49,640; lisp: 32,396; pascal: 12,286; sh: 9,394; perl: 7,442; ml: 5,494; awk: 3,523; makefile: 2,723; javascript: 1,206; xml: 886; fortran: 581; cs: 573
file content (113 lines) | stat: -rw-r--r-- 3,958 bytes parent folder | download | duplicates (12)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
//===-- IntelPTMultiCoreTrace.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_IntelPTMultiCoreTrace_H_
#define liblldb_IntelPTMultiCoreTrace_H_

#include "IntelPTProcessTrace.h"
#include "IntelPTSingleBufferTrace.h"
#include "lldb/Host/common/NativeProcessProtocol.h"
#include "lldb/Utility/TraceIntelPTGDBRemotePackets.h"
#include "lldb/lldb-types.h"
#include "llvm/Support/Error.h"
#include <memory>
#include <optional>

namespace lldb_private {
namespace process_linux {

class IntelPTMultiCoreTrace : public IntelPTProcessTrace {
  using ContextSwitchTrace = PerfEvent;

public:
  /// Start tracing all CPU cores.
  ///
  /// \param[in] request
  ///   Intel PT configuration parameters.
  ///
  /// \param[in] process
  ///   The process being debugged.
  ///
  ///  \param[in] cgroup_fd
  ///  A file descriptor in /sys/fs associated with the cgroup of the process to
  ///  trace. If not \a std::nullopt, then the trace sesion will use cgroup
  ///  filtering.
  ///
  /// \return
  ///   An \a IntelPTMultiCoreTrace instance if tracing was successful, or
  ///   an \a llvm::Error otherwise.
  static llvm::Expected<std::unique_ptr<IntelPTMultiCoreTrace>>
  StartOnAllCores(const TraceIntelPTStartRequest &request,
                  NativeProcessProtocol &process,
                  std::optional<int> cgroup_fd = std::nullopt);

  /// Execute the provided callback on each core that is being traced.
  ///
  /// \param[in] callback.cpu_id
  ///   The core id that is being traced.
  ///
  /// \param[in] callback.core_trace
  ///   The single-buffer trace instance for the given core.
  void ForEachCore(std::function<void(lldb::cpu_id_t cpu_id,
                                      IntelPTSingleBufferTrace &core_trace)>
                       callback);

  /// Execute the provided callback on each core that is being traced.
  ///
  /// \param[in] callback.cpu_id
  ///   The core id that is being traced.
  ///
  /// \param[in] callback.intelpt_trace
  ///   The single-buffer intel pt trace instance for the given core.
  ///
  /// \param[in] callback.context_switch_trace
  ///   The perf event collecting context switches for the given core.
  void ForEachCore(std::function<void(lldb::cpu_id_t cpu_id,
                                      IntelPTSingleBufferTrace &intelpt_trace,
                                      ContextSwitchTrace &context_switch_trace)>
                       callback);

  void ProcessDidStop() override;

  void ProcessWillResume() override;

  TraceIntelPTGetStateResponse GetState() override;

  bool TracesThread(lldb::tid_t tid) const override;

  llvm::Error TraceStart(lldb::tid_t tid) override;

  llvm::Error TraceStop(lldb::tid_t tid) override;

  llvm::Expected<std::optional<std::vector<uint8_t>>>
  TryGetBinaryData(const TraceGetBinaryDataRequest &request) override;

private:
  /// This assumes that all underlying perf_events for each core are part of the
  /// same perf event group.
  IntelPTMultiCoreTrace(
      llvm::DenseMap<lldb::cpu_id_t,
                     std::pair<IntelPTSingleBufferTrace, ContextSwitchTrace>>
          &&traces_per_core,
      NativeProcessProtocol &process, bool using_cgroup_filtering)
      : m_traces_per_core(std::move(traces_per_core)), m_process(process),
        m_using_cgroup_filtering(using_cgroup_filtering) {}

  llvm::DenseMap<lldb::cpu_id_t,
                 std::pair<IntelPTSingleBufferTrace, ContextSwitchTrace>>
      m_traces_per_core;

  /// The target process.
  NativeProcessProtocol &m_process;
  bool m_using_cgroup_filtering;
};

} // namespace process_linux
} // namespace lldb_private

#endif // liblldb_IntelPTMultiCoreTrace_H_