WinDbg – Configurações e workspaces

Artigo
10/26/2023

Esta seção descreve como configurar e configurar o depurador WinDbg.

Configurações

Use o menu de configurações para definir itens como o caminho de origem e símbolo, bem como escolha o tema claro e escuro para o depurador.

Atualmente, há seis painéis de diálogo de configurações:

Geral
Janela Comando
Configurações de depuração
Janelas desmontadas
Exceções de & de eventos
Janela de origem

Para obter mais informações sobre como definir os caminhos, consulte Caminho do símbolo para o depurador do Windows e Depuração de Código-Fonte no WinDbg (Clássico).

Workspaces

Os workspaces permitem salvar informações de configuração no arquivo de informações de conexão de destino.

As opções nos workspaces são salvas ao fechar o depurador ou podem ser salvas manualmente usando Arquivo ->Salvar Workspace.

Os workspaces são carregados automaticamente ao iniciar da lista de destinos recentes ou podem ser carregados manualmente no menu de arquivos.

Além das informações de conexão de destino, as configurações a seguir são armazenadas no arquivo de workspaces.

Configurações gerais

Observação

Essa lista e o formato não são finais e estão sujeitos a alterações.

Configuração	Padrão	Descrição
FinalBreak	true	Se for true, ignorará o ponto de interrupção final (opção de linha de comando -g).
SourceDebugging	true	Alterna entre o modo de origem ou assembly.
DebugChildProcesses	false	(Somente modo de usuário) Se true depurar processos filho iniciados pelo aplicativo de destino. (opção de linha de comando).
Não invasivo	false	Especifica a anexação não invasiva (opção de linha de comando -pv).
NoDebugHeap	false	Especifica que o heap de depuração não deve ser usado (opção de linha de comando-hd).
Detalhado	false	Quando o modo detalhado é ativado, alguns comandos de exibição (como o despejo de registro) produzem uma saída mais detalhada. (opção de linha de comando (-v).
Elevate	-	Usado internamente pelo WinDbg – Não modifique.
Reinicializável	-	Usado internamente pelo WinDbg – Não modifique.
UseImplicitCommandLine	false	Use a linha de comando implícita (opção de linha de comando-cimp). Isso inicia o depurador com uma linha de comando implícita em vez de um processo explícito a ser executado.

Para obter mais informações sobre as opções de linha de comando, consulte Opções de Command-Line do WinDbg.

Configurações de Símbolo

Configuração	Padrão	Descrição
SymbolOptionsOverride	0	Uma máscara de opção de símbolo explícita, na forma de um único número hexadecimal.
ShouldOverrideSymbolOptions	false	Se definido como true , substitua todas as opções de símbolo listadas abaixo com a máscara de opção de símbolo fornecida, descrita acima.
SymOptExactSymbols	false	Essa opção faz com que o depurador execute uma avaliação estrita de todos os arquivos de símbolo.
SymOptFailCriticalErrors	false	Essa opção de símbolo faz com que as caixas de diálogo de erro de acesso ao arquivo sejam suprimidas.
SymOptIgnoreCvRec	false	Essa opção faz com que o manipulador de símbolos ignore o registro CV no cabeçalho da imagem carregada ao pesquisar símbolos.
SymOptIgnoreNtSympath	false	Essa opção faz com que o depurador ignore as configurações de variável de ambiente para o caminho do símbolo e o caminho da imagem executável.
SymOptNoCpp	false	Essa opção de símbolo desativa a tradução do C++. Quando essa opção de símbolo é definida, :: é substituído por __ em todos os símbolos.
SymOptNoUnqualifiedLoads	false	Essa opção de símbolo desabilita o carregamento automático de módulos do manipulador de símbolos. Quando essa opção é definida e o depurador tenta corresponder a um símbolo, ele pesquisará apenas os módulos que já foram carregados.
SymOptAutoPublics	false	Essa opção de símbolo faz com que DbgHelp pesquise a tabela de símbolos públicos em um arquivo .pdb apenas como último recurso. Se alguma correspondência for encontrada ao pesquisar os dados de símbolo privado, os símbolos públicos não serão pesquisados. Isso melhora a velocidade de pesquisa de símbolos.
SymOptDebug	false	Essa opção de símbolo ativa o carregamento de símbolo barulhento. Isso instrui o depurador a exibir informações sobre sua pesquisa por símbolos.

Para obter mais informações sobre opções de símbolo, consulte Opções de símbolo.

Configurações de layout de janela

O layout da janela é salvo globalmente e não é salvo no arquivo de workspaces.

Arquivo XML de workspaces

As informações de conexão de destino e workspace são armazenadas no formato XML.

O arquivo a seguir mostra um arquivo de configuração de workspaces de exemplo.

<?xml version="1.0" encoding="utf-8"?>
<TargetConfig Name="C:\paint.dmp" LastUsed="2017-08-03T21:34:20.1013837Z">
  <EngineConfig />
  <EngineOptions>
    <Property name="FinalBreak" value="true" />
    <Property name="SourceDebugging" value="true" />
    <Property name="DebugChildProcesses" value="false" />
    <Property name="Noninvasive" value="false" />
    <Property name="NoDebugHeap" value="false" />
    <Property name="Verbose" value="false" />
    <Property name="SymbolOptionsOverride" value="0" />
    <Property name="ShouldOverrideSymbolOptions" value="false" />
    <Property name="SymOptExactSymbols" value="false" />
    <Property name="SymOptFailCriticalErrors" value="false" />
    <Property name="SymOptIgnoreCvRec" value="false" />
    <Property name="SymOptIgnoreNtSympath" value="false" />
    <Property name="SymOptNoCpp" value="false" />
    <Property name="SymOptNoUnqualifiedLoads" value="false" />
    <Property name="SymOptAutoPublics" value="false" />
    <Property name="SymOptDebug" value="false" />
    <Property name="Elevate" value="false" />
    <Property name="Restartable" value="true" />
    <Property name="UseImplicitCommandLine" value="false" />
  </EngineOptions>
  <TargetOptions>
    <Option name="OpenDump">
      <Property name="DumpPath" value="C:\paint.dmp" />
    </Option>
  </TargetOptions>
</TargetConfig>

Observe que esse formato de arquivo continua evoluindo à medida que mais recursos são adicionados ao depurador WinDbg.

Consulte Também

Recursos do WinDbg

Compartilhar via