SOS インストーラー (dotnet-sos)

この記事は、✔️ .NET 6.0 SDK 以降のバージョンに適用されます。

注意

代わりに、.NET デバッガー拡張機能 を使用することを検討してください。これには、SOS 機能と追加機能が含まれます。

インストール

dotnet-sos をダウンロードしてインストールするには、次の 2 つの方法があります。

• dotnet グローバル ツール:

  dotnet-sos NuGet パッケージの最新のリリース バージョンをインストールするには、次のように dotnet tool install コマンドを使用します。

  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 の状態を調べることができます。

オプション

• --version

  バージョン情報を表示します。

• -h|--help

  コマンド ライン ヘルプを表示します。

dotnet-sos install

.NET Core プロセスをデバッグするために、SOS 拡張機能をローカルにインストールします。 macOS および Linux では、拡張子が LLDB の起動時に自動的に読み込まれるように、.lldbinit ファイルが更新されます。 以前のデバッグ ツール (バージョン 10.0.18317.1001 より前) を使用して Windows に SOS をインストールする場合は、デバッガーで .load %USERPROFILE%\.dotnet\sos\sos.dll を実行して、WinDbg または cdb に拡張機能を手動で読み込む必要があります。

これにより、dotnet-debugger-extensions または dotnet-sos インストーラーからの以前のインストールが上書きされます。

構文

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 uninstall

SOS 拡張機能 をアンインストールし、Linux および macOS では LLDB 構成から削除します。

構文

dotnet-sos uninstall