配置 tools.ini

  • 项目

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

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

下表显示了 tools.ini 项。

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

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

条目 说明

$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