本文适用于: ✔️ .NET Core 2.1 SDK 及更高版本
安装
可采用两种方法来下载和安装 dotnet-sos:
dotnet 全局工具:
若要安装最新版 dotnet-sos NuGet 包,请使用 dotnet tool install 命令:
dotnet tool install --global dotnet-sos
直接下载:
下载与平台相匹配的工具可执行文件:
(OS)
平台
Windows
x86 | x64 | arm | arm-x64
macOS
x64
Linux
x64 | arm | arm64 | musl-x64 | musl-arm64
摘要
dotnet-sos [-h|--help] [options] [command]]
说明
dotnet-sos 全局工具将安装 SOS 调试程序扩展。 借助此扩展,你可以从本机调试器(如 lldb 和 windbg)检查托管 .NET Core 状态。
备注
只有 Linux 或 macOS 需要通过 dotnet-sos 工具安装 SOS。 如果使用的是旧版调试工具,则 Windows 也可能需要使用此工具。 Windows 调试程序的最新版本(WinDbg 或 cdb 的版本 10.0.18317.1001 及更高版本)会从 Microsoft 扩展程序库自动加载 SOS。
选项
--version
显示版本信息。
-h|--help
显示命令行帮助。
安装 dotnet-sos
在本地安装用于调试 .NET Core 进程的 SOS 扩展。 在 macOS 和 Linux 上,将更新 .lldbinit 文件,以便扩展在 lldb 启动时自动加载。 如果要使用较旧的调试工具(低于版本 10.0.18317.1001)在 Windows 上安装 SOS,则需要通过在调试程序中运行 .load %USERPROFILE%.dotnetsossos.dll 以在 WinDbg 或 cdb 中手动加载扩展。
摘要
dotnet-sos install [--architecture <arch>]
选项
--architecture <arch>
指定要安装的 SOS 二进制文件的处理器体系结构。 默认情况下,dotnet-sos 安装主机的体系结构。 当你要为与 dotnet 主机体系结构不同的体系结构安装 SOS 时,请使用此选项。 例如,如果要从 Arm64 主机运行 Arm32 二进制文件,则需要使用 dotnet-sos install --architecture Arm 安装 SOS。
可以使用以下体系结构:
Arm
Arm64
X86
X64
卸载 dotnet-sos
卸载 SOS 扩展名,并在 Linux 和 macOS 上将其从 lldb 配置中删除。
摘要
dotnet-sos uninstall