llvm::dwarf::UnwindRow Class Reference

A class that represents a single row in the unwind table that is decoded by parsing the DWARF Call Frame Information opcodes. More...

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

Public Member Functions
	UnwindRow ()
bool	hasAddress () const
	Returns true if the address is valid in this object.
uint64_t	getAddress () const
	Get the address for this row.
void	setAddress (uint64_t Addr)
	Set the address for this UnwindRow.
void	slideAddress (uint64_t Offset)
	Offset the address for this UnwindRow.
UnwindLocation &	getCFAValue ()
const UnwindLocation &	getCFAValue () const
RegisterLocations &	getRegisterLocations ()
const RegisterLocations &	getRegisterLocations () const
void	dump (raw_ostream &OS, DIDumpOptions DumpOpts, unsigned IndentLevel=0) const
	Dump the UnwindRow to the stream.

Detailed Description

A class that represents a single row in the unwind table that is decoded by parsing the DWARF Call Frame Information opcodes.

The row consists of an optional address, the rule to unwind the CFA and all rules to unwind any registers. If the address doesn't have a value, this row represents the initial instructions for a CIE. If the address has a value the UnwindRow represents a row in the UnwindTable for a FDE. The address is the first address for which the CFA location and register rules are valid within a function.

UnwindRow objects are created by parsing opcodes in the DWARF Call Frame Information and UnwindRow objects are lazily populated and pushed onto a stack in the UnwindTable when evaluating this state machine. Accessors are needed for the address, CFA value, and register locations as the opcodes encode a state machine that produces a sorted array of UnwindRow objects

See also

UnwindTable.

Definition at line 255 of file DWARFDebugFrame.h.

Constructor & Destructor Documentation

UnwindRow()

llvm::dwarf::UnwindRow::UnwindRow ( )

inline

Definition at line 263 of file DWARFDebugFrame.h.

Member Function Documentation

dump()

void UnwindRow::dump	(	raw_ostream &	OS,
		DIDumpOptions	DumpOpts,
		unsigned	IndentLevel = 0
	)		const

Dump the UnwindRow to the stream.

Parameters

OS	the stream to use for output.
MRI	register information that helps emit register names insteead of raw register numbers.
IsEH	true if the DWARF Call Frame Information is from .eh_frame instead of from .debug_frame. This is needed for register number conversion because some register numbers differ between the two sections for certain architectures like x86.
IndentLevel	specify the indent level as an integer. The UnwindRow will be output to the stream preceded by 2 * IndentLevel number of spaces.

Definition at line 171 of file DWARFDebugFrame.cpp.

References llvm::dwarf::UnwindLocation::dump(), llvm::dwarf::RegisterLocations::dump(), llvm::format(), hasAddress(), llvm::dwarf::RegisterLocations::hasLocations(), llvm::raw_ostream::indent(), and OS.

getAddress()

uint64_t llvm::dwarf::UnwindRow::getAddress ( ) const

inline

Get the address for this row.

Clients should only call this function after verifying it has a valid address with a call to

See also

hasAddress().

Definition at line 272 of file DWARFDebugFrame.h.

References Address.

getCFAValue() [1/2]

UnwindLocation & llvm::dwarf::UnwindRow::getCFAValue ( )

inline

Definition at line 287 of file DWARFDebugFrame.h.

getCFAValue() [2/2]

const UnwindLocation & llvm::dwarf::UnwindRow::getCFAValue ( ) const

inline

Definition at line 288 of file DWARFDebugFrame.h.

getRegisterLocations() [1/2]

RegisterLocations & llvm::dwarf::UnwindRow::getRegisterLocations ( )

inline

Definition at line 289 of file DWARFDebugFrame.h.

getRegisterLocations() [2/2]

const RegisterLocations & llvm::dwarf::UnwindRow::getRegisterLocations ( ) const

inline

Definition at line 290 of file DWARFDebugFrame.h.

hasAddress()

bool llvm::dwarf::UnwindRow::hasAddress ( ) const

inline

Returns true if the address is valid in this object.

Definition at line 266 of file DWARFDebugFrame.h.

References Address.

Referenced by dump().

setAddress()

void llvm::dwarf::UnwindRow::setAddress ( uint64_t  Addr )

inline

Set the address for this UnwindRow.

The address represents the first address for which the CFAValue and RegLocs are valid within a function.

Definition at line 278 of file DWARFDebugFrame.h.

References Addr, and Address.

slideAddress()

void llvm::dwarf::UnwindRow::slideAddress ( uint64_t  Offset )

inline

Offset the address for this UnwindRow.

The address represents the first address for which the CFAValue and RegLocs are valid within a function. Clients must ensure that this object already has an address (

See also

hasAddress()) prior to calling this function.

Definition at line 286 of file DWARFDebugFrame.h.

References Address, and llvm::Offset.

---

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

• include/llvm/DebugInfo/DWARF/DWARFDebugFrame.h
• lib/DebugInfo/DWARF/DWARFDebugFrame.cpp