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< 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)

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)

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
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

typedef std::vector<DWARFDebugInfoEntry> DWARFDebugInfoEntry::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

using DWARFDebugInfoEntry::Recurse = DWARFBaseDIE::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

Definition at line 814 of file DWARFDebugInfoEntry.cpp.

References 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 623 of file DWARFDebugInfoEntry.cpp.

References GetAttributeHighPC(), and GetAttributeValueAsAddress().

Referenced by GetAttributeAddressRanges().

◆ GetAttributeAddressRanges()

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

Definition at line 639 of file DWARFDebugInfoEntry.cpp.

References lldb_private::RangeVector< B, S, N >::Append(), GetAttributeAddressRange(), GetAttributeValue(), GetRangesOrReportError(), 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 600 of file DWARFDebugInfoEntry.cpp.

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

Referenced by GetAttributeAddressRange().

◆ GetAttributes() [1/2]

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

private

Definition at line 417 of file DWARFDebugInfoEntry.cpp.

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

◆ GetAttributes() [2/2]

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

inline

Definition at line 55 of file DWARFDebugInfoEntry.h.

References GetAttributes().

Referenced by DWARFUnit::AddUnitDIE(), GetAttributes(), DWARFBaseDIE::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 584 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 560 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 574 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 536 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 549 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