配置 tools.ini

文件tools.ini包含初始化命令行调试器的信息。 启动时，调试器会在tools.ini文件中搜索相应的节标头，并从标头下的条目中提取初始化信息。 每个命令行调试器都有自己的节标头 - [CDB]、[NTSD]和 [KD]。 环境变量 INIT 必须指向包含tools.ini文件的目录。

WinDbg 不使用tools.ini文件。 相反，WinDbg 会在工作区中保存初始化设置。

下表显示了tools.ini项。

关键字必须用空格或冒号分隔值。 关键字不区分大小写。

对于 TRUE 或 FALSE 值，“FALSE”是唯一的 false 值。 任何其他内容都是 真的。

条目	说明
$u 0：值... $u 9：值	将值分配给固定名称别名。 可以指定数值 n 或 0xn 或任何其他字符串。 有关详细信息，请参阅 “使用别名 ”。 无命令行等效项。
DebugChildren： 标志	TRUE 或 FALSE。 如果 为 TRUE，CDB 将调试指定的应用程序以及它可能生成的任何子进程。 命令行等效项为 -o。
DebugOutput： 标志	TRUE 或 FALSE。 如果 为 TRUE，则 CDB 通过终端发送输出并接收输入。 如果 为 FALSE，输出将转到用户屏幕。 命令行选项 -d 类似，但不完全相同。
IniFile： 文件	指定 CDB 或 KD 在启动时从中获取命令的脚本文件的名称。 默认值为当前目录中ntsd.ini文件。 命令行等效项为 -cf。有关详细信息，请参阅 “使用脚本文件”。
LazyLoad： flag	TRUE 或 FALSE。 如果 为 TRUE，CDB 将执行延迟符号加载;也就是说，在需要之前不会加载符号。 命令行等效项为 -s。 有关详细信息，以及设置此选项的其他方法，请参阅 延迟符号加载。
SetDll： filename	设置扩展 DLL。 应省略.dll文件扩展名。 默认值为userexts.dll。 命令行等效项为 -a。 有关详细信息以及设置此默认值的其他方法，请参阅加载调试器扩展 DLL。
StopFirst： 标志	TRUE 或 FALSE。 如果 为 true，CDB 会在图像加载过程结束时在断点上停止。 命令行等效项为 -g。
StopOnProcessExit： 标志	TRUE 或 FALSE。 如果 为 TRUE，则 CDB 在收到进程终止通知时停止。 命令行等效项为 -G。
sxd：event sxe： event	设置调试器响应和指定异常或事件的处理状态。 可以通过以下方式指定异常和事件： *：默认异常 n：异常 n （十进制） 0xn：异常 0xn （十六进制） （其他）： 事件代码 有关此过程的详细信息以及控制这些设置的其他方法，请参阅 控制异常和事件 。
VerboseOutput： 标志	TRUE 或 FALSE。 如果 为 TRUE，CDB 将显示有关符号处理、事件通知和其他运行时事件的详细信息。 命令行等效项为 -v。
行：标志	TRUE 或 FALSE。 行标志启用或禁用对源行信息的支持。
srcopt： options	设置控制源显示和程序单步执行选项的源行选项。 有关详细信息，请参阅 l+、l- （设置源选项）。
srcpath： directory	设置源文件搜索路径。 有关详细信息，请参阅 .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