Symbol Options

Plusieurs options sont disponibles pour contrôler le chargement et l’utilisation des symboles. Ces options peuvent être définies de différentes façons.

Le tableau suivant répertorie les options de symbole suivantes :

Modification des paramètres d’option de symbole

La commande .symopt (Définir les options de symbole) peut être utilisée pour modifier ou afficher les paramètres d’option de symbole. In addition, a number of command-line parameters and commands are available to change these settings; these are listed in the individual SYMOPT_XXX sections.

You can also control all the settings at once with the -sflagscommand-line option. This option can be followed with a decimal number, or with a hexadecimal number prefixed by 0x. Il est recommandé d’utiliser hexadécimal, car les indicateurs de symboles sont alignés correctement de cette façon. Soyez prudent lors de l’utilisation de cette méthode, car elle définit le champ de bits entier et remplace tous les paramètres par défaut du gestionnaire de symboles. For example, -sflags 0x401 will not only turn on SYMOPT_EXACT_SYMBOLS and SYMOPT_CASE_INSENSITIVE, but will also turn off all the other options that normally are on by default!

La valeur par défaut des bits d’indicateur total est 0x30237 dans WinDbg, 0xB0227 en CDB et KD, et 0x10C13 dans l’outil DBH, lorsque ces programmes sont lancés sans aucune option de ligne de commande liée aux symboles.

SYMOPT_CASE_INSENSITIVE

Cette option de symbole entraîne l’insensible à toutes les recherches de noms de symboles.

Cette option est activée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x1 or .symopt-0x1, respectively.

Cette option est activée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +1 ou symopt -1, respectivement.

SYMOPT_UNDNAME

Cette option de symbole entraîne l’annulation de l’affichage des noms de symboles publics et les recherches de noms de symboles ignorent les décorations de symboles. Les noms de symboles privés ne sont jamais décorés, que cette option soit active ou non. Pour plus d’informations sur les décorations de noms de symboles, consultez Symboles publics et privés.

Cette option est activée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x2 or .symopt-0x2, respectively.

Cette option est activée par défaut dans DBH. Elle est désactivée si l’option de ligne de commande -d est utilisée. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +2 ou symopt -2, respectivement.

SYMOPT_DEFERRED_LOADS

Cette option de symbole est appelée chargement différé de symboles ou chargement différé de symboles différés. Lorsqu’il est actif, les symboles ne sont pas réellement chargés lorsque les modules cibles sont chargés. Au lieu de cela, les symboles sont chargés par le débogueur, car ils sont nécessaires. Pour plus d’informations, consultez Chargement différé des symboles .

Cette option est activée par défaut dans tous les débogueurs. Dans CDB et KD, l’option de ligne de commande -s désactive cette option. It can also be turned off in CDB by using the LazyLoad variable in the tools.ini file. Once the debugger is running, this option can be turned on or off by using .symopt+0x4 or .symopt-0x4, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +4 ou symopt -4, respectivement.

SYMOPT_NO_CPP

Cette option de symbole désactive la traduction C++. When this symbol option is set, :: is replaced by __ in all symbols.

Cette option est désactivée par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -snc. Once the debugger is running, it can be turned on or off by using .symopt+0x8 or .symopt-0x8, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +8 ou symopt -8, respectivement.

SYMOPT_LOAD_LINES

Cette option de symbole permet de lire les informations de numéro de ligne à partir des fichiers sources. Cette option doit être activée pour que le débogage source fonctionne correctement.

Dans KD et CDB, cette option est désactivée par défaut ; dans WinDbg, cette option est activée par défaut. Dans CDB et KD, l’option de ligne de commande -lines active cette option. Once the debugger is running, it can be turned on or off by using .symopt+0x10 or .symopt-0x10, respectively. Il peut également être activé et désactivé à l’aide de la commande .lines (Toggle Source Line Support).

Cette option est activée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +10 ou symopt -10, respectivement.

SYMOPT_OMAP_FIND_NEAREST

Lorsque le code a été optimisé et qu’il n’existe aucun symbole à l’emplacement attendu, cette option entraîne l’utilisation du symbole le plus proche à la place.

Cette option est activée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x20 or .symopt-0x20, respectively.

Cette option est activée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +20 ou symopt -20, respectivement.

SYMOPT_LOAD_ANYTHING

Cette option de symbole réduit la sélection du gestionnaire de symboles lorsqu’elle tente de faire correspondre des symboles.

Cette option est désactivée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x40 or .symopt-0x40, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +40 ou symopt -40, respectivement.

SYMOPT_IGNORE_CVREC

Cette option de symbole permet au gestionnaire de symboles d’ignorer l’enregistrement CV dans l’en-tête d’image chargé lors de la recherche de symboles.

Cette option est désactivée par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -sicv. Once the debugger is running, it can be turned on or off by using .symopt+0x80 or .symopt-0x80, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +80 ou symopt -80, respectivement.

SYMOPT_NO_UNQUALIFIED_LOADS

Cette option de symbole désactive le chargement automatique du gestionnaire de symboles des modules. Lorsque cette option est définie et que le débogueur tente de faire correspondre un symbole, il recherche uniquement les modules qui ont déjà été chargés.

Cette option peut être utilisée comme défense contre la mauvaise saisie d’un nom de symbole. Normalement, un symbole mal typé entraîne la pause du débogueur pendant qu’il recherche tous les fichiers de symboles déchargés. Lorsque cette option est active, un symbole mal typé est introuvable dans les modules chargés, puis la recherche se termine.

Cette option est désactivée par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -snul. Once the debugger is running, it can be turned on or off by using .symopt+0x100 or .symopt-0x100, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +100 ou symopt -100, respectivement.

SYMOPT_FAIL_CRITICAL_ERRORS

Cette option de symbole entraîne la suppression des boîtes de dialogue d’erreur d’accès aux fichiers.

Si cette option est désactivée, les erreurs d’accès aux fichiers, telles que « lecteur non prêt », rencontrées pendant le chargement des symboles, entraînent l’affichage des boîtes de dialogue. Si cette option est activée, ces zones sont supprimées et toutes les erreurs d’accès reçoivent une réponse « échec ».

Cette option est activée par défaut dans tous les débogueurs. Elle peut être désactivée à l’aide de l’option de ligne de commande -sdce. Once the debugger is running, it can be turned on or off by using .symopt+0x200 or .symopt-0x200, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +200 ou symopt -200, respectivement.

SYMOPT_EXACT_SYMBOLS

Cette option de symbole permet au débogueur d’effectuer une évaluation stricte de tous les fichiers de symboles.

Lorsque cette option est activée, même la moindre différence entre les fichiers de symboles et les attentes du gestionnaire de symboles entraîne l’ignorer.

Cette option est désactivée par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -ses. Once the debugger is running, it can be turned on or off by using .symopt+0x400 or .symopt-0x400, respectively.

L’option de ligne de commande -failinc active également SYMOPT_EXACT_SYMBOLS. En outre, si vous déboguez un minidump en mode utilisateur ou un minidump en mode noyau, -failinc empêchera le débogueur de charger les modules dont les images ne peuvent pas être mappées.

Cette option est activée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +400 ou symopt -400, respectivement.

SYMOPT_ALLOW_ABSOLUTE_SYMBOLS

Cette option de symbole permet à DbgHelp de lire les symboles stockés à une adresse absolue en mémoire. Cette option n’est pas nécessaire dans la grande majorité des cas.

Cette option est désactivée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x800 or .symopt-0x800, respectively.

Cette option est activée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +800 ou symopt -800, respectivement.

SYMOPT_IGNORE_NT_SYMPATH

Cette option de symbole entraîne l’ignorer des paramètres de variable d’environnement pour le chemin d’accès des symboles et le chemin d’accès de l’image exécutable.

Cette option est désactivée par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -sins. However, it cannot be controlled by .symopt once the debugger is running, because the environment variables are only read at startup.

Cette option est désactivée par défaut dans DBH et est ignorée par DBH dans tous les cas.

SYMOPT_PUBLICS_ONLY

Cette option de symbole permet à DbgHelp d’ignorer les données de symboles privés et de rechercher uniquement la table de symboles publique pour obtenir des informations sur les symboles. Cela émule le comportement de DbgHelp avant l’ajout de la prise en charge de ces types. voir Symboles publics et privés.

Cette option est désactivée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x4000 or .symopt-0x4000, respectively.

Cette option est désactivée par défaut dans DBH. Elle est activée si l’option de ligne de commande -d est utilisée. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +4000 ou symopt -4000, respectivement.

SYMOPT_NO_PUBLICS

Cette option de symbole empêche DbgHelp de rechercher la table de symboles publics. Cela peut rendre l’énumération de symboles et les recherches de symboles beaucoup plus rapides. Si vous êtes préoccupé uniquement par la vitesse de recherche, l’option SYMOPT_AUTO_PUBLICS est généralement préférable à celle-ci. Pour plus d’informations sur la table de symboles publics, consultez Symboles publics et privés.

Cette option est désactivée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x8000 or .symopt-0x8000, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +8000 ou symopt -8000, respectivement.

SYMOPT_AUTO_PUBLICS

Cette option de symbole permet à DbgHelp de rechercher la table de symboles publics dans un fichier .pdb uniquement en dernier recours. Si des correspondances sont trouvées lors de la recherche des données de symboles privés, les symboles publics ne sont pas recherchés. Cela améliore la vitesse de recherche de symboles.

Cette option est activée par défaut dans tous les débogueurs. Elle peut être désactivée à l’aide de l’option de ligne de commande -sup. Once the debugger is running, it can be turned on or off by using .symopt+0x10000 or .symopt-0x10000, respectively.

Cette option est activée par défaut dans DBH. Elle est désactivée si l’option de ligne de commande -d est utilisée. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +10000 ou symopt -10000, respectivement.

SYMOPT_NO_IMAGE_SEARCH

Cette option de symbole empêche DbgHelp de rechercher sur le disque une copie de l’image lorsque des symboles sont chargés.

Cette option est activée par défaut dans tous les débogueurs. Once the debugger is running, it can be turned on or off by using .symopt+0x20000 or .symopt-0x20000, respectively.

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +20000 ou symopt -20000, respectivement.

SYMOPT_SECURE

(Kernel mode only) This symbol option indicates whether Secure Mode is active.

Le mode sécurisé est désactivé par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -secure. If the debugger is running, is in dormant mode, and has not established any Debugging Servers, Secure Mode can be turned on by using .symopt+0x40000 or .secure (Activate Secure Mode).

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +40000 ou symopt -40000, respectivement.

Le mode sécurisé ne peut jamais être désactivé une fois qu’il a été activé.

SYMOPT_NO_PROMPTS

Cette option de symbole supprime les boîtes de dialogue d’authentification du serveur proxy. Cela peut entraîner l’impossibilité pour SymSrv d’accéder à un magasin de symboles sur Internet.

Pour plus d’informations, consultez Pare-feu et serveurs proxy.

Dans KD et CDB, cette option est activée par défaut ; dans WinDbg, cette option est désactivée par défaut. Once the debugger is running, it can be turned on or off by using .symopt+0x80000 or .symopt-0x80000, respectively, followed by the .reload (Reload Module) command. Il peut également être activé et désactivé à l’aide des invites !sym et!sym invite les commandes d’extension, suivie de la commande .reload (Module de rechargement).

Cette option est désactivée par défaut dans DBH. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +80000 ou symopt -80000, respectivement.

-SYMOPT_DEBUG

Cette option de symbole active le chargement de symboles bruyants. Cela indique au débogueur d’afficher des informations sur sa recherche de symboles.

Le nom de chaque fichier de symboles s’affiche à mesure qu’il est chargé. Si le débogueur ne peut pas charger un fichier de symboles, il affiche un message d’erreur. Les messages d’erreur pour les fichiers .pdb s’affichent en texte. Les messages d’erreur pour les fichiers .dbg sont sous la forme d’un code d’erreur ; ces codes sont expliqués dans le fichier winerror.h.

Si un fichier image est chargé uniquement pour récupérer les informations d’en-tête symboliques, cela s’affiche également.

Cette option est désactivée par défaut dans tous les débogueurs. Elle peut être activée à l’aide de l’option de ligne de commande -n. Once the debugger is running, it can be turned on or off by using .symopt+0x80000000 or .symopt-0x80000000, respectively. It can also be turned on and off by using the !sym noisy and !sym quiet extension commands.

Note This option should not be confused with noisy source loading -- that is controlled by the .srcnoisy (Noisy Source Loading) command.

Cette option est désactivée par défaut dans DBH. Elle peut être activée à l’aide de l’option de ligne de commande -n. Une fois DBH en cours d’exécution, il peut être activé ou désactivé à l’aide de symopt +800000000 ou symopt -80000000, respectivement. Il peut également être activé et désactivé à l’aide des commandes détaillées activées et détaillées.