WinDbg — параметры запуска из командной строки
Запуск WinDbg
После установки WinDbg WinDbgX.exe можно запустить из любого расположения каталога.
Параметры запуска из командной строки
WinDbgX [options]
В следующих таблицах перечислены доступные параметры командной строки.
Общие параметры
| Параметр | Описание |
|---|---|
| -c "command" | Выполняет командную строку после присоединения отладчика. Эта команда должна быть заключена в кавычки. Несколько команд можно разделить точкой с запятой. |
| -v | Включает подробные выходные данные в отладчике. |
| -T Заголовок | Задает заголовок окна. |
| -logo LogFile | Открытие журнала. Начинает запись данных в файл журнала. Если файл уже существует, он будет перезаписан. |
| -loga LogFile | Добавление журнала. Начинает запись данных в файл журнала. Если файл существует, он будет добавлен в . |
| -e EventHandle | Сигнализирует о событии с помощью заданного дескриптора после следующего исключения в целевом объекте. |
| -? | Отображает сводку доступных команд. |
Параметры ядра
| Параметр | Описание |
|---|---|
| -k [ConnectType] | Запускает сеанс отладки ядра. Если параметр -k используется без параметров ConnectType , он должен быть последней записью в командной строке. |
| -kqm | Запускает KD в тихом режиме. |
| -Kl | Запускает сеанс отладки ядра на том же компьютере, что и отладчик. |
| -kx ExdiOptions | Запускает сеанс отладки ядра с помощью драйвера EXDI. Дополнительные сведения об EXDI см. в разделе Настройка транспорта отладчика EXDI. |
| -d | После перезагрузки отладчик войдет в целевой компьютер сразу после загрузки модуля ядра. |
Параметры пользовательского режима
| Параметр | Описание |
|---|---|
| -o | Выполняет отладку всех процессов, запущенных целевым приложением (дочерними процессами). |
| -g | Игнорирует начальную точку останова в целевом приложении. |
| \- G | Игнорирует последнюю точку останова в целевом приложении. |
| -Pv | Указывает, что отладчик должен подключаться к целевому процессу неинвазивно. |
| -Hd | Указывает, что отладочная куча не должна использоваться. |
| -cimp | Указывает, что все созданные процессы будут использовать неявную командную строку, заданную сервером, а не заданную пользователем строку командной строки клиента. |
Параметры целевого объекта
| Параметр | Описание |
|---|---|
| -remote ClientTransport | Подключается к уже работающему серверу отладки. Описание возможных значений ClientTransport см. в разделе Активация клиента отладки. При использовании этого параметра он должен быть первым параметром в командной строке. |
| -server ServerTransport | Создает сервер отладки, к которому могут обращаться другие отладчики. Описание возможных значений ServerTransport см. в разделе Активация сервера отладки. |
| -premote SmartClientTransport | Создает интеллектуальный клиент и подключается к уже работающему серверу обработки. Описание возможных значений SmartClientTransport см. в разделе Активация смарт-клиента. |
| -p PID | Указывает идентификатор отлаживаемого десятичного процесса. |
| -tid TID | Указывает идентификатор потока, возобновляемого при запуске сеанса отладки. |
| -psn ServiceName | Указывает имя службы, содержащейся в отлаживаемом процессе. Используется для отладки уже запущенного процесса. |
| -pn ProcessName | Указывает имя отлаживаемого процесса. |
| -z DumpFile | Указывает имя файла аварийного дампа для отладки. Если путь и имя файла содержат пробелы, они должны быть заключены в кавычки. |
| -debugArch x86 -or- amd64 | Переопределите поведение автоопределения и задайте целевую разрядность для отладчика. |
| -loadSession | Загрузите сохраненный файл конфигурации сеанса. |
| -setupFirewallRules | Настраивает необходимые правила брандмауэра в локальной системе, чтобы разрешить отладку ядра с помощью KDNET. |
| -openPrivateDumpByHandle Handle | Только для внутреннего использования майкрософт. Указывает дескриптор файла аварийного дампа для отладки. |
| -benchmarkStartup | Только для внутреннего использования майкрософт. Запускает тест производительности запуска и добавляет результат в файл. |
Параметры символов
| Параметр | Описание |
|---|---|
| -y SymbolPath | Указывает используемый путь к символам. Разделяйте несколько путей точкой с запятой (;). Если путь содержит пробелы, его следует заключить в кавычки. Дополнительные сведения и другие способы изменения этого пути см. в разделе Путь к символу. |
| -n | Шумная загрузка символов. Включает подробные выходные данные из обработчика символов. |
| -i ImagePath | Задает используемый путь поиска изображений. |
| -sdce | Заставляет отладчик отображать сообщения "Ошибка доступа к файлу" во время загрузки символов. |
| -Ses | Заставляет отладчик выполнять строгую оценку всех файлов символов и игнорировать любые сомнительные символы. |
| -sicv | Вызывает проигнорирование записи CV обработчиком символов |
| -Грехи | Заставляет отладчик игнорировать переменные среды пути к символам и пути к исполняемому образу. |
| -Snc | Приводит к отключению отладчика перевода C++. |
| -snul | Отключает автоматическую загрузку символов для неквалифицированных имен. |
| -Sup | Заставляет обработчик символов выполнять поиск в общедоступной таблице символов во время каждого поиска символов. |
| -sflags | Задает все параметры обработчика символов одновременно. |
Параметры исходного пути
| Параметр | Описание |
|---|---|
| -srcpath | Указывает исходный путь, используемый на сервере отладки. |
| -lsrcpath | Указывает исходный путь для использования на локальном клиенте. |
Если вы находитесь в сеансе локального отладчика, srcpath и lsrcpath фактически совпадают (ваш "сервер" — это локальный сеанс). Для удаленной отладки существуют варианты, в которых может потребоваться задать для них разные значения. Дополнительные сведения об удаленной отладке см. в статье Удаленная отладка.
Обработка исключений
| Параметр | Описание |
|---|---|
| -X | Включите обработку второго шанса только для исключений нарушения доступа. |
| Исключение -xe | Включите обработку исключений первого шанса для указанного исключения. |
| Исключение -xd | Включите обработку исключений второго шанса для указанного исключения. |
| Исключение -xn | Для данного исключения отключите обработку первого и второго шанса и выведите сообщение только на консоли. |
| Исключение -xi | Полностью игнорируйте данное исключение, отключая обработку первого и второго шансов и не выводя ничего в консоль. |
Список исключений, которые можно указать, см. в разделе Определения событий и значения по умолчанию.
Post Mortem
| Параметр | Описание |
|---|---|
| -I | Задает WinDbg в качестве отладчика post-mortem по умолчанию для системы. |
| -IS | Автоматически задает WinDbg в качестве отладчика post-mortem по умолчанию для системы, при этом сообщаются только ошибки. |
Нерекомендуемые параметры
| Параметр | Описание |
|---|---|
| -Q | Нерекомендуемый параметр командной строки. |
| -QY | Нерекомендуемый параметр командной строки. |
| -QS | Нерекомендуемый параметр командной строки. |
| -QSY | Нерекомендуемый параметр командной строки. |
| -WX | Нерекомендуемый параметр командной строки. |
Общие сведения о параметрах запуска см. в разделе Параметры Command-Line WinDbg.
Вы можете использовать -? , чтобы получить список поддерживаемых параметров командной строки.
