Параметры командной строки KD

При первом запуске пользователей KD следует начать отладку с помощью KD и NTKD .

В командной строке KD используется следующий синтаксис.

kd [ -server ServerTransport | -remote ClientTransport ] 
   [-b | -x] [-d] [-bonc] [-m] [-myob] [-lines] [-n] [-r] [-s] 
   [-v] [-clines lines] [-failinc] [-noio] [-noshell] 
   [-secure] [-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul]
   [-sup] [-sflags 0xNumber] [-log{a|au|o|ou} LogFile] 
   [-aExtension] [-zp PageFile] 
   [-i ImagePath] [-y SymbolPath]  [-srcpath SourcePath] 
   [-k ConnectType | -kl | -kqm | -kx ExdiOptions] [-ee {masm|c++}] 
   [-z DumpFile] [-cf "filename"] [-cfr "filename"] [-c "command"] 
   [-t PrintErrorLevel] [-version] 

kd -iu KeyString

kd -QR Server 

kd -wake PID 

kd -?

Ниже приведены описания параметров командной строки KD. Только параметры -remote и -server чувствительны к регистру. Начальный дефис можно заменить косой чертой вперед (/). Параметры, которые не принимают никаких дополнительных параметров, можно объединить - поэтому kd -r -n -v можно записать как kd -rnv.

Если используется параметр -remote или -server, он должен отображаться перед любыми другими параметрами в командной строке.

Параметры

-сервер ServerTransport
Создает сервер отладки, к которому можно получить доступ другим отладчикам. Описание возможного сервера ServerTransport см. в разделе "Активация сервера отладки". Если этот параметр используется, он должен быть первым параметром в командной строке.

-удалённый ClientTransport
Создает клиент отладки и подключается к серверу отладки, который уже запущен. Описание возможных значений ClientTransport см. в разделе "Активация клиента отладки". Если этот параметр используется, он должен быть первым параметром в командной строке.

-a Расширение
Задает библиотеку DLL расширения по умолчанию. Значение по умолчанию — kdextx86.dll или kdexts.dll. Не должно быть места после "a", а расширение имени файла .dll не должно быть включено. Дополнительные сведения и другие методы настройки этого по умолчанию см. в разделе "Загрузка библиотек DLL расширения отладчика".

-b
Этот параметр больше не поддерживается.

-bonc
Если этот параметр указан, отладчик переходит в целевой объект сразу после начала сеанса. Это особенно полезно при подключении к серверу отладки, который в настоящее время не может быть разбит на целевой объект.

-c "команда"
Указывает начальную команду отладчика для запуска при запуске. Эта команда должна быть окружена кавычками. Несколько команд можно разделить точкой с запятой. (Если у вас есть длинный список команд, их может быть проще поместить в скрипт, а затем использовать параметр -c с командой $<, $, $><><, $$>< (Запуск файла скрипта).)

Если вы запускаете клиент отладки, эта команда должна быть предназначена для сервера отладки. Команды для конкретного клиента, такие как Lsrcpath, не допускаются.

-cf "filename"
Указывает путь и имя файла скрипта. Этот файл скрипта выполняется сразу после запуска отладчика. Если имя файла содержит пробелы, оно должно быть заключено в кавычки. Если путь опущен, предполагается, что текущий каталог. Если параметр -cf не используется, файл ntsd.ini в текущем каталоге используется в качестве файла скрипта. Если файл не существует, ошибка не возникает. Дополнительные сведения см. в разделе "Использование файлов скриптов".

-cfr "filename"
Указывает путь и имя файла скрипта. Этот файл скрипта выполняется сразу после запуска отладчика и при перезапуске целевого объекта. Если имя файла содержит пробелы, оно должно быть заключено в кавычки. Если путь опущен, предполагается, что текущий каталог. Если файл не существует, ошибка не возникает. Дополнительные сведения см. в разделе "Использование файлов скриптов".

-clines обводы
Задает приблизительное количество команд в журнале команд, к которым можно получить доступ во время удаленной отладки. Дополнительные сведения и другие способы изменения этого числа см. в разделе "Использование команд отладчика".

-d
После перезагрузки отладчик переходит на целевой компьютер сразу после загрузки модуля ядра. (Этот разрыв выше, чем разрыв с параметром -b .) Дополнительные сведения и другие методы изменения состояния см. в разделе "Аварийное завершение и перезагрузка целевого компьютера ".

-ee {masm|c++}
Задает средство оценки выражений по умолчанию. Если задан масм , будет использоваться синтаксис выражения MASM. При указании c++ синтаксис выражения C++ будет использоваться. Если параметр -ee опущен, синтаксис выражения MASM используется в качестве значения по умолчанию. Дополнительные сведения см. в статье об оценке выражений .

-failinc
Позволяет отладчику игнорировать любые сомнительные символы. При отладке мини-файла в режиме пользователя или в режиме ядра этот параметр также не позволит отладчику загружать все модули, образы которых невозможно сопоставить. Дополнительные сведения и другие методы управления этим процессом см. в SYMOPT_EXACT_SYMBOLS.

-я ImagePath
Указывает расположение исполняемых файлов, создающих ошибку. Если путь содержит пробелы, он должен быть заключен в кавычки.

-Ме KeyString
Регистрирует удаленное взаимодействие отладчика в качестве типа URL-адреса, чтобы пользователи могли автоматически запускать удаленный клиент отладчика с URL-адресом. KeyString имеет формат remdbgeng://RemotingOption. RemotingOption — это строка, определяющая транспортный протокол, как определено в разделе "Активация клиента отладки". Если это действие выполнено успешно, сообщение не отображается; Если ошибка завершается ошибкой, отображается сообщение об ошибке.

Параметр -iu не должен использоваться с другими параметрами. Эта команда на самом деле не запустит KD.

-k ConnectType
Сообщает отладчику, как подключиться к целевому объекту. Дополнительные сведения см. в разделе "Отладка с помощью KD и NTKD".

-kl
Запускает сеанс отладки ядра на том же компьютере, что и отладчик.

-kqm
Запускает KD в тихом режиме.

-kx ExdiOptions
Запускает сеанс отладки ядра с помощью драйвера EXDI. Драйверы EXDI не описаны в этой документации. Если у вас есть интерфейс EXDI для аппаратного зонда или симулятора оборудования, обратитесь к корпорации Майкрософт за сведениями об отладке.

-обводы
Включает отладку исходной строки. Если этот параметр опущен, команда .line (toggle Source Line Support) должна быть использована, прежде чем будет разрешена отладка источника. Другие методы управления этим, см . в SYMOPT_LOAD_LINES.

-log{a|au|o|ou} LogFile
Начинает ведение журнала в файл журнала. Если LogFile уже существует, он будет перезаписан, если используется логотип , или выходные данные будут добавлены в файл, если используется -loga . Параметры -logau и -logou работают аналогично -loga и -logo соответственно, за исключением того, что файл журнала является файлом Юникода. Дополнительные сведения см. в разделе "Сохранение файла журнала в KD".

-m
Указывает, что последовательный порт подключен к модему. Указывает отладчику следить за сигналом обнаружения оператора.

-myob
Если существует несоответствие версий с dbghelp.dll, отладчик продолжит выполняться. (Без переключателя -myob это считается неустранимой ошибкой.)

Дополнительный эффект этого параметра заключается в том, что предупреждение, которое обычно отображается при разрыве на целевом компьютере, подавляется.

-n
Шумная загрузка символов: включает подробные выходные данные обработчика символов. Дополнительные сведения и другие методы управления этим процессом см . в SYMOPT_DEBUG.

-noio
Предотвращает использование сервера отладки для входных или выходных данных. Входные данные будут приниматься только из клиента отладки (плюс любая исходная команда или скрипт команды, указанный параметром командной строки -c ).

Все выходные данные будут перенаправлены клиенту отладки. Дополнительные сведения см. в разделе "Активация сервера отладки".

-noshell
Запрещает все команды .shell . Это запрет будет длиться до тех пор, пока отладчик запущен, даже если начинается новый сеанс отладки. Дополнительные сведения и другие способы отключения команд оболочки см. в разделе "Использование команд оболочки".

-QR Сервер
Выводит список всех серверов отладки, работающих на указанном сетевом сервере. Двойная обратная косая черта (\\) предыдущего сервера является необязательным. Дополнительные сведения см. в статье "Поиск серверов отладки".

Параметр -QR не должен использоваться с другими параметрами. Эта команда на самом деле не запустит KD.

-r
Отображает регистры.

-s
Отключает отложенную загрузку символов. Это приведет к замедлению запуска процесса. Дополнительные сведения и другие методы управления этим процессом см. в SYMOPT_DEFERRED_LOADS.

-sdce
Позволяет отладчику отображать диалоговые окна доступа к файлам во время загрузки символов. Дополнительные сведения и другие методы контроля см. в SYMOPT_FAIL_CRITICAL_ERRORS.

-безопасный
Активирует безопасный режим.

-ses
Позволяет отладчику выполнять строгую оценку всех файлов символов и игнорировать любые сомнительные символы. Дополнительные сведения и другие методы управления этим процессом см. в SYMOPT_EXACT_SYMBOLS.

-sflags 0xЧисло
Задает все параметры обработчика символов одновременно. Число должно быть шестнадцатеричным числом, префиксом 0x - десятичное значение без 0x разрешено, но параметры символов являются двоичными флагами, поэтому рекомендуется шестнадцатеричное значение. Этот параметр следует использовать с осторожностью, так как он переопределит все значения обработчика символов по умолчанию. Дополнительные сведения см. в разделе "Параметры символов".

-sicv
Вызывает пропуск записи CV обработчика символов. Дополнительные сведения и другие методы управления этим процессом см. в SYMOPT_IGNORE_CVREC.

-Грехи
Позволяет отладчику игнорировать путь символа и переменные среды пути к исполняемому изображению. Дополнительные сведения см. в SYMOPT_IGNORE_NT_SYMPATH.

-snc
Приводит к отключению отладчика перевода C++. Дополнительные сведения и другие методы управления этим процессом см . в SYMOPT_NO_CPP.

-snul
Отключает автоматическую загрузку символов для неквалифицированных имен. Дополнительные сведения и другие методы управления этим процессом см . в SYMOPT_NO_UNQUALIFIED_LOADS.

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

-глоток
Вызывает обработчик символов для поиска открытой таблицы символов во время каждого поиска символов. Дополнительные сведения и другие методы управления этим процессом см. в SYMOPT_AUTO_PUBLICS.

-t PrintErrorLevel
Указывает уровень ошибки, который приведет к отображению отладчика сообщения об ошибке. Это десятичное число, равное 0, 1, 2 или 3. Значения описаны ниже.

Значение	Константа	Значение
0	NONE	Не отображайте никаких ошибок.
1	ОШИБКА	Отображение событий отладки на уровне ОШИБКИ.
2	MINORERROR	Отображение событий отладки на уровне MINORERROR и ERROR.
3	ПРЕДУПРЕЖДЕНИЕ	Отображение событий отладки на уровне ПРЕДУПРЕЖДЕНИЙ, MINORERROR и ОШИБОК.

Этот уровень ошибок имеет значение только в проверенных сборках Microsoft Windows. Значение по умолчанию равно 1. Проверенные сборки были доступны в более ранних версиях Windows до Windows 10 версии 1803.

-v
Создает подробные сообщения для загрузки, отложенных загрузок и выгрузки.

-Версия
Выводит строку версии отладчика.

-будить PiD
Вызывает завершение режима спящего режима для отладчика пользовательского режима, идентификатор процесса которого указан PID. Эта команда должна быть выдана на целевом компьютере во время спящего режима. Дополнительные сведения см. в разделе "Управление отладчиком пользовательского режима" из отладчика ядра.

Параметр -wake не должен использоваться с другими параметрами. Эта команда на самом деле не запустит KD.

-x
Позволяет отладчику прерываться при первом возникновении исключения, а не разрешать приложению или модулю, вызвавшего с ним дело об исключении. (То же, что и -b, за исключением начального eb nt! NtGlobalFlag 9; g command.)

-y SymbolPath
Указывает путь поиска символов. Разделение нескольких путей с запятой (;). Если путь содержит пробелы, он должен быть заключен в кавычки. Дополнительные сведения и другие способы изменения этого пути см. в разделе "Путь к символам".

-z DumpFile
Указывает имя файла аварийного дампа для отладки. Если путь и имя файла содержат пробелы, это должно быть окружено кавычками. Можно одновременно открыть несколько файлов дампа, включив несколько параметров -z , за которыми следует другое значение DumpFile . Дополнительные сведения см. в разделе "Анализ файла дампа в режиме ядра" с помощью KD.

-zp PageFile
Указывает имя измененного файла страницы. Это полезно, если вы отладили файл дампа и хотите использовать команду .pagein (Page In Memory). Нельзя использовать -zp со стандартным файлом страницы Windows— можно использовать только специально измененные файлы страниц.

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

KD автоматически обнаруживает платформу, на которой выполняется целевой объект. Не нужно указывать целевой объект в командной строке KD. Старый синтаксис (с использованием имени I386KD или IA64KD) устарел.