Поделиться через


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

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

Установка

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

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

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

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

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

    ОС Платформа
    Windows x86 x64 Arm-x64 Arm-x64 | | |
    Linux x64 Arm64 | | | musl-x64 musl-arm64 |

Краткие сведения

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

Description

Глобальное средство 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