/DEBUG (Générer des informations de débogage)

  • Article

L’option /DEBUG éditeur de liens crée un fichier d’informations de débogage pour l’exécutable.

Syntaxe

/DEBUG[:{FASTLINK||FULLNONE}]

Notes

L’option /DEBUG place les informations de débogage à partir de fichiers d’objet et de bibliothèque liés dans un fichier de base de données de programme (PDB). Il met à jour le fichier PDB lors des générations suivantes du programme.

Un exécutable (fichier EXE ou DLL) créé pour le débogage contient le nom et le chemin d’accès de la base de données PDB correspondante. Le débogueur lit le nom incorporé et utilise le fichier PDB lorsque vous déboguez le programme. L’éditeur de liens utilise le nom de base du programme et l’extension .pdb pour nommer la base de données du programme et incorpore le chemin d’accès où il a été créé. Pour remplacer cette valeur par défaut, définissez l’option /PDB et spécifiez un autre nom de fichier.

L’option /DEBUG:FASTLINK est disponible dans Visual Studio 2017 et versions ultérieures. Cette option génère une base de données PDB limitée qui indexe les informations de débogage dans les fichiers et bibliothèques d’objets utilisés pour générer l’exécutable au lieu d’effectuer une copie complète. Vous ne pouvez utiliser cette base de données PDB limitée que pour déboguer à partir de l’ordinateur où le fichier binaire et ses bibliothèques ont été créés. Si vous déployez le fichier binaire ailleurs, vous pouvez le déboguer à distance à partir de l’ordinateur de build, mais pas directement sur l’ordinateur de test. Depuis Visual Studio 2019, /DEBUG:FULL les temps de liaison ont été considérablement améliorés et /DEBUG:FASTLINK ne sont pas toujours plus rapides que /DEBUG:FULL. Étant donné qu’il /DEBUG:FASTLINK n’offre plus d’améliorations de temps de génération volumineuses et entraîne une expérience de débogage plus lente par rapport /DEBUG:FULLà cette option, cette option n’est plus recommandée.

Une /DEBUG:FASTLINK base de données PDB peut être convertie en une base de données PDB complète que vous pouvez déployer sur un ordinateur de test pour le débogage local. Dans Visual Studio, utilisez la boîte de dialogue Pages de propriétés comme décrit ci-dessous pour créer une base de données PDB complète pour le projet ou la solution. Dans une invite de commandes développeur, vous pouvez utiliser l’outil mspdbcmf.exe pour créer une base de données PDB complète.

L’option /DEBUG:FULL déplace toutes les informations de symbole privé des produits de compilation individuels (fichiers et bibliothèques d’objets) dans une base de données PDB unique et peut être la partie la plus longue du lien. Toutefois, le fichier PDB complet peut permettre de déboguer le fichier exécutable quand aucun autre produit de build n’est disponible, par exemple quand le fichier exécutable est déployé.

L’option /DEBUG:NONE ne génère pas de base de données PDB.

La spécification /DEBUG sans argument supplémentaire équivaut à spécifier /DEBUG:FULL.

L’option /Z7 du compilateur (compatible C7) permet au compilateur de laisser les informations de débogage dans les fichiers OBJ (Object). Vous pouvez également utiliser l’option du /Zi compilateur (Program Database) pour stocker les informations de débogage dans une base de données PDB pour le fichier OBJ. L’éditeur de liens recherche d’abord la base de données PDB de l’objet dans le chemin absolu écrit dans le fichier OBJ, puis dans le répertoire qui contient le fichier OBJ. Vous ne pouvez pas spécifier le nom ou l’emplacement du fichier PDB d’un objet vers l’éditeur de liens.

/INCREMENTAL est implicite lorsqu’elle /DEBUG est spécifiée.

/DEBUGmodifie les valeurs par défaut de l’option de vers NOREF et de ICF vers NOICF. Par conséquent, si vous souhaitez que les valeurs par défaut d’origine soient spécifiées ou après l’option, vous devez spécifier /OPT:REF explicitement ou /OPT:ICF après l’option/DEBUG./OPTREF

Il n’est pas possible de créer une DLL ou exe qui contient des informations de débogage. Les informations de débogage sont toujours placées dans un fichier OBJ ou PDB.

Pour définir cette option de l'éditeur de liens dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de propriétés Débogage de l’éditeur de>liens.

  3. Modifiez la propriété Generate Debug Info pour activer ou désactiver la génération PDB. Cette propriété est active par défaut dans Visual Studio 2017 et versions ultérieures /DEBUG:FASTLINK .

  4. Modifiez la propriété Générer un fichier de base de données de programme complet pour activer /DEBUG:FULL la génération complète de PDB pour chaque build incrémentielle.

Pour définir cette option de l'éditeur de liens par programmation

  1. Consultez GenerateDebugInformation.

Voir aussi

Informations de référence sur l’éditeur de liens MSVC
Options de l’éditeur de liens MSVC