Repositórios de símbolos personalizados e servidores de símbolos

Configurar símbolos corretamente para depuração pode ser uma tarefa desafiadora, especialmente para depuração de kernel. Geralmente, exige que você saiba os nomes e versões de todos os produtos em seu computador. O depurador deve ser capaz de localizar cada um dos arquivos de símbolo correspondentes às versões do produto e aos service packs.

Isso pode resultar em um caminho de símbolo extremamente longo que consiste em uma longa lista de diretórios. Para simplificar essas dificuldades na coordenação de arquivos de símbolo, os arquivos de símbolo podem ser coletados em um repositório de símbolos, que é acessado por um servidor de símbolos.

Um repositório de símbolos é uma coleção de arquivos de símbolo, um índice e uma ferramenta que pode ser usada por um administrador para adicionar e excluir arquivos. Um repositório de símbolos também pode conter arquivos de imagem executáveis.

Os arquivos são indexados de acordo com parâmetros exclusivos, como o carimbo de data/hora e o tamanho da imagem. Um repositório de símbolos também pode conter arquivos de imagem executáveis que podem ser extraídos usando um servidor de símbolos. As Ferramentas de Depuração para Windows contêm uma ferramenta de criação de repositório de símbolos chamada SymStore.

O depurador acessa os arquivos em um repositório de símbolos usando um servidor de símbolos. As Ferramentas de Depuração para Windows incluem uma ferramenta de criação de repositório de símbolos, o SymStore e um servidor de símbolos, o SymSrv. Ele também inclui uma ferramenta, SymProxy, para configurar um repositório de símbolos HTTP em uma rede para servir como um proxy para todos os repositórios de símbolos que o depurador pode precisar acessar.

Um servidor de símbolos permite que os depuradores recuperem automaticamente os arquivos de símbolo corretos de um repositório de símbolos sem que o usuário precise saber nomes de produtos, versões ou números de build. As Ferramentas de Depuração para Windows contêm um servidor de símbolos chamado SymSrv. O servidor de símbolos é ativado por meio da inclusão de uma determinada cadeia de caracteres de texto no caminho do símbolo. Sempre que o depurador precisar carregar símbolos para um módulo recém-carregado, ele chama o servidor de símbolos para localizar os arquivos de símbolo apropriados. Para obter informações sobre como trabalhar com o servidor de símbolos, consulte Símbolos públicos da Microsoft.

Se você quiser usar um método diferente para sua pesquisa de símbolos do que o fornecido pelo SymSrv, é possível desenvolver sua própria DLL de servidor de símbolos. Para obter detalhes sobre como implementar esse servidor de símbolos, consulte Outros servidores de símbolos.

Esta seção inclui:

Repositórios de símbolos HTTP

Servidor de Símbolos do Depurador de Compartilhamento de Arquivos (SMB)

Árvore de Pastas do Repositório de Símbolos

Outros repositórios de símbolos

Instalando arquivos de símbolo do Windows

Símbolos offline para Windows Update

Se você não estiver configurando seu próprio repositório de símbolos, mas apenas pretende usar o repositório de símbolos público da Microsoft, consulte Símbolos Públicos da Microsoft.

Utilitários de símbolo

Os utilitários a seguir permitem a distribuição e o controle de símbolos em projetos de desenvolvimento de software maiores.

Utilitário	Descrição
SymProxy	Use para configurar seu repositório de símbolos baseado em HTTP para atuar como um proxy entre computadores cliente e outros repositórios de símbolos.
SymStore	O SymStore (symstore.exe) é uma ferramenta para criar repositórios de símbolos.
AgeStore	A ferramenta AgeStore (agestore.exe) exclui arquivos em um diretório ou árvore de diretório, com base em suas datas de último acesso.
DAP	A ferramenta DBH (dbh.exe) é uma ferramenta de linha de comando que exibe informações sobre o conteúdo de um arquivo de símbolo.
PDBCopy	A ferramenta PDBCopy (pdbcopy.exe) é uma ferramenta de linha de comando que remove informações de símbolo privado de um arquivo de símbolo.
SymChk	O SymChk (a ferramenta Verificador de Símbolos da Microsoft), Symchk.exe, é um programa que compara arquivos executáveis com arquivos de símbolo.