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

Classes
struct	UnitOffset

Public Types
enum	FormClass { FC_Unknown, FC_Address, FC_Block, FC_Constant, FC_String, FC_Flag, FC_Reference, FC_Indirect, FC_SectionOffset, FC_Exprloc }

Public Member Functions
	DWARFFormValue (dwarf::Form F=dwarf::Form(0))

dwarf::Form	getForm () const

uint64_t	getRawUValue () const

bool	isFormClass (FormClass FC) const

const DWARFUnit *	getUnit () const

void	dump (raw_ostream &OS, DIDumpOptions DumpOpts=DIDumpOptions()) const

void	dumpSectionedAddress (raw_ostream &OS, DIDumpOptions DumpOpts, object::SectionedAddress SA) const

void	dumpAddress (raw_ostream &OS, uint64_t Address) const

bool	extractValue (const DWARFDataExtractor &Data, uint64_t OffsetPtr, dwarf::FormParams FormParams, const DWARFContext Context=nullptr, const DWARFUnit *Unit=nullptr)
	Extracts a value in `Data` at offset `*OffsetPtr`. More...

bool	extractValue (const DWARFDataExtractor &Data, uint64_t OffsetPtr, dwarf::FormParams FormParams, const DWARFUnit U)

Optional< uint64_t >	getAsReference () const
	getAsFoo functions below return the extracted value as Foo if only DWARFFormValue has form class is suitable for representing Foo. More...

Optional< UnitOffset >	getAsRelativeReference () const

Optional< uint64_t >	getAsUnsignedConstant () const

Optional< int64_t >	getAsSignedConstant () const

Expected< const char * >	getAsCString () const

Optional< uint64_t >	getAsAddress () const

Optional< object::SectionedAddress >	getAsSectionedAddress () const

Optional< uint64_t >	getAsSectionOffset () const

Optional< ArrayRef< uint8_t > >	getAsBlock () const

Optional< uint64_t >	getAsCStringOffset () const

Optional< uint64_t >	getAsReferenceUVal () const

Optional< std::string >	getAsFile (DILineInfoSpecifier::FileLineInfoKind Kind) const
	Correctly extract any file paths from a form value. More...

bool	skipValue (DataExtractor DebugInfoData, uint64_t *OffsetPtr, const dwarf::FormParams Params) const
	Skip a form's value in `DebugInfoData` at the offset specified by `OffsetPtr`. More...

Static Public Member Functions
static DWARFFormValue	createFromSValue (dwarf::Form F, int64_t V)

static DWARFFormValue	createFromUValue (dwarf::Form F, uint64_t V)

static DWARFFormValue	createFromPValue (dwarf::Form F, const char *V)

static DWARFFormValue	createFromBlockValue (dwarf::Form F, ArrayRef< uint8_t > D)

static DWARFFormValue	createFromUnit (dwarf::Form F, const DWARFUnit Unit, uint64_t OffsetPtr)

static void	dumpAddress (raw_ostream &OS, uint8_t AddressSize, uint64_t Address)

static void	dumpAddressSection (const DWARFObject &Obj, raw_ostream &OS, DIDumpOptions DumpOpts, uint64_t SectionIndex)

static bool	skipValue (dwarf::Form Form, DataExtractor DebugInfoData, uint64_t *OffsetPtr, const dwarf::FormParams FormParams)
	Skip a form's value in `DebugInfoData` at the offset specified by `OffsetPtr`. More...

Detailed Description

Definition at line 28 of file DWARFFormValue.h.

Member Enumeration Documentation

◆ FormClass

enum llvm::DWARFFormValue::FormClass

Enumerator
FC_Unknown
FC_Address
FC_Block
FC_Constant
FC_String
FC_Flag
FC_Reference
FC_Indirect
FC_SectionOffset
FC_Exprloc

Definition at line 30 of file DWARFFormValue.h.

Constructor & Destructor Documentation

◆ DWARFFormValue()

llvm::DWARFFormValue::DWARFFormValue ( dwarf::Form F = dwarf::Form(0) )

inline

Definition at line 69 of file DWARFFormValue.h.

Member Function Documentation

◆ createFromBlockValue()

DWARFFormValue DWARFFormValue::createFromBlockValue	(	dwarf::Form	F,
		ArrayRef< uint8_t >	D
	)

static

Definition at line 96 of file DWARFFormValue.cpp.

References D, and F.

◆ createFromPValue()

DWARFFormValue DWARFFormValue::createFromPValue	(	dwarf::Form	F,
		const char *	V
	)

static

Definition at line 92 of file DWARFFormValue.cpp.

References F.

Referenced by llvm::DWARFDebugLine::LineTable::parse().

◆ createFromSValue()

DWARFFormValue DWARFFormValue::createFromSValue	(	dwarf::Form	F,
		int64_t	V
	)

static

Definition at line 84 of file DWARFFormValue.cpp.

References F.

Referenced by llvm::DWARFAbbreviationDeclaration::getAttributeValueFromOffset().

◆ createFromUnit()

DWARFFormValue DWARFFormValue::createFromUnit	(	dwarf::Form	F,
		const DWARFUnit *	Unit,
		uint64_t *	OffsetPtr
	)

static

Definition at line 104 of file DWARFFormValue.cpp.

References extractValue(), F, llvm::DWARFUnit::getDebugInfoExtractor(), and llvm::DWARFUnit::getFormParams().

◆ createFromUValue()

DWARFFormValue DWARFFormValue::createFromUValue	(	dwarf::Form	F,
		uint64_t	V
	)

static

Definition at line 88 of file DWARFFormValue.cpp.

References F.

Referenced by dumpAttribute().

◆ dump()

void DWARFFormValue::dump	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts = `DIDumpOptions()`
	)		const

Definition at line 409 of file DWARFFormValue.cpp.

References llvm::Address, llvm::format(), llvm::WithColor::get(), llvm::dwarf::getDwarfOffsetByteSize(), llvm::None, llvm::nulls(), llvm::DIDumpOptions::ShowAddresses, llvm::DIDumpOptions::Verbose, and llvm::raw_ostream::write_escaped().

Referenced by llvm::DWARFDebugLine::Prologue::dump(), dumpAttribute(), and dumpLocationList().

◆ dumpAddress() [1/2]

void llvm::DWARFFormValue::dumpAddress	(	raw_ostream &	OS,
		uint64_t	Address
	)		const

Referenced by llvm::DWARFDebugArangeSet::Descriptor::dump(), llvm::DWARFAddressRange::dump(), dumpAttribute(), and llvm::DWARFDebugLine::LineTable::parse().

◆ dumpAddress() [2/2]

void DWARFFormValue::dumpAddress	(	raw_ostream &	OS,
		uint8_t	AddressSize,
		uint64_t	Address
	)

static

Definition at line 380 of file DWARFFormValue.cpp.

References llvm::format().

◆ dumpAddressSection()

void DWARFFormValue::dumpAddressSection	(	const DWARFObject &	Obj,
		raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		uint64_t	SectionIndex
	)

static

Definition at line 394 of file DWARFFormValue.cpp.

References llvm::format(), llvm::DWARFObject::getSectionNames(), and llvm::DIDumpOptions::Verbose.

Referenced by llvm::DWARFAddressRange::dump().

◆ dumpSectionedAddress()

void DWARFFormValue::dumpSectionedAddress	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		object::SectionedAddress	SA
	)		const

Definition at line 386 of file DWARFFormValue.cpp.

References llvm::object::SectionedAddress::Address, and llvm::object::SectionedAddress::SectionIndex.

◆ extractValue() [1/2]

bool DWARFFormValue::extractValue	(	const DWARFDataExtractor &	Data,
		uint64_t *	OffsetPtr,
		dwarf::FormParams	FormParams,
		const DWARFContext *	Context = `nullptr`,
		const DWARFUnit *	Unit = `nullptr`
	)

Extracts a value in Data at offset *OffsetPtr.

The information in FormParams is needed to interpret some forms. The optional Context and Unit allows extracting information if the form refers to other sections (e.g., .debug_str).

Definition at line 248 of file DWARFFormValue.cpp.

References FP.

Referenced by createFromUnit(), extractValue(), llvm::DWARFAbbreviationDeclaration::getAttributeValueFromOffset(), and llvm::AppleAcceleratorTable::readAtoms().

◆ extractValue() [2/2]

bool llvm::DWARFFormValue::extractValue	(	const DWARFDataExtractor &	Data,
		uint64_t *	OffsetPtr,
		dwarf::FormParams	FormParams,
		const DWARFUnit *	U
	)

inline

Definition at line 102 of file DWARFFormValue.h.

References llvm::Data, and extractValue().

◆ getAsAddress()

Optional< uint64_t > DWARFFormValue::getAsAddress ( ) const

Definition at line 669 of file DWARFFormValue.cpp.

References llvm::None.

Referenced by dumpAttribute().

◆ getAsBlock()

Optional< ArrayRef< uint8_t > > DWARFFormValue::getAsBlock ( ) const

Definition at line 754 of file DWARFFormValue.cpp.

References llvm::makeArrayRef(), and llvm::None.

Referenced by dumpLocationExpr().

◆ getAsCString()

Expected< const char * > DWARFFormValue::getAsCString ( ) const

Definition at line 628 of file DWARFFormValue.cpp.

References llvm::dwarf::FormEncodingString(), llvm::DataExtractor::getCStr(), llvm::inconvertibleErrorCode(), llvm::AMDGPU::SendMsg::Msg, llvm::StringRef::str(), and llvm::Expected< T >::takeError().

◆ getAsCStringOffset()

Optional< uint64_t > DWARFFormValue::getAsCStringOffset ( ) const

Definition at line 761 of file DWARFFormValue.cpp.

References llvm::None.

◆ getAsFile()

Optional< std::string > DWARFFormValue::getAsFile ( DILineInfoSpecifier::FileLineInfoKind Kind ) const

Correctly extract any file paths from a form value.

These attributes can be in the from DW_AT_decl_file or DW_AT_call_file attributes. We need to use the file index in the correct DWARFUnit's line table prologue, and each DWARFFormValue has the DWARFUnit the form value was extracted from.

Parameters

Kind	The kind of path to extract.

Returns: A valid string value on success, or llvm::None if the form class is not FC_Constant, or if the file index is not valid.

Definition at line 774 of file DWARFFormValue.cpp.

References llvm::DWARFUnit::getCompilationDir(), llvm::DWARFUnit::getContext(), llvm::DWARFContext::getLineTableForUnit(), llvm::AArch64CC::LT, and llvm::None.

◆ getAsReference()

Optional< uint64_t > DWARFFormValue::getAsReference ( ) const

getAsFoo functions below return the extracted value as Foo if only DWARFFormValue has form class is suitable for representing Foo.

Definition at line 695 of file DWARFFormValue.cpp.

References llvm::None.

◆ getAsReferenceUVal()

Optional< uint64_t > DWARFFormValue::getAsReferenceUVal ( ) const

Definition at line 767 of file DWARFFormValue.cpp.

References llvm::None.

◆ getAsRelativeReference()

Optional< DWARFFormValue::UnitOffset > DWARFFormValue::getAsRelativeReference ( ) const

Definition at line 701 of file DWARFFormValue.cpp.

References llvm::None.

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

◆ getAsSectionedAddress()

Optional< object::SectionedAddress > DWARFFormValue::getAsSectionedAddress ( ) const

Definition at line 676 of file DWARFFormValue.cpp.

References llvm::object::SectionedAddress::Address, if(), and llvm::None.

◆ getAsSectionOffset()

Optional< uint64_t > DWARFFormValue::getAsSectionOffset ( ) const

Definition at line 722 of file DWARFFormValue.cpp.

References llvm::None.

Referenced by dumpAttribute(), and dumpLocationList().

◆ getAsSignedConstant()

Optional< int64_t > DWARFFormValue::getAsSignedConstant ( ) const

Definition at line 735 of file DWARFFormValue.cpp.

References llvm::max(), and llvm::None.

◆ getAsUnsignedConstant()

Optional< uint64_t > DWARFFormValue::getAsUnsignedConstant ( ) const

Definition at line 728 of file DWARFFormValue.cpp.

References llvm::None.

Referenced by dumpAttribute(), and llvm::AppleAcceleratorTable::readAtoms().

◆ getForm()

dwarf::Form llvm::DWARFFormValue::getForm ( ) const

inline

Definition at line 79 of file DWARFFormValue.h.

Referenced by dumpAttribute(), dumpLocationList(), and llvm::AppleAcceleratorTable::validateForms().

◆ getRawUValue()

uint64_t llvm::DWARFFormValue::getRawUValue ( ) const

inline

Definition at line 80 of file DWARFFormValue.h.

◆ getUnit()

const DWARFUnit* llvm::DWARFFormValue::getUnit ( ) const

inline

Definition at line 83 of file DWARFFormValue.h.

◆ isFormClass()

bool DWARFFormValue::isFormClass ( DWARFFormValue::FormClass FC ) const

Definition at line 216 of file DWARFFormValue.cpp.

References DWARF5FormClasses, R600_InstFlag::FC, llvm::makeArrayRef(), and llvm::size().

Referenced by dumpAttribute(), dumpLocationExpr(), dumpLocationList(), llvm::shouldSkipAttribute(), and llvm::AppleAcceleratorTable::validateForms().

◆ skipValue() [1/2]

bool llvm::DWARFFormValue::skipValue	(	DataExtractor	DebugInfoData,
		uint64_t *	OffsetPtr,
		const dwarf::FormParams	Params
	)		const

inline

Skip a form's value in DebugInfoData at the offset specified by OffsetPtr.

Skips the bytes for the current form and updates the offset.

Parameters

DebugInfoData	The data where we want to skip the value.
OffsetPtr	A reference to the offset that will be updated.
Params	DWARF parameters to help interpret forms.

Returns: true on success, false if the form was not skipped.

Definition at line 147 of file DWARFFormValue.h.

Referenced by llvm::DWARFDebugInfoEntry::extractFast(), llvm::DWARFAbbreviationDeclaration::getAttributeOffsetFromIndex(), and getCUIdentifiers().

◆ skipValue() [2/2]

bool DWARFFormValue::skipValue	(	dwarf::Form	Form,
		DataExtractor	DebugInfoData,
		uint64_t *	OffsetPtr,
		const dwarf::FormParams	FormParams
	)

static

Skip a form's value in DebugInfoData at the offset specified by OffsetPtr.

Skips the bytes for the specified form and updates the offset.

Parameters

Form	The DW_FORM enumeration that indicates the form to skip.
DebugInfoData	The data where we want to skip the value.
OffsetPtr	A reference to the offset that will be updated.
FormParams	DWARF parameters to help interpret forms.

Returns: true on success, false if the form was not skipped.

Definition at line 112 of file DWARFFormValue.cpp.

References llvm::DataExtractor::getCStr(), llvm::dwarf::getFixedFormByteSize(), llvm::DataExtractor::getSLEB128(), llvm::DataExtractor::getU16(), llvm::DataExtractor::getU32(), llvm::DataExtractor::getU8(), llvm::DataExtractor::getULEB128(), and llvm::size().

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

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ FormClass

Constructor & Destructor Documentation

◆ DWARFFormValue()

Member Function Documentation

◆ createFromBlockValue()

◆ createFromPValue()

◆ createFromSValue()

◆ createFromUnit()

◆ createFromUValue()

◆ dump()

◆ dumpAddress() [1/2]

◆ dumpAddress() [2/2]

◆ dumpAddressSection()

◆ dumpSectionedAddress()

◆ extractValue() [1/2]

◆ extractValue() [2/2]

◆ getAsAddress()

◆ getAsBlock()

◆ getAsCString()

◆ getAsCStringOffset()

◆ getAsFile()

◆ getAsReference()

◆ getAsReferenceUVal()

◆ getAsRelativeReference()

◆ getAsSectionedAddress()

◆ getAsSectionOffset()

◆ getAsSignedConstant()

◆ getAsUnsignedConstant()

◆ getForm()

◆ getRawUValue()

◆ getUnit()

◆ isFormClass()

◆ skipValue() [1/2]

◆ skipValue() [2/2]