Spécifiez les fichiers de symbole (.pdb) et les fichiers source dans le débogueur Visual Studio.

Rechercher et spécifier des fichiers de symboles et des fichiers sources ; spécifier le comportement de chargement des symboles, utiliser des serveurs de symboles et sources ; charger des symboles automatiquement ou à la demande.

Sommaire

Find symbol (.pdb) files

Find source files

Rechercher les fichiers de symboles (.pdb)

• Where the debugger searches for .pdb files | Why do symbol files need to exactly match the executable files? | Specify symbol locations and loading behavior | Use symbol servers to find symbol files not on your local machine | Find and load symbols while debugging | Set compiler options for symbol files

Un fichier de base de données du programme (.pdb), également appelé fichier de symboles, mappe les identificateurs que vous créez dans les fichiers sources pour les classes, méthodes et autre code aux identificateurs utilisés dans les fichiers exécutables compilés de votre projet. Le fichier .pdb mappe également les instructions du code source aux instructions d'exécution des fichiers exécutables. Le débogueur utilise ces informations pour déterminer deux informations essentielles : le fichier source et le numéro de ligne qui s'affichent dans l'IDE de Visual Studio et l'emplacement où s'arrêter dans le fichier exécutable lorsque vous définissez un point d'arrêt. Un fichier de symboles contient également l'emplacement d'origine des fichiers sources, et éventuellement, l'emplacement d'un serveur source d'où les fichiers sources peuvent être extraits.

Lorsque vous déboguez un projet dans l'IDE de Visual Studio, le débogueur sait précisément où rechercher les fichiers .pdb et source de votre code. Si vous souhaitez déboguer du code en dehors du code source de votre projet, tel que le code Windows ou tiers appelé par votre projet, vous devez spécifier l'emplacement du fichier .pdb (et éventuellement, des fichiers sources du code externe) et ces fichiers doivent correspondre exactement à la build des fichiers exécutables.

Où le débogueur recherche les fichiers .pdb

1. Emplacement spécifié à l'intérieur de la DLL ou du fichier exécutable.

   (Par défaut, si vous avez développé une DLL ou un fichier exécutable sur votre ordinateur, l'éditeur de liens place le chemin d'accès complet et le nom du fichier .pdb associé à l'intérieur de la DLL ou du fichier exécutable. Le débogueur vérifie d'abord si le fichier de symboles existe dans l'emplacement spécifié dans la DLL ou le fichier exécutable. Cela est utile, car vous avez toujours des symboles disponibles pour le code que vous avez compilé sur votre ordinateur.)

2. fichiers .pdb qui peuvent être présents dans le même dossier que la DLL ou le fichier exécutable.

3. Tout dossier de cache de symboles local.

4. Tout serveur de symboles réseau, internet ou local et tout emplacement sur lequel il sont spécifiés, comme le serveur de symboles Microsoft s'il est activé.

Find symbol (.pdb) files

Contents

Pourquoi les fichiers de symboles doivent-ils correspondre exactement aux fichiers exécutables ?

Le débogueur chargera uniquement un fichier .pdb pour un fichier exécutable qui correspond exactement au fichier .pdb créé lors de la génération du fichier exécutable (autrement dit, le fichier .pdb doit être le fichier d'origine ou une copie du fichier .pdb d'origine). Étant donné que le compilateur est optimisé pour la vitesse de compilation en plus de sa tâche principale qui consiste à créer du code correct et efficace, la disposition effective d'un fichier exécutable peut changer même si le code lui-même n'a pas changé. Pour plus d'informations, consultez l'entrée de blog MSDN Why does Visual Studio require debugger symbol files to *exactly* match the binary files that they were built with?

Find symbol (.pdb) files

Contents

Spécifier les emplacements de symboles et le comportement de chargement

Lorsque vous déboguez un projet dans l'IDE de Visual Studio, le débogueur charge automatiquement les fichiers de symboles situés dans le répertoire du projet. Vous pouvez spécifier d'autres chemins de recherche et serveurs de symboles pour Microsoft, Windows ou composants tiers dans la page Débogage/Symboles de la boîte de dialogue Options de Visual Studio. Dans la page Symboles, vous pouvez également spécifier des modules spécifiques pour lesquels vous souhaitez que le débogueur charge automatiquement des symboles. Et vous pouvez ensuite modifier ces paramètres manuellement lorsque vous déboguez activement.

Pour ouvrir la page Débogage/Symboles

1. Dans le menu Déboguer, choisissez Options.

2. Dans la boîte de dialogue Options, choisissez Symboles sous le nœud Débogage.

Spécifier un emplacement de serveur de symboles ou de recherche

1. Choisissez l'icône de dossier . Le texte modifiable s'affiche dans la zone Emplacements du fichier de symboles (.pdb).

2. Tapez l'URL ou le chemin d'accès du serveur de symboles ou de l'emplacement de symboles. La saisie semi-automatique des instructions vous aide à rechercher le format correct.

3. Pour améliorer les performances de chargement de symboles, tapez le chemin d'accès d'un répertoire local dans lequel les symboles peuvent être copiés par les serveurs de symboles dans la zone Mettre en cache les symboles dans ce répertoire d'un répertoire local dans lequel les symboles peuvent être copiés.

   Notes

   Ne placez pas votre cache de symboles dans un dossier protégé (tel que le dossier C:\Windows ou un de ses sous-dossiers).Utilisez plutôt un dossier en lecture-écriture.

Spécifier le comportement de chargement des symboles

Vous pouvez spécifier les fichiers qui doivent être chargés automatiquement à partir des emplacements de zone Emplacements du fichier de symboles (.pdb) lorsque vous commencez le débogage. Les fichiers de symboles contenus dans le répertoire du projet sont toujours chargés.

1. Sélectionnez Tous les modules, sauf exclus pour charger tous les symboles pour tous les modules à l'exception de ceux que vous spécifiez lorsque vous choisissez le lien Spécifier les modules exclus.

2. Choisissez l'option Modules spécifiés uniquement puis choisissez Spécifier les modules pour répertorier les modules des fichiers de symboles que vous voulez charger automatiquement. Les fichiers de symboles d'autres modules sont ignorés.

Spécifier des options de symbole supplémentaires

Vous pouvez également définir l'option suivante sur la page Débogage / Général de la boîte de dialogue Options Visual Studio :

Avertir s'il n'y a aucun symbole au lancement (natif uniquement)

Lorsqu'elle est sélectionnée, cette option affiche une boîte de dialogue d'avertissement quand vous essayez de déboguer un programme pour lequel le débogueur ne possède aucune information symbolique.

Charger les exportations de DLL

Lorsqu'elle est sélectionnée, cette option charge les tables d'exportation de DLL. Les informations symboliques de tables d'exportation de DLL peuvent être utiles si vous utilisez des messages Windows, des procédures Windows (WindowProcs), des objets COM, le marshaling ou toute DLL pour laquelle vous n'avez pas de symbole. La lecture des informations d'exportation des DLL implique une certaine charge mémoire. Par conséquent, cette fonctionnalité est désactivée par défaut.

Pour savoir quels symboles sont disponibles dans la table d'exportation d'une DLL, utilisez dumpbin /exports. Il existe des symboles pour toutes les DLL système 32 bits. En lisant le résultat de dumpbin /exports, vous apprenez le nom exact de la fonction, y compris les caractères non alphanumériques. Cette information peut être utile pour définir un point d'arrêt sur une fonction. Les noms de fonctions provenant de tables d'exportation de DLL peuvent s'afficher sous une forme tronquée dans les autres parties du débogueur. Les appels sont répertoriés dans l'ordre chronologique inverse, la fonction en cours (la plus profondément imbriquée) apparaissant en tête de liste. Pour plus d'informations, consultez dumpbin /exports.

Contents | Find symbol (.pdb) files

Utiliser des serveurs de symboles pour rechercher des fichiers de symboles qui ne sont pas sur votre ordinateur local

Visual Studio peut télécharger les fichiers de symboles de débogage à partir des serveurs de symboles qui implémentent le protocole symsrv. Visual Studio Team Foundation Server et les outils de débogage pour Windows sont deux outils qui peuvent implémenter des serveurs de symboles. Vous spécifiez les serveurs de symboles à utiliser dans la boîte de dialogue Options de Visual Studio.

Les serveurs de symboles que vous pouvez utiliser sont les suivants :

Serveurs de symboles publics Microsoft

Pour déboguer un incident survenu durant un appel à une DLL système ou une bibliothèque tierce, vous devrez souvent utiliser des fichiers .pdb système, qui contiennent les symboles des fichiers DLL, EXE et pilotes de périphériques de Windows. Vous pouvez obtenir ces symboles auprès des serveurs de symboles publics Microsoft. Les serveurs de symboles publics Microsoft fournissent des symboles pour les systèmes d'exploitation Windows, en plus de MDAC, d'IIS, d'ISA et du .NET Framework.

Pour utiliser les serveurs de symboles Microsoft, choisissez Options et paramètres dans le menu Déboguer, puis choisissez Symboles. Sélectionnez Serveurs de symboles Microsoft.

Serveurs de symboles sur un réseau interne ou sur votre ordinateur local

Votre équipe ou société peut créer les serveurs de symboles de vos propres produits et comme cache des symboles à partir des sources externes. Vous pouvez avoir un serveur de symboles sur votre propre ordinateur. Vous pouvez entrer l'emplacement des serveurs de symboles en tant qu'URL ou comme chemin sur la page Débogage/Symboles de la boîte de dialogue Options de Visual Studio.

Serveurs de symboles tiers

Les fournisseurs tiers des applications et des bibliothèques Windows peuvent donner accès au serveur de symboles sur Internet. Vous entrez également l'URL de ces serveurs de symboles sur la page Débogage/Symboles,

Contents | Find symbol (.pdb) files

Rechercher et charger des symboles pendant le débogage

Lorsque le débogueur est en mode arrêt, vous pouvez charger des symboles pour un module qui a été précédemment exclu par les options du débogueur ou que le compilateur n'a pas pu trouver. Vous pouvez charger les symboles à partir des menus contextuels des fenêtres Pile des appels, Modules, Variables locales, Automatique et Espion. Si le débogueur s'arrête dans du code qui ne contient pas de fichiers sources ou de symboles disponibles, une fenêtre de document s'affiche. Vous trouverez des informations sur les fichiers manquants et pourrez prendre des mesures pour les localiser et les charger.

Rechercher des symboles à l'aide des pages de document Aucun symbole n'a été chargé

Il existe plusieurs moyens pour que le débogueur se divise en code n'ayant pas de symboles disponibles :

1. Codage en mode pas à pas détaillé.

2. Arrêt dans le code depuis un point d'arrêt ou une exception.

3. Passage à un autre thread.

4. Modification du frame de pile en double-cliquant sur un frame dans la fenêtre Pile des appels.

Lorsqu'un de ces événements se produit, le débogueur affiche la page Aucun symbole n'a été chargé pour vous aider à identifier et à charger les symboles nécessaires.

• Pour modifier les chemins de recherche, choisissez un chemin d'accès non sélectionné ou choisissez Nouveau et entrez un nouveau chemin d'accès. Sélectionnez Charger pour rechercher à nouveau les chemins d'accès et charger le fichier de symboles s'il est trouvé.

• Choisissez Parcourir et rechercher executable-name ... pour remplacer toutes les options de symbole et réessayer les chemins de recherche. Le fichier de symboles est chargé s'il est trouvé, ou un Explorateur de fichiers s'affiche pour sélectionner manuellement le fichier de symboles.

• Sélectionnez Modifier les paramètres des symboles ... pour afficher la page Débogage / Symboles de la boîte de dialogue Options de VS.

• Choisissez afficher le code machine pour afficher le code machine dans une nouvelle fenêtre.

• Pour toujours afficher le code machine lorsque la source ou les fichiers de symboles sont introuvables, choisissez le lien Boîte de dialogue Options, puis sélectionnez Activer le débogage au niveau de l'adresse et Afficher le code machine si la source n'est pas disponible.

  

Changer les options de symbole depuis le menu contextuel

Lorsque vous êtes en mode arrêt, vous pouvez rechercher et charger les symboles des éléments affichés dans les fenêtres Pile des appels, Modules, Variables locales, Automatique et Espion. Sélectionnez un élément dans la fenêtre, ouvrez le menu contextuel, puis sélectionnez l'une des options suivantes :

Contents | Find symbol (.pdb) files

Définir des options du compilateur pour les fichiers de symboles

Lorsque vous générez votre projet à partir du VS IDE et utilisez la configuration de build Debug standard, C++ et les compilateurs managés créent les fichiers de symboles appropriés pour votre code. Vous pouvez aussi définir les options du compilateur sur la ligne de commande pour créer les fichiers de symboles.

Options C++

Un fichier .pdb (base de données du programme) contient des informations sur l'état du projet et le débogage, qui permettent l'édition des liens incrémentielle pour la configuration Debug de votre programme. Un fichier .pdb est créé lors de la génération à l'aide de /ZI ou /Zi (pour C/C++).

Dans Visual C++, l'option /Fd permet de nommer le fichier .pdb créé par le compilateur. Lorsque vous créez un projet dans Visual Studio à l'aide des Assistants, l'option /Fd est définie pour créer un fichier .pdb nommé projet.pdb.

Si vous générez votre application C/C++ à l'aide d'un makefile, et que vous spécifiez /ZI ou /Zi sans /Fd, vous obtenez finalement deux fichiers .pdb :

• VCx.pdb, où x représente la version de Visual C++, par exemple VC11.pdb. Ce fichier stocke toutes les informations de débogage concernant les fichiers OBJ individuels et réside dans le même répertoire que le makefile du projet.

• project.pdb   Ce fichier stocke toutes les informations de débogage concernant le fichier .exe. Pour C/C++, il réside dans le sous-répertoire \debug.

Chaque fois qu'il crée un fichier OBJ, le compilateur C/C++ fusionne les informations de débogage dans VCx.pdb. Celles-ci se composent d'informations de type, mais pas d'informations de symbole telles que les définitions de fonctions. Par conséquent, même si chaque fichier source inclut des fichiers d'en-tête courants tels que <windows.h>, les typedefs de ces en-têtes ne sont stockés qu'une seule fois, au lieu de l'être pour chaque fichier OBJ.

L'Éditeur de liens crée projet.pdb, qui contient les informations de débogage concernant le fichier EXE du projet. Le fichier projet.pdb contient toutes les informations de débogage, y compris les prototypes de fonction et pas seulement les informations de type présentes dans VCx.pdb. Les deux fichiers .pdb autorisent les mises à jour incrémentielles. L'Éditeur de liens incorpore également le chemin d'accès au fichier .pdb dans le fichier .exe ou .dll qu'il crée.

Le débogueur Visual Studio utilise le chemin d'accès au fichier .pdb dans le fichier EXE ou DLL pour rechercher le fichier project.pdb. Si le débogueur ne peut pas trouver le fichier .pdb à cet emplacement ou que le chemin d'accès n'est pas valide (par exemple, lorsque le projet a été déplacé sur un autre ordinateur), le débogueur recherche le chemin d'accès contenant le fichier EXE, les chemins d'accès aux symboles spécifiés dans la boîte de dialogue Options (dossier Débogage, nœud Symboles). Le débogueur ne chargera pas un fichier .pdb qui ne correspond pas au fichier exécutable débogué. Si le débogueur ne trouve aucun fichier .pdb, la boîte de dialogue Rechercher des symboles qui s'affiche vous permet de rechercher des symboles ou d'ajouter des emplacements supplémentaires au chemin de recherche.

Options du .NET Framework

Un fichier .pdb (base de données du programme) contient des informations sur l'état du projet et le débogage, qui permettent l'édition des liens incrémentielle pour la configuration Debug de votre programme. Un fichier .pdb est créé lorsque vous générez avec /debug. Vous pouvez générer des applications avec /debug:full ou /debug:pdbonly. La génération avec /debug:full donne lieu à un code débogable. La génération avec /debug:pdbonly permet d'obtenir des fichiers .pdb mais non le DebuggableAttribute indiquant au compilateur JIT que des informations de débogage sont disponibles. Utilisez /debug:pdbonly si vous souhaitez générer des fichiers .pdb pour une version Release sans la rendre débogable. Pour plus d'informations, consultez /debug (Options du compilateur C#) ou /debug (Visual Basic).

Le débogueur Visual Studio utilise le chemin d'accès au fichier .pdb dans le fichier EXE ou DLL pour rechercher le fichier project.pdb. Si le débogueur ne peut pas trouver le fichier .pdb à cet emplacement ou si le chemin d'accès n'est pas valide, le débogueur recherche le chemin d'accès qui contient l'EXE, puis les chemins d'accès aux symboles spécifiés dans la boîte de dialogue Options. Ce chemin d'accès est en général le dossier Débogage du nœud Symboles. Le débogueur ne chargera pas un fichier .pdb qui ne correspond pas au fichier exécutable débogué. Si le débogueur ne trouve aucun fichier .pdb, la boîte de dialogue Rechercher des symboles qui s'affiche vous permet de rechercher des symboles ou d'ajouter des emplacements supplémentaires au chemin de recherche.

Applications Web

Le fichier de configuration de votre application (Web.config) doit avoir pour valeur mode débogage. En mode débogage, ASP.NET génère des symboles pour les fichiers générés dynamiquement et le débogueur peut être attaché à l'application ASP.NET. VS définit cela automatiquement lorsque vous commencez le débogage, si vous avez créé votre projet à partir du modèle de projets web.

Contents | Find symbol (.pdb) files

Rechercher les fichiers sources

• Where the debugger searches for source files | Find and load source files with the No Source / No Symbols Loaded pages | Add source file search paths to a solution | Use source servers

Où le débogueur recherche les fichiers source

Le débogueur recherche des fichiers sources dans les emplacements suivants :

1. Fichiers ouverts dans l'IDE de l'instance Visual Studio qui a lancé le débogueur.

2. Fichiers dans la solution ouverte dans l'instance VS.

3. Répertoires qui sont spécifiés dans la page Propriétés communes / Fichiers sources pour le débogage dans les propriétés de la solution.

4. Informations sources du .pdb du module. Il peut s'agir de l'emplacement du fichier source lorsque le module a été généré, ou d'une commande d'un serveur source.

Contents | Find source files

Rechercher et charger des fichiers sources à l'aide des pages Aucune source / Aucun symbole n'a été chargé

Lorsque le débogueur interrompt l'exécution à un emplacement où le fichier source n'est pas disponible, il affiche les pages Aucune source n'a été chargée ou Aucun symbole n'a été chargé qui peuvent vous aider à trouver le fichier source. Le message Aucun symbole n'a été chargé apparaît lorsque le débogueur ne trouve aucun fichier de symboles (.pdb) pour le fichier exécutable pour terminer sa recherche. La page Aucun symbole fournit des options de recherche pour le fichier. Si le fichier .pdb est trouvé après l'exécution d'une des options et que le débogueur peut récupérer le fichier source à l'aide des informations contenues dans le fichier de symboles, la source est affichée. Sinon, la page Aucune source n'a été chargée apparaît et décrit le problème. La page affiche les liens d'option qui peuvent effectuer des actions pouvant résoudre le problème.

Contents | Find source files

Ajouter des chemins de recherche de fichier source à une solution

Vous pouvez spécifier le réseau ou les répertoires locaux sur lesquels rechercher les fichiers sources.

1. Sélectionnez la solution dans l'Explorateur de solutions, puis choisissez Propriétés dans le menu contextuel.

2. Sous le nœud Propriétés communes, choisissez Fichiers sources pour le débogage.

3. Cliquez sur l'icône de dossier . Le texte modifiable apparaît dans la liste Répertoires contenant du code source.

4. Ajoutez le chemin que vous souhaitez rechercher.

Notez que seul le répertoire spécifié est recherché. Vous devez ajouter des entrées pour tous les sous-répertoires à explorer.

Contents | Find source files

Utiliser des serveurs sources

Lorsqu'il n'y a pas de code source sur l'ordinateur local ou si le fichier .pdb ne correspond pas au code source, le serveur source peut vous aider à déboguer une application. Il prend les demandes de fichiers et retourne les fichiers réels. Le serveur source s'exécute au moyen d'un fichier DLL nommé srcsrv.dll. Le serveur source lit le fichier .pdb de l'application, qui contient des pointeurs vers le référentiel de code source ainsi que des commandes utilisées pour extraire le code source du référentiel. Vous pouvez limiter les commandes dont vous autorisez l'exécution et appartenant au fichier .pdb de l'application en les répertoriant dans un fichier srcsrv.ini qui doit se trouver dans le même répertoire que srcsrv.dll et devenv.exe.

Note de sécurité

Les commandes arbitraires peuvent être incorporées dans le fichier .pdb de l'application, veillez à ne mettre que celles que vous voulez exécuter dans le fichier srcsrv.ini.Toute tentative d'exécution d'une commande ne se trouvant pas dans le fichier srcsvr.ini provoque l'apparition d'une boîte de dialogue de confirmation.Pour plus d'informations, consultez Avertissement de sécurité : Le débogueur doit exécuter cette commande non approuvée.Aucune validation n'est effectuée sur les paramètres de commande, soyez donc prudent avec les commandes de confiance.Par exemple, vous avez confiance en cmd.exe, mais un utilisateur malveillant a pu spécifier des paramètres qui rendent la commande dangereuse.

Pour activer l'utilisation d'un serveur source

1. Vérifiez que vous respectez les mesures de sécurité décrites dans la section précédente.

2. Dans le menu Outils, choisissez Options.

   La boîte de dialogue Options s'affiche.

3. Dans le nœud Débogage, choisissez la page Général.

4. Activez la case à cocher Activer le support du serveur source.

   

5. (Facultatif) Sélectionnez les options enfants que vous souhaitez.

   Notez que les deux options Autoriser le serveur source pour les assemblys de confiance partielle (managé uniquement) et Toujours exécuter les commandes de serveur source non fiables sans demander de confirmation peuvent augmenter les risques de sécurité décrits ci-dessus.

Contents | Find source files

Voir aussi

Autres ressources

Article sur les modifications du chargement des symboles distants .NET dans Visual Studio 2012 et 2013