WinDbg常用命令系列---!htrace

!htrace

简介

!htrace扩展显示一个或多个句柄的堆栈跟踪信息。

使用形式

• 用户模式
  !htrace [ Handle [ Max_Traces ]]
  !htrace -enable [ Max_Traces ]
  !htrace -snapshot
  !htrace -diff
  !htrace -disable
  !htrace -?
• 内核模式
  !htrace [ Handle [ Process [ Max_Traces ]]]
• !htrace -?

参数

• Handle
  指定将显示其堆栈跟踪的句柄。如果Handle为0或省略，则将显示进程中所有句柄的堆栈跟踪。
• Process
  （仅限内核模式）指定将显示其句柄的进程。如果进程为0或省略，则使用当前进程。在用户模式下，始终使用当前进程。
• Max_Traces
  指定要显示的堆栈跟踪的最大数目。在用户模式下，如果省略此参数，则将显示目标进程的所有堆栈跟踪。
• -enable
  （仅限用户模式）启用句柄跟踪，并通过-diff选项将句柄信息的第一个快照用作初始状态。
• -snapshot
  （仅限用户模式）获取当前句柄信息的快照，以用作-diff选项的初始状态。
• -diff
  （仅限用户模式）将当前句柄信息与上次获取的句柄信息快照进行比较。显示所有仍打开的句柄。
• -disable
  （仅限用户模式；仅限Windows Server 2003及更高版本）禁用句柄跟踪。在WindowsXP中，只有终止目标进程才能禁用句柄跟踪。
• -?
  在调试器命令窗口中显示此扩展的一些简短帮助文本。

支持环境

Windows 2000	不可用
Windows XP 和更高版本	Kdexts Ntsdexts

备注

启用句柄跟踪后，才能使用!htrace。启用句柄跟踪的一种方法是输入!htrace-enable命令。启用句柄跟踪时，每次进程打开句柄、关闭句柄或引用无效句柄时，都会保存堆栈跟踪信息。就是这个堆栈跟踪信息!htrace显示。还可以通过激活目标进程的应用程序验证器并选择Handles选项来启用句柄跟踪。

由 ! htrace 报告的某些跟踪可能来自不同的进程上下文。 在这种情况下, 返回地址在当前进程上下文中可能无法正确解析, 或可能解析为错误的符号。

下面的示例显示有关进程0x81400300 中的所有句柄的信息:

kd> !htrace 0 81400300

Process 0x81400300

ObjectTable 0xE10CCF60

## 

Handle 0x7CC - CLOSE:

0x8018FCB9: ntoskrnl!ExDestroyHandle+0x103

0x801E1D12: ntoskrnl!ObpCloseHandleTableEntry+0xE4

0x801E1DD9: ntoskrnl!ObpCloseHandle+0x85

0x801E1EDD: ntoskrnl!NtClose+0x19

0x010012C1: badhandle!mainCRTStartup+0xE3

## 0x77DE0B2F: KERNEL32!BaseProcessStart+0x3D

Handle 0x7CC - OPEN:

0x8018F44A: ntoskrnl!ExCreateHandle+0x94

0x801E3390: ntoskrnl!ObpCreateUnnamedHandle+0x10C

0x801E7317: ntoskrnl!ObInsertObject+0xC3

0x77DE23B2: KERNEL32!CreateSemaphoreA+0x66

0x010011C5: badhandle!main+0x45

0x010012C1: badhandle!mainCRTStartup+0xE3

## 0x77DE0B2F: KERNEL32!BaseProcessStart+0x3D

Handle 0x7DC - BAD REFERENCE:

0x8018F709: ntoskrnl!ExMapHandleToPointerEx+0xEA

0x801E10F2: ntoskrnl!ObReferenceObjectByHandle+0x12C

0x801902BE: ntoskrnl!NtSetEvent+0x6C

0x80154965: ntoskrnl!_KiSystemService+0xC4

0x010012C1: badhandle!mainCRTStartup+0xE3

## 0x77DE0B2F: KERNEL32!BaseProcessStart+0x3D

Handle 0x7DC - CLOSE:

0x8018FCB9: ntoskrnl!ExDestroyHandle+0x103

0x801E1D12: ntoskrnl!ObpCloseHandleTableEntry+0xE4

0x801E1DD9: ntoskrnl!ObpCloseHandle+0x85

0x801E1EDD: ntoskrnl!NtClose+0x19

0x010012C1: badhandle!mainCRTStartup+0xE3

## 0x77DE0B2F: KERNEL32!BaseProcessStart+0x3D

Handle 0x7DC - OPEN:

0x8018F44A: ntoskrnl!ExCreateHandle+0x94

0x801E3390: ntoskrnl!ObpCreateUnnamedHandle+0x10C

0x801E7317: ntoskrnl!ObInsertObject+0xC3

0x77DE265C: KERNEL32!CreateEventA+0x66

0x010011A0: badhandle!main+0x20

0x010012C1: badhandle!mainCRTStartup+0xE3

0x77DE0B2F: KERNEL32!BaseProcessStart+0x3D

## 

Parsed 0x6 stack traces.

Dumped 0x5 stack traces.