Definindo símbolos e caminhos de imagem executáveis em KD

  • 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* no caminho do símbolo. Para obter mais informações sobre como acessar servidores de símbolos, consulte Caminho do símbolo para o depurador do Windows.

Para controlar o caminho do símbolo em KD, 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 . Confira Opções de Command-Line KD.

  • 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, talvez você queira 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 do caminho do símbolo.

Caminho da imagem executável

Um arquivo executável é um arquivo binário que o processador pode executar. Esses arquivos normalmente 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 imprecisamente. Por exemplo, alguns documentos podem usar "image" para o arquivo real no disco. Além disso, os aplicativos baseados no Windows referem-se ao nome executável, que normalmente inclui a extensão de nome de arquivo. Mas esses aplicativos se referem ao nome do módulo, que não inclui a extensão de nome de arquivo. 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, 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 minidespejo 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 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 compatíveis. No entanto, a menos que você sempre inicie o depurador do mesmo diretório, você deve adicionar uma letra da unidade ou um compartilhamento de rede antes de cada caminho. Também há suporte para compartilhamentos de rede. 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 em KD, siga um destes procedimentos: