Konfigurieren von tools.ini

Die Datei tools.ini enthält Informationen zum Initialisieren der Befehlszeilendebugger. Beim Start sucht der Debugger in der tools.ini-Datei nach dem entsprechenden Abschnittsheader und extrahiert Initialisierungsinformationen aus den Einträgen unter der Kopfzeile. Jeder Befehlszeilendebugger verfügt über einen eigenen Abschnittsheader - [CDB], [NTSD] und [KD]. Die Umgebungsvariable INIT muss auf das Verzeichnis verweisen, das die tools.ini Datei enthält.

WinDbg verwendet die tools.ini Datei nicht. Stattdessen speichert WinDbg Initialisierungseinstellungen in Arbeitsbereichen.

Die tools.ini Einträge werden in der folgenden Tabelle angezeigt.

Schlüsselwörter müssen durch Leerzeichen oder Doppelpunkt von den Werten getrennt werden. Bei Schlüsselwörtern muss die Groß-/Kleinschreibung nicht beachtet werden.

Bei WAHR - oder FALSCH-Werten ist "FALSE" der einzige false-Wert. Alles andere ist WAHR.

Eintrag	Beschreibung
$u 0: Wert ... $u 9: Wert	Zuweisen von Werten zu Aliasen mit fester Bezeichnung. Sie können numerische Werte n oder 0xn oder eine beliebige andere Zeichenfolge angeben. Details finden Sie unter Verwenden von Aliasen . Keine Befehlszeilenentsprechung.
DebugChildren: Flag	WAHR oder FALSCH. Wenn WAHR, debugt CDB die angegebene Anwendung sowie alle untergeordneten Prozesse, die sie möglicherweise spawnen. Die Befehlszeilenentsprechung lautet -o.
DebugOutput: Flag	WAHR oder FALSCH. Wenn TRUE, sendet CDB Ausgabe und empfängt Eingaben über ein Terminal. Wenn FALSE, wechselt die Ausgabe an den Benutzerbildschirm. Die Befehlszeilenoption -d ist ähnlich, aber nicht identisch.
IniFile: Datei	Gibt den Namen der Skriptdatei an, von der CDB oder KD Befehle beim Start übernimmt. Der Standardwert ist die ntsd.ini Datei im aktuellen Verzeichnis. Befehlszeilenäquivalent ist -cf. Ausführliche Informationen finden Sie unter Verwenden von Skriptdateien.
LazyLoad: Flag	WAHR oder FALSCH. Wenn TRUE, führt CDB faules Laden von Symbolen durch. Das heißt, Symbole werden erst geladen, wenn erforderlich. Befehlszeilenäquivalent ist -s. Ausführliche Informationen und andere Methoden zum Festlegen dieser Option finden Sie unter "Verzögertes Laden von Symbolen".
SetDll: Dateiname	Erweiterungs-DLL festlegen. Die .dll Dateinamenerweiterung sollte weggelassen werden. Der Standardwert ist userexts.dll. Die Befehlszeilenentsprechung ist -a. Ausführliche Informationen und andere Methoden zum Festlegen dieser Standardeinstellung finden Sie unter Laden von Debuggererweiterungs-DLLs.
StopFirst: Flag	WAHR oder FALSCH. Ist "true", hält CDB am Ende des Bildladevorgangs am Haltepunkt an. Die Befehlszeilenentsprechung lautet -g.
StopOnProcessExit: Flag	WAHR oder FALSCH. Wenn TRUE, stoppt CDB, wenn sie eine Prozessbeendigungsbenachrichtigung empfängt. Befehlszeilenäquivalent ist -G.
sxd: Ereignissxe: Ereignis	Legt die Debuggerantwort und den Behandlungsstatus für die angegebene Ausnahme oder das angegebene Ereignis fest. Ausnahmen und Ereignisse können auf folgende Weise angegeben werden: *: Standard exception n: Exception n (decimal) 0xn: Exception 0xn (hexadecimal) (other): Ereigniscode Details zu diesem Prozess und andere Methoden zum Steuern dieser Einstellungen finden Sie unter "Steuern von Ausnahmen und Ereignissen ".
VerboseOutput: Flag	WAHR oder FALSCH. Wenn TRUE, zeigt CDB detaillierte Informationen zur Symbolbehandlung, Ereignisbenachrichtigung und anderen Laufzeitereignissen an. Befehlszeilenäquivalent ist -v.
Linien: Kennzeichnung	WAHR oder FALSCH. Die Linienkennzeichnung aktiviert oder deaktiviert die Unterstützung für Quellzeileninformationen.
srcopt: options	Legt die Quellzeilenoptionen fest, mit denen die Anzeige- und Programmschrittoptionen gesteuert werden. Weitere Informationen finden Sie unter l+, l- (Set Source Options).For more information see l+, l- (Set Source Options).
srcpath: directory	Legt den Pfad für die Quelldateisuche fest. Weitere Informationen finden Sie unter .srcpath, .lsrcpath (Set Source Path).
enable_unicode: Kennzeichnung	WAHR oder FALSCH. Das flag enable_unicode gibt an, ob der Debugger USHORT-Zeiger und Arrays als Unicode-Zeichenfolgen anzeigt.
force_radix_output: Kennzeichnung	WAHR oder FALSCH. Das flag force_radix_output gibt an, ob ganze Zahlen im Dezimalformat oder im Standardradiix angezeigt werden.
col_mode: Kennzeichnung	WAHR oder FALSCH. Das col_mode-Flag steuert die Einstellung für den Farbmodus. Wenn der Farbmodus aktiviert ist, kann der Debugger eine farbige Ausgabe erzeugen. Standardmäßig werden die meisten Farben nicht festgelegt, sondern standardmäßig auf die aktuellen Konsolenfarben festgelegt.
col: name colspec	Der Name gibt das Element an, das Sie färben. Die Colspec ist ein RGB-Indikator mit drei Buchstaben des Formulars [rR-][gG-][bB-]. Ein Kleinbuchstabe bedeutet dunkler, ein Großbuchstabe bedeutet heller und ein Gedankenstrich gibt keinen Farbkomponentenbeitrag an. Aufgrund von Konsolenfarbbeschränkungen ist hell nicht tatsächlich pro Komponente, sondern gilt für alle Komponenten, wenn sie hell anfordern. Mit anderen Worten, rgB ist identisch mit RGB. Aus diesem Grund wird empfohlen, dass alle Feststelltaste verwendet werden, wenn Feststelltaste verwendet werden. Beispielverwendung: Col: emphfg R--

Ein Beispielabschnitt [NTSD] in der datei tools.ini folgt:

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