Windbg命令的语法规则系列(二)

二、字符串通配符语法

一些调试器命令具有接受各种通配符的字符串参数。这些类型的参数支持以下语法功能:

  •  星号(*)表示零个或多个字符。
  • 问号(?)表示任何单个字符。
  • 包含字符列表的括号([])表示列表中的任何单个字符。列表中只有一个字符匹配。在这些括号中,可以使用连字符(-)指定范围。例如,prog[er-t7]am匹配“progeam”、“program”、“progsam”、“progtam”和“prog7am”。
  • 数字符号(#)表示前面零个或多个字符。例如,lo#p与“lp”、“lop”、“loop”、“loop”等匹配。您还可以将数字符号与括号组合,因此m[ia]#n与“mn”、“min”、“man”、“maan”、“main”、“mian”、“miin”、“miain”等匹配。
  • 加号(+)表示前面的一个或多个字符。例如,lo+p与lo p相同,只是lo+p与“lp”不匹配。同样,m[ia]+n与m[ia]n相同,只是m[ia]+n与“mn”不匹配。A?+B和A*B一样,除了A?+B与“AB”不匹配。
  • 如果必须指定文字数字符号(#),问号(?),左括号([),右括号(]),星号(*)或加号(+)字符,必须在字符前面添加反斜杠(\)。如果不将连字符括在括号中,则连字符始终是文字。但不能在带括号的列表中指定文字连字符。
指定符号的参数还支持一些附加功能。除了标准字符串通配符之外,还可以在用于指定符号的文本表达式之前使用下划线(_)。将此表达式与符号匹配时,调试器将下划线视为任何数量的下划线,甚至为零。此功能仅在匹配符号时适用。它一般不适用于字符串通配符表达式。 三、寄存器语法 调试器可以控制寄存器和浮点寄存器。在表达式中使用寄存器时,应在寄存器之前添加at符号(@)。这个at符号告诉调试器以下文本是寄存器的名称。如果您使用的是masm表达式语法,则可以省略某些非常常见的寄存器的at符号。在基于x86的系统上,可以省略eax、ebx、ecx、edx、esi、edi、ebp、eip和efl寄存器的at符号。但是,如果指定一个不带at符号的不太常见的寄存器,调试器首先尝试将文本解释为十六进制数字。如果文本包含非十六进制字符,调试器接下来将文本解释为符号。最后,如果调试器找不到匹配的符号,则调试器将文本解释为寄存器。如果使用C++表达式语法,则总是需要AT-符号。 r(registers)命令是此规则的一个例外。调试器总是将其第一个参数解释为寄存器。(不需要或不允许使用at符号。)如果R命令有第二个参数,则根据默认表达式语法进行解释。如果默认表达式语法是C++,则必须使用以下命令将EBX寄存器复制到EAX寄存器中。
0:000> r eax = @ebx

基于x86的处理器上的标志

基于x86的处理器也使用多个1位寄存器,称为标志。

寄存器和线程

每个线程都有自己的寄存器值。这些值在线程执行时存储在CPU寄存器中,在另一个线程执行时存储在内存中。在用户模式下,对寄存器的任何引用都被解释为与当前线程关联的寄存器。有关当前线程的更多信息,请参阅控制进程和线程。在内核模式中,对寄存器的任何引用都被解释为与当前寄存器上下文关联的寄存器。可以设置寄存器上下文以匹配特定线程、上下文记录或陷阱帧。您只能为指定的寄存器上下文显示最重要的寄存器,并且不能更改它们的值。

四、伪寄存器语法

调试器支持保存某些值的多个伪寄存器。调试器将自动伪寄存器设置为某些有用的值。用户定义的伪寄存器是可写入或读取的整数变量。所有伪寄存器都以美元符号($)开头。如果使用MASM语法,可以在美元符号之前添加at符号(@)。这个at符号告诉调试器以下标记是寄存器或伪寄存器,而不是符号。如果省略了at符号,调试程序的响应会更慢,因为它必须搜索整个符号表。

例如,以下两个命令产生相同的输出,但第二个命令更快。

0:000> ? $exp
Evaluate expression: 143 = 0000008f
0:000> ? @$exp
Evaluate expression: 143 = 0000008f

如果存在与伪寄存器同名的符号,则必须添加at符号@。如果使用C++表达式语法,则总是需要at符号(@)。

 r(registers)命令是此规则的一个例外。调试器总是将其第一个参数解释为寄存器或伪寄存器。(不需要或不允许使用at符号@。)如果r命令有第二个参数,则根据默认表达式语法进行解释。如果默认表达式语法是C++,则必须使用以下命令将$T2伪寄存器复制到$T1伪寄存器。

0:000> r $t1 = @$t2

4.1、自动伪寄存器

调试器自动设置以下伪寄存器:

伪寄存器 描述

$ea

已执行的最后一个指令的有效地址。 如果此指令没有有效的地址,调试器将显示"错误的寄存器错误"。 如果此指令有两个有效的地址,调试器会显示第一个地址。

$ea2

已执行的最后一个指令的第二个的有效地址。 如果此指令不具有两个有效的地址,调试器将显示"错误的寄存器错误"。

$exp

最后一个表达式的计算。

$ra

寄信人地址为当前位于堆栈上。

此地址是在执行命令中尤其有用。 例如, g @$ ra继续,直到找到的寄信人地址 (尽管(Go Up) gu是"单步执行"当前函数的更精确地有效的方法)。

$ip

指令指针寄存器。

基于 x86 的处理器:与相同eip基于 Itanium 处理器:与相关iip。 (有关详细信息,请参阅此表后面的说明)。基于 x64 的处理器:与相同rip

$eventip

当前事件的时间处的指令指针。 此指针通常与匹配$ip,除非你切换线程或手动更改指令指针的值。

$previp

上一事件的时间处的指令指针。 (中断到调试器计为一个事件。)

$relip

指令指针与当前事件相关的。 分支跟踪时,此指针是指向分支源的指针。

$scopeip

当前指令指针本地上下文(也称为作用域)。

$exentry

当前进程的第一个可执行文件的入口点的地址。

$retreg

主要的返回值寄存器中。

基于 x86 的处理器:与相同eax基于 Itanium 处理器:与相同ret0基于 x64 的处理器:与相同rax

$retreg64

在 64 位格式中注册主要的返回值。

x86 处理器:与相同edx: eax对。

$csp

当前调用堆栈指针。 此指针是最具代表性的调用堆栈深度的寄存器。

基于 x86 的处理器:与相同esp基于 Itanium 处理器:与相同bsp基于 x64 的处理器:与相同rsp

$p

值的最后一个d \* (显示内存)打印命令。

$proc

当前进程 (即,地址 EPROCESS 块) 的地址。

$thread

当前线程的地址。 在内核模式调试,此地址是 ETHREAD 块的地址。 在用户模式调试,此地址为线程环境块 (TEB) 的地址。

$peb

当前进程的进程环境块 (PEB) 的地址。

$teb

当前线程的线程环境块 (TEB) 的地址。

$tpid

拥有当前线程的进程的进程 ID (PID)。

$tid

当前线程的线程 ID。

$dtid

 

$dpid

 

$dsid

 

$bpNumber

相应的断点的地址。 例如,美元 bp3 (或美元 bp03) 指的是断点的断点 ID 为 3。 数字始终是一个十进制数。 如果任何断点不的 ID 为数量$bp计算结果为零。 有关断点的详细信息,请参阅使用断点

$frame

当前的帧索引。 此索引是相同的帧号.frame (设置本地上下文)命令使用。

$dbgtime

根据计算机上运行调试器的当前时间。

$callret

返回值的最后一个函数.call (调用函数)中使用或调用.fnret /s命令。 数据类型$callret是此返回值的数据类型。

$extret

 

$extin

 

$clrex

 

$lastclrex

托管仅调试:上一次遇到公共语言运行时 (CLR) 异常对象的地址。

$ptrsize

指针的大小。 在内核模式下,此大小是目标计算机上的指针大小。

$pagesize

在一页上的内存字节数。 在内核模式下,此大小为目标计算机上的页面大小。

$pcr

 

$pcrb

 

$argreg

 

$exr_chance

当前的异常记录的可能性。

$exr_code

当前的异常记录异常代码。

$exr_numparams

当前的异常记录中的参数数量。

$exr_param0

当前的异常记录中的参数 0 的值。

$exr_param1

当前的异常记录中的值的参数 1。

$exr_param2

当前的异常记录中的参数 2 的值。

$exr_param3

当前的异常记录中的参数 3 的值。

$exr_param4

当前的异常记录中的参数 4 的值。

$exr_param5

当前的异常记录中的参数 5 的值。

$exr_param6

当前的异常记录中的参数 6 的值。

$exr_param7

当前的异常记录中的值的参数 7。

$exr_param8

当前的异常记录中的参数 8 的值。

$exr_param9

当前的异常记录中的值的参数 9。

$exr_param10

当前的异常记录中的参数 10 的值。

$exr_param11

当前的异常记录中的参数 11 的值。

$exr_param12

当前的异常记录中的值的参数 12。

$exr_param13

当前的异常记录中的值的参数 13。

$exr_param14

当前的异常记录中的值为 14 个参数。

$bug_code

如果发生了错误检查,这是错误代码。 适用于实时内核模式调试和内核故障转储。

$bug_param1

如果发生了错误检查,这是参数 1 的值。 适用于实时内核模式调试和内核故障转储。

$bug_param2

如果发生了错误检查,这是参数 2 的值。 适用于实时内核模式调试和内核故障转储。

$bug_param3

如果发生了错误检查,这是参数 3 的值。 适用于实时内核模式调试和内核故障转储。

$bug_param4

如果发生了错误检查,这是参数 4 的值。 适用于实时内核模式调试和内核故障转储。

在某些调试场景中,这些伪寄存器中的一些可能不可用。例如,在调试用户模式小型转储或某些内核模式转储文件时,不能使用$peb、$tid和$tpid。在某些情况下,您可以从~(thread status)而不是$tid学习线程信息。不能在第一个调试器事件上使用$previp伪寄存器。除非是分支跟踪,否则不能使用$relip伪寄存器。如果使用不可用的伪寄存器,则会出现语法错误。

 一个包含结构的地址的伪寄存器(比如$线程)、$、$、$和$将根据C++表达式计算器中的适当数据类型进行评估,但不是在表达式求值器中。例如,命令?$teb显示teb的地址,而命令??@$teb显示整个teb结构。有关详细信息,请参见计算表达式。在基于Itanium的处理器上,IIP寄存器是捆绑对齐的,这意味着它指向包含当前指令的捆绑中的插槽0,即使正在执行不同的插槽。所以IIP不是完整的指令指针。$IP伪寄存器是实际的指令指针,包括bundle和slot。其他持有地址指针的伪寄存器($ra、$retreg、$eventip、$previp、$relip和$exentry)的结构与所有处理器上的$ip相同。

您可以使用r命令更改$ip的值。此更改也会自动更改相应的寄存器。当执行恢复时,它将恢复到新的指令指针地址。这个寄存器是唯一可以手动更改的自动伪寄存器。注意:在masm语法中,可以用句点(.)表示$ip伪寄存器。。在此期间之前不添加at符号(@),也不将该期间用作r命令的第一个参数。在C++表达式中不允许使用此语法。自动伪寄存器类似于自动别名。但是,可以将自动别名与别名相关的令牌(如$)一起使用,并且不能将伪寄存器与此类令牌一起使用

4.2、用户定义的伪寄存器

有20个用户定义的伪寄存器($t0、$t1、…$t19)。这些伪寄存器是可以通过调试器读写的变量。您可以在这些伪寄存器中存储任何整数值。它们作为循环变量尤其有用。 若要写入到一个这些伪寄存器,使用 r (寄存器) 命令,如以下示例所示。
0:000> r $t0 = 7
0:000> r $t1 = 128*poi(MyVar)
 与所有伪寄存器一样,您可以在任何表达式中使用用户定义的伪寄存器,如下例所示。
0:000> bp $t3 
0:000> bp @$t4 
0:000> ?? @$t1 + 4*@$t2 

除非使用?与R命令一起切换。如果使用此开关,伪寄存器将获取分配给它的任何类型。例如,下面的命令将unicode_string**类型和0x0012ffbc值分配给$t15。

0:000> r? $t15 = * (UNICODE_STRING*) 0x12ffbc
 启动调试器时,用户定义的伪寄存器使用零作为默认值。注意,别名$u0、$u1、…$u9不是伪寄存器,尽管它们的外观相似。 4.3、示例 下面的示例设置了当前线程调用每次命中的断点NtOpenFile。 但在其他线程调用时,则不会命中此断点NtOpenFile
kd> bp /t @$thread nt!ntopenfile

下面的示例执行一个命令,直到寄存器保留指定的值。首先,在名为“eaxstep”的脚本文件中放入以下条件步进代码。

.if (@eax == 1234) { .echo 1234 } .else { t "$<eaxstep" }

接下来,发出以下命令。

t "$<eaxstep"

调试器执行一个步骤,然后运行您的命令。在这种情况下,调试器运行脚本,该脚本显示1234或重复该过程。

上一篇:使用WinDbg调试入门(内核模式)


下一篇:WDK1.3. windbg调试配置