Instalador do SOS (dotnet-sos)

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

Observação

Considere usar as extensões de depurador do .NET , que incluem a funcionalidade SOS e recursos adicionais.

Instalar

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

• Ferramenta global dotnet:

  Para instalar a versão mais recente 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.

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 de .lldbinit do é 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.

Isso substitui todas as instalações anteriores dos instaladores dotnet-debugger-extensions ou dotnet-sos.

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 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 uninstall

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

Sinopse

dotnet-sos uninstall