Configuração de símbolos e caminhos de imagem executáveis no CDB

  • Artigo

Caminho do símbolo

O caminho do símbolo especifica os diretórios em que os arquivos de símbolo estão localizados. Para obter mais informações sobre símbolos e arquivos de símbolo, consulte Símbolos.

Nota Se você estiver conectado à Internet ou a uma rede corporativa, a maneira mais eficiente de acessar símbolos é usar um servidor de símbolos. Você pode usar um servidor de símbolos usando a cadeia de caracteres srv* ou symsrv* dentro do caminho do símbolo. Para obter mais informações sobre servidores de símbolos, consulte Caminho do símbolo para o depurador do Windows.

Para controlar o caminho do símbolo no CDB, siga um destes procedimentos:

  • Insira o comando .sympath (Definir Caminho do Símbolo). Se você estiver usando um servidor de símbolos, o comando .symfix (Definir Caminho do Repositório de Símbolos) será semelhante a .sympath, mas salvará você digitando.

  • Ao iniciar o depurador, use a opção de linha de comando -y . Consulte Opções de Command-Line do CDB.

  • Antes de iniciar o depurador, use as variáveis de ambiente _NT_SYMBOL_PATH e _NT_ALT_SYMBOL_PATH para definir o caminho. O caminho do símbolo é criado acrescentando _NT_SYMBOL_PATH após _NT_ALT_SYMBOL_PATH. (Normalmente, o caminho é definido por meio do _NT_SYMBOL_PATH. No entanto, convém usar _NT_ALT_SYMBOL_PATH para substituir essas configurações em casos especiais, como quando você tem versões privadas de arquivos de símbolo compartilhados.)

    Nota Se você usar a opção de linha de comando -sins , o depurador ignorará a variável de ambiente de caminho de símbolo.

Caminho da imagem executável

Um arquivo executável é um arquivo binário que o processador pode executar. Normalmente, esses arquivos têm a extensão de nome de arquivo .exe, .dll ou .sys. Os arquivos executáveis também são conhecidos como módulos, especialmente quando arquivos executáveis são descritos como unidades de um aplicativo maior. Antes que o sistema operacional Windows execute um arquivo executável, ele o carrega na memória. A cópia do arquivo executável na memória é chamada de imagem executável ou imagem.

Nota Às vezes, esses termos são usados de forma imprecisa. Por exemplo, alguns documentos podem usar "image" para o arquivo real no disco. Além disso, o kernel do Windows e o HAL têm nomes de módulo especiais. Por exemplo, o módulo nt corresponde ao arquivo Ntoskrnl.exe.

O caminho da imagem executável especifica os diretórios nos quais os arquivos executáveis binários estão localizados.

Na maioria das situações, o depurador sabe o local dos arquivos executáveis, portanto, você não precisa definir o caminho para esse arquivo.

No entanto, há situações em que esse caminho é necessário. Por exemplo, os arquivos de despejo de memória pequenos no modo kernel não contêm todos os arquivos executáveis que existem na memória no momento de um erro de parada (ou seja, uma falha). Da mesma forma, os arquivos de minidump no modo de usuário não contêm os binários do aplicativo. Se você definir o caminho dos arquivos executáveis, o depurador poderá encontrar esses arquivos binários.

O caminho de imagem executável do depurador é uma cadeia de caracteres que consiste em vários caminhos de diretório, separados por ponto e vírgula. Caminhos relativos são compatíveis. No entanto, a menos que você sempre inicie o depurador do mesmo diretório, você deve adicionar uma letra de unidade ou um compartilhamento de rede antes de cada caminho. Também há suporte para compartilhamentos de rede. O depurador pesquisa o caminho de imagem executável recursivamente. Ou seja, o depurador pesquisa os subdiretórios de cada diretório listado nesse caminho.

Para controlar o caminho da imagem executável no CDB, siga um destes procedimentos: