DBH Commands

Z poziomu wiersza polecenia DBH można użyć różnych poleceń do analizowania symboli i plików symboli.

W poniższej tabeli wymieniono polecenia kontrolujące opcje DBH i wykonujące inne podstawowe zadania.

Command	Effect
verbose [on|off]	Włącza lub wyłącza tryb pełny. Bez parametru wyświetla bieżące ustawienie trybu pełnego.
sympath [Path]	Ustawia ścieżkę wyszukiwania symboli. Bez parametru wyświetla bieżącą ścieżkę wyszukiwania symboli.
symoptOptions symopt +Options symopt -Options symopt	Ustawia opcje symboli. 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 są wyświetlane bieżące opcje symboli. Po uruchomieniu funkcji DBH wartość domyślna wszystkich opcji symboli jest 0x10C13. Aby uzyskać listę dostępnych opcji, zobacz Ustawianie opcji symboli.
help	Wyświetla tekst pomocy dla poleceń DBH.
quit	Zamyka program DBH.

W poniższej tabeli wymieniono polecenia, które ładują, zwalniają i bazą danych modułu docelowego. Tych poleceń nie można użyć, jeśli funkcja DBH została uruchomiona, określając identyfikator procesu w wierszu polecenia.

Command	Effect
loadFile	Ładuje określony moduł. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Zwalnia bieżący moduł.
baseAddress	Ustawia domyślny adres podstawowy na określoną wartość. Wszystkie adresy symboli zostaną określone względem tego adresu podstawowego.

W poniższej tabeli wymieniono polecenia, które wyszukują pliki i wyświetlają informacje o katalogu.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Lokalizuje określony plik dbg w określonej ścieżce. Dołączenie rozszerzenia dbg jest opcjonalne.
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	Znajduje określony plik w bieżącej ścieżce symboli.

W poniższej tabeli wymieniono polecenia, które analizują listę modułów i kontrolują domyślny moduł. Domyślny moduł i jego adres podstawowy są wyświetlane w wierszu polecenia DBH.

Command	Effect
modAddress	Zmienia domyślny moduł na moduł przy użyciu określonego adresu podstawowego.
refresh	Odświeża listę modułów.
omap	Wyświetla struktury OMAP modułu.
epmodPID	Wylicza wszystkie moduły załadowane dla określonego procesu. PID specifies the process ID of the desired process.
info	Wyświetla informacje o aktualnie załadowanym module.
objMask	Wyświetla listę wszystkich plików obiektów skojarzonych z modułem domyślnym, który jest zgodny z określonym wzorcem. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Wyświetla listę wszystkich plików źródłowych skojarzonych z modułem domyślnym, który jest zgodny z określonym wzorcem. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	Wylicza wszystkie załadowane moduły. Zawsze istnieje co najmniej jeden moduł, chyba że baza danych jest uruchomiona bez elementu docelowego, w tym przypadku nie ma żadnego.

W poniższej tabeli wymieniono polecenia, które wyświetlają i wyszukują symbole.

Command	Effect
enumModule!Symbol	Wylicza wszystkie symbole pasujące do określonego modułu i 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	Wylicza wszystkie symbole skojarzone z określonym adresem.
addrAddress	Wyświetla szczegółowe informacje o symbolach skojarzonych z określonym adresem.
name [Module!]Symbol	Wyświetla szczegółowe informacje o określonym 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	Wyświetla szczegółowe informacje o następnym symbolu po określonym symbolu lub adresie. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Wyświetla szczegółowe informacje na temat pierwszego symbolu poprzedniego do określonego symbolu lub adresu. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	Wyświetla adres szesnastkowy instrukcji binarnej skojarzonej z określonym wierszem źródłowym i wszelkie symbole skojarzone z tym wierszem. Ustawia również bieżący numer wiersza równy określonej liczbie wierszy. 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	Wyświetla pliki obiektów skojarzone z określonym wierszem źródłowym oraz adres szesnastkowy instrukcji binarnej skojarzonej z tym wierszem. Nie zmienia bieżącego numeru wiersza. 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	Wyświetla plik źródłowy i numer wiersza odpowiadający symbolowi znajdującemu się pod określonym adresem.
linenext	Zwiększa bieżący numer wiersza i wyświetla informacje o nowym numerze wiersza.
lineprev	Dekrementuje bieżący numer wiersza i wyświetla informacje o nowym numerze wiersza.
localsFunction [Mask]	Wyświetla wszystkie zmienne lokalne zawarte w określonej funkcji. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Wyświetla szczegółowe informacje o określonym typie danych. TypeName specifies the name of the data type (for example, WSTRING). Jeśli żadna nazwa typu nie pasuje do tej wartości, zostanie wyświetlony dowolny pasujący symbol. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Wylicza wszystkie wiersze źródłowe pasujące do określonej maski źródłowej i maski obiektu. 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. Jeśli parametr zostanie pominięty, jest to równoważne użyciu symbolu wieloznakowego gwiazdki (). Jeśli nie chcesz określać informacji o ścieżce, prefiks nazwy pliku z </strong> , aby wskazać ścieżkę z symbolami wieloznacznymi.
indexValue	Wyświetla szczegółowe informacje o symbolu z określoną wartością indeksu.
scopeAddress scope [Module!]Symbol	Wyświetla szczegółowe informacje o obiekcie nadrzędnym określonego symbolu. Symbol może być określony przez adres lub nazwę.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Wyszukuje wszystkie symbole zgodne z określonymi maskami. Symbol specifies the symbol name. Nie powinien zawierać nazwy modułu, ale może zawierać symbole wieloznaczne i specyfikatory; Aby uzyskać szczegółowe informacje, zobacz Składnia symboli wieloznacznych ciągów . 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	Wyświetla informacje o odwijeniu funkcji pod określonym adresem.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	Wylicza wszystkie typy danych.
dump	Wyświetla pełną listę wszystkich informacji o symbolach w pliku docelowym.

W poniższej tabeli wymieniono polecenia powiązane z serwerami symboli i magazynami symboli.

Command	Effect
home [Path]	Ustawia katalog macierzysty używany przez SymSrv i SrcSrv dla domyślnego magazynu podrzędnego. 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	Sprawdza, czy określona ścieżka jest ścieżką magazynu symboli.
srvindFile	Znajduje indeks serwera symboli odpowiadający określonemu plikowi. Indeks serwera symboli jest unikatową wartością opartą na zawartości pliku, niezależnie od tego, czy faktycznie został on dodany do dowolnego magazynu symboli. File should specify the file name and absolute path of the desired file.
fiiFile	Wyświetla indeksy serwera symboli dla określonego pliku binarnego i skojarzonych z nim plików.
getfileFile Index	Wyświetla plik o określonej nazwie i indeksie serwera symboli. 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	Przechowuje plik w magazynie symboli na podstawie wartości parametrów. 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	Dodaje określony plik do określonego magazynu symboli. Store should be the root path of the symbol store.

W poniższej tabeli wymieniono polecenia DBH, które mają zastosowanie do rzeczywistych i wyimaginowanych symboli.

Command	Effect
undecName	Ujawnia znaczenie dekoracji dołączonych do określonej nazwy 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	Dodaje określony symbol wyimaginowany do listy symboli załadowanych w bazie danych 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 można określić według nazwy lub adresu. Nie można jej użyć do usunięcia rzeczywistych symboli.