WinDbg 徽标,使用放大镜检查位。
Starting WinDbg
安装 WinDbg 后,WinDbgX.exe 可从任何目录位置运行。
命令行启动选项
WinDbgX [options]
下表汇总了可用的命令行选项。
General Options
Option | Description |
---|---|
-c "command" | 附加调试器后执行命令行。 此命令必须用引号引起来。 可以使用分号分隔多个命令。 |
-v | 在调试器中启用详细输出。 |
-T Title | 设置窗口标题。 |
-logo LogFile | Log Open. 开始将信息记录到日志文件。 如果此文件已存在,则会将其覆盖。 |
-loga LogFile | Log Append. 开始将信息记录到日志文件。 如果文件存在,则会将其追加到其中。 |
-e EventHandle | 在目标出现下一个异常后,使用给定的句柄发出事件信号。 |
-? | 显示可用命令的摘要。 |
Kernel Options
Option | Description |
---|---|
-k [ConnectType] | 启动内核调试会话。 If -k is used without any ConnectType options following it, it must be the final entry on the command line. |
-kqm | 以安静模式启动 KD。 |
-kl | 在调试器所在的同一台计算机上启动内核调试会话。 |
-kx ExdiOptions | 使用 EXDI 驱动程序启动内核调试会话。 有关 EXDI 的详细信息,请参阅 配置 EXDI 调试器传输。 |
-d | 重新启动后,调试器会在加载内核模块后立即进入目标计算机。 |
用户模式选项
Option | Description |
---|---|
-o | 调试目标应用程序启动的所有进程(子进程)。 |
-g | 忽略目标应用程序中的初始断点。 |
-G | 忽略目标应用程序中的最终断点。 |
-pv | 指定调试器应以非侵入方式附加到目标进程。 |
-hd | 指定不应使用调试堆。 |
-cimp | 指定创建的任何进程都将使用服务器设置的隐式命令行,而不是来自客户端的用户给定命令行字符串。 |
Target Options
Option | Description |
---|---|
-remote ClientTransport | 连接到正在运行的调试服务器。 For an explanation of the possible ClientTransport values, see Activating a Debugging Client. 使用此参数时,它必须是命令行上的第一个参数。 |
-server ServerTransport | 创建可由其他调试器访问的调试服务器。 For an explanation of the possible ServerTransport values, see Activating a Debugging Server. |
-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仅供内部使用。 运行启动基准,并将结果追加到文件中。 |
Symbol Options
Option | Description |
---|---|
-y SymbolPath | 指定要使用的符号路径。 Separate multiple paths with a semicolon (;). 如果路径包含空格,则应使用引号引起来。 For details, and for other ways to change this path, see Symbol Path. |
-n | 噪声符号负载。 启用符号处理程序的详细输出。 |
-i ImagePath | 设置要使用的图像搜索路径。 |
-sdce | 导致调试器在符号加载期间显示“文件访问错误”消息。 |
-ses | 使调试器对所有符号文件执行严格的评估,并忽略任何可疑的符号。 |
-sicv | 导致符号处理程序忽略 CV 记录 |
-sins | 使调试器忽略符号路径和可执行映像路径环境变量。 |
-snc | 使调试器关闭C++转换。 |
-snul | 禁用非限定名称的自动符号加载。 |
-sup | 使符号处理程序在每个符号搜索期间搜索公共符号表 |
-sflags | 同时设置所有符号处理程序选项。 |
源路径选项
Option | Description |
---|---|
-srcpath | 指定要在调试服务器上使用的源路径。 |
-lsrcpath | 指定要在本地客户端上使用的源路径。 |
如果处于本地调试器会话中,srcpath 和 lsrcpath 实际上相同(“服务器”是本地会话)。 对于远程调试,可能需要将这些值设置为不同的值。 For more information about remote debugging see, Remote Debugging.
Exception handling
Option | Description |
---|---|
-x | 仅针对访问冲突异常启用第二次机会处理。 |
-xe Exception | 为指定的异常启用第一次机会异常处理。 |
-xd Exception | 为指定的异常启用二次机会异常处理机制。 |
-xn Exception | 对于给定的异常,请禁用一次和二次机会处理,并且仅在控制台上显示消息。 |
-xi Exception | 完全忽略给定的异常,禁用第一次和第二次机会处理,而不向控制台输出任何内容。 |
有关可指定的异常列表,请参阅 事件定义和默认值。
Post Mortem
Option | Description |
---|---|
-I | 将 WinDbg 设置为系统的默认验尸调试器。 |
-IS | 将 WinDbg 静默地设置为系统的默认事后调试器,仅报告错误。 |
Deprecated Options
Option | Description |
---|---|
-Q | 弃用的命令行选项。 |
-QY | 弃用的命令行选项。 |
-QS | 弃用的命令行选项。 |
-QSY | 弃用的命令行选项。 |
-WX | 弃用的命令行选项。 |
有关启动参数的一般信息,请参阅 WinDbg Command-Line 选项。
可以使用 -? 列出支持的命令行选项。