LLDB  mainline
DWARFDebugInfoEntry.h
Go to the documentation of this file.
1 //===-- DWARFDebugInfoEntry.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_SYMBOLFILE_DWARF_DWARFDEBUGINFOENTRY_H
10 #define LLDB_SOURCE_PLUGINS_SYMBOLFILE_DWARF_DWARFDEBUGINFOENTRY_H
11 
12 #include "SymbolFileDWARF.h"
13 #include "llvm/ADT/SmallVector.h"
14 
16 #include "DWARFBaseDIE.h"
17 #include "DWARFDebugAbbrev.h"
18 #include "DWARFDebugRanges.h"
19 #include <map>
20 #include <set>
21 #include <vector>
22 
23 class DWARFDeclContext;
24 
25 #define DIE_SIBLING_IDX_BITSIZE 31
26 
27 /// DWARFDebugInfoEntry objects assume that they are living in one big
28 /// vector and do pointer arithmetic on their this pointers. Don't
29 /// pass them by value. Due to the way they are constructed in a
30 /// std::vector, we cannot delete the copy constructor.
32 public:
33  typedef std::vector<DWARFDebugInfoEntry> collection;
34  typedef collection::iterator iterator;
35  typedef collection::const_iterator const_iterator;
36 
39  m_has_children(false), m_abbr_idx(0), m_tag(llvm::dwarf::DW_TAG_null) {}
40 
41  explicit operator bool() const { return m_offset != DW_INVALID_OFFSET; }
42  bool operator==(const DWARFDebugInfoEntry &rhs) const;
43  bool operator!=(const DWARFDebugInfoEntry &rhs) const;
44 
46  DWARFDebugAranges *debug_aranges) const;
47 
49  const DWARFUnit *cu, lldb::offset_t *offset_ptr);
50 
53  Recurse recurse = Recurse::yes) const {
54  return GetAttributes(cu, attrs, recurse, 0 /* curr_depth */);
55  }
56 
58  GetAttributeValue(const DWARFUnit *cu, const dw_attr_t attr,
59  DWARFFormValue &formValue,
60  dw_offset_t *end_attr_offset_ptr = nullptr,
61  bool check_specification_or_abstract_origin = false) const;
62 
63  const char *GetAttributeValueAsString(
64  const DWARFUnit *cu, const dw_attr_t attr, const char *fail_value,
65  bool check_specification_or_abstract_origin = false) const;
66 
68  const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value,
69  bool check_specification_or_abstract_origin = false) const;
70 
72  const DWARFUnit *cu, const dw_attr_t attr,
73  bool check_specification_or_abstract_origin = false) const;
74 
76  const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value,
77  bool check_specification_or_abstract_origin = false) const;
78 
79  dw_addr_t
80  GetAttributeHighPC(const DWARFUnit *cu, dw_addr_t lo_pc, uint64_t fail_value,
81  bool check_specification_or_abstract_origin = false) const;
82 
84  const DWARFUnit *cu, dw_addr_t &lo_pc, dw_addr_t &hi_pc,
85  uint64_t fail_value,
86  bool check_specification_or_abstract_origin = false) const;
87 
89  DWARFUnit *cu, DWARFRangeList &ranges, bool check_hi_lo_pc,
90  bool check_specification_or_abstract_origin = false) const;
91 
92  const char *GetName(const DWARFUnit *cu) const;
93 
94  const char *GetMangledName(const DWARFUnit *cu,
95  bool substitute_name_allowed = true) const;
96 
97  const char *GetPubname(const DWARFUnit *cu) const;
98 
99  const char *GetQualifiedName(DWARFUnit *cu, std::string &storage) const;
100 
101  const char *GetQualifiedName(DWARFUnit *cu, const DWARFAttributes &attributes,
102  std::string &storage) const;
103 
105  DWARFUnit *cu, const char *&name, const char *&mangled,
106  DWARFRangeList &rangeList, int &decl_file, int &decl_line,
107  int &decl_column, int &call_file, int &call_line, int &call_column,
108  lldb_private::DWARFExpression *frame_base = nullptr) const;
109 
111  GetAbbreviationDeclarationPtr(const DWARFUnit *cu) const;
112 
114 
115  dw_tag_t Tag() const { return m_tag; }
116 
117  bool IsNULL() const { return m_abbr_idx == 0; }
118 
119  dw_offset_t GetOffset() const { return m_offset; }
120 
121  bool HasChildren() const { return m_has_children; }
122 
123  void SetHasChildren(bool b) { m_has_children = b; }
124 
125  // We know we are kept in a vector of contiguous entries, so we know
126  // our parent will be some index behind "this".
128  return m_parent_idx > 0 ? this - m_parent_idx : nullptr;
129  }
131  return m_parent_idx > 0 ? this - m_parent_idx : nullptr;
132  }
133  // We know we are kept in a vector of contiguous entries, so we know
134  // our sibling will be some index after "this".
136  return m_sibling_idx > 0 ? this + m_sibling_idx : nullptr;
137  }
139  return m_sibling_idx > 0 ? this + m_sibling_idx : nullptr;
140  }
141  // We know we are kept in a vector of contiguous entries, so we know
142  // we don't need to store our child pointer, if we have a child it will
143  // be the next entry in the list...
145  return HasChildren() ? this + 1 : nullptr;
146  }
148  return HasChildren() ? this + 1 : nullptr;
149  }
150 
152 
155  const DWARFAttributes &attributes) const;
156 
158  void SetParentIndex(uint32_t idx) { m_parent_idx = idx; }
159 
160  // This function returns true if the variable scope is either
161  // global or (file-static). It will return false for static variables
162  // that are local to a function, as they have local scope.
163  bool IsGlobalOrStaticScopeVariable() const;
164 
165 protected:
166  static DWARFDeclContext
168 
169  dw_offset_t m_offset; // Offset within the .debug_info/.debug_types
170  uint32_t m_parent_idx; // How many to subtract from "this" to get the parent.
171  // If zero this die has no parent
172  uint32_t m_sibling_idx : 31, // How many to add to "this" to get the sibling.
173  // If it is zero, then the DIE doesn't have children, or the
174  // DWARF claimed it had children but the DIE only contained
175  // a single NULL terminating child.
178  /// A copy of the DW_TAG value so we don't have to go through the compile
179  /// unit abbrev table
180  dw_tag_t m_tag = llvm::dwarf::DW_TAG_null;
181 
182 private:
183  size_t GetAttributes(DWARFUnit *cu, DWARFAttributes &attrs, Recurse recurse,
184  uint32_t curr_depth) const;
185 };
186 
187 #endif // LLDB_SOURCE_PLUGINS_SYMBOLFILE_DWARF_DWARFDEBUGINFOENTRY_H
DWARFDebugInfoEntry::GetAttributeValueAsReference
DWARFDIE GetAttributeValueAsReference(const DWARFUnit *cu, const dw_attr_t attr, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:552
DWARFDebugInfoEntry::GetAttributeValueAsAddress
uint64_t GetAttributeValueAsAddress(const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:562
DWARFDebugInfoEntry::GetQualifiedName
const char * GetQualifiedName(DWARFUnit *cu, std::string &storage) const
Definition: DWARFDebugInfoEntry.cpp:788
llvm
Definition: Debugger.h:49
DWARFDebugInfoEntry::GetOffset
dw_offset_t GetOffset() const
Definition: DWARFDebugInfoEntry.h:119
DWARFBaseDIE::Recurse::yes
@ yes
DWARFDebugInfoEntry::GetMangledName
const char * GetMangledName(const DWARFUnit *cu, bool substitute_name_allowed=true) const
Definition: DWARFDebugInfoEntry.cpp:650
DWARFDebugAranges
Definition: DWARFDebugAranges.h:16
DWARFDebugInfoEntry::GetSibling
const DWARFDebugInfoEntry * GetSibling() const
Definition: DWARFDebugInfoEntry.h:138
dw_tag_t
llvm::dwarf::Tag dw_tag_t
Definition: dwarf.h:25
DWARFDebugInfoEntry::HasChildren
bool HasChildren() const
Definition: DWARFDebugInfoEntry.h:121
DWARFDebugInfoEntry::GetFirstChild
const DWARFDebugInfoEntry * GetFirstChild() const
Definition: DWARFDebugInfoEntry.h:147
SymbolFileDWARF.h
lldb::offset_t
uint64_t offset_t
Definition: lldb-types.h:87
DWARFDebugInfoEntry::GetSibling
DWARFDebugInfoEntry * GetSibling()
Definition: DWARFDebugInfoEntry.h:135
lldb_private::DWARFDataExtractor
Definition: DWARFDataExtractor.h:18
DWARFDebugInfoEntry
DWARFDebugInfoEntry objects assume that they are living in one big vector and do pointer arithmetic o...
Definition: DWARFDebugInfoEntry.h:31
DW_INVALID_OFFSET
#define DW_INVALID_OFFSET
Definition: dwarf.h:34
DWARFDebugInfoEntry::GetDIENamesAndRanges
bool GetDIENamesAndRanges(DWARFUnit *cu, const char *&name, const char *&mangled, DWARFRangeList &rangeList, int &decl_file, int &decl_line, int &decl_column, int &call_file, int &call_line, int &call_column, lldb_private::DWARFExpression *frame_base=nullptr) const
Definition: DWARFDebugInfoEntry.cpp:230
DWARFAttributes
Definition: DWARFAttribute.h:44
DWARFDebugInfoEntry::GetFirstAttributeOffset
lldb::offset_t GetFirstAttributeOffset() const
Definition: DWARFDebugInfoEntry.cpp:848
DWARFDIE
Definition: DWARFDIE.h:15
DWARFDebugInfoEntry::m_abbr_idx
uint16_t m_abbr_idx
Definition: DWARFDebugInfoEntry.h:177
DWARFDebugInfoEntry::DWARFDebugInfoEntry
DWARFDebugInfoEntry()
Definition: DWARFDebugInfoEntry.h:37
DWARFDebugInfoEntry::SetSiblingIndex
void SetSiblingIndex(uint32_t idx)
Definition: DWARFDebugInfoEntry.h:157
DWARFDebugInfoEntry::m_offset
dw_offset_t m_offset
Definition: DWARFDebugInfoEntry.h:169
DWARFUnit
Definition: DWARFUnit.h:80
DWARFDebugInfoEntry::GetParentDeclContextDIE
DWARFDIE GetParentDeclContextDIE(DWARFUnit *cu) const
Definition: DWARFDebugInfoEntry.cpp:739
dwarf
Definition: ABISysV_arc.cpp:61
DWARFDebugInfoEntry::GetDWARFDeclContext
DWARFDeclContext GetDWARFDeclContext(DWARFUnit *cu) const
Definition: DWARFDebugInfoEntry.cpp:734
DWARFDebugInfoEntry::SetHasChildren
void SetHasChildren(bool b)
Definition: DWARFDebugInfoEntry.h:123
lldb_private::DWARFExpression
Definition: DWARFExpression.h:35
DWARFDebugInfoEntry::m_tag
dw_tag_t m_tag
A copy of the DW_TAG value so we don't have to go through the compile unit abbrev table.
Definition: DWARFDebugInfoEntry.h:180
DWARFDebugInfoEntry::GetPubname
const char * GetPubname(const DWARFUnit *cu) const
Definition: DWARFDebugInfoEntry.cpp:673
DWARFFormValue
Definition: DWARFFormValue.h:20
DWARFDebugInfoEntry::GetDWARFDeclContextStatic
static DWARFDeclContext GetDWARFDeclContextStatic(const DWARFDebugInfoEntry *die, DWARFUnit *cu)
Definition: DWARFDebugInfoEntry.cpp:715
DWARFDebugInfoEntry::const_iterator
collection::const_iterator const_iterator
Definition: DWARFDebugInfoEntry.h:35
string
string(SUBSTRING ${p} 10 -1 pStripped) if($
Definition: Plugins/CMakeLists.txt:38
DWARFDebugInfoEntry::Extract
bool Extract(const lldb_private::DWARFDataExtractor &data, const DWARFUnit *cu, lldb::offset_t *offset_ptr)
Definition: DWARFDebugInfoEntry.cpp:39
DWARFDebugInfoEntry::BuildFunctionAddressRangeTable
void BuildFunctionAddressRangeTable(DWARFUnit *cu, DWARFDebugAranges *debug_aranges) const
This function is builds a table very similar to the standard .debug_aranges table,...
Definition: DWARFDebugInfoEntry.cpp:693
DWARFDebugInfoEntry::m_parent_idx
uint32_t m_parent_idx
Definition: DWARFDebugInfoEntry.h:170
lldb_private::RangeVector
Definition: RangeMap.h:125
DWARFDebugInfoEntry::GetAttributeValueAsString
const char * GetAttributeValueAsString(const DWARFUnit *cu, const dw_attr_t attr, const char *fail_value, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:525
DWARFDebugInfoEntry::operator!=
bool operator!=(const DWARFDebugInfoEntry &rhs) const
Definition: DWARFDebugInfoEntry.cpp:892
DWARFAbbreviationDeclaration.h
DWARFDebugInfoEntry::GetAttributeAddressRange
bool GetAttributeAddressRange(const DWARFUnit *cu, dw_addr_t &lo_pc, dw_addr_t &hi_pc, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:601
uint32_t
DWARFBaseDIE::Recurse
Recurse
Definition: DWARFBaseDIE.h:113
DWARFDebugInfoEntry::IsGlobalOrStaticScopeVariable
bool IsGlobalOrStaticScopeVariable() const
Definition: DWARFDebugInfoEntry.cpp:862
DWARFDebugRanges.h
DWARFDebugInfoEntry::GetAbbreviationDeclarationPtr
const DWARFAbbreviationDeclaration * GetAbbreviationDeclarationPtr(const DWARFUnit *cu) const
Definition: DWARFDebugInfoEntry.cpp:853
uint16_t
DWARFDebugAbbrev.h
DWARFDebugInfoEntry::SetParentIndex
void SetParentIndex(uint32_t idx)
Definition: DWARFDebugInfoEntry.h:158
DWARFBaseDIE.h
DWARFAbbreviationDeclaration
Definition: DWARFAbbreviationDeclaration.h:17
DWARFDebugInfoEntry::GetParent
const DWARFDebugInfoEntry * GetParent() const
Definition: DWARFDebugInfoEntry.h:130
DWARFDeclContext
Definition: DWARFDeclContext.h:23
DWARFDebugInfoEntry::collection
std::vector< DWARFDebugInfoEntry > collection
Definition: DWARFDebugInfoEntry.h:33
DWARFDebugInfoEntry::Tag
dw_tag_t Tag() const
Definition: DWARFDebugInfoEntry.h:115
DWARFDebugInfoEntry::m_sibling_idx
uint32_t m_sibling_idx
Definition: DWARFDebugInfoEntry.h:172
DWARFDebugInfoEntry::m_has_children
uint32_t m_has_children
Definition: DWARFDebugInfoEntry.h:176
DWARFDebugInfoEntry::GetAttributeAddressRanges
size_t GetAttributeAddressRanges(DWARFUnit *cu, DWARFRangeList &ranges, bool check_hi_lo_pc, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:617
DWARFDebugInfoEntry::iterator
collection::iterator iterator
Definition: DWARFDebugInfoEntry.h:34
DWARFDebugInfoEntry::GetAttributes
size_t GetAttributes(DWARFUnit *cu, DWARFAttributes &attrs, Recurse recurse=Recurse::yes) const
Definition: DWARFDebugInfoEntry.h:52
DWARFDebugInfoEntry::IsNULL
bool IsNULL() const
Definition: DWARFDebugInfoEntry.h:117
dw_addr_t
uint64_t dw_addr_t
Definition: dwarf.h:26
DWARFDebugInfoEntry::GetAttributeHighPC
dw_addr_t GetAttributeHighPC(const DWARFUnit *cu, dw_addr_t lo_pc, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:578
DWARFDebugInfoEntry::GetName
const char * GetName(const DWARFUnit *cu) const
Definition: DWARFDebugInfoEntry.cpp:641
DWARFDebugInfoEntry::GetParent
DWARFDebugInfoEntry * GetParent()
Definition: DWARFDebugInfoEntry.h:127
DWARFDebugInfoEntry::GetAttributeValueAsUnsigned
uint64_t GetAttributeValueAsUnsigned(const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:538
DWARFDebugInfoEntry::operator==
bool operator==(const DWARFDebugInfoEntry &rhs) const
Definition: DWARFDebugInfoEntry.cpp:885
DWARFDebugInfoEntry::GetAttributeValue
dw_offset_t GetAttributeValue(const DWARFUnit *cu, const dw_attr_t attr, DWARFFormValue &formValue, dw_offset_t *end_attr_offset_ptr=nullptr, bool check_specification_or_abstract_origin=false) const
Definition: DWARFDebugInfoEntry.cpp:468
DWARFDebugInfoEntry::GetFirstChild
DWARFDebugInfoEntry * GetFirstChild()
Definition: DWARFDebugInfoEntry.h:144