Verwenden von Skriptdateien

  • Artikel

Eine Skriptdatei ist eine Textdatei, die eine Sequenz von Debuggerbefehlen enthält. Es gibt eine Vielzahl von Möglichkeiten, wie der Debugger eine Skriptdatei laden und ausführen kann. Eine Skriptdatei kann Befehle enthalten, die sequenziell ausgeführt werden sollen, oder einen komplexeren Ausführungsfluss verwenden.

Zum Ausführen einer Skriptdatei können Sie eine der folgenden Aktionen ausführen:

  • (Nur KD und CDB; nur, wenn der Debugger gestartet wird) Erstellen Sie eine Skriptdatei mit dem Namen Ntsd.ini, und fügen Sie sie in das Verzeichnis ein, aus dem Sie den Debugger starten. Der Debugger führt diese Datei automatisch aus, wenn der Debugger gestartet wird. Wenn Sie eine andere Datei für die Startskriptdatei verwenden möchten, geben Sie den Pfad und dateinamen mithilfe der Befehlszeilenoption "-cf" oder mithilfe des IniFile-Eintrags in der Tools.ini-Datei an.

  • (Nur KD und CDB; wenn jede Sitzung gestartet wird) 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 wurde. Weitere Informationen zur Syntax finden Sie unter $<, $, $><, $, $><$>< (Skriptdatei ausführen).

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

Sie können keine Befehle verwenden, die nur in WinDbg (z. B. Lsrcfix (Local Source Server) und .lsrcpath (Set Local Source Path), .open (Open Source File) und .write_cmd_hist (Write Command History)) in Skriptdateien verfügbar sind, auch wenn die Skriptdatei in WinDbg ausgeführt wird. Darüber hinaus können Sie den Signalton (Lautsprecherbeep), .cls (Clear Screen), HH (Open HTML Help File), .idle_cmd (Set Idle Command), .remote (Create Remote.exe Server), Kernelmodus .restart (Restart Kernel Connection), User-Mode .restart (Restart Target Application) oder .wtitle (Set Window Title) verwenden. Befehle in einer Skriptdatei.

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