Partager via

Utilisation de SrcSrv

  • Article

Pour utiliser SrcSrv avec WinDbg, KD, NTSD ou CDB, vérifiez que vous avez installé une version récente du package Outils de débogage pour Windows (version 6.3 ou ultérieure). Ensuite, incluez le texte srv* dans le chemin source, séparé par des points-virgules de tous les répertoires qui se trouvent également dans le chemin source.

Par exemple :

.srcpath srv*;c:\someSourceCode

Si le chemin source est défini comme indiqué dans l’exemple précédent, le débogueur utilise d’abord SrcSrv pour récupérer les fichiers sources à partir des emplacements spécifiés dans les fichiers de symboles des modules cibles. Si SrcSrv ne parvient pas à récupérer un fichier source, le débogueur tente de le récupérer à partir de c :\someSourceCode. Que srv* soit le premier élément du chemin d’accès ou s’affiche ultérieurement, le débogueur utilise toujours SymSrv avant de rechercher d’autres répertoires répertoriés dans le chemin d’accès.

Si un fichier source est récupéré par SrcSrv, il reste sur votre disque dur une fois la session de débogage terminée. Les fichiers sources sont stockés localement dans le sous-répertoire src du répertoire de base (contrairement au serveur de symboles, le serveur source ne spécifie pas de cache local dans la srv* syntaxe elle-même). Le répertoire de base est défini par défaut sur le répertoire d’installation Outils de débogage pour Windows ; Il peut être modifié à l’aide de l’extension !homedir ou en définissant la variable d’environnement DBGHELP_HOMEDIR. Si le sous-répertoire src du répertoire de base n’existe pas déjà, il est créé.

Débogage de SrcSrv

Si vous rencontrez des problèmes lors de l’extraction des fichiers sources à partir du débogueur, démarrez le débogueur avec le paramètre de ligne de commande -n pour afficher les commandes d’extraction de source réelles ainsi que la sortie de ces commandes. La commande bruyante !sym fait la même chose, mais vous avez peut-être déjà manqué des informations importantes des tentatives d’extraction précédentes. En effet, le débogueur abandonne toute tentative d’accès à la source à partir de référentiels de contrôle de version qui semblent inaccessibles.

Récupération des fichiers sources

Si vous utilisez la commande .open (fichier open source) pour ouvrir un nouveau fichier source via SrcSrv, vous devez inclure le paramètre -m Address.

Pour faciliter l’utilisation de SrcSrv à partir d’outils autres que les débogueurs répertoriés précédemment, l’API DbgHelp fournit l’accès à la fonctionnalité SrcSrv via la fonction SymGetSourceFile . Pour récupérer le nom du fichier source à récupérer, appelez la fonction SymEnumSourceFiles ou SymGetLineFromAddr64. Pour plus d’informations sur l’API DbgHelp, consultez la documentation dbghelp.chm, qui se trouve dans le sous-répertoire sdk/help du répertoire d’installation Outils de débogage pour Windows, ou consultez Bibliothèque d’aide de débogage.

Utilisation d’AgeStore pour réduire la taille du cache

Tous les fichiers sources téléchargés par SrcSrv restent sur votre disque dur une fois la session de débogage terminée. Pour contrôler la taille du cache source, l’outil AgeStore peut être utilisé pour supprimer les fichiers mis en cache antérieurs à une date spécifiée ou pour réduire le contenu du cache en dessous d’une taille spécifiée. Pour plus d’informations, consultez AgeStore.