!heap
简介
!heap扩展显示堆使用信息、控制堆管理器中的断点、检测泄漏的堆块、搜索堆块或显示页堆信息。此扩展支持段堆和NT堆。使用!heap没有参数列出所有堆及其类型的堆。
使用形式
!heap [HeapOptions] [ValidationOptions] [Heap]
!heap -b [{alloc|realloc|free} [Tag]] [Heap | BreakAddress]
!heap -B {alloc|realloc|free} [Heap | BreakAddress]
!heap -l
!heap -s [SummaryOptions] [StatHeapAddress]
!heap -i HeapAddress
!heap -x [-v] Address
!heap -p [PageHeapOptions]
!heap -srch [Size] Pattern
!heap -flt FilterOptions
!heap -stat [-h Handle [-grp GroupBy [MaxDisplay]]]
!heap [-p] -?
!heap -triage [Handle | Address] 参数
这些参数适用于Segment和NT堆。
- -s
指定正在请求摘要信息。如果省略SummaryOptions和StatHeapAddress，则显示与当前进程关联的所有堆的摘要信息。 - SummaryOptions
可以是以下选项的任意组合。SummaryOptions不区分大小写。输入!heap -s -?了解更多信息。
选项 效果 -v
验证所有数据块。
-b BucketSize
指定存储桶大小。 默认值为1024位。
-d DumpBlockSize
指定存储桶大小。
-a
转储所有堆块。
-c
指定应显示每个块的内容。
- -triage [Handle | Address]
使调试器自动搜索进程堆中的失败。如果将堆句柄指定为参数，则检查该堆；否则，将搜索所有堆中包含给定地址的堆，如果找到，则检查该堆。使用-triage是验证低碎片堆（LFH）损坏的唯一方法。 - -x[-v]
使调试器搜索包含指定地址的堆块。如果添加了-v，该命令将搜索当前进程的整个虚拟内存空间以查找指向此堆块的指针。 - -l
使调试器检测泄漏的堆块。 - -iAddress -h HeapAddress
显示有关指定 堆 的信息。 - Address
指定要搜索的地址。 - -?
在调试器命令窗口中显示此扩展的简短帮助文本。使用!heap -?一般的帮助，而且!heap -p -?页面堆帮助。
这些参数仅适用于NT堆。
- HeapOptions
可以是以下选项的任意组合。HeapOptions值区分大小写。
选项 效果 -v
使调试器验证指定的堆。此选项不会检测到低碎片堆（LFH）损坏。使用-triage代替。
-a
使显示包含指定堆的所有信息。 大小，在本例中，将向上舍入到堆粒度。 （运行!heap 具有-a选项的堆等效于使用三个选项-h-f-m运行它，这可能需要很长时间。）
-h
使显示包含指定堆的所有非 LFH 条目。
-hl
使显示包含指定堆的所有条目，包括 LFH 条目。
-f
使显示包含指定堆的所有可用列表项。
-m
使显示内容包括指定堆的所有段条目。
-t
使显示包含指定堆的标记信息。
-T
使显示包含指定堆的伪标记条目。
-g
使显示内容包含全局标记信息。 全局标记与每个未标记的分配相关联。
-s
使显示内容包括指定堆的摘要信息。
-k
（仅限基于 x86 的目标）使显示内容包括与每个条目关联的 stack backtrace。
- ValidationOptions
可以是以下任一选项。ValidationOptions区分大小写。
选项 效果 -D
对指定的堆禁用调用验证。
-E
为指定的堆启用调用时验证。
-d
为指定的堆禁用堆检查。
-e
为指定的堆启用堆检查。
- -iHeapAddress or HeapAddress
显示有关指定 堆 的信息。 - BreakAddress
指定要在其中设置或删除断点的块的地址。 - -b
使调试器在堆管理器中创建条件断点。-b选项可以后跟alloc、realloc或free；这指定是否通过分配、重新分配或释放内存来激活断点。如果使用BreakAddress指定块的地址，则可以省略断点类型。如果使用Heap指定堆地址或堆索引，则必须包括类型以及标记参数。 - Tag
指定堆中的标记名称。 - -B
使调试器从堆管理器中删除条件断点。必须指定断点类型（alloc、realloc或free），并且必须与-b选项使用的断点类型相同。 - StatHeapAddress
指定堆的地址。 如果此为0或省略，则显示与当前进程关联的所有堆。 - -p
指定正在请求页堆信息。 如果在没有任何PageHeapOptions的情况下使用，则将显示所有页堆。 - PageHeapOptions
可以是以下选项中的任何一个。 PageHeapOptions区分大小写。 如果未指定任何选项，则将显示所有可能的页堆句柄。
选项 效果 -h Handle
使调试器显示有关带有句柄句柄的页堆的详细信息。
-a Address
使调试器查找其块包含地址的页堆。 将包括此地址如何包含到整页堆块的完整详细信息，如此地址是否是页面堆的一部分、其在块内的偏移量，以及是分配块还是释放块。 每次提供堆栈跟踪。 使用此选项时，大小以堆分配粒度的倍数显示。
-t[c|s][Traces]
使调试器显示大量堆用户的已收集跟踪。 跟踪指定要显示的跟踪数;默认值为四。 如果跟踪超过指定的数量，则显示最早的跟踪。 如果使用-t或-tc ，则跟踪按计数使用情况进行排序。 如果使用-ts ，则跟踪按大小排序。 （仅 Windows XP 支持-tc和-ts选项; 仅在 windows xp 和更早版本的 windows 中支持-t选项。）
-fi[Traces]
使调试器显示最新的错误注入跟踪。 跟踪指定要显示的数量;默认值为4。
-all
使调试器显示有关所有页堆的详细信息。
-?
使调试器显示页堆帮助，包括堆块的关系图。 （也可以在下面的 "备注" 部分中查看这些关系图。）
- -srch
扫描给定模式的所有堆。 - Pattern
指定要查找的模式。 - Size
可以是以下选项中的任何一个。 这将指定模式的大小。 "-" 是必需的。
选项 效果 -b
模式大小为1个字节。
-w
模式为一个大小的单词。
-d
模式为一个 DWORD 大小。
-q
模式为大小为1个 QWORD。
如果未指定上述任何一个，则假设模式的大小与计算机指针的大小相同。 - -flt
将显示范围限制为仅包含具有指定大小或大小范围的堆。 - FilterOptions
可以是以下选项中的任何一个。 FilterOptions区分大小写。
选项 效果 s 大小
将显示范围限制为仅包含指定大小的堆。
r SizeMin SizeMax
将显示范围限制为仅包含指定大小范围内的堆。
- -stat
显示指定堆的使用情况统计信息。 - -h Handle
导致显示仅显示在句柄上的堆的使用情况统计信息。 如果Handle为0或省略，则显示所有堆的使用情况统计信息。 - -grp GroupBy
按GroupBy指定的重新排序显示。 可以在下表中找到GroupBy的选项。
选项 效果 A
根据分配大小显示使用情况统计信息。
B
根据块计数显示使用情况统计信息。
S
根据每个分配的总大小显示使用量统计信息。
- MaxDisplay
将输出限制为仅MaxDisplay的行数。
支持环境
Windows XP 和更高版本 Ext .dll Exts
备注
此扩展命令可用于执行各种任务。
标准 !heap命令用于显示当前进程的堆信息。 （这应该只用于用户模式进程。 !heap Pool extension 命令应用于系统进程。）
!heap-b和 !heap -B命令用于在堆管理器中创建和删除条件断点。
!heap -l命令检测泄漏的堆块。 它使用垃圾回收器算法来检测未在进程地址空间中的任何位置引用的堆中的所有繁忙块。 对于大型应用程序，可能需要几分钟才能完成。 此命令仅在 Windows XP 和更高版本的 Windows 中可用。
!heap -x命令搜索包含给定地址的堆块。 如果使用了 -v选项，则此命令将另外在当前进程的整个虚拟内存空间中搜索指向此堆块的指针。 此命令仅在 Windows XP 和更高版本的 Windows 中可用。
!heap -p命令显示了各种形式的页堆信息。 使用 !heap -p之前，必须为目标进程启用页堆。 这是通过全局标志（gflags）实用程序来完成的。 为此，请启动实用工具，在 "映像文件" 文本框中填写目标应用程序的名称，选择 "映像文件选项" 并启用页堆，并单击 "应用"。 或者，你可以通过键入gflags/i xxx + hpa（其中， xxx是目标应用程序的名称）从命令提示符窗口启动全局标志实用程序。
不支持在 Windows XP 以外的情况!heap -p -t[c|s]命令。 使用随调试器包一起提供的UMDH工具来获取类似的结果。
!heap -srch命令显示包含某个指定模式的堆条目。
!heap -flt命令会将显示范围限制为仅指定大小的堆分配。
!heap -stat命令显示堆使用情况统计信息。
下面是标准!heap 命令的示例：
0:000> !ntsdexts.heap -a
Index Address Name Debugging options enabled
1: 00250000
Segment at 00250000 to 00350000 (00056000 bytes committed)
Flags: 50000062
ForceFlags: 40000060
Granularity: 8 bytes
Segment Reserve: 00100000
Segment Commit: 00004000
DeCommit Block Thres:00000400
DeCommit Total Thres:00002000
Total Free Size: 000003be
Max. Allocation Size:7ffddfff
Lock Variable at: 00250b54
Next TagIndex: 0012
Maximum TagIndex: 07ff
Tag Entries: 00350000
PsuedoTag Entries: 00250548
Virtual Alloc List: 00250050
UCR FreeList: 002504d8
128-bit bitmap of free lists
FreeList Usage: 00000014 00000000 00000000 00000000
Free Free
List List
# Head Blink Flink
FreeList[ 00 ] at 002500b8: 002a4378 . 002a4378
0x02 - HEAP_ENTRY_EXTRA_PRESENT
0x04 - HEAP_ENTRY_FILL_PATTERN
Entry Prev Cur 0x10 - HEAP_ENTRY_LAST_ENTRY
Address Size Size flags
002a4370: 00098 . 01c90 [14] - free
FreeList[ 02 ] at 002500c8: 0025cb30 . 002527b8
002527b0: 00058 . 00010 [04] - free
0025cb28: 00088 . 00010 [04] - free
FreeList[ 04 ] at 002500d8: 00269a08 . 0026e530
0026e528: 00038 . 00020 [04] - free
0026a4d0: 00038 . 00020 [06] - free
0026f9b8: 00038 . 00020 [04] - free
0025cda0: 00030 . 00020 [06] - free
00272660: 00038 . 00020 [04] - free
0026ab60: 00038 . 00020 [06] - free
00269f20: 00038 . 00020 [06] - free
00299818: 00038 . 00020 [04] - free
0026c028: 00038 . 00020 [06] - free
00269a00: 00038 . 00020 [46] - free
Segment00 at 00250b90:
Flags: 00000000
Base: 00250000
First Entry: 00250bc8
Last Entry: 00350000
Total Pages: 00000080
Total UnCommit: 00000055
Largest UnCommit:000aa000
UnCommitted Ranges: (1)
002a6000: 000aa000
Heap entries for Segment00 in Heap 250000
0x01 - HEAP_ENTRY_BUSY
0x02 - HEAP_ENTRY_EXTRA_PRESENT
0x04 - HEAP_ENTRY_FILL_PATTERN
0x08 - HEAP_ENTRY_VIRTUAL_ALLOC
0x10 - HEAP_ENTRY_LAST_ENTRY
0x20 - HEAP_ENTRY_SETTABLE_FLAG1
0x40 - HEAP_ENTRY_SETTABLE_FLAG2
Entry Prev Cur 0x80 - HEAP_ENTRY_SETTABLE_FLAG3
Address Size Size flags (Bytes used) (Tag name)
00250000: 00000 . 00b90 [01] - busy (b90)
00250b90: 00b90 . 00038 [01] - busy (38)
00250bc8: 00038 . 00040 [07] - busy (24), tail fill (NTDLL!LDR Database)
00250c08: 00040 . 00060 [07] - busy (48), tail fill (NTDLL!LDR Database)
00250c68: 00060 . 00028 [07] - busy (10), tail fill (NTDLL!LDR Database)
00250c90: 00028 . 00060 [07] - busy (48), tail fill (NTDLL!LDR Database)
00250cf0: 00060 . 00050 [07] - busy (38), tail fill (Objects= 80)
00250d40: 00050 . 00048 [07] - busy (2e), tail fill (NTDLL!LDR Database)
00250d88: 00048 . 00c10 [07] - busy (bf4), tail fill (Objects>1024)
00251998: 00c10 . 00030 [07] - busy (12), tail fill (NTDLL!LDR Database)
...
002525c0: 00030 . 00060 [07] - busy (48), tail fill (NTDLL!LDR Database)
00252620: 00060 . 00050 [07] - busy (38), tail fill (NTDLL!LDR Database)
00252670: 00050 . 00040 [07] - busy (22), tail fill (NTDLL!CSRSS Client)
002526b0: 00040 . 00040 [07] - busy (24), tail fill (Objects= 64)
002526f0: 00040 . 00040 [07] - busy (24), tail fill (Objects= 64)
00252730: 00040 . 00028 [07] - busy (10), tail fill (Objects= 40)
00252758: 00028 . 00058 [07] - busy (3c), tail fill (Objects= 88)
002527b0: 00058 . 00010 [04] free fill
002527c0: 00010 . 00058 [07] - busy (3c), tail fill (NTDLL!LDR Database)
00252818: 00058 . 002d0 [07] - busy (2b8), tail fill (Objects= 720)
00252ae8: 002d0 . 00330 [07] - busy (314), tail fill (Objects= 816)
00252e18: 00330 . 00330 [07] - busy (314), tail fill (Objects= 816)
00253148: 00330 . 002a8 [07] - busy (28c), tail fill (NTDLL!LocalAtom)
002533f0: 002a8 . 00030 [07] - busy (18), tail fill (NTDLL!LocalAtom)
00253420: 00030 . 00030 [07] - busy (18), tail fill (NTDLL!LocalAtom)
00253450: 00030 . 00098 [07] - busy (7c), tail fill (BASEDLL!LMEM)
002534e8: 00098 . 00060 [07] - busy (44), tail fill (BASEDLL!TMP)
00253548: 00060 . 00020 [07] - busy (1), tail fill (Objects= 32)
00253568: 00020 . 00028 [07] - busy (10), tail fill (Objects= 40)
00253590: 00028 . 00030 [07] - busy (16), tail fill (Objects= 48)
...
0025ccb8: 00038 . 00060 [07] - busy (48), tail fill (NTDLL!LDR Database)
0025cd18: 00060 . 00058 [07] - busy (3c), tail fill (NTDLL!LDR Database)
0025cd70: 00058 . 00030 [07] - busy (18), tail fill (NTDLL!LDR Database)
0025cda0: 00030 . 00020 [06] free fill (NTDLL!Temporary)
0025cdc0: 00020 . 00258 [07] - busy (23c), tail fill (Objects= 600)
0025d018: 00258 . 01018 [07] - busy (1000), tail fill (Objects>1024)
0025e030: 01018 . 00060 [07] - busy (48), tail fill (NTDLL!LDR Database)
...
002a4190: 00028 . 00118 [07] - busy (100), tail fill (BASEDLL!GMEM)
002a42a8: 00118 . 00030 [07] - busy (18), tail fill (Objects= 48)
002a42d8: 00030 . 00098 [07] - busy (7c), tail fill (Objects= 152)
002a4370: 00098 . 01c90 [14] free fill
002a6000: 000aa000 - uncommitted bytes.下面是!heap -l命令的示例：
1:0:011> !heap -l
1:Heap 00170000
Heap 00280000
Heap 00520000
Heap 00b50000
Heap 00c60000
Heap 01420000
Heap 01550000
Heap 016d0000
Heap 019b0000
Heap 01b40000
Scanning VM ...
## Entry User Heap Segment Size PrevSize Flags
001b2958 001b2960 00170000 00000000 40 18 busy extra
001b9cb0 001b9cb8 00170000 00000000 80 300 busy extra
001ba208 001ba210 00170000 00000000 80 78 busy extra
001cbc90 001cbc98 00170000 00000000 e0 48 busy extra
001cbd70 001cbd78 00170000 00000000 d8 e0 busy extra
001cbe90 001cbe98 00170000 00000000 68 48 busy extra
001cbef8 001cbf00 00170000 00000000 58 68 busy extra
001cc078 001cc080 00170000 00000000 f8 128 busy extra
001cc360 001cc368 00170000 00000000 80 50 busy extra
001cc3e0 001cc3e8 00170000 00000000 58 80 busy extra
001fe550 001fe558 00170000 00000000 150 278 busy extra
001fe6e8 001fe6f0 00170000 00000000 48 48 busy extra
002057a8 002057b0 00170000 00000000 58 58 busy extra
00205800 00205808 00170000 00000000 48 58 busy extra
002058b8 002058c0 00170000 00000000 58 70 busy extra
00205910 00205918 00170000 00000000 48 58 busy extra
00205958 00205960 00170000 00000000 90 48 busy extra
00246970 00246978 00170000 00000000 60 88 busy extra
00251168 00251170 00170000 00000000 78 d0 busy extra user_flag
00527730 00527738 00520000 00000000 40 40 busy extra
00527920 00527928 00520000 00000000 40 80 busy extra
21 leaks detected.此示例中的表包含发现的所有21个泄漏。
下面是!heap x命令的示例：
0:011> !heap 002057b8 -x
## Entry User Heap Segment Size PrevSize Flags
002057a8 002057b0 00170000 00170640 58 58 busy extra下面是!heap -x v命令的示例：
1:0:011> !heap 002057b8 -x -v
## 1:Entry User Heap Segment Size PrevSize Flags
002057a8 002057b0 00170000 00170640 58 58 busy extra
Search VM for address range 002057a8 - 002057ff : 00205990 (002057d0),在此示例中，有一个指向地址0x00205990 的堆块的指针。
下面是 !heap flt s命令的示例：
0:001>!heap -flt s 0x50这会显示大小0x50 的所有分配。
下面是 !heap flt r命令的示例：
0:001>!heap -flt r 0x50 0x80这会显示大小介于0x50 和0x7F 之间的每个分配。
下面是 !heap srch命令的示例。
0:001> !heap -srch 77176934
_HEAP @ 00090000
in HEAP_ENTRY: Size : Prev Flags - UserPtr UserSize - state
00099A48: 0018 : 0005 [01] - 00099A50 (000000B8) - (busy)
ole32!CALLFRAME_CACHE<INTERFACE_HELPER_CLSID>::`vftable'
_HEAP @ 00090000
in HEAP_ENTRY: Size : Prev Flags - UserPtr UserSize - state
00099B58: 0018 : 0005 [01] - 00099B60 (000000B8) - (busy)
ole32!CALLFRAME_CACHE<INTERFACE_HELPER_CLSID>::`vftable'轻型页堆块--已分配：
+-----+---------------+---+
| | | |
+-----+---------------+---+
^ ^ ^
| | 8 suffix bytes (filled with 0xA0)
| User allocation (filled with E0 if zeroing not requested)
Block header (starts with 0xABCDAAAA and ends with 0xDCBAAAAA)
轻型页堆块--已释放：
+-----+---------------+---+
| | | |
+-----+---------------+---+
^ ^ ^
| | 8 suffix bytes (filled with 0xA0)
| User allocation (filled with F0 bytes)
Block header (starts with 0xABCDAAA9 and ends with 0xDCBAAA9)
整页堆块--已分配：
+-----+---------+---+-------
| | | | ... N/A page
+-----+---------+---+-------
^ ^ ^
| | 0-7 suffix bytes (filled with 0xD0)
| User allocation (if zeroing not requested, filled
with C0)
Block header (starts with 0xABCDBBBB and ends with 0xDCBABBBB)
整页堆块--已释放：
+-----+---------+---+-------
| | | | ... N/A page
+-----+---------+---+-------
^ ^ ^
| | 0-7 suffix bytes (filled with 0xD0)
| User allocation (filled with F0 bytes)
Block header (starts with 0xABCDBBA and ends with 0xDCBABBBA) 要查看堆块或整页堆块的分配或释放的堆栈跟踪，请使用dt DPH_block_INFORMATION和头地址，然后使用dds和块的stack trace字段。
