DetailPage-MSS-KB

Base de Dados de Conhecimento

ID do artigo: 311503 - Última revisão: sábado, 3 de janeiro de 2015 - Revisão: 2.0

 

Nesta página

Sumário

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

Clique no botão Executarpara visualizar a demonstração em fluxo de mídia. Vídeo da MicrosoftObservação:Para visualizar este vídeo, o Windows Media Player 7.0 ou posterior deve ser instalado no seu computador. Para obter informações adicionais, clique no número abaixo para ler o artigo na Base de Conhecimento Microsoft:
299321  (http://support.microsoft.com/kb/299321/EN-US/ ) Descrição e disponibilidade do Windows Media Player 7.1
Quando você depura aplicativos com várias ferramentas da Microsoft, você deve ter informações de símbolo. Os arquivos de símbolo fornecem uma base das funções que estão contidos em arquivos executáveis e bibliotecas de vínculo dinâmico (DLLs). Além disso, os arquivos de símbolo podem apresentar um roteiro das chamadas de função que levar para o ponto de falha. Por exemplo, você deve ter os símbolos quando você despejar pilhas de chamadas dentro de um depurador. Este artigo descreve como usar o Microsoft Symbol Server, especificando a seguinte URL para várias ferramentas de depuração:
http://MSDL.microsoft.com/download/symbols
Observação: http://MSDL.microsoft.com/download/symbols não é navegáveis e é destinada apenas para acesso pelo depurador.

Mais Informações

Usando a tecnologia de servidor de símbolos

O Microsoft Symbol Server é construído usando a tecnologia de SymSrv (SymSrv.dll) que é fornecida com o pacote de ferramentas de depuração para Windows. SymSrv cria um cache local do símbolo para resolução de símbolo rápidas e automáticas.

É tão simple usar o servidor de símbolo conforme é usar a sintaxe apropriada em seu caminho de símbolo. Normalmente, a sintaxe tem o seguinte formato:
SRV *a pasta local do símbolo* http://msdl.microsoft.com/download/symbols
onde a pasta local do símbolo é qualquer unidade ou compartilhamento que é usado como um destino de símbolo.

Por exemplo, para definir o caminho de símbolos no depurador WinDbg, digite o seguinte comando na janela de comando do depurador:
sympath SRV * http://msdl.microsoft.com/download/symbols f:\localsymbols*
Para obter a mais recente funcionalidade de SymSrv, você deve instalar o pacote de depuração mais recentes. Para obter a versão mais recente do pacote Debugging Tools for Windows, visite o seguinte site da Microsoft:
Ferramentas de depuração da Microsoft
http://www.microsoft.com/whdc/devtools/DDK/default.mspx (http://www.microsoft.com/whdc/devtools/ddk/default.mspx)
Para obter mais informações sobre a tecnologia de servidor de símbolos, consulte a Debuggers.chm a Ajuda do arquivo incluído com o pacote de ferramentas de depuração para Windows.

Definir a variável de ambiente NT_SYMBOL_PATH

As ferramentas de depuração comuns do Microsoft usam a tecnologia de SymSrv se você fornecer a sintaxe correta symsrv na variável de ambiente NT_SYMBOL_PATH. Essas ferramentas incluem automaticamente tudo o que você fornecer a variável como o caminho do símbolo.

Você pode definir esta variável como uma variável de sistema ou uma variável de ambiente do usuário. Para fazer isso a partir da área de trabalho, clique em Meu computadore, em seguida, clique em Propriedades. Na guia Avançado , clique em Variáveis de ambiente.

Você também pode definir essa variável temporariamente em um prompt de comando. Dessa forma, todos os aplicativos que iniciar pelo prompt de comando herdam essa configuração. Por exemplo:
Definir NT_SYMBOL_PATH = symsrv*symsrv.dll*f:\localsymbols* http://msdl.microsoft.com/download/symbols

Usando o servidor de símbolos da Microsoft com o WinDbg

Para usar o site da Web do servidor de símbolo de em WinDbg, siga estas etapas:
  1. Inicie o depurador do Windows (WinDbg.exe).
  2. No menu arquivo , clique em Símbolo de caminho do arquivo.
  3. Na caixa caminho de símbolo , digite o seguinte comando:
    SRV *a pasta local para símbolos* http://msdl.microsoft.com/download/symbols
    onde a pasta local para símbolos é a pasta na qual você copia o cache local do símbolo. Os símbolos de depuração são baixados para este local.

    Observação: Você pode apontar para qualquer caminho local ou um compartilhamento que pode chegar a seu computador; ele não precisa ser um local no disco rígido do computador.
Como alternativa, você também pode usar o comando . sympath no prompt de comando para definir o caminho de símbolo.

Você pode combinar a sintaxe symsrv com outros caminhos de símbolo. Por exemplo, use a seguinte sintaxe para especificar dois ou mais caminhos de símbolo:
f:\BusObjSymbols;SRV * http://msdl.microsoft.com/download/symbols f:\localsymbols*
Essa sintaxe separa os caminhos de símbolo com um ponto e vírgula.

Quando começar a depurar um arquivo de despejo de memória ou um aplicativo, o depurador do Windows verifica se as informações de símbolo para um módulo que ele carrega estão na pasta local. Se as informações de símbolo do módulo não for encontradas na pasta local, WinDbg tenta baixar o arquivo de símbolo adequado ou arquivos do servidor de símbolos.

Se você usar o mesmo cache local quando você depurar um aplicativo em um computador que tem diferentes versões do arquivo, símbolos para as diferentes versões são baixados e armazenados com os símbolos primeiro. O formato SymStore armazena arquivos de acordo com o carimbo de hora e o tamanho da imagem (ou soma de verificação). Como resultado, símbolos de versões diferentes do produto podem coexistir lado a lado. (O SymStore.exe é um utilitário do pacote Debugging Tools for Windows gera um servidor de símbolos. Para obter mais informações, consulte a documentação do produto.)

Porque pode levar um tempo para baixar arquivos de símbolo, tenha em mente que o depurador pode parecer parar de responder (travar) na primeira vez que você depurar um aplicativo. Isso ocorre porque a maioria dos arquivos de símbolos para o DLLs (como Ntdll. dll, Kernel32. dll e outros) do sistema deve ser baixada.

Usando o utilitário SymChk.exe para fazer o download de símbolos

Você pode usar o utilitário SymChk.exe para verificar símbolos e criar um cache local do símbolo de maneira conveniente e noninvasive. O utilitário SymChk.exe é incluído com o pacote de ferramentas de depuração para Windows. SymChk.exe é uma ferramenta de linha de comando. Você talvez queira adicionar a pasta do pacote Debugging Tools for Windows para a variável de ambiente PATH do sistema para que você possa acessar essa ferramenta facilmente em qualquer prompt de comando.

Para usar o utilitário SymChk.exe para fazer o download de arquivos de símbolos para todos os componentes na pasta Windows\System32, use o seguinte comando:
Symchk /r c:\windows\system32 /s SRV * http://msdl.microsoft.com/download/symbols c:\symbols\*
Neste exemplo:
  • c:\windows\system32 /r localiza todos os símbolos para os arquivos na pasta System32 e todas as subpastas.
  • /s SRV * http://msdl.microsoft.com/download/symbols c:\symbols* Especifica o caminho de símbolo a ser usado para resolução de símbolo. Nesse 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 de linha de comando para SymChk.exe, digite: Symchk /? no prompt de comando. Outras opções incluem a capacidade de especificar o nome ou o processo de identificação (PID) de um arquivo executável que está sendo executado.

A informação contida neste artigo aplica-se a:
  • Microsoft Visual Studio .NET 2003 Enterprise Architect
  • Microsoft Visual Studio .NET 2003 Enterprise Developer
  • Microsoft Visual Studio .NET 2003 Academic Edition
  • Microsoft Visual Studio .NET 2002 Professional Edition
  • Microsoft Visual Studio .NET 2002 Enterprise Architect
  • Microsoft Visual Studio .NET 2002 Enterprise Developer
  • Microsoft Visual Studio .NET 2002 Academic Edition
Palavras-chave: 
kbfile kbinfo kbsample kbmt KB311503 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido pelo software de tradução automática da Microsoft e eventualmente pode ter sido editado pela Microsoft Community através da tecnologia Community Translation Framework (CTF) ou por um tradutor profissional. A Microsoft oferece artigos traduzidos automaticamente por software, por tradutores profissionais e editados pela comunidade para que você tenha acesso a todos os artigos de nossa Base de Conhecimento em diversos idiomas. No entanto, um artigo traduzido pode conter erros de vocabulário, sintaxe e/ou gramática. A Microsoft não é responsável por qualquer inexatidão, erro ou dano causado por qualquer tradução imprecisa do conteúdo ou por seu uso pelos nossos clientes.
Clique aqui para ver a versão em Inglês deste artigo: 311503  (http://support.microsoft.com/kb/311503/en-us/ )
Compartilhar
Opções de suporte adicionais
Fóruns de Suporte do Microsoft Community
Contate-nos diretamente
Localize um parceiro certificado da Microsoft
Microsoft Store