Partilhar via

Definindo caminhos de símbolo e imagem executável em CDB

Caminho do símbolo

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

Observação 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 string srv* ou symsrv* dentro do caminho do símbolo. Para obter mais informações sobre servidores de símbolos, consulte Caminho de símbolos para o depurador do Windows.

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

  • Digite o comando .sympath (set Symbol Path). Se você estiver usando um servidor de símbolos, o comando .symfix (set Symbol Store Path) será semelhante ao .sympath, mas salvará a digitação.

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

  • 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 anexando _NT_SYMBOL_PATH após _NT_ALT_SYMBOL_PATH. (Normalmente, o caminho é definido através 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ímbolos compartilhados.)

    Observação Se usar a opção de linha de comando -sins, o depurador ignorará a variável de ambiente do caminho de símbolos.

Caminho da imagem executável

Um arquivo executável é um arquivo binário que o processador pode executar. Esses arquivos geralmente têm a extensão de nome de arquivo .exe, .dllou .sys. Os arquivos executáveis também são conhecidos como módulos, especialmente quando os arquivos executáveis são descritos como unidades de um aplicativo maior. Antes de o sistema operacional Windows executar 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.

Observação Estes termos são, por vezes, utilizados de forma imprecisa. Por exemplo, alguns documentos podem usar "imagem" para o arquivo real no disco. Além disso, o kernel do Windows e o HAL têm nomes de módulos 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 ficheiros de despejo de memória pequenos do modo kernel não contêm todos os ficheiros executáveis que existem na memória no momento de um erro de paragem (ou seja, uma falha). Da mesma forma, os arquivos minidump de modo de usuário não contêm os binários do aplicativo. Se você definir o caminho dos arquivos executáveis, o depurador pode encontrar esses arquivos binários.

O caminho da 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 suportados. No entanto, a menos que você sempre inicie o depurador a partir do mesmo diretório, você deve adicionar uma letra de unidade ou um compartilhamento de rede antes de cada caminho. Compartilhamentos de rede também são suportados. O depurador pesquisa o caminho da 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:

  • Last updated on