設定tools.ini
檔案tools.ini包含初始化命令行調試程序的資訊。 啟動時,調試程式會在 tools.ini 檔案中搜尋適當的區段標頭,並從標頭下的專案擷取初始化資訊。 每個命令行調試程式都有自己的區段標頭 - [CDB]、[NTSD]和 [KD]。 環境變數 INIT 必須指向包含tools.ini檔案的目錄。
WinDbg 不會使用 tools.ini 檔案。 相反地,WinDbg 會將初始化設定儲存在工作區中。
下表顯示tools.ini專案。
關鍵詞必須以空格元或冒號分隔值。 關鍵字不區分大小寫。
對於 TRUE 或 FALSE 值,“FALSE” 是唯一的 false 值。 任何其他專案都是 TRUE。
Entry | 描述 |
---|---|
$u 0: value ... $u 9:value |
將值指派給固定名稱別名。 您可以指定數值 n 或 0xn 或任何其他字串。 如需詳細資訊,請參閱使用別名。 沒有對等的命令行。 |
DebugChildren: flag |
TRUE 或 FALSE。 如果 為TRUE,CDB會偵錯指定的應用程式及其可能繁衍的任何子進程。 命令行對等專案是 -o。 |
DebugOutput: 旗標 |
TRUE 或 FALSE。 如果 為TRUE,CDB會透過終端傳送輸出並接收輸入。 如果 為 FALSE,輸出會移至用戶畫面。 命令行選項 -d 類似,但不相同。 |
IniFile: 檔案 |
指定CDB或 KD 在啟動時從 中取得命令的文稿檔名稱。 預設值是目前目錄中ntsd.ini檔案。 命令行對等專案為 -cf。如需詳細資訊,請參閱 使用腳本檔案。 |
LazyLoad:旗標 |
TRUE 或 FALSE。 如果 為 TRUE,CDB 會執行延遲符號載入;也就是說,除非需要,否則不會載入符號。 命令行對等專案為 -s。 如需設定此選項的詳細資訊和其他方法,請參閱 延後符號載入。 |
SetDll:filename |
設定延伸模組 DLL。 應省略.dll擴展名。 預設值為 userexts.dll。 命令行對等專案是 -a。 如需設定此預設值的詳細資訊和其他方法,請參閱 載入調試程式擴充功能 DLL。 |
StopFirst: flag |
TRUE 或 FALSE。 如果 為 true,CDB 會在映像載入程式結尾的斷點上停止。 命令行對等專案為 -g。 |
StopOnProcessExit: flag |
TRUE 或 FALSE。 如果 為TRUE,CDB 會在收到進程終止通知時停止。 命令行對等專案是 -G。 |
sxd:事件sxe: event | 設定調試程式回應和指定例外狀況或事件的處理狀態。 例外狀況和事件可透過下列方式指定: *:默認例外狀況 n:例外狀況 n (十進位) 0xn:例外狀況 0xn (十六進位) (其他): 事件程序代碼如需此程式的詳細數據,以及控制這些設定的其他方法,請參閱 控制例外狀況和事件 。 |
VerboseOutput: flag |
TRUE 或 FALSE。 如果 為TRUE,CDB 會顯示符號處理、事件通知和其他運行時間發生的詳細資訊。 命令行對等專案是 -v。 |
行:旗標 |
TRUE 或 FALSE。 行旗標會啟用或停用對源行信息的支援。 |
srcopt:選項 |
設定控制來源顯示和程式逐步執行選項的來源行選項。 如需詳細資訊,請參閱 l+、l- (設定來源選項)。 |
srcpath:目錄 |
設定來源檔案搜尋路徑。 如需詳細資訊,請參閱 .srcpath、.lsrcpath(設定來源路徑)。 |
enable_unicode: 旗標 |
TRUE 或 FALSE。 enable_unicode旗標會指定調試程式是否會將 USHORT 指標和陣列顯示為 Unicode 字串。 |
force_radix_output: 旗標 |
TRUE 或 FALSE。 force_radix_output旗標會指定整數是以十進位格式還是預設基數顯示。 |
col_mode: 旗標 |
TRUE 或 FALSE。 col_mode旗標會控制色彩模式設定。 啟用色彩模式時,調試程式會產生彩色輸出。 根據預設,大部分色彩都不會設定,而是預設為目前的控制台色彩。 |
col:name colspec |
名稱表示您要著色的專案。 colspec 是 [rR-][gG-][bB-] 窗體的三個字母 RGB 指標。 小寫字母表示較深,大寫字母表示較亮,虛線表示沒有色彩元件貢獻。 由於主控台色彩限制,明亮實際上並非每個元件,但如果有任何要求亮起,則會套用至所有元件。 換句話說,rgB 與 RGB 相同。 基於這個理由,建議在使用任何上限時使用所有上限。 使用方式範例: col: emphfg R-- |
tools.ini檔案中的範例 [NTSD] 區段如下:
[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true