Comandi DBH

Dalla riga di comando DBH è possibile usare un'ampia gamma di comandi per analizzare i simboli e i file di simboli.

Nella tabella seguente sono elencati i comandi che controllano le opzioni DBH ed eseguono altre attività di base.

Comando	Effetto
verbose [on|off]	Attiva o disattiva la modalità dettagliata. Senza parametri, visualizza l'impostazione della modalità dettagliata corrente.
simpatia [Percorso]	Imposta il percorso di ricerca dei simboli. Senza parametri, visualizza il percorso di ricerca dei simboli corrente.
Opzioni symopt symopt +Opzioni symopt -Options symopt	Imposta le opzioni dei simboli. + Senza o -, il valore di Opzioni sostituisce le opzioni dei simboli correnti. Se + si utilizza o - , Opzioni specifica le opzioni da aggiungere o rimuovere; deve essere presente uno spazio prima o + - ma non dopo di esso. Senza parametri, vengono visualizzate le opzioni dei simboli correnti. All'avvio di DBH, il valore predefinito di tutte le opzioni dei simboli è 0x10C13. Per un elenco delle opzioni disponibili, vedere Impostazione delle opzioni dei simboli.
help	Visualizza il testo della Guida per i comandi DBH.
dimettersi	Chiude il programma DBH.

Nella tabella seguente sono elencati i comandi che caricano, scaricano e rebaseno il modulo di destinazione. Questi comandi non possono essere usati se DBH è stato avviato specificando un ID processo nella riga di comando.

Comando	Effetto
caricare il file	Carica il modulo specificato. Il file deve specificare il percorso, il nome file e l'estensione del nome file del file eseguibile o del file di simboli.
scaricare	Scarica il modulo corrente.
indirizzo di base	Imposta l'indirizzo di base predefinito sul valore specificato. Tutti gli indirizzi dei simboli verranno determinati in relazione a questo indirizzo di base.

Nella tabella seguente sono elencati i comandi che cercano i file e visualizzano le informazioni sulla directory.

Comando	Effetto
Findexe File Path	Individua il file eseguibile specificato nel percorso specificato usando la routine FindExecutableImage .
Percorso file finddbg	Individua il file con estensione dbg specificato nel percorso specificato. L'inclusione dell'estensione dbg è facoltativa.
Percorso file dir	Individua il file specificato nel percorso specificato o in qualsiasi sottodirectory in questo percorso, usando la routine EnumDirTree .
srchtree Path File	Individua il file specificato nel percorso specificato o in qualsiasi sottodirectory in questo percorso, usando la routine SearchTreeForFile . Questo comando è uguale a dir, ad eccezione del fatto che i parametri vengono invertiti.
File ffpath	Trova il file specificato nel percorso del simbolo corrente.

Nella tabella seguente sono elencati i comandi che analizzano l'elenco dei moduli e controllano il modulo predefinito. Il modulo predefinito e il relativo indirizzo di base vengono visualizzati nel prompt DBH.

Comando	Effetto
Mod Address	Modifica il modulo predefinito nel modulo con l'indirizzo di base specificato.
aggiornare	Aggiorna l'elenco dei moduli.
omap	Visualizza le strutture OMAP del modulo.
epmod PID	Enumera tutti i moduli caricati per il processo specificato. PID specifica l'ID processo del processo desiderato.
info	Visualizza informazioni sul modulo attualmente caricato.
obj Mask	Elenca tutti i file oggetto associati al modulo predefinito che corrispondono al modello specificato. Mask può contenere un'ampia gamma di caratteri jolly e identificatori. Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa.
src Mask	Elenca tutti i file di origine associati al modulo predefinito che corrispondono al modello specificato. Mask può contenere un'ampia gamma di caratteri jolly e identificatori. Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa.
enummod	Enumera tutti i moduli caricati. È sempre presente almeno un modulo, a meno che DBH non sia in esecuzione senza una destinazione, nel qual caso non è presente alcun modulo.

Nella tabella seguente sono elencati i comandi che visualizzano e cercano simboli.

Comando	Effetto
modulo di enumerazione!Simbolo	Enumera tutti i simboli corrispondenti al modulo e al simbolo specificati. Module specifica il modulo da cercare (senza l'estensione del nome file). Symbol specifica un motivo che il simbolo deve contenere. Sia Il modulo che il simbolo possono contenere un'ampia gamma di caratteri jolly e identificatori. Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa.
Indirizzo enumaddr	Enumera tutti i simboli associati all'indirizzo specificato.
Indirizzo addr	Visualizza informazioni dettagliate sui simboli associati all'indirizzo specificato.
nome [Modulo!]Simbolo	Visualizza informazioni dettagliate sul simbolo specificato. È possibile includere un identificatore di modulo facoltativo. I caratteri jolly non devono essere utilizzati, perché se più simboli corrispondono al modello, il nome visualizza solo il primo di essi.
successivo [Modulo!]Simbolo Indirizzo successivo	Visualizza informazioni dettagliate sul simbolo successivo dopo il simbolo o l'indirizzo specificati. Se un simbolo viene specificato in base al nome, è possibile includere un identificatore di modulo facoltativo, ma i caratteri jolly non devono essere utilizzati.
prev [Module!]Simbolo indirizzo prev	Visualizza informazioni dettagliate sul primo simbolo precedente al simbolo o all'indirizzo specificato. Se un simbolo viene specificato in base al nome, è possibile includere un identificatore di modulo facoltativo, ma i caratteri jolly non devono essere utilizzati.
#LineNum file riga	Visualizza l'indirizzo esadecimale dell'istruzione binaria associata alla riga di origine specificata ed eventuali simboli associati a questa riga. Imposta anche il numero di riga corrente uguale al numero di riga specificato. File specifica il nome del file di origine e LineNum specifica il numero di riga all'interno di tale file. Questi valori devono essere separati con un segno di numero ( # ).
Srclines File LineNum	Visualizza i file oggetto associati alla riga di origine specificata e l'indirizzo esadecimale dell'istruzione binaria associata a questa riga. Non modifica il numero di riga corrente. Il file specifica il nome del file di origine e LineNum specifica il numero di riga all'interno del file. Questi valori devono essere separati da uno spazio.
Indirizzo laddr	Visualizza il file di origine e il numero di riga corrispondenti al simbolo che si trova nell'indirizzo specificato.
linenext	Incrementa il numero di riga corrente e visualizza informazioni sul nuovo numero di riga.
lineprev	Decrementa il numero di riga corrente e visualizza informazioni sul nuovo numero di riga.
Funzione locals [Mask]	Visualizza tutte le variabili locali contenute nella funzione specificata. Se mask è incluso, vengono visualizzate solo le variabili locali corrispondenti al modello specificato. Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa.
type TypeName	Visualizza informazioni dettagliate sul tipo di dati specificato. TypeName specifica il nome del tipo di dati, ad esempio WSTRING. Se nessun nome di tipo corrisponde a questo valore, verrà visualizzato qualsiasi simbolo corrispondente. A differenza della maggior parte dei parametri dei comandi DBH, TypeName fa distinzione tra maiuscole e minuscole.
elines [Source [Obj]]	Enumera tutte le righe di origine corrispondenti alla maschera di origine e alla maschera oggetto specificata. Source specifica il nome del file di origine, incluso il percorso assoluto e l'estensione del nome file. Obj specifica il nome del file oggetto, incluso il percorso relativo e l'estensione del nome file. Sia Source che Obj possono contenere un'ampia gamma di caratteri jolly e identificatori. Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa. Se un parametro viene omesso, equivale all'uso del carattere jolly asterisco (). Se non si desidera specificare le informazioni sul percorso, anteporre il nome del file con </strong> per indicare un percorso con caratteri jolly.
index Value	Visualizza informazioni dettagliate sul simbolo con il valore di indice specificato.
ambito Indirizzo ambito [Modulo!]Simbolo	Visualizza informazioni dettagliate sull'elemento padre del simbolo specificato. Il simbolo può essere specificato dall'indirizzo o dal nome.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Cerca tutti i simboli che corrispondono alle maschere specificate. Symbol specifica il nome del simbolo. Non deve includere il nome del modulo, ma può contenere caratteri jolly e identificatori; Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa. Index specifica l'indirizzo esadecimale di un simbolo da utilizzare come elemento padre per la ricerca. Tag specifica il valore del classificatore del tipo di simbolo esadecimale (SymTagXxx) che deve corrispondere al simbolo. Address specifica l'indirizzo del simbolo. Se sono incluse le globals , verranno visualizzati solo i simboli globali.
Indirizzo uw	Visualizza le informazioni di rimozione per la funzione in corrispondenza dell'indirizzo specificato.
dtag	Visualizza tutti i valori del classificatore di tipi di simboli (SymTagXxx).
etype	Enumera tutti i tipi di dati.
dump	Visualizza un elenco completo di tutte le informazioni sui simboli nel file di destinazione.

Nella tabella seguente sono elencati i comandi correlati ai server di simboli e agli archivi di simboli.

Comando	Effetto
home [Percorso]	Imposta la home directory utilizzata da SymSrv e SrcSrv per l'archivio downstream predefinito. Se il percorso del simbolo contiene un riferimento a un server di simboli che usa un archivio downstream predefinito, la sottodirectory sym della home directory verrà usata per l'archivio downstream. Senza alcun parametro, home visualizza la home directory corrente.
percorso srvpath	Verifica se il percorso specificato è il percorso di un archivio simboli.
file srvind	Trova l'indice del server di simboli che corrisponde al file specificato. L'indice del server dei simboli è un valore univoco in base al contenuto del file, indipendentemente dal fatto che sia stato effettivamente aggiunto a qualsiasi archivio simboli. Il file deve specificare il nome file e il percorso assoluto del file desiderato.
fii File	Visualizza gli indici del server di simboli per il file binario specificato e i relativi file associati.
Getfile File Index	Visualizza il file con il nome e l'indice del server di simboli specificati. Il file specifica il nome del file desiderato, che non deve includere il percorso. Index specifica l'indice del server di simboli del file desiderato. DBH usa la routine SymFindFileInPath per eseguire ricerche nell'albero sotto il percorso del simbolo corrente per un file con questo nome e questo indice.
sup Percorso File1 File2	Archivia un file in un archivio simboli, in base ai valori dei parametri. Path specifica il percorso della directory dell'archivio simboli. File1 e File2 vengono usati per creare un valore differenziale, che a sua volta viene usato per determinare il file archiviato.
storeadd File Store	Aggiunge il file specificato all'archivio dei simboli specificato. Store deve essere il percorso radice dell'archivio simboli.

Nella tabella seguente sono elencati i comandi DBH che si applicano ai simboli reali e immaginari.

Comando	Effetto
undec Name	Rivela il significato delle decorazioni associate al nome del simbolo specificato. Il nome può essere qualsiasi stringa. Non deve corrispondere a un simbolo attualmente caricato. Se Name contiene decorazioni C++, viene visualizzato il significato di queste decorazioni.
Add Name Address Size	Aggiunge il simbolo immaginario specificato all'elenco di simboli caricati in DBH. Name specifica il nome del simbolo da aggiungere, Address specifica il relativo indirizzo esadecimale e le dimensioni esadecimali in byte. Questo viene considerato come qualsiasi altro simbolo nei comandi DBH successivi, fino a quando la sessione DBH non viene terminata con la chiusura o lo scaricamento o fino a quando il simbolo immaginario non viene eliminato con del. Il file di simboli di destinazione effettivo non viene modificato.
del Name indirizzo del	Elimina un simbolo immaginario aggiunto in precedenza con il comando add . Il simbolo può essere specificato in base al nome o all'indirizzo. Non è possibile utilizzare questa opzione per eliminare i simboli reali.