Параметры Command-Line 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 , он должен отображаться перед любыми другими параметрами в командной строке.

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

-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 0xNumber
Задает все параметры обработчика символов одновременно. Число должно быть шестнадцатеричным числом с префиксом 0x . Десятичная дробь без 0x разрешена, но параметры символов являются двоичными флагами, поэтому рекомендуется шестнадцатеричное значение. Этот параметр следует использовать с осторожностью, так как он переопределит все значения по умолчанию обработчика символов. Дополнительные сведения см. в разделе Настройка параметров символов.

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

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

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

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

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

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

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

Значение	Константа	Значение
0	None	Ошибки не отображаются.
1	ОШИБКА	Отображение событий отладки уровня ERROR.
2	ДОПОЛНИТЕЛЬНЫЙ НОМЕР	Отображение событий отладки уровня MINORERROR и ERROR.
3	ПРЕДУПРЕЖДЕНИЕ	Отображение событий отладки на уровне WARNING, MINORERROR и ERROR.

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

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

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

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

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

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

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

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

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

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

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