MiniDumpWriteDump是MS DbgHelp.dll 中一個(gè)API, 用于導(dǎo)出當(dāng)前運(yùn)行的程序的Dump. 這個(gè)dll程序系統(tǒng)中就有, 但是很多軟件, 都在自己的安裝目錄下保存了這個(gè).dll的最新的版本.
為了測(cè)試這個(gè)API, 參考網(wǎng)上一些資料, 寫(xiě)了一個(gè)簡(jiǎn)單的C++ 程序. 目的是當(dāng)有異常發(fā)生的時(shí)候, 自動(dòng)生成Dump文件供之后的分析. 有了Dump文件, 我們就可以使用WinDBG等調(diào)試器來(lái)分析異常發(fā)生時(shí)的情況. 其實(shí)這個(gè)功能很多軟件都有, 比如QQ, 魔獸世界, 等等. 它們?cè)诔霈F(xiàn)了異常的時(shí)候會(huì)彈出一個(gè)對(duì)話框, 讓用戶輸入異常發(fā)生時(shí)的情況, 然后把異常的dump文件用email發(fā)回, 供開(kāi)發(fā)者們分析修改bug.
不過(guò)有一點(diǎn), 這里需要程序的調(diào)試符號(hào)文件(pdb文件). 對(duì)于Debug版來(lái)說(shuō), 是生成的, 但是Release版來(lái)說(shuō)默認(rèn)是不生成的. 可以設(shè)置VC的編譯器, 讓它在Release版的時(shí)候也生成調(diào)試信息. 這帶來(lái)一個(gè)新的問(wèn)題, 因?yàn)?span lang="EN-US">.pdb里面是保存了源文件的信息的, 為了避免泄密, 可以采用VS中的CVPack工具, 從中去除敏感的信息.
程序需要使用Dbghelp.h 和 Dbghelp.lib . 它們可以從MSDN找到.
//最主要的函數(shù), 生成Dump
static void DumpMiniDump(HANDLE hFile, PEXCEPTION_POINTERS excpInfo)
{
if (excpInfo == NULL) //如果沒(méi)有傳入異常, 比如是在程序里面調(diào)用的, 生成一個(gè)異常
{
// Generate exception to get proper context in dump
__try
{
OutputDebugString(_T("raising exception\r\n"));
RaiseException(EXCEPTION_BREAKPOINT, 0, 0, NULL);
}
__except(DumpMiniDump(hFile, GetExceptionInformation()),
EXCEPTION_CONTINUE_EXECUTION)
{
}
}
else
{
OutputDebugString(_T("writing minidump\r\n"));
MINIDUMP_EXCEPTION_INFORMATION eInfo;
eInfo.ThreadId = GetCurrentThreadId(); //把需要的信息添進(jìn)去
eInfo.ExceptionPointers = excpInfo;
eInfo.ClientPointers = FALSE;
// 調(diào)用, 生成Dump. 98不支持
// Dump的類(lèi)型是小型的, 節(jié)省空間. 可以參考MSDN生成更詳細(xì)的Dump.
MiniDumpWriteDump(
GetCurrentProcess(),
GetCurrentProcessId(),
hFile,
MiniDumpNormal,
excpInfo ? &eInfo : NULL,
NULL,
NULL);
}
}
下面的是程序部分:
int _tmain(int argc, _TCHAR* argv[])
{
// 創(chuàng)建一個(gè)Dump文件
HANDLE hFile = CreateFile( _T("MiniDump.dmp"), GENERIC_READ | GENERIC_WRITE,
0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL );
int code;
__try
{
// 把自己實(shí)現(xiàn)的main函數(shù)包裝一下, 放在try .. except 塊中. 這樣出現(xiàn)了異常可以自動(dòng)生成dump
main_wrapper(argc, argv);
}
__except( code=GetExceptionCode(), DumpMiniDump(hFile, GetExceptionInformation() ), EXCEPTION_EXECUTE_HANDLER ) //出現(xiàn)了異常, 記錄異常的code, 生成dump!!
{
printf("%x\n", code);
wchar_t msg[512];
wsprintf(msg, L"Exception happened. Exception code is %x", code);
MessageBox(NULL, msg, L"Exception", MB_OK); //顯示消息給用戶
}
CloseHandle( hFile ); //關(guān)閉Dump文件
getchar();
return 0;
}
最下面是兩個(gè)測(cè)試的函數(shù), main_wrapper函數(shù)將調(diào)用test1, test1將會(huì)生成一個(gè)異常(非法內(nèi)存寫(xiě))
void test1() {
int *p;
p = (int*)0x100;
*p = 0; //寫(xiě)0x100地址, 這個(gè)是非法的
}
void main_wrapper(int argc, _TCHAR* argv[]) {
test1();
}
運(yùn)行, 異常被捕獲了:
同時(shí), dump文件也生成了:
用WinDBG打開(kāi)Dump文件, 可以清楚的看出異常出現(xiàn)的情況:
從中可以比較清楚的看到異常發(fā)生的情況(Exception code), 異常出現(xiàn)的地址(test1函數(shù), 偏移0x28). 因?yàn)檫@次測(cè)試的是Debug版, 有保存了源代碼的.pdb文件, 所以WinDbg把源代碼也列出來(lái)了. 這樣可以非常容易的發(fā)現(xiàn)問(wèn)題.
============================================
參考:
DbgHelp中的DumpAPI例子: http://www.debuginfo.com/examples/src/effminidumps/MiniDump.cpp
CrashReport: 程序出現(xiàn)異常的時(shí)候顯示發(fā)送錯(cuò)誤的對(duì)話框, 并把Dump文件發(fā)送到指定的地址. http://code.google.com/p/crashrpt/
XCrashReport: 與上面的類(lèi)似的一個(gè)開(kāi)源項(xiàng)目. http://www.codeproject.com/KB/debug/XCrashReportPt1.aspx