Verwenden von Skriptdateien

  • Artikel

Eine Skriptdatei ist eine Textdatei, die eine Sequenz von Debuggerbefehlen enthält. Es gibt verschiedene Möglichkeiten für den Debugger, eine Skriptdatei zu laden und auszuführen. Eine Skriptdatei kann Befehle enthalten, die sequenziell ausgeführt werden sollen, oder einen komplexeren Ausführungsfluss verwenden.

Um eine Skriptdatei auszuführen, können Sie eine der folgenden Aktionen ausführen:

  • (nur KD und CDB; nur beim Start des Debuggers) Erstellen Sie eine Skriptdatei mit dem Namen Ntsd.ini, und legen Sie sie in das Verzeichnis ab, in dem Sie den Debugger starten. Der Debugger führt diese Datei automatisch aus, wenn der Debugger gestartet wird. Um eine andere Datei für die Startskriptdatei zu verwenden, geben Sie den Pfad und den Dateinamen mithilfe der Befehlszeilenoption-cf oder mithilfe des Eintrags IniFile in der Tools.ini-Datei an.

  • (Nur KD und CDB; wenn jede Sitzung beginnt) Erstellen Sie eine Skriptdatei, und geben Sie ihren Pfad und Dateinamen mithilfe der Befehlszeilenoption-cfr an. Der Debugger führt diese Skriptdatei automatisch aus, wenn der Debugger gestartet wird und jedes Mal, wenn das Ziel neu gestartet wird.

  • Verwenden Sie die Befehle $<, $><, $$< und $$><, um eine Skriptdatei auszuführen, nachdem der Debugger ausgeführt wird. Weitere Informationen zur Syntax finden Sie unter $<, $, $><><, $$>< (Skriptdatei ausführen).

Die Befehle $>< und $$>< unterscheiden sich in einer wichtigen Weise von den anderen Methoden zum Ausführen von Skripts. Wenn Sie diese Befehle verwenden, öffnet der Debugger die angegebene Skriptdatei, ersetzt alle Wagenrückläufe durch Semikolons und führt den resultierenden Text als einzelnen Befehlsblock aus. Diese Befehle sind nützlich zum Ausführen von Skripts, die Debuggerbefehlsprogramme enthalten. Weitere Informationen zu diesen Programmen finden Sie unter Verwenden von Debuggerbefehlsprogrammen. X

Sie können befehle, die nur in WinDbg verfügbar sind (z. B . .lsrcfix (Use Local Source Server), .lsrcpath (Set Local Source Path), .open (Open Source File) und .write_cmd_hist (Write Command History)) in Skriptdateien nicht verwenden, auch wenn die Skriptdatei in WinDbg ausgeführt wird. Darüber hinaus können Sie die Befehle .beep (Lautsprecherton), .cls (Clear Screen), .hh (Open HTML Help File),.idle_cmd (Set Idle Command), .remote (Create Remote.exe Server)), kernel-mode .restart (Restart Kernel Connection), user-mode .restart (Restart Target Application) oder .wtitle (Set Window Title) in einer Skriptdatei verwenden.

WinDbg unterstützt dieselben Skripts wie KD und CDB, mit einer kleinen Ausnahme. Sie können den Befehl .remote_exit (Debugclient beenden) nur in einer Skriptdatei verwenden, die von KD oder CDB verwendet wird. Sie können einen Debugclient nicht beenden, obwohl ein Skript in WinDbg ausgeführt wird.