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
20using namespace lldb_private;
21using namespace lldb_private::plugin::dwarf;
22
23std::optional<DIERef> DWARFBaseDIE::GetDIERef() const {
24 if (!IsValid())
25 return std::nullopt;
26
27 return DIERef(m_cu->GetSymbolFileDWARF().GetFileIndex(),
28 m_cu->GetDebugSection(), m_die->GetOffset());
29}
30
31dw_tag_t DWARFBaseDIE::Tag() const {
32 if (m_die)
33 return m_die->Tag();
34 else
35 return llvm::dwarf::DW_TAG_null;
36}
37
38const char *DWARFBaseDIE::GetAttributeValueAsString(const dw_attr_t attr,
39 const char *fail_value) const {
40 if (IsValid())
41 return m_die->GetAttributeValueAsString(cu: GetCU(), attr, fail_value);
42 else
43 return fail_value;
44}
45
46uint64_t DWARFBaseDIE::GetAttributeValueAsUnsigned(const dw_attr_t attr,
47 uint64_t fail_value) const {
48 if (IsValid())
49 return m_die->GetAttributeValueAsUnsigned(cu: GetCU(), attr, fail_value);
50 else
51 return fail_value;
52}
53
54std::optional<uint64_t>
55DWARFBaseDIE::GetAttributeValueAsOptionalUnsigned(const dw_attr_t attr) const {
56 if (IsValid())
57 return m_die->GetAttributeValueAsOptionalUnsigned(cu: GetCU(), attr);
58 return std::nullopt;
59}
60
61uint64_t DWARFBaseDIE::GetAttributeValueAsAddress(const dw_attr_t attr,
62 uint64_t fail_value) const {
63 if (IsValid())
64 return m_die->GetAttributeValueAsAddress(cu: GetCU(), attr, fail_value);
65 else
66 return fail_value;
67}
68
69lldb::user_id_t DWARFBaseDIE::GetID() const {
70 const std::optional<DIERef> &ref = this->GetDIERef();
71 if (ref)
72 return ref->get_id();
73
74 return LLDB_INVALID_UID;
75}
76
77const char *DWARFBaseDIE::GetName() const {
78 if (IsValid())
79 return m_die->GetName(cu: m_cu);
80 else
81 return nullptr;
82}
83
84lldb::ModuleSP DWARFBaseDIE::GetModule() const {
85 SymbolFileDWARF *dwarf = GetDWARF();
86 if (dwarf)
87 return dwarf->GetObjectFile()->GetModule();
88 else
89 return lldb::ModuleSP();
90}
91
92dw_offset_t DWARFBaseDIE::GetOffset() const {
93 if (IsValid())
94 return m_die->GetOffset();
95 else
96 return DW_INVALID_OFFSET;
97}
98
99SymbolFileDWARF *DWARFBaseDIE::GetDWARF() const {
100 if (m_cu)
101 return &m_cu->GetSymbolFileDWARF();
102 else
103 return nullptr;
104}
105
106bool DWARFBaseDIE::HasChildren() const {
107 return m_die && m_die->HasChildren();
108}
109
110DWARFAttributes DWARFBaseDIE::GetAttributes(Recurse recurse) const {
111 if (IsValid())
112 return m_die->GetAttributes(cu: m_cu, recurse);
113 return DWARFAttributes();
114}
115
116namespace lldb_private::plugin {
117namespace dwarf {
118bool operator==(const DWARFBaseDIE &lhs, const DWARFBaseDIE &rhs) {
119 return lhs.GetDIE() == rhs.GetDIE() && lhs.GetCU() == rhs.GetCU();
120}
121
122bool operator!=(const DWARFBaseDIE &lhs, const DWARFBaseDIE &rhs) {
123 return !(lhs == rhs);
124}
125} // namespace dwarf
126} // namespace lldb_private::plugin
127
128const DWARFDataExtractor &DWARFBaseDIE::GetData() const {
129 // Clients must check if this DIE is valid before calling this function.
130 assert(IsValid());
131 return m_cu->GetData();
132}
133

source code of lldb/source/Plugins/SymbolFile/DWARF/DWARFBaseDIE.cpp