Programme d’installation SOS (dotnet-sos)

Cet article s’applique à : ✔️ SDK .NET Core 2.1 et versions ultérieures

Installer

Il existe deux façons de télécharger et d’installer dotnet-sos :

• outil global dotnet :

  Pour installer la dernière version de version du dotnet-sospackage NuGet, utilisez la commande d’installation de l’outil dotnet :

  dotnet tool install --global dotnet-sos
  

• Téléchargement direct :

  Téléchargez l’exécutable de l’outil qui correspond à votre plateforme :

  Système d''exploitation	Plateforme
  Windows	x86 | x64 | Arm | Arm-x64
  Linux	x64 | Arm | Arm64 | musl-x64 | musl-Arm64

Synopsis

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

Description

L’outil global dotnet-sos installe l’extension de débogueur SOS. Cette extension vous permet d’inspecter l’état .NET Core managé à partir de débogueurs natifs tels que lldb et windbg.

Notes

L’installation de SOS via l’outil dotnet-sos est nécessaire uniquement sur Linux ou macOS. Il peut également être nécessaire sur Windows si vous utilisez des outils de débogage plus anciens. Les versions récentes du débogueur Windows (>= version 10.0.18317.1001 de WinDbg ou cdb) chargent automatiquement SOS à partir de la galerie d’extensions Microsoft.

Options

• --version

  Affiche les informations de version.

• -h|--help

  Affiche l’aide en ligne de commande.

installation dotnet-sos

Installe l’extension SOS localement pour le débogage des processus .NET Core. Sur macOS et Linux, le fichier .lldbinit est mis à jour afin que l’extension puisse se charger automatiquement au démarrage de lldb. Si vous installez SOS sur Windows avec des outils de débogage plus anciens (avant la version 10.0.18317.1001), vous devez charger manuellement l’extension dans WinDbg ou cdb en exécutant .load %USERPROFILE%\.dotnet\sos\sos.dll dans le débogueur.

Synopsis

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

Options

• --architecture <arch>

  Spécifie l’architecture du processeur des fichiers binaires SOS à installer. Par défaut, dotnet-sos installe l’architecture de l’ordinateur hôte. Utilisez cette option lorsque vous souhaitez installer SOS pour une architecture différente de l’architecture hôte dotnet. Par exemple, si vous exécutez des fichiers binaires Arm32 à partir d’un hôte Arm64, vous devez installer SOS avec dotnet-sos install --architecture Arm.

  Les architectures suivantes sont disponibles :

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos uninstall

Désinstalle l’extension SOS et, sur Linux et macOS, la supprime de la configuration lldb.

Synopsis

dotnet-sos uninstall