Commandes DBH

À partir de la ligne de commande DBH, vous pouvez utiliser diverses commandes pour analyser les symboles et les fichiers de symboles.

Le tableau suivant répertorie les commandes qui contrôlent les options DBH et effectuent d’autres tâches de base.

Commande	Effet
verbose [on|off]	Active ou désactive le mode détaillé. Sans paramètre, affiche le paramètre de mode détaillé actuel.
sympath [Chemin]	Définit le chemin de recherche de symboles. Sans paramètre, affiche le chemin de recherche des symboles actuel.
Options symopt symopt +Options symopt -Options symopt	Définit les options de symbole. + Sans ou -, la valeur d’Options remplace les options de symbole actuelles. Si + ou - est utilisé, Options spécifie les options à ajouter ou à supprimer ; il doit y avoir un espace avant ou + - sans espace après celui-ci. Sans paramètre, les options de symbole actuelles sont affichées. Lorsque DBH est lancé, la valeur par défaut de toutes les options de symboles est 0x10C13. Pour obtenir la liste des options disponibles, consultez Définition des options de symbole.
help	Affiche le texte d’aide des commandes DBH.
démissionner	Quitte le programme DBH.

Le tableau suivant répertorie les commandes qui chargent, déchargent et rebasent le module cible. Ces commandes ne peuvent pas être utilisées si DBH a été démarré en spécifiant un ID de processus sur la ligne de commande.

Commande	Effet
charger un fichier	Charge le module spécifié. Le fichier doit spécifier le chemin d’accès, le nom de fichier et l’extension de nom de fichier du fichier exécutable ou du fichier de symboles.
décharger	Décharge le module actuel.
adresse de base	Définit l’adresse de base par défaut sur la valeur spécifiée. Toutes les adresses de symboles sont déterminées par rapport à cette adresse de base.

Le tableau suivant répertorie les commandes qui recherchent des fichiers et affichent des informations de répertoire.

Commande	Effet
findexe File Path	Localise le fichier exécutable spécifié dans le chemin d’accès spécifié, à l’aide de la routine FindExecutableImage .
finddbg File Path	Localise le fichier .dbg spécifié dans le chemin d’accès spécifié. L’inclusion de l’extension .dbg est facultative.
chemin d’accès au fichier dir	Localise le fichier spécifié dans le chemin d’accès spécifié ou dans n’importe quel sous-répertoire sous ce chemin, à l’aide de la routine EnumDirTree .
fichier de chemin d’accès srchtree	Localise le fichier spécifié dans le chemin d’accès spécifié ou dans n’importe quel sous-répertoire sous ce chemin, à l’aide de la routine SearchTreeForFile . Cette commande est identique à dir, sauf que les paramètres sont inversés.
ffpath File	Recherche le fichier spécifié dans le chemin d’accès du symbole actuel.

Le tableau suivant répertorie les commandes qui analysent la liste des modules et contrôlent le module par défaut. Le module par défaut et son adresse de base s’affichent à l’invite DBH.

Commande	Effet
mod Address	Remplace le module par défaut par l’adresse de base spécifiée.
refresh	Actualise la liste des modules.
omap	Affiche les structures OMAP du module.
epmod PID	Énumère tous les modules chargés pour le processus spécifié. PID spécifie l’ID de processus du processus souhaité.
info	Affiche des informations sur le module actuellement chargé.
obj Mask	Répertorie tous les fichiers objet associés au module par défaut qui correspondent au modèle spécifié. Le masque peut contenir un large éventail de caractères génériques et de spécificateurs . Pour plus d’informations, consultez la syntaxe de caractères génériques de chaîne.
masque src	Répertorie tous les fichiers sources associés au module par défaut qui correspondent au modèle spécifié. Le masque peut contenir un large éventail de caractères génériques et de spécificateurs . Pour plus d’informations, consultez la syntaxe de caractères génériques de chaîne.
énumération	Énumère tous les modules chargés. Il existe toujours au moins un module, sauf si DBH s’exécute sans cible, auquel cas il n’existe aucun module.

Le tableau suivant répertorie les commandes qui affichent et recherchent des symboles.

Commande	Effet
module d’énumération !Symbole	Énumère tous les symboles correspondant au module et au symbole spécifiés. Le module spécifie le module à rechercher (sans l’extension de nom de fichier). Le symbole spécifie un modèle que le symbole doit contenir. Module et Symbole peuvent contenir une variété de caractères génériques et de spécificateurs. Pour plus d’informations, consultez la syntaxe de caractères génériques de chaîne.
adresse enumaddr	Énumère tous les symboles associés à l’adresse spécifiée.
Adresse du module complémentaire	Affiche des informations détaillées sur les symboles associés à l’adresse spécifiée.
name [Module !]Symbole	Affiche des informations détaillées sur le symbole spécifié. Un spécificateur de module facultatif peut être inclus. Les caractères génériques ne doivent pas être utilisés, car si plusieurs symboles correspondent au modèle, le nom affiche uniquement le premier d’entre eux.
suivant [Module !]Symbole adresse suivante	Affiche des informations détaillées sur le symbole suivant après le symbole ou l’adresse spécifié. Si un symbole est spécifié par nom, un spécificateur de module facultatif peut être inclus, mais les caractères génériques ne doivent pas être utilisés.
prév [Module !]Symbole adresse préliminaire	Affiche des informations détaillées sur le premier symbole précédent le symbole ou l’adresse spécifiés. Si un symbole est spécifié par nom, un spécificateur de module facultatif peut être inclus, mais les caractères génériques ne doivent pas être utilisés.
line File#LineNum	Affiche l’adresse hexadécimale de l’instruction binaire associée à la ligne source spécifiée et tous les symboles associés à cette ligne. Définit également le numéro de ligne actuel égal au numéro de ligne spécifié. Le fichier spécifie le nom du fichier source et LineNum spécifie le numéro de ligne dans ce fichier ; ceux-ci doivent être séparés par un signe numérique ( # ).
srclines FileNum	Affiche les fichiers objet associés à la ligne source spécifiée et l’adresse hexadécimale de l’instruction binaire associée à cette ligne. Ne modifie pas le numéro de ligne actuel. Le fichier spécifie le nom du fichier source et LineNum spécifie le numéro de ligne au sein de ce fichier ; ceux-ci doivent être séparés par un espace.
adresse laddr	Affiche le fichier source et le numéro de ligne correspondant au symbole situé à l’adresse spécifiée.
linenext	Incrémente le numéro de ligne actuel et affiche des informations sur le nouveau numéro de ligne.
lineprev	Décrémente le numéro de ligne actuel et affiche des informations sur le nouveau numéro de ligne.
fonction locals [Mask]	Affiche toutes les variables locales contenues dans la fonction spécifiée. Si Mask est inclus, seuls les locaux correspondant au modèle spécifié sont affichés . Pour plus d’informations, consultez la syntaxe de caractères génériques de chaîne.
type TypeName	Affiche des informations détaillées sur le type de données spécifié. TypeName spécifie le nom du type de données (par exemple, WSTRING). Si aucun nom de type ne correspond à cette valeur, tout symbole correspondant est affiché. Contrairement à la plupart des paramètres de commande DBH, TypeName respecte la casse.
elines [Source [Obj]]	Énumère toutes les lignes sources correspondant au masque source et au masque d’objet spécifiés. La source spécifie le nom du fichier source, y compris le chemin d’accès absolu et l’extension de nom de fichier. Obj spécifie le nom du fichier objet, y compris le chemin d’accès relatif et l’extension de nom de fichier. Source et Obj peuvent contenir une variété de caractères génériques et de spécificateurs. Pour plus d’informations, consultez la syntaxe de caractères génériques de chaîne. Si un paramètre est omis, cela équivaut à utiliser le caractère générique astérisque (). Si vous ne souhaitez pas spécifier d’informations de chemin d’accès, préfixez le nom de fichier par </strong> pour indiquer un chemin générique.
valeur d’index	Affiche des informations détaillées sur le symbole avec la valeur d’index spécifiée.
Adresse d’étendue scope [Module !]Symbole	Affiche des informations détaillées sur le parent du symbole spécifié. Le symbole peut être spécifié par adresse ou par nom.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Recherche tous les symboles qui correspondent aux masques spécifiés. Le symbole spécifie le nom du symbole. Il ne doit pas inclure le nom du module, mais il peut contenir des caractères génériques et des spécificateurs ; pour plus d’informations, consultez syntaxe de caractères génériques de chaîne. Index spécifie l’adresse hexadécimale d’un symbole à utiliser comme parent pour la recherche. La balise spécifie la valeur classifieur de type de symbole hexadécimal (SymTagXxx) qui doit correspondre au symbole. L’adresse spécifie l’adresse du symbole. Si les globals sont inclus, seuls les symboles globaux sont affichés.
Adresse uw	Affiche les informations de déroulement de la fonction à l’adresse spécifiée.
dtag	Affiche toutes les valeurs de classifieur de type de symbole (SymTagXxx).
etypes	Énumère tous les types de données.
dump	Affiche une liste complète de toutes les informations de symbole dans le fichier cible.

Le tableau suivant répertorie les commandes relatives aux serveurs de symboles et aux magasins de symboles.

Commande	Effet
home [Path]	Définit le répertoire de base utilisé par SymSrv et SrcSrv pour le magasin en aval par défaut. Si le chemin d’accès aux symboles contient une référence à un serveur de symboles qui utilise un magasin en aval par défaut, le sous-répertoire sym du répertoire de base sera utilisé pour le magasin en aval. Sans paramètre, la page d’accueil affiche le répertoire d’accueil actuel.
chemin srvpath	Teste si le chemin spécifié est le chemin d’accès d’un magasin de symboles.
fichier srvind	Recherche l’index du serveur de symboles qui correspond au fichier spécifié. L’index du serveur de symboles est une valeur unique basée sur le contenu du fichier, qu’il soit réellement ajouté à un magasin de symboles. Le fichier doit spécifier le nom de fichier et le chemin absolu du fichier souhaité.
fichier fii	Affiche les index de serveur de symboles pour le fichier binaire spécifié et ses fichiers associés.
getfile File Index	Affiche le fichier avec le nom et l’index de serveur de symboles spécifiés. Le fichier spécifie le nom du fichier souhaité ; il ne doit pas inclure son chemin d’accès. Index spécifie l’index du serveur de symboles du fichier souhaité. DBH utilise la routine SymFindFileInPath pour rechercher l’arborescence sous le chemin d’accès de symbole actuel d’un fichier portant ce nom et cet index.
sup Path File1 File2	Stocke un fichier dans un magasin de symboles, en fonction des valeurs des paramètres. Chemin d’accès spécifie le chemin d’accès au répertoire du magasin de symboles. File1 et File2 sont utilisés pour créer une valeur delta, qui est à son tour utilisée pour déterminer le fichier stocké.
storeadd File Store	Ajoute le fichier spécifié au magasin de symboles spécifié. Le magasin doit être le chemin racine du magasin de symboles.

Le tableau suivant répertorie les commandes DBH qui s’appliquent aux symboles réels et imaginaires.

Commande	Effet
undec Name	Révèle la signification des décorations attachées au nom de symbole spécifié. Le nom peut être n’importe quelle chaîne ; il n’a pas besoin de correspondre à un symbole actuellement chargé. Si Name contient des décorations C++, la signification de ces décorations est affichée.
ajouter une taille d’adresse de nom	Ajoute le symbole imaginaire spécifié à la liste des symboles chargés dans DBH. Le nom spécifie le nom du symbole à ajouter, l’adresse spécifie son adresse hexadécimale et la taille hexadécimale en octets. Cela est traité comme n’importe quel autre symbole dans les commandes DBH ultérieures, jusqu’à ce que la session DBH se termine par quitter ou décharger, ou jusqu’à ce que le symbole imaginaire soit supprimé avec del. Le fichier de symboles cible réel n’est pas modifié.
del Name del Address	Supprime un symbole imaginaire précédemment ajouté avec la commande Add . Le symbole peut être spécifié par nom ou par adresse. Cela ne peut pas être utilisé pour supprimer des symboles réels.