DwarfInterpret Class Reference

Classes
class	ExoticRegister
class	FailedGetContext
	Thrown when somehow, getcontext (read CPU registers) fails. More...
class	FirstUnwindFrame
	Thrown when trying to unwind a context with nothing more to unwind. More...
class	InvalidElf
class	NoDebugData
class	NoElfForPC
class	NotFound
	Thrown when a Dwarf element is not found for a given PC. More...
class	NotImplemented
	Thrown when accessing unimplemented parts of this library. More...
struct	UnwindContext
class	ValuelessRegister
class	WhatException

Public Types
typedef dwarf::core::FrameSection::register_def	DwarfRegister
	A Dwarf register.
typedef std::set< std::pair< int, DwarfRegister > >	DwarfRow
	A Dwarf row of registers (for a given PC)
typedef uintptr_t	reg_content_t
	The value type of a register's contents.

Public Member Functions
	DwarfInterpret (DwarfInterpret const &)=delete
void	operator= (DwarfInterpret const &)=delete
DwarfRow	dwarf_row_at (uintptr_t pc) const
reg_content_t	interpret_dw_register (const DwarfRow &row, const DwarfRegister &reg, const UnwindContext &ctx) const
reg_content_t	interpret_dw_register (const DwarfRow &row, int reg_id, const UnwindContext &ctx) const
UnwindContext	unwind_context (const UnwindContext &ctx)

Static Public Member Functions
static DwarfInterpret &	acquire ()
static DwarfInterpret &	acquire (uintptr_t pc)
static UnwindContext	get_current_unwind_context ()

Friends
class	std::unique_ptr< DwarfInterpret >

Member Function Documentation

acquire() [1/2]

DwarfInterpret & DwarfInterpret::acquire ( )

static

Acquire the anonymous instance of DwarfInterpret, which works on the empty memory range. Acts as a handle: passes every call to some other instance

acquire() [2/2]

DwarfInterpret & DwarfInterpret::acquire ( uintptr_t  pc )

static

Acquire the relevant instance of DwarfInterpret for the given program counter. Instanciate it if needed.

dwarf_row_at()

DwarfInterpret::DwarfRow DwarfInterpret::dwarf_row_at

(

uintptr_t

pc

)

const

Get the Dwarf registers row at the given PC.

Exceptions

NotFound

if for some reason, the Dwarf row cannot be accessed at this PC.

get_current_unwind_context()

DwarfInterpret::UnwindContext DwarfInterpret::get_current_unwind_context ( )

static

Get the current UnwindContext (from the caller's point of view)

WARNING! This context will be valid within the call frame of the caller, and within descendant calls from this function, but will most probably be invalid and result in weird behaviours if there is only a single return made!

This is supposed to work:

void foo() {
    UnwindContext context = get_current_unwind_context();
    // have fun with context
}

While this will probably crash:

UnwindContext wrap_get_context() {
    return f(get_current_unwind_context());
}
void foo() {
    UnwindContext context = wrap_get_context();
    // have fun with context
}

interpret_dw_register() [1/2]

DwarfInterpret::reg_content_t DwarfInterpret::interpret_dw_register	(	const DwarfRow &	row,
		const DwarfRegister &	reg,
		const UnwindContext &	ctx
	)		const

Retrieves the value pointed to by the given Dwarf register

Exceptions

ValuelessRegister

interpret_dw_register() [2/2]

DwarfInterpret::reg_content_t DwarfInterpret::interpret_dw_register	(	const DwarfRow &	row,
		int	reg_id,
		const UnwindContext &	ctx
	)		const

Retrieves the value pointed to by the given Dwarf register

Exceptions

ValuelessRegister

unwind_context()

DwarfInterpret::UnwindContext DwarfInterpret::unwind_context

(

const UnwindContext &

ctx

)

Unwinds once the given context

Exceptions

FirstUnwindFrame

when trying to unwind the first frame.

---

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

• include/dwarfinterpret/DwarfInterpret.hpp
• src/DwarfInterpret.cpp