38 lines
1.1 KiB
C++
38 lines
1.1 KiB
C++
|
/** Provides stack walking facilities exploiting the eh_elf objects, that can
|
||
|
|
* be loaded at runtime. */
|
||
|
|
|
||
|
|
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#include <cstdint>
|
||
|
|
#include <functional>
|
||
|
|
|
||
|
|
#include "../shared/context_struct.h"
|
||
|
|
|
||
|
|
|
||
|
|
/** Initialize the stack walker. This must be called only once.
|
||
|
|
*
|
||
|
|
* \return true iff everything was correctly initialized.
|
||
|
|
*/
|
||
|
|
bool stack_walker_init();
|
||
|
|
|
||
|
|
/** Deallocate everything that was allocated by the stack walker */
|
||
|
|
void stack_walker_close();
|
||
|
|
|
||
|
|
/** Get the unwind context of the point from which this function was called.
|
||
|
|
*
|
||
|
|
* This context must then be exploited straight away: it is unsafe to alter the
|
||
|
|
* call stack before using it, in particular by returning from the calling
|
||
|
|
* function. */
|
||
|
|
unwind_context_t get_context();
|
||
|
|
|
||
|
|
/** Unwind the passed context once, in place.
|
||
|
|
*
|
||
|
|
* Returns `true` if the context was actually unwinded, or `false` if the end
|
||
|
|
* of the call stack was reached. */
|
||
|
|
bool unwind_context(unwind_context_t& ctx);
|
||
|
|
|
||
|
|
/** Call the passed function once per frame in the call stack, most recent
|
||
|
|
* frame first, with the current context as its sole argument. */
|
||
|
|
void walk_stack(const std::function<void(const unwind_context_t&)>& mapped);
|