Comandos da DBH

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 de DBH e executam outras tarefas básicas.

Comando	Efeito
detalhado [ligado|desligado]	Ativa ou desativa o modo detalhado. Sem parâmetro, exibe a configuração atual do modo detalhado.
simpatia [Caminho]	Define o caminho de pesquisa do símbolo. Sem parâmetro, exibe o caminho de pesquisa de símbolo atual.
Opções symopt symopt + Opções symopt -Opções simopt	Define as opções de símbolo. + Sem ou -, o valor de Opções substitui as opções de símbolo atuais. Se + ou - for usado, Opções especifica as opções a serem adicionadas ou removidas; deve haver um espaço antes do + ou-, mas nenhum espaço depois dele. 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 Configurando opções de símbolo.
help	Exibe o texto de ajuda para os comandos DAB.
renunciar	Sai do programa DBH.

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

Comando	Efeito
carregar arquivo	Carrega o módulo especificado. O arquivo deve especificar o caminho, o nome do arquivo e a extensão do nome do arquivo executável ou do arquivo de símbolo.
descarregar	Descarrega o módulo atual.
Endereço base	Define o endereço base padrão para o valor especificado. Todos os endereços de símbolo serão determinados em relação a esse endereço base.

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

Comando	Efeito
Caminho do arquivo findexe	Localiza o arquivo executável especificado no caminho especificado, usando a rotina FindExecutableImage .
Caminho do arquivo finddbg	Localiza o arquivo .dbg especificado no caminho especificado. A inclusão da extensão .dbg é opcional.
Caminho do arquivo dir	Localiza o arquivo especificado no caminho especificado ou em qualquer subdiretório nesse caminho, usando a rotina EnumDirTree .
Arquivo de caminho srchtree	Localiza o arquivo especificado no caminho especificado ou em qualquer subdiretório nesse caminho, usando a rotina SearchTreeForFile . Este comando é o mesmo que dir, exceto que os parâmetros são invertidos.
Arquivo ffpath	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 do DAP.

Comando	Efeito
Endereço do mod	Altera o módulo padrão para o módulo com o endereço base especificado.
atualizar	Atualiza a lista de módulos.
omap	Exibe as estruturas OMAP do módulo.
epmod PID	Enumera todos os módulos carregados para o processo especificado. O PID especifica o ID do processo desejado.
info	Exibe informações sobre o módulo carregado no momento.
Máscara obj	Lista todos os arquivos de objeto associados ao módulo padrão que correspondem ao padrão especificado. A máscara pode conter uma variedade de caracteres curinga e especificadores; consulte Sintaxe curinga de cadeia de caracteres para obter detalhes.
máscara src	Lista todos os arquivos de origem associados ao módulo padrão que correspondem ao padrão especificado. A máscara pode conter uma variedade de caracteres curinga e especificadores; consulte Sintaxe curinga de cadeia de caracteres para obter detalhes.
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.

Comando	Efeito
enum Módulo!Símbolo	Enumera todos os símbolos que correspondem ao módulo e ao símbolo especificados. Module especifica o módulo a ser pesquisado (sem a extensão de nome de arquivo). Símbolo especifica um padrão que o símbolo deve conter. Tanto o Módulo quanto o Símbolo podem conter uma variedade de caracteres curinga e especificadores; consulte Sintaxe Curinga de Cadeia de Caracteres para obter detalhes.
enumaddr Endereço	Enumera todos os símbolos associados ao endereço especificado.
endereço addr	Exibe informações detalhadas sobre os símbolos associados ao endereço especificado.
nome [Módulo!]Símbolo	Exibe informações detalhadas sobre o símbolo especificado. Um especificador de módulo opcional pode ser incluído. Curingas não devem ser usados, pois se vários símbolos corresponderem ao padrão, o nome exibirá apenas o primeiro deles.
próximo [Módulo!]Símbolo próximo Endereço	Exibe informações detalhadas sobre o próximo símbolo após o símbolo ou endereço especificado. Se um símbolo for especificado pelo nome, um especificador de módulo opcional poderá ser incluído, mas curingas não devem ser usados.
prev [Módulo!]Símbolo prev Endereço	Exibe informações detalhadas sobre o primeiro símbolo antes do símbolo ou endereço especificado. Se um símbolo for especificado pelo nome, um especificador de módulo opcional poderá ser incluído, mas curingas não devem ser usados.
linha Arquivo#LineNum	Exibe o endereço hexadecimal da instrução binária associada à linha de origem especificada e todos os símbolos associados a essa linha. Também define o número da linha atual igual ao número da linha especificado. File especifica o nome do arquivo de origem e LineNum especifica o número da linha dentro desse arquivo; estes devem ser separados por um sinal numérico ( # ).
srclines Arquivo 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 especifica o nome do arquivo de origem e LineNum especifica o número da linha dentro desse arquivo; eles devem ser separados por um espaço.
laddr Endereço	Exibe o arquivo de origem e o número da linha correspondente ao símbolo localizado no endereço especificado.
linhapróximo	Incrementa o número da linha atual e exibe informações sobre o novo número da linha.
linhaprev	Diminui o número da linha atual e exibe informações sobre o novo número da linha.
locais Função [Máscara]	Exibe todas as variáveis locais contidas na função especificada. Se Mask estiver incluído, somente os locais que correspondem ao padrão especificado serão exibidos; consulte Sintaxe de curinga de string para obter detalhes.
digite TypeName	Exibe informações detalhadas sobre o tipo de dados especificado. TypeName especifica o nome do tipo de dados (por exemplo, WSTRING). Se nenhum nome de tipo corresponder a esse valor, qualquer símbolo correspondente será exibido. Ao contrário da maioria dos parâmetros de comando DBH, TypeName diferencia maiúsculas de minúsculas.
elines [Fonte [Obj]]	Enumera todas as linhas de origem que correspondem à máscara de origem e à máscara de objeto especificadas. Source especifica o nome do arquivo de origem, incluindo o caminho absoluto e a extensão do nome do arquivo. Obj especifica o nome do arquivo de objeto, incluindo o caminho relativo e a extensão do nome do arquivo. Tanto Source quanto Obj podem conter uma variedade de caracteres curinga e especificadores; consulte Sintaxe de curinga de cadeia de caracteres para obter detalhes. Se um parâmetro for omitido, isso equivale a usar o curinga asterisco (). Se você não quiser especificar informações de caminho, prefixe o nome do arquivo com </strong> para indicar um caminho curinga.
index Valor	Exibe informações detalhadas sobre o símbolo com o valor de índice especificado.
escopo Endereço escopo [Módulo!]Símbolo	Exibe informações detalhadas sobre o pai do símbolo especificado. O símbolo pode ser especificado por endereço ou por nome.
srch [máscara = Símbolo] [índice = Índice] [tag = Tag] [addr = Endereço] [globais]	Pesquisa todos os símbolos que correspondem às máscaras especificadas. Símbolo especifica o nome do símbolo. 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 especifica o endereço hexadecimal de um símbolo a ser usado como pai para a pesquisa. Tag especifica o valor do classificador de tipo de símbolo hexadecimal (SymTagXxx) que deve corresponder ao símbolo. Endereço especifica o endereço do símbolo. Se os globais forem incluídos, apenas os símbolos globais serão exibidos.
uw Endereço	Exibe as informações de desenrolamento da função no endereço especificado.
dtag	Exibe todos os valores do classificador de tipo de símbolo (SymTagXxx).
tipos	Enumera todos os tipos de dados.
dump	Exibe uma lista completa de todas as informações de símbolo no arquivo de destino.

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

Comando	Efeito
home [Caminho]	Define o diretório base usado por SymSrv e SrcSrv para o repositório downstream padrão. Se o caminho do símbolo contiver uma referência a um servidor de símbolos que usa um repositório downstream padrão, o subdiretório sym do diretório base será usado para o repositório downstream. Sem parâmetro, home exibe o diretório inicial atual.
Caminho srvpath	Testa se o caminho especificado é o caminho de um repositório de símbolos.
Arquivo srvind	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 repositório de símbolos. O arquivo deve especificar o nome do arquivo e o caminho absoluto do arquivo desejado.
fii Arquivo	Exibe os índices do servidor de símbolos para o arquivo binário especificado e seus arquivos associados.
Índice de arquivo getfile	Exibe o arquivo com o nome especificado e o índice do servidor de símbolos. File especifica o nome do arquivo desejado; isso não deve incluir seu caminho. Index especifica o índice do servidor de símbolos do arquivo desejado. O DBH usa a rotina SymFindFileInPath para pesquisar a árvore no caminho do símbolo atual para um arquivo com esse nome e esse índice.
sup Caminho Arquivo1 Arquivo2	Armazena um arquivo em um repositório de símbolos, com base nos valores dos parâmetros. Caminho especifica o caminho do diretório do repositório de símbolos. File1 e File2 são usados para criar um valor delta, que por sua vez é usado para determinar o arquivo que está sendo armazenado.
storeadd Armazenamento de arquivos	Adiciona o arquivo especificado ao repositório de símbolos especificado. Store deve ser o caminho raiz do repositório de símbolos.

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

Comando	Efeito
undec Nome	Revela o significado das decorações anexadas ao nome do símbolo especificado. O nome pode ser qualquer string; não precisa corresponder a um símbolo carregado no momento. Se Name contiver decorações C++, o significado dessas decorações será exibido.
adicionar nome tamanho do endereço	Adiciona o símbolo imaginário especificado à lista de símbolos carregados no DAP. Nome especifica o nome do símbolo a ser adicionado, Endereço especifica seu endereço hexadecimal e Tamanho seu tamanho hexadecimal em bytes. Isso é tratado como qualquer outro símbolo em comandos DBH posteriores, até que a sessão do DBH seja encerrada com quit ou unload, ou até que o símbolo imaginário seja excluído com del. O arquivo de símbolo de destino real não é alterado.
del Nome del Endereço	Exclui um símbolo imaginário adicionado anteriormente com o comando add . O símbolo pode ser especificado por nome ou por endereço. Isso não pode ser usado para excluir símbolos reais.