SOS 调试扩展 (SOS.dll) 通过提供有关内部公共语言运行时 (CLR) 环境的信息，帮助您在 WinDbg.exe 调试器和 Visual Studio 中调试托管程序。 此工具需要您启用项目的非托管调试。还可以将 SOS 调试扩展用于 Windows 调试器 (WinDbg.exe)。
安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具，我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符（也称 CMD Shell）。 您可以使用这些实用程序轻松运行工具，而不需要导航到安装文件夹。 有关更多信息，请参见 Visual Studio 和 Windows SDK 命令提示。
-
如果您的计算机上已安装了 Visual Studio：在任务栏上依次单击 Start、All Programs、Visual Studio、Visual Studio Tools、Visual Studio Command Prompt。
- 或 -
如果您的计算机上已安装了 Windows SDK：在任务栏上依次单击 Start、All Programs、Windows SDK 文件夹和 Command Prompt（或CMD Shell)。
-
在命令提示处，键入下列命令：
![command] [options]
| 命令 | 说明 |
|---|---|
| AnalyzeOOM (ao) | 显示对垃圾回收堆进行分配请求时发生的最后 OOM 的信息。 （在服务器垃圾回收中，它将在每个垃圾回收堆上显示 OOM（如果有））。 |
| BPMD [-nofuturemodule] [<模块名> <方法名>] [-md <MethodDesc>] -list-clear <挂起断点数> -clearall | 在指定模块中的指定方法处创建断点。 如果尚未加载指定的模块和方法，则此命令将在创建断点之前等待已加载并实时 (JIT) 编译模块的通知。 您可以通过使用 -list、-clear 和 -clearall 选项来管理挂起断点的列表：
|
| CLRStack [-a] [-l] [-p] [-n] | 仅提供托管代码的堆栈跟踪。
在基于 x64 和 IA-64 的平台上，SOS 调试扩展不显示过渡帧。 |
| COMState | 列出每个线程的 COM 单元模型和 Context 指针（如果有）。 |
| DumpArray [-start <起始索引>] [-length <长度>] [-details] [-nofields] <数组对象地址> - 或 - DA [-start起始索引] [-length长度] [-detail] [-nofields] 数组对象地址 | 检查数组对象的元素。
|
| DumpAssembly <程序集地址> | 显示有关程序集的信息。 DumpAssembly 命令将列出多个模块（如果存在）。 可以通过使用 DumpDomain 命令获取程序集的地址。 |
| DumpClass <EEClass 地址> | 显示有关与类型关联的 EEClass 结构的信息。 DumpClass 命令显示静态字段值，但不显示非静态字段值。 使用 DumpMT、DumpObj, Name2EE 或 Token2EE 命令获取 EEClass 结构的地址。 |
| DumpDomain [<域地址>] | 枚举在指定的 AppDomain 对象地址内加载的每个 Assembly 对象。 若在调用 DumpDomain 命令时不提供任何参数，则将列出进程中的所有 AppDomain 对象。 |
| DumpHeap [-stat] [-strings] [-short] [-min <大小>] [-max <大小>] [-thinlock] [-startAtLowerBound] [-mt <MethodTable 地址>] [-type <分部类型名称>][起始[结束]] | 显示有关垃圾回收堆的信息和有关对象的回收统计信息。 如果 DumpHeap 命令检测到垃圾回收器堆中存在过多碎片，将会显示警告。
|
| DumpIL <托管 DynamicMethod 对象> | <DynamicMethodDesc 指针> | <MethodDesc 指针> | 显示与托管方法关联的 Microsoft 中间语言 (MSIL)。 请注意，发出的动态 MSIL 与从程序集加载的 MSIL 不同。 动态 MSIL 引用托管对象数组中的对象而不是引用元数据标记。 |
| DumpLog [-addr <压力测试日志的地址>] [<文件名e>] | 将内存中压力日志的内容写入到指定文件。 如果您不指定文件名，则此命令将在当前目录中创建一个名为 StressLog.txt 的文件。 内存中压力日志可帮助您在不使用锁或 I/O 的情况下诊断压力故障。 若要启用压力日志，请在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework 下设置以下注册表项： (DWORD) StressLog = 1 (DWORD) LogFacility = 0xffffffff (DWORD) StressLogSize = 65536 可选 -addr 选项使您可以指定压力日志而非默认日志。 |
| DumpMD <MethodDesc 地址> | 显示有关指定地址处的 MethodDesc 结构的信息。 可以使用 IP2MD 命令从托管函数中获取 MethodDesc 结构地址。 |
| DumpMT [-MD] <MethodTable 地址> | 显示有关指定地址处的方法表的信息。 指定 -MD 选项将显示与对象一起定义的所有方法的列表。 每个托管对象都包含一个方法表指针。 |
| DumpMethodSig <sigaddr> <moduleaddr> | 显示有关指定地址处的 MethodSig 结构的信息。 |
| DumpModule [-mt] <模块地址> | 显示有关指定地址处的模块的信息。 -mt 选项显示模块中定义的类型和模块所引用的类型。 可以使用 DumpDomain 或 DumpAssembly 命令检索模块的地址。 |
| DumpObj [-nofields] <对象地址> - 或 - DO <对象地址> | 显示有关指定地址处的对象的信息。 DumpObj 命令显示对象的字段、EEClass 结构信息、方法表和大小。 可以使用 DumpStackObjects 命令检索对象的地址。 请注意，可以对 CLASS 类型的字段运行 DumpObj 命令，因为这些字段也是对象。 -nofields 选项可防止对象的字段显示，它对 String 那样的对象很有用。 |
| DumpRuntimeTypes | 显示垃圾回收器堆中的运行时类型对象并列出其关联的类型名称和方法表。 |
| DumpStack [-EE] [-n] [top 堆栈 [bottom 堆栈k]] | 显示堆栈跟踪。
在 x86 和 x64 平台上，DumpStack 命令将创建详细的堆栈跟踪。 在基于 IA-64 的平台上，DumpStack 命令将模拟执行调试器的 K 命令。 在基于 IA-64 的平台上，将忽略 top 和 bottom 参数。 |
| DumpSig <信号地址> <模块地址> | 显示有关指定地址处的 Sig 结构的信息。 |
| DumpSigElem <信号地址> <模块地址> | 显示签名对象的单个元素。 大多数情况下，您应该使用 DumpSig 查看单个签名对象。 但是，如果签名已通过某种方式损坏，则可以使用 DumpSigElem 读取它的有效部分。 |
| DumpStackObjects [-verify] [top 堆栈 [bottom堆栈]] - 或 - DSO [-verify] [top 堆栈 [bottom 堆栈 ]] | 显示在当前堆栈的边界内找到的所有托管对象。 -verify 选项验证对象字段的每个非静态 CLASS 字段。 将 DumpStackObject 命令与堆栈跟踪命令（如 K 命令和 CLRStack 命令）一起使用，以确定局部变量和参数的值。 |
| DumpVC <MethodTable 地址> <地址> | 显示有关指定地址处的值类字段的信息。 MethodTable 参数使 DumpVC 命令可以正确解释字段。 值类不使用方法表作为它的第一个字段。 |
| EEHeap [-gc] [-loader] | 显示有关内部公共语言运行时数据结构所使用的进程内存的信息。 -gc 和 -loader 选项将此命令的输出限制为垃圾回收器或加载程序数据结构。 有关垃圾回收器的信息列出了托管堆中每个段的范围。 如果指针落在由 -gc 给出的段范围内，则该指针是一个对象指针。 |
| EEStack [-short] [-EE] | 对一个进程中的所有线程运行 DumpStack 命令。 将 -EE 选项直接传递给 DumpStack 命令。 -short 参数将输出限制为以下类型的线程：
|
| EEVersion | 显示公共语言运行时版本。 |
| EHInfo [<MethodDesc 地址>] [<代码地址>] | 显示指定方法中的异常处理块。 此命令显示子句块（try 块）和处理程序块（catch 块）的代码地址和偏移量。 |
| FAQ | 显示常见问题。 |
| FinalizeQueue [-detail] | [-allReady] [-short] | 显示所有已进行终结注册的对象。
|
| FindAppDomain <对象地址> | 确定指定地址处的对象的应用程序域。 |
| FindRoots-gen <N> | -gen any |<对象地址> | 导致调试器在指定生产的下次回收时在调试对象中中断。 在中断发生时立即重置该效果。 若要中断下一个集合，您必须重新发出该命令。 此命令的 <对象地址> 形式在 -gen 或 -gen any 创建的中断发生后使用。 此时，调试对象处于正确的状态，以便FindRoots 从当前已报废的生产中识别出对象的根。 |
| GCHandles [-perdomain] | 显示有关进程中的垃圾回收器句柄的统计信息。 -perdomain 选项将按应用程序域排列统计信息。 使用 GCHandles 命令可查找由垃圾回收器句柄泄漏导致的内存泄漏。 例如，当代码由于强垃圾回收器句柄仍指向一个大型数组而保留该数组时，若不释放句柄就将其放弃，则会发生内存泄漏。 |
| GCHandleLeaks | 在内存中搜索进程中的对强垃圾回收器句柄和固定垃圾回收器句柄的任何引用并显示结果。 如果找到某个句柄，GCHandleLeaks 命令将显示相应的引用地址。 如果在内存中找不到句柄，此命令将显示一个通知。 |
| GCInfo <MethodDesc 地址><代码地址> | 显示指示寄存器或堆栈位置何时包含托管对象的数据。 如果发生垃圾回收，回收器必须知道对象引用的位置，以便可以使用新的对象指针值更新相应的对象引用。 |
| GCRoot [-nostacks] <对象地址> | 显示有关对指定地址处的对象的引用（或根）的信息。 GCRoot 命令将检查整个托管堆和句柄表以查找其他对象内的句柄和堆栈上的句柄。 然后，在每个堆栈中搜索对象的指针，同时还搜索终结器队列。 此命令无法确定堆栈根是有效的还是已丢弃。 使用 CLRStack 和 U 命令可对本地或参数值所属的帧进行反汇编，以便确定堆栈根是否仍在使用中。 -nostacks 选项将搜索限制为垃圾回收器句柄和 Freachable 对象。 |
| GCWhere <对象地址> | 显示垃圾回收堆中参数传入的位置和大小。 当参数位于托管堆中，但不是一个有效的对象地址时，大小显示为 0（零）。 |
| help [<命令>] [faq] | 在未指定参数时显示所有可用命令，或者显示有关指定命令的详细帮助信息。 faq 参数显示常见问题的答案。 |
| HeapStat [-inclUnrooted |-iu] | 显示每个堆的生成大小及每个堆上各生成的可用空间总量。 如果指定了 -inclUnrooted 选项，则报告将包括有关不再为根的垃圾回收集合堆中的托管对象的信息。 |
| HistClear | 释放由 Hist 命令系列使用的任何资源。 通常，您不必显式调用 HistClear，因为每个 HistInit 都会清理以前的资源。 |
| HistInit | 从保存在调试对象中的压力日志初始化 SOS 结构。 |
| HistObj<对象地址> | 检查所有压力日志的重定位记录，并显示可能已将地址作为参数传入的垃圾回收重定位链。 |
| HisttObjFind <obj_address> | 显示在指定地址处引用对象的所有日志项。 |
| HistRoot<根位置> | 显示与提升和重定位指定根相关的信息。 根值可用于跟踪对象通过垃圾回收的移动。 |
| IP2MD <代码地址> | 显示已 JIT 编译的代码中指定地址处的 MethodDesc 结构。 |
| ListNearObj (lno) <对象地址> | 显示指定地址之前和指定地址之后的对象。 该命令在垃圾回收堆和参数地址之后的对象中寻找地址，而该垃圾回收堆看上去像托管对象（基于有效的方法表）的有效开头。 |
| MinidumpMode [0] [1] | 防止在使用小型转储时运行不安全的命令。 传递 0 以禁用此功能或传递 1 以启用此功能。 默认情况下，MinidumpMode 值设置为 0。 使用 .dump /m 命令或 .dump 命令创建的小型转储具有有限的特定于 CLR 的数据，只允许您正确运行 SOS 命令的一个子集。有些命令可能会因意外错误而失败，出错原因在于所需的内存区域未被映射或仅被部分映射。 此选项可防止您对小型转储运行不安全的命令。 |
| Name2EE <模块名> <类型名或方法名> - 或 - Name2EE <模块名>!<类型名或方法名> | 显示指定模块中指定类型或方法的 MethodTable 结构和 EEClass 结构。 在进程中必须加载指定的模块。 若要获取正确的类型名称，请通过使用 Ildasm.exe（MSIL 反汇编程序） 浏览模块。 也可以将 * 作为模块名参数传递，以搜索所有已加载的托管模块。 模块名 参数也可以是模块的调试器名称，如 mscorlib 或 image00400000。 此命令支持 Windows 调试器语法：<module>!<type>。 类型必须是完全限定的。 |
| ObjSize [<对象地址>] | [-aggregate] [-stat] | 显示指定对象的大小。 如果您未指定任何参数，则 ObjSize 命令将显示在托管线程上找到的所有对象的大小，显示进程中的所有垃圾回收器句柄，并对这些句柄指向的任何对象的大小进行合计。 除父对象之外，ObjSize 命令还包括所有子对象的大小。 -aggregate 选项能够与 -stat 参数一起使用，以获得仍然为根类型的类型的详细视图。 通过使用 !dumpheap -stat 和 !objsize -aggregate -stat，可以确定不再为根的对象并诊断各种内存问题。 |
| PrintException [-nested] [-lines] [<异常对象地址>] - 或 - PE [-nested] [<异常对象地址>] | 显示从指定地址处的 Exception 类派生的任何对象的字段并设置这些字段的格式。 如果不指定地址，PrintException 命令将显示在当前线程上引发的最后一个异常。
可以使用此命令设置 _stackTrace 字段的格式化并查看该字段，该字段是一个二进制数组。 |
| ProcInfo [-env] [-time] [-mem] | 显示进程的环境变量、内核 CPU 时间和内存使用统计信息。 |
| RCWCleanupList <RCWCleanupList 地址> | 显示在指定地址处等待清理的运行时可调用包装的列表。 |
| SaveModule <基址> <文件名> | 将加载到内存中指定地址的图像写入指定文件。 |
| SOSFlush | 刷新内部 SOS 缓存。 |
| StopOnException [-derived] [-create | -create2] <异常> <伪寄存器号> | 使调试器在引发指定异常时停止，但在引发其他异常时继续运行。 -derived 选项用于捕获指定异常以及从指定异常派生的每个异常。 |
| SyncBlk [-all | <syncblk 号>] | 显示指定的 SyncBlock 结构或所有 SyncBlock 结构。 如果不传递任何参数，SyncBlk 命令将显示与一个线程拥有的对象对应的SyncBlock 结构。 SyncBlock 结构是一个容器，用于存放无需为每个对象创建的额外信息。 它可以存放 COM 互操作数据、哈希代码和用于线程安全操作的锁定信息。 |
| ThreadPool | 显示有关托管线程池的信息，包括队列中工作请求的数目、完成端口线程的数目和计时器的数目。 |
| Token2EE <模块名> <标记> | 将指定模块中的指定元数据标记转换成 MethodTable 结构或 MethodDesc 结构。 可以传递 * 作为模块名参数，以便在每个已加载的托管模块中查找该标记映射到的内容。 也可以传递某个模块的调试器名称，如 mscorlib 或 image00400000。 |
| Threads [-live] [-special] | 显示进程中的所有托管线程。 Threads 命令显示调试器速记 ID、公共语言运行时线程 ID 以及操作系统线程 ID。 此外，Threads 命令还会显示“Domain”（域）列、“APT”列和“Exception”（异常）列，这三列分别用于指示正在执行某线程的应用程序域、COM 单元模式以及该线程中引发的上一个异常。
|
| ThreadState <状态值字段> | 显示线程的状态。 value 参数为 Threads 报告输出中的 State 字段的值。 示例： 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
|
| TraverseHeap [-xml] <文件名> | 以 CLR 探查器能够识别的格式将堆信息写入指定文件。 -xml 选项使 TraverseHeap 命令将文件格式化为 XML。 可以从 Microsoft 下载中心下载 CLR 探查器。 |
| U [-gcinfo] [-ehinfo] [-n] <MethodDesc 地址> | <代码地址> | 显示由方法的 MethodDesc 结构指针或方法体内的代码地址指定的托管方法的反汇编（带有批注）。 U 命令将从开始到结束显示整个方法，并带有将元数据标记转换为名称的批注。
|
| VerifyHeap | 检查垃圾回收器堆中是否有损坏迹象，并显示找到的任何错误。 错误构造的平台调用可能导致堆损坏。 |
| VerifyObj <对象地址> | 检查作为参数传递的对象是否有损坏迹象。 |
| VMMap | 遍历虚拟地址空间并显示应用于每个区域的保护类型。 |
| VMStat | 提供虚拟地址空间的摘要视图，并按应用于该内存的每种保护类型（可用、已保留、已提交、私有、已映射和映像）排序。“TOTAL”列显示“AVERAGE”列乘以“BLK COUNT”列的结果。 |
使用 SOS 调试扩展的方法是，将其加载到 WinDbg.exe 调试器中，该工具也可以从 WDK and Developer Tools（WDK 和开发人员工具）网站获得，或者加载到 Visual Studio 2005 中。 可以在 WinDgb.exe 或 Visual Studio 的“即时”窗口中执行命令。
SOS 调试扩展允许您查看有关在公共语言运行时内运行的代码的信息。 例如，可以使用 SOS 调试扩展显示有关托管堆的信息、查找堆损坏情况、显示运行时所使用的内部数据类型以及查看有关在运行时内运行的所有托管代码的信息。
加载 SOS 调试扩展
若要将 SOS 调试扩展加载到 WinDbg.exe 调试器中，工具请在工具中运行以下命令：
.loadby sos clr
若要将 SOS 调试扩展加载到 Visual Studio 中，请在调试时在“即时”窗口中运行以下命令：
.load SOS.dll
如果命令成功，将在“即时”窗口中返回以下消息：
extension C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\sos.dll loaded
必须首先在解决方案的项目设置中启用非托管调试，才能加载 SOS 调试扩展。 对于某些语言，默认情况下将禁用非托管调试。 有些平台不允许同时调试托管代码和非托管代码。
 注意 |
|---|
| 若要显示 Visual Studio 中的“即时”窗口，请在“调试”菜单上指向“窗口”，再单击“即时”选项。 也可以通过按 Ctrl+Alt+I 打开 Visual Studio 中的“即时”窗口。 |
WinDbg.exe 和 Visual Studio 使用与当前使用的 Mscorwks.dll 版本对应的 SOS.dll 版本。 在 .NET Framework 1.1 和 2.0 版中，SOS.dll 安装在与 Mscorwks.dll 相同的目录中。 默认情况下，应使用与当前版本的 Mscorwks.dll 匹配的 SOS.dll 版本。
若要使用在其他计算机上创建的转储文件，请确保该安装所附带的 Mscorwks.dll 文件存在于符号路径中，并加载相应的 SOS.dll 版本。
若要加载特定版本的 SOS.dll，请在 Windows 调试器中键入以下命令：
.load <full path to sos.dll>
下面的命令显示在地址 00ad28d0 处的数组内容。 显示从第二个元素开始，连续显示五个元素。
!dumparray -start 2 -length 5 -detail 00ad28d0
下面的命令显示在地址 1ca248 处的程序集的内容。
!dumpassembly 1ca248
下面的命令显示有关垃圾回收器堆的信息。
!dumpheap
下面的命令将内存中压力日志的内容写入到当前目录中名为 StressLog.txt 的（默认）文件中。
!DumpLog
下面的命令显示在地址 902f40 处的 MethodDesc 结构。
!dumpmd 902f40
下面的命令显示有关在地址 1caa50 处的模块的信息。
!dumpmodule 1caa50
下面的命令显示有关在地址 a79d40 处的对象的信息。
!DumpObj a79d40
下面的命令使用在地址 0090320c 处的方法表显示在地址 00a79d9c 处的值类的字段。
!DumpVC 0090320c 00a79d9c
下面的命令显示垃圾回收器所使用的进程内存。
!eeheap -gc
下面的命令显示所有已做好终结计划的对象。
!finalizequeue
下面的命令确定在地址 00a79d98 处的对象的应用程序域。
!findappdomain 00a79d98
下面的命令显示当前进程中的所有垃圾回收器句柄。
!gcinfo 5b68dbb8
下面的命令显示模块 unittest.exe 的类 MainClass 中的 Main 方法的 MethodTable 和 EEClass 结构。
!name2ee unittest.exe MainClass.Main
下面的命令显示有关在模块 unittest.exe 中的地址 02000003 处的元数据标记的信息。
!token2ee unittest.exe 02000003
扫一扫
1191
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
