Partager via


Utilisation de fichiers de script

Un fichier de script est un fichier texte qui contient une séquence de commandes de débogueur. Il existe différentes 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 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 lorsque le débogueur démarre) 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 de fichier à l’aide de l’option de ligne de commande -cf ou à l’aide de 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 d’accès 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 de scripts d’une manière importante. Lorsque vous utilisez ces commandes, le débogueur ouvre le fichier de script spécifié, remplace toutes les retours chariot par des points-virgules et exécute le texte résultant sous la forme d’un bloc de commande unique. Ces commandes sont utiles pour exécuter des scripts qui contiennent des programmes de commandes de débogueur. Pour plus d’informations sur ces programmes, consultez Utilisation des programmes de commandes du débogueur. X

Vous ne pouvez pas utiliser de commandes disponibles uniquement dans WinDbg (comme .lsrcfix (Utiliser le serveur source local), .lsrcpath (Définir le chemin de la source locale), .open (fichier open source)et .write_cmd_hist (historique des commandes d’écriture)) dans les fichiers de script, même si le fichier de script est exécuté dans WinDbg. En outre, vous ne pouvez pas utiliser le fichier .beep (Beep 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), le mode noyau .restart (Redémarrer la connexion du noyau), le mode utilisateur .restart (Redémarrer l’application cible)ou .wtitle (Définir le titre de la fenêtre) commandes dans un fichier de script.

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