StackTracer库使用指南与堆栈跟踪技术.pdfVIP

使用StackTracer库

作者：DavidL.Koenig高级软件工程

师TouchdownEntertainment,

Inc.

本文档旨在让开发者熟悉在JupiterSDK的第69版中新增的StackTracer库。该库使开发者能

够在项目的任何位置生成程序堆栈。这可以用于创建更具信息量的断言、记录特定函数的执行

路径，或者由开发者定义的任何其他用途。

.

该库位于SDK安装目录根路径下的“Libs\StackTracer”文件夹中

在SDK的根目录中有一个演示示例位于“Samp\debug\StackTrace”。该库在ltclientshell.cpp的

OnCommandOn()函数中使用。

首先，你需要做的是在每个项目中启用调试信息（PDB文件）的生成。这需要对每个EXE和DLL进行设置。

对于每个DLL

StackTracer类

•StackTracer–创建堆栈的主要接口。

•StackTrace–用于一个完整的堆栈。

•SymbolDetails–用于给定地址的详细信息。

基本使用步骤

•获取当前堆栈。

•加载所有项目二进制文件的调试符号。

•查找每个条目的详细信息

•卸载符号以清理内存。

获取完整堆栈:StackTracer

stackTrace

r;StackTrace;

stackTracer.DoStackTrace(trace);

加载符号：

stackTracer.加载dSymbolsInDir(目录名称,文件扩展名);

示例：stackTracer.LoadSymbolsInDir(debug_symbols,exe,dll,lto,fxd);

UsingtheStackTracerLibrary

By:DavidL.Koenig

SeniorSoftwareEngineer

TouchdownEntertainment,Inc.

August8,2005

ThepurposeofthisdocumentistofamiliarizedeveloperswiththenewStackTracerlibrarymade

availableinbuild69oftheJupiterSDK.Thislibraryenabdeveloperstocreateaprogramstack

traceatanypointwithintheirproject.Thiscanbeusedforcreatingmoreinformativeassertions,

loggingexecutionpathsforgivenfunctions,oranypurposedefinedbythedeveloper.

Thelibraryislocatedinthe“Libs\StackTracer”directoryintherootoftheSDKinstallation.

Thereisademonstrationsamplelocatedin“Samp\debug\StackTrace”intherootoftheSDK

installation.Thelibraryisusedinltclientshell.cppintheOnCommandOn()function.