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

Iniciar o WinDbg

Depois que o WinDbg for instalado, WinDbgX.exe estará disponível para execução em qualquer local de diretório.

Opções de inicialização de 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 uma linha de comando depois que o depurador é conectado. Esse comando deve ser colocado entre aspas. Vários comandos podem ser separados com ponto e vírgula.
-v	Habilita a saída verbosa no depurador.
-T Title	Define o título da janela.
-logo LogFile	Abrir log. Começa a registrar informações em um arquivo de log. Se existir outro arquivo, ele será substituído.
-loga LogFile	Acréscimo de log. Começa a registrar informações em um arquivo de log. Se o arquivo existir, ele será acrescentado.
-e EventHandle	Sinaliza o evento com o identificador determinado após a próxima exceção em um destino.
-?	Exibe um resumo dos comandos disponíveis.

Opções de kernel

Option	Description
-k \[ConnectType\]	Inicia uma sessão de depuração de kernel. Se -k for usado sem nenhuma opção ConnectType seguindo-o, ele deverá 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 no mesmo computador utilizado pelo depurador.
-kx ExdiOptions	Inicia uma sessão de depuração de kernel usando um driver EXDI. Para obter mais informações sobre EXDI, consulte Configurando o transporte do depurador EXDI.
-I	Após uma reinicialização, o depurador invadirá o computador de destino assim que um módulo de kernel for carregado.

Opções de modo de usuário

Option	Description
-o	Depura todos os processos iniciados pelo aplicativo de destino (processos filho).
-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 ser anexado ao processo de destino de forma não invasiva.
-hd	Especifica que o heap de depuração não deve ser utilizado.
-cimp	Especifica que todos os processos criados usarão um conjunto de linha de comando implícito 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 ClientTransport , consulte Ativando um cliente de depuração. Quando esse parâmetro é usado, ele deve ser os primeiros parâmetros 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 o ID numérico do processo a ser depurado.
-tid TID	Especifica o ID de um thread que deve ser retomado 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 falha 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 autodetecção e defina a arquitetura 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 KDNET.
-openPrivateDumpByHandle Handle	Somente uso interno da Microsoft. Especifica o identificador de um arquivo de despejo de falha para depuração.
-benchmarkStartup	Somente uso interno da Microsoft. Executa um teste de desempenho de inicialização e adiciona o resultado a um arquivo.

Opções de símbolo

Option	Description
-y SymbolPath	Especifica o caminho do símbolo a ser usado. Separar vários caminhos com um ponto-e-vírgula (;). Se o caminho contiver espaços, ele deverá ser colocado entre aspas. Para obter detalhes e outras maneiras de alterar esse caminho, consulte o Caminho do Símbolo.
-n	Carga de símbolo barulhento. 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 a arquivos" durante o carregamento de símbolos.
-ses	Faz com que o depurador execute uma avaliação rigorosa de todos os arquivos de símbolo 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 as variáveis de ambiente do caminho de símbolos e do caminho de imagem executável.
-snc	Faz com que o depurador desligue a tradução de C++.
-snul	Desabilita 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 serão efetivamente os mesmos (seu "servidor" é sua sessão local.) Para depuração remota, há situações em que talvez você queira defini-las para valores diferentes. Para obter mais informações sobre depuração remota, consulte Depuração Remota.

Tratamento de exceções

Option	Description
-x	Habilite o tratamento de segunda chance somente para exceções de violação de acesso.
-xe Exception	Ative o manuseio de exceções de primeira chance para a exceção especificada.
-xd Exception	Habilite o tratamento de exceção de segunda chance para a exceção especificada.
-xn Exception	Para a exceção fornecida, desabilite o tratamento de primeira e segunda chance e exiba apenas uma mensagem no console.
-xi Exception	Ignore completamente a exceção fornecida, desabilitando a manipulação de primeira e segunda chance e não gerando nada para o console.

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

Post-mortem

Option	Description
-I	Defina o WinDbg como o depurador pós-mortem padrão para o sistema.
-IS	Configura o WinDbg como o depurador post-mortem padrão para o sistema de forma silenciosa, com apenas erros sendo relatados.

Opções preteridas

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

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

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

Conteúdo relacionado

• Recursos do WinDbg