LLDB mainline
StackID.h
Go to the documentation of this file.
1//===-- StackID.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_TARGET_STACKID_H
10#define LLDB_TARGET_STACKID_H
11
13#include "lldb/lldb-private.h"
14
15namespace lldb_private {
16
17class StackID {
18public:
19 // Constructors and Destructors
20 StackID() = default;
21
23 SymbolContextScope *symbol_scope)
24 : m_pc(pc), m_cfa(cfa), m_symbol_scope(symbol_scope) {}
25
26 StackID(const StackID &rhs)
27 : m_pc(rhs.m_pc), m_cfa(rhs.m_cfa), m_symbol_scope(rhs.m_symbol_scope) {}
28
29 ~StackID() = default;
30
31 lldb::addr_t GetPC() const { return m_pc; }
32
34
36
38 m_symbol_scope = symbol_scope;
39 }
40
41 void Clear() {
44 m_symbol_scope = nullptr;
45 }
46
47 bool IsValid() const {
49 }
50
51 void Dump(Stream *s);
52
53 // Operators
54 const StackID &operator=(const StackID &rhs) {
55 if (this != &rhs) {
56 m_pc = rhs.m_pc;
57 m_cfa = rhs.m_cfa;
59 }
60 return *this;
61 }
62
63protected:
64 friend class StackFrame;
65
67
68 void SetCFA(lldb::addr_t cfa) { m_cfa = cfa; }
69
71 LLDB_INVALID_ADDRESS; // The pc value for the function/symbol for this
72 // frame. This will
73 // only get used if the symbol scope is nullptr (the code where we are
74 // stopped is not represented by any function or symbol in any shared
75 // library).
77 LLDB_INVALID_ADDRESS; // The call frame address (stack pointer) value
78 // at the beginning of the function that uniquely
79 // identifies this frame (along with m_symbol_scope
80 // below)
82 nullptr; // If nullptr, there is no block or symbol for this frame.
83 // If not nullptr, this will either be the scope for the
84 // lexical block for the frame, or the scope for the
85 // symbol. Symbol context scopes are always be unique
86 // pointers since the are part of the Block and Symbol
87 // objects and can easily be used to tell if a stack ID
88 // is the same as another.
89};
90
91bool operator==(const StackID &lhs, const StackID &rhs);
92bool operator!=(const StackID &lhs, const StackID &rhs);
93
94// frame_id_1 < frame_id_2 means "frame_id_1 is YOUNGER than frame_id_2"
95bool operator<(const StackID &lhs, const StackID &rhs);
96
97} // namespace lldb_private
98
99#endif // LLDB_TARGET_STACKID_H
This base class provides an interface to stack frames.
Definition: StackFrame.h:42
StackID(const StackID &rhs)
Definition: StackID.h:26
void Dump(Stream *s)
Definition: StackID.cpp:17
lldb::addr_t m_cfa
Definition: StackID.h:76
bool IsValid() const
Definition: StackID.h:47
void SetPC(lldb::addr_t pc)
Definition: StackID.h:66
SymbolContextScope * GetSymbolContextScope() const
Definition: StackID.h:35
const StackID & operator=(const StackID &rhs)
Definition: StackID.h:54
lldb::addr_t m_pc
Definition: StackID.h:70
lldb::addr_t GetPC() const
Definition: StackID.h:31
StackID(lldb::addr_t pc, lldb::addr_t cfa, SymbolContextScope *symbol_scope)
Definition: StackID.h:22
SymbolContextScope * m_symbol_scope
Definition: StackID.h:81
void SetSymbolContextScope(SymbolContextScope *symbol_scope)
Definition: StackID.h:37
void SetCFA(lldb::addr_t cfa)
Definition: StackID.h:68
lldb::addr_t GetCallFrameAddress() const
Definition: StackID.h:33
A stream class that can stream formatted output to a file.
Definition: Stream.h:28
"lldb/Symbol/SymbolContextScope.h" Inherit from this if your object is part of a symbol context and c...
#define LLDB_INVALID_ADDRESS
Definition: lldb-defines.h:82
A class that represents a running process on the host machine.
Definition: SBAttachInfo.h:14
bool operator!=(const Address &lhs, const Address &rhs)
Definition: Address.cpp:1028
bool operator==(const Address &lhs, const Address &rhs)
Definition: Address.cpp:1022
bool operator<(const Address &lhs, const Address &rhs)
Definition: Address.cpp:991
uint64_t addr_t
Definition: lldb-types.h:79