1 //===-- DWARFBaseDIE.cpp --------------------------------------------------===//
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 #include "DWARFBaseDIE.h"
10
11 #include "DWARFUnit.h"
12 #include "DWARFDebugInfoEntry.h"
13 #include "SymbolFileDWARF.h"
14
15 #include "lldb/Core/Module.h"
16 #include "lldb/Symbol/ObjectFile.h"
17 #include "lldb/Utility/Log.h"
18 #include <optional>
19
20 using namespace lldb_private;
21
GetDIERef() const22 std::optional<DIERef> DWARFBaseDIE::GetDIERef() const {
23 if (!IsValid())
24 return std::nullopt;
25
26 return DIERef(m_cu->GetSymbolFileDWARF().GetDwoNum(), m_cu->GetDebugSection(),
27 m_die->GetOffset());
28 }
29
Tag() const30 dw_tag_t DWARFBaseDIE::Tag() const {
31 if (m_die)
32 return m_die->Tag();
33 else
34 return llvm::dwarf::DW_TAG_null;
35 }
36
GetTagAsCString() const37 const char *DWARFBaseDIE::GetTagAsCString() const {
38 return lldb_private::DW_TAG_value_to_name(Tag());
39 }
40
GetAttributeValueAsString(const dw_attr_t attr,const char * fail_value) const41 const char *DWARFBaseDIE::GetAttributeValueAsString(const dw_attr_t attr,
42 const char *fail_value) const {
43 if (IsValid())
44 return m_die->GetAttributeValueAsString(GetCU(), attr, fail_value);
45 else
46 return fail_value;
47 }
48
GetAttributeValueAsUnsigned(const dw_attr_t attr,uint64_t fail_value) const49 uint64_t DWARFBaseDIE::GetAttributeValueAsUnsigned(const dw_attr_t attr,
50 uint64_t fail_value) const {
51 if (IsValid())
52 return m_die->GetAttributeValueAsUnsigned(GetCU(), attr, fail_value);
53 else
54 return fail_value;
55 }
56
57 std::optional<uint64_t>
GetAttributeValueAsOptionalUnsigned(const dw_attr_t attr) const58 DWARFBaseDIE::GetAttributeValueAsOptionalUnsigned(const dw_attr_t attr) const {
59 if (IsValid())
60 return m_die->GetAttributeValueAsOptionalUnsigned(GetCU(), attr);
61 return std::nullopt;
62 }
63
GetAttributeValueAsAddress(const dw_attr_t attr,uint64_t fail_value) const64 uint64_t DWARFBaseDIE::GetAttributeValueAsAddress(const dw_attr_t attr,
65 uint64_t fail_value) const {
66 if (IsValid())
67 return m_die->GetAttributeValueAsAddress(GetCU(), attr, fail_value);
68 else
69 return fail_value;
70 }
71
GetID() const72 lldb::user_id_t DWARFBaseDIE::GetID() const {
73 if (IsValid())
74 return GetDWARF()->GetUID(*this);
75 return LLDB_INVALID_UID;
76 }
77
GetName() const78 const char *DWARFBaseDIE::GetName() const {
79 if (IsValid())
80 return m_die->GetName(m_cu);
81 else
82 return nullptr;
83 }
84
GetModule() const85 lldb::ModuleSP DWARFBaseDIE::GetModule() const {
86 SymbolFileDWARF *dwarf = GetDWARF();
87 if (dwarf)
88 return dwarf->GetObjectFile()->GetModule();
89 else
90 return lldb::ModuleSP();
91 }
92
GetOffset() const93 dw_offset_t DWARFBaseDIE::GetOffset() const {
94 if (IsValid())
95 return m_die->GetOffset();
96 else
97 return DW_INVALID_OFFSET;
98 }
99
GetDWARF() const100 SymbolFileDWARF *DWARFBaseDIE::GetDWARF() const {
101 if (m_cu)
102 return &m_cu->GetSymbolFileDWARF();
103 else
104 return nullptr;
105 }
106
HasChildren() const107 bool DWARFBaseDIE::HasChildren() const {
108 return m_die && m_die->HasChildren();
109 }
110
Supports_DW_AT_APPLE_objc_complete_type() const111 bool DWARFBaseDIE::Supports_DW_AT_APPLE_objc_complete_type() const {
112 return IsValid() && GetDWARF()->Supports_DW_AT_APPLE_objc_complete_type(m_cu);
113 }
114
GetAttributes(DWARFAttributes & attributes,Recurse recurse) const115 size_t DWARFBaseDIE::GetAttributes(DWARFAttributes &attributes,
116 Recurse recurse) const {
117 if (IsValid())
118 return m_die->GetAttributes(m_cu, attributes, recurse);
119 attributes.Clear();
120 return 0;
121 }
122
operator ==(const DWARFBaseDIE & lhs,const DWARFBaseDIE & rhs)123 bool operator==(const DWARFBaseDIE &lhs, const DWARFBaseDIE &rhs) {
124 return lhs.GetDIE() == rhs.GetDIE() && lhs.GetCU() == rhs.GetCU();
125 }
126
operator !=(const DWARFBaseDIE & lhs,const DWARFBaseDIE & rhs)127 bool operator!=(const DWARFBaseDIE &lhs, const DWARFBaseDIE &rhs) {
128 return !(lhs == rhs);
129 }
130
GetData() const131 const DWARFDataExtractor &DWARFBaseDIE::GetData() const {
132 // Clients must check if this DIE is valid before calling this function.
133 assert(IsValid());
134 return m_cu->GetData();
135 }
136