Uso de archivos de script

Un archivo de script es un archivo de texto que contiene una secuencia de comandos del depurador. Hay varias maneras de que el depurador cargue un archivo de script y ejecútelo. Un archivo de script puede contener comandos que se ejecutarán secuencialmente o puede usar un flujo de ejecución más complejo.

Para ejecutar un archivo de script, puede realizar una de las acciones siguientes:

  • (Solo KD y CDB; solo cuando se inicia el depurador) Cree un archivo de script denominado Ntsd.ini y colóquelo en el directorio desde el que va a iniciar el depurador. El depurador ejecuta automáticamente este archivo cuando se inicia el depurador. Para usar un archivo diferente para el archivo de script de inicio, especifique la ruta de acceso y el nombre de archivo mediante la opción de línea de comandos -cf o mediante la entrada IniFile en el archivo Tools.ini.

  • (Solo KD y CDB; cuando se inicia cada sesión) Cree un archivo de script y especifique su ruta de acceso y su nombre de archivo mediante la opción de línea de comandos -cfr. El depurador ejecuta automáticamente este archivo de script cuando se inicia el depurador y cada vez que se reinicia el destino.

  • Use los comandos $, $<, $<><$ y $$>< para ejecutar un archivo de script después de ejecutar el depurador. Para obtener más información sobre la sintaxis, vea $, $><<, $><, $$>< (Ejecutar archivo de script).

Los comandos $>< y $$>< difieren de los otros métodos de ejecución de scripts de una manera importante. Cuando se usan estos comandos, el depurador abre el archivo de script especificado, reemplaza todos los retornos de carro por punto y coma y ejecuta el texto resultante como un único bloque de comandos. Estos comandos son útiles para ejecutar scripts que contienen programas de comandos del depurador. Para obtener más información sobre estos programas, vea Using Debugger Command Programs. X

No puede usar comandos que solo estén disponibles en WinDbg (como .lsrcfix (Usar servidor de origen local), .lsrcpath (Establecer ruta de acceso de origen local), .open (Archivo de código abierto) y .write_cmd_hist (Historial de comandos de escritura)) en archivos de script, incluso si el archivo de script se ejecuta en WinDbg. Además, no puede usar el .beep (Speaker Beep), .cls (Borrar pantalla), .hh (Abrir archivo de ayuda HTML), .idle_cmd (Establecer comando inactivo), .remote (Crear Remote.exe Servidor), el modo kernel-restart (Reiniciar conexión del kernel), el modo de usuario .restart (Reiniciar aplicación de destino) o .wtitle (Establecer título de la ventana) comandos en un archivo de script.

WinDbg admite los mismos scripts que KD y CDB, con una excepción secundaria. Puede usar el comando .remote_exit (Exit Debugging Client) solo en un archivo de script que usa KD o CDB. No se puede salir de un cliente de depuración a través de un script que se ejecuta en WinDbg.