Use o Microsoft Symbol Server para obter arquivos de símbolos de depuração

Traduções deste artigo Traduções deste artigo
ID do artigo: 311503 - Exibir os produtos aos quais esse artigo se aplica.
Expandir tudo | Recolher tudo

Neste artigo

Sumário

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

Clique noJogarbotão para ver a demonstração em fluxo contínuo de mídia.Observação:Para visualizar este vídeo, o Windows Media Player 7. 0 ou posterior deve estar instalado no seu computador.Para obter informações adicionais, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
299321Descrição e disponibilidade do Windows Media Player 7. 1
Quando você depura aplicativos com várias ferramentas da Microsoft, você deve ter as informações do 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 de 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 URL a seguir 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 o acesso pelo depurador.

Mais Informações

Usando a tecnologia de servidor de símbolos

O Microsoft Symbol Server baseia-se usando a tecnologia de SymSrv (SymSrv.dll) é fornecida com o pacote de ferramentas de depuração para Windows. SymSrv constrói um cache local do símbolo para a resolução de símbolo rápido e automático.

É mais simples usar o servidor de símbolos, como é usar a sintaxe adequada em seu caminho de símbolo. Normalmente, a sintaxe assume o formato a seguir:
SRV *a pasta local do símbolo*http://MSDL.microsoft.com/download/Symbols
ondea pasta local do símboloé qualquer unidade ou compartilhamento que está sendo usado como um símbolo de destino.

Por exemplo, para definir o caminho de símbolo no depurador WinDbg, digite o seguinte comando na janela de comando do depurador:
.sympath SRV*f:\localsymbols*http://msdl.microsoft.com/download/symbols
Para obter a funcionalidade de SymSrv mais recente, você deve instalar o pacote mais recente de depuração. Para obter a versão mais recente do pacote de ferramentas de depuração para Windows, visite o seguinte site da Microsoft:
Ferramentas de depuração da Microsoft
http://www.microsoft.com/whdc/devtools/DDK/default.mspx
For more information about the Symbol Server technology, see the Debuggers.chm help file that is included with the Debugging Tools for Windows package.

Setting the _NT_SYMBOL_PATH environment variable

The common Microsoft debugging tools use the SymSrv technology if you provide the correctsymsrvsyntax in the _NT_SYMBOL_PATH environment variable. These tools automatically include whatever you provide in the variable as the symbol path.

You can set this variable as a system variable or as a user environment variable. To do this from the desktop, right-clickMeu computadore, em seguida, clique emPropriedades. Sobre oAvançadoClique emEnvironment Variables.

You can also set this variable temporarily at a command prompt. In this way, all applications that you start through the command prompt inherit this setting. For example:
Set _NT_SYMBOL_PATH = symsrv*symsrv.dll*f:\localsymbols*http://msdl.microsoft.com/download/symbols

Using the Microsoft Symbol Server with WinDbg

To use the Symbol Server Web site from within WinDbg, follow these steps:
  1. Start the Windows Debugger (WinDbg.exe).
  2. Sobre oArquivomenu, clique emSymbol File Path.
  3. NaSymbol pathbox, type the following command:
    SRV*your local folder for symbols*http://msdl.microsoft.com/download/symbols
    whereyour local folder for symbolsis the folder in which you copy your local symbol cache. The debug symbols are downloaded to this location.

    Observação:You can point to any local path or share that your computer can reach; it does not have to be a location on the computer's hard disk.
Alternatively, you can also use the.sympathcommand at a command prompt to set the symbol path.

You can combine thesymsrvsyntax with other symbol paths. For example, use the following syntax to specify two or more symbol paths:
f:\BusObjSymbols;SRV*f:\localsymbols*http://msdl.microsoft.com/download/symbols
This syntax separates the symbol paths with a semicolon.

When you start to debug a crash dump file or an application, the Windows Debugger checks whether the symbol information for a module that it loads is in the local folder. If the symbol information of the module is not located in the local folder, WinDbg tries to download the appropriate symbol file or files from the Symbol Server.

If you use the same local cache when you debug an application on a computer that has different file versions, symbols for the different versions are downloaded and stored with the first symbols. The SymStore format stores files according to the time stamp and the size of the image (or checksum). As a result, symbols from different product versions can coexist side by side. (SymStore.exe is a utility from the Debugging Tools for Windows package that generates a symbol server. For more information, see the product documentation.)

Because it may take time to download symbol files, keep in mind that the debugger may appear to stop responding (hang) the first time that you debug an application. This occurs because most of the symbol files for the system DLLs (such as Ntdll.dll, Kernel32.dll, and others) must be downloaded.

Using the SymChk.exe utility to download symbols

You can use the SymChk.exe utility to verify symbols and to build a local symbol cache in a convenient, noninvasive way. The SymChk.exe utility is included with the Debugging Tools for Windows package. SymChk.exe is a command-line tool. You may want to add the folder of the Debugging Tools for Windows package to the PATH environment variable on your system so that you can access this tool easily from any command prompt.

To use the SymChk.exe utility to download symbol files for all of the components in the Windows\System32 folder, use the following command-line command:
symchk /r c:\windows\system32 /s SRV*c:\symbols\*http://msdl.microsoft.com/download/symbols
In this example:
  • /r c:\windows\system32finds all symbols for files in the System32 folder and any subfolders.
  • /s SRV*c:\symbols*http://msdl.microsoft.com/download/symbolsspecifies the symbol path to use for symbol resolution. In this case,c:\symbolsis the local folder where the symbols will be copied from the symbol server.
To obtain more information about the command-line options for SymChk.exe, typesymchk /?at a command prompt. Other options include the ability to specify the name or the process ID (PID) of an executable file that is running.

Propriedades

ID do artigo: 311503 - Última revisão: quinta-feira, 2 de dezembro de 2010 - Revisão: 0.1
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ática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 311503

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com