WinDbg - 命令行启动选项

带有放大镜的 WinDbg 徽标检查位。

启动 WinDbg

安装 WinDbg 后,WinDbgX.exe 可从任何目录位置运行。

命令行启动选项

WinDbgX [options]

下表汇总了可用的命令行选项。

常规选项

选项 说明
-c “command” 附加调试器后执行命令行。 此命令必须用引号引起来。 可以使用分号分隔多个命令。
-v 在调试器中启用详细输出。
-T 标题 设置窗口标题。
-logo LogFile 日志打开。 开始将信息记录到日志文件。 如果此文件已存在,则会将其覆盖。
-loga LogFile 日志追加。 开始将信息记录到日志文件。 如果文件存在,则会将其追加到 。
-e EventHandle 在目标中的下一个异常之后,使用给定句柄向事件发出信号。
-? 显示可用命令的摘要。

内核选项

选项 说明
-k [ConnectType] 启动内核调试会话。 如果使用 -k 后没有任何 ConnectType 选项,则它必须是命令行上的最后一个条目。
-kqm 在安静模式下启动 KD。
-Kl 在调试器所在的计算机上启动内核调试会话。
-kx ExdiOptions 使用 EXDI 驱动程序启动内核调试会话。 有关 EXDI 的详细信息,请参阅 配置 EXDI 调试器传输
-d 重新启动后,一旦加载内核模块,调试器就会进入目标计算机。

用户模式选项

选项 说明
-o 调试目标应用程序启动的所有进程 (子进程) 。
-g 忽略目标应用程序中的初始断点。
-G 忽略目标应用程序中的最终断点。
-光伏 指定调试器应非侵入性地附加到目标进程。
-高清 指定不应使用调试堆。
-cimp 指定创建的任何进程都将使用服务器设置的隐式命令行,而不是客户端中用户给定的命令行字符串。

目标选项

选项 说明
-remote ClientTransport 连接到已在运行的调试服务器。 有关可能的 ClientTransport 值的说明,请参阅 激活调试客户端。 使用此参数时,它必须是命令行上的第一个参数。
-server ServerTransport 创建可由其他调试器访问的调试服务器。 有关可能的 ServerTransport 值的说明,请参阅 激活调试服务器
-premote SmartClientTransport 创建智能客户端,并连接到已在运行的进程服务器。 有关可能的 SmartClientTransport 值的说明,请参阅 激活智能客户端
-p PID 指定要调试的十进制进程 ID。
-tid TID 指定要在启动调试会话时恢复的线程的线程 ID。
-psn ServiceName 指定要调试的进程中包含的服务的名称。 这用于调试已在运行的进程。
-pn ProcessName 指定要调试的进程的名称。
-z DumpFile 指定要调试的故障转储文件的名称。 如果路径和文件名包含空格,则必须用引号括起来。
-debugArch x86 -或- amd64 重写自动检测行为并设置调试器的目标位数。
-loadSession 加载已保存的会话配置文件。
-setupFirewallRules 在本地系统上配置所需的防火墙规则,以允许使用 KDNET 进行内核调试。
-openPrivateDumpByHandle Handle 仅限 Microsoft 内部使用。 指定要调试的故障转储文件的句柄。
-benchmarkStartup 仅限 Microsoft 内部使用。 运行启动基准并将结果追加到文件。

符号选项

选项 说明
-y SymbolPath 指定要使用的符号路径。 使用分号 (分隔多个路径 ;) 。 如果路径包含空格,则应用引号引起来。 有关详细信息以及更改此路径的其他方法,请参阅 符号路径
-n 干扰符号加载。 启用符号处理程序的详细输出。
-i ImagePath 设置要使用的图像搜索路径。
-sdce 导致调试器在符号加载期间显示“文件访问错误”消息。
-ses 使调试器对所有符号文件执行严格计算,并忽略任何可疑的符号。
-sicv 导致符号处理程序忽略 CV 记录
-罪 使调试器忽略符号路径和可执行映像路径环境变量。
-Snc 导致调试器关闭 C++ 转换。
-snul 禁用非限定名称的自动符号加载。
-支持 使符号处理程序在每次符号搜索期间搜索公共符号表
-sflags 同时设置所有符号处理程序选项。

源路径选项

选项 说明
-srcpath 指定要在调试服务器上使用的源路径。
-lsrcpath 指定要在本地客户端上使用的源路径。

如果位于本地调试器会话中,则 srcpath 和 lsrcpath 实际上是相同的 (“服务器”是本地会话) 。 对于远程调试,可能需要在一些位置将这些值设置为不同的值。 有关远程调试的详细信息,请参阅 远程调试

异常处理

选项 说明
-X 仅对访问冲突异常启用第二次机会处理。
-xe 异常 为指定的异常启用第一次异常处理。
-xd 异常 为指定的异常启用第二次异常处理。
-xn 异常 对于给定的异常,请禁用第一次和第二次机会处理,并仅在主机上显示消息。
-xi 异常 完全忽略给定的异常,禁用第一次和第二次机会处理,并且不向控制台输出任何内容。

有关可指定的异常列表,请参阅 事件定义和默认值

验尸

选项 说明
-I 将 WinDbg 设置为系统的默认事后调试器。
-是 以无提示方式将 WinDbg 设置为系统的默认事后调试器,仅报告错误。

已弃用的选项

选项 说明
-S 已弃用的命令行选项。
-QY 已弃用的命令行选项。
-Qs 已弃用的命令行选项。
-QSY 已弃用的命令行选项。
-WX 已弃用的命令行选项。

有关启动参数的常规信息,请参阅 WinDbg Command-Line 选项

可以使用 -? 列出支持的命令行选项。

显示各种选项的 WinDbgX 命令行帮助输出的屏幕截图。

另请参阅

WinDbg 功能