DetailPage-MSS-KB

Base de connaissances

Numéro d'article: 311503 - Dernière mise à jour: dimanche 2 juin 2013 - Version: 6.0

 

Sommaire

Résumé

Cet article décrit comment référencer le serveur de symboles Microsoft pour obtenir des informations de débogage de symbole.

Cliquez sur le bouton lecture pour afficher cette démonstration multimédia en continu. Vidéo MicrosoftRemarque : Pour visualiser cette vidéo, le Lecteur Windows Media 7.0 ou version ultérieure doit être installé sur votre ordinateur. Pour plus d'informations, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
299321  (http://support.microsoft.com/kb/299321/EN-US/ ) Description et disponibilité du Lecteur Windows Media 7.1
Vous devez disposer des informations de symboles lors du débogage d'applications avec divers outils de Microsoft. Les fichiers de symboles offrent un ensemble de fonctions qui sont contenues dans les fichiers exécutables et les bibliothèques de liens dynamiques (DLL). En outre, les fichiers de symboles peuvent présenter un plan d'évolution des appels de fonction qui mènent à un point de défaillance. Par exemple, vous devez disposer les symboles lorsque vous videz des piles d'appels à l'intérieur d'un débogueur. Cet article explique comment utiliser Microsoft Symbol Server en spécifiant l'URL suivante pour les différents outils de débogage :
http://msdl.Microsoft.com/download/symbols
Remarque l'adresse http://msdl.Microsoft.com/download/symbols ne peut pas être parcourue et est conçue uniquement pour un accès par débogueur.

Plus d'informations

À l'aide de la technologie de serveur de symboles

Le serveur de symboles Microsoft est construit à l'aide de la technologie SymSrv (SymSrv.dll) qui est fournie avec le package Outils de débogage pour Windows. SymSrv construit un cache de symboles local pour la résolution de symboles rapide et automatique.

Il est aussi simple d'utiliser le serveur de symboles que d'utiliser la syntaxe appropriée dans votre chemin de symbole. En règle générale, la syntaxe prend le format suivant :
SRV *votre dossier de symbole local*http://msdl.Microsoft.com/download/symbols
votre dossier de symbole local est un lecteur ou partage qui est utilisé comme destination de symbole.

Par exemple, pour définir le chemin de symbole dans le débogueur WinDbg, tapez la commande suivante dans la fenêtre de commande du débogueur :
.sympath SRV*f:\localsymbols*http://msdl.microsoft.com/download/symbols
Pour obtenir les dernières fonctionnalités SymSrv, vous devez installer le package de débogage le plus récent. Pour obtenir la dernière version du package Outils de débogage pour Windows, visitez le site Web de Microsoft à l'adresse suivante :
Outils de débogage Microsoft
http://www.Microsoft.com/whdc/devtools/ddk/default.mspx (http://www.microsoft.com/whdc/devtools/ddk/default.mspx)
Pour plus d'informations sur la technologie de serveur de symboles, consultez le Debuggers.chm à l'aide de fichier est inclus dans le package Outils de débogage pour Windows.

Définition de la variable d'environnement _NT_SYMBOL_PATH

Les outils de débogage Microsoft courants utilisent la technologie de SymSrv si vous fournissez la syntaxe correcte symsrv dans la variable d'environnement _NT_SYMBOL_PATH. Ces outils incluent automatiquement tout ce que vous fournissez dans la variable en tant que le chemin de symbole.

Vous pouvez définir cette variable sous la forme d'une variable système ou une variable d'environnement utilisateur. Pour ce faire, à partir du bureau, cliquez droit sur Poste de travail, puis cliquez sur Propriétés. Sous l'onglet Avancé , cliquez sur Variables d'environnement.

Vous pouvez également définir cette variable temporaire à une invite de commande. De cette manière, toutes les applications que vous démarrez par le biais de l'invite de commande héritent de ce paramètre. Par exemple :
Set _NT_SYMBOL_PATH = symsrv*symsrv.dll*f:\localsymbols*http://msdl.microsoft.com/download/symbols

À l'aide du serveur de symboles Microsoft avec WinDbg

Pour utiliser le site Web de serveur de symboles à partir de WinDbg, procédez comme suit :
  1. Démarrez le débogueur Windows (WinDbg.exe).
  2. Dans le menu fichier , cliquez sur Chemin d'accès du fichier de symboles.
  3. Dans la zone chemin d'accès , tapez la commande suivante :
    SRV *votre dossier local pour les symboles*http://msdl.Microsoft.com/download/symbols
    votre dossier local pour les symboles est le dossier dans lequel vous copiez votre cache de symboles local. Les symboles de débogage sont téléchargés vers cet emplacement.

    Remarque : Vous pouvez pointer vers n'importe quel chemin d'accès local ou un partage votre ordinateur pouvant atteindre ; Il n'a pas à être un emplacement sur le disque dur.
Sinon, vous pouvez également utiliser la commande .sympath à une invite de commande pour définir le chemin de symbole.

Vous pouvez combiner la syntaxe symsrv avec les autres chemins d'accès aux symboles. Par exemple, utiliser la syntaxe suivante pour spécifier deux ou plusieurs chemins d'accès de symbole :
f:\BusObjSymbols ;SRV*f:\localsymbols*http://msdl.Microsoft.com/download/symbols
Cette syntaxe sépare les chemins d'accès de symbole par un point-virgule.

Lorsque vous commencez à déboguer une application ou un fichier de vidage sur incident, le débogueur Windows vérifie si les informations de symbole pour un module qu'il charge figurent dans le dossier local. Si les informations sur les symboles du module ne sont pas situées dans le dossier local, WinDbg tente de télécharger le symbole approprié ou les fichiers à partir du serveur de symboles.

Si vous utilisez le cache local même lorsque vous déboguez une application sur un ordinateur qui dispose des versions de fichier différent, les symboles pour les différentes versions sont téléchargés et stockés avec les symboles des première. Le format SymStore stocke les fichiers en fonction de l'horodatage et la taille de l'image (ou somme de contrôle). Par conséquent, les symboles à partir de différentes versions de produits peuvent coexister côte à côte. (SymStore.exe est un utilitaire à partir du package Outils de débogage pour Windows qui génère un serveur de symboles. Pour plus d'informations, consultez la documentation du produit.)

Dans la mesure où il peut prendre le temps de téléchargement des fichiers de symboles, gardez à l'esprit que le débogueur peut sembler cesser de répondre (se bloquer) la première fois que vous déboguez une application. Cela se produit car la plupart des fichiers de symboles pour le système de DLL (comme Ntdll.dll, Kernel32.dll, etc.) doit être téléchargée.

À l'aide de l'utilitaire SymChk.exe pour télécharger des symboles

Vous pouvez utiliser l'utilitaire SymChk.exe pour vérifier les symboles et générer un cache de symboles local d'une façon pratique et non invasif. L'utilitaire SymChk.exe est inclus dans le package Outils de débogage pour Windows. SymChk.exe est un outil de ligne de commande. Vous souhaiterez peut-être ajouter le dossier du package Outils de débogage pour Windows à la variable d'environnement PATH de votre système afin que vous pouvez facilement accéder à cet outil à partir d'une invite de commande.

Pour utiliser l'utilitaire SymChk.exe pour télécharger des fichiers de symboles pour tous les composants dans le dossier Windows\System32, utilisez la commande de ligne de commande suivante :
Symchk /r c:\windows\system32 /s SRV*c:\symbols\*http://msdl.microsoft.com/download/symbols
Dans cet exemple :
  • /r c:\windows\system32 recherche tous les symboles pour les fichiers dans le dossier System32 et tous les sous-dossiers.
  • SRV*c:\symbols*http://msdl.microsoft.com/download/symbols /s Spécifie le chemin de symbole à utiliser pour la résolution de symboles. Dans ce cas, c:\SYMBOLS est le dossier local où les symboles sont copiés à partir du serveur de symboles.
Pour obtenir plus d'informations sur les options de ligne de commande pour SymChk.exe, tapez Symchk / ? à l'invite de commandes. Autres options incluent la possibilité de spécifier le nom ou ID du processus (PID) d'un fichier exécutable qui est en cours d'exécution.

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Visual Studio .NET 2003 Enterprise Architect
  • Microsoft Visual Studio .NET 2003 Enterprise Developer
  • Microsoft Visual Studio .NET 2003 Éducation
  • Microsoft Visual Studio .NET 2002 Professional Edition
  • Microsoft Visual Studio .NET 2002 Enterprise Architect
  • Microsoft Visual Studio .NET 2002 Enterprise Developer
  • Microsoft Visual Studio .NET 2002 Éducation
Mots-clés : 
kbfile kbinfo kbsample kbmt KB311503 KbMtfr
Traduction automatiqueTraduction automatique
IMPORTANT : Cet article est issu d'une traduction automatique réalisée par un logiciel Microsoft et non par un traducteur professionnel. Cette traduction automatique a pu aussi être révisée par la communauté Microsoft grâce à la technologie Community Translation Framework (CTF). Pour en savoir plus sur cette technologie, veuillez consulter la page http://support.microsoft.com/gp/machine-translation-corrections/fr. Microsoft vous propose en effet des articles traduits par des professionnels, des articles issus de traductions automatiques et des articles issus de traductions automatiques révisées par la communauté Microsoft, de manière à ce que vous ayez accès à tous les articles de notre Base de connaissances dans votre langue. Il est important de noter que les articles issus de la traduction automatique, y compris ceux révisés par la communauté Microsoft, peuvent contenir des erreurs de vocabulaire, de syntaxe ou de grammaire. Microsoft ne pourra être tenu responsable des imprécisions, erreurs, ainsi que de tout dommage résultant d’une traduction incorrecte du contenu ou de son utilisation par les clients.
La version anglaise de cet article est la suivante: 311503  (http://support.microsoft.com/kb/311503/en-us/ )
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.
Partager
Options de support supplémentaire
Forums du support Microsoft Community
Nous contacter directement
Trouver un partenaire Microsoft Certified Partner
Microsoft Store