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

Запуск WinDbg

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

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

WinDbgX [options]

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

Общие параметры

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

Параметры ядра

Option	Description
-d	После перезагрузки отладчик переходит на целевой компьютер сразу после загрузки модуля ядра.
-k \[ConnectType\]	Запускает сеанс отладки ядра. Если параметр -k используется без параметров ConnectType после него, он должен быть окончательной записью в командной строке.
-kqm	Запускает KD в тихом режиме.
-kl	Запускает сеанс отладки ядра на том же компьютере, что и отладчик.
-kx ExdiOptions	Запускает сеанс отладки ядра с помощью драйвера EXDI. Дополнительные сведения об EXDI см. в разделе "Настройка транспорта отладчика EXDI".
-I	После перезагрузки отладчик переходит на целевой компьютер сразу после загрузки модуля ядра.

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

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

Параметры целевого объекта

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

Параметры символов

Option	Description
-y SymbolPath	Указывает используемый путь к символам. Разделение нескольких путей с запятой (;). Если путь содержит пробелы, он должен быть заключен в кавычки. Дополнительные сведения и другие способы изменения этого пути см. в разделе "Путь к символам".
-n	Шумная загрузка символов. Активирует детализированный вывод данных обработчика символов.
-i *ImagePath	Задает используемый путь поиска изображений.
-sdce	Причиняет отладчику отображение сообщений об ошибке доступа к файлу во время загрузки символов.
-ses	Позволяет отладчику выполнять строгую оценку всех файлов символов и игнорировать любые сомнительные символы.
-sicv	Вызывает пропуск записи CV обработчика символов.
-sins	Позволяет отладчику игнорировать путь символа и переменные среды пути к исполняемому изображению.
-snc	Приводит к отключению отладчика перевода C++.
-snul	Отключает автоматическую загрузку символов для неквалифицированных имен.
-sup	Вызывает обработчик символов для поиска открытой таблицы символов во время каждого поиска символов.
-sflags	Задает все параметры обработчика символов одновременно.

Параметры пути к источнику

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

Если вы находитесь в локальном сеансе отладчика, srcpath и lsrcpath фактически совпадают (сервер — это локальный сеанс). Для удаленной отладки существуют ситуации, когда их можно задать для разных значений. Дополнительные сведения об удаленной отладке см. в разделе "Удаленная отладка".

Обработка исключений

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

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

Анализ после события

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

Устаревшие параметры

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

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

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

Связанный контент

• Функции WinDbg