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
Defines
#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.

Id:

Stack_Trace.cpp 95534 2012-02-17 23:19:33Z mitza

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.

---

Define 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
	)		[inline, static]

static void emptyStack

(

)

[static]

static bool load_dbghelp_library_if_needed

(

dbghelp_functions *

pDbg

)

[static]