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
• the Solaris stack generation is adapted from a 1995 post on comp.unix.solaris by Bart Smaalders, http://groups.google.com/group/comp.unix.solaris/browse_thread/thread/8b9f3de8be288f1c/31550f93a48231d5?lnk=gst&q=how+to+get+stack+trace+on+solaris+group:comp.unix.solaris#31550f93a48231d5
• 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

#define LINK	(		TYPE,
			NAME
	)

Value:

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

#define LINK_T

(

NAME

)

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

#define MAXTEXT   5000

#define SYMSIZE   100

Typedef Documentation

typedef struct _dbghelp_functions dbghelp_functions

Function Documentation

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

static

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

static

static size_t determine_starting_frame ( ssize_t  initial_frame, ssize_t  offset  )

inlinestatic

static void emptyStack ( )

static

static bool load_dbghelp_library_if_needed ( dbghelp_functions *  pDbg )

static