Partager via

Définition des chemins d’accès de symbole et d’image exécutable dans CDB

  • 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 les serveurs de symboles, consultez Chemin des symboles pour le débogueur Windows.

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

  • Entrez 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 CDB.

  • 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. 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 d’accès 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.)

    Note Si vous utilisez l’option de ligne de commande -sins , le débogueur ignore la variable d’environnement de chemin de symbole.

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 .exe, .dll ou .sys nom de fichier. Les fichiers exécutables sont également appelés modules, en particulier lorsque les fichiers exécutables sont décrits en tant qu’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 modules spéciaux. Par exemple, le module nt correspond au fichier Ntoskrnl.exe.

Le chemin d’accès de 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 est requis. Par exemple, les fichiers de vidage de mémoire de petite taille en mode noyau ne contiennent pas tous les fichiers exécutables qui existent en mémoire au moment d’une erreur d’arrêt (autrement dit, un incident). De même, les fichiers minidump en mode utilisateur ne contiennent pas les fichiers binaires d’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 de répertoire, séparés par des points-virgules. Les chemins d’accès relatifs sont pris en charge. Toutefois, sauf si vous 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. 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.

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