Chemin du code source

Le chemin d’accès source spécifie les répertoires où se trouvent les fichiers sources C et C++.

Si vous déboguez un processus en mode utilisateur sur l’ordinateur sur lequel le fichier exécutable a été généré, et si les fichiers sources sont toujours à leur emplacement d’origine, le débogueur peut localiser automatiquement les fichiers sources.

Dans la plupart des autres situations, vous devez définir le chemin d’accès source ou charger les fichiers sources individuels.

Lorsque vous effectuez un débogage à distance via le débogueur, le serveur de débogage utilise le chemin d’accès source. Si vous utilisez WinDbg comme débogueur, chaque client de débogage a également son propre chemin d’accès source local. Toutes les commandes liées à la source accèdent aux fichiers sources sur l’ordinateur local. Vous devez définir les chemins d’accès appropriés sur n’importe quel client ou serveur que vous souhaitez utiliser les commandes sources.

Ce système à plusieurs chemins permet également à un client de débogage d’utiliser des commandes liées à la source sans réellement partager les fichiers sources avec d’autres clients ou avec le serveur. Ce système est utile s’il existe des fichiers sources privés ou confidentiels auxquels l’un des utilisateurs a accès.

Vous pouvez également charger des fichiers sources à tout moment, quel que soit le chemin d’accès source.

Syntaxe du chemin d’accès source

Le chemin source 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.

Note Si vous êtes connecté à un réseau d’entreprise, le moyen le plus efficace d’accéder aux fichiers sources consiste à utiliser un serveur source. Vous pouvez utiliser un serveur source à l’aide de la chaîne srv\* dans votre chemin d’accès source. Pour plus d’informations sur les serveurs sources, consultez Utilisation d’un serveur source.

Contrôle du chemin d’accès source

Pour contrôler le chemin source et le chemin source local, vous pouvez effectuer l’une des opérations suivantes :

• Avant de commencer le débogueur, utilisez la variable d’environnement _NT_SOURCE_PATH pour définir le chemin d’accès source. Si vous essayez d’ajouter un répertoire non valide via cette variable d’environnement, le débogueur ignore ce répertoire.

• Lorsque vous démarrez le débogueur, utilisez l’option de ligne de commande-srcpath pour définir le chemin d’accès source.

• Utilisez la commande .srcpath (Définir le chemin source) pour afficher, définir, modifier ou ajouter au chemin source. Si vous utilisez un serveur source, .srcfix (Utiliser le serveur source) est légèrement plus facile.

• (WinDbg uniquement) Utilisez la commande .lsrcpath (Définir le chemin de la source locale) pour afficher, définir, modifier ou ajouter au chemin d’accès source local. Si vous utilisez un serveur source, .lsrcfix (Utiliser un serveur source local) est légèrement plus facile. Vous pouvez également utiliser le Command-Line WinDbg avec le paramètre -lscrpath. Pour plus d’informations, consultez Options de Command-Line WinDbg.

• (WinDbg uniquement) Utiliser le [Fichier | Commande Chemin du fichier source ou appuyez sur Ctrl+P pour afficher, définir, modifier ou ajouter au chemin source ou au chemin d’accès source local.

Vous pouvez également ouvrir ou fermer directement un fichier source en effectuant l’une des opérations suivantes :

• Utilisez la commande lsf (Charger ou décharger le fichier source) pour ouvrir ou fermer un fichier source.

• (WinDbg uniquement) Utilisez la commande .open (fichier open source) pour ouvrir un fichier source.

• (WinDbg uniquement) Utiliser le fichier | open source commande de fichier ou appuyez sur ctrl+o pour ouvrir un fichier source. vous pouvez également utiliser le bouton fichier open source (ctrl+o) dans la barre d’outils.

  Note Quand vous utilisez Fichier | Ouvrez fichier source (ou son menu contextuel ou ses équivalents de bouton) pour ouvrir un fichier source, le chemin d’accès de ce fichier est automatiquement ajouté au chemin source.

• (WinDbg uniquement) Utiliser le fichier | Commande Fichiers récents pour ouvrir l’un des quatre fichiers sources que vous avez récemment ouverts dans WinDbg.

• (WinDbg uniquement) Utiliser le fichier | Commande Fermer la fenêtre actuelle ou sélectionnez le bouton Fermer dans le coin de la fenêtre Source pour fermer un fichier source.

Voir aussi

Pour plus d’informations sur l’utilisation des fichiers sources, consultez Débogage en mode source.