Partager via


Comment : spécifier les emplacements du fichier de symboles à partir de la ligne de commande

Pour afficher les informations de symbole telles que les noms de fonction et les numéros de ligne, l'outil en ligne de commande VSPerfReport doit pouvoir accéder aux fichiers de symboles (.PDB) des composants profilés, ainsi qu'aux fichiers système Windows. Les fichiers de symboles sont créés lors de la compilation d'un composant. Pour plus d'informations, consultez VSPerfReport. VSPerfReport recherche automatiquement les fichiers de symboles aux emplacements suivants :

  • Chemins spécifiés dans l'option /SymbolPath ou dans la variable d'environnement _NT_SYMBOL_PATH.

  • Chemin d'accès local exact dans lequel un composant a été compilé.

  • Répertoire contenant le fichier des données de profilage (.vsp ou vsps).

Microsoft fournit les fichiers .pdb de bon nombre de ses produits en ligne sur un serveur de symboles. Si l'ordinateur que vous utilisez pour le reporting est connecté à Internet, VSPerfReport se connecte au serveur de symboles en ligne afin de rechercher automatiquement les informations relatives aux symboles et d'enregistrer les fichiers dans un magasin local.

Vous pouvez spécifier l'emplacement des fichiers de symboles et du magasin du serveur de symboles Microsoft comme suit :

  • Définissez la variable d'environnement _NT_SYMBOL_PATH.

  • Ajoutez l'option /SymbolPath à la ligne de commande de VSPerfReport.

Vous pouvez également utiliser ces deux méthodes.

Notes

Si Visual Studio est installé sur l'ordinateur local, un emplacement pour les fichiers de symboles Windows a probablement déjà été défini. Pour plus d'informations, consultez Comment : référencer les informations de symboles Windows. Vous devez encore configurer VSPerfReport pour utiliser l'emplacement et le serveur comme décrit ultérieurement dans cette rubrique.

Spécification des fichiers de symboles Windows

Pour configurer l'utilisation du serveur de symboles Windows

  1. Si nécessaire, créez un répertoire dans lequel stocker les fichiers de symboles en local.

  2. Utilisez la syntaxe suivante pour définir la variable d'environnement _NT_SYMBOL_PATH ou l'option VSPerfReport /SymbolPath :

    srv*LocalStore*http://msdl.microsoft.com/downloads/symbols

    où LocalStore est le chemin d'accès du répertoire local que vous avez créé.

Spécification des fichiers de symboles de composants

Les outils de profilage recherchent les fichiers .pdb des composants que vous voulez profiler à leurs emplacements d'origine qui sont stockés dans les composants ou dans le dossier qui contient le fichier des données de profilage. Vous pouvez spécifier d'autres emplacements à examiner en ajoutant un ou plusieurs chemins d'accès à _NT_SYMBOL_PATH ou à l'option /SymbolPath. Séparez les chemins d'accès par des points-virgules.

Exemple

La ligne de commande suivante définit la variable d'environnement _NT_SYMBOL_PATH sur le serveur de symboles Windows et le répertoire local sur C:\Symbols.

set  _NT_SYMBOL_PATH=srv*C:\symbols*http://msdl.microsoft.com/downloads/symbols

La ligne de commande VSPerfReport suivante ajoute le répertoire C:\Projects\Symbols au chemin d'accès de recherche à l'aide de l'option /SymbolPath.

VSPerfReport MyApp**.exe /SymbolPath:C:\Projects\Symbols /summary:all**