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

この記事の対象: ✔️ .NET Core 2.1 SDK 以降のバージョン

インストール

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

• dotnet グローバル ツール:

  dotnet-sosdotnet-sosの最新のリリース バージョンをインストールするには、次のように 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 の状態を検査できます。

注意

dotnet-sos ツールから SOS をインストールすることは、Linux または macOS の場合のみ必要です。 古いデバッグ ツールを使用している場合、Windows でも必要になることがあります。 Windows Debugger (>= WinDbg または cdb のバージョン 10.0.18317.1001) の最近のバージョンでは、Microsoft 拡張機能ギャラリーから自動的に SOS がロードされます。

オプション

• --version

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

• -h|--help

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

dotnet-sos install

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

概要

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