Armazenamentos de símbolos personalizados e servidores de símbolos

Configurar símbolos corretamente para depuração pode ser uma tarefa desafiadora, particularmente para depuração do kernel. Muitas vezes, requer que você saiba os nomes e versões de todos os produtos no seu computador. O depurador deve ser capaz de localizar cada um dos arquivos de símbolo correspondentes às versões do produto e pacotes de serviço.

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ímbolos, os arquivos de símbolos podem ser reunidos em um armazenamento de símbolos, que é então acessado por um servidor de símbolos.

Um repositório de símbolos é uma coleção de arquivos de símbolos, um índice e uma ferramenta que pode ser usada por um administrador para adicionar e excluir arquivos. Um armazenamento 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 armazenamento 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 armazenamento 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 armazenamento de símbolos, SymStore, e um servidor de símbolos, SymSrv. Ele também inclui uma ferramenta, SymProxy, para configurar um armazenamento de símbolos HTTP em uma rede para servir como um proxy para todos os armazenamentos de símbolos que o depurador pode precisar acessar.

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

Se você deseja 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 a implementação desse servidor de símbolos, consulte Outros servidores de símbolos.

Esta secção inclui:

repositórios de símbolos HTTP

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

Árvore de pastas de armazenamento de símbolos

Outras Lojas de Símbolos

Instalando arquivos de símbolos do Windows

Símbolos offline para o Windows Update

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

Utilitários de símbolos

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