SOS 安裝程式 (dotnet-sos)

本文適用於： ✔️ .NET Core 2.1 SDK 與更新版本

安裝

有兩種方法可下載並安裝 dotnet-sos：

• dotnet 全域工具：

  若要安裝最新發行版本的 dotnet-sosNuGet 套件 (英文)，請使用 dotnet 工具安裝命令：

  dotnet tool install --global dotnet-sos
  

• 直接下載：

  下載適用於您平台的工具可執行檔：

  OS	平台
  Windows	x86 | x64 | Arm | Arm-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 偵錯工具 的較新版本 (> = 10.0.18317.1001 版本的 WinDbg 或 cdb) 會自動從 Microsoft 延伸模組資源庫載入 SOS。

選項。

• --version

  顯示版本資訊。

• -h|--help

  顯示命令列說明。

安裝 dotnet-sos

請於本機安裝 SOS 延伸模組 來針對 .NET Core 流程進行偵錯。 在 macOS 和 Linux 上，系統會更新 .lldbinit 檔案，好讓延伸模組自動於 lldb 啟動時載入。 如果您在 Windows 上安裝 SOS 並搭配舊版偵錯工具 (版本早於 10.0.18317.1001)，則需在偵錯工具中執行 .load %USERPROFILE%\.dotnet\sos\sos.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