Instalador do SOS (dotnet-sos)

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

Instalar

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

• Ferramenta global dotnet:

  Para instalar a última versão de lançamento do dotnet-sospacote NuGet, use o comando dotnet tool install:

  dotnet tool install --global dotnet-sos
  

• Download direto:

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

  Sistema operacional	Plataforma
  Windows	x86 | x64 | Arm | Arm-x64
  Linux	x64 | Arm | Arm64 | musl-x64 | musl-Arm64

Sinopse

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

Descrição

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

Observação

A instalação do SOS por meio da ferramenta dotnet-sos só é necessária no Linux ou no macOS. Ela também poderá ser necessária 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.

dotnet-sos install

Instala a extensão SOS localmente para depurar processos do .NET Core. No macOS e no 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 do SOS a serem instalados. Por padrão, dotnet-sos instala a arquitetura do computador host. Use essa opção quando quiser instalar o SOS para uma arquitetura diferente da arquitetura do host do dotnet. Por exemplo, se você estiver executando binários do Arm32 por meio de um host do Arm64, precisará instalar o SOS com dotnet-sos install --architecture Arm.

  As seguintes arquiteturas estão disponíveis:

  • Arm
  • Arm64
  • X86
  • X64

dotnet-sos uninstall

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

Sinopse

dotnet-sos uninstall