windbg 调试器简明手册——第 7 章——调试器命令——第 3 节——命令

$$>a< 标记允许调试器向脚本传递参数。如果文件名包含空格，则必须用引号括起来。如果提供的参数过多，多余的参数将被忽略。如果提供的参数过少，源文件中任何形如 ${$argn}(其中 n 大于提供的参数数量)的标记都将保持其字面形式，不会被替换。你可以在此命令后跟分号和其他命令；分号的存在表示参数列表结束。

当调试器执行脚本文件时，命令及其输出将显示在“调试器命令”窗口中。脚本文件执行完毕后，控制权将返回给调试器。

这些标记的使用概括如下：

标记	允许文件名包含分号	允许连接多个以分号分隔的命令	简化为单个命令方块	允许脚本参数
$<	是	否	否	否
$><	是	否	是	否
$$<	否	是	否	否
$$><	否	是	是	否
$$>a<	否	是	是	是

$< ，$>< ，$$< 和 $$>< 命令会回显脚本文件中的命令并显示这些命令的输出。$$>a< 命令不会回显脚本文件中的命令，而只是显示它们的输出。

脚本文件可以嵌套。如果调试器在脚本文件中遇到这些标记之一，执行将跳转到新的脚本文件，并在新的脚本文件执行完毕后返回到之前的位置。脚本也可以递归调用。

在 WinDbg 中，你可以将附加命令文本粘贴到“调试器命令”窗口中。

2.4 示例

以下示例演示如何将参数传递给脚本文件 Myfile.txt。假设该文件包含以下文本：

.echo The first argument is ${$arg1}.

.echo The second argument is ${$arg2}.

然后，你可以使用类似这样的命令将参数传递给此文件：

0:000> $$>a<myfile.txt myFirstArg mySecondArg

该命令的执行结果为：

The first argument is myFirstArg.

The second argument is mySecondArg.

以下示例展示了当提供的参数数量错误时会发生什么情况。假设文件 My Script.txt 包含以下文本：

.echo The first argument is ${$arg1}.

.echo The fifth argument is ${$arg5}.

.echo The fourth argument is ${$arg4}.

然后，以下以分号分隔的命令行会产生如下输出：

0:000> $$>a< "c:\binl\my script.txt" "First one" Two "Three More" Four; recx

The first argument is First one.

The fifth argument is ${$arg5}.

The fourth argument is Four.

ecx=0021f4ac

在前面的例子中，文件名用引号括起来是因为它包含空格，包含空格的参数也用引号括起来。虽然脚本似乎需要第五个参数，但分号在第四个参数之后就终止了 $$>a< 命令。

3. ？(帮助命令)

问号 (?) 字符会显示所有命令和运算符的列表。注意：单独一个问号会显示命令帮助。问号表达式语法会计算给定表达式的值。

3.1 格式

3.2 评注

要了解有关标准命令的更多信息，请使用 ?。要了解有关元命令的更多信息，请使用 .help。要了解有关扩展命令的更多信息，请使用 !help。

4. ? (求值表达式)

问号 (?) 命令用于计算并显示表达式的值。

单独的问号 (?) 用于显示命令帮助。问号表达式 (? expression) 命令用于计算给定表达式的值。

4.1 格式

? Expression

4.2 参数

Expression：指定需计算的表达式。

4.3 评注

? 命令的输入和输出取决于你使用的是 MASM 表达式语法还是 C++ 表达式语法。有关这些表达式语法的更多信息，请参阅“表达式求值”和“数值表达式语法”。

如果你使用的是 MASM 语法，则输入和输出取决于当前基数。要更改基数，请使用 n (设置数字基数)命令。

? 命令在当前线程和进程的上下文中计算表达式中的符号。

某些字符串可能包含转义字符，例如 \n、\r 和 \b，这些转义字符应按字面意思读取，而不是由求值器解释。如果字符串中的转义字符被求值器解释，则可能会出现求值错误。例如：

0:000> as AliasName c:\dir\name.txt

0:000> al

Alias Value

------- -------

AliasName c:\dir\name.txt

0:001> ? $spat( "c:\dir\name.txt", "*name*" )

Evaluate expression: 0 = 00000000

0:001> ? $spat( "${AliasName}", "*name*" )

Evaluate expression: 0 = 00000000

0:001> ? $spat( "c:\dir\", "*filename*" )

Syntax error at '( "c:\dir\", "*filename*" )

在前两个示例中，即使字符串与模式匹配，求值器也返回 FALSE 值。在第三个示例中，由于字符串以反斜杠 (\) 结尾，求值器无法进行比较，因此反斜杠 (\) 会被求值器转换。

要使求值器按字面意思解释字符串，必须使用 @"String" 语法。以下代码示例显示了正确的结果：

0:000> ? $spat( @"c:\dir\name.txt", "*name*" )

Evaluate expression: 1 = 00000000`00000001

0:000> ? $spat( @"${AliasName}", "*name*" )

Evaluate expression: 1 = 00000000`00000001

0:001> ? $spat( @"c:\dir\", "*filename*" )

Evaluate expression: 0 = 00000000

在前面的示例中，$spat MASM 运算符检查第一个字符串，以确定它是否(不区分大小写)与第二个字符串的模式匹配。有关 MASM 运算符的更多信息，请参阅“MASM 数字和运算符”主题。

5. ?? (C++ 求值表达式)

双问号 (??) 命令根据 C++ 表达式规则计算并显示表达式的值。

5.1 格式

?? Expression

5.2 参数

Expression：指定要计算的 C++ 表达式。有关语法的更多信息，请参阅 C++ 数字和运算符。

5.3 评注

?? 命令会在当前线程和进程的上下文中计算表达式中的符号。

如果要根据 MASM 表达式规则计算表达式的一部分，请将该部分用括号括起来，并在其前面添加两个 @ 符号。有关 MASM 表达式和 C++ 表达式的更多信息，请参阅“计算表达式”和“数值表达式语法”。

6. # (汇编搜索模式)

井号 (#) 命令在反汇编代码中搜索指定的模式。有关汇编调试和相关命令的更多信息，请参阅“汇编模式下的调试”。

6.1 格式

# [Pattern] [Address [ L Size ]]

6.2 参数

(1) Pattern：指定要在反汇编代码中搜索的模式。模式可以包含各种通配符和说明符。有关语法的更多信息，请参阅字符串通配符语法。如果要在模式中包含空格，则必须将模式用引号括起来。模式不区分大小写。如果之前使用过 # 命令，并且省略了模式，则该命令将重用最近一次使用的模式。

(2) Address：指定搜索的起始地址。有关语法的更多信息，请参阅“地址和地址范围语法”。

(3) Size：指定要搜索的指令数量。如果省略“大小”，搜索将持续进行，直到找到第一个匹配项为止。

6.3 评注

若你之前使用过 # 命令，并且省略了 Address 参数，则搜索将从上次搜索结束的位置开始。

此命令通过在反汇编文本中搜索指定的模式来工作。你可以使用此命令查找寄存器名称、常量或反汇编输出中出现的任何其他字符串。你可以重复执行此命令，但不使用 Address 参数，以查找模式的连续出现。

你可以使用 u(反汇编)命令或使用 WinDbg 中的反汇编窗口来查看反汇编指令。反汇编显示最多包含四个部分：地址偏移量、二进制代码、汇编语言助记符和汇编语言详细信息。以下示例显示了一种可能的显示方式。

0040116b 45 inc ebp

0040116c fc cld

0040116d 8945b0 mov eax,[ebp-0x1c]

# 命令可以在反汇编显示的任何单个部分中搜索文本。例如，你可以使用 # eax 0040116b 查找地址 0040116d 处的 mov eax,[ebp-0x1c] 指令。以下命令也可以查找此指令。

# [ebp?0x 0040116b

# mov 0040116b

# 8945* 0040116b

# 116d 0040116b

但是，你不能将 mov eax* 作为一个整体进行搜索，因为 mov 和 eax 出现在显示的不同位置。请改用 mov*eax。

例如，你可以执行以下命令来搜索 main 入口点之后对 strlen 函数的第一个引用。

# strlen main

同样地，你可以发出以下两个命令来查找地址 0x779F9FBA 之后的第一个 jnz 指令，然后再查找其后的下一个 jnz 指令。

# jnz 779f9fba#

如果省略 Pattern 或 Address 参数，它们的值将基于上次使用 # 命令的情况。如果首次执行 # 命令时省略任一参数，则不会执行搜索。但是，即使在这种情况下，Pattern 和 Address 的值也会被初始化。

如果包含 Pattern 或 Address 参数，则其值将设置为输入的值。如果省略 Address 参数，则其值将初始化为程序计数器的当前值。如果省略 Pattern 参数，则其值将初始化为空模式。

7. || (系统状态)

双竖线(||)命令用于打印指定系统的状态，或当前正在调试的所有系统的状态。注意，不要将此命令与单竖线(|)(系统状态)命令混淆。

7.1 格式

|| System

指定要显示的系统。如果省略此参数，将显示你正在调试的所有系统。

7.2 评注

|| 命令仅在调试多个目标时才有用。许多(但并非全部)多目标调试会话都涉及多个系统。

每个系统列表均包含服务器名称和协议详细信息。调试器当前运行所在的系统标识为 <Local>。

(1) 例如：

0:000>||

显示如下：

. 0 Live user mode: <Local>

(2) 下列命令同样显示所有系统：

0:000>||*

显示如下：

. 0 Live user mode: <Local>

(3) 下列命令显示当前活动系统：

0:000>||.

显示如下：

. 0 Live user mode: <Local>

(4) 下列命令显示最近异常或中断的系统：

0:000>||#

显示如下：

. 0 Live user mode: <Local>

(5) 下列命令显示系统号为2的系统：

0:000>||2

显示如下：

. 2 Live user mode: <Local>

8. ||s (设置当前系统)

||s 命令设置或显示当前系统号。

||System s

|| s

不要将此命令与 s(搜索内存)、~s(改变当前处理器)、~s(设置当前线程)、或 |s(设置当前进程)命令混淆。

7.1 参数

System 为指定要激活的系统号。

7.2 评注

当你调试多个目标或处理多个转储文件时，||s 命令非常有用。如果你使用 ||s 语法，调试器将显示有关当前系统的信息。

此命令也对当前系统、进程和线程的当前指令进行反汇编。

注意：

当你同时对实时目标和转储目标进行调试时，会遇到一些复杂情况，因为针对不同类型的调试，命令的行为各不相同。例如，如果当前系统环境为转储文件，此时你使用 g (Go) 命令，调试器便会开始执行；但随后你将无法中断并重新回到调试器中，因为在转储文件调试模式下，break 命令不视为有效命令。

9. |(处理状态)

|s 命令用于设置或显示当前进程号。请勿将此命令与 s (搜索内存)、~s (更改当前处理器)、~s (设置当前线程) 或 ||s (设置当前系统) 命令混淆。

10.1 格式

|Process s

10.2 参数

进程号

指定要设置或显示的进程号。

10.3 评注

只有在用户模式下才能指定进程。如果使用 |s 语法，调试器会显示有关当前进程的信息。此命令还会反汇编当前系统、进程和线程的当前指令。

11. ~(线程状态)

波浪号( ~ )命令显示指定线程或当前进程中所有线程的状态。

11.1 格式

~ Thread(线程号)

指定要显示的线程之线程号。如果省略此参数，将显示所有线程。

11.2 评注

只有在用户模式下才能指定线程。在内核模式下，波浪号 (~) 指的是处理器。你可以在许多命令前添加线程符号。

以下示例演示了如何使用此命令。

(1) 以下命令显示所有线程。

0:000> ~

输出：

. 0 Id: 2630.1ce4 Suspend: 1 Teb: 000000a8`d30c8000 Unfrozen

1 Id: 2630.5468 Suspend: 1 Teb: 000000a8`d30ca000 Unfrozen

2 Id: 2630.4cdc Suspend: 1 Teb: 000000a8`d30cc000 Unfrozen

3 Id: 2630.2ba4 Suspend: 1 Teb: 000000a8`d30ce000 Unfrozen

(2) 以下命令同样显示所有线程。

0:000> ~*

输出(格式略有差异)：

. 0 Id: 2630.1ce4 Suspend: 1 Teb: 000000a8`d30c8000 Unfrozen

Start: TestVC__!ILT+23780(wmainCRTStartup) (00007ff6`e4c66ce9)