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

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

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

Записи tools.ini приведены в следующей таблице.

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

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

Ввод Описание

$u 0:значение ... $u 9:value

Присваивать значения псевдонимам с фиксированным именем. Можно указать числовые значения n или 0xn или любую другую строку. Дополнительные сведения см. в статье Использование псевдонимов . Нет эквивалента командной строки.

DebugChildren:flag

TRUE или FALSE. Если задано значение TRUE, CDB выполняет отладку указанного приложения, а также всех дочерних процессов, которые оно может породить. Эквивалент командной строки — -o.

DebugOutput:flag

TRUE или FALSE. Если задано значение TRUE, CDB отправляет выходные данные и получает входные данные через терминал. Если значение FALSE, выходные данные переходит на экран пользователя. Параметр командной строки -d аналогичен, но не идентичен.

IniFile:file

Указывает имя файла скрипта, из который CDB или KD принимает команды при запуске. По умолчанию используется файл ntsd.ini в текущем каталоге. Эквивалент командной строки — -cf. Дополнительные сведения см. в разделе Использование файлов скриптов.

LazyLoad:flag

TRUE или FALSE. Если задано значение TRUE, CDB выполняет отложенную загрузку символов; то есть символы не загружаются до тех пор, пока не потребуется. Эквивалент командной строки — -s.

Дополнительные сведения и другие методы установки этого параметра см. в разделе Отложенная загрузка символов.

SetDll:filename

Задайте библиотеку DLL расширения. Следует опустить расширение имени файла .dll. Значение по умолчанию — userexts.dll. Эквивалент командной строки — -a.

Дополнительные сведения и другие методы установки этого значения по умолчанию см. в разделе Загрузка библиотек DLL расширения отладчика.

StopFirst:flag

TRUE или FALSE. Если значение равно true, CDB останавливается в точке останова в конце процесса загрузки образа. Эквивалент командной строки — -g.

StopOnProcessExit:flag

TRUE или FALSE. Если задано значение TRUE, CDB останавливается при получении уведомления о завершении процесса. Эквивалент командной строки — -G.

sxd:eventsxe:event

Задает ответ отладчика и состояние обработки для указанного исключения или события.

Исключения и события можно указать следующими способами:

*: исключение по умолчанию n: исключение n (decimal) 0xn: исключение 0xn (шестнадцатеричное) (другое): код события

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

VerboseOutput:flag

TRUE или FALSE. Если задано значение TRUE, в CDB будут отображаться подробные сведения об обработке символов, уведомлениях о событиях и других вхождениях во время выполнения. Эквивалент командной строки — -v.

lines:flag

TRUE или FALSE. Флаг строк включает или отключает поддержку данных исходной строки.

srcopt:options

Задает параметры исходной строки, управляющие отображением источника и параметрами пошагового выполнения программы. Дополнительные сведения см. в разделе l+, l- (настройка параметров источника).

srcpath:directory

Задает путь поиска исходного файла. Дополнительные сведения см. в разделе .srcpath, .lsrcpath (Set Source Path) (Установка исходного пути).

enable_unicode:flag

TRUE или FALSE. Флаг enable_unicode указывает, отображает ли отладчик указатели и массивы USHORT в виде строк Юникода.

force_radix_output:flag

TRUE или FALSE. Флаг force_radix_output указывает, отображаются ли целые числа в десятичном формате или в радиксе по умолчанию.

col_mode:flag

TRUE или FALSE. Флаг 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