Настройка 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