DBH Commands

Über die Befehlszeile von DBH können Sie eine Vielzahl von Befehlen verwenden, um Symbole und Symboldateien zu analysieren.

In der folgenden Tabelle sind die Befehle aufgeführt, die die DBH-Optionen steuern und andere grundlegende Aufgaben ausführen.

Command	Effect
verbose [on|off]	Aktiviert oder deaktiviert den ausführlichen Modus. Ohne Parameter wird die aktuelle ausführliche Moduseinstellung angezeigt.
sympath [Path]	Legt den Suchpfad des Symbols fest. Ohne Parameter wird der aktuelle Suchpfad für Symbole angezeigt.
symoptOptions symopt +Options symopt -Options symopt	Legt die Symboloptionen fest. With no + or -, the value of Options replaces the current symbol options. If + or - is used, Options specifies the options to be added or removed; there must be a space before the + or - but no space after it. Ohne Parameter werden die aktuellen Symboloptionen angezeigt. Wenn DBH gestartet wird, wird der Standardwert aller Symboloptionen 0x10C13. Eine Liste der verfügbaren Optionen finden Sie unter Festlegen von Symboloptionen.
help	Zeigt Hilfetext für die DBH-Befehle an.
quit	Beendet das DBH-Programm.

In der folgenden Tabelle sind die Befehle aufgeführt, die das Zielmodul laden, entladen und neu basen. Diese Befehle können nicht verwendet werden, wenn DBH durch Angeben einer Prozess-ID in der Befehlszeile gestartet wurde.

Command	Effect
loadFile	Lädt das angegebene Modul. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Entladen des aktuellen Moduls.
baseAddress	Legt die Standardbasisadresse auf den angegebenen Wert fest. Alle Symboladressen werden relativ zu dieser Basisadresse bestimmt.

In der folgenden Tabelle sind die Befehle aufgeführt, die nach Dateien suchen und Verzeichnisinformationen anzeigen.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Sucht die angegebene DBG-Datei im angegebenen Pfad. Das Einschließen der DBG-Erweiterung ist optional.
dirFile Path	Locates the specified file in the specified path or in any subdirectory under this path, using the EnumDirTree routine.
srchtreePath File	Locates the specified file in the specified path or in any subdirectory under this path, using the SearchTreeForFile routine. This command is the same as dir, except that the parameters are reversed.
ffpathFile	Sucht die angegebene Datei im aktuellen Symbolpfad.

In der folgenden Tabelle sind die Befehle aufgeführt, die die Modulliste analysieren und das Standardmodul steuern. Das Standardmodul und seine Basisadresse werden in der DBH-Eingabeaufforderung angezeigt.

Command	Effect
modAddress	Ändert das Standardmodul in das Modul mit der angegebenen Basisadresse.
refresh	Aktualisiert die Modulliste.
omap	Zeigt die OMAP-Strukturen des Moduls an.
epmodPID	Listet alle Module auf, die für den angegebenen Prozess geladen wurden. PID specifies the process ID of the desired process.
info	Zeigt Informationen zum aktuell geladenen Modul an.
objMask	Listet alle Objektdateien auf, die dem Standardmodul zugeordnet sind, das dem angegebenen Muster entspricht. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Listet alle Quelldateien auf, die dem Standardmodul zugeordnet sind, das dem angegebenen Muster entspricht. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	Listet alle geladenen Module auf. Es gibt immer mindestens ein Modul, es sei denn, DBH wird ohne Ziel ausgeführt, in diesem Fall gibt es keine.

In der folgenden Tabelle sind die Befehle aufgeführt, die symbole anzeigen und suchen.

Command	Effect
enumModule!Symbol	Listet alle Symbole auf, die dem angegebenen Modul und Symbol entsprechen. Module specifies the module to search (without the file name extension). Symbol specifies a pattern that the symbol must contain. Both Module and Symbol may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enumaddrAddress	Listet alle Symbole auf, die der angegebenen Adresse zugeordnet sind.
addrAddress	Zeigt detaillierte Informationen zu den Symbolen an, die der angegebenen Adresse zugeordnet sind.
name [Module!]Symbol	Zeigt detaillierte Informationen zum angegebenen Symbol an. An optional Module specifier may be included. Wildcards should not be used, because if multiple symbols match the pattern, name only displays the first of them.
next [Module!]Symbol nextAddress	Zeigt detaillierte Informationen zum nächsten Symbol nach dem angegebenen Symbol oder der angegebenen Adresse an. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Zeigt detaillierte Informationen zum ersten Symbol vor dem angegebenen Symbol oder der angegebenen Adresse an. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	Zeigt die hexadezimale Adresse der binären Anweisung an, die der angegebenen Quellzeile zugeordnet ist, und alle Symbole, die dieser Zeile zugeordnet sind. Legt außerdem die aktuelle Zeilennummer gleich der angegebenen Zeilennummer fest. File specifies the name of the source file, and LineNum specifies the line number within that file; these should be separated with a number sign ( # ).
srclinesFile LineNum	Zeigt die Objektdateien an, die der angegebenen Quellzeile zugeordnet sind, und die hexadezimale Adresse der binären Anweisung, die dieser Zeile zugeordnet ist. Ändert nicht die aktuelle Zeilennummer. File specifies the name of the source file, and LineNum specifies the line number within that file; these should be separated with a space.
laddrAddress	Zeigt die Quelldatei und die Zeilennummer an, die dem Symbol entspricht, das sich an der angegebenen Adresse befindet.
linenext	Erhöht die aktuelle Zeilennummer und zeigt Informationen zur neuen Zeilennummer an.
lineprev	Erhöht die aktuelle Zeilennummer und zeigt Informationen zur neuen Zeilennummer an.
localsFunction [Mask]	Zeigt alle lokalen Variablen an, die in der angegebenen Funktion enthalten sind. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Zeigt detaillierte Informationen zum angegebenen Datentyp an. TypeName specifies the name of the data type (for example, WSTRING). Wenn kein Typname mit diesem Wert übereinstimmt, wird ein entsprechendes Symbol angezeigt. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Listet alle Quellzeilen auf, die dem angegebenen Quellformat und -objektformat entsprechen. Source specifies the name of the source file, including the absolute path and file name extension. Obj specifies the name of the object file, including the relative path and file name extension. Both Source and Obj may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details. Wenn ein Parameter weggelassen wird, entspricht dies der Verwendung des Sternchens () des Wildcards. Wenn Sie keine Pfadinformationen angeben möchten, stellen Sie dem Dateinamen <das Präfix "/strong> " voran, um einen Wildcardpfad anzugeben.
indexValue	Zeigt detaillierte Informationen zum Symbol mit dem angegebenen Indexwert an.
scopeAddress scope [Module!]Symbol	Zeigt detaillierte Informationen zum übergeordneten Element des angegebenen Symbols an. Das Symbol kann anhand der Adresse oder des Namens angegeben werden.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Sucht nach allen Symbolen, die den angegebenen Masken entsprechen. Symbol specifies the symbol name. Er sollte nicht den Modulnamen enthalten, kann aber Auch Wildcardzeichen und Bezeichner enthalten; Weitere Informationen finden Sie unter String Wildcard Syntax . Index specifies the hexadecimal address of a symbol to be used as the parent for the search. Tag specifies the hexadecimal symbol type classifier (SymTagXxx) value that must match the symbol. Address specifies the address of the symbol. If globals is included, only global symbols will be displayed.
uwAddress	Zeigt die Abspanninformationen für die Funktion an der angegebenen Adresse an.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	Listet alle Datentypen auf.
dump	Zeigt eine vollständige Liste aller Symbolinformationen in der Zieldatei an.

In der folgenden Tabelle sind die Befehle aufgeführt, die sich auf Symbolserver und Symbolspeicher beziehen.

Command	Effect
home [Path]	Legt das Startverzeichnis fest, das von SymSrv und SrcSrv für den Standard-Downstreamspeicher verwendet wird. If the symbol path contains a reference to a symbol server that uses a default downstream store, then the sym subdirectory of the home directory will be used for the downstream store. With no parameter, home displays the current home directory.
srvpathPath	Überprüft, ob der angegebene Pfad der Pfad eines Symbolspeichers ist.
srvindFile	Sucht den Symbolserverindex, der der angegebenen Datei entspricht. Der Symbolserverindex ist ein eindeutiger Wert, der auf dem Inhalt der Datei basiert, unabhängig davon, ob er tatsächlich einem Symbolspeicher hinzugefügt wurde. File should specify the file name and absolute path of the desired file.
fiiFile	Zeigt die Symbolserverindizes für die angegebene Binärdatei und die zugehörigen Dateien an.
getfileFile Index	Zeigt die Datei mit dem angegebenen Namen und dem Symbolserverindex an. File specifies the name of the desired file; this should not include its path. Index specifies the symbol server index of the desired file. DBH uses the SymFindFileInPath routine to search the tree under the current symbol path for a file with this name and this index.
supPath File1 File2	Speichert eine Datei in einem Symbolspeicher basierend auf den Werten der Parameter. Path specifies the directory path of the symbol store. File1 and File2 are used to create a delta value, which is in turn used to determine the file being stored.
storeaddFile Store	Fügt die angegebene Datei dem angegebenen Symbolspeicher hinzu. Store should be the root path of the symbol store.

In der folgenden Tabelle sind die DBH-Befehle aufgeführt, die auf reale und imaginäre Symbole angewendet werden.

Command	Effect
undecName	Zeigt die Bedeutung der Dekorationen an, die mit dem angegebenen Symbolnamen verbunden sind. Name can be any string; it need not correspond to a currently loaded symbol. If Name contains C++ decorations, the meaning of these decorations is displayed.
addName Address Size	Fügt das angegebene imaginäre Symbol zur Liste der in DBH geladenen Symbole hinzu. Name specifies the name of the symbol to be added, Address specifies its hexadecimal address, and Size its hexadecimal size in bytes. This is treated like any other symbol in later DBH commands, until the DBH session is ended with quit or unload, or until the imaginary symbol is deleted with del. The actual target symbol file is not altered.
delName delAddress	Deletes an imaginary symbol previously added with the add command. Das Symbol kann entweder anhand des Namens oder der Adresse angegeben werden. Dies kann nicht verwendet werden, um echte Symbole zu löschen.