Programma di installazione di SOS (dotnet-sos)

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

Nota

Prendere in considerazione l'uso delle estensioni del debugger .NET , che includono invece la funzionalità SOS e le funzionalità aggiuntive.

Installare

Esistono due modi per scaricare e installare dotnet-sos:

• Strumento globale dotnet:

  Per installare la versione più recente del dotnet-sospacchetto 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.

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 viene 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), è necessario caricare manualmente l'estensione in WinDbg o cdb eseguendo .load %USERPROFILE%\.dotnet\sos\sos.dll nel debugger.

In questo modo vengono sovrascritti le installazioni precedenti dai programmi di installazione dotnet-debugger-extensions o dotnet-sos.

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, è 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