stack.h

Go to the documentation of this file.

/* KallistiOS ##version##
 
   arch/dreamcast/include/arch/stack.h
   (c)2002 Megan Potter
 
*/
 
/** \file    arch/stack.h
    \brief   Stack tracing.
    \ingroup debugging_stacktrace
 
    The functions in this file deal with doing stack traces. These functions
    will do a stack trace, as specified, printing it out to stdout (usually a
    dcload terminal). These functions only work if frame pointers have been
    enabled at compile time (-DFRAME_POINTERS and no -fomit-frame-pointer flag).
 
    \author Megan Potter
*/
 
#ifndef __ARCH_STACK_H
#define __ARCH_STACK_H
 
#include <sys/cdefs.h>
__BEGIN_DECLS
 
#include <arch/types.h>
 
/** \defgroup debugging_stacktrace  Stack Traces
    \brief                          API for managing stack backtracing
    \ingroup                        debugging
 
    @{
*/
 
/** \brief  Do a stack trace from the current function.
 
    This function does a stack trace from the current function, printing the
    results to stdout. This is used, for instance, when an assertion fails in
    assert().
 
    \param  n               The number of frames to leave off. Each frame is a
                            jump to subroutine or branch to subroutine. assert()
                            leaves off 2 frames, for reference.
*/
void arch_stk_trace(int n);
 
/** \brief  Do a stack trace from the current function.
 
    This function does a stack trace from the the specified frame pointer,
    printing the results to stdout. This could be used for doing something like
    stack tracing a main thread from inside an IRQ handler.
 
    \param  fp              The frame pointer to start from.
    \param  n               The number of frames to leave off.
*/
void arch_stk_trace_at(uint32_t fp, size_t n);
 
/** @} */
 
__END_DECLS
 
#endif  /* __ARCH_EXEC_H */