Partager via

Définition des chemins d’accès aux symboles et aux images exécutables dans WinDbg

  • Article

Chemin du symbole

Le chemin du symbole spécifie les répertoires où se trouvent les fichiers de symboles. Pour plus d’informations sur les symboles et les fichiers de symboles, consultez Symboles.

Note Si vous êtes connecté à Internet ou à un réseau d’entreprise, le moyen le plus efficace d’accéder aux symboles consiste à utiliser un serveur de symboles. Vous pouvez utiliser un serveur de symboles à l’aide de la chaîne srv* ou symsrv* dans le chemin de votre symbole. Pour plus d’informations sur l’accès aux serveurs de symboles, consultez Chemin des symbolespour le débogueur Windows.

Pour contrôler le chemin du symbole dans WinDbg, effectuez l’une des opérations suivantes :

  • Choisissez Chemin du fichier de symbole dans le menu Fichier ou appuyez sur Ctrl+S.

  • Utilisez la commande .sympath (Définir le chemin du symbole). Si vous utilisez un serveur de symboles, la commande .symfix (Définir le chemin du magasin de symboles) est similaire à .sympath , mais vous évite de taper.

  • Lorsque vous démarrez le débogueur, utilisez l’option de ligne de commande -y . Consultez Options de Command-Line WinDbg.

  • Avant de démarrer le débogueur, utilisez les variables d’environnement _NT_SYMBOL_PATH et _NT_ALT_SYMBOL_PATH pour définir le chemin d’accès. Le chemin du symbole est créé en ajoutant _NT_SYMBOL_PATH après _NT_ALT_SYMBOL_PATH. (En règle générale, le chemin est défini via le _NT_SYMBOL_PATH. Toutefois, vous pouvez utiliser _NT_ALT_SYMBOL_PATH pour remplacer ces paramètres dans des cas spéciaux, par exemple lorsque vous avez des versions privées de fichiers de symboles partagés.) Si vous essayez d’ajouter un répertoire non valide via ces variables d’environnement, le débogueur ignore ce répertoire.

    Note Si vous utilisez l’option de ligne de commande -sins , le débogueur ignore la variable d’environnement symbol path. Pour plus d’informations, consultez Options de Command-Line WinDbg.

Chemin d’accès de l’image exécutable

Un fichier exécutable est un fichier binaire que le processeur peut exécuter. Ces fichiers ont généralement l’extension de nom de fichier .exe, .dll ou .sys. Les fichiers exécutables sont également appelés modules, en particulier lorsque les fichiers exécutables sont décrits comme des unités d’une application plus grande. Avant que le système d’exploitation Windows n’exécute un fichier exécutable, il le charge en mémoire. La copie du fichier exécutable en mémoire est appelée image exécutable ou image.

Note Ces termes sont parfois utilisés de manière imprécise. Par exemple, certains documents peuvent utiliser « image » pour le fichier réel sur le disque. En outre, le noyau Windows et HAL ont des noms de module spéciaux. Par exemple, le module nt correspond au fichier Ntoskrnl.exe.

Le chemin d’accès à l’image exécutable spécifie les répertoires où se trouvent les fichiers exécutables binaires.

Dans la plupart des cas, le débogueur connaît l’emplacement des fichiers exécutables. Vous n’avez donc pas à définir le chemin d’accès de ce fichier.

Toutefois, il existe des situations où ce chemin d’accès est requis. Par exemple, les petits fichiers de vidage de mémoire en mode noyau ne contiennent pas tous les fichiers exécutables qui existent en mémoire au moment d’une erreur d’arrêt (c’est-à-dire un incident). De même, les fichiers minidump en mode utilisateur ne contiennent pas les fichiers binaires de l’application. Si vous définissez le chemin des fichiers exécutables, le débogueur peut trouver ces fichiers binaires.

Le chemin d’accès de l’image exécutable du débogueur est une chaîne qui se compose de plusieurs chemins d’accès de répertoire, séparés par des points-virgules. Les chemins d’accès relatifs sont pris en charge. Toutefois, à moins que vous ne démarrez toujours le débogueur à partir du même répertoire, vous devez ajouter une lettre de lecteur ou un partage réseau avant chaque chemin d’accès. Les partages réseau sont également pris en charge. Le débogueur recherche le chemin d’accès de l’image exécutable de manière récursive. Autrement dit, le débogueur recherche les sous-répertoires de chaque répertoire répertorié dans ce chemin d’accès.

Pour contrôler le chemin d’accès de l’image exécutable dans WinDbg, effectuez l’une des opérations suivantes :

  • Choisissez Chemin d’accès du fichier image dans le menu Fichier , ou appuyez sur Ctrl+I.

  • Utilisez la commande .exepath (Définir le chemin exécutable).

  • Lorsque vous démarrez le débogueur, utilisez l’option de ligne de commande -i . Consultez Options de Command-Line WinDbg.

  • Avant de démarrer le débogueur, utilisez la variable d’environnement _NT_EXECUTABLE_IMAGE_PATH pour définir le chemin d’accès.

    Note Si vous utilisez l’option de ligne de commande -sins , le débogueur ignore la variable d’environnement du chemin d’accès de l’image exécutable. Pour plus d’informations, consultez Options de Command-Line WinDbg.