原文

如果尚未加载指定的模块和方法，则此命令将在创建断点之前等待已加载并进行实时 (JIT) 编译的模块的通知。

你可以通过使用 -list、-clear 和 -clearall 选项来管理挂起断点的列表：

• 该 -list 选项生成所有挂起断点的列表。 如果挂起断点有一个非零模块 ID，则该断点特定于该特定已加载模块中的函数。 如果挂起断点有一个零模块 ID，则该断点适用于尚未加载的模块。
• 使用 -clear 或 -clearall 选项可从该列表中移除挂起断点。

• -p 选项显示托管函数的参数。
• -l 选项显示有关帧中的局部变量的信息。 SOS 调试扩展无法检索本地名称，因此本地名称的输出采用的格式为 <local address>= <value>。
• -a (all) 选项是 -l 和 -p的组合的快捷方式。
• -n 选项禁止显示源文件名和行号。 如果调试器已指定选项 SYMOPT_LOAD_LINES，则 SOS 将查找每个托管帧的符号，如果成功，则将显示对应的源文件名和行号。 可以指定 -n（无行号）参数来禁用此行为。

在基于 x64 和 IA-64 的平台上，SOS 调试扩展不显示过渡帧。

- 或 -

DA [-start<startIndex>] [-length<length>] [-detail] [-nofields] array object address>

• -start 选项指定开始显示元素的起始索引。
• -length 选项指定要显示的元素数量。
• -details 选项使用 DumpObj 和 DumpVC 格式显示元素的详细信息。
• -nofields 选项可阻止显示数组。 此选项仅在指定 -detail 选项后可用。

DumpAssembly 命令将列出多个模块（如果存在）。

可以通过使用 DumpDomain 命令获取程序集地址。

DumpClass 命令显示静态字段值，但不显示非静态字段值。

使用 DumpMT、DumpObj, Name2EE 或 Token2EE 命令获取 EEClass 结构地址。

如果 DumpHeap 命令在垃圾回收器堆中检测到过多碎片，将会显示警告。

• -stat 选项将输出限制为统计类型摘要。
• -strings 选项将输出限制为统计字符串值摘要。
• -short 选项将输出限制为只是每个对象的地址。 这使你能够轻松地以管道方式将输出从该命令转移到另一个调试器命令以实现自动化。
• -min 选项忽略小于 size 参数指定的大小（以字节为单位）的对象。
• -max 选项忽略大于 size 参数指定的大小（以字节为单位）的对象。
• -thinlock 选项报告 ThinLocks。有关详细信息，请参阅 SyncBlk 命令。
• -startAtLowerBound 选项将强制在提供的地址范围的下限开始堆审核。 在计划阶段，堆通常不可移动，因为对象正在移动。 此选项将强制 DumpHeap 在指定的下限开始其审核。 你必须提供有效的对象的地址作为使此选项工作的下限。 你可以显示错误对象的地址的内存来手动寻找下一个方法表。 如果垃圾回收当前处于对 memcopy 的调用中，则你还可以通过将大小添加到作为参数提供的起始地址中来查找下一个对象的地址。
• -mt 选项仅列出与指定的 MethodTable 结构对应的那些对象。
• -type 选项仅列出其类型名称为指定字符串的子字符串匹配项的那些对象。
• start 参数从指定的地址处开始列出。
• end 参数在指定的地址处停止列出。

请注意，发出的动态 MSIL 与从程序集加载的 MSIL 不同。 动态 MSIL 引用托管对象数组中的对象而不是引用元数据标记。

内存中压力日志可帮助你在不使用锁或 I/O 的情况下诊断压力故障。 若要启用压力日志，请在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework 下设置以下注册表项：

(DWORD) StressLog = 1

(DWORD) LogFacility = 0xffffffff

(DWORD) StressLogSize = 65536

利用可选的 -addr 选项，你可以指定压力日志而非默认日志。

可以使用 IP2MD 命令从托管函数中获取 MethodDesc 结构地址。

每个托管对象均包含一个方法表指针。

可以使用 DumpDomain 或 DumpAssembly 命令检索模块的地址。

- 或 -

DO <object address>

可以使用 DumpStackObjects 命令检索对象的地址。

请注意，可以对 CLASS 类型的字段运行 DumpObj 命令，因为这些字段也是对象。

- nofields 选项可阻止显示对象的字段，它对 String 这样的对象很有用。

• -EE 选项使 DumpStack 命令仅显示托管函数。 使用 top 和 bottom 参数可限制 x86 平台上显示的堆栈帧。
• -n 选项禁止显示源文件名和行号。 如果调试器已指定选项 SYMOPT_LOAD_LINES，则 SOS 将查找每个托管帧的符号，如果成功，则将显示对应的源文件名和行号。 可以指定 -n（无行号）参数来禁用此行为。

在 x86 和 x64 平台上，DumpStack 命令将创建详细的堆栈跟踪。

在基于 IA-64 的平台上，DumpStack 命令模拟调试器的 K 命令。 在基于 IA-64 的平台上，将忽略 top 和 bottom 参数。

- 或 -

DSO [-verify] [topstack [bottom stack]]

-verify 选项验证对象字段的每个非静态 CLASS 字段。

将 DumpStackObject 命令与堆栈跟踪命令（如 K 命令和 CLRStack 命令）一起使用以确定局部变量和参数的值。

MethodTable 参数使 DumpVC 命令可以正确解释字段。 值类不将方法表作为其第一个字段。

-gc 和 -loader 选项将此命令的输出限制为垃圾回收器或加载程序数据结构。

有关垃圾回收器的信息列出了托管堆中每个段的范围。如果指针落在由 -gc 给出的段范围内，则该指针是一个对象指针。

将 -EE 选项直接传递给 DumpStack 命令。 -short 参数将输出限制为以下类型的线程：

• 已获取锁的线程。
• 己停止运行以允许垃圾回收的线程。
• 当前在托管代码中的线程。

• -detail 选项显示有关需要清理的任何 SyncBlocks 的额外信息以及有关等待清理的任何 RuntimeCallableWrappers (RCW) 的额外信息。 这两种数据结构都由终结器线程在运行时进行缓存和清理。
• -allReady 选项显示所有准备终止的对象，无论它们已被垃圾回收标记成这样，还是将被下一个垃圾回收标记。 “准备终止”列表中的对象为不再为根的可终止对象。 此选项可能耗费大量资源，因为它验证可终止队列中的所有对象是否仍然为根对象。
• -short 选项将输出限制为每个对象的地址。 如果将此选项与 -allReady 一起使用，则将枚举具有不再为根的终结器的所有对象。如果单独使用此选项，则将列出终结和“准备终结”队列中的所有对象。

-perdomain 选项将按应用程序域排列统计信息。

使用 GCHandles 命令可查找由垃圾回收器句柄泄漏导致的内存泄漏。 例如，当代码由于强垃圾回收器句柄仍指向一个大型数组而保留该数组时，若不释放句柄就将其放弃，则会发生内存泄漏。

GCRoot 命令将检查整个托管堆和句柄表以查找其他对象内的句柄和堆栈上的句柄。 然后，在每个堆栈中搜索对象的指针，同时还搜索终结器队列。

此命令无法确定堆栈根是有效的还是已丢弃。 使用 CLRStack 和 U 命令可对本地或参数值所属的帧进行反汇编，以便确定堆栈根是否仍在使用中。

-nostacks 选项将搜索限制为垃圾回收器句柄和 Freachable 对象。

faq 参数显示常见问题的答案。

通常，你不必显式调用 HistClear，因为每个 HistInit 都会清理以前的资源。

根值可用于通过垃圾回收来跟踪对象的移动。

传递 0 以禁用此功能或传递 1 以启用此功能。 默认情况下，MinidumpMode 值设置为 0。

使用 .dump /m 命令或 .dump 命令创建的小型转储具有有限的特定于 CLR 的数据，允许你仅正确运行一小部分 SOS 命令。 有些命令可能会因错误而失败，因为所需的内存区域未被映射或仅被部分映射。 此选项可防止你对小型转储运行不安全的命令。

- 或 -

Name2EE <module name>!<type or method name>

在进程中必须加载指定的模块。

若要获取正确的类型名称，请通过使用 Ildasm.exe（IL 反汇编程序） 浏览模块。 也可以将 * 作为模块名参数传递以搜索所有已加载的托管模块。 module name 参数也可以是模块的调试器名称，如 mscorlib 或 image00400000。

此命令支持 <module>!<type> 的 Windows 调试器语法。 类型必须是完全限定的。

-aggregate 选项能够与 -stat 参数一起使用，以获得仍为根类型的类型的详细视图。 通过使用 !dumpheap -stat 和 !objsize -aggregate -stat，可以确定不再为根的对象并诊断各种内存问题。

- 或 -

PE [-nested] [<Exception object address>]

• -nested 选项显示有关嵌套异常对象的详细信息。
• -lines 选项显示源信息（如果可用）。

可以使用此命令设置 _stackTrace 字段的格式并查看该字段（它是一个二进制数组）。

-derived 选项用于捕获指定异常以及从指定异常派生的每个异常。

SyncBlock 结构是一个容器，用于存放无需为每个对象创建的额外信息。 它可以存放 COM 互操作数据、哈希代码和用于线程安全操作的锁定信息。

可以传递 * 作为模块名参数，以便在每个已加载的托管模块中查找该标记映射到的内容。 也可以传递某个模块的调试器名称，如 mscorlib或 image00400000。

Threads 命令显示调试器速记 ID、公共语言运行时线程 ID 以及操作系统线程 ID。此外，Threads 命令还会显示“Domain”列、“APT”列和“Exception”列，这三列分别用于指示正在执行某线程的应用程序域、显示 COM 单元模式以及显示该线程中引发的上一个异常。

• -live 选项显示与活动线程关联的线程。
• -special 选项显示由 CLR 创建的所有特殊线程。 特殊线程包括垃圾回收线程（在并发垃圾回收和服务器垃圾回收中）、调试器帮助程序线程、终结器线程、AppDomain 卸载线程和线程池计时器线程。

示例：

    0:003> !Threads
    ThreadCount:      2
    UnstartedThread:  0
    BackgroundThread: 1
    PendingThread:    0
    DeadThread:       0
    Hosted Runtime:   no
                                          PreEmptive   GC Alloc           Lock
           ID OSID ThreadOBJ    State     GC       Context       Domain   Count APT Exception
       0    1  250 0019b068      a020 Disabled 02349668:02349fe8 0015def0     0 MTA
       2    2  944 001a6020      b220 Enabled  00000000:00000000 0015def0     0 MTA (Finalizer)
    0:003> !ThreadState b220
        Legal to Join
        Background
        CLR Owns
        CoInitialized
        In Multi Threaded Apartment

可以从 Microsoft 下载中心下载 CLR 探查器。

• -gcinfo 选项使 U 命令显示方法的 GCInfo 结构。
• -ehinfo 选项显示方法的异常信息。 也可以使用 EHInfo 命令获取此信息。
• -n 选项禁止显示源文件名和行号。 如果调试器已指定选项 SYMOPT_LOAD_LINES，则 SOS 将查找每个托管帧的符号，如果成功，则将显示对应的源文件名和行号。 可以指定 -n 选项来禁用此行为。

错误构造的平台调用可能导致堆损坏。