LLDB  mainline
HistoryThread.h
Go to the documentation of this file.
1 //===-- HistoryThread.h -----------------------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #ifndef LLDB_SOURCE_PLUGINS_PROCESS_UTILITY_HISTORYTHREAD_H
10 #define LLDB_SOURCE_PLUGINS_PROCESS_UTILITY_HISTORYTHREAD_H
11 
12 #include <mutex>
13 
17 #include "lldb/Target/Thread.h"
19 #include "lldb/Utility/Event.h"
20 #include "lldb/Utility/UserID.h"
21 #include "lldb/lldb-private.h"
22 
23 namespace lldb_private {
24 
25 /// \class HistoryThread HistoryThread.h "HistoryThread.h"
26 /// A thread object representing a backtrace from a previous point in the
27 /// process execution
28 ///
29 /// This subclass of Thread is used to provide a backtrace from earlier in
30 /// process execution. It is given a backtrace list of pc addresses and it
31 /// will create stack frames for them.
32 
34 public:
36  std::vector<lldb::addr_t> pcs,
37  bool pcs_are_call_addresses = false);
38 
39  ~HistoryThread() override;
40 
41  lldb::RegisterContextSP GetRegisterContext() override;
42 
43  lldb::RegisterContextSP
45 
46  void RefreshStateAfterStop() override {}
47 
48  bool CalculateStopInfo() override { return false; }
49 
50  void SetExtendedBacktraceToken(uint64_t token) override {
52  }
53 
54  uint64_t GetExtendedBacktraceToken() override {
56  }
57 
58  const char *GetQueueName() override { return m_queue_name.c_str(); }
59 
60  void SetQueueName(const char *name) override { m_queue_name = name; }
61 
62  lldb::queue_id_t GetQueueID() override { return m_queue_id; }
63 
64  void SetQueueID(lldb::queue_id_t queue) override { m_queue_id = queue; }
65 
66  const char *GetThreadName() { return m_thread_name.c_str(); }
67 
69 
70  void SetThreadName(const char *name) { m_thread_name = name; }
71 
72  const char *GetName() override { return m_thread_name.c_str(); }
73 
74  void SetName(const char *name) override { m_thread_name = name; }
75 
76 protected:
77  virtual lldb::StackFrameListSP GetStackFrameList();
78 
79  mutable std::mutex m_framelist_mutex;
80  lldb::StackFrameListSP m_framelist;
81  std::vector<lldb::addr_t> m_pcs;
82 
84  std::string m_queue_name;
85  std::string m_thread_name;
88 };
89 
90 } // namespace lldb_private
91 
92 #endif // LLDB_SOURCE_PLUGINS_PROCESS_UTILITY_HISTORYTHREAD_H
uint64_t GetExtendedBacktraceToken() override
Gets the extended backtrace token for this thread.
Definition: HistoryThread.h:54
virtual lldb::StackFrameListSP GetStackFrameList()
A class that represents a running process on the host machine.
lldb::RegisterContextSP GetRegisterContext() override
const char * GetQueueName() override
Retrieve the Queue name for the queue currently using this Thread.
Definition: HistoryThread.h:58
void SetQueueID(lldb::queue_id_t queue) override
Definition: HistoryThread.h:64
void SetQueueName(const char *name) override
Definition: HistoryThread.h:60
bool CalculateStopInfo() override
Definition: HistoryThread.h:48
void RefreshStateAfterStop() override
Definition: HistoryThread.h:46
HistoryThread(lldb_private::Process &process, lldb::tid_t tid, std::vector< lldb::addr_t > pcs, bool pcs_are_call_addresses=false)
lldb::queue_id_t GetQueueID() override
Retrieve the Queue ID for the queue currently using this Thread.
Definition: HistoryThread.h:62
lldb::tid_t m_originating_unique_thread_id
Definition: HistoryThread.h:86
std::vector< lldb::addr_t > m_pcs
Definition: HistoryThread.h:81
uint64_t tid_t
Definition: lldb-types.h:86
void SetName(const char *name) override
Definition: HistoryThread.h:74
A plug-in interface definition class for debugging a process.
Definition: Process.h:362
uint32_t GetExtendedBacktraceOriginatingIndexID() override
const char * GetThreadName()
Definition: HistoryThread.h:66
void SetThreadName(const char *name)
Definition: HistoryThread.h:70
A thread object representing a backtrace from a previous point in the process execution.
Definition: HistoryThread.h:33
uint64_t queue_id_t
Definition: lldb-types.h:91
lldb::StackFrameListSP m_framelist
Definition: HistoryThread.h:80
void SetExtendedBacktraceToken(uint64_t token) override
Sets the extended backtrace token for this thread.
Definition: HistoryThread.h:50
lldb::queue_id_t m_queue_id
Definition: HistoryThread.h:87
const char * GetName() override
Definition: HistoryThread.h:72
This base class provides an interface to stack frames.
Definition: StackFrame.h:40
lldb::RegisterContextSP CreateRegisterContextForFrame(StackFrame *frame) override