DBH Commands

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.

Command	Effect
verbose [on|off]	Attiva o disattiva la modalità dettagliata. Senza parametri, visualizza l'impostazione della modalità dettagliata corrente.
sympath [Path]	Imposta il percorso di ricerca dei simboli. Senza parametri, visualizza il percorso di ricerca dei simboli corrente.
symoptOptions symopt +Options symopt -Options symopt	Imposta le opzioni dei simboli. 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. 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.
quit	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.

Command	Effect
loadFile	Carica il modulo specificato. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Scarica il modulo corrente.
baseAddress	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.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Individua il file con estensione dbg specificato nel percorso specificato. L'inclusione dell'estensione dbg è facoltativa.
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	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.

Command	Effect
modAddress	Modifica il modulo predefinito nel modulo con l'indirizzo di base specificato.
refresh	Aggiorna l'elenco dei moduli.
omap	Visualizza le strutture OMAP del modulo.
epmodPID	Enumera tutti i moduli caricati per il processo specificato. PID specifies the process ID of the desired process.
info	Visualizza informazioni sul modulo attualmente caricato.
objMask	Elenca tutti i file oggetto associati al modulo predefinito che corrispondono al modello specificato. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Elenca tutti i file di origine associati al modulo predefinito che corrispondono al modello specificato. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
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.

Command	Effect
enumModule!Symbol	Enumera tutti i simboli corrispondenti al modulo e al simbolo specificati. 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 tutti i simboli associati all'indirizzo specificato.
addrAddress	Visualizza informazioni dettagliate sui simboli associati all'indirizzo specificato.
name [Module!]Symbol	Visualizza informazioni dettagliate sul simbolo specificato. 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	Visualizza informazioni dettagliate sul simbolo successivo dopo il simbolo o l'indirizzo specificati. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Visualizza informazioni dettagliate sul primo simbolo precedente al simbolo o all'indirizzo specificato. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	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 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	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. 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	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.
localsFunction [Mask]	Visualizza tutte le variabili locali contenute nella funzione specificata. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Visualizza informazioni dettagliate sul tipo di dati specificato. TypeName specifies the name of the data type (for example, WSTRING). Se nessun nome di tipo corrisponde a questo valore, verrà visualizzato qualsiasi simbolo corrispondente. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Enumera tutte le righe di origine corrispondenti alla maschera di origine e alla maschera oggetto specificata. 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 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.
indexValue	Visualizza informazioni dettagliate sul simbolo con il valore di indice specificato.
scopeAddress scope [Module!]Symbol	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 specifies the symbol name. Non deve includere il nome del modulo, ma può contenere caratteri jolly e identificatori; Per informazioni dettagliate, vedere Sintassi con caratteri jolly stringa. 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	Visualizza le informazioni di rimozione per la funzione in corrispondenza dell'indirizzo specificato.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	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.

Command	Effect
home [Path]	Imposta la home directory utilizzata da SymSrv e SrcSrv per l'archivio downstream predefinito. 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	Verifica se il percorso specificato è il percorso di un archivio simboli.
srvindFile	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. File should specify the file name and absolute path of the desired file.
fiiFile	Visualizza gli indici del server di simboli per il file binario specificato e i relativi file associati.
getfileFile Index	Visualizza il file con il nome e l'indice del server di simboli specificati. 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	Archivia un file in un archivio simboli, in base ai valori dei parametri. 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	Aggiunge il file specificato all'archivio dei simboli specificato. Store should be the root path of the symbol store.

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

Command	Effect
undecName	Rivela il significato delle decorazioni associate al nome del simbolo specificato. 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	Aggiunge il simbolo immaginario specificato all'elenco di simboli caricati in 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. Il simbolo può essere specificato in base al nome o all'indirizzo. Non è possibile utilizzare questa opzione per eliminare i simboli reali.