Instalador SOS (dotnet-sos)

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

Instalar

Há duas maneiras de baixar e instalar dotnet-sos:

• Ferramenta global dotnet:

  Para instalar a versão mais recente do dotnet-sos pacote NuGet, use o comando dotnet tool install :

  dotnet tool install --global dotnet-sos
  

• Download direto:

  Faça o download do executável da ferramenta que corresponde à sua plataforma:

  SO	Plataforma
  Windows	x86 x64 | braço | braço-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 do depurador SOS. Essa extensão permite inspecionar o estado gerenciado do .NET Core 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. Ele também pode ser necessário no Windows se você estiver usando ferramentas de depuração mais antigas. As versões recentes do Depurador do Windows (>= versão 10.0.18317.1001 do WinDbg ou cdb) carregam o SOS automaticamente da galeria de extensões da Microsoft.

Opções

• --version

  Exibe informações de versão.

• -h|--help

  Mostra a ajuda da linha de comando.

instalação dotnet-sos

Instala a extensão SOS localmente para depurar processos .NET Core. No macOS e Linux, o arquivo .lldbinit será atualizado para que a extensão seja carregada automaticamente na inicialização do lldb. Se você estiver instalando o SOS no Windows com ferramentas de depuração mais antigas (antes da versão 10.0.18317.1001), será necessário carregar manualmente a extensão no WinDbg ou cdb executando .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 serem instalados. Por padrão, dotnet-sos instala a arquitetura da máquina host. Use esta opção quando quiser instalar o SOS para uma arquitetura diferente da arquitetura de host dotnet. Por exemplo, se você estiver executando binários Arm32 de um host Arm64, precisará instalar o SOS com dotnet-sos install --architecture Arm.

  As seguintes arquiteturas estão disponíveis:

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos desinstalar

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

Sinopse

dotnet-sos uninstall