Instalador SOS (dotnet-sos)

Este artigo aplica-se a: ✔️ SDK .NET Core 2.1 e versões posteriores

Instalar

Existem duas formas de transferir e instalar dotnet-sos:

• ferramenta global dotnet:

  Para instalar a versão de versão mais recente do dotnet-sospacote NuGet, utilize o comando de instalação da ferramenta dotnet :

  dotnet tool install --global dotnet-sos
  

• Transferência direta:

  Transfira o executável da ferramenta que corresponde à sua plataforma:

  SO	Plataforma
  Windows	x86 | x64 | Braço | Arm-x64
  Linux	x64 | Braço | Arm64 | musl-x64 | musl-Arm64

Sinopse

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

Description

A dotnet-sos ferramenta global instala a extensão de depurador SOS. Esta extensão permite-lhe inspecionar o estado do .NET Core gerido a partir de depuradores nativos, como lldb e windbg.

Nota

A instalação do SOS através da dotnet-sos ferramenta só é necessária no Linux ou macOS. Também poderá ser necessário no Windows se estiver a utilizar ferramentas de depuração mais antigas. As versões recentes do Windows Debugger (>= versão 10.0.18317.1001 do WinDbg ou cdb) carregam o SOS automaticamente a partir da galeria de extensões da Microsoft.

Opções

• --version

  Apresenta as informações da versão.

• -h|--help

  Mostra a ajuda da linha de comandos.

instalação dotnet-sos

Instala a extensão SOS localmente para depurar processos .NET Core. No macOS e Linux, o ficheiro .lldbinit será atualizado para que a extensão seja carregada automaticamente no arranque do lldb. Se estiver a instalar o SOS no Windows com ferramentas de depuração mais antigas (antes da versão 10.0.18317.1001), terá de carregar manualmente a extensão no WinDbg ou cdb ao executar .load %USERPROFILE%\.dotnet\sos\sos.dll no depurador.

Sinopse

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

Opções

• --architecture <arch>

  Especifica a arquitetura do processador dos binários SOS a instalar. Por predefinição, dotnet-sos instala a arquitetura do computador anfitrião. Utilize esta opção quando quiser instalar o SOS para uma arquitetura diferente da arquitetura do anfitrião dotnet. Por exemplo, se estiver a executar binários do Arm32 a partir de um anfitrião Arm64, terá de instalar o SOS com dotnet-sos install --architecture Arm.

  Estão disponíveis as seguintes arquiteturas:

  • Arm
  • Arm64
  • X86
  • X64

desinstalar dotnet-sos

Desinstala a extensão SOS e, no Linux e macOS, remove-a da configuração do lldb.

Sinopse

dotnet-sos uninstall