Programma di installazione di SOS (dotnet-sos)

Questo articolo si applica a: ✔️ .NET Core 2.1 SDK e versioni successive

Installare

Esistono due modi per scaricare e installare dotnet-sos:

• Strumento globale dotnet:

  Per installare la versione più recente del dotnet-sos pacchetto NuGet, usare il comando dotnet tool install :

  dotnet tool install --global dotnet-sos
  

• Download diretto:

  Scaricare lo strumento eseguibile corrispondente alla piattaforma:

  Sistema operativo	Piattaforma
  Finestre	x86 | x64 | Arm | Arm-x64
  Linux	x64 | Arm | Arm64 | musl-x64 | musl-Arm64

Riepilogo

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

Descrizione

Lo strumento globale dotnet-sos installa l'estensione del debugger SOS. Questa estensione consente di controllare lo stato gestito di .NET Core da debugger nativi come lldb e windbg.

Nota

L'installazione di SOS tramite lo strumento dotnet-sos è necessaria solo in Linux o macOS. Potrebbe essere necessaria anche in Windows se si usano strumenti di debug meno recenti. Le versioni recenti di Windows Debugger (>= versione 10.0.18317.1001 di WinDbg o cdb) caricano automaticamente SOS dalla raccolta di estensioni Microsoft.

Opzioni

• --version

  Visualizza informazioni sulla versione.

• -h|--help

  Mostra la Guida della riga di comando.

dotnet-sos install

Installa l'estensione SOS in locale per il debug dei processi .NET Core. In macOS e Linux il file .lldbinit verrà aggiornato in modo che l'estensione venga caricata automaticamente all'avvio di lldb. Se si installa SOS in Windows con strumenti di debug meno recenti (prima della versione 10.0.18317.1001), sarà necessario caricare manualmente l'estensione in WinDbg o cdb eseguendo .load %USERPROFILE%\.dotnet\sos\sos.dll nel debugger.

Riepilogo

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

Opzioni

• --architecture <arch>

  Specifica l'architettura del processore dei file binari SOS da installare. Per impostazione predefinita, dotnet-sos installa l'architettura del computer host. Usare questa opzione quando si vuole installare SOS per un'architettura diversa dall'architettura dell'host dotnet. Ad esempio, se si eseguono file binari Arm32 da un host Arm64, sarà necessario installare SOS con dotnet-sos install --architecture Arm.

  Sono disponibili le architetture seguenti:

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos uninstall

Disinstalla l'estensione SOS e, in Linux e macOS, la rimuove dalla configurazione lldb.

Riepilogo

dotnet-sos uninstall