Instalační program SOS (dotnet-sos)

Tento článek se vztahuje na: ✔️ .NET Core 2.1 SDK a novější verze

Instalace

Existují dva způsoby stažení a instalace dotnet-sos:

• globální nástroj dotnet:

  Pokud chcete nainstalovat nejnovější vydanou dotnet-sos verzi balíčku NuGet, použijte příkaz dotnet install:

  dotnet tool install --global dotnet-sos
  

• Přímé stažení:

  Stáhněte spustitelný soubor nástroje, který odpovídá vaší platformě:

  Operační systém	Platforma
  Windows	x86 | x64 | Rameno | ARM-x64
  Linux	x64 | Rameno | Arm64 | musl-x64 | musl-Arm64

Synopse

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

Description

Globální dotnet-sos nástroj nainstaluje rozšíření ladicího programu SOS. Toto rozšíření umožňuje zkontrolovat spravovaný stav .NET Core z nativních ladicích programů, jako jsou lldb a windbg.

Poznámka

Instalace SOS prostřednictvím nástroje dotnet-sos je potřeba jenom v Linuxu nebo macOS. Pokud používáte starší ladicí nástroje, může být potřeba i ve Windows. Nedávné verze ladicího programu Windows (>= verze 10.0.18317.1001 WinDbg nebo cdb) načítají SOS automaticky z galerie rozšíření Microsoftu.

Možnosti

• --version

  Zobrazí informace o verzi.

• -h|--help

  Zobrazuje nápovědu k příkazovému řádku.

dotnet-sos install

Nainstaluje rozšíření SOS místně pro ladění procesů .NET Core. V systémech macOS a Linux se soubor .lldbinit aktualizuje tak, aby se rozšíření automaticky načte při spuštění lldb. Pokud instalujete SOS do Windows se staršími ladicími nástroji (starší než verze 10.0.18317.1001), budete muset ručně načíst rozšíření v windbg nebo cdb spuštěním .load %USERPROFILE%\.dotnet\sos\sos.dll v ladicím programu.

Synopse

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

Možnosti

• --architecture <arch>

  Určuje architekturu procesoru binárních souborů SOS, které se mají nainstalovat. Ve výchozím nastavení dotnet-sos nainstaluje architekturu hostitelského počítače. Tuto možnost použijte, pokud chcete nainstalovat SOS pro architekturu, která se liší od architektury hostitele dotnet. Pokud například používáte binární soubory Arm32 z hostitele Arm64, budete muset nainstalovat SOS pomocí dotnet-sos install --architecture Arm.

  K dispozici jsou následující architektury:

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos uninstall

Odinstaluje rozšíření SOS a v Linuxu a macOS ho odebere z konfigurace lldb.

Synopse

dotnet-sos uninstall