SOS-Installer (dotnet-sos)

Dieser Artikel gilt für: ✔️ .NET Core 2.1 SDK und neuere Versionen

Installieren

Es gibt zwei Möglichkeiten, dotnet-sos herunterzuladen und zu installieren:

• Globales dotnet-Tool:

  Verwenden Sie zum Installieren der neuesten Releaseversion des NuGet-Pakets dotnet-sos den Befehl dotnet tool install:

  dotnet tool install --global dotnet-sos
  

• Direkter Download:

  Laden Sie die ausführbare Datei für das Tool herunter, die Ihrer Plattform entspricht:

  OS	Plattform
  Windows	x86 | x64 | Arm | Arm-x64
  Linux	x64 | Arm | Arm64 | musl-x64 | musl-Arm64

Übersicht

dotnet-sos [-h|--help] [options] [command]]

Beschreibung

Über das globale dotnet-sos-Tool wird die SOS-Debuggererweiterung installiert. Mit dieser Erweiterung können Sie den verwalteten .NET Core-Status von nativen Debuggern wie LLDB und WinDbg überprüfen.

Hinweis

Die Installation von SOS über das Tool dotnet-sos wird nur unter Linux oder macOS benötigt. Sie ist möglicherweise auch unter Windows erforderlich, wenn Sie ältere Debuggingtools verwenden. In neuen Versionen des Windows-Debuggers (>= Version 10.0.18317.1001 von WinDbg oder CDB) wird SOS automatisch aus dem Microsoft-Erweiterungskatalog geladen.

Optionen

• --version

  Zeigt Versionsinformationen an.

• -h|--help

  Zeigt die Hilfe für die Befehlszeile an.

dotnet-sos install

Mit diesem Befehl wird die SOS-Erweiterung zum Debuggen von.NET Core-Prozessen lokal installiert. Unter macOS und Linux wird die LLDBINIT-Datei so aktualisiert, dass die Erweiterung beim Starten von LLDB automatisch geladen wird. Wenn Sie SOS unter Windows mit älteren Debuggingtools (niedriger als Version 10.0.18317.1001) installieren, müssen Sie die Erweiterung manuell in WinDbg oder CDB laden, indem Sie .load %USERPROFILE%\.dotnet\sos\sos.dll im Debugger ausführen.

Übersicht

dotnet-sos install [--architecture <arch>]

Optionen

• --architecture <arch>

  Gibt die Prozessorarchitektur der zu installierenden SOS-Binärdateien an. Standardmäßig installiert dotnet-sos die Architektur des Hostcomputers. Verwenden Sie diese Option, wenn Sie SOS für eine Architektur installieren möchten, die sich von der dotnet-Hostarchitektur unterscheidet. Wenn Sie beispielsweise Arm32-Binärdateien über einen Arm64-Host ausführen, müssen Sie SOS mit dotnet-sos install --architecture Arm installieren.

  Die folgenden Architekturen sind verfügbar:

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos uninstall

Mit diesem Befehl wird die SOS-Erweiterung deinstalliert und unter Linux und macOS aus der LLDB-Konfiguration entfernt.

Übersicht

dotnet-sos uninstall