DWARFContext This data structure is the top level entity that deals with dwarf debug information parsing. More...

#include "llvm/DebugInfo/DWARF/DWARFContext.h"

Inheritance diagram for llvm::DWARFContext:

Collaboration diagram for llvm::DWARFContext:

Classes
struct	DIEsForAddress
	Wraps the returned DIEs for a given address. More...

Public Types
enum	ProcessDebugRelocations { ProcessDebugRelocations::Process, ProcessDebugRelocations::Ignore }

using	unit_iterator_range = DWARFUnitVector::iterator_range

using	compile_unit_range = DWARFUnitVector::compile_unit_range

Public Types inherited from llvm::DIContext
enum	DIContextKind { CK_DWARF, CK_PDB }

Public Member Functions
	DWARFContext (std::unique_ptr< const DWARFObject > DObj, std::string DWPName="", std::function< void(Error)> RecoverableErrorHandler=WithColor::defaultErrorHandler, std::function< void(Error)> WarningHandler=WithColor::defaultWarningHandler)

	~DWARFContext () override

	DWARFContext (DWARFContext &)=delete

DWARFContext &	operator= (DWARFContext &)=delete

const DWARFObject &	getDWARFObj () const

void	dump (raw_ostream &OS, DIDumpOptions DumpOpts, std::array< Optional< uint64_t >, DIDT_ID_Count > DumpOffsets)
	Dump a textual representation to `OS`. More...

void	dump (raw_ostream &OS, DIDumpOptions DumpOpts) override

bool	verify (raw_ostream &OS, DIDumpOptions DumpOpts={}) override

unit_iterator_range	info_section_units ()
	Get units from .debug_info in this context. More...

const DWARFUnitVector &	getNormalUnitsVector ()

unit_iterator_range	types_section_units ()
	Get units from .debug_types in this context. More...

compile_unit_range	compile_units ()
	Get compile units in this context. More...

unit_iterator_range	normal_units ()
	Get all normal compile/type units in this context. More...

unit_iterator_range	dwo_info_section_units ()
	Get units from .debug_info..dwo in the DWO context. More...

const DWARFUnitVector &	getDWOUnitsVector ()

unit_iterator_range	dwo_types_section_units ()
	Get units from .debug_types.dwo in the DWO context. More...

compile_unit_range	dwo_compile_units ()
	Get compile units in the DWO context. More...

unit_iterator_range	dwo_units ()
	Get all units in the DWO context. More...

unsigned	getNumCompileUnits ()
	Get the number of compile units in this context. More...

unsigned	getNumTypeUnits ()
	Get the number of type units in this context. More...

unsigned	getNumDWOCompileUnits ()
	Get the number of compile units in the DWO context. More...

unsigned	getNumDWOTypeUnits ()
	Get the number of type units in the DWO context. More...

DWARFUnit *	getUnitAtIndex (unsigned index)
	Get the unit at the specified index. More...

DWARFUnit *	getDWOUnitAtIndex (unsigned index)
	Get the unit at the specified index for the DWO units. More...

DWARFCompileUnit *	getDWOCompileUnitForHash (uint64_t Hash)

DWARFTypeUnit *	getTypeUnitForHash (uint16_t Version, uint64_t Hash, bool IsDWO)

DWARFCompileUnit *	getCompileUnitForOffset (uint64_t Offset)
	Return the compile unit that includes an offset (relative to .debug_info). More...

DWARFDie	getDIEForOffset (uint64_t Offset)
	Get a DIE given an exact offset. More...

unsigned	getMaxVersion ()

unsigned	getMaxDWOVersion ()

void	setMaxVersionIfGreater (unsigned Version)

const DWARFUnitIndex &	getCUIndex ()

DWARFGdbIndex &	getGdbIndex ()

const DWARFUnitIndex &	getTUIndex ()

const DWARFDebugAbbrev *	getDebugAbbrev ()
	Get a pointer to the parsed DebugAbbrev object. More...

const DWARFDebugLoc *	getDebugLoc ()
	Get a pointer to the parsed DebugLoc object. More...

const DWARFDebugAbbrev *	getDebugAbbrevDWO ()
	Get a pointer to the parsed dwo abbreviations object. More...

const DWARFDebugAranges *	getDebugAranges ()
	Get a pointer to the parsed DebugAranges object. More...

Expected< const DWARFDebugFrame * >	getDebugFrame ()
	Get a pointer to the parsed frame information object. More...

Expected< const DWARFDebugFrame * >	getEHFrame ()
	Get a pointer to the parsed eh frame information object. More...

const DWARFDebugMacro *	getDebugMacinfo ()
	Get a pointer to the parsed DebugMacinfo information object. More...

const DWARFDebugMacro *	getDebugMacinfoDWO ()
	Get a pointer to the parsed DebugMacinfoDWO information object. More...

const DWARFDebugMacro *	getDebugMacro ()
	Get a pointer to the parsed DebugMacro information object. More...

const DWARFDebugMacro *	getDebugMacroDWO ()
	Get a pointer to the parsed DebugMacroDWO information object. More...

const DWARFDebugNames &	getDebugNames ()
	Get a reference to the parsed accelerator table object. More...

const AppleAcceleratorTable &	getAppleNames ()
	Get a reference to the parsed accelerator table object. More...

const AppleAcceleratorTable &	getAppleTypes ()
	Get a reference to the parsed accelerator table object. More...

const AppleAcceleratorTable &	getAppleNamespaces ()
	Get a reference to the parsed accelerator table object. More...

const AppleAcceleratorTable &	getAppleObjC ()
	Get a reference to the parsed accelerator table object. More...

const DWARFDebugLine::LineTable *	getLineTableForUnit (DWARFUnit *U)
	Get a pointer to a parsed line table corresponding to a compile unit. More...

Expected< const DWARFDebugLine::LineTable * >	getLineTableForUnit (DWARFUnit *U, function_ref< void(Error)> RecoverableErrorHandler)
	Get a pointer to a parsed line table corresponding to a compile unit. More...

void	clearLineTableForUnit (DWARFUnit *U)

DataExtractor	getStringExtractor () const

DataExtractor	getStringDWOExtractor () const

DataExtractor	getLineStringExtractor () const

DIEsForAddress	getDIEsForAddress (uint64_t Address)
	Get the compilation unit, the function DIE and lexical block DIE for the given address where applicable. More...

DILineInfo	getLineInfoForAddress (object::SectionedAddress Address, DILineInfoSpecifier Specifier=DILineInfoSpecifier()) override

DILineInfo	getLineInfoForDataAddress (object::SectionedAddress Address) override

DILineInfoTable	getLineInfoForAddressRange (object::SectionedAddress Address, uint64_t Size, DILineInfoSpecifier Specifier=DILineInfoSpecifier()) override

DIInliningInfo	getInliningInfoForAddress (object::SectionedAddress Address, DILineInfoSpecifier Specifier=DILineInfoSpecifier()) override

std::vector< DILocal >	getLocalsForAddress (object::SectionedAddress Address) override

bool	isLittleEndian () const

std::shared_ptr< DWARFContext >	getDWOContext (StringRef AbsolutePath)

const MCRegisterInfo *	getRegisterInfo () const

function_ref< void(Error)>	getRecoverableErrorHandler ()

function_ref< void(Error)>	getWarningHandler ()

Error	loadRegisterInfo (const object::ObjectFile &Obj)
	Loads register info for the architecture of the provided object file. More...

uint8_t	getCUAddrSize ()
	Get address size from CUs. More...

Triple::ArchType	getArch () const

DWARFCompileUnit *	getCompileUnitForAddress (uint64_t Address)
	Return the compile unit which contains instruction with provided address. More...

Public Member Functions inherited from llvm::DIContext
	DIContext (DIContextKind K)

virtual	~DIContext ()=default

DIContextKind	getKind () const

Static Public Member Functions
static bool	classof (const DIContext *DICtx)

static unsigned	getMaxSupportedVersion ()

static bool	isSupportedVersion (unsigned version)

static SmallVector< uint8_t, 3 >	getSupportedAddressSizes ()

static bool	isAddressSizeSupported (unsigned AddressSize)

template<typename... Ts>
static Error	checkAddressSizeSupported (unsigned AddressSize, std::error_code EC, char const *Fmt, const Ts &...Vals)

static std::unique_ptr< DWARFContext >	create (const object::ObjectFile &Obj, ProcessDebugRelocations RelocAction=ProcessDebugRelocations::Process, const LoadedObjectInfo *L=nullptr, std::string DWPName="", std::function< void(Error)> RecoverableErrorHandler=WithColor::defaultErrorHandler, std::function< void(Error)> WarningHandler=WithColor::defaultWarningHandler)

static std::unique_ptr< DWARFContext >	create (const StringMap< std::unique_ptr< MemoryBuffer >> &Sections, uint8_t AddrSize, bool isLittleEndian=sys::IsLittleEndianHost, std::function< void(Error)> RecoverableErrorHandler=WithColor::defaultErrorHandler, std::function< void(Error)> WarningHandler=WithColor::defaultWarningHandler)

Detailed Description

DWARFContext This data structure is the top level entity that deals with dwarf debug information parsing.

The actual data is supplied through DWARFObj.

Definition at line 47 of file DWARFContext.h.

Member Typedef Documentation

◆ compile_unit_range

using llvm::DWARFContext::compile_unit_range = DWARFUnitVector::compile_unit_range

Definition at line 145 of file DWARFContext.h.

◆ unit_iterator_range

using llvm::DWARFContext::unit_iterator_range = DWARFUnitVector::iterator_range

Definition at line 144 of file DWARFContext.h.

Member Enumeration Documentation

◆ ProcessDebugRelocations

enum llvm::DWARFContext::ProcessDebugRelocations

strong

Enumerator
Process
Ignore

Definition at line 419 of file DWARFContext.h.

Constructor & Destructor Documentation

◆ DWARFContext() [1/2]

DWARFContext::DWARFContext	(	std::unique_ptr< const DWARFObject >	DObj,
		std::string	DWPName = `""`,
		std::function< void(Error)>	RecoverableErrorHandler = `WithColor::defaultErrorHandler`,
		std::function< void(Error)>	WarningHandler = `WithColor::defaultWarningHandler`
	)

Definition at line 73 of file DWARFContext.cpp.

◆ ~DWARFContext()

DWARFContext::~DWARFContext ( )

overridedefault

◆ DWARFContext() [2/2]

llvm::DWARFContext::DWARFContext ( DWARFContext & )

delete

Member Function Documentation

◆ checkAddressSizeSupported()

template<typename... Ts>

static Error llvm::DWARFContext::checkAddressSizeSupported	(	unsigned	AddressSize,
		std::error_code	EC,
		char const *	Fmt,
		const Ts &...	Vals
	)

inlinestatic

Definition at line 392 of file DWARFContext.h.

References llvm::format(), getSupportedAddressSizes(), isAddressSizeSupported(), llvm::AArch64CC::LS, llvm::raw_string_ostream::str(), and llvm::Error::success().

Referenced by llvm::DWARFDebugRangeList::extract().

◆ classof()

static bool llvm::DWARFContext::classof ( const DIContext * DICtx )

inlinestatic

Definition at line 128 of file DWARFContext.h.

References llvm::DIContext::CK_DWARF, and llvm::DIContext::getKind().

◆ clearLineTableForUnit()

void DWARFContext::clearLineTableForUnit ( DWARFUnit * U )

Definition at line 1006 of file DWARFContext.cpp.

References llvm::DWARFUnit::getLineTableOffset(), llvm::DWARFUnit::getUnitDIE(), and llvm::dwarf::toSectionOffset().

◆ compile_units()

compile_unit_range llvm::DWARFContext::compile_units ( )

inline

Get compile units in this context.

Definition at line 168 of file DWARFContext.h.

References info_section_units(), llvm::isCompileUnit(), and llvm::make_filter_range().

Referenced by llvm::gsym::DwarfTransformer::convert(), llvm::DWARFDebugAranges::generate(), getCompileUnitForAddress(), and getCUAddrSize().

◆ create() [1/2]

std::unique_ptr< DWARFContext > DWARFContext::create	(	const object::ObjectFile &	Obj,
		ProcessDebugRelocations	RelocAction = `ProcessDebugRelocations::Process`,
		const LoadedObjectInfo *	L = `nullptr`,
		std::string	DWPName = `""`,
		std::function< void(Error)>	RecoverableErrorHandler = `WithColor::defaultErrorHandler`,
		std::function< void(Error)>	WarningHandler = `WithColor::defaultWarningHandler`
	)

static

Definition at line 1999 of file DWARFContext.cpp.

References move.

◆ create() [2/2]

std::unique_ptr< DWARFContext > DWARFContext::create	(	const StringMap< std::unique_ptr< MemoryBuffer >> &	Sections,
		uint8_t	AddrSize,
		bool	isLittleEndian = `sys::IsLittleEndianHost`,
		std::function< void(Error)>	RecoverableErrorHandler = `WithColor::defaultErrorHandler`,
		std::function< void(Error)>	WarningHandler = `WithColor::defaultWarningHandler`
	)

static

Definition at line 2012 of file DWARFContext.cpp.

References isLittleEndian(), and move.

◆ dump() [1/2]

void llvm::DWARFContext::dump	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts
	)

inlineoverridevirtual

Implements llvm::DIContext.

Definition at line 137 of file DWARFContext.h.

References llvm::DIDT_ID_Count, and dump().

◆ dump() [2/2]

void DWARFContext::dump	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		std::array< Optional< uint64_t >, DIDT_ID_Count >	DumpOffsets
	)

Dump a textual representation to OS.

If any DumpOffsets are present, dump only the record at the specified offset.

Definition at line 352 of file DWARFContext.cpp.

References llvm::Data, DF, llvm::DIDT_All, llvm::DIDT_UUID, llvm::DIDumpOptions::DisplayRawContents, llvm::DWARFDebugLine::SectionParser::done(), llvm::DWARFDebugAbbrev::dump(), llvm::DWARFDebugLoc::dump(), llvm::DWARFLocationTable::dumpLocationList(), dumpLoclistsSection(), llvm::DWARFDebugLoclists::dumpRange(), llvm::DIDumpOptions::DumpType, dumpUUID(), dwo_info_section_units(), dwo_types_section_units(), E, llvm::sys::path::extension(), llvm::format(), getDebugAbbrev(), getDebugAbbrevDWO(), getDebugFrame(), getDebugLoc(), getDebugMacinfo(), getDebugMacinfoDWO(), getDebugMacro(), getDebugMacroDWO(), getEHFrame(), getNumCompileUnits(), getNumDWOCompileUnits(), getNumDWOTypeUnits(), getNumTypeUnits(), llvm::DWARFDebugLine::SectionParser::getOffset(), getRegisterInfo(), info_section_units(), isLittleEndian(), llvm::DataExtractor::isValidOffset(), llvm::BitmaskEnumDetail::Mask(), move, llvm::DIDumpOptions::noImplicitRecursion(), llvm::None, llvm::DWARFDebugLine::SectionParser::parseNext(), set, llvm::DWARFDebugLine::SectionParser::skip(), types_section_units(), llvm::DIDumpOptions::Verbose, and llvm::DIDumpOptions::WarningHandler.

Referenced by dump().

◆ dwo_compile_units()

compile_unit_range llvm::DWARFContext::dwo_compile_units ( )

inline

Get compile units in the DWO context.

Definition at line 201 of file DWARFContext.h.

References dwo_info_section_units(), llvm::isCompileUnit(), and llvm::make_filter_range().

Referenced by getDWOCompileUnitForHash().

◆ dwo_info_section_units()

unit_iterator_range llvm::DWARFContext::dwo_info_section_units ( )

inline

Get units from .debug_info..dwo in the DWO context.

Definition at line 182 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumInfoUnits().

Referenced by dump(), dwo_compile_units(), and getMaxDWOVersion().

◆ dwo_types_section_units()

unit_iterator_range llvm::DWARFContext::dwo_types_section_units ( )

inline

Get units from .debug_types.dwo in the DWO context.

Definition at line 194 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumInfoUnits().

Referenced by dump().

◆ dwo_units()

unit_iterator_range llvm::DWARFContext::dwo_units ( )

inline

Get all units in the DWO context.

Definition at line 210 of file DWARFContext.h.

Referenced by getTypeUnitForHash().

◆ getAppleNames()

const AppleAcceleratorTable & DWARFContext::getAppleNames ( )

Get a reference to the parsed accelerator table object.

Definition at line 945 of file DWARFContext.cpp.

References getAccelTable(), and isLittleEndian().

◆ getAppleNamespaces()

const AppleAcceleratorTable & DWARFContext::getAppleNamespaces ( )

Get a reference to the parsed accelerator table object.

Definition at line 955 of file DWARFContext.cpp.

References getAccelTable(), and isLittleEndian().

◆ getAppleObjC()

const AppleAcceleratorTable & DWARFContext::getAppleObjC ( )

Get a reference to the parsed accelerator table object.

Definition at line 961 of file DWARFContext.cpp.

References getAccelTable(), and isLittleEndian().

◆ getAppleTypes()

const AppleAcceleratorTable & DWARFContext::getAppleTypes ( )

Get a reference to the parsed accelerator table object.

Definition at line 950 of file DWARFContext.cpp.

References getAccelTable(), and isLittleEndian().

◆ getArch()

Triple::ArchType llvm::DWARFContext::getArch ( ) const

inline

Definition at line 447 of file DWARFContext.h.

References llvm::object::ObjectFile::getArch(), getDWARFObj(), and llvm::DWARFObject::getFile().

Referenced by getDebugFrame(), and getEHFrame().

◆ getCompileUnitForAddress()

DWARFCompileUnit * DWARFContext::getCompileUnitForAddress ( uint64_t Address )

Return the compile unit which contains instruction with provided address.

TODO: change input parameter from "uint64_t Address" into "SectionedAddress Address"

Definition at line 1052 of file DWARFContext.cpp.

References compile_units(), llvm::DWARFDebugAranges::findAddress(), getCompileUnitForOffset(), and getDebugAranges().

Referenced by getDIEsForAddress(), getInliningInfoForAddress(), getLineInfoForAddress(), getLineInfoForAddressRange(), getLineInfoForDataAddress(), and getLocalsForAddress().

◆ getCompileUnitForOffset()

DWARFCompileUnit * DWARFContext::getCompileUnitForOffset ( uint64_t Offset )

Return the compile unit that includes an offset (relative to .debug_info).

Definition at line 1046 of file DWARFContext.cpp.

References llvm::DWARFUnitVector::getUnitForOffset().

Referenced by getCompileUnitForAddress().

◆ getCUAddrSize()

uint8_t DWARFContext::getCUAddrSize ( )

Get address size from CUs.

TODO: refactor compile_units() to make this const.

Definition at line 2039 of file DWARFContext.cpp.

References compile_units().

◆ getCUIndex()

const DWARFUnitIndex & DWARFContext::getCUIndex ( )

Definition at line 784 of file DWARFContext.cpp.

References isLittleEndian().

Referenced by getDWOCompileUnitForHash().

◆ getDebugAbbrev()

const DWARFDebugAbbrev * DWARFContext::getDebugAbbrev ( )

Get a pointer to the parsed DebugAbbrev object.

Definition at line 816 of file DWARFContext.cpp.

References isLittleEndian().

Referenced by dump().

◆ getDebugAbbrevDWO()

const DWARFDebugAbbrev * DWARFContext::getDebugAbbrevDWO ( )

Get a pointer to the parsed dwo abbreviations object.

Definition at line 827 of file DWARFContext.cpp.

References isLittleEndian().

Referenced by dump().

◆ getDebugAranges()

const DWARFDebugAranges * DWARFContext::getDebugAranges ( )

Get a pointer to the parsed DebugAranges object.

Definition at line 851 of file DWARFContext.cpp.

Referenced by getCompileUnitForAddress().

◆ getDebugFrame()

Expected< const DWARFDebugFrame * > DWARFContext::getDebugFrame ( )

Get a pointer to the parsed frame information object.

Definition at line 860 of file DWARFContext.cpp.

References DF, E, getArch(), isLittleEndian(), and move.

Referenced by dump().

◆ getDebugLoc()

const DWARFDebugLoc * DWARFContext::getDebugLoc ( )

Get a pointer to the parsed DebugLoc object.

Definition at line 837 of file DWARFContext.cpp.

References getNumCompileUnits(), getUnitAtIndex(), isLittleEndian(), and move.

Referenced by dump().

◆ getDebugMacinfo()

const DWARFDebugMacro * DWARFContext::getDebugMacinfo ( )

Get a pointer to the parsed DebugMacinfo information object.

Definition at line 914 of file DWARFContext.cpp.

Referenced by dump().

◆ getDebugMacinfoDWO()

const DWARFDebugMacro * DWARFContext::getDebugMacinfoDWO ( )

Get a pointer to the parsed DebugMacinfoDWO information object.

Definition at line 920 of file DWARFContext.cpp.

Referenced by dump().

◆ getDebugMacro()

const DWARFDebugMacro * DWARFContext::getDebugMacro ( )

Get a pointer to the parsed DebugMacro information object.

Definition at line 902 of file DWARFContext.cpp.

Referenced by dump().

◆ getDebugMacroDWO()

const DWARFDebugMacro * DWARFContext::getDebugMacroDWO ( )

Get a pointer to the parsed DebugMacroDWO information object.

Definition at line 908 of file DWARFContext.cpp.

Referenced by dump().

◆ getDebugNames()

const DWARFDebugNames & DWARFContext::getDebugNames ( )

Get a reference to the parsed accelerator table object.

Definition at line 940 of file DWARFContext.cpp.

References getAccelTable(), and isLittleEndian().

◆ getDIEForOffset()

DWARFDie DWARFContext::getDIEForOffset ( uint64_t Offset )

Get a DIE given an exact offset.

Definition at line 760 of file DWARFContext.cpp.

References llvm::DWARFUnitVector::getUnitForOffset().

◆ getDIEsForAddress()

DWARFContext::DIEsForAddress DWARFContext::getDIEsForAddress ( uint64_t Address )

Get the compilation unit, the function DIE and lexical block DIE for the given address where applicable.

TODO: change input parameter from "uint64_t Address" into "SectionedAddress Address"

Definition at line 1077 of file DWARFContext.cpp.

References llvm::append_range(), getCompileUnitForAddress(), and llvm::DIE::getTag().

◆ getDWARFObj()

const DWARFObject& llvm::DWARFContext::getDWARFObj ( ) const

inline

Definition at line 126 of file DWARFContext.h.

Referenced by dumpAttribute(), dumpLocationList(), llvm::DWARFVerifier::DWARFVerifier(), llvm::DWARFDebugAranges::generate(), getArch(), and llvm::DWARFVerifier::handleAccelTables().

◆ getDWOCompileUnitForHash()

DWARFCompileUnit * DWARFContext::getDWOCompileUnitForHash ( uint64_t Hash )

Definition at line 730 of file DWARFContext.cpp.

References dwo_compile_units(), getCUIndex(), llvm::DWARFUnitVector::getUnitForIndexEntry(), and llvm::dwarf::toUnsigned().

◆ getDWOContext()

std::shared_ptr< DWARFContext > DWARFContext::getDWOContext ( StringRef AbsolutePath )

Definition at line 1402 of file DWARFContext.cpp.

References move, and S.

◆ getDWOUnitAtIndex()

DWARFUnit* llvm::DWARFContext::getDWOUnitAtIndex ( unsigned index )

inline

Get the unit at the specified index for the DWO units.

Definition at line 246 of file DWARFContext.h.

References index.

◆ getDWOUnitsVector()

const DWARFUnitVector& llvm::DWARFContext::getDWOUnitsVector ( )

inline

Definition at line 188 of file DWARFContext.h.

◆ getEHFrame()

Expected< const DWARFDebugFrame * > DWARFContext::getEHFrame ( )

Get a pointer to the parsed eh frame information object.

Definition at line 886 of file DWARFContext.cpp.

References DF, E, getArch(), isLittleEndian(), and move.

Referenced by dump().

◆ getGdbIndex()

DWARFGdbIndex & DWARFContext::getGdbIndex ( )

Definition at line 806 of file DWARFContext.cpp.

◆ getInliningInfoForAddress()

DIInliningInfo DWARFContext::getInliningInfoForAddress	(	object::SectionedAddress	Address,
		DILineInfoSpecifier	Specifier = `DILineInfoSpecifier()`
	)

overridevirtual

Implements llvm::DIContext.

Definition at line 1333 of file DWARFContext.cpp.

Referenced by llvm::gsym::DwarfTransformer::verify().

◆ getLineInfoForAddress()

DILineInfo DWARFContext::getLineInfoForAddress	(	object::SectionedAddress	Address,
		DILineInfoSpecifier	Specifier = `DILineInfoSpecifier()`
	)

overridevirtual

Implements llvm::DIContext.

Definition at line 1242 of file DWARFContext.cpp.

References llvm::DILineInfoSpecifier::FLIKind, llvm::DILineInfoSpecifier::FNKind, getCompileUnitForAddress(), getFunctionNameAndStartLineForAddress(), getLineTableForUnit(), and llvm::None.

Referenced by llvm::gsym::DwarfTransformer::verify().

◆ getLineInfoForAddressRange()

DILineInfoTable DWARFContext::getLineInfoForAddressRange	(	object::SectionedAddress	Address,
		uint64_t	Size,
		DILineInfoSpecifier	Specifier = `DILineInfoSpecifier()`
	)

overridevirtual

Implements llvm::DIContext.

Definition at line 1278 of file DWARFContext.cpp.

References llvm::DILineInfo::BadString, llvm::DILineInfoSpecifier::FLIKind, llvm::DILineInfoSpecifier::FNKind, getCompileUnitForAddress(), llvm::DWARFDebugLine::LineTable::getFileNameByIndex(), getFunctionNameAndStartLineForAddress(), getLineTableForUnit(), llvm::DWARFDebugLine::LineTable::lookupAddressRange(), llvm::None, and llvm::DWARFDebugLine::LineTable::Rows.

◆ getLineInfoForDataAddress()

DILineInfo DWARFContext::getLineInfoForDataAddress ( object::SectionedAddress Address )

overridevirtual

Implements llvm::DIContext.

Definition at line 1264 of file DWARFContext.cpp.

References getCompileUnitForAddress(), llvm::DWARFDie::getDeclFile(), and llvm::DWARFDie::getDeclLine().

◆ getLineStringExtractor()

DataExtractor llvm::DWARFContext::getLineStringExtractor ( ) const

inline

Definition at line 346 of file DWARFContext.h.

◆ getLineTableForUnit() [1/2]

const DWARFDebugLine::LineTable * DWARFContext::getLineTableForUnit ( DWARFUnit * U )

Get a pointer to a parsed line table corresponding to a compile unit.

Report any parsing issues as warnings on stderr.

Definition at line 967 of file DWARFContext.cpp.

References llvm::Expected< T >::takeError().

Referenced by llvm::gsym::CUInfo::CUInfo(), dumpAttribute(), llvm::DWARFFormValue::getAsFile(), llvm::DeclContextTree::getChildDeclContext(), getInliningInfoForAddress(), getLineInfoForAddress(), and getLineInfoForAddressRange().

◆ getLineTableForUnit() [2/2]

Expected< const DWARFDebugLine::LineTable * > DWARFContext::getLineTableForUnit	(	DWARFUnit *	U,
		function_ref< void(Error)>	RecoverableErrorHandler
	)

Get a pointer to a parsed line table corresponding to a compile unit.

Report any recoverable parsing problems using the handler.

Definition at line 977 of file DWARFContext.cpp.

References llvm::DWARFSection::Data, llvm::DWARFUnit::getAddressByteSize(), llvm::DWARFUnit::getLineSection(), llvm::DWARFUnit::getLineTableOffset(), llvm::DWARFUnit::getUnitDIE(), isLittleEndian(), llvm::StringRef::size(), and llvm::dwarf::toSectionOffset().

◆ getLocalsForAddress()

std::vector< DILocal > DWARFContext::getLocalsForAddress ( object::SectionedAddress Address )

overridevirtual

Implements llvm::DIContext.

Definition at line 1230 of file DWARFContext.cpp.

References getCompileUnitForAddress(), and llvm::DWARFDie::isValid().

◆ getMaxDWOVersion()

unsigned llvm::DWARFContext::getMaxDWOVersion ( )

inline

Definition at line 266 of file DWARFContext.h.

References dwo_info_section_units().

◆ getMaxSupportedVersion()

static unsigned llvm::DWARFContext::getMaxSupportedVersion ( )

inlinestatic

Definition at line 380 of file DWARFContext.h.

Referenced by isSupportedVersion().

◆ getMaxVersion()

unsigned llvm::DWARFContext::getMaxVersion ( )

inline

Definition at line 260 of file DWARFContext.h.

References info_section_units().

◆ getNormalUnitsVector()

const DWARFUnitVector& llvm::DWARFContext::getNormalUnitsVector ( )

inline

Definition at line 155 of file DWARFContext.h.

◆ getNumCompileUnits()

unsigned llvm::DWARFContext::getNumCompileUnits ( )

inline

Get the number of compile units in this context.

Definition at line 216 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumInfoUnits().

Referenced by dump(), and getDebugLoc().

◆ getNumDWOCompileUnits()

unsigned llvm::DWARFContext::getNumDWOCompileUnits ( )

inline

Get the number of compile units in the DWO context.

Definition at line 228 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumInfoUnits().

Referenced by dump().

◆ getNumDWOTypeUnits()

unsigned llvm::DWARFContext::getNumDWOTypeUnits ( )

inline

Get the number of type units in the DWO context.

Definition at line 234 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumTypesUnits().

Referenced by dump().

◆ getNumTypeUnits()

unsigned llvm::DWARFContext::getNumTypeUnits ( )

inline

Get the number of type units in this context.

Definition at line 222 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumTypesUnits().

Referenced by dump().

◆ getRecoverableErrorHandler()

function_ref<void(Error)> llvm::DWARFContext::getRecoverableErrorHandler ( )

inline

Definition at line 413 of file DWARFContext.h.

Referenced by llvm::DWARFDebugAranges::generate().

◆ getRegisterInfo()

const MCRegisterInfo* llvm::DWARFContext::getRegisterInfo ( ) const

inline

Definition at line 411 of file DWARFContext.h.

Referenced by dump(), dumpLocationExpr(), and dumpLocationList().

◆ getStringDWOExtractor()

DataExtractor llvm::DWARFContext::getStringDWOExtractor ( ) const

inline

Definition at line 343 of file DWARFContext.h.

◆ getStringExtractor()

DataExtractor llvm::DWARFContext::getStringExtractor ( ) const

inline

Definition at line 340 of file DWARFContext.h.

◆ getSupportedAddressSizes()

static SmallVector<uint8_t, 3> llvm::DWARFContext::getSupportedAddressSizes ( )

inlinestatic

Definition at line 385 of file DWARFContext.h.

Referenced by checkAddressSizeSupported(), and isAddressSizeSupported().

◆ getTUIndex()

const DWARFUnitIndex & DWARFContext::getTUIndex ( )

Definition at line 795 of file DWARFContext.cpp.

References llvm::DW_SECT_EXT_TYPES, and isLittleEndian().

Referenced by getTypeUnitForHash().

◆ getTypeUnitForHash()

DWARFTypeUnit * DWARFContext::getTypeUnitForHash	(	uint16_t	Version,
		uint64_t	Hash,
		bool	IsDWO
	)

Definition at line 702 of file DWARFContext.cpp.

References dwo_units(), getTUIndex(), llvm::DWARFUnitVector::getUnitForIndexEntry(), and normal_units().

Referenced by llvm::DWARFDie::resolveTypeUnitReference().

◆ getUnitAtIndex()

DWARFUnit* llvm::DWARFContext::getUnitAtIndex ( unsigned index )

inline

Get the unit at the specified index.

Definition at line 240 of file DWARFContext.h.

References index.

Referenced by getDebugLoc().

◆ getWarningHandler()

function_ref<void(Error)> llvm::DWARFContext::getWarningHandler ( )

inline

Definition at line 417 of file DWARFContext.h.

Referenced by llvm::DWARFDebugInfoEntry::extractFast(), and llvm::DWARFDebugAranges::generate().

◆ info_section_units()

unit_iterator_range llvm::DWARFContext::info_section_units ( )

inline

Get units from .debug_info in this context.

Definition at line 148 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumInfoUnits().

Referenced by compile_units(), dump(), and getMaxVersion().

◆ isAddressSizeSupported()

static bool llvm::DWARFContext::isAddressSizeSupported ( unsigned AddressSize )

inlinestatic

Definition at line 388 of file DWARFContext.h.

References getSupportedAddressSizes(), and llvm::is_contained().

Referenced by checkAddressSizeSupported(), and llvm::DWARFDebugRangeList::RangeListEntry::isBaseAddressSelectionEntry().

◆ isLittleEndian()

bool llvm::DWARFContext::isLittleEndian ( ) const

inline

Definition at line 379 of file DWARFContext.h.

Referenced by create(), dump(), dumpLocationExpr(), llvm::DWARFDebugAranges::generate(), getAppleNames(), getAppleNamespaces(), getAppleObjC(), getAppleTypes(), getCUIndex(), getDebugAbbrev(), getDebugAbbrevDWO(), getDebugFrame(), getDebugLoc(), getDebugNames(), getEHFrame(), getLineTableForUnit(), getTUIndex(), and llvm::DWARFVerifier::handleAccelTables().

◆ isSupportedVersion()

static bool llvm::DWARFContext::isSupportedVersion ( unsigned version )

inlinestatic

Definition at line 381 of file DWARFContext.h.

References getMaxSupportedVersion().

◆ loadRegisterInfo()

Error DWARFContext::loadRegisterInfo ( const object::ObjectFile & Obj )

Loads register info for the architecture of the provided object file.

Improves readability of dumped DWARF expressions. Requires the caller to have initialized the relevant target descriptions.

Definition at line 2022 of file DWARFContext.cpp.

References llvm::Target::createMCRegInfo(), llvm::createStringError(), llvm::object::ObjectFile::getArch(), llvm::invalid_argument, llvm::TargetRegistry::lookupTarget(), llvm::Error::success(), llvm::Triple::UnknownOS, and llvm::Triple::UnknownVendor.

◆ normal_units()

unit_iterator_range llvm::DWARFContext::normal_units ( )

inline

Get all normal compile/type units in this context.

Definition at line 176 of file DWARFContext.h.

Referenced by getTypeUnitForHash().

◆ operator=()

DWARFContext& llvm::DWARFContext::operator= ( DWARFContext & )

delete

◆ setMaxVersionIfGreater()

void llvm::DWARFContext::setMaxVersionIfGreater ( unsigned Version )

inline

Definition at line 272 of file DWARFContext.h.

References llvm::IndexedInstrProf::Version.

◆ types_section_units()

unit_iterator_range llvm::DWARFContext::types_section_units ( )

inline

Get units from .debug_types in this context.

Definition at line 161 of file DWARFContext.h.

References llvm::DWARFUnitVector::getNumInfoUnits().

Referenced by dump().

◆ verify()

bool DWARFContext::verify	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts = `{}`
	)

overridevirtual

Reimplemented from llvm::DIContext.

Definition at line 767 of file DWARFContext.cpp.

References llvm::DIDumpOptions::DumpType, llvm::DWARFVerifier::handleAccelTables(), llvm::DWARFVerifier::handleDebugAbbrev(), llvm::DWARFVerifier::handleDebugCUIndex(), llvm::DWARFVerifier::handleDebugInfo(), llvm::DWARFVerifier::handleDebugLine(), llvm::DWARFVerifier::handleDebugTUIndex(), and Success.

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

include/llvm/DebugInfo/DWARF/DWARFContext.h
lib/DebugInfo/DWARF/DWARFContext.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ compile_unit_range

◆ unit_iterator_range

Member Enumeration Documentation

◆ ProcessDebugRelocations

Constructor & Destructor Documentation

◆ DWARFContext() [1/2]

◆ ~DWARFContext()

◆ DWARFContext() [2/2]

Member Function Documentation

◆ checkAddressSizeSupported()

◆ classof()

◆ clearLineTableForUnit()

◆ compile_units()

◆ create() [1/2]

◆ create() [2/2]

◆ dump() [1/2]

◆ dump() [2/2]

◆ dwo_compile_units()

◆ dwo_info_section_units()

◆ dwo_types_section_units()

◆ dwo_units()

◆ getAppleNames()

◆ getAppleNamespaces()

◆ getAppleObjC()

◆ getAppleTypes()

◆ getArch()

◆ getCompileUnitForAddress()

◆ getCompileUnitForOffset()

◆ getCUAddrSize()

◆ getCUIndex()

◆ getDebugAbbrev()

◆ getDebugAbbrevDWO()

◆ getDebugAranges()

◆ getDebugFrame()

◆ getDebugLoc()

◆ getDebugMacinfo()

◆ getDebugMacinfoDWO()

◆ getDebugMacro()

◆ getDebugMacroDWO()

◆ getDebugNames()

◆ getDIEForOffset()

◆ getDIEsForAddress()

◆ getDWARFObj()

◆ getDWOCompileUnitForHash()

◆ getDWOContext()

◆ getDWOUnitAtIndex()

◆ getDWOUnitsVector()

◆ getEHFrame()

◆ getGdbIndex()

◆ getInliningInfoForAddress()

◆ getLineInfoForAddress()

◆ getLineInfoForAddressRange()

◆ getLineInfoForDataAddress()

◆ getLineStringExtractor()

◆ getLineTableForUnit() [1/2]

◆ getLineTableForUnit() [2/2]

◆ getLocalsForAddress()

◆ getMaxDWOVersion()

◆ getMaxSupportedVersion()

◆ getMaxVersion()

◆ getNormalUnitsVector()

◆ getNumCompileUnits()

◆ getNumDWOCompileUnits()

◆ getNumDWOTypeUnits()

◆ getNumTypeUnits()

◆ getRecoverableErrorHandler()

◆ getRegisterInfo()

◆ getStringDWOExtractor()

◆ getStringExtractor()

◆ getSupportedAddressSizes()

◆ getTUIndex()

◆ getTypeUnitForHash()

◆ getUnitAtIndex()

◆ getWarningHandler()