Utilize o Microsoft Symbol Server para obter os ficheiros de símbolos de depuração

Este artigo descreve como o Microsoft Symbol Server para obter as informações de depuração de símbolo de referência.

Faça clique sobre oReproduzirbotão para ver esta transmissão em sequência de multimédia demonstração.NotaPara ver este vídeo, o Windows Media Player 7. 0 ou posterior deve estar instalado no computador.Para obter informações adicionais, clique no número de artigo existente abaixo para visualizar o artigo na Microsoft Knowledge Base:Tem de ter informações do símbolo quando depura aplicações com várias ferramentas da Microsoft. Símbolo de ficheiros fornece um footprint das funções que estão contidos em ficheiros executáveis e de bibliotecas de ligação dinâmica (DLL). Além disso, os ficheiros de símbolos podem apresentar um plano de chamadas de função que levar até ao ponto de falha. Por exemplo, tem de ter os símbolos quando copiar pilhas de chamadas dentro de um depurador. Este artigo descreve como utilizar o Microsoft Symbol Server especificando o seguinte URL para várias ferramentas de depuração:Notahttp://MSDL.microsoft.com/download/symbols não é browseable e só está destinada para acesso pelo depurador.

Utilizando a tecnologia de símbolo

A Microsoft Symbol Server é criado utilizando a tecnologia de SymSrv (SymSrv.dll) que é fornecida com o pacote de ferramentas de depuração para o Windows. SymSrv cria uma cache local símbolo para resolução de símbolo rápida e automática.

É mais simples utilizar Symbol Server como está a utilizar a sintaxe adequada no seu caminho de símbolos. Normalmente, a sintaxe tem o seguinte formato:em quea pasta local símboloé qualquer unidade ou partilha em que é utilizada como um destino de símbolo.

Por exemplo, para definir o caminho de símbolos no depurador WinDbg, escreva o seguinte comando na janela de comandos do depurador:Para obter as mais recentes funcionalidades de SymSrv, tem de instalar o pacote de depuração mais recentes. Para obter a versão mais recente do pacote Debugging Tools for Windows, visite o seguinte Web site da Microsoft:Para mais informações sobre a tecnologia Symbol Server, consulte o Debuggers.chm ajudar o ficheiro incluído com o pacote de ferramentas de depuração para o Windows.

Definir a variável de ambiente _ NT_SYMBOL_PATH

As ferramentas de depuração do Microsoft comuns utilizam a tecnologia de SymSrv se fornecer o correctosymsrvsintaxe na variável de ambiente _ NT_SYMBOL_PATH. Estas ferramentas incluem automaticamente qualquer que seja fornecido na variável como o caminho de símbolos.

Pode definir esta variável como uma variável de sistema ou como uma variável de ambiente do utilizador. Para o fazer no ambiente de trabalho, clique emO meu computadore, em seguida, clique emPropriedades. Sobre oAvançadasseparador, clique emVariáveis de ambiente.

Também pode definir esta variável temporariamente na linha de comandos. Desta forma, todas as aplicações que são iniciados através de comandos herdam esta definição. Por exemplo:

Utilizando o Microsoft Symbol Server com WinDbg

Para utilizar o site de Web Server de símbolo a partir WinDbg, siga estes passos:

1. Inicie o depurador do Windows (WinDbg.exe).
2. Sobre oFicheiromenu, clique emCaminho do ficheiro de símbolo.
3. NaCaminho de símbolosEscreva o seguinte comando:
   SRV *a pasta local para símbolos*http://MSDL.microsoft.com/download/symbols
   em quea pasta local para símbolosé a pasta na qual copiar a cache local do símbolo. Os símbolos de depuração são transferidos para esta localização.
   
   NotaPode apontar para qualquer caminho local ou partilhar a que o computador possa alcançar; não tem de ser uma localização no disco rígido do computador.

Em alternativa, também pode utilizar o.sympathcomando numa linha de comandos para definir o caminho de símbolos.

É possível combinar osymsrvsintaxe com outros caminhos de símbolo. Por exemplo, utilize a seguinte sintaxe para especificar duas ou mais caminhos de símbolo:Esta sintaxe separa os caminhos de símbolo com um ponto e vírgula.

Quando começar a depurar um ficheiro de informação de falha de sistema ou uma aplicação, o depurador do Windows verifica se as informações do símbolo para um módulo que carrega são na pasta local. Se as informações de símbolo do módulo não estão localizadas na pasta local, WinDbg tenta transferir o símbolo adequado ficheiro ou ficheiros do servidor de símbolo.

Se utilizar a cache local mesma quando depurar uma aplicação num computador que tem as versões de ficheiro diferente, símbolos para as diferentes versões são transferidos e armazenados com os símbolos primeiros. O formato SymStore armazena ficheiros de acordo com a marca de hora e o tamanho da imagem (ou soma de verificação). Como resultado, os símbolos a partir de versões de produto diferente podem coexistir lado a lado. (SymStore.exe é um utilitário do pacote de ferramentas de depuração para o Windows que gera um servidor de símbolos. Para mais informações, consulte a documentação do produto.)

Uma vez que poderá demorar tempo a transferir ficheiros de símbolos, tenha em atenção que o depurador pode parecer deixar de responder (bloquear) da primeira vez que depurar uma aplicação. Isto ocorre porque a maior parte dos ficheiros de símbolos para o dll (tais como Ntdll. dll, Kernel32. dll e outros) de sistema tem de ser transferido.

Utilizar o utilitário SymChk.exe para transferir símbolos

Pode utilizar o utilitário SymChk.exe para verificar símbolos e para criar uma cache local do símbolo de forma conveniente e noninvasive. O utilitário SymChk.exe é incluído com o pacote de ferramentas de depuração para o Windows. SymChk.exe é uma ferramenta da linha de comandos. Poderá adicionar a pasta do pacote Debugging Tools for Windows a variável de ambiente PATH do sistema, para que possa aceder esta ferramenta facilmente qualquer linha de comandos.

Para utilizar o utilitário SymChk.exe para transferir ficheiros de todos os componentes na pasta Windows\System32 símbolos, utilize o seguinte comando da linha de comandos:Neste exemplo:

• /r c:\windows\system32Localiza todos os símbolos para ficheiros na pasta System32 e todas as subpastas.
• /s SRV*c:\symbols*http://msdl.microsoft.com/download/symbolsEspecifica o caminho do símbolo a utilizar para a resolução de símbolo. Neste caso,c:\Symbolsé a pasta local onde os símbolos serão copiados do servidor de símbolos.

Para obter mais informações sobre as opções da linha de comandos para SymChk.exe, escrevaSymchk /?numa linha de comandos. Outras opções incluem a capacidade para especificar o nome ou o ID de processo (PID) de um ficheiro executável que está a ser executado.