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


WinDbg — параметры запуска командной строки

логотип WinDbg с увеличивающимся стеклом, проверяющим биты.

Starting WinDbg

После установки WinDbg WinDbgX.exe может быть запущен из любого места в каталоге.

Параметры запуска командной строки

WinDbgX [options]

В следующих таблицах перечислены доступные параметры командной строки.

General Options

Option Description
-c "command" Выполняет командную строку после подключения отладчика. Эта команда должна быть заключена в кавычки. Несколько команд можно разделить точкой с запятой.
-v Включает вывод подробных данных в отладчике.
-T Title Задает заголовок окна.
-logo LogFile Log Open. Начинает запись информации в лог-файл. Если файл уже существует, он будет перезаписан.
-loga LogFile Log Append. Начинает запись информации в лог-файл. Если файл существует, он будет добавлен.
-e EventHandle Сигнализирует о событии с заданным дескриптором после следующего исключения в целевом объекте.
-? Отображает сводку доступных команд.

Kernel Options

Option Description
-k [ConnectType] Запускает сеанс отладки ядра. If -k is used without any ConnectType options following it, it must be the final entry on the command line.
-kqm Запускает KD в тихом режиме.
-kl Запускает сеанс отладки ядра на том же компьютере, что и отладчик.
-kx ExdiOptions Запускает сеанс отладки ядра с помощью драйвера EXDI. Дополнительные сведения об EXDI см. в разделе "Настройка транспорта отладчика EXDI".
-d После перезагрузки отладчик переходит на целевой компьютер сразу после загрузки модуля ядра.

Параметры пользовательского режима

Option Description
-o Отладка всех процессов, запущенных целевым приложением (дочерними процессами).
-g Игнорирует начальную точку останова в целевом приложении.
-G Игнорирует окончательную точку останова в целевом приложении.
-pv Указывает, что отладчик должен подключаться к целевому процессу ненавязчиво.
-hd Указывает, что отладочная куча не должна использоваться.
-cimp Указывает, что все процессы, созданные, будут использовать неявную командную строку, заданную сервером, а не строку командной строки пользователя из клиента.

Target Options

Option Description
-remote ClientTransport Подключается к серверу отладки, который уже запущен. For an explanation of the possible ClientTransport values, see Activating a Debugging Client. Если этот параметр используется, он должен быть первым параметром в командной строке.
-server ServerTransport Создает сервер отладки, к которому можно получить доступ другим отладчикам. For an explanation of the possible ServerTransport values, see Activating a Debugging Server.
-premote SmartClientTransport Создает смарт-клиент и подключается к серверу обработки, который уже запущен. Описание возможных значений SmartClientTransport см. в разделе "Активация смарт-клиента".
-p PID Указывает идентификатор десятичного процесса для отладки.
-tid TID Указывает ID потока, который должен быть возобновлен при запуске сеанса отладки.
-psn ServiceName Указывает имя службы, содержащейся в процессе отладки. Используется для отладки процесса, который уже запущен.
-pn ProcessName Указывает имя процесса для отладки.
-z DumpFile Указывает имя файла аварийного дампа для отладки. Если путь и имя файла содержат пробелы, это должно быть окружено кавычками.
-debugArch x86 -или- amd64 Переопределите автоматическое определение и установите целевую битность для отладчика.
-loadSession Загрузите сохраненный файл конфигурации сеанса.
-setupFirewallRules Настраивает необходимые правила брандмауэра в локальной системе, чтобы разрешить отладку ядра с помощью KDNET.
-openPrivateDumpByHandle Handle Только внутреннее использование Майкрософт. Указывает дескриптор файла аварийного дампа для отладки.
-benchmarkStartup Только внутреннее использование Майкрософт. Запускает тест запуска и добавляет результат в файл.

Symbol Options

Option Description
-y SymbolPath Указывает используемый путь к символам. Separate multiple paths with a semicolon (;). Если путь содержит пробелы, он должен быть заключен в кавычки. For details, and for other ways to change this path, see Symbol Path.
-n Шумная загрузка символов. Активирует детализированный вывод данных обработчика символов.
-i ImagePath Задает используемый путь поиска изображений.
-sdce Причиняет отладчику отображение сообщений об ошибке доступа к файлу во время загрузки символов.
-ses Позволяет отладчику выполнять строгую оценку всех файлов символов и игнорировать любые сомнительные символы.
-sicv Заставляет обработчик символов игнорировать запись CV.
-sins Позволяет отладчику игнорировать путь символа и переменные среды пути к исполняемому изображению.
-snc Приводит к отключению отладчика перевода C++.
-snul Отключает автоматическую загрузку символов для неквалифицированных имен.
-sup Вызывает обработчик символов для поиска открытой таблицы символов во время каждого поиска символов.
-sflags Задает все параметры обработчика символов одновременно.

Параметры исходного пути

Option Description
-srcpath Указывает исходный путь для использования на сервере отладки.
-lsrcpath Указывает исходный путь для использования на локальном клиенте.

Если вы находитесь в локальном сеансе отладчика, srcpath и lsrcpath фактически одинаковы (сервер — это локальный сеанс). Для удаленной отладки существуют ситуации, в которых можно установить их на разные значения. For more information about remote debugging see, Remote Debugging.

Exception handling

Option Description
-x Включите обработку второго шанса только для исключений, связанных с нарушением доступа.
-xe Exception Включите обработку исключений первого шанса для указанного исключения.
-xd Exception Включите обработку исключений второго шанса для указанного исключения.
-xn Exception Для данного исключения отключите обработку первой и второй попытки и отображайте только сообщение на консоли.
-xi Exception Полностью игнорируйте данное исключение, отключив обработку первого и второго случаев и не выводя ничего в консоль.

Список исключений, которые можно указать, см. в разделе "Определения событий" и "Значения по умолчанию".

Post Mortem

Option Description
-I Устанавливает WinDbg в качестве отладчика по умолчанию для анализа после сбоя в системе.
-IS Задает WinDbg в качестве отладчика после смерти по умолчанию для системы автоматически, и сообщается только об ошибках.

Deprecated Options

Option Description
-Q Нерекомендуемый параметр командной строки.
-QY Нерекомендуемый параметр командной строки.
-QS Нерекомендуемый параметр командной строки.
-QSY Нерекомендуемый параметр командной строки.
-WX Нерекомендуемый параметр командной строки.

Общие сведения о параметрах запуска см. в разделе "Параметры Command-Line WinDbg".

Вы можете использовать ?? чтобы перечислить поддерживаемые параметры командной строки.

Снимок экрана: командная строка WinDbgX помогает выводить различные параметры.

See Also

WinDbg Features