Usando arquivos de script

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, siga um destes procedimentos:

• (KD e CDB apenas; somente quando o depurador é iniciado) Crie um arquivo de script chamado Ntsd.ini e coloque-o no diretório de onde 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 ficheiro de script após a execução do depurador. 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 os programas de comandos do depurador. X

Não é possível usar comandos que estão disponíveis somente no WinDbg (como .lsrcfix (Usar Servidor de Origem Local),.lsrcpath (Definir Caminho de Origem Local),.open (Arquivo de Código Aberto) 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, não é possível usar os comandos .beep (Speaker Beep),.cls (Clear Screen),.hh (Open HTML Help File), .idle_cmd (Set Idle Command), .remote (Create Remote.exe Server), kernel-mode .restart (Restart Kernel Connection), user-mode .restart (Restart Target Application) ou .wtitle (Set Window Title) num ficheiro de script.

WinDbg suporta os mesmos scripts como 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 através de um script que é executado no WinDbg.