Magasins de symboles personnalisés et serveurs de symboles

La configuration correcte des symboles pour le débogage peut s’avérer difficile, en particulier pour le débogage du noyau. Il vous faut souvent mémoriser les noms et versions de tous les produits sur votre ordinateur. Le débogueur doit être en mesure de localiser chacun des fichiers de symboles correspondant aux versions de produits et aux Service Packs.

Cela peut entraîner un chemin de symbole extrêmement long, constitué d’une longue liste de répertoires. Pour simplifier ces difficultés de coordination des fichiers de symboles, les fichiers de symboles peuvent être regroupés dans un magasin de symboles, qui est ensuite accessible par un serveur de symboles.

Un magasin de symboles est une collection de fichiers de symboles, un index et un outil qui peut être utilisé par un administrateur pour ajouter et supprimer des fichiers. Un magasin de symboles peut également contenir des fichiers image exécutables.

Les fichiers sont indexés en fonction de paramètres uniques tels que l’horodatage et la taille de l’image. Un magasin de symboles peut également contenir des fichiers image exécutables qui peuvent être extraits à l’aide d’un serveur de symboles. Outils de débogage pour Windows contient un outil de création de magasin de symboles appelé SymStore.

Le débogueur accède aux fichiers d’un magasin de symboles à l’aide d’un serveur de symboles. Les outils de débogage pour Windows incluent à la fois un outil de création de magasin de symboles, SymStore, et un serveur de symboles, SymSrv. Il comprend également un outil, SymProxy, pour configurer un magasin de symboles HTTP sur un réseau afin de servir de proxy pour tous les magasins de symboles auxquels le débogueur peut avoir besoin d’accéder.

Un serveur de symboles permet aux débogueurs de récupérer automatiquement les fichiers de symboles corrects à partir d’un magasin de symboles sans que l’utilisateur n’a besoin de connaître les noms de produits, les versions ou les numéros de build. Les outils de débogage pour Windows contiennent un serveur de symboles appelé SymSrv. Le serveur de symboles est activé en incluant une certaine chaîne de texte dans le chemin des symboles. Chaque fois que le débogueur doit charger des symboles pour un module nouvellement chargé, il appelle le serveur de symboles afin de localiser les fichiers de symboles appropriés. Pour plus d’informations sur l’utilisation du serveur de symboles, consultez Symboles publics Microsoft.

Si vous souhaitez utiliser une autre méthode pour votre recherche de symboles que celle fournie par SymSrv, il est possible de développer votre propre DLL de serveur de symboles. Pour plus d’informations sur l’implémentation d’un tel serveur de symboles, consultez Autres serveurs de symboles.

Cette section comprend :

Magasins de symboles HTTP

Serveur de symboles de débogueur de partage de fichiers (SMB)

Arborescence des dossiers du magasin de symboles

Autres magasins de symboles

Installation de fichiers de symboles Windows

Symboles hors connexion pour Windows Update

Si vous ne configurez pas votre propre magasin de symboles, mais que vous envisagez simplement d’utiliser le magasin de symboles Microsoft public public, consultez Symboles publics Microsoft.

Utilitaires de symboles

Les utilitaires suivants permettent la distribution et le contrôle des symboles dans des projets de développement logiciel plus volumineux.

Utilitaire	Description
SymProxy	Permet de configurer votre magasin de symboles http afin qu’il agisse en tant que proxy entre les ordinateurs clients et d’autres magasins de symboles.
SymStore	SymStore (symstore.exe) est un outil permettant de créer des magasins de symboles.
AgeStore	L’outil AgeStore (agestore.exe) supprime les fichiers d’un répertoire ou d’une arborescence de répertoires, en fonction de leurs dates de dernier accès.
DBH	L’outil DBH (dbh.exe) est un outil en ligne de commande qui affiche des informations sur le contenu d’un fichier de symboles.
PDBCopy	L’outil PDBCopy (pdbcopy.exe) est un outil en ligne de commande qui supprime les informations de symbole privé d’un fichier de symboles.
SymChk	SymChk (outil Microsoft Symbol Checker), Symchk.exe, est un programme qui compare les fichiers exécutables aux fichiers de symboles.