Share via

Utilisation de fichiers de script

  • Article

Un fichier de script est un fichier texte qui contient une séquence de commandes de débogueur. Il existe plusieurs façons pour le débogueur de charger un fichier de script et de l’exécuter. Un fichier de script peut contenir des commandes à exécuter séquentiellement ou peut utiliser un flux d’exécution plus complexe.

Pour exécuter un fichier de script, vous pouvez effectuer l’une des opérations suivantes :

  • (KD et CDB uniquement ; uniquement au démarrage du débogueur) Créez un fichier de script nommé Ntsd.ini et placez-le dans le répertoire à partir duquel vous démarrez le débogueur. Le débogueur exécute automatiquement ce fichier au démarrage du débogueur. Pour utiliser un autre fichier pour le fichier de script de démarrage, spécifiez le chemin d’accès et le nom du fichier à l’aide de l’option de ligne de commande-cf ou en utilisant l’entrée IniFile dans le fichier Tools.ini.

  • (KD et CDB uniquement ; lorsque chaque session démarre) Créez un fichier de script et spécifiez son chemin et son nom à l’aide de l’option de ligne de commande-cfr. Le débogueur exécute automatiquement ce fichier de script au démarrage du débogueur et chaque fois que la cible est redémarrée.

  • Utilisez les commandes $<, $><, $$<et $$>< pour exécuter un fichier de script après l’exécution du débogueur. Pour plus d’informations sur la syntaxe, consultez $<, $><, $><$>< (Exécuter le fichier de script).

Les commandes $>< et $$>< diffèrent des autres méthodes d’exécution des scripts d’une manière importante. Lorsque vous utilisez ces commandes, le débogueur ouvre le fichier de script spécifié, remplace tous les retours chariot par des points-virgules et exécute le texte résultant sous la forme d’un seul bloc de commandes. Ces commandes sont utiles pour exécuter des scripts qui contiennent des programmes de commande du débogueur. Pour plus d’informations sur ces programmes, consultez Utilisation des programmes de commande du débogueur. X

Vous ne pouvez pas utiliser des commandes disponibles uniquement dans WinDbg (par exemple , .lsrcfix (Utiliser le serveur source local),.lsrcpath (Définir le chemin d’accès source local),.open (fichier open source) et .write_cmd_hist (écrire l’historique des commandes)) dans les fichiers de script, même si le fichier de script est exécuté dans WinDbg. En outre, vous ne pouvez pas utiliser les commandes .beep (signal sonore de l’orateur),.cls (effacer l’écran),.hh (Ouvrir le fichier d’aide HTML),.idle_cmd (Définir la commande inactive),.remote (Créer Remote.exe Server),.restart (Redémarrer la connexion au noyau),.restart (Redémarrer l’application cible) en mode utilisateur ou .wtitle (Définir le titre de la fenêtre) dans un fichier de script.

WinDbg prend en charge les mêmes scripts que KD et CDB, à une exception mineure. Vous pouvez utiliser la commande .remote_exit (Quitter le client de débogage) uniquement dans un fichier de script utilisé par KD ou CDB. Vous ne pouvez pas quitter un client de débogage via un script exécuté dans WinDbg.