Stack_Trace.cpp File Reference

Encapsulate string representation of stack trace. More...

#include "ace/Stack_Trace.h"
#include "ace/Min_Max.h"
#include "ace/OS_NS_string.h"
#include "ace/OS_NS_stdio.h"
#include <windows.h>
#include <Dbghelp.h>

Classes
struct	_dbghelp_functions
struct	frame_state

Macros
#define	MAXTEXT   5000
#define	SYMSIZE   100
#define	LINK(TYPE, NAME)
#define	LINK_T(NAME)   LINK (dbghelp_functions::NAME##_t, NAME)

Typedefs
typedef struct _dbghelp_functions	dbghelp_functions

Functions
static size_t	determine_starting_frame (ssize_t initial_frame, ssize_t offset)
static bool	load_dbghelp_library_if_needed (dbghelp_functions *pDbg)
static int	add_frame_to_buf (struct frame_state const *fs, void *usrarg)
static void	emptyStack ()
static int	cs_operate (int(*func)(struct frame_state const *, void *), void *usrarg, size_t starting_frame, size_t num_frames)

Detailed Description

Encapsulate string representation of stack trace.

Some platform-specific areas of this code have been adapted from examples found elsewhere. Specifically,

• the GLIBC stack generation uses the documented "backtrace" API and is adapted from examples shown in relevant documentation and repeated elsewhere, e.g., http://www.linuxselfhelp.com/gnu/glibc/html_chapter/libc_33.html
• VxWorks kernel-mode stack tracing is adapted from a code example in the VxWorks FAQ at http://www.xs4all.nl/~borkhuis/vxworks/vxw_pt5.html although the undocumented functions it uses are also mentioned in various documents available on the WindRiver support website.

If you add support for a new platform, please add a bullet to the above list with durable references to the origins of your code.

Macro Definition Documentation

LINK

#define LINK	(		TYPE,
			NAME )

Value:

    (pDbg->NAME = \
    (TYPE) GetProcAddress (pDbg->hMod, #NAME))

LINK_T

#define LINK_T

(

NAME

)

LINK (dbghelp_functions::NAME##_t, NAME)

MAXTEXT

#define MAXTEXT   5000

SYMSIZE

#define SYMSIZE   100

Typedef Documentation

dbghelp_functions

typedef struct _dbghelp_functions dbghelp_functions

Function Documentation

add_frame_to_buf()

static int add_frame_to_buf ( struct frame_state const * fs, void * usrarg )

static

cs_operate()

static int cs_operate ( int(*)(struct frame_state const *, void *) func, void * usrarg, size_t starting_frame, size_t num_frames )

static

determine_starting_frame()

static size_t determine_starting_frame ( ssize_t initial_frame, ssize_t offset )

inlinestatic

emptyStack()

static void emptyStack ( )

static

load_dbghelp_library_if_needed()

static bool load_dbghelp_library_if_needed ( dbghelp_functions * pDbg )

static