設定 tools.ini

  • 發行項

檔案 tools.ini 包含初始化命令行調試程序的資訊。 啟動時，調試程式會在 tools.ini 檔案中搜尋適當的區段標頭，並從標頭下的專案擷取初始化資訊。 每個命令行調試程式都有自己的區段標頭 - [CDB]、[NTSD] 和 [KD]。 環境變數 INIT 必須指向包含 tools.ini 檔案的目錄。

WinDbg 不會使用 tools.ini 檔案。 相反地，WinDbg 會將初始化設定儲存在 工作區中。

下表顯示 tools.ini 專案。

關鍵詞必須以空格元或冒號分隔值。 關鍵字不區分大小寫。

針對 TRUE 或 FALSE 值，“FALSE” 是唯一的 false 值。 任何其他專案都是 TRUE。

進入 Description

$u 0：value ... $u 9：value

將值指派給固定名稱別名。 您可以指定數值 n 或 0xn 或任何其他字串。 如需詳細資訊 ，請參閱使用別名 。 沒有命令行對等專案。

DebugChildren：flag

TRUE 或 FALSE。 如果 為TRUE，CDB會偵錯指定的應用程式及其可能繁衍的任何子進程。 命令行對等專案為 -o。

DebugOutput：flag

TRUE 或 FALSE。 如果 為TRUE，CDB會透過終端機傳送輸出並接收輸入。 如果 為 FALSE，輸出會移至用戶畫面。 命令行選項 -d 類似，但不相同。

IniFile：file

指定CDB或 KD 在啟動時從 中取得命令的文稿檔名。 預設值為目前目錄中的 ntsd.ini 檔案。 命令行對等專案為 -cf。如需詳細資訊，請參閱 使用腳本檔案。

LazyLoad：flag

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：eventsxe：event

設定調試程式回應和指定例外狀況或事件的處理狀態。

例外狀況和事件可以透過下列方式指定：

*：默認例外 狀況 n：例外 狀況 n (十進位) 0xn：例外 狀況 0xn (十六進位) (其他) ：事件程序代碼

如需此程式的詳細數據，以及控制這些設定的其他方法，請參閱 控制例外狀況和事件 。

VerboseOutput：flag

TRUE 或 FALSE。 如果 為TRUE，CDB 會顯示符號處理、事件通知和其他運行時間發生的詳細資訊。 命令行對等專案是 -v。

lines：flag

TRUE 或 FALSE。 行旗標會啟用或停用來源行信息的支援。

srcopt：options

設定控制原始檔顯示和程式逐步執行選項的來源行選項。 如需詳細資訊，請參閱 l+、l- (設定來源選項) 。

srcpath：directory

設定來源檔案搜尋路徑。 如需詳細資訊，請參閱 .srcpath、.lsrcpath (設定來源路徑) 。

enable_unicode：flag

TRUE 或 FALSE。 enable_unicode旗標會指定調試程式是否將 USHORT 指標和陣列顯示為 Unicode 字串。

force_radix_output：flag

TRUE 或 FALSE。 force_radix_output旗標會指定整數是以十進位格式或預設的弧度顯示。

col_mode：flag

TRUE 或 FALSE。 col_mode旗標會控制色彩模式設定。 啟用色彩模式時，調試程式會產生彩色輸出。 根據預設，大部分的色彩都不會設定，而是預設為目前的控制台色彩。

col：namecolspec

此名稱表示您正在著色的專案。 colspec 是 [rR-][gG-][bB-] 格式的三個字母 RGB 指標。 小寫字母表示較深，大寫字母表示較亮，虛線表示沒有色彩元件貢獻。 由於控制台色彩限制，亮色實際上並非每個元件，但如果有任何要求亮起，則會套用至所有元件。 換句話說，rgB 與 RGB 相同。 基於這個理由，建議在要使用任何上限時使用所有上限。

使用方式範例：

col：emphfg R--

tools.ini 檔案中的範例 [NTSD] 區段如下：

[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true