LLDB mainline
Public Types | Public Member Functions | Static Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
DWARFDebugInfoEntry Class Reference

DWARFDebugInfoEntry objects assume that they are living in one big vector and do pointer arithmetic on their this pointers. More...

#include <DWARFDebugInfoEntry.h>

Public Types

typedef std::vector< DWARFDebugInfoEntrycollection
 
typedef collection::iterator iterator
 
typedef collection::const_iterator const_iterator
 
using Recurse = DWARFBaseDIE::Recurse
 

Public Member Functions

 DWARFDebugInfoEntry ()
 
 operator bool () const
 
bool operator== (const DWARFDebugInfoEntry &rhs) const
 
bool operator!= (const DWARFDebugInfoEntry &rhs) const
 
void BuildFunctionAddressRangeTable (DWARFUnit *cu, DWARFDebugAranges *debug_aranges) const
 This function is builds a table very similar to the standard .debug_aranges table, except that the actual DIE offset for the function is placed in the table instead of the compile unit offset.
 
bool Extract (const lldb_private::DWARFDataExtractor &data, const DWARFUnit *cu, lldb::offset_t *offset_ptr)
 
DWARFAttributes GetAttributes (DWARFUnit *cu, Recurse recurse=Recurse::yes) const
 
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
 
const char * GetAttributeValueAsString (const DWARFUnit *cu, const dw_attr_t attr, const char *fail_value, bool check_specification_or_abstract_origin=false) const
 
uint64_t GetAttributeValueAsUnsigned (const DWARFUnit *cu, const dw_attr_t attr, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
 
std::optional< uint64_t > GetAttributeValueAsOptionalUnsigned (const DWARFUnit *cu, const dw_attr_t attr, bool check_specification_or_abstract_origin=false) const
 
DWARFDIE GetAttributeValueAsReference (const DWARFUnit *cu, const dw_attr_t attr, 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
 
dw_addr_t GetAttributeHighPC (const DWARFUnit *cu, dw_addr_t lo_pc, uint64_t fail_value, bool check_specification_or_abstract_origin=false) const
 
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
 
DWARFRangeList GetAttributeAddressRanges (DWARFUnit *cu, bool check_hi_lo_pc, bool check_specification_or_abstract_origin=false) const
 
const char * GetName (const DWARFUnit *cu) const
 
const char * GetMangledName (const DWARFUnit *cu, bool substitute_name_allowed=true) const
 
const char * GetPubname (const DWARFUnit *cu) const
 
bool GetDIENamesAndRanges (DWARFUnit *cu, const char *&name, const char *&mangled, DWARFRangeList &rangeList, std::optional< int > &decl_file, std::optional< int > &decl_line, std::optional< int > &decl_column, std::optional< int > &call_file, std::optional< int > &call_line, std::optional< int > &call_column, lldb_private::DWARFExpressionList *frame_base=nullptr) const
 
const llvm::DWARFAbbreviationDeclaration * GetAbbreviationDeclarationPtr (const DWARFUnit *cu) const
 
lldb::offset_t GetFirstAttributeOffset () const
 
dw_tag_t Tag () const
 
bool IsNULL () const
 
dw_offset_t GetOffset () const
 
bool HasChildren () const
 
void SetHasChildren (bool b)
 
DWARFDebugInfoEntryGetParent ()
 
const DWARFDebugInfoEntryGetParent () const
 
DWARFDebugInfoEntryGetSibling ()
 
const DWARFDebugInfoEntryGetSibling () const
 
DWARFDebugInfoEntryGetFirstChild ()
 
const DWARFDebugInfoEntryGetFirstChild () const
 
DWARFDeclContext GetDWARFDeclContext (DWARFUnit *cu) const
 
DWARFDIE GetParentDeclContextDIE (DWARFUnit *cu) const
 
DWARFDIE GetParentDeclContextDIE (DWARFUnit *cu, const DWARFAttributes &attributes) const
 
void SetSiblingIndex (uint32_t idx)
 
void SetParentIndex (uint32_t idx)
 
bool IsGlobalOrStaticScopeVariable () const
 

Static Protected Member Functions

static DWARFDeclContext GetDWARFDeclContextStatic (const DWARFDebugInfoEntry *die, DWARFUnit *cu)
 

Protected Attributes

dw_offset_t m_offset: DW_DIE_OFFSET_MAX_BITSIZE
 
dw_offset_t m_parent_idx: 64 - DW_DIE_OFFSET_MAX_BITSIZE
 
uint32_t m_sibling_idx: 31
 
uint32_t m_has_children: 1
 
uint16_t m_abbr_idx = 0
 
dw_tag_t m_tag = llvm::dwarf::DW_TAG_null
 A copy of the DW_TAG value so we don't have to go through the compile unit abbrev table.
 

Private Member Functions

void GetAttributes (DWARFUnit *cu, DWARFAttributes &attrs, Recurse recurse, uint32_t curr_depth) const
 

Detailed Description

DWARFDebugInfoEntry objects assume that they are living in one big vector and do pointer arithmetic on their this pointers.

Don't pass them by value. Due to the way they are constructed in a std::vector, we cannot delete the copy constructor.

Definition at line 34 of file DWARFDebugInfoEntry.h.

Member Typedef Documentation

◆ collection

Definition at line 36 of file DWARFDebugInfoEntry.h.

◆ const_iterator

typedef collection::const_iterator DWARFDebugInfoEntry::const_iterator

Definition at line 38 of file DWARFDebugInfoEntry.h.

◆ iterator

typedef collection::iterator DWARFDebugInfoEntry::iterator

Definition at line 37 of file DWARFDebugInfoEntry.h.

◆ Recurse

Definition at line 54 of file DWARFDebugInfoEntry.h.

Constructor & Destructor Documentation

◆ DWARFDebugInfoEntry()

DWARFDebugInfoEntry::DWARFDebugInfoEntry ( )
inline

Definition at line 40 of file DWARFDebugInfoEntry.h.

Member Function Documentation

◆ BuildFunctionAddressRangeTable()

void DWARFDebugInfoEntry::BuildFunctionAddressRangeTable ( DWARFUnit cu,
DWARFDebugAranges debug_aranges 
) const

This function is builds a table very similar to the standard .debug_aranges table, except that the actual DIE offset for the function is placed in the table instead of the compile unit offset.

Definition at line 716 of file DWARFDebugInfoEntry.cpp.

References DWARFDebugAranges::AppendRange(), BuildFunctionAddressRangeTable(), GetAttributeAddressRanges(), GetFirstChild(), GetOffset(), GetSibling(), and m_tag.

Referenced by BuildFunctionAddressRangeTable(), and DWARFUnit::GetFunctionAranges().

◆ Extract()

bool DWARFDebugInfoEntry::Extract ( const lldb_private::DWARFDataExtractor data,
const DWARFUnit cu,
lldb::offset_t offset_ptr 
)

◆ GetAbbreviationDeclarationPtr()

const DWARFAbbreviationDeclaration * DWARFDebugInfoEntry::GetAbbreviationDeclarationPtr ( const DWARFUnit cu) const

◆ GetAttributeAddressRange()

bool DWARFDebugInfoEntry::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

◆ GetAttributeAddressRanges()

DWARFRangeList DWARFDebugInfoEntry::GetAttributeAddressRanges ( DWARFUnit cu,
bool  check_hi_lo_pc,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetAttributeHighPC()

dw_addr_t DWARFDebugInfoEntry::GetAttributeHighPC ( const DWARFUnit cu,
dw_addr_t  lo_pc,
uint64_t  fail_value,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetAttributes() [1/2]

void DWARFDebugInfoEntry::GetAttributes ( DWARFUnit cu,
DWARFAttributes attrs,
Recurse  recurse,
uint32_t  curr_depth 
) const
private

◆ GetAttributes() [2/2]

DWARFAttributes DWARFDebugInfoEntry::GetAttributes ( DWARFUnit cu,
Recurse  recurse = Recurse::yes 
) const
inline

◆ GetAttributeValue()

dw_offset_t DWARFDebugInfoEntry::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

◆ GetAttributeValueAsAddress()

uint64_t DWARFDebugInfoEntry::GetAttributeValueAsAddress ( const DWARFUnit cu,
const dw_attr_t  attr,
uint64_t  fail_value,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetAttributeValueAsOptionalUnsigned()

std::optional< uint64_t > DWARFDebugInfoEntry::GetAttributeValueAsOptionalUnsigned ( const DWARFUnit cu,
const dw_attr_t  attr,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetAttributeValueAsReference()

DWARFDIE DWARFDebugInfoEntry::GetAttributeValueAsReference ( const DWARFUnit cu,
const dw_attr_t  attr,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetAttributeValueAsString()

const char * DWARFDebugInfoEntry::GetAttributeValueAsString ( const DWARFUnit cu,
const dw_attr_t  attr,
const char *  fail_value,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetAttributeValueAsUnsigned()

uint64_t DWARFDebugInfoEntry::GetAttributeValueAsUnsigned ( const DWARFUnit cu,
const dw_attr_t  attr,
uint64_t  fail_value,
bool  check_specification_or_abstract_origin = false 
) const

◆ GetDIENamesAndRanges()

bool DWARFDebugInfoEntry::GetDIENamesAndRanges ( DWARFUnit cu,
const char *&  name,
const char *&  mangled,
DWARFRangeList rangeList,
std::optional< int > &  decl_file,
std::optional< int > &  decl_line,
std::optional< int > &  decl_column,
std::optional< int > &  call_file,
std::optional< int > &  call_line,
std::optional< int > &  call_column,
lldb_private::DWARFExpressionList frame_base = nullptr 
) const

◆ GetDWARFDeclContext()

DWARFDeclContext DWARFDebugInfoEntry::GetDWARFDeclContext ( DWARFUnit cu) const

Definition at line 756 of file DWARFDebugInfoEntry.cpp.

References GetDWARFDeclContextStatic().

◆ GetDWARFDeclContextStatic()

DWARFDeclContext DWARFDebugInfoEntry::GetDWARFDeclContextStatic ( const DWARFDebugInfoEntry die,
DWARFUnit cu 
)
staticprotected

◆ GetFirstAttributeOffset()

lldb::offset_t DWARFDebugInfoEntry::GetFirstAttributeOffset ( ) const

Definition at line 809 of file DWARFDebugInfoEntry.cpp.

References GetOffset(), and m_abbr_idx.

Referenced by GetAttributes(), GetAttributeValue(), and GetDIENamesAndRanges().

◆ GetFirstChild() [1/2]

DWARFDebugInfoEntry * DWARFDebugInfoEntry::GetFirstChild ( )
inline

Definition at line 150 of file DWARFDebugInfoEntry.h.

References HasChildren().

Referenced by BuildFunctionAddressRangeTable(), and DWARFDIE::GetFirstChild().

◆ GetFirstChild() [2/2]

const DWARFDebugInfoEntry * DWARFDebugInfoEntry::GetFirstChild ( ) const
inline

Definition at line 153 of file DWARFDebugInfoEntry.h.

References HasChildren().

◆ GetMangledName()

const char * DWARFDebugInfoEntry::GetMangledName ( const DWARFUnit cu,
bool  substitute_name_allowed = true 
) const

Definition at line 673 of file DWARFDebugInfoEntry.cpp.

References GetAttributeValueAsString().

Referenced by DWARFDIE::GetMangledName().

◆ GetName()

const char * DWARFDebugInfoEntry::GetName ( const DWARFUnit cu) const

◆ GetOffset()

dw_offset_t DWARFDebugInfoEntry::GetOffset ( ) const
inline

◆ GetParent() [1/2]

DWARFDebugInfoEntry * DWARFDebugInfoEntry::GetParent ( )
inline

◆ GetParent() [2/2]

const DWARFDebugInfoEntry * DWARFDebugInfoEntry::GetParent ( ) const
inline

Definition at line 136 of file DWARFDebugInfoEntry.h.

References m_parent_idx.

◆ GetParentDeclContextDIE() [1/2]

DWARFDIE DWARFDebugInfoEntry::GetParentDeclContextDIE ( DWARFUnit cu) const

◆ GetParentDeclContextDIE() [2/2]

DWARFDIE DWARFDebugInfoEntry::GetParentDeclContextDIE ( DWARFUnit cu,
const DWARFAttributes attributes 
) const

◆ GetPubname()

const char * DWARFDebugInfoEntry::GetPubname ( const DWARFUnit cu) const

Definition at line 696 of file DWARFDebugInfoEntry.cpp.

References GetAttributeValueAsString().

Referenced by DWARFDIE::GetPubname().

◆ GetSibling() [1/2]

DWARFDebugInfoEntry * DWARFDebugInfoEntry::GetSibling ( )
inline

Definition at line 141 of file DWARFDebugInfoEntry.h.

References m_sibling_idx.

Referenced by BuildFunctionAddressRangeTable(), and DWARFDIE::GetSibling().

◆ GetSibling() [2/2]

const DWARFDebugInfoEntry * DWARFDebugInfoEntry::GetSibling ( ) const
inline

Definition at line 144 of file DWARFDebugInfoEntry.h.

References m_sibling_idx.

◆ HasChildren()

bool DWARFDebugInfoEntry::HasChildren ( ) const
inline

◆ IsGlobalOrStaticScopeVariable()

bool DWARFDebugInfoEntry::IsGlobalOrStaticScopeVariable ( ) const

Definition at line 825 of file DWARFDebugInfoEntry.cpp.

References GetParent(), and Tag().

◆ IsNULL()

bool DWARFDebugInfoEntry::IsNULL ( ) const
inline

Definition at line 123 of file DWARFDebugInfoEntry.h.

References m_abbr_idx.

Referenced by DWARFUnit::ExtractDIEsRWLocked().

◆ operator bool()

DWARFDebugInfoEntry::operator bool ( ) const
inlineexplicit

Definition at line 44 of file DWARFDebugInfoEntry.h.

References DW_INVALID_OFFSET, and m_offset.

◆ operator!=()

bool DWARFDebugInfoEntry::operator!= ( const DWARFDebugInfoEntry rhs) const

Definition at line 855 of file DWARFDebugInfoEntry.cpp.

◆ operator==()

bool DWARFDebugInfoEntry::operator== ( const DWARFDebugInfoEntry rhs) const

◆ SetHasChildren()

void DWARFDebugInfoEntry::SetHasChildren ( bool  b)
inline

Definition at line 129 of file DWARFDebugInfoEntry.h.

References m_has_children.

Referenced by DWARFUnit::ExtractDIEsRWLocked().

◆ SetParentIndex()

void DWARFDebugInfoEntry::SetParentIndex ( uint32_t  idx)
inline

Definition at line 164 of file DWARFDebugInfoEntry.h.

References m_parent_idx.

Referenced by DWARFUnit::ExtractDIEsRWLocked().

◆ SetSiblingIndex()

void DWARFDebugInfoEntry::SetSiblingIndex ( uint32_t  idx)
inline

Definition at line 163 of file DWARFDebugInfoEntry.h.

References m_sibling_idx.

◆ Tag()

dw_tag_t DWARFDebugInfoEntry::Tag ( ) const
inline

Member Data Documentation

◆ m_abbr_idx

uint16_t DWARFDebugInfoEntry::m_abbr_idx = 0
protected

◆ m_has_children

uint32_t DWARFDebugInfoEntry::m_has_children
protected

Definition at line 184 of file DWARFDebugInfoEntry.h.

Referenced by Extract(), HasChildren(), operator==(), and SetHasChildren().

◆ m_offset

dw_offset_t DWARFDebugInfoEntry::m_offset
protected

Definition at line 176 of file DWARFDebugInfoEntry.h.

Referenced by Extract(), GetOffset(), operator bool(), and operator==().

◆ m_parent_idx

dw_offset_t DWARFDebugInfoEntry::m_parent_idx
protected

Definition at line 179 of file DWARFDebugInfoEntry.h.

Referenced by Extract(), GetParent(), operator==(), and SetParentIndex().

◆ m_sibling_idx

uint32_t DWARFDebugInfoEntry::m_sibling_idx
protected

Definition at line 184 of file DWARFDebugInfoEntry.h.

Referenced by Extract(), GetSibling(), operator==(), and SetSiblingIndex().

◆ m_tag

dw_tag_t DWARFDebugInfoEntry::m_tag = llvm::dwarf::DW_TAG_null
protected

A copy of the DW_TAG value so we don't have to go through the compile unit abbrev table.

Definition at line 188 of file DWARFDebugInfoEntry.h.

Referenced by BuildFunctionAddressRangeTable(), Extract(), operator==(), and Tag().


The documentation for this class was generated from the following files: