Usando um servidor de símbolos

  • Artigo

Um servidor de símbolos permite que o depurador recupere automaticamente os arquivos de símbolo corretos de um repositório de símbolos – uma coleção indexada de arquivos de símbolo – sem que o usuário precise saber nomes de produtos, versões ou números de build. As Ferramentas de Depuração para Windows incluem o SymSrv do servidor de símbolos de dll necessário. Para obter informações sobre como trabalhar com o servidor de símbolos, consulte Símbolos públicos da Microsoft.

Usando o SymSrv com um depurador

O SymSrv pode ser usado com WinDbg, KD, NTSD ou CDB.

Para usar esse servidor de símbolos com o depurador, basta incluir o texto srv\* no caminho do símbolo. Por exemplo:

set _NT_SYMBOL_PATH = srv*DownstreamStore*SymbolStoreLocation

em que DownstreamStore especifica o diretório local ou o compartilhamento de rede que será usado para armazenar em cache arquivos de símbolo individuais e SymbolStoreLocation é o local do repositório de símbolos no formato \\server\share ou como um endereço da Internet. Para obter mais opções de sintaxe, consulte Uso avançado do SymSrv.

A Microsoft tem um site que disponibiliza publicamente símbolos do Windows. Você pode consultar diretamente este site no caminho do símbolo da seguinte maneira:

set _NT_SYMBOL_PATH=srv*DownstreamStore*https://msdl.microsoft.com/download/symbols

em que, novamente, DownstreamStore especifica o diretório local ou o compartilhamento de rede que será usado para armazenar em cache arquivos de símbolo individuais. Para obter mais informações, consulte Símbolos públicos da Microsoft.

Se você planeja criar um repositório de símbolos, configurar um repositório de símbolos para acesso à Web (HTTP) ou gravar seu próprio servidor de símbolos ou repositório de símbolos, consulte Armazenamentos de Símbolos Personalizados e Servidores de Símbolos.

Usando AgeStore para reduzir o tamanho do cache

Todos os arquivos de símbolo baixados pelo SymSrv permanecerão no disco rígido após o fim da sessão de depuração. Para controlar o tamanho do cache de símbolos, a ferramenta AgeStore pode ser usada para excluir arquivos armazenados em cache mais antigos do que uma data especificada ou para reduzir o conteúdo do cache abaixo de um tamanho especificado. Para obter detalhes, consulte AgeStore.