WinDbg – Opções de inicialização de linha de comando
Iniciando 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]
Estas tabelas a seguir resumem as opções de linha de comando disponíveis.
Opções gerais
| Opção | Descrição |
|---|---|
| -c "command" | Executa uma linha de comando depois que o depurador é anexado. Esse comando deve estar entre aspas. Vários comandos podem ser separados por ponto e vírgula. |
| -v | Habilita a saída detalhada no depurador. |
| -T Title | Define o título da janela. |
| -logo LogFile | Abrir log. Começa a registrar informações em log em um arquivo de log. Se outro arquivo existir, ele será substituído. |
| -loga LogFile | Acréscimo de log. Começa a registrar informações em log em um arquivo de log. Se o arquivo existir, ele será acrescentado a. |
| -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 de kernel
| Opção | Descrição |
|---|---|
| -k [ConnectType] | Inicia uma sessão de depuração de kernel. Se -k for usado sem nenhuma opção ConnectType após ele, 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 de kernel no mesmo computador que o 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. |
| -d | Após uma reinicialização, o depurador entrará no computador de destino assim que um módulo de kernel for carregado. |
Opções de modo de usuário
| Opção | Descrição |
|---|---|
| -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 usado. |
| -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
| Opção | Descrição |
|---|---|
| -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 de 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 de SmartClientTransport, consulte Ativando um cliente inteligente. |
| -p PID | Especifica a ID de processo decimal a ser depurada. |
| -tid TID | Especifica a ID de thread de um thread a ser retomada quando a sessão de depuração é 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á estar entre aspas. |
| -debugArch x86 -or- amd64 | Substitua o comportamento de detecção automática e defina o bitness 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 de kernel usando KDNET. |
| -openPrivateDumpByHandle Handle | Somente uso interno da Microsoft. Especifica o identificador de um arquivo de despejo de memória a ser depurado. |
| -benchmarkStartup | Somente uso interno da Microsoft. Executa um parâmetro de comparação de inicialização e acrescenta o resultado a um arquivo. |
Opções de símbolo
| Opção | Descrição |
|---|---|
| -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 deverá ser colocado entre aspas. Para obter detalhes e outras maneiras de alterar esse caminho, consulte Caminho do símbolo. |
| -n | Carregamento 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 ao arquivo" durante o carregamento do símbolo. |
| -Ses | Faz com que o depurador execute uma avaliação estrita de todos os arquivos de símbolo e ignore todos os símbolos questionáveis. |
| -sicv | Faz com que o manipulador de símbolos ignore o registro CV |
| -Pecados | 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 tradução do 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
| Opção | Descrição |
|---|---|
| -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 do depurador local, srcpath e lsrcpath serão efetivamente os mesmos (seu "servidor" é sua sessão local). Para depuração remota, há situtations em que talvez você queira defini-las para valores diferentes. Para obter mais informações sobre a depuração remota, consulte Depuração remota.
Tratamento de exceções
| Opção | Descrição |
|---|---|
| -X | Habilite o tratamento de segunda chance somente para exceções de violação de acesso. |
| Exceção -xe | Habilite o tratamento de exceção de primeira chance para a exceção especificada. |
| Exceção -xd | Habilite o tratamento de exceção de segunda chance para a exceção especificada. |
| Exceção -xn | Para a exceção fornecida, desabilite o tratamento de primeira e segunda chance e exiba apenas uma mensagem no console. |
| Exceção -xi | Ignore completamente a exceção fornecida, desabilitando o tratamento 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 evento e padrões.
Autópsia
| Opção | Descrição |
|---|---|
| -I | Define WinDbg como o depurador post mortem padrão para o sistema. |
| -É | Define o WinDbg como o depurador post mortem padrão para o sistema silenciosamente, com apenas erros sendo relatados. |
Opções preteridas
| Opção | Descrição |
|---|---|
| -Q | Opção de linha de comando preterida. |
| -QY | Opção de linha de comando preterida. |
| -QS | Opção de linha de comando preterida. |
| -QSY | Opção de linha de comando preterida. |
| -WX | Opção de linha de comando preterida. |
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 com suporte.
