Compartilhar via


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:

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