Настройка tools.ini

Файл tools.ini содержит сведения для инициализации отладчиков командной строки. При запуске отладчик выполняет поиск соответствующего заголовка раздела в файле tools.ini и извлекает сведения об инициализации из записей под заголовком. Каждый отладчик командной строки имеет собственный заголовок раздела — [CDB], [NTSD] и [KD]. Переменная среды INIT должна указывать на каталог, содержащий файл tools.ini.

WinDbg не использует файл tools.ini. Вместо этого WinDbg сохраняет параметры инициализации в рабочих областях.

В следующей таблице показаны записи tools.ini.

Ключевые слова должны быть отделены от значений пробелами или двоеточием. Ключевые слова не учитывают регистр.

Для значений TRUE или FALSE "FALSE" является единственным ложным значением. Все остальное — TRUE.

Вход	Описание
$u 0:value ... $u 9:value	Назначьте значения псевдонимам фиксированного имени. Можно указать числовые значения n или 0xn или любую другую строку. Дополнительные сведения см. в разделе "Использование псевдонимов ". Нет эквивалента в командной строке.
DebugChildren:flag	ИСТИНА или ЛОЖЬ. Если TRUE, CDB отлаживает указанное приложение, а также любые дочерние процессы, которые могут запуститься. Эквивалент командной строки — -o.
DebugOutput:flag	ИСТИНА или ЛОЖЬ. Если значение TRUE, CDB отправляет выходные данные и получает входные данные через терминал. Если FALSE, выходные данные переходят на экран пользователя. Параметр командной строки -d аналогичен, но не идентичен.
IniFile:file	Указывает имя файла сценария, из которого CDB или KD получают команды при запуске. По умолчанию используется файл ntsd.ini в текущем каталоге. Эквивалент командной строки — -cf. Дополнительные сведения см. в разделе "Использование файлов скриптов".
LazyLoad:flag	ИСТИНА или ЛОЖЬ. Если TRUE, CDB выполняет отложенную загрузку символов; то есть символы не загружаются до тех пор, пока это не требуется. Эквивалент командной строки — -s. Дополнительные сведения и другие методы настройки этого параметра см. в разделе "Отложенная загрузка символов".
SetDll:filename	Установите DLL расширения. Расширение имени файла .dll должно быть опущено. По умолчанию используется userexts.dll. Эквивалент командной строки — a. Дополнительные сведения и другие методы настройки данного параметра по умолчанию см. в разделе Загрузка библиотек DLL отладочного расширения.
StopFirst:flag	ИСТИНА или ЛОЖЬ. Если true, CDB останавливается на точке останова в конце процесса загрузки образа. Эквивалент командной строки — -g.
StopOnProcessExit:flag	ИСТИНА или ЛОЖЬ. Если TRUE, CDB останавливается при получении уведомления о завершении процесса. Эквивалент командной строки — -G.
sxd:eventsxe:event	Задает ответ отладчика и состояние обработки для указанного исключения или события. Исключения и события могут быть указаны следующим образом: *: исключение n по умолчанию: исключение n (десятичный) 0xn: исключение 0xn (шестнадцатеричное) (другое): код события Дополнительные сведения об этом процессе и других методах управления этими параметрами см. в разделе "Управление исключениями и событиями ".
VerboseOutput:flag	ИСТИНА или ЛОЖЬ. Если TRUE, CDB отобразит подробные сведения об обработке символов, уведомлении о событиях и других процессах во время выполнения. Эквивалент командной строки — -v.
линии:флаг	ИСТИНА или ЛОЖЬ. Флаг строк включает или отключает поддержку информации о строках исходного кода.
srcopt:опции	Задает параметры исходной строки, которые управляют параметрами отображения источника и параметров шагов программы. Дополнительные сведения см. в разделе l+, l- (настройка параметров источника).
srcpath:directory	Задает путь поиска исходного файла. Дополнительные сведения см. в статье .srcpath, .lsrcpath (Set Source Path).
enable_unicode:flag	ИСТИНА или ЛОЖЬ. Флаг enable_unicode указывает, отображает ли отладчик указатели и массивы USHORT в виде строк Юникода.
force_radix_output:flag	ИСТИНА или ЛОЖЬ. Флаг force_radix_output указывает, отображаются ли целые числа в десятичном формате или в радиксе по умолчанию.
col_mode:flag	ИСТИНА или ЛОЖЬ. Флаг col_mode управляет параметром цветового режима. Если режим цвета включен, отладчик может создавать цветные выходные данные. По умолчанию большинство цветов не задаются, а по умолчанию используются текущие цвета консоли.
col:namecolspec	Имя указывает элемент, который вы раскрашиваете. Colspec — это трехбуквенный индикатор RGB формы [rR-][gG-][bB-]. Буква нижнего регистра указывает на более тёмное, буква верхнего регистра указывает на более яркое, а тире указывает на отсутствие вклада цветового компонента. Из-за ограничений цвета консоли яркость не применяется к каждому компоненту отдельно, но воздействует на все компоненты, если любой из них требует яркость. Другими словами, rgB совпадает с RGB. По этой причине рекомендуется использовать все заглавные буквы, если будут использоваться какие-либо заглавные буквы. Пример использования: col: emphfg R--

Ниже приведен пример раздела [NTSD] в файле tools.ini:

[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true