DBH Commands

Från DBH-kommandoraden kan du använda en mängd olika kommandon för att analysera symboler och symbolfiler.

I följande tabell visas de kommandon som styr DBH-alternativen och utför andra grundläggande uppgifter.

Command	Effect
verbose [on|off]	Aktiverar eller inaktiverar utförligt läge. Utan parameter visar den aktuella utförliga lägesinställningen.
sympath [Path]	Anger sökvägen till symbolsökningen. Utan parameter visar den aktuella sökvägen för symbolen.
symoptOptions symopt +Options symopt -Options symopt	Anger symbolalternativen. 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. Utan parameter visas de aktuella symbolalternativen. När DBH startas är standardvärdet för alla symbolalternativ 0x10C13. En lista över tillgängliga alternativ finns i Ange symbolalternativ.
help	Visar hjälptext för DBH-kommandona.
quit	Avslutar DBH-programmet.

I följande tabell visas de kommandon som läser in, tar bort och ombaser målmodulen. Dessa kommandon kan inte användas om DBH startades genom att ange ett process-ID på kommandoraden.

Command	Effect
loadFile	Läser in den angivna modulen. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Tar bort den aktuella modulen.
baseAddress	Anger standardbasadressen till det angivna värdet. Alla symboladresser bestäms i förhållande till den här basadressen.

I följande tabell visas de kommandon som söker efter filer och visar kataloginformation.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Letar upp den angivna .dbg-filen i den angivna sökvägen. Det är valfritt att inkludera .dbg-tillägget.
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	Söker efter den angivna filen i den aktuella symbolsökvägen.

I följande tabell visas de kommandon som parsar modullistan och styr standardmodulen. Standardmodulen och dess basadress visas i DBH-prompten.

Command	Effect
modAddress	Ändrar standardmodulen till modulen med den angivna basadressen.
refresh	Uppdaterar modullistan.
omap	Visar modulens OMAP-strukturer.
epmodPID	Räknar upp alla moduler som lästs in för den angivna processen. PID specifies the process ID of the desired process.
info	Visar information om den inlästa modulen.
objMask	Visar en lista över alla objektfiler som är associerade med standardmodulen som matchar det angivna mönstret. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Visar en lista över alla källfiler som är associerade med standardmodulen som matchar det angivna mönstret. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	Räknar upp alla inlästa moduler. Det finns alltid minst en modul, såvida inte DBH körs utan mål, i vilket fall det inte finns några.

I följande tabell visas de kommandon som visar och söker efter symboler.

Command	Effect
enumModule!Symbol	Räknar upp alla symboler som matchar den angivna modulen och symbolen. 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	Räknar upp alla symboler som är associerade med den angivna adressen.
addrAddress	Visar detaljerad information om de symboler som är associerade med den angivna adressen.
name [Module!]Symbol	Visar detaljerad information om den angivna symbolen. 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	Visar detaljerad information om nästa symbol efter den angivna symbolen eller adressen. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Visar detaljerad information om den första symbolen före den angivna symbolen eller adressen. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	Visar hexadecimala adressen för den binära instruktion som är associerad med den angivna källlinjen och eventuella symboler som är associerade med den här raden. Anger även det aktuella radnumret lika med det angivna radnumret. 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	Visar objektfilerna som är associerade med den angivna källraden och hexadecimala adressen för den binära instruktion som är associerad med den här raden. Ändrar inte det aktuella radnumret. 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	Visar källfilen och radnumret som motsvarar symbolen som finns på den angivna adressen.
linenext	Ökar det aktuella radnumret och visar information om det nya radnumret.
lineprev	Minskar det aktuella radnumret och visar information om det nya radnumret.
localsFunction [Mask]	Visar alla lokala variabler som finns i den angivna funktionen. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Visar detaljerad information om den angivna datatypen. TypeName specifies the name of the data type (for example, WSTRING). Om inget typnamn matchar det här värdet visas en matchande symbol. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Räknar upp alla källrader som matchar den angivna källmasken och objektmasken. 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. Om en parameter utelämnas motsvarar detta att använda jokertecknet asterisk (). Om du inte vill ange sökvägsinformation prefixar du filnamnet med </strong> för att ange en sökväg med jokertecken.
indexValue	Visar detaljerad information om symbolen med det angivna indexvärdet.
scopeAddress scope [Module!]Symbol	Visar detaljerad information om den överordnade symbolen. Symbolen kan anges med adress eller efter namn.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Söker efter alla symboler som matchar de angivna maskerna. Symbol specifies the symbol name. Det bör inte innehålla modulnamnet, men det kan innehålla jokertecken och specificerare. Mer information finns i Strängsyntax för jokertecken . 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	Visar avspolningsinformationen för funktionen på den angivna adressen.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	Räknar upp alla datatyper.
dump	Visar en fullständig lista över all symbolinformation i målfilen.

I följande tabell visas de kommandon som är relaterade till symbolservrar och symbollager.

Command	Effect
home [Path]	Anger den hemkatalog som används av SymSrv och SrcSrv för standardlagringsplatsen. 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	Testar om den angivna sökvägen är sökvägen till ett symbolarkiv.
srvindFile	Hittar symbolserverindexet som motsvarar den angivna filen. Symbolserverindexet är ett unikt värde baserat på innehållet i filen, oavsett om det faktiskt har lagts till i något symbolarkiv. File should specify the file name and absolute path of the desired file.
fiiFile	Visar symbolserverindex för den angivna binära filen och dess associerade filer.
getfileFile Index	Visar filen med det angivna namnet och symbolserverindexet. 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	Lagrar en fil i ett symbolarkiv baserat på parametrarnas värden. 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	Lägger till den angivna filen i det angivna symbolarkivet. Store should be the root path of the symbol store.

I följande tabell visas de DBH-kommandon som gäller för verkliga och imaginära symboler.

Command	Effect
undecName	Visar innebörden av de dekorationer som är kopplade till det angivna symbolnamnet. 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	Lägger till den angivna imaginära symbolen i listan över symboler som lästs in i DBH. 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. Symbolen kan anges antingen efter namn eller adress. Detta kan inte användas för att ta bort verkliga symboler.