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

#include <DWARFDebugInfoEntry.h>

Collaboration diagram for DWARFDebugInfoEntry:

[legend]

Public Types
typedef std::vector< DWARFDebugInfoEntry >	collection

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)

size_t	GetAttributes (DWARFUnit *cu, DWARFAttributes &attrs, 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

size_t	GetAttributeAddressRanges (DWARFUnit *cu, DWARFRangeList &ranges, 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 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)

DWARFDebugInfoEntry *	GetParent ()

const DWARFDebugInfoEntry *	GetParent () const

DWARFDebugInfoEntry *	GetSibling ()

const DWARFDebugInfoEntry *	GetSibling () const

DWARFDebugInfoEntry *	GetFirstChild ()

const DWARFDebugInfoEntry *	GetFirstChild () 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
size_t	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 32 of file DWARFDebugInfoEntry.h.

Member Typedef Documentation

◆ collection

typedef std::vector<DWARFDebugInfoEntry> DWARFDebugInfoEntry::collection

Definition at line 34 of file DWARFDebugInfoEntry.h.

◆ const_iterator

typedef collection::const_iterator DWARFDebugInfoEntry::const_iterator

Definition at line 36 of file DWARFDebugInfoEntry.h.

◆ iterator

typedef collection::iterator DWARFDebugInfoEntry::iterator

Definition at line 35 of file DWARFDebugInfoEntry.h.

◆ Recurse

using DWARFDebugInfoEntry::Recurse = DWARFBaseDIE::Recurse

Definition at line 52 of file DWARFDebugInfoEntry.h.

Constructor & Destructor Documentation

◆ DWARFDebugInfoEntry()

DWARFDebugInfoEntry::DWARFDebugInfoEntry ( )

inline

Definition at line 38 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 712 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

Definition at line 812 of file DWARFDebugInfoEntry.cpp.

References DWARFAbbreviationDeclarationSet::GetAbbreviationDeclaration(), DWARFUnit::GetAbbreviations(), and m_abbr_idx.

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

◆ 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

Definition at line 620 of file DWARFDebugInfoEntry.cpp.

References GetAttributeHighPC(), and GetAttributeValueAsAddress().

Referenced by GetAttributeAddressRanges().

◆ GetAttributeAddressRanges()

size_t DWARFDebugInfoEntry::GetAttributeAddressRanges	(	DWARFUnit *	cu,
		DWARFRangeList &	ranges,
		bool	check_hi_lo_pc,
		bool	check_specification_or_abstract_origin = `false`
	)		const

Definition at line 636 of file DWARFDebugInfoEntry.cpp.

References lldb_private::RangeVector< B, S, N >::Append(), lldb_private::RangeVector< B, S, N >::Clear(), GetAttributeAddressRange(), GetAttributeValue(), GetRangesOrReportError(), lldb_private::RangeVector< B, S, N >::GetSize(), and LLDB_INVALID_ADDRESS.

Referenced by DWARFCompileUnit::BuildAddressRangeTable(), BuildFunctionAddressRangeTable(), and DWARFDIE::LookupDeepestBlock().

◆ 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

Definition at line 597 of file DWARFDebugInfoEntry.cpp.

References DWARFFormValue::Address(), DWARFFormValue::Form(), GetAttributeValue(), and DWARFFormValue::Unsigned().

Referenced by GetAttributeAddressRange().

◆ GetAttributes() [1/2]

size_t DWARFDebugInfoEntry::GetAttributes	(	DWARFUnit *	cu,
		DWARFAttributes &	attrs,
		Recurse	recurse,
		uint32_t	curr_depth
	)		const

private

Definition at line 413 of file DWARFDebugInfoEntry.cpp.

References DWARFAttributes::Append(), DWARFAttributes::Clear(), DWARFFormValue::ExtractValue(), DWARFFormValue::Form(), GetAbbreviationDeclarationPtr(), DWARFBaseDIE::GetAttributes(), DWARFBaseDIE::GetCU(), DWARFUnit::GetData(), DWARFDIE::GetDIE(), GetFirstAttributeOffset(), DWARFFormValue::GetFixedSize(), DWARFFormValue::Reference(), DWARFAttributes::Size(), and DWARFFormValue::SkipValue().

◆ GetAttributes() [2/2]

size_t DWARFDebugInfoEntry::GetAttributes	(	DWARFUnit *	cu,
		DWARFAttributes &	attrs,
		Recurse	recurse = `Recurse::yes`
	)		const

inline

Definition at line 53 of file DWARFDebugInfoEntry.h.

References GetAttributes().

Referenced by DWARFUnit::AddUnitDIE(), DWARFBaseDIE::GetAttributes(), GetAttributes(), and GetParentDeclContextDIE().

◆ 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

Definition at line 581 of file DWARFDebugInfoEntry.cpp.

References DWARFFormValue::Address(), and GetAttributeValue().

Referenced by GetAttributeAddressRange(), and DWARFBaseDIE::GetAttributeValueAsAddress().

◆ GetAttributeValueAsOptionalUnsigned()

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

Definition at line 557 of file DWARFDebugInfoEntry.cpp.

References GetAttributeValue(), and DWARFFormValue::Unsigned().

Referenced by DWARFBaseDIE::GetAttributeValueAsOptionalUnsigned(), and GetDWOId().

◆ GetAttributeValueAsReference()

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

Definition at line 571 of file DWARFDebugInfoEntry.cpp.

References GetAttributeValue(), and DWARFFormValue::Reference().

Referenced by DWARFDIE::GetReferencedDIE().

◆ 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

Definition at line 533 of file DWARFDebugInfoEntry.cpp.

References DWARFFormValue::AsCString(), and GetAttributeValue().

Referenced by DWARFUnit::ComputeAbsolutePath(), DWARFUnit::ComputeCompDirAndGuessPathStyle(), DWARFBaseDIE::GetAttributeValueAsString(), GetDWOName(), SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), GetMangledName(), GetName(), DWARFDIE::GetName(), GetPubname(), and DWARFUnit::ParseProducerInfo().

◆ 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

Definition at line 546 of file DWARFDebugInfoEntry.cpp.

References GetAttributeValue(), and DWARFFormValue::Unsigned().

Referenced by DWARFBaseDIE::GetAttributeValueAsUnsigned(), DWARFUnit::GetDWARFLanguageType(), and DWARFUnit::GetIsOptimized().

◆ 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