DBH Commands

Z příkazového řádku DBH můžete k analýze symbolů a souborů symbolů použít různé příkazy.

Následující tabulka uvádí příkazy, které řídí možnosti DBH a provádějí další základní úlohy.

Command	Effect
verbose [on|off]	Zapne nebo vypne podrobný režim. Bez parametru zobrazí aktuální nastavení podrobného režimu.
sympath [Path]	Nastaví cestu hledání symbolů. Bez parametru zobrazí aktuální cestu hledání symbolů.
symoptOptions symopt +Options symopt -Options symopt	Nastaví možnosti symbolu. 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. Bez parametru se zobrazí aktuální možnosti symbolů. Při spuštění dbH je výchozí hodnota všech možností symbolu 0x10C13. Seznam dostupných možností najdete v tématu Nastavení možností symbolů.
help	Zobrazí text nápovědy pro příkazy DBH.
quit	Ukončí program DBH.

Následující tabulka uvádí příkazy, které načítají, odkládají a znovu načítají cílový modul. Tyto příkazy nelze použít, pokud dbH byla spuštěna zadáním ID procesu na příkazovém řádku.

Command	Effect
loadFile	Načte zadaný modul. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Uvolní aktuální modul.
baseAddress	Nastaví výchozí základní adresu na zadanou hodnotu. Všechny adresy symbolů budou určeny vzhledem k této základní adrese.

Následující tabulka uvádí příkazy, které vyhledávají soubory a zobrazují informace o adresáři.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Vyhledá zadaný soubor .dbg v zadané cestě. Zahrnutí rozšíření .dbg je volitelné.
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	Vyhledá zadaný soubor v aktuální cestě symbolu.

Následující tabulka uvádí příkazy, které analyzují seznam modulů a řídí výchozí modul. Na příkazovém řádku DBH se zobrazí výchozí modul a jeho základní adresa.

Command	Effect
modAddress	Změní výchozí modul na modul se zadanou základní adresou.
refresh	Aktualizuje seznam modulů.
omap	Zobrazí struktury OMAP modulu.
epmodPID	Vytvoří výčet všech modulů načtených pro zadaný proces. PID specifies the process ID of the desired process.
info	Zobrazí informace o aktuálně načteném modulu.
objMask	Zobrazí seznam všech souborů objektů přidružených k výchozímu modulu, který odpovídá zadanému vzoru. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Zobrazí seznam všech zdrojových souborů přidružených k výchozímu modulu, který odpovídá zadanému vzoru. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	Vytvoří výčet všech načtených modulů. Vždy existuje alespoň jeden modul, pokud dbH neběží bez cíle, v takovém případě neexistuje žádný.

Následující tabulka uvádí příkazy, které zobrazují a hledají symboly.

Command	Effect
enumModule!Symbol	Vytvoří výčet všech symbolů odpovídajících zadanému modulu a symbolu. 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	Vytvoří výčet všech symbolů přidružených k zadané adrese.
addrAddress	Zobrazí podrobné informace o symbolech přidružených k zadané adrese.
name [Module!]Symbol	Zobrazí podrobné informace o zadaném symbolu. 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	Zobrazí podrobné informace o dalším symbolu za zadaným symbolem nebo adresou. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Zobrazí podrobné informace o prvním symbolu předcházejícím zadanému symbolu nebo adrese. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	Zobrazí šestnáctkovou adresu binární instrukce přidružené k zadanému zdrojovému řádku a všechny symboly přidružené k tomuto řádku. Nastaví také číslo aktuálního řádku, které se rovná zadanému číslu řádku. 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	Zobrazí soubory objektů přidružené k zadanému zdrojovému řádku a šestnáctkovou adresu binární instrukce přidružené k tomuto řádku. Nezmění číslo aktuálního řádku. 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	Zobrazí zdrojový soubor a číslo řádku odpovídající symbolu umístěnému na zadané adrese.
linenext	Zvýší číslo aktuálního řádku a zobrazí informace o novém čísle řádku.
lineprev	Sníží číslo aktuálního řádku a zobrazí informace o novém čísle řádku.
localsFunction [Mask]	Zobrazí všechny místní proměnné obsažené v zadané funkci. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Zobrazí podrobné informace o zadaném datovém typu. TypeName specifies the name of the data type (for example, WSTRING). Pokud název typu neodpovídá této hodnotě, zobrazí se jakýkoli odpovídající symbol. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Vytvoří výčet všech zdrojových řádků odpovídajících zadané zdrojové masce a masce objektu. 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. Pokud parametr vynecháte, je to ekvivalent použití zástupného znaku hvězdičky (). Pokud nechcete zadat informace o cestě, předpona názvu <souboru /strong> označující cestu se zástupným znakem.
indexValue	Zobrazí podrobné informace o symbolu se zadanou hodnotou indexu.
scopeAddress scope [Module!]Symbol	Zobrazí podrobné informace o nadřazené sadě zadaného symbolu. Symbol může být určen adresou nebo jménem.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Vyhledá všechny symboly, které odpovídají zadaným maskám. Symbol specifies the symbol name. Nesmí obsahovat název modulu, ale může obsahovat zástupné znaky a specifikátory; Podrobnosti najdete v tématu Syntaxe zástupných znaků řetězce . 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	Zobrazí informace o odvinutí funkce na zadané adrese.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	Vytvoří výčet všech datových typů.
dump	Zobrazí úplný seznam všech informací o symbolech v cílovém souboru.

Následující tabulka uvádí příkazy, které se vztahují k serverům symbolů a úložišti symbolů.

Command	Effect
home [Path]	Nastaví domovský adresář používaný SymSrv a SrcSrv pro výchozí podřízené úložiště. 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	Testuje, zda je zadaná cesta cestou úložiště symbolů.
srvindFile	Vyhledá index serveru symbolů, který odpovídá zadanému souboru. Index serveru symbolů je jedinečná hodnota založená na obsahu souboru bez ohledu na to, jestli se skutečně přidala do libovolného úložiště symbolů. File should specify the file name and absolute path of the desired file.
fiiFile	Zobrazí indexy serveru symbolů pro zadaný binární soubor a jeho přidružené soubory.
getfileFile Index	Zobrazí soubor se zadaným názvem a indexem serveru symbolů. 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	Ukládá soubor v úložišti symbolů na základě hodnot parametrů. 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	Přidá zadaný soubor do zadaného úložiště symbolů. Store should be the root path of the symbol store.

Následující tabulka uvádí příkazy DBH, které platí pro skutečné a imaginární symboly.

Command	Effect
undecName	Odhalí význam dekorací připojených k zadanému názvu symbolu. 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	Přidá zadaný imaginární symbol do seznamu symbolů načtených v 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. Symbol lze zadat buď jménem, nebo adresou. Tuto možnost nelze použít k odstranění skutečných symbolů.