SOS-Installer (dotnet-sos)

Dieser Artikel bezieht sich auf: ✔️ .NET 6.0 SDK und höhere Versionen

Hinweis

Erwägen Sie stattdessen die Verwendung der .NET-Debuggererweiterungen, die die SOS-Funktionalität und zusätzliche Features enthalten.

Installieren

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

• Globales dotnet-Tool:

  Verwenden Sie zum Installieren der neuesten Releaseversion des 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 verwalteten .NET Core-Zustand aus systemeigenen Debuggern wie LLDB und WinDbg prüfen.

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 aktualisiert, sodass die Erweiterung beim LLDB-Start automatisch geladen wird. Wenn Sie SOS unter Windows mit älteren Debuggingtools (vor Version 10.0.18317.1001) installieren, müssen Sie die Erweiterung in WinDbg oder cdb manuell laden, indem Sie .load %USERPROFILE%\.dotnet\sos\sos.dll im Debugger ausführen.

Dadurch werden alle vorherigen Installationen aus den dotnet-debugger-extensions oder dotnet-sos-Installern überschrieben.

Ü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 von einem Arm64-Host ausführen, müssen Sie SOS mit dotnet-sos install --architecture Arminstallieren.

  Die folgenden Architekturen sind verfügbar:

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos uninstall

Deinstalliert die SOS-Erweiterung und entfernt sie unter Linux und macOS aus der LLDB-Konfiguration.

Übersicht

dotnet-sos uninstall