Heath's Blog

Window調(diào)試中的符號(hào)文件與源代碼管理

    游戲開(kāi)始進(jìn)行第二次封閉測(cè)試，這次參與人數(shù)較多，隨之而來(lái)的便是無(wú)數(shù)的崩潰dump。雖然在自動(dòng)構(gòu)建流程中已經(jīng)對(duì)PDB和EXE按版本號(hào)進(jìn)行了保存，但由于構(gòu)建操作人員手動(dòng)修改構(gòu)建號(hào)，出現(xiàn)多個(gè)版本對(duì)應(yīng)相同版本號(hào)的問(wèn)題，以及BUG單填寫(xiě)人以基線版本號(hào)而非真實(shí)版本號(hào)提交的情況，經(jīng)常浪費(fèi)開(kāi)發(fā)人員的時(shí)間和精力去找對(duì)應(yīng)的PDB，降低了崩潰解決的響應(yīng)速度。所以非常有必要建立一套自動(dòng)化方案，得到dump文件后啟動(dòng)WinDbg進(jìn)行分析時(shí)能夠自動(dòng)獲取對(duì)應(yīng)的PDB和源代碼，WinDbg就提供了這樣一套方便實(shí)用的工具。

1. 建立源代碼索引

     WinDbg提供了一套用于管理pdb對(duì)應(yīng)的源代碼的工具，位于其安裝目錄的srcsrv下，對(duì)VSS、SVN、CVS、Perforce提供了支持，分別對(duì)應(yīng)vssindex.cmd、svnindex.cmd、cvsindex.cmd、p4index.cmd這四個(gè)perl腳本。其實(shí)，ssindex.cmd才是具體實(shí)現(xiàn)，它根據(jù)傳入的版本控制系統(tǒng)標(biāo)識(shí)，調(diào)用對(duì)應(yīng)的perl module。

     svnindex.cmd通過(guò)/source和/symbols參數(shù)來(lái)指定源代碼目錄和PDB目錄，/debug可輸出處理的詳細(xì)信息，/user和/pass提供svn賬戶和密碼。PDB文件中有一節(jié)專門(mén)用于存放源代碼文件列表及處理命令，可通過(guò)pdbstr -r -p:PdbFileName -s:srcsrv查看。

     svnindex.cmd /debug /source="E:\CodeBase_SVN\Client\trunk\tools\CutSceneEditor" /symbols="E:\CodeBase_SVN\Client\trunk\bin\Release\CutSceneEditor" /user="user" /pass="pwd"

     在執(zhí)行上面命令前，確保Perl和Subversion已經(jīng)被安裝且設(shè)置了PATH環(huán)境變量。該命令將提取source code的服務(wù)器路徑和當(dāng)前Revision，然后寫(xiě)入PDB。下面是通過(guò)pdbstr獲取的信息：

     上面輸出是經(jīng)過(guò)格式化的，原始信息可以通過(guò)srctool -n查看：

     可以看出，原始代碼路徑后面跟了一條svn cat指令，由于沒(méi)有指定sourcepath，所以%targ%缺省為當(dāng)前路徑（"C:\Program Files\Debugging Tools for Windows (x64)\srcsrv"）。 

2. 創(chuàng)建符號(hào)服務(wù)器

    所謂符號(hào)服務(wù)器，最簡(jiǎn)單的形式就是文件共享服務(wù)器。我們使用symstore命令，將1中產(chǎn)生的pdb添加到一個(gè)文件共享服務(wù)器上，如：

     symstore.exe add /f "E:\CodeBase_SVN\Client\trunk\bin\Release\CutSceneEditor\*.pdb" /s "\\server.com\pub\Symbols" /t "CutSceneEditor" /v "Build 4171" /c "fix memory leak"

     該命令會(huì)根據(jù)PDB的signature和age產(chǎn)生一個(gè)GUID，并將PDB放置于以改GUID為名字的目錄下：

    當(dāng)debug時(shí)，將UNC路徑添加到_NT_SYMBOL_PATH中（如：_NT_SYMBOL_PATH=CACHE*F:\Symbols;SRV*http://msdl.microsoft.com/download/symbols;SRV*\\server.com\pub\Symbols），調(diào)試器會(huì)自動(dòng)到指定的符號(hào)服務(wù)器上去搜索對(duì)應(yīng)的pdb文件。

     symstore大大簡(jiǎn)化了符號(hào)的版本管理問(wèn)題，關(guān)于它的詳細(xì)介紹可參考symstore介紹。

     值得注意的是，symstore沒(méi)有鎖機(jī)制，并不支持多人同時(shí)操作。實(shí)際情況中，也只有自動(dòng)構(gòu)建時(shí)才會(huì)做此操作。

3. 使用WinDbg分析Dump文件

      我們?cè)诖a中加入發(fā)生異常寫(xiě)MiniDump的功能，在程序崩潰時(shí)產(chǎn)生dump文件。在使用WinDbg分析dump文件時(shí)，需要設(shè)置Symbol File Path和Source File Path，也可以直接設(shè)置環(huán)境變量_NT_SYMBOL_PATH和_NT_SOURCE_PATH。在設(shè)置_NT_SOURCE_PATH時(shí)使用"SRV*CachePath"將表示啟用代碼提取功能，執(zhí)行svn cat寫(xiě)入到CachePath指定的目錄，否則將使用原始路徑。此后，通過(guò)點(diǎn)擊Call Stack中的函數(shù)調(diào)用便會(huì)觸發(fā)從svn讀取對(duì)應(yīng)代碼的操作（通常會(huì)有一個(gè)安全警告窗口彈出）。

     對(duì)于使用WinDbg進(jìn)行調(diào)試在此就不多講了，推薦一本不錯(cuò)的書(shū)《Advanced Windows Debugging》。

參考資料

[1] Source Indexing and Symbol Servers: A Guide to Easier Debugging

[2] Source Server Helps You Kill Bugs Dead In Visual Studio 2005

posted on 2012-03-26 23:10 Heath 閱讀(3947) 評(píng)論(2)  編輯 收藏 引用 所屬分類: Game Development