WinDbg: Opções de inicialização de linha de comando

Iniciar WinDbg

Depois que o WinDbg é instalado, WinDbgX.exe está disponível para ser executado a partir de qualquer local de diretório.

Opções de inicialização da linha de comando

WinDbgX [options]

As tabelas a seguir resumem as opções de linha de comando disponíveis.

Opções gerais

Option	Description
-c command	Executa um comando de linha após o depurador estar ligado. Este comando deve ser colocado entre aspas. Vários comandos podem ser separados com ponto-e-vírgula.
-v	Habilita a saída detalhada no depurador.
-T Title	Define o título da janela.
-logo LogFile	Log Aberto. Começa a registrar informações em um arquivo de log. Se o arquivo existir, ele será substituído.
-loga LogFile	Anexar log. Começa a registrar informações em um arquivo de log. Se o arquivo existir, ele será anexado.
-e EventHandle	Sinaliza o evento com o identificador fornecido após a próxima exceção em um destino.
-?	Exibe um resumo dos comandos disponíveis.

Opções do kernel

Option	Description
-k \[ConnectType\]	Inicia uma sessão de depuração do kernel. Se -k for usado sem nenhuma opção ConnectType após ele, ele deve ser a entrada final na linha de comando.
-kqm	Inicia o KD no modo silencioso.
-kl	Inicia uma sessão de depuração do kernel na mesma máquina que o depurador.
-kx ExdiOptions	Inicia uma sessão de depuração do kernel usando um driver EXDI. Para obter mais informações sobre EXDI, consulte Configuração do Transporte do Depurador EXDI.
-I	Após uma reinicialização, o depurador entrará no computador de destino assim que um módulo do kernel for carregado.

Opções do modo de utilizador

Option	Description
-o	Depura todos os subprocessos lançados pela aplicação de destino (subprocessos).
-g	Ignora o ponto de interrupção inicial no aplicativo de destino.
-G	Ignora o ponto de interrupção final no aplicativo de destino.
-pv	Especifica que o depurador deve ligar-se ao processo alvo de forma não invasiva.
-hd	Especifica que o heap de depuração não deve ser usado.
-cimp	Especifica que todos os processos criados usarão uma linha de comando implícita definida pelo servidor em vez de uma cadeia de caracteres de linha de comando fornecida pelo usuário do cliente.

Opções de destino

Option	Description
-remote ClientTransport	Conecta-se a um servidor de depuração que já está em execução. Para obter uma explicação dos possíveis valores de ClientTransport , consulte Ativando um cliente de depuração. Quando esse parâmetro é usado, ele deve ser o primeiro parâmetro na linha de comando.
-server ServerTransport	Cria um servidor de depuração que pode ser acessado por outros depuradores. Para obter uma explicação dos possíveis valores ServerTransport , consulte Ativando um servidor de depuração.
-premote SmartClientTransport	Cria um cliente inteligente e se conecta a um servidor de processo que já está em execução. Para obter uma explicação dos possíveis valores SmartClientTransport, consulte Ativando um cliente inteligente.
-p PID	Especifica a ID decimal do processo a ser depurado.
-tid TID	Especifica o ID de tarefa de uma tarefa a retomar quando a sessão de depuração for iniciada.
-psn ServiceName	Especifica o nome do serviço contido no processo a ser depurado. Isso é usado para depurar um processo que já está em execução.
-pn ProcessName	Especifica o nome do processo a ser depurado.
-z DumpFile	Especifica o nome de um arquivo de despejo de memória a ser depurado. Se o caminho e o nome do arquivo contiverem espaços, isso deverá ser cercado por aspas.
-debugArch x86 -or- amd64	Substitua o comportamento de deteção automática e defina o número de bits de destino para o depurador.
-loadSession	Carregue um arquivo de configuração de sessão salvo.
-setupFirewallRules	Configura as regras de firewall necessárias no sistema local para permitir a depuração do kernel usando o KDNET.
-openPrivateDumpByHandle Handle	Apenas para uso interno da Microsoft. Especifica o identificador de um arquivo de despejo de memória a ser depurado.
-benchmarkStartup	Apenas para uso interno da Microsoft. Executa um benchmark de inicialização e acrescenta o resultado a um arquivo.

Opções de símbolos

Option	Description
-y SymbolPath	Especifica o caminho do símbolo a ser usado. Separe vários caminhos com um ponto-e-vírgula (;). Se o caminho contiver espaços, ele deve ser colocado entre aspas. Para obter detalhes e outras maneiras de alterar esse caminho, consulte Caminho do símbolo.
-n	Carga de símbolos ruidosa. Habilita a saída detalhada do manipulador de símbolos.
-i *ImagePath	Define o caminho de pesquisa de imagem a ser usado.
-sdce	Faz com que o depurador exiba mensagens de 'Erro de acesso ao arquivo' durante o carregamento do símbolo.
-ses	Faz com que o depurador execute uma avaliação rigorosa de todos os arquivos de símbolos e ignore quaisquer símbolos questionáveis.
-sicv	Faz com que o manipulador de símbolos ignore o registro CV.
-sins	Faz com que o depurador ignore o caminho do símbolo e as variáveis de ambiente do caminho da imagem executável.
-snc	Faz com que o depurador desative a interpretação C++.
-snul	Desativa o carregamento automático de símbolos para nomes não qualificados.
-sup	Faz com que o manipulador de símbolos pesquise a tabela de símbolos públicos durante cada pesquisa de símbolos.
-sflags	Define todas as opções do manipulador de símbolos de uma só vez.

Opções de caminho de origem

Option	Description
-srcpath	Especifica o caminho de origem a ser usado no servidor de depuração.
-lsrcpath	Especifica o caminho de origem a ser usado no cliente local.

Se você estiver em uma sessão de depurador local, srcpath e lsrcpath são efetivamente os mesmos (seu "servidor" é sua sessão local.) Para depuração remota, há situações em que você pode querer defini-los para valores diferentes. Para obter mais informações sobre depuração remota, consulte Depuração remota.

Processamento de exceções

Option	Description
-x	Habilite o tratamento de segunda chance apenas para exceções de violação de acesso.
-xe Exception	Habilite o tratamento de exceções de primeira chance para a exceção especificada.
-xd Exception	Habilite o tratamento de exceções de segunda chance para a exceção especificada.
-xn Exception	Para a exceção dada, desative o manuseio de primeira e segunda chance e exiba apenas uma mensagem no console.
-xi Exception	Ignore completamente a exceção dada, desativando o manuseio de primeira e segunda chance e não enviando nada para o console.

Para obter uma lista de exceções que podem ser especificadas, consulte Definições de evento e padrões.

Post mortem

Option	Description
-I	Define WinDbg como o depurador post-mortem padrão para o sistema.
-IS	Define o WinDbg como o depurador post-mortem padrão para o sistema em segundo plano, com apenas os erros sendo relatados.

Opções preteridas

Option	Description
-Q	Opção de linha de comando descontinuada.
-QY	Opção de linha de comando descontinuada.
-QS	Opção de linha de comando descontinuada.
-QSY	Opção de linha de comando descontinuada.
-WX	Opção de linha de comando descontinuada.

Para obter informações gerais sobre os parâmetros de inicialização, consulte Opções de Command-Line do WinDbg.

Você pode usar -? para listar as opções de linha de comando suportadas.

Conteúdo relacionado

• Recursos do WinDbg