次の方法で共有

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

  • [アーティクル]

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

インストール

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 の状態を検査できます。

注意

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