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
23namespace 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 pcs (return or call
31/// addresses) and it will create stack frames for them.
32
34public:
36 std::vector<lldb::addr_t> pcs,
38
39 ~HistoryThread() override;
40
42
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
76protected:
78
79 mutable std::mutex m_framelist_mutex;
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
bool CalculateStopInfo() override
Ask the thread subclass to set its stop info.
void SetName(const char *name) override
void SetQueueID(lldb::queue_id_t queue) override
void RefreshStateAfterStop() override
lldb::queue_id_t m_queue_id
lldb::queue_id_t GetQueueID() override
Retrieve the Queue ID for the queue currently using this Thread.
const char * GetQueueName() override
Retrieve the Queue name for the queue currently using this Thread.
void SetExtendedBacktraceToken(uint64_t token) override
Sets the extended backtrace token for this thread.
lldb::RegisterContextSP GetRegisterContext() override
const char * GetName() override
virtual lldb::StackFrameListSP GetStackFrameList()
uint32_t GetExtendedBacktraceOriginatingIndexID() override
HistoryThread(lldb_private::Process &process, lldb::tid_t tid, std::vector< lldb::addr_t > pcs, HistoryPCType pc_type=HistoryPCType::Returns)
lldb::RegisterContextSP CreateRegisterContextForFrame(StackFrame *frame) override
std::vector< lldb::addr_t > m_pcs
lldb::tid_t m_originating_unique_thread_id
void SetQueueName(const char *name) override
uint64_t GetExtendedBacktraceToken() override
Gets the extended backtrace token for this thread.
void SetThreadName(const char *name)
lldb::StackFrameListSP m_framelist
A plug-in interface definition class for debugging a process.
Definition Process.h:357
friend class StackFrame
Definition Thread.h:1303
A class that represents a running process on the host machine.
HistoryPCType
Specifies the type of PCs when creating a HistoryThread.
@ Returns
PCs are return addresses, except for topmost frame.
std::shared_ptr< lldb_private::RegisterContext > RegisterContextSP
uint64_t tid_t
Definition lldb-types.h:84
uint64_t queue_id_t
Definition lldb-types.h:90
std::shared_ptr< lldb_private::StackFrameList > StackFrameListSP