DBH Commands

Na linha de comando DBH, você pode usar uma variedade de comandos para analisar símbolos e arquivos de símbolos.

A tabela a seguir lista os comandos que controlam as opções do DBH e executam outras tarefas básicas.

Command	Effect
verbose [on|off]	Ativa ou desativa o modo detalhado. Sem parâmetro, exibe a configuração atual do modo detalhado.
sympath [Path]	Define o caminho de pesquisa do símbolo. Sem parâmetro, exibe o caminho de pesquisa do símbolo atual.
symoptOptions symopt +Options symopt -Options symopt	Define as opções de símbolo. 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. Sem parâmetro, as opções de símbolo atuais são exibidas. Quando o DBH é iniciado, o valor padrão de todas as opções de símbolo é 0x10C13. Para obter uma lista de opções disponíveis, consulte Definindo opções de símbolo.
help	Exibe o texto de ajuda para os comandos DBH.
quit	Encerra o programa DBH.

A tabela a seguir lista os comandos que carregam, descarregam e rebaseiam o módulo de destino. Esses comandos não podem ser usados se o DBH foi iniciado especificando um ID de processo na linha de comando.

Command	Effect
loadFile	Carrega o módulo especificado. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Descarrega o módulo atual.
baseAddress	Define o endereço base padrão para o valor especificado. Todos os endereços de símbolos serão determinados em relação a este endereço base.

A tabela a seguir lista os comandos que pesquisam arquivos e exibem informações de diretório.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Localiza o arquivo .dbg especificado no caminho especificado. Incluir a extensão .dbg é opcional.
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	Localiza o arquivo especificado no caminho do símbolo atual.

A tabela a seguir lista os comandos que analisam a lista de módulos e controlam o módulo padrão. O módulo padrão e seu endereço base são exibidos no prompt DBH.

Command	Effect
modAddress	Altera o módulo padrão para o módulo com o endereço base especificado.
refresh	Atualiza a lista de módulos.
omap	Exibe as estruturas OMAP do módulo.
epmodPID	Enumera todos os módulos carregados para o processo especificado. PID specifies the process ID of the desired process.
info	Exibe informações sobre o módulo carregado no momento.
objMask	Lista todos os arquivos de objeto associados ao módulo padrão que correspondem ao padrão especificado. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Lista todos os arquivos de origem associados ao módulo padrão que correspondem ao padrão especificado. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	Enumera todos os módulos carregados. Há sempre pelo menos um módulo, a menos que o DBH esteja sendo executado sem um destino, caso em que não há nenhum.

A tabela a seguir lista os comandos que exibem e pesquisam símbolos.

Command	Effect
enumModule!Symbol	Enumera todos os símbolos correspondentes ao módulo e símbolo especificados. 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	Enumera todos os símbolos associados ao endereço especificado.
addrAddress	Exibe informações detalhadas sobre os símbolos associados ao endereço especificado.
name [Module!]Symbol	Exibe informações detalhadas sobre o símbolo especificado. 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	Exibe informações detalhadas sobre o próximo símbolo após o símbolo ou endereço especificado. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Exibe informações detalhadas sobre o primeiro símbolo anterior ao símbolo ou endereço especificado. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	Exibe o endereço hexadecimal da instrução binária associada à linha de origem especificada e quaisquer símbolos associados a essa linha. Também define o número de linha atual igual ao número de linha especificado. 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	Exibe os arquivos de objeto associados à linha de origem especificada e o endereço hexadecimal da instrução binária associada a essa linha. Não altera o número da linha atual. 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	Exibe o arquivo de origem e o número da linha correspondente ao símbolo localizado no endereço especificado.
linenext	Incrementa o número da linha atual e exibe informações sobre o novo número de linha.
lineprev	Diminui o número da linha atual e exibe informações sobre o novo número de linha.
localsFunction [Mask]	Exibe todas as variáveis locais contidas na função especificada. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Exibe informações detalhadas sobre o tipo de dados especificado. TypeName specifies the name of the data type (for example, WSTRING). Se nenhum nome de tipo corresponder a esse valor, qualquer símbolo correspondente será exibido. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Enumera todas as linhas de origem correspondentes à máscara de origem especificada e à máscara de objeto. 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. Se um parâmetro for omitido, isso equivale a usar o curinga asterisco (). Se você não desejar especificar informações de caminho, prefixe o nome do arquivo com </strong> para indicar um caminho curinga.
indexValue	Exibe informações detalhadas sobre o símbolo com o valor de índice especificado.
scopeAddress scope [Module!]Symbol	Exibe informações detalhadas sobre o pai do símbolo especificado. O símbolo pode ser especificado pelo endereço ou pelo nome.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Procura todos os símbolos que correspondem às máscaras especificadas. Symbol specifies the symbol name. Ele não deve incluir o nome do módulo, mas pode conter caracteres curinga e especificadores; consulte Sintaxe curinga de cadeia de caracteres para obter detalhes. 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	Exibe as informações de desenrolar para a função no endereço especificado.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	Enumera todos os tipos de dados.
dump	Exibe uma lista completa de todas as informações de símbolos no arquivo de destino.

A tabela a seguir lista os comandos relacionados a servidores de símbolos e repositórios de símbolos.

Command	Effect
home [Path]	Define o diretório base usado por SymSrv e SrcSrv para o armazenamento downstream padrão. 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	Testa se o caminho especificado é o caminho de um repositório de símbolos.
srvindFile	Localiza o índice do servidor de símbolos que corresponde ao arquivo especificado. O índice do servidor de símbolos é um valor exclusivo baseado no conteúdo do arquivo, independentemente de ele realmente ter sido adicionado a qualquer armazenamento de símbolos. File should specify the file name and absolute path of the desired file.
fiiFile	Exibe os índices do servidor de símbolos para o arquivo binário especificado e seus arquivos associados.
getfileFile Index	Exibe o arquivo com o nome especificado e o índice do servidor de símbolos. 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	Armazena um arquivo em um repositório de símbolos, com base nos valores dos parâmetros. 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	Adiciona o arquivo especificado ao repositório de símbolos especificado. Store should be the root path of the symbol store.

A tabela a seguir lista os comandos DBH que se aplicam a símbolos reais e imaginários.

Command	Effect
undecName	Revela o significado das decorações anexadas ao nome do símbolo especificado. 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	Adiciona o símbolo imaginário especificado à lista de símbolos carregados no 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. O símbolo pode ser especificado pelo nome ou pelo endereço. Isso não pode ser usado para excluir símbolos reais.