Usando arquivos de script

  • Artigo

Um arquivo de script é um arquivo de texto que contém uma sequência de comandos do depurador. Há várias maneiras de o depurador carregar um arquivo de script e executá-lo. Um arquivo de script pode conter comandos a serem executados sequencialmente ou pode usar um fluxo de execução mais complexo.

Para executar um arquivo de script, você pode executar um dos seguintes procedimentos:

  • (somente KD e CDB; somente quando o depurador é iniciado) Crie um arquivo de script chamado Ntsd.ini e coloque-o no diretório do qual você está iniciando o depurador. O depurador executa automaticamente esse arquivo quando o depurador é iniciado. Para usar um arquivo diferente para o arquivo de script de inicialização, especifique o caminho e o nome do arquivo usando a opção de linha de comando -cf ou usando a entrada IniFile no arquivo Tools.ini.

  • (KD e CDB apenas; quando cada sessão começa) Crie um arquivo de script e especifique seu caminho e nome de arquivo usando a opção de linha de comando -cfr. O depurador executa automaticamente esse arquivo de script quando o depurador é iniciado e sempre que o destino é reiniciado.

  • Use os comandos $<, $><, $$< e $$>< para executar um arquivo de script depois que o depurador estiver em execução. Para obter mais informações sobre a sintaxe, consulte $<, $><, $><, $$>< (Executar arquivo de script).

Os comandos $>< e $$>< diferem dos outros métodos de execução de scripts de uma maneira importante. Quando você usa esses comandos, o depurador abre o arquivo de script especificado, substitui todos os retornos de carro por ponto-e-vírgula e executa o texto resultante como um único bloco de comando. Esses comandos são úteis para executar scripts que contêm programas de comando do depurador. Para obter mais informações sobre esses programas, consulte Usando programas de comando do depurador. X

Você não pode usar comandos que estão disponíveis apenas no WinDbg (como .lsrcfix (Usar Servidor de Origem Local), .lsrcpath (Definir Caminho de Origem Local), .open (Arquivo de Software Livre) e .write_cmd_hist (Gravar Histórico de Comandos)) em arquivos de script, mesmo que o arquivo de script seja executado no WinDbg. Além disso, você não pode usar .beep (bipe do alto-falante), .cls (limpar tela), .hh (abrir arquivo de ajuda HTML), .idle_cmd (definir comando ocioso), .remote (criar servidor Remote.exe), kernel-mode .restart (reiniciar conexão do kernel), user-mode .restart (reiniciar aplicativo de destino) ou .wtitle (definir título da janela) comandos em um arquivo de script.

O WinDbg dá suporte aos mesmos scripts que KD e CDB, com uma pequena exceção. Você pode usar o comando .remote_exit (Exit Debugging Client) somente em um arquivo de script usado pelo KD ou CDB. Você não pode sair de um cliente de depuração por meio de um script executado no WinDbg.