Поделиться через


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

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

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

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

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

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

Формат ввода Description

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

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

DebugChildren: флаг

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

DebugOutput: флаг

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

IniFile: файл

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

LazyLoad: флаг

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

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

SetDll: имя файла

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

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

StopFirst: флаг

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

StopOnProcessExit: флаг

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

sxd: событиеsxe: event

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

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

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

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

VerboseOutput: флаг

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

строки: флаг

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

srcopt: параметры

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

srcpath: каталог

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

enable_unicode: флаг

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

force_radix_output: флаг

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

col_mode: флаг

TRUE или FALSE. Флаг col_mode управляет параметром цветового режима. Если режим цвета включен, отладчик может создавать цветные выходные данные. По умолчанию большинство цветов не задаются, а по умолчанию используются текущие цвета консоли.

col: name colspec

Имя указывает элемент, который вы цветете. Colspec — это трехбуквенный индикатор RGB формы [rR-][gG-][bB-]. Буква нижнего регистра указывает на темнее, буква верхнего регистра указывает на яркое и тире не указывает на вклад компонента цвета. Из-за ограничений цвета консоли яркий цвет на самом деле не является компонентом, но применяется ко всем компонентам, если любой запрос яркий. Другими словами, rgB совпадает с RGB. По этой причине рекомендуется использовать все крышки, если будут использоваться какие-либо крышки.

Пример использования:

col: emphfg R--

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

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