#include <DWARFUnit.h>

Inheritance diagram for DWARFUnit:

[legend]

Collaboration diagram for DWARFUnit:

[legend]

Classes
class	ScopedExtractDIEs

Public Member Functions
virtual	~DWARFUnit ()

bool	IsDWOUnit ()

std::optional< uint64_t >	GetDWOId ()

void	ExtractUnitDIEIfNeeded ()

void	ExtractUnitDIENoDwoIfNeeded ()

void	ExtractDIEsIfNeeded ()

ScopedExtractDIEs	ExtractDIEsScoped ()

bool	Verify (lldb_private::Stream *s) const

virtual void	Dump (lldb_private::Stream *s) const =0

const lldb_private::DWARFDataExtractor &	GetData () const
	Get the data that contains the DIE information for this unit.

uint32_t	GetHeaderByteSize () const
	Get the size in bytes of the unit header.

dw_offset_t	GetOffset () const

size_t	GetLengthByteSize () const
	Get the size in bytes of the length field in the header.

bool	ContainsDIEOffset (dw_offset_t die_offset) const

dw_offset_t	GetFirstDIEOffset () const

dw_offset_t	GetNextUnitOffset () const

size_t	GetDebugInfoSize () const

uint32_t	GetLength () const

uint16_t	GetVersion () const

const DWARFAbbreviationDeclarationSet *	GetAbbreviations () const

dw_offset_t	GetAbbrevOffset () const

uint8_t	GetAddressByteSize () const

dw_addr_t	GetAddrBase () const

dw_addr_t	GetBaseAddress () const

dw_offset_t	GetLineTableOffset ()

dw_addr_t	GetRangesBase () const

dw_addr_t	GetStrOffsetsBase () const

void	SetAddrBase (dw_addr_t addr_base)

void	SetLoclistsBase (dw_addr_t loclists_base)

void	SetRangesBase (dw_addr_t ranges_base)

void	SetStrOffsetsBase (dw_offset_t str_offsets_base)

virtual void	BuildAddressRangeTable (DWARFDebugAranges *debug_aranges)=0

dw_addr_t	ReadAddressFromDebugAddrSection (uint32_t index) const

lldb::ByteOrder	GetByteOrder () const

const DWARFDebugAranges &	GetFunctionAranges ()

void	SetBaseAddress (dw_addr_t base_addr)

DWARFBaseDIE	GetUnitDIEOnly ()

DWARFDIE	DIE ()

DWARFDIE	GetDIE (dw_offset_t die_offset)

DWARFUnit &	GetNonSkeletonUnit ()

void *	GetUserData () const

void	SetUserData (void *d)

bool	Supports_DW_AT_APPLE_objc_complete_type ()

bool	DW_AT_decl_file_attributes_are_invalid ()

bool	Supports_unnamed_objc_bitfields ()

SymbolFileDWARF &	GetSymbolFileDWARF () const

DWARFProducer	GetProducer ()

llvm::VersionTuple	GetProducerVersion ()

uint64_t	GetDWARFLanguageType ()

bool	GetIsOptimized ()

const lldb_private::FileSpec &	GetCompilationDirectory ()

const lldb_private::FileSpec &	GetAbsolutePath ()

lldb_private::FileSpec	GetFile (size_t file_idx)

lldb_private::FileSpec::Style	GetPathStyle ()

SymbolFileDWARFDwo *	GetDwoSymbolFile ()

die_iterator_range	dies ()

DIERef::Section	GetDebugSection () const

uint8_t	GetUnitType () const

bool	IsTypeUnit () const

bool	IsSkeletonUnit () const
	Note that this check only works for DWARF5+.

std::optional< uint64_t >	GetStringOffsetSectionItem (uint32_t index) const

llvm::Expected< DWARFRangeList >	FindRnglistFromOffset (dw_offset_t offset)
	Return a list of address ranges resulting from a (possibly encoded) range list starting at a given offset in the appropriate ranges section.

llvm::Expected< DWARFRangeList >	FindRnglistFromIndex (uint32_t index)
	Return a list of address ranges retrieved from an encoded range list whose offset is found via a table lookup given an index (DWARF v5 and later).

llvm::Expected< uint64_t >	GetRnglistOffset (uint32_t Index)
	Return a rangelist's offset based on an index.

std::optional< uint64_t >	GetLoclistOffset (uint32_t Index)

std::unique_ptr< llvm::DWARFLocationTable >	GetLocationTable (const lldb_private::DataExtractor &data) const
	Return the location table for parsing the given location list data.

lldb_private::DWARFDataExtractor	GetLocationData () const

bool	HasAny (llvm::ArrayRef< dw_tag_t > tags)
	Returns true if any DIEs in the unit match any DW_TAG values in tags.

const lldb_private::Status &	GetDwoError () const
	Get the fission .dwo file specific error for this compile unit.

void	SetDwoError (const lldb_private::Status &error)
	Set the fission .dwo file specific error for this compile unit.

Public Member Functions inherited from lldb_private::UserID
	UserID (lldb::user_id_t uid=LLDB_INVALID_UID)
	Construct with optional user ID.

	~UserID ()=default
	Destructor.

void	Clear ()
	Clears the object state.

lldb::user_id_t	GetID () const
	Get accessor for the user ID.

void	SetID (lldb::user_id_t uid)
	Set accessor for the user ID.

Static Public Member Functions
static llvm::Expected< DWARFUnitSP >	extract (SymbolFileDWARF &dwarf2Data, lldb::user_id_t uid, const lldb_private::DWARFDataExtractor &debug_info, DIERef::Section section, lldb::offset_t *offset_ptr)

static uint8_t	GetAddressByteSize (const DWARFUnit *cu)

static uint8_t	GetDefaultAddressSize ()

Protected Member Functions
	DWARFUnit (SymbolFileDWARF &dwarf, lldb::user_id_t uid, const DWARFUnitHeader &header, const DWARFAbbreviationDeclarationSet &abbrevs, DIERef::Section section, bool is_dwo)

llvm::Error	ExtractHeader (SymbolFileDWARF &dwarf, const lldb_private::DWARFDataExtractor &data, lldb::offset_t *offset_ptr)

const DWARFDebugInfoEntry *	GetUnitDIEPtrOnly ()

const DWARFDebugInfoEntry *	DIEPtr ()

const std::optional< llvm::DWARFDebugRnglistTable > &	GetRnglistTable ()

lldb_private::DWARFDataExtractor	GetRnglistData () const

Protected Attributes
SymbolFileDWARF &	m_dwarf

std::shared_ptr< DWARFUnit >	m_dwo

DWARFUnitHeader	m_header

const DWARFAbbreviationDeclarationSet *	m_abbrevs = nullptr

void *	m_user_data = nullptr

DWARFDebugInfoEntry::collection	m_die_array

llvm::sys::RWMutex	m_die_array_mutex

llvm::sys::RWMutex	m_die_array_scoped_mutex

std::atomic< bool >	m_cancel_scopes

DWARFDebugInfoEntry	m_first_die

llvm::sys::RWMutex	m_first_die_mutex

std::unique_ptr< DWARFDebugAranges >	m_func_aranges_up

dw_addr_t	m_base_addr = 0

DWARFProducer	m_producer = eProducerInvalid

llvm::VersionTuple	m_producer_version

std::optional< uint64_t >	m_language_type

lldb_private::LazyBool	m_is_optimized = lldb_private::eLazyBoolCalculate

std::optional< lldb_private::FileSpec >	m_comp_dir

std::optional< lldb_private::FileSpec >	m_file_spec

std::optional< dw_addr_t >	m_addr_base
	Value of DW_AT_addr_base.

dw_addr_t	m_loclists_base = 0
	Value of DW_AT_loclists_base.

dw_addr_t	m_ranges_base = 0
	Value of DW_AT_rnglists_base.

std::optional< uint64_t >	m_gnu_addr_base

std::optional< uint64_t >	m_gnu_ranges_base

dw_offset_t	m_line_table_offset = DW_INVALID_OFFSET
	Value of DW_AT_stmt_list.

dw_offset_t	m_str_offsets_base = 0

std::optional< llvm::DWARFDebugRnglistTable >	m_rnglist_table

bool	m_rnglist_table_done = false

std::optional< llvm::DWARFListTableHeader >	m_loclist_table_header

const DIERef::Section	m_section

bool	m_is_dwo

bool	m_has_parsed_non_skeleton_unit

std::optional< uint64_t >	m_dwo_id
	Value of DW_AT_GNU_dwo_id (v4) or dwo_id from CU header (v5).

lldb_private::Status	m_dwo_error
	If we get an error when trying to load a .dwo file, save that error here.

Protected Attributes inherited from lldb_private::UserID
lldb::user_id_t	m_uid
	The user ID that uniquely identifies an object.

Private Types
using	die_iterator_range = llvm::iterator_range< DWARFDebugInfoEntry::collection::iterator >

Private Member Functions
void	ParseProducerInfo ()

void	ExtractDIEsRWLocked ()

void	ClearDIEsRWLocked ()

void	AddUnitDIE (const DWARFDebugInfoEntry &cu_die)

void	SetDwoStrOffsetsBase ()

void	ComputeCompDirAndGuessPathStyle ()

void	ComputeAbsolutePath ()

	DWARFUnit (const DWARFUnit &)=delete

const DWARFUnit &	operator= (const DWARFUnit &)=delete

Detailed Description

Definition at line 84 of file DWARFUnit.h.

Member Typedef Documentation

◆ die_iterator_range

using DWARFUnit::die_iterator_range = llvm::iterator_range<DWARFDebugInfoEntry::collection::iterator>

private

Definition at line 85 of file DWARFUnit.h.

Constructor & Destructor Documentation

◆ ~DWARFUnit()

DWARFUnit::~DWARFUnit ( )

virtualdefault

◆ DWARFUnit() [1/2]

DWARFUnit::DWARFUnit	(	SymbolFileDWARF &	dwarf,
		lldb::user_id_t	uid,
		const DWARFUnitHeader &	header,
		const DWARFAbbreviationDeclarationSet &	abbrevs,
		DIERef::Section	section,
		bool	is_dwo
	)

protected

Definition at line 33 of file DWARFUnit.cpp.

◆ DWARFUnit() [2/2]

DWARFUnit::DWARFUnit ( const DWARFUnit & )

privatedelete

Member Function Documentation

◆ AddUnitDIE()

void DWARFUnit::AddUnitDIE ( const DWARFDebugInfoEntry & cu_die )

private

◆ BuildAddressRangeTable()

virtual void DWARFUnit::BuildAddressRangeTable ( DWARFDebugAranges * debug_aranges )

pure virtual

Implemented in DWARFCompileUnit, and DWARFTypeUnit.

Referenced by DWARFDebugInfo::GetCompileUnitAranges().

◆ ClearDIEsRWLocked()

void DWARFUnit::ClearDIEsRWLocked ( )

private

Definition at line 615 of file DWARFUnit.cpp.

References m_die_array, and m_dwo.

◆ ComputeAbsolutePath()

void DWARFUnit::ComputeAbsolutePath ( )

private

Definition at line 836 of file DWARFUnit.cpp.

References DWARFDebugInfoEntry::GetAttributeValueAsString(), GetCompilationDirectory(), GetPathStyle(), GetUnitDIEPtrOnly(), and m_file_spec.

Referenced by GetAbsolutePath().

◆ ComputeCompDirAndGuessPathStyle()

void DWARFUnit::ComputeCompDirAndGuessPathStyle ( )

private

Definition at line 814 of file DWARFUnit.cpp.

References DWARFDebugInfoEntry::GetAttributeValueAsString(), GetUnitDIEPtrOnly(), lldb_private::FileSpec::GuessPathStyle(), m_comp_dir, and removeHostnameFromPathname().

Referenced by GetCompilationDirectory(), and GetPathStyle().

◆ ContainsDIEOffset()

bool DWARFUnit::ContainsDIEOffset ( dw_offset_t die_offset ) const

inline

Definition at line 143 of file DWARFUnit.h.

References GetFirstDIEOffset(), and GetNextUnitOffset().

Referenced by GetDIE(), DWARFDebugInfo::GetUnitContainingDIEOffset(), and DWARFFormValue::Reference().

◆ DIE()

DWARFDIE DWARFUnit::DIE ( )

inline

Definition at line 180 of file DWARFUnit.h.

References DIEPtr().

Referenced by DWARFCompileUnit::LookupAddress(), SymbolFileDWARF::ParseImportedModules(), and SymbolFileDWARF::ParseTypes().

◆ DIEPtr()

const DWARFDebugInfoEntry * DWARFUnit::DIEPtr ( )

inlineprotected

Definition at line 312 of file DWARFUnit.h.

References ExtractDIEsIfNeeded(), and m_die_array.

Referenced by DIE(), and GetFunctionAranges().

◆ dies()

die_iterator_range DWARFUnit::dies ( )

inline

Definition at line 217 of file DWARFUnit.h.

References ExtractDIEsIfNeeded(), and m_die_array.

Referenced by lldb_private::ManualDWARFIndex::IndexUnitImpl(), and SymbolFileDWARF::ParseFunctions().

◆ Dump()

virtual void DWARFUnit::Dump ( lldb_private::Stream * s ) const

pure virtual

Implemented in DWARFCompileUnit, and DWARFTypeUnit.

◆ DW_AT_decl_file_attributes_are_invalid()

bool DWARFUnit::DW_AT_decl_file_attributes_are_invalid ( )

Definition at line 685 of file DWARFUnit.cpp.

References eProducerLLVMGCC, and GetProducer().

◆ extract()

llvm::Expected< DWARFUnitSP > DWARFUnit::extract	(	SymbolFileDWARF &	dwarf2Data,
		lldb::user_id_t	uid,
		const lldb_private::DWARFDataExtractor &	debug_info,
		DIERef::Section	section,
		lldb::offset_t *	offset_ptr
	)

static

Definition at line 964 of file DWARFUnit.cpp.

References DWARFUnitHeader::extract(), DWARFDebugAbbrev::GetAbbreviationDeclarationSet(), and lldb_private::DataExtractor::ValidOffset().

Referenced by DWARFDebugInfo::ParseUnitsFor().

◆ ExtractDIEsIfNeeded()

void DWARFUnit::ExtractDIEsIfNeeded ( )

Definition at line 140 of file DWARFUnit.cpp.

References ExtractDIEsRWLocked(), m_cancel_scopes, m_die_array, and m_die_array_mutex.

Referenced by DIEPtr(), dies(), and GetDIE().

◆ ExtractDIEsRWLocked()

void DWARFUnit::ExtractDIEsRWLocked ( )

private

◆ ExtractDIEsScoped()

DWARFUnit::ScopedExtractDIEs DWARFUnit::ExtractDIEsScoped ( )

Definition at line 160 of file DWARFUnit.cpp.

References ExtractDIEsRWLocked(), lldbassert, m_cancel_scopes, DWARFUnit::ScopedExtractDIEs::m_clear_dies, m_die_array, and m_die_array_mutex.

◆ ExtractHeader()

llvm::Error DWARFUnit::ExtractHeader	(	SymbolFileDWARF &	dwarf,
		const lldb_private::DWARFDataExtractor &	data,
		lldb::offset_t *	offset_ptr
	)

protected

◆ ExtractUnitDIEIfNeeded()

void DWARFUnit::ExtractUnitDIEIfNeeded ( )

◆ ExtractUnitDIENoDwoIfNeeded()

void DWARFUnit::ExtractUnitDIENoDwoIfNeeded ( )

Definition at line 44 of file DWARFUnit.cpp.

References AddUnitDIE(), elapsed(), DWARFDebugInfoEntry::Extract(), GetData(), SymbolFileDWARF::GetDebugInfoParseTimeRef(), GetFirstDIEOffset(), GetNextUnitOffset(), m_dwarf, m_first_die, and m_first_die_mutex.

Referenced by ExtractUnitDIEIfNeeded(), GetDWOId(), GetLineTableOffset(), and GetUnitDIEPtrOnly().

◆ FindRnglistFromIndex()

llvm::Expected< DWARFRangeList > DWARFUnit::FindRnglistFromIndex ( uint32_t index )

Return a list of address ranges retrieved from an encoded range list whose offset is found via a table lookup given an index (DWARF v5 and later).

Definition at line 1075 of file DWARFUnit.cpp.

References FindRnglistFromOffset(), and GetRnglistOffset().

Referenced by GetRangesOrReportError().

◆ FindRnglistFromOffset()

llvm::Expected< DWARFRangeList > DWARFUnit::FindRnglistFromOffset ( dw_offset_t offset )

Return a list of address ranges resulting from a (possibly encoded) range list starting at a given offset in the appropriate ranges section.

Definition at line 1028 of file DWARFUnit.cpp.

References lldb_private::RangeVector< B, S, N >::Append(), DWARFDebugRanges::FindRanges(), GetAddrBase(), DWARFUnitHeader::GetAddressByteSize(), GetAddressByteSize(), lldb_private::DWARFDataExtractor::GetAsLLVM(), GetBaseAddress(), SymbolFileDWARF::GetDebugRanges(), SymbolFileDWARF::GetDWARFContext(), lldb_private::DataExtractor::GetMaxU64(), lldb_private::DWARFContext::getOrLoadAddrData(), GetRnglistData(), GetRnglistTable(), GetVersion(), m_dwarf, and m_header.

Referenced by FindRnglistFromIndex(), and GetRangesOrReportError().

◆ GetAbbreviations()

const DWARFAbbreviationDeclarationSet * DWARFUnit::GetAbbreviations ( ) const

Definition at line 437 of file DWARFUnit.cpp.

References m_abbrevs.

Referenced by DWARFDebugInfoEntry::GetAbbreviationDeclarationPtr().

◆ GetAbbrevOffset()

dw_offset_t DWARFUnit::GetAbbrevOffset ( ) const

Definition at line 441 of file DWARFUnit.cpp.

References DW_INVALID_OFFSET, DWARFAbbreviationDeclarationSet::GetOffset(), and m_abbrevs.

Referenced by DWARFCompileUnit::Dump(), and DWARFTypeUnit::Dump().

◆ GetAbsolutePath()

const FileSpec & DWARFUnit::GetAbsolutePath ( )

Definition at line 783 of file DWARFUnit.cpp.

References ComputeAbsolutePath(), and m_file_spec.

◆ GetAddrBase()

dw_addr_t DWARFUnit::GetAddrBase ( ) const

inline

Definition at line 159 of file DWARFUnit.h.

References m_addr_base.

Referenced by DWARFFormValue::Address(), FindRnglistFromOffset(), and ReadAddressFromDebugAddrSection().

◆ GetAddressByteSize() [1/2]

uint8_t DWARFUnit::GetAddressByteSize ( ) const

inline

Definition at line 158 of file DWARFUnit.h.

References DWARFUnitHeader::GetAddressByteSize(), and m_header.

Referenced by DWARFFormValue::Address(), DWARFCompileUnit::Dump(), DWARFTypeUnit::Dump(), DWARFDebugInfoEntry::Extract(), DWARFFormValue::ExtractValue(), FindRnglistFromOffset(), GetAddressByteSize(), DWARFFormValue::GetFixedSize(), SymbolFileDWARF::ParseVariableDIE(), ReadAddressFromDebugAddrSection(), and DWARFFormValue::SkipValue().

◆ GetAddressByteSize() [2/2]

uint8_t DWARFUnit::GetAddressByteSize ( const DWARFUnit * cu )

static

Definition at line 669 of file DWARFUnit.cpp.

References GetAddressByteSize(), and GetDefaultAddressSize().

◆ GetBaseAddress()

dw_addr_t DWARFUnit::GetBaseAddress ( ) const

inline

Definition at line 160 of file DWARFUnit.h.

References m_base_addr.

Referenced by ExtractUnitDIEIfNeeded(), DWARFDebugRanges::FindRanges(), FindRnglistFromOffset(), DWARFDebugInfoEntry::GetDIENamesAndRanges(), and lldb_private::DWARFExpression::ParseDWARFLocationList().

◆ GetByteOrder()

lldb::ByteOrder DWARFUnit::GetByteOrder ( ) const

Definition at line 623 of file DWARFUnit.cpp.

References lldb_private::ObjectFile::GetByteOrder(), lldb_private::SymbolFileCommon::GetObjectFile(), and m_dwarf.

Referenced by SymbolFileDWARF::ParseVariableDIE().

◆ GetCompilationDirectory()

const FileSpec & DWARFUnit::GetCompilationDirectory ( )

Definition at line 777 of file DWARFUnit.cpp.

References ComputeCompDirAndGuessPathStyle(), and m_comp_dir.

Referenced by ComputeAbsolutePath(), and MakeAbsoluteAndRemap().

◆ GetData()

const lldb_private::DWARFDataExtractor & DWARFUnit::GetData ( ) const

Get the data that contains the DIE information for this unit.

This will return the correct bytes that contain the data for this DWARFUnit. It could be .debug_info or .debug_types depending on where the data for this unit originates.

Returns: The correct data for the DIE information in this unit.

Definition at line 1000 of file DWARFUnit.cpp.

References DIERef::DebugTypes, SymbolFileDWARF::GetDWARFContext(), lldb_private::DWARFContext::getOrLoadDebugInfoData(), lldb_private::DWARFContext::getOrLoadDebugTypesData(), m_dwarf, and m_section.

Referenced by ExtractDIEsRWLocked(), DWARFAttributes::ExtractFormValueAtIndex(), ExtractUnitDIENoDwoIfNeeded(), DWARFDebugInfoEntry::GetAttributes(), DWARFDebugInfoEntry::GetAttributeValue(), DWARFBaseDIE::GetData(), and DWARFDebugInfoEntry::GetDIENamesAndRanges().

◆ GetDebugInfoSize()

size_t DWARFUnit::GetDebugInfoSize ( ) const

Definition at line 433 of file DWARFUnit.cpp.

References GetHeaderByteSize(), GetLength(), and GetLengthByteSize().

Referenced by ExtractDIEsRWLocked().

◆ GetDebugSection()

DIERef::Section DWARFUnit::GetDebugSection ( ) const

inline

Definition at line 222 of file DWARFUnit.h.

References m_section.

Referenced by NameToDIE::FindAllEntriesForUnit(), and DWARFBaseDIE::GetDIERef().

◆ GetDefaultAddressSize()

uint8_t DWARFUnit::GetDefaultAddressSize ( )

static

Definition at line 675 of file DWARFUnit.cpp.

Referenced by GetAddressByteSize().

◆ GetDIE()

DWARFDIE DWARFUnit::GetDIE ( dw_offset_t die_offset )

Definition at line 641 of file DWARFUnit.cpp.

References CompareDIEOffset(), ContainsDIEOffset(), DW_INVALID_OFFSET, ExtractDIEsIfNeeded(), lldb_private::ModuleChild::GetModule(), lldb_private::SymbolFileCommon::GetObjectFile(), GetOffset(), GetSymbolFileDWARF(), and m_die_array.

Referenced by DWARFDebugInfo::GetDIE(), DWARFDIE::GetDIE(), lldb_private::ManualDWARFIndex::IndexUnit(), DWARFCompileUnit::LookupAddress(), SymbolFileDWARF::ParseBlocksRecursive(), and DWARFFormValue::Reference().

◆ GetDWARFLanguageType()

uint64_t DWARFUnit::GetDWARFLanguageType ( )

Definition at line 745 of file DWARFUnit.cpp.

References DWARFDebugInfoEntry::GetAttributeValueAsUnsigned(), GetUnitDIEPtrOnly(), and m_language_type.

Referenced by SymbolFileDWARF::CalculateFrameVariableError(), SymbolFileDWARF::GetLanguage(), SymbolFileDWARF::GetLanguageFamily(), and SymbolFileDWARF::ParseCompileUnit().

◆ GetDwoError()

const lldb_private::Status & DWARFUnit::GetDwoError ( ) const

inline

Get the fission .dwo file specific error for this compile unit.

The skeleton compile unit only can have a DWO error. Any other type of DWARFUnit will not have a valid DWO error.

Returns: A valid DWO error if there is a problem with anything in the locating or parsing inforamtion in the .dwo file

Definition at line 281 of file DWARFUnit.h.

References m_dwo_error.

Referenced by SymbolFileDWARF::CalculateFrameVariableError().

◆ GetDWOId()

std::optional< uint64_t > DWARFUnit::GetDWOId ( )

Definition at line 367 of file DWARFUnit.cpp.

References ExtractUnitDIENoDwoIfNeeded(), and m_dwo_id.

Referenced by SymbolFileDWARFDwo::GetDWOCompileUnitForHash(), SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), lldb_private::ManualDWARFIndex::IndexUnit(), and SetLoclistsBase().

◆ GetDwoSymbolFile()

SymbolFileDWARFDwo * DWARFUnit::GetDwoSymbolFile ( )

Definition at line 850 of file DWARFUnit.cpp.

References ExtractUnitDIEIfNeeded(), and m_dwo.

Referenced by SymbolFileDWARF::GetDIE(), SymbolFileDWARF::GetMangledNamesForFunction(), and lldb_private::ManualDWARFIndex::IndexUnit().

◆ GetFile()

FileSpec DWARFUnit::GetFile ( size_t file_idx )

Definition at line 789 of file DWARFUnit.cpp.

References SymbolFileDWARF::GetFile(), and m_dwarf.

Referenced by DWARFASTParserClang::ParseChildEnumerators(), ParsedDWARFTypeAttributes::ParsedDWARFTypeAttributes(), DWARFASTParserClang::ParseFunctionFromDWARF(), and SymbolFileDWARF::ParseVariableDIE().

◆ GetFirstDIEOffset()

dw_offset_t DWARFUnit::GetFirstDIEOffset ( ) const

inline

Definition at line 147 of file DWARFUnit.h.

References GetHeaderByteSize(), and GetOffset().

Referenced by ContainsDIEOffset(), ExtractDIEsRWLocked(), ExtractUnitDIENoDwoIfNeeded(), and lldb_private::ManualDWARFIndex::IndexUnit().

◆ GetFunctionAranges()

const DWARFDebugAranges & DWARFUnit::GetFunctionAranges ( )

Definition at line 857 of file DWARFUnit.cpp.

References DWARFDebugInfoEntry::BuildFunctionAddressRangeTable(), DIEPtr(), m_dwo, and m_func_aranges_up.

Referenced by DWARFCompileUnit::LookupAddress().

◆ GetHeaderByteSize()

uint32_t DWARFUnit::GetHeaderByteSize ( ) const

Get the size in bytes of the unit header.

Returns: Byte size of the unit header

Definition at line 1006 of file DWARFUnit.cpp.

References DWARFUnitHeader::GetUnitType(), GetVersion(), and m_header.

Referenced by GetDebugInfoSize(), and GetFirstDIEOffset().

◆ GetIsOptimized()

bool DWARFUnit::GetIsOptimized ( )

Definition at line 757 of file DWARFUnit.cpp.

References lldb_private::eLazyBoolCalculate, lldb_private::eLazyBoolNo, lldb_private::eLazyBoolYes, DWARFDebugInfoEntry::GetAttributeValueAsUnsigned(), GetUnitDIEPtrOnly(), and m_is_optimized.

Referenced by SymbolFileDWARF::ParseIsOptimized().

◆ GetLength()

uint32_t DWARFUnit::GetLength ( ) const

inline

Definition at line 154 of file DWARFUnit.h.

References DWARFUnitHeader::GetLength(), and m_header.

Referenced by DWARFCompileUnit::Dump(), DWARFTypeUnit::Dump(), and GetDebugInfoSize().

◆ GetLengthByteSize()

size_t DWARFUnit::GetLengthByteSize ( ) const

inline

Get the size in bytes of the length field in the header.

In DWARF32 this is just 4 bytes

Returns: Byte size of the compile unit header length field

Definition at line 141 of file DWARFUnit.h.

Referenced by GetDebugInfoSize().

◆ GetLineTableOffset()

dw_offset_t DWARFUnit::GetLineTableOffset ( )

Definition at line 445 of file DWARFUnit.cpp.

References ExtractUnitDIENoDwoIfNeeded(), and m_line_table_offset.

Referenced by SymbolFileDWARF::GetTypeUnitSupportFiles(), and SymbolFileDWARF::ParseLineTable().

◆ GetLocationData()

DWARFDataExtractor DWARFUnit::GetLocationData ( ) const

Definition at line 523 of file DWARFUnit.cpp.

References SymbolFileDWARF::GetDWARFContext(), DWARFUnitHeader::GetIndexEntry(), lldb_private::DWARFContext::getOrLoadLocData(), lldb_private::DWARFContext::getOrLoadLocListsData(), GetSymbolFileDWARF(), GetVersion(), and m_header.

Referenced by DWARFDebugInfoEntry::GetDIENamesAndRanges(), and SymbolFileDWARF::ParseVariableDIE().

◆ GetLocationTable()

std::unique_ptr< llvm::DWARFLocationTable > DWARFUnit::GetLocationTable ( const lldb_private::DataExtractor & data ) const

Return the location table for parsing the given location list data.

The format is chosen according to the unit type. Never returns null.

Definition at line 513 of file DWARFUnit.cpp.

References lldb::eByteOrderLittle, lldb_private::DataExtractor::GetAddressByteSize(), lldb_private::DataExtractor::GetByteOrder(), lldb_private::DataExtractor::GetData(), GetVersion(), and m_is_dwo.

Referenced by lldb_private::DWARFExpression::ParseDWARFLocationList().

◆ GetLoclistOffset()

std::optional< uint64_t > DWARFUnit::GetLoclistOffset ( uint32_t Index )

inline

Definition at line 245 of file DWARFUnit.h.

References lldb_private::DWARFDataExtractor::GetAsLLVM(), SymbolFileDWARF::GetDWARFContext(), lldb_private::DWARFContext::getOrLoadLocListsData(), m_dwarf, m_loclist_table_header, and m_loclists_base.

Referenced by SymbolFileDWARF::ParseVariableDIE().

◆ GetNextUnitOffset()

dw_offset_t DWARFUnit::GetNextUnitOffset ( ) const

inline

Definition at line 150 of file DWARFUnit.h.

References DWARFUnitHeader::GetNextUnitOffset(), and m_header.

Referenced by ContainsDIEOffset(), DWARFCompileUnit::Dump(), DWARFTypeUnit::Dump(), ExtractDIEsRWLocked(), ExtractUnitDIENoDwoIfNeeded(), NameToDIE::FindAllEntriesForUnit(), and lldb_private::AppleDWARFIndex::GetGlobalVariables().

◆ GetNonSkeletonUnit()

DWARFUnit & DWARFUnit::GetNonSkeletonUnit ( )

Definition at line 662 of file DWARFUnit.cpp.

References ExtractUnitDIEIfNeeded(), and m_dwo.

Referenced by NameToDIE::FindAllEntriesForUnit(), DWARFDebugInfo::GetDIE(), lldb_private::AppleDWARFIndex::GetGlobalVariables(), DWARFCompileUnit::GetNonSkeletonUnit(), lldb_private::ManualDWARFIndex::IndexUnit(), SymbolFileDWARF::ParseBlocksRecursive(), SymbolFileDWARF::ParseFunctions(), SymbolFileDWARF::ParseIsOptimized(), SymbolFileDWARF::ParseLanguage(), SymbolFileDWARF::ParseXcodeSDK(), and lldb_private::DebugNamesDWARFIndex::ToDIERef().

◆ GetOffset()

dw_offset_t DWARFUnit::GetOffset ( ) const

inline

◆ GetPathStyle()

FileSpec::Style DWARFUnit::GetPathStyle ( )

Definition at line 771 of file DWARFUnit.cpp.

References ComputeCompDirAndGuessPathStyle(), and m_comp_dir.

Referenced by ComputeAbsolutePath(), SymbolFileDWARF::GetTypeUnitSupportFiles(), SymbolFileDWARF::ParseCompileUnit(), and SymbolFileDWARF::ParseImportedModules().

◆ GetProducer()

DWARFProducer DWARFUnit::GetProducer ( )

Definition at line 733 of file DWARFUnit.cpp.

References eProducerInvalid, m_producer, and ParseProducerInfo().

Referenced by DW_AT_decl_file_attributes_are_invalid(), Supports_DW_AT_APPLE_objc_complete_type(), and Supports_unnamed_objc_bitfields().

◆ GetProducerVersion()

llvm::VersionTuple DWARFUnit::GetProducerVersion ( )

Definition at line 739 of file DWARFUnit.cpp.

References m_producer_version, and ParseProducerInfo().

Referenced by Supports_unnamed_objc_bitfields().

◆ GetRangesBase()

dw_addr_t DWARFUnit::GetRangesBase ( ) const

inline

Definition at line 162 of file DWARFUnit.h.

References m_ranges_base.

Referenced by DWARFDebugRanges::FindRanges().

◆ GetRnglistData()

DWARFDataExtractor DWARFUnit::GetRnglistData ( ) const

protected

Definition at line 537 of file DWARFUnit.cpp.

References SymbolFileDWARF::GetDWARFContext(), DWARFUnitHeader::GetIndexEntry(), lldb_private::ModuleChild::GetModule(), lldb_private::SymbolFileCommon::GetObjectFile(), lldb_private::DWARFContext::getOrLoadRngListsData(), GetSymbolFileDWARF(), and m_header.

Referenced by FindRnglistFromOffset(), GetRnglistOffset(), and GetRnglistTable().

◆ GetRnglistOffset()

llvm::Expected< uint64_t > DWARFUnit::GetRnglistOffset ( uint32_t Index )

Return a rangelist's offset based on an index.

The index designates an entry in the rangelist table's offset array and is supplied by DW_FORM_rnglistx.

Definition at line 577 of file DWARFUnit.cpp.

References GetOffset(), GetRnglistData(), GetRnglistTable(), and m_ranges_base.

Referenced by FindRnglistFromIndex().

◆ GetRnglistTable()

const std::optional< llvm::DWARFDebugRnglistTable > & DWARFUnit::GetRnglistTable ( )

protected

Definition at line 561 of file DWARFUnit.cpp.

References lldb_private::ModuleChild::GetModule(), lldb_private::SymbolFileCommon::GetObjectFile(), GetRnglistData(), GetSymbolFileDWARF(), GetVersion(), m_ranges_base, m_rnglist_table, m_rnglist_table_done, and lldb_private::toString().

Referenced by FindRnglistFromOffset(), and GetRnglistOffset().

◆ GetStringOffsetSectionItem()

std::optional< uint64_t > DWARFUnit::GetStringOffsetSectionItem ( uint32_t index ) const

Definition at line 1022 of file DWARFUnit.cpp.

References SymbolFileDWARF::GetDWARFContext(), lldb_private::DWARFContext::getOrLoadStrOffsetsData(), GetStrOffsetsBase(), lldb_private::DataExtractor::GetU32(), and m_dwarf.

Referenced by DWARFFormValue::AsCString().

◆ GetStrOffsetsBase()

dw_addr_t DWARFUnit::GetStrOffsetsBase ( ) const

inline

Definition at line 163 of file DWARFUnit.h.

References m_str_offsets_base.

Referenced by GetStringOffsetSectionItem().

◆ GetSymbolFileDWARF()

SymbolFileDWARF & DWARFUnit::GetSymbolFileDWARF ( ) const

inline

◆ GetUnitDIEOnly()

DWARFBaseDIE DWARFUnit::GetUnitDIEOnly ( )

inline

Definition at line 178 of file DWARFUnit.h.

References GetUnitDIEPtrOnly().

Referenced by ExtractUnitDIEIfNeeded(), SymbolFileDWARF::ParseCompileUnit(), SymbolFileDWARF::ParseDebugMacros(), SymbolFileDWARF::ParseXcodeSDK(), and SymbolFileDWARF::UpdateExternalModuleListIfNeeded().

◆ GetUnitDIEPtrOnly()

const DWARFDebugInfoEntry * DWARFUnit::GetUnitDIEPtrOnly ( )

inlineprotected

Definition at line 303 of file DWARFUnit.h.

References ExtractUnitDIENoDwoIfNeeded(), and m_first_die.

Referenced by DWARFCompileUnit::BuildAddressRangeTable(), ComputeAbsolutePath(), ComputeCompDirAndGuessPathStyle(), GetDWARFLanguageType(), GetIsOptimized(), GetUnitDIEOnly(), and ParseProducerInfo().

◆ GetUnitType()

uint8_t DWARFUnit::GetUnitType ( ) const

inline

Definition at line 224 of file DWARFUnit.h.

References DWARFUnitHeader::GetUnitType(), and m_header.

Referenced by IsSkeletonUnit().

◆ GetUserData()

void * DWARFUnit::GetUserData ( ) const

Definition at line 677 of file DWARFUnit.cpp.

References m_user_data.

Referenced by SymbolFileDWARF::GetCompUnitForDWARFCompUnit(), SymbolFileDWARF::GetDWARFCompileUnit(), and SymbolFileDWARF::ParseCompileUnit().

◆ GetVersion()

uint16_t DWARFUnit::GetVersion ( ) const

inline

Definition at line 155 of file DWARFUnit.h.

References DWARFUnitHeader::GetVersion(), and m_header.

Referenced by DWARFFormValue::Dump(), DWARFCompileUnit::Dump(), DWARFTypeUnit::Dump(), DWARFDebugInfoEntry::Extract(), ExtractUnitDIEIfNeeded(), DWARFFormValue::ExtractValue(), FindRnglistFromOffset(), GetHeaderByteSize(), GetLocationData(), GetLocationTable(), GetRnglistTable(), lldb_private::ManualDWARFIndex::IndexUnit(), SymbolFileDWARF::ParseCompileUnit(), SetDwoStrOffsetsBase(), and DWARFFormValue::SkipValue().

◆ HasAny()

bool DWARFUnit::HasAny ( llvm::ArrayRef< dw_tag_t > tags )

Returns true if any DIEs in the unit match any DW_TAG values in tags.

Parameters

[in] tags An array of dw_tag_t values to check all abbrevitions for.

Returns: True if any DIEs match any tag in tags, false otherwise.

Definition at line 1083 of file DWARFUnit.cpp.

References ExtractUnitDIEIfNeeded(), m_die_array, and m_dwo.

Referenced by SymbolFileDWARF::CalculateFrameVariableError().

◆ IsDWOUnit()

bool DWARFUnit::IsDWOUnit ( )

inline

Definition at line 95 of file DWARFUnit.h.

References m_is_dwo.

Referenced by SymbolFileDWARF::GetCompUnitForDWARFCompUnit().

◆ IsSkeletonUnit()

bool DWARFUnit::IsSkeletonUnit ( ) const

inline

Note that this check only works for DWARF5+.

Definition at line 227 of file DWARFUnit.h.

References GetUnitType().

Referenced by lldb_private::ManualDWARFIndex::IndexUnit().

◆ IsTypeUnit()

bool DWARFUnit::IsTypeUnit ( ) const

inline

Definition at line 225 of file DWARFUnit.h.

References DWARFUnitHeader::IsTypeUnit(), and m_header.

Referenced by DWARFCompileUnit::classof(), and DWARFTypeUnit::classof().

◆ operator=()

const DWARFUnit & DWARFUnit::operator= ( const DWARFUnit & )

privatedelete

◆ ParseProducerInfo()

void DWARFUnit::ParseProducerInfo ( )

private

Definition at line 698 of file DWARFUnit.cpp.

References eProducerClang, eProducerGCC, eProducerLLVMGCC, eProducerOther, eProducerSwift, lldb_private::RegularExpression::Execute(), DWARFDebugInfoEntry::GetAttributeValueAsString(), GetUnitDIEPtrOnly(), m_producer, and m_producer_version.

Referenced by GetProducer(), and GetProducerVersion().

◆ ReadAddressFromDebugAddrSection()

dw_addr_t DWARFUnit::ReadAddressFromDebugAddrSection ( uint32_t index ) const

Definition at line 603 of file DWARFUnit.cpp.

References GetAddrBase(), GetAddressByteSize(), SymbolFileDWARF::GetDWARFContext(), lldb_private::DataExtractor::GetMaxU64_unchecked(), lldb_private::DWARFContext::getOrLoadAddrData(), LLDB_INVALID_ADDRESS, and m_dwarf.

Referenced by lldb_private::DWARFExpression::Evaluate(), lldb_private::DWARFExpression::GetLocation_DW_OP_addr(), and lldb_private::DWARFExpression::ParseDWARFLocationList().

◆ SetAddrBase()

void DWARFUnit::SetAddrBase ( dw_addr_t addr_base )

Definition at line 450 of file DWARFUnit.cpp.

References m_addr_base.

Referenced by AddUnitDIE(), and ExtractUnitDIEIfNeeded().

◆ SetBaseAddress()

void DWARFUnit::SetBaseAddress ( dw_addr_t base_addr )

Definition at line 627 of file DWARFUnit.cpp.

References m_base_addr.

Referenced by AddUnitDIE(), and ExtractUnitDIEIfNeeded().

◆ SetDwoError()

void DWARFUnit::SetDwoError ( const lldb_private::Status & error )

inline

Set the fission .dwo file specific error for this compile unit.

This helps tracks issues that arise when trying to locate or parse a .dwo file. Things like a missing .dwo file, DWO ID mismatch, and other .dwo errors can be stored in each compile unit so the issues can be communicated to the user.

Definition at line 289 of file DWARFUnit.h.

References error(), and m_dwo_error.

Referenced by ExtractUnitDIEIfNeeded(), and SymbolFileDWARF::GetDwoSymbolFileForCompileUnit().