Установщик SOS (dotnet-sos)

Эта статья относится к следующему. ✔️ SDK для .NET Core 2.1 и более поздних версий

Установка

Есть два способа загрузки и установки dotnet-sos:

  • Средство dotnet global:

    Чтобы установить последнюю версию dotnet-sosпакета NuGet, используйте команду dotnet tool install :

    dotnet tool install --global dotnet-sos
    
  • Прямое скачивание:

    скачайте исполняемый файл средства, соответствующий вашей платформе:

    OS Платформа
    Windows x86 | x64 | Руку | Arm-x64
    Linux x64 | Руку | Arm64 | musl-x64 | musl-Arm64

Краткий обзор

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

Описание

Глобальное средство dotnet-sos устанавливает расширение отладчика SOS. Это расширение позволяет проверять управляемое состояние .NET Core из отладчиков машинного кода, таких как lldb и windbg.

Примечание

Установка SOS с помощью средства dotnet-sos требуется только в Linux или macOS. Это также может потребоваться в Windows, если вы используете старые средства отладки. Последние версии отладчика Windows (>= версия 10.0.18317.1001 WinDbg или cdb) автоматически загружают SOS из коллекции расширений Майкрософт.

Параметры

  • --version

    Отображение сведений о версии.

  • -h|--help

    Отображение справки в командной строке.

dotnet-sos install

Установка расширения SOS локально для отладки процессов .NET Core. В macOS и Linux файл LLDBINIT будет обновлен таким образом, чтобы расширение загружалось автоматически при запуске lldb. При установке SOS в Windows с более старыми средствами отладки (ниже версии 10.0.18317.1001) необходимо вручную загрузить расширение в WinDbg или CDB, запустив .load %USERPROFILE%\.dotnet\sos\sos.dll в отладчике.

Краткий обзор

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

Параметры

  • --architecture <arch>

    Задает архитектуру процессора для устанавливаемых двоичных файлов SOS. По умолчанию средство dotnet-sos устанавливает архитектуру хост-компьютера. Используйте этот параметр, если необходимо установить SOS для архитектуры, отличной от архитектуры узла dotnet. Например, если вы запускаете двоичные файлы Arm32 на узле Arm64, необходимо установить SOS командой dotnet-sos install --architecture Arm.

    Доступны следующие архитектуры:

    • Arm
    • Arm64
    • X86
    • X64

dotnet-sos uninstall

Удаление расширения SOS, а в Linux и macOS также удаление из конфигурации lldb.

Краткий обзор

dotnet-sos uninstall