LLDB mainline
DWARFBaseDIE.cpp
Go to the documentation of this file.
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"
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
29}
30
32 if (m_die)
33 return m_die->Tag();
34 else
35 return llvm::dwarf::DW_TAG_null;
36}
37
38const char *DWARFBaseDIE::GetTagAsCString() const {
39 return DW_TAG_value_to_name(Tag());
40}
41
43 const char *fail_value) const {
44 if (IsValid())
45 return m_die->GetAttributeValueAsString(GetCU(), attr, fail_value);
46 else
47 return fail_value;
48}
49
51 uint64_t fail_value) const {
52 if (IsValid())
53 return m_die->GetAttributeValueAsUnsigned(GetCU(), attr, fail_value);
54 else
55 return fail_value;
56}
57
58std::optional<uint64_t>
60 if (IsValid())
62 return std::nullopt;
63}
64
66 uint64_t fail_value) const {
67 if (IsValid())
68 return m_die->GetAttributeValueAsAddress(GetCU(), attr, fail_value);
69 else
70 return fail_value;
71}
72
74 const std::optional<DIERef> &ref = this->GetDIERef();
75 if (ref)
76 return ref->get_id();
77
78 return LLDB_INVALID_UID;
79}
80
81const char *DWARFBaseDIE::GetName() const {
82 if (IsValid())
83 return m_die->GetName(m_cu);
84 else
85 return nullptr;
86}
87
90 if (dwarf)
91 return dwarf->GetObjectFile()->GetModule();
92 else
93 return lldb::ModuleSP();
94}
95
97 if (IsValid())
98 return m_die->GetOffset();
99 else
100 return DW_INVALID_OFFSET;
101}
102
104 if (m_cu)
105 return &m_cu->GetSymbolFileDWARF();
106 else
107 return nullptr;
108}
109
111 return m_die && m_die->HasChildren();
112}
113
116}
117
119 if (IsValid())
120 return m_die->GetAttributes(m_cu, recurse);
121 return DWARFAttributes();
122}
123
124namespace lldb_private::plugin {
125namespace dwarf {
126bool operator==(const DWARFBaseDIE &lhs, const DWARFBaseDIE &rhs) {
127 return lhs.GetDIE() == rhs.GetDIE() && lhs.GetCU() == rhs.GetCU();
128}
129
130bool operator!=(const DWARFBaseDIE &lhs, const DWARFBaseDIE &rhs) {
131 return !(lhs == rhs);
132}
133} // namespace dwarf
134} // namespace lldb_private::plugin
135
137 // Clients must check if this DIE is valid before calling this function.
138 assert(IsValid());
139 return m_cu->GetData();
140}
Identifies a DWARF debug info entry within a given Module.
Definition: DIERef.h:30
DWARFAttributes GetAttributes(Recurse recurse=Recurse::yes) const
std::optional< uint64_t > GetAttributeValueAsOptionalUnsigned(const dw_attr_t attr) const
const DWARFDataExtractor & GetData() const
const char * GetAttributeValueAsString(const dw_attr_t attr, const char *fail_value) const
std::optional< DIERef > GetDIERef() const
DWARFDebugInfoEntry * GetDIE() const
Definition: DWARFBaseDIE.h:59
uint64_t GetAttributeValueAsUnsigned(const dw_attr_t attr, uint64_t fail_value) const
uint64_t GetAttributeValueAsAddress(const dw_attr_t attr, uint64_t fail_value) const
std::optional< uint64_t > GetAttributeValueAsOptionalUnsigned(const DWARFUnit *cu, const dw_attr_t attr, bool check_specification_or_abstract_origin=false) const
const char * GetAttributeValueAsString(const DWARFUnit *cu, const dw_attr_t attr, const char *fail_value, bool check_specification_or_abstract_origin=false) const
DWARFAttributes GetAttributes(DWARFUnit *cu, Recurse recurse=Recurse::yes) const
uint64_t GetAttributeValueAsUnsigned(const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
uint64_t GetAttributeValueAsAddress(const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
const char * GetName(const DWARFUnit *cu) const
SymbolFileDWARF & GetSymbolFileDWARF() const
Definition: DWARFUnit.h:229
DIERef::Section GetDebugSection() const
Definition: DWARFUnit.h:251
const DWARFDataExtractor & GetData() const
Get the data that contains the DIE information for this unit.
Definition: DWARFUnit.cpp:1065
std::optional< uint64_t > GetFileIndex() const
uint64_t dw_offset_t
Definition: dwarf.h:31
#define DW_INVALID_OFFSET
Definition: dwarf.h:36
llvm::dwarf::Tag dw_tag_t
Definition: dwarf.h:26
llvm::dwarf::Attribute dw_attr_t
Definition: dwarf.h:24
#define LLDB_INVALID_UID
Definition: lldb-defines.h:88
const char * DW_TAG_value_to_name(uint32_t val)
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
uint64_t user_id_t
Definition: lldb-types.h:80
std::shared_ptr< lldb_private::Module > ModuleSP
Definition: lldb-forward.h:365