tools.ini konfigurálása

A tools.ini fájl információkat tartalmaz a parancssori hibakeresők inicializálásához. Indításkor a hibakereső megkeresi a megfelelő szakaszfejlécet a tools.ini fájlban, és kinyeri az inicializálási információkat a fejléc alatti bejegyzésekből. Minden parancssori hibakereső saját szakaszfejléccel rendelkezik – [CDB], [NTSD] és [KD]. Az INIT környezeti változónak a tools.ini fájlt tartalmazó könyvtárra kell mutatnia.

A WinDbg nem használja a tools.ini fájlt. Ehelyett a WinDbg menti az inicializálási beállításokat a munkaterületeken.

A tools.ini bejegyzések az alábbi táblázatban láthatók.

A kulcsszavakat szóközzel vagy kettősponttal kell elválasztani az értékektől. A kulcsszavak nem megkülönböztetik a kis- és nagybetűket.

IGAZ vagy HAMIS értékek esetén a "HAMIS" az egyetlen hamis érték. Az egyéb mind igaz.

Bejegyzés Leírás

$u 0:érték ... $u 9:value

Az értékek hozzárendelése állandó nevekhez tartozó aliasokhoz. Megadhatja az n vagy a 0xn numerikus értékeket vagy bármely más sztringet. Részletekért lásd: Aliasok használata . Nincs parancssori megfelelője.

DebugChildren:flag

IGAZ vagy HAMIS. Ha IGAZ, a CDB a megadott alkalmazást és az esetlegesen előforduló gyermekfolyamatokat is hibakeresésre hajtja. A parancssor megfelelője -o.

DebugOutput:flag

IGAZ vagy HAMIS. Ha IGAZ, a CDB kimenetet küld, és bemenetet fogad egy terminálon keresztül. Ha HAMIS, a kimenet a felhasználói képernyőre kerül. A -d parancssori lehetőség hasonló, de nem azonos.

IniFile:file

Annak a szkriptfájlnak a nevét adja meg, amelyről a CDB vagy a KD parancsokat hajt végre indításkor. Az alapértelmezett a ntsd.ini fájl az aktuális könyvtárban. A parancssor megfelelője -cf. További részletekért lásd: Szkriptfájlok használata.

LazyLoad:flag

IGAZ vagy HAMIS. Ha IGAZ, a CDB késleltetett szimbólum betöltést végez, vagyis a szimbólumok csak akkor töltődnek be, amikor szükség van rájuk. A parancssor megfelelője - s.

További részletekért és a beállítás egyéb módszereiért lásd: Halasztott szimbólum betöltése.

SetDll:filename

Bővítmény DLL-ének beállítása. A .dll fájlnévkiterjesztést ki kell hagyni. Az alapértelmezett érték userexts.dll. A parancssor megfelelője -a.

További részletekért és az alapértelmezett beállítás egyéb módszereiért lásd: Hibakereső bővítmény DLL-einek betöltése.

StopFirst:flag

IGAZ vagy HAMIS. Ha igaz, a CDB leáll a törésponton a képbetöltési folyamat végén. A parancssor megfelelője -g.

StopOnProcessExit:flag

IGAZ vagy HAMIS. Ha IGAZ, a CDB leáll, amikor folyamatmegszüntetési értesítést kap. A parancssor megfelelője a -G.

sxd:eventsxe:event

Beállítja a hibakereső válaszát és a megadott kivétel vagy esemény kezelési állapotát.

Kivételek és események a következő módokon adhatók meg:

*: Alapértelmezett kivétel n: N kivétel (decimális) 0xn: 0xn (hexadecimális) kivétel (egyéb): Eseménykód

A folyamat részleteiről és a beállítások szabályozásának egyéb módszereiről a Kivételek és események szabályozása című témakörben olvashat.

VerboseOutput:flag

IGAZ vagy HAMIS. Ha IGAZ, a CDB részletes információkat jelenít meg a szimbólumkezelésről, az eseményértesítésről és az egyéb futásidejű eseményekről. A parancssor megfelelője -v.

lines:flag

IGAZ vagy HAMIS. A vonaljelző engedélyezi vagy letiltja a forrásvonal-információk támogatását.

srcopt:opciók

Beállítja a forrásvonal beállításait, amelyek a forrásmegjelenítést és a programlépési beállításokat vezérli. További információ: l+, l– (Forrásbeállítások megadása).

srcpath:directory

Beállítja a forrásfájl keresési útvonalát. További információ: .srcpath, .lsrcpath (Forrásútvonal beállítása).

enable_unicode:flag

IGAZ vagy HAMIS. A enable_unicode jelző azt határozza meg, hogy a hibakereső az USHORT-mutatókat és -tömböket Unicode-sztringekként jeleníti-e meg.

force_radix_output:flag

IGAZ vagy HAMIS. A force_radix_output jelző azt határozza meg, hogy az egész számok decimális formátumban vagy az alapértelmezett radix formátumban jelenjenek-e meg.

col_mode:flag

IGAZ vagy HAMIS. A színmód beállítását a col_mode jelző vezérli. Ha a színmód engedélyezve van, a hibakereső színes kimenetet hozhat létre. Alapértelmezés szerint a legtöbb szín nincs beállítva, és ehelyett alapértelmezés szerint az aktuális konzolszínek lesznek beállítva.

col:namecolspec

A név a színező elemet jelzi. A colspec egy hárombetűs RGB-mutató formátuma [rR-][gG-][bB-]. A kisbetű sötétebb, a nagybetűs betű világosabb, a kötőjel pedig nem jelez színösszetevő-hozzájárulást. A konzol színkorlátozásai miatt a fényesség nem komponensenként érvényesül, hanem ha bármelyik kérés fényességet igényel, az minden összetevőre alkalmazandó. Más szóval az rgB ugyanaz, mint az RGB. Ezért javasoljuk, hogy minden sapkát használjon, ha bármilyen sapkát használni fog.

Példahasználat:

col: emphfg R--

A tools.ini fájl minta [NTSD] szakasza a következő:

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