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

Загрузчик символов (dotnet-symbol)

  • Статья

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

Установка

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

dotnet tool install --global dotnet-symbol

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

dotnet-symbol [-h|--help] [options] <FILES>

Description

Глобальный инструмент dotnet-symbol скачивает файлы (символы, приложения уровня данных, модули и т. д.), необходимые для отладки основных дампов и минидампов. Это может быть полезно при отладке дампов, записанных на другой компьютер. dotnet-symbol может скачивать модули и символы, необходимые для анализа дампа.

Параметры

  • --microsoft-symbol-server

    Добавьте http://msdl.microsoft.com/download/symbols путь к серверу символов (по умолчанию).

  • --server-path <symbol server path>

    Добавление сервера символов в путь к серверу.

  • authenticated-server-path <pat> <server path>

    Добавление сервера символов, прошедшего проверку подлинности, в путь к серверу с помощью личного маркера доступа (PAT).

  • --cache-directory <file cache directory>

    Добавление каталога кэша.

  • --recurse-subdirectories

    Обработка входных файлов во всех подкаталогах.

  • --host-only

    Загрузка только основной программы (то есть dotnet), которая требуется lldb для загрузки основных дампов.

  • --symbols

    Загрузка файлов символов (PDB, DBG, DWARF).

  • --modules

    Загрузка файлов модулей (DLL, SO, DYLIB).

  • --debugging

    Загрузка специальных модулей отладки (DAC, DBI, SOS).

  • --windows-pdbs

    Принудительная загрузка файлов PDB Windows при наличии переносимых PDB.

  • -o, --output <output directory>

    Указание выходного каталога. В противном случае запись рядом с входным файлом (по умолчанию).

  • -d, --diagnostics

    Включение выходных данных диагностики.

  • -h|--help

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

Скачать символы

Выполнение dotnet-symbol для файла дампа по умолчанию загружает все модули, символы и файлы DAC/DBI, необходимые для отладки дампа, включая управляемые сборки. Поскольку SOS теперь может скачивать символы при необходимости, большинство основных дампов Linux можно анализировать с помощью lldb, используя только модули host (dotnet) и модули отладки. Чтобы получить эти файлы, необходимые для диагностики основного дампа с помощью lldb, выполните следующую команду:

dotnet-symbol --host-only --debugging <dump file path>

Устранение неполадок

  • Ошибка 404 (объект не найден) при скачивании символов.

    Загрузка символов поддерживается только для официальных версий среды выполнения .NET Core, полученных по официальным каналам, таким как официальный веб-сайт и источники по умолчанию в сценариях установки dotnet. Ошибка 404 при скачивании файлов отладки может указывать на то, что дамп был создан с помощью среды выполнения .NET Core из другого источника, например из исходного кода, созданного локально или для конкретного дистрибутива Linux, либо с сайтов сообщества, таких как archlinux. В таких случаях файл, необходимый для отладки (dotnet, libcoreclr.so и libmscordaccore.so), должен быть скопирован из этих источников или из среды, в которой был создан файл дампа.

См. также