summaryrefslogtreecommitdiff
path: root/tools/debugserver/source/MacOSX/DarwinLog/DarwinLogCollector.h
blob: f12f5752bb980715d88ce9b929d669bbbfe48853 (plain)
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
//===-- DarwinLogCollector.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 DarwinLogCollector_h
#define DarwinLogCollector_h

#include <sys/types.h>

#include <memory>
#include <mutex>
#include <unordered_map>

#include "ActivityStore.h"
#include "ActivityStreamSPI.h"
#include "DNBDefs.h"
#include "DarwinLogEvent.h"
#include "DarwinLogInterfaces.h"
#include "JSON.h"

class DarwinLogCollector;
typedef std::shared_ptr<DarwinLogCollector> DarwinLogCollectorSP;

class DarwinLogCollector
    : public std::enable_shared_from_this<DarwinLogCollector>,
      public ActivityStore {
public:
  //------------------------------------------------------------------
  /// Return whether the os_log and activity tracing SPI is available.
  ///
  /// @return \b true if the activity stream support is available,
  /// \b false otherwise.
  //------------------------------------------------------------------
  static bool IsSupported();

  //------------------------------------------------------------------
  /// Return a log function suitable for DNBLog to use as the internal
  /// logging function.
  ///
  /// @return a DNBLog-style logging function if IsSupported() returns
  ///      true; otherwise, returns nullptr.
  //------------------------------------------------------------------
  static DNBCallbackLog GetLogFunction();

  static bool StartCollectingForProcess(nub_process_t pid,
                                        const JSONObject &config);

  static bool CancelStreamForProcess(nub_process_t pid);

  static DarwinLogEventVector GetEventsForProcess(nub_process_t pid);

  ~DarwinLogCollector();

  pid_t GetProcessID() const { return m_pid; }

  //------------------------------------------------------------------
  // ActivityStore API
  //------------------------------------------------------------------
  const char *GetActivityForID(os_activity_id_t activity_id) const override;

  std::string
  GetActivityChainForID(os_activity_id_t activity_id) const override;

private:
  DarwinLogCollector() = delete;
  DarwinLogCollector(const DarwinLogCollector &) = delete;
  DarwinLogCollector &operator=(const DarwinLogCollector &) = delete;

  explicit DarwinLogCollector(nub_process_t pid,
                              const LogFilterChainSP &filter_chain_sp);

  void SignalDataAvailable();

  void SetActivityStream(os_activity_stream_t activity_stream);

  bool HandleStreamEntry(os_activity_stream_entry_t entry, int error);

  DarwinLogEventVector RemoveEvents();

  void CancelActivityStream();

  void GetActivityChainForID_internal(os_activity_id_t activity_id,
                                      std::string &result, size_t depth) const;

  struct ActivityInfo {
    ActivityInfo(const char *name, os_activity_id_t activity_id,
                 os_activity_id_t parent_activity_id)
        : m_name(name), m_id(activity_id), m_parent_id(parent_activity_id) {}

    const std::string m_name;
    const os_activity_id_t m_id;
    const os_activity_id_t m_parent_id;
  };

  using ActivityMap = std::unordered_map<os_activity_id_t, ActivityInfo>;

  const nub_process_t m_pid;
  os_activity_stream_t m_activity_stream;
  DarwinLogEventVector m_events;
  std::mutex m_events_mutex;
  LogFilterChainSP m_filter_chain_sp;

  /// Mutex to protect activity info (activity name and parent structures)
  mutable std::mutex m_activity_info_mutex;
  /// Map of activity id to ActivityInfo
  ActivityMap m_activity_map;
};

#endif /* LogStreamCollector_h */