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

std::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...

std::optional< UnitOffset >	getAsRelativeReference () const

std::optional< uint64_t >	getAsUnsignedConstant () const

std::optional< int64_t >	getAsSignedConstant () const

Expected< const char * >	getAsCString () const

std::optional< uint64_t >	getAsAddress () const

std::optional< object::SectionedAddress >	getAsSectionedAddress () const

std::optional< uint64_t >	getAsSectionOffset () const

std::optional< ArrayRef< uint8_t > >	getAsBlock () const

std::optional< uint64_t >	getAsCStringOffset () const

std::optional< uint64_t >	getAsReferenceUVal () const

std::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 26 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 28 of file DWARFFormValue.h.

Constructor & Destructor Documentation

◆ DWARFFormValue()

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

inline

Definition at line 67 of file DWARFFormValue.h.

Member Function Documentation

◆ createFromBlockValue()

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

static

Definition at line 94 of file DWARFFormValue.cpp.

References D, and F.

◆ createFromPValue()

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

static

Definition at line 90 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 82 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 102 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 86 of file DWARFFormValue.cpp.

References F.

Referenced by dumpAttribute().

◆ dump()

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

Definition at line 407 of file DWARFFormValue.cpp.

References llvm::Address, llvm::format(), llvm::WithColor::get(), llvm::dwarf::getDwarfOffsetByteSize(), 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 378 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 392 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 384 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 246 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 100 of file DWARFFormValue.h.

References llvm::Data, and extractValue().

◆ getAsAddress()

std::optional< uint64_t > DWARFFormValue::getAsAddress ( ) const

Definition at line 669 of file DWARFFormValue.cpp.

Referenced by dumpAttribute().

◆ getAsBlock()

std::optional< ArrayRef< uint8_t > > DWARFFormValue::getAsBlock ( ) const

Definition at line 756 of file DWARFFormValue.cpp.

References llvm::ArrayRef().

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

std::optional< uint64_t > DWARFFormValue::getAsCStringOffset ( ) const

Definition at line 763 of file DWARFFormValue.cpp.

◆ getAsFile()

std::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 std::nullopt if the form class is not FC_Constant, or if the file index is not valid.

Definition at line 776 of file DWARFFormValue.cpp.

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

◆ getAsReference()

std::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 696 of file DWARFFormValue.cpp.

◆ getAsReferenceUVal()

std::optional< uint64_t > DWARFFormValue::getAsReferenceUVal ( ) const

Definition at line 769 of file DWARFFormValue.cpp.

◆ getAsRelativeReference()

std::optional< DWARFFormValue::UnitOffset > DWARFFormValue::getAsRelativeReference ( ) const

Definition at line 703 of file DWARFFormValue.cpp.

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

◆ getAsSectionedAddress()

std::optional< object::SectionedAddress > DWARFFormValue::getAsSectionedAddress ( ) const

Definition at line 676 of file DWARFFormValue.cpp.

References if().

◆ getAsSectionOffset()

std::optional< uint64_t > DWARFFormValue::getAsSectionOffset ( ) const

Definition at line 724 of file DWARFFormValue.cpp.

Referenced by dumpAttribute(), and dumpLocationList().

◆ getAsSignedConstant()

std::optional< int64_t > DWARFFormValue::getAsSignedConstant ( ) const

Definition at line 737 of file DWARFFormValue.cpp.

References llvm::max().

◆ getAsUnsignedConstant()

std::optional< uint64_t > DWARFFormValue::getAsUnsignedConstant ( ) const

Definition at line 730 of file DWARFFormValue.cpp.

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

◆ getForm()

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

inline

Definition at line 77 of file DWARFFormValue.h.

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

◆ getRawUValue()

uint64_t llvm::DWARFFormValue::getRawUValue ( ) const

inline

Definition at line 78 of file DWARFFormValue.h.

◆ getUnit()

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

inline

Definition at line 81 of file DWARFFormValue.h.

◆ isFormClass()

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

Definition at line 214 of file DWARFFormValue.cpp.

References llvm::ArrayRef(), DWARF5FormClasses, R600_InstFlag::FC, 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 145 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 110 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]